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. Impostano il ruolo, il tono e il formato di output di Claude per ogni risposta. 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 fornisce a Claude le vostre istruzioni 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 suo set standard di istruzioni, progettato per aiutarvi a completare i compiti di ingegneria del software in modo efficiente.
Ci sono quattro output styles integrati aggiuntivi:
-
Proactive: Claude esegue immediatamente, fa ipotesi ragionevoli invece di fermarsi per decisioni di routine, e preferisce l'azione alla pianificazione. Questa è una guida di esecuzione autonoma più forte di quella che auto mode applica, e funziona senza cambiare la vostra modalità di permesso, quindi la vostra modalità di permesso decide comunque cosa viene eseguito senza chiedere.
-
Concise: Claude inizia con il risultato, salta il preambolo e la narrazione, e mantiene le risposte brevi per impostazione predefinita, mentre svolge il lavoro di ingegneria in modo altrettanto approfondito dello stile Default. Quando chiedete una spiegazione o più dettagli, Claude risponde completamente. Claude mantiene sempre il contenuto completo dei rapporti di errore, degli avvisi di sicurezza e delle conferme per le azioni distruttive. Richiede Claude Code v2.1.237 o successivo.
-
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
Scegliete uno stile in uno di questi modi:
- Terminal: eseguite
/confige selezionate Output style per scegliere uno stile da un menu. Claude Code salva la vostra selezione in.claude/settings.local.jsonal livello del progetto locale. - VS Code extension: aprite il menu dei comandi con
/e selezionate Output styles per scegliere uno stile, inclusi i vostri stili personalizzati. Claude Code salva la vostra selezione in.claude/settings.local.json, lo stesso file che scrive il menu del terminal. Richiede Claude Code v2.1.257 o successivo. - Desktop app: impostate il campo
outputStylein un file di impostazioni, ad esempio.claude/settings.local.json, il file che scrive il menu del terminal. Quando eseguite/configlì, Claude Code apre Settings > Claude Code piuttosto che un menu.
Per impostare uno stile senza il menu, modificate direttamente il campo outputStyle in un file di impostazioni:
{
"outputStyle": "Explanatory"
}
Quando cambiate stile a metà sessione, Claude utilizza il nuovo stile a partire dal vostro messaggio successivo. Per il costo di quel primo messaggio in prompt caching, consultate Changing output style. Prima della v2.1.251, il nuovo stile si applicava solo dopo aver eseguito /clear o avviato una nuova sessione.
Creare uno stile di output personalizzato
Uno stile di output personalizzato è un file Markdown: frontmatter per i metadati, quindi le istruzioni per Claude.
Nell'estensione VS Code, potete anche creare il file dal menu Output styles piuttosto che scriverlo manualmente. Questo richiede Claude Code v2.1.261 o successivo.
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.
- Utente:
~/.claude/output-styles - Progetto:
.claude/output-styles - Politica gestita:
.claude/output-stylesall'interno della directory delle impostazioni gestite
Gli output styles del progetto si caricano da ogni .claude/output-styles/ tra la directory di lavoro e la radice del repository. 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.
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:
---
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.
Passare al vostro stile
Eseguite /config nel terminale e selezionate il vostro stile sotto Output style. Claude utilizza il nuovo stile a partire dal vostro messaggio successivo. Nel terminale, Claude Code legge i file di stile quando si avvia, quindi se create o modificate uno durante una sessione in esecuzione, riavviate Claude Code per acquisire la modifica.
I Plugins possono anche fornire output styles in una directory output-styles/.
Frontmatter
I file di output style supportano questi campi frontmatter:
| Frontmatter | Scopo | Predefinito |
|---|---|---|
name |
Nome dell'output style, se non il nome del file | Eredita dal nome del file |
description |
Descrizione dell'output style, mostrata nel picker /config |
Nessuno |
keep-coding-instructions |
Mantenere le istruzioni integrate di ingegneria del software di Claude Code | false |
force-for-plugin |
Solo output styles dei plugin: applica questo stile automaticamente ogni volta che il plugin è abilitato, senza richiedere agli utenti di selezionarlo. Sostituisce l'impostazione outputStyle dell'utente. Se più plugin abilitati impostano questo, Claude Code utilizza il primo caricato. |
false |
Come funzionano gli output styles
Uno output style modifica le istruzioni che Claude Code fornisce a Claude.
- Claude Code invia le istruzioni dello stile attivo con ogni richiesta.
- Quando selezionate uno stile diverso da Default, Claude Code ricorda anche a Claude lo stile 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-instructionsnon sia impostato atrue.
Gli output styles si applicano alla conversazione principale e a un fork, che eredita la conversazione completa e il prompt di sistema del genitore. Altri subagent eseguono il proprio prompt di sistema, quindi gli stili non cambiano il modo in cui rispondono.
L'utilizzo dei token dipende dallo stile. Le istruzioni di uno stile aggiungono 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. Lo stile Concise fa il contrario istruendo Claude a mantenere le risposte brevi per impostazione predefinita. 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 le istruzioni predefinite di Claude Code e si applicano a ogni risposta. Le altre aggiungono istruzioni senza cambiare quelle predefinite, o le limitano a un compito specifico.
| Funzionalità | Come funziona | Utilizzatela quando |
|---|---|---|
| Output styles | Modifica le istruzioni predefinite di Claude Code | Desiderate un ruolo, tono o formato di risposta predefinito diverso ad ogni turno |
| CLAUDE.md | Aggiunge un messaggio utente dopo il prompt di sistema | Claude dovrebbe sempre conoscere le convenzioni del vostro progetto e il contesto del codebase |
--append-system-prompt |
Aggiunge al prompt di sistema senza rimuovere nulla | Desiderate un'aggiunta una tantum passata come flag CLI al lancio |
| Agents | Esegue un subagent con il suo prompt di sistema, modello e strumenti | Desiderate un helper con ambito separato per un compito focalizzato |
| Skills | Carica istruzioni specifiche per compiti quando invocate o rilevanti | Avete un flusso di lavoro riutilizzabile |
Risorse correlate
- Settings: dove risiede il campo
outputStylee 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