Stili di output

Intermedio

What you'll learn

Che cos'è uno stile di output — e in cosa differisce dal cambiare ciò che Claude sa
I quattro stili integrati: Default, Proactive, Explanatory, Learning
Come passare da uno stile all'altro con /config — e perché la modifica richiede una nuova sessione
Come creare il tuo stile personalizzato come file Markdown
Quando ricorrere a uno stile di output rispetto a CLAUDE.md o alle istruzioni personalizzate di Claude.ai

Gli stili di output cambiano il modo in cui Claude Code comunica — il suo ruolo, tono, prolissità e se spiega o meno il proprio ragionamento — modificando direttamente il system prompt. Cambiano il modo in cui Claude risponde, non ciò che sa. Ricorri a uno di essi quando ti ritrovi a richiedere ogni volta lo stesso registro o formato.

Perché usarli

Adattali al tuo flusso di lavoro. Conciso e orientato all'azione quando vai veloce; esplicativo quando stai imparando.
Modalità didattica. Alcuni stili aggiungono commenti formativi — ottimi mentre prendi confidenza con una codebase o una tecnica.
Coerenza. Imposta una volta lo stile che preferisci, così ogni sessione si presenta come piace a te.

Gli stili integrati

Claude Code include quattro stili predefiniti:

Stile	Cosa fa
Default	Il system prompt standard per l'ingegneria del software — efficiente, orientato all'azione.
Proactive	Esegue immediatamente e fa assunzioni ragionevoli invece di fermarsi per le decisioni di routine. Offre indicazioni di esecuzione autonoma più marcate rispetto alla modalità auto, ma vedi comunque le richieste di permesso prima che gli strumenti vengano eseguiti.
Explanatory	Aggiunge "Insights" formativi tra un passaggio e l'altro, spiegando le scelte implementative e i pattern della codebase.
Learning	Collaborativo, basato sull'imparare facendo: condivide Insights e ti chiede di scrivere tu stesso piccole parti, lasciando marcatori `[TODO(human)]` nel tuo codice.

Watch out

Explanatory e Learning producono per loro natura risposte più lunghe, quindi costano più token di output rispetto a Default.

Premi Invio o Spazio per girare la carta. Usa le frecce sinistra e destra per spostarti tra le carte.Termine mostrato.

1 / 4

Come passare da uno all'altro

Esegui /config e scegli uno stile sotto Output style. La tua scelta viene salvata in .claude/settings.local.json a livello di progetto. Per impostarlo senza il menu, modifica il campo outputStyle in qualsiasi file di impostazioni.

Guided walkthrough1 of 4

Esegui /config nella tua sessione e individua l'opzione Output style.

{
  "outputStyle": "Explanatory"
}

:::warning Le modifiche richiedono una nuova sessione Lo stile di output fa parte del system prompt, che Claude Code legge una sola volta all'avvio della sessione. Una modifica ha effetto solo dopo /clear o in una nuova sessione. (Il comando autonomo /output-style è stato rimosso nella v2.1.91 — usa /config o l'impostazione qui sopra.) :::

Creare uno stile personalizzato

Uno stile personalizzato è un file Markdown: frontmatter, poi le istruzioni da accodare al system prompt. Salvalo a livello utente (~/.claude/output-styles/) o a livello di progetto (.claude/output-styles/); il nome del file diventa il nome dello stile, a meno che tu non imposti name.

Esempio di stile personalizzato — Diagrammi prima di tutto

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid
diagram showing the structure, then explain in prose.

Pro tip

Imposta keep-coding-instructions: true quando stai cambiando solo il MODO in cui Claude comunica ma vuoi comunque che continui a programmare normalmente.
Omettilo (è l'impostazione predefinita) quando Claude non sta facendo affatto ingegneria del software — ad esempio, un assistente puramente di scrittura o di analisi dati — così le istruzioni di coding integrate vengono escluse.

Stili di output vs CLAUDE.md vs altre leve

Stile di output = un preset del system prompt per ruolo, tono e formato — si applica a ogni risposta.
CLAUDE.md = fatti e regole di progetto persistenti (convenzioni, guardrail), aggiunti come messaggio dopo il system prompt.
Istruzioni personalizzate / stili di risposta = il cugino dell'app consumer Claude.ai.

:::tip Usa la leva giusta Vuoi che Claude "esegua sempre i test prima di concludere"? Quello è un guardrail di CLAUDE.md, non uno stile. Vuoi che "spieghi ogni passaggio man mano che procede"? Quello è uno stile di output. Tieni le regole di comportamento in CLAUDE.md e la presentazione negli stili. :::

Mettiti alla prova

0/5

Che cosa cambia in realtà uno stile di output?
Quale stile integrato lascia i marcatori [TODO(human)] e ti chiede di scrivere tu stesso piccole parti?
Dopo aver cambiato lo stile di output, quando ha effetto?
Vuoi che Claude 'esegua sempre i test prima di concludere'. Quale leva è?
Quando dovresti impostare keep-coding-instructions: true in uno stile personalizzato?

Key takeaways

Gli stili di output cambiano il MODO in cui Claude comunica (ruolo, tono, prolissità), non COSA sa — modificano il system prompt.
Quattro stili integrati: Default (orientato all'azione), Proactive (esegue con assunzioni), Explanatory (aggiunge Insights), Learning (Insights + marcatori [TODO(human)]).
Explanatory e Learning costano più token di output perché le risposte sono per loro natura più lunghe.
Cambia tramite /config (salvato in .claude/settings.local.json) o tramite l'impostazione outputStyle — le modifiche richiedono /clear o una nuova sessione.
Gli stili personalizzati sono file Markdown in ~/.claude/output-styles/ o .claude/output-styles/; usa keep-coding-instructions: true per mantenere il comportamento di coding.
Usa CLAUDE.md per le regole di comportamento/guardrail e gli stili di output per la presentazione.

Perché usarli​

Gli stili integrati​

Come passare da uno all'altro​

Creare uno stile personalizzato​