Output styles

Cambia il ruolo, il tono e il formato di risposta di Claude Code con uno stile di output integrato come Concise o Explanatory, oppure scrivi uno stile personalizzato.

Uno stile di output è un insieme di istruzioni che imposta il ruolo, il tono e il formato di risposta di Claude per ogni risposta in una sessione. Claude Code include quattro stili integrati oltre al suo predefinito, e puoi scrivere il tuo.

Utilizza uno stile di output per cambiare il modo in cui Claude risponde e lavora con te per un'intera sessione, così non devi ripetere la richiesta in ogni prompt. Ad esempio, uno stile integrato può rendere le risposte più brevi, aggiungere una spiegazione di ogni modifica, oppure fare in modo che Claude inizi il lavoro senza fare domande di routine. Uno stile personalizzato può anche trasformare Claude in qualcosa di diverso da un ingegnere del software, come un assistente di scrittura o un analista di dati.

• Per utilizzare uno stile integrato, scegline uno dagli stili di output integrati e passa ad esso.
• Per scrivere le tue istruzioni, crea uno stile di output personalizzato.

Output styles integrati

Claude Code inizia nello stile Default, le sue istruzioni standard per completare i compiti di ingegneria del software. Ognuno degli altri quattro output styles integrati mantiene quelle istruzioni e aggiunge le proprie.

Questa tabella mostra cosa cambia ogni stile in una sessione e quando è appropriato:

Default

Default significa che nessuno output style è selezionato. Claude Code non aggiunge istruzioni di stile e Claude lavora dal prompt di sistema standard di Claude Code, che è scritto per i compiti di ingegneria del software.

default appare nell'elenco /output-style insieme agli altri stili, quindi lo selezioni allo stesso modo.

Proactive

Nello stile Proactive, Claude inizia l'implementazione non appena invii un compito. Fa ipotesi ragionevoli su decisioni di routine piuttosto che fermarsi per chiedere, e non passa alla plan mode a meno che non chiedi un piano. Puoi reindirizzarlo in qualsiasi momento.

Le istruzioni dello stile dicono anche a Claude di verificare con te nella conversazione prima di un'azione che elimina dati o modifica un sistema condiviso o di produzione. Questo controllo è un'istruzione che Claude segue ed è separato dai prompt di permesso.

Il passaggio allo stile Proactive non cambia la tua modalità di permesso. La tua modalità di permesso decide comunque quali chiamate di strumento vengono eseguite senza chiederti, quindi i prompt di permesso appaiono allo stesso modo di prima del passaggio.

Concise

Nello stile Concise, la prima frase di una risposta afferma cosa è successo o qual è la risposta. Claude omette l'introduzione, la narrazione passo dopo passo e il riepilogo di chiusura, e risponde a una domanda semplice in una o tre frasi. Svolge il lavoro di ingegneria in modo altrettanto approfondito dello stile Default. Richiede Claude Code v2.1.237 o successivo.

Claude scrive comunque a piena lunghezza in questi casi:

• Qualsiasi cosa tu chieda: quando chiedi una spiegazione o più dettagli, Claude risponde completamente.
• Qualsiasi cosa tu abbia bisogno per agire in sicurezza: rapporti di errore, output di test falliti, avvisi di sicurezza e conferme per azioni distruttive mantengono il loro contenuto completo.

Explanatory

Nello stile Explanatory, Claude svolge il compito come fa nello stile Default e aggiunge brevi spiegazioni del perché ha fatto le scelte che ha fatto. Ogni spiegazione appare nella conversazione, prima o dopo il codice di cui parla, in un blocco etichettato Insight. Le spiegazioni non sono scritte nei tuoi file come commenti.

Un blocco Insight contiene due o tre punti sulla tua codebase o sul codice che Claude ha scritto, come questo dopo l'aggiunta di un endpoint API:

★ Insight ─────────────────────────────────────
- Ogni route in questo repo passa attraverso il wrapper withAuth, quindi il nuovo endpoint ottiene i controlli di sessione senza il suo middleware.
- I limiti di velocità sono impostati per route in limits.ts, ecco perché questo cambiamento aggiunge una voce lì piuttosto che un default globale.
─────────────────────────────────────────────────

Learning

Nello stile Learning, Claude aggiunge gli stessi blocchi Insight dello stile Explanatory e ti chiede anche di scrivere parte del codice. Claude gestisce l'implementazione di routine da solo. Quando raggiunge un pezzo con una vera decisione di design, come la gestione degli errori, una struttura dati o la logica di business con più di un approccio valido, lascia alcune righe per te.

Claude contrassegna il punto con un commento TODO(human) nel file, quindi invia una richiesta che dice cosa è già costruito, cosa scrivere e cosa considerare:

● Learn by Doing

Context: Il modulo di caricamento è in posizione e chiama validateFile() prima di accettare un file. I controlli di dimensione e tipo funzionano per le immagini, ma l'istruzione switch non ha ancora la gestione per i documenti.

Your Task: In upload.js, implementa il ramo del caso "document" all'interno di validateFile(). Cerca TODO(human).

Guidance: Decidi un limite di dimensione per i documenti e se l'estensione del file deve corrispondere al tipo MIME. Restituisci {valid: boolean, error?: string}.

Claude quindi si ferma e aspetta. Scrivi il tuo codice al commento TODO(human) e dì a Claude quando hai finito. Claude risponde con un Insight sul tuo codice e continua il compito.

Cambiare il vostro output style

Scegliete uno stile con il comando, un menu o un file di impostazioni. Il comando e entrambi i menu salvano la vostra scelta in .claude/settings.local.json al livello del progetto locale.

• Comando /output-style: eseguite /output-style <style> per passare a uno stile, ad esempio /output-style concise. Senza argomenti, il comando elenca gli stili che potete scegliere e contrassegna quello attuale.

  Il comando funziona anche in modalità non interattiva e nelle sessioni Agent SDK, e dall'app mobile o dal web tramite Remote Control, dove potete elencare e selezionare solo gli stili incorporati. Richiede Claude Code v2.1.269 o successivo.

• Menu Terminal: eseguite /config e selezionate Output style per scegliere uno stile da un menu.

• Estensione VS Code: aprite il menu dei comandi con / e selezionate Output styles per scegliere uno stile, inclusi i vostri stili personalizzati. Richiede Claude Code v2.1.257 o successivo.

• App Desktop: impostate il campo outputStyle in un file di impostazioni, ad esempio .claude/settings.local.json, il file che scrive il menu del terminal. Quando eseguite /config lì, 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"
}

Il valore è sensibile alle maiuscole, quindi scrivete i nomi incorporati come Proactive, Concise, Explanatory e Learning. Un valore che non corrisponde esattamente a un nome di stile, come explanatory, vi fornisce lo stile Default. Il comando /output-style ignora le maiuscole.

Per impostare uno stile come predefinito in tutti i progetti, impostate outputStyle in ~/.claude/settings.json. I file di impostazioni di un progetto hanno la precedenza su quel valore.

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.

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

Riferimento frontmatter

Configurate uno stile di output con frontmatter YAML tra i marcatori --- all'inizio del file. Tutti i campi sono facoltativi e i nomi dei campi utilizzano parole minuscole separate da trattini. Un campo scritto male viene ignorato senza errore. Se lo YAML non viene analizzato, lo stile si carica comunque con il suo nome file senza campi impostati; eseguite claude --debug per visualizzare l'errore di analisi.