Skip to main content
Output styles cambiano il modo in cui Claude risponde, non quello che Claude sa. Modificano il prompt di sistema per impostare il ruolo, il tono e il formato di output. Utilizzatene uno quando continuate a ripetere la stessa voce o formato ad ogni turno, oppure quando desiderate che Claude agisca come qualcosa di diverso da un ingegnere del software. Uno stile di output personalizzato aggiunge le vostre istruzioni al prompt di sistema e vi permette di scegliere se mantenere le istruzioni integrate di ingegneria del software di Claude Code. Mantenetele quando state cambiando il modo in cui Claude comunica ma state ancora codificando, come rispondere sempre con un diagramma. Omettele quando Claude non sta facendo ingegneria del software affatto, come un assistente di scrittura o un analista di dati. Per le istruzioni relative al vostro progetto, alle convenzioni o al codebase, utilizzate CLAUDE.md invece.

​
Output styles integrati

Lo Default output style di Claude Code è il prompt di sistema esistente, progettato per aiutarvi a completare i compiti di ingegneria del software in modo efficiente. Ci sono tre output styles integrati aggiuntivi:
  • Proactive: Claude esegue immediatamente, fa ipotesi ragionevoli invece di fermarsi per decisioni di routine, e preferisce l’azione alla pianificazione. Questo è una guida di esecuzione autonoma più forte di quella che auto mode applica, e funziona senza cambiare la vostra modalità di permesso, quindi vedete comunque i prompt di permesso prima che gli strumenti vengano eseguiti.
  • Explanatory: Fornisce “Insights” educativi tra l’aiuto nel completamento dei compiti di ingegneria del software. Aiuta a comprendere le scelte di implementazione e i pattern del codebase.
  • Learning: Modalità collaborativa di apprendimento pratico in cui Claude non solo condividerà “Insights” durante la codifica, ma vi chiederà anche di contribuire con piccoli, strategici pezzi di codice voi stessi. Claude Code aggiungerà marcatori TODO(human) nel vostro codice per voi da implementare.

​
Cambiare il vostro output style

Eseguite /config e selezionate Output style per scegliere uno stile da un menu. La vostra selezione viene salvata in .claude/settings.local.json al livello del progetto locale.
Il comando standalone /output-style è stato deprecato nella v2.1.73 e rimosso nella v2.1.91. Utilizzate /config o modificate direttamente l’impostazione outputStyle.
Per impostare uno stile senza il menu, modificate direttamente il campo outputStyle in un file di impostazioni:
Output style è parte del prompt di sistema, che Claude Code legge una volta all’avvio della sessione. Le modifiche hanno effetto dopo /clear o una nuova sessione. Consultate Come Claude Code utilizza il prompt caching per sapere cosa fa un cambio di output style sulla cache.

​
Creare uno stile di output personalizzato

Uno stile di output personalizzato è un file Markdown: frontmatter per i metadati, quindi le istruzioni da aggiungere al prompt di sistema.
1

Creare un file Markdown

Salvarlo a uno di tre livelli. Il nome del file diventa il nome dello stile a meno che non impostiate name nel frontmatter.Gli output styles del progetto si caricano da ogni .claude/output-styles/ tra la directory di lavoro e la radice del repository. A partire dalla v2.1.178, quando più di una di queste directory annidate definisce uno stile con lo stesso nome, Claude Code utilizza quello più vicino alla directory di lavoro.
2

Aggiungere frontmatter e istruzioni

Decidete se mantenere le istruzioni di ingegneria del software di Claude Code. Impostate keep-coding-instructions: true se state cambiando il modo in cui Claude comunica ma volete comunque che codifichi allo stesso modo. Omettete se Claude non farà ingegneria del software.Questo esempio introduce ogni spiegazione con un diagramma mantenendo il comportamento di codifica di Claude:
3

Passare al vostro stile

Eseguite /config e selezionate il vostro stile sotto Output style. Ha effetto dopo /clear o la prossima volta che avviate una sessione.
I Plugins possono anche fornire output styles in una directory output-styles/.

​
Frontmatter

I file di output style supportano questi campi frontmatter:

​
Come funzionano gli output styles

Gli output styles modificano direttamente il prompt di sistema di Claude Code.
  • Tutti gli output styles hanno le loro istruzioni personalizzate aggiunte alla fine del prompt di sistema.
  • Tutti gli output styles attivano promemoria affinché Claude aderisca alle istruzioni dell’output style durante la conversazione.
  • Gli output styles personalizzati omettono le istruzioni integrate di ingegneria del software di Claude Code, come come definire l’ambito dei cambiamenti, scrivere commenti e verificare il lavoro, a meno che keep-coding-instructions non sia impostato a true.
L’utilizzo dei token dipende dallo stile. L’aggiunta di istruzioni al prompt di sistema aumenta i token di input, anche se il prompt caching riduce questo costo dopo la prima richiesta in una sessione. Gli output styles integrati Explanatory e Learning producono risposte più lunghe rispetto a Default per progettazione, il che aumenta i token di output. Per gli stili personalizzati, l’utilizzo dei token di output dipende da ciò che le vostre istruzioni dicono a Claude di produrre. Diverse funzionalità personalizzano il comportamento di Claude Code. Gli output styles modificano il prompt di sistema direttamente e si applicano a ogni risposta. Gli altri aggiungono istruzioni senza cambiare il prompt di sistema predefinito, o le limitano a un compito specifico.
  • Settings: dove risiede il campo outputStyle e come funziona la precedenza delle impostazioni
  • Permission modes: come lo stile Proactive si confronta con la modalità auto
  • Plugins: pacchetto e distribuzione degli output styles insieme a skills, hooks e agents
  • Debug your configuration: diagnosticare perché uno output style non ha effetto