Output styles

Adattare Claude Code per usi oltre l'ingegneria del software

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.

Per impostare uno stile senza il menu, modificate direttamente il campo outputStyle in un file di impostazioni:

{
  "outputStyle": "Explanatory"
}

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.

---
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.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

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.

Confronti con funzionalità correlate

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.

Risorse correlate

• 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