SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Claude Code: guida agli stili di output

Gli stili di output modificano il prompt di sistema di Claude Code. Scopri i 5 stili integrati, l’aggiornamento dalla v2.1.251 e come crearne uno.

Che cos'è uno stile di output in Claude Code

Uno stile di output in Claude Code è un blocco di istruzioni che Claude Code aggiunge a ciò che invia a Claude con ogni richiesta. Cambia il modo in cui Claude ti risponde: il ruolo che assume e la struttura di ciò che stampa. Non insegna nulla a Claude sul tuo codebase e non può autorizzarlo a eseguire alcuna operazione.

Claude Code rilascia cinque stili integrati. La tua scelta è memorizzata in una chiave delle impostazioni, outputStyle. In Claude Code v2.1.251 o versioni successive, uno stile selezionato durante una sessione si applica dal messaggio successivo. Dalla v2.1.73 fino alla v2.1.251, la modifica veniva salvata ma ignorata finché non cancellavi la sessione; questo spiega gran parte della confusione ancora presente nelle guide meno recenti a questa funzione.

Su un VPS non si tratta soltanto di una preferenza estetica. Il transcript è ciò che leggi attraverso una connessione SSH (secure shell), di solito all'interno di una finestra tmux; quindi ogni riga descritta da Claude è una riga che devi attendere e una riga in un buffer di scrollback di dimensioni fisse.

Dove si trova l'impostazione outputStyle

Scegli uno stile dal menu /config, nella sezione Output style. Claude Code salva la scelta in .claude/settings.local.json nel progetto su cui stai lavorando.

Il comando /output-style svolge la stessa funzione dal prompt. Esegui /output-style concise per cambiare stile oppure /output-style senza argomenti per elencare gli stili e vedere quale è attivo. Il comando salva nello stesso file .claude/settings.local.json, non distingue tra maiuscole e minuscole e funziona anche in modalità non interattiva. Il comando descritto in questa pagina è stato introdotto in Claude Code v2.1.269. Un comando /output-style precedente era già presente nella versione v2.0.30 ed è stato deprecato nella versione v2.1.73 a favore di /config, quindi una build compresa tra queste due release potrebbe non comportarsi come descritto in questa pagina. Verifica quale versione stai eseguendo prima di seguire qualsiasi guida, inclusa questa. Le versioni indicate in questa pagina sono state verificate a ottobre 2026.

claude --version

Puoi anche impostare manualmente la chiave. Può essere presente in quattro file di configurazione; il file con ambito più ristretto ha la precedenza su quello con ambito più ampio.

  • ~/.claude/settings.json è il file dell'utente. Si applica a tutti i progetti su quella macchina.
  • .claude/settings.json è il file del progetto. Viene salvato in git, quindi si applica a tutti gli utenti che clonano il repository.
  • .claude/settings.local.json è il file locale del progetto. Non viene salvato in git e sostituisce entrambi i file precedenti. È il file in cui scrivono il menu /config e il comando /output-style.
  • Le impostazioni gestite, distribuite da un team IT a partire da un percorso di sistema come /etc/claude-code/ su Linux, hanno la precedenza su tutte le altre.

Il valore della chiave è il nome dello stile:

{
  "outputStyle": "Concise"
}

Il valore distingue tra maiuscole e minuscole. Scrivi i nomi integrati come Proactive, Concise, Explanatory e Learning. Un valore che non corrisponde esattamente al nome di uno stile, come concise, seleziona silenziosamente lo stile Default.

Per una sola sessione, passa la stessa chiave sulla riga di comando. Il flag --settings accetta un percorso o una stringa JSON inline; i relativi valori sostituiscono le stesse chiavi nei file delle impostazioni dell'utente, del progetto e locali per quella sessione. Le impostazioni gestite hanno comunque la precedenza:

claude --settings '{"outputStyle": "Concise"}'

La documentazione elenca quattro modi per scegliere uno stile, ma solo due prevedono una versione minima. Il menu /config nel terminale non ne richiede alcuna. Il comando /output-style, nella forma attuale, richiede la versione v2.1.269, mentre il menu Output styles nell'estensione VS Code richiede la versione v2.1.257. Nell'app Desktop devi invece impostare il campo outputStyle in un file delle impostazioni. La chiave outputStyle non richiede una versione minima, quindi è quella su cui fare affidamento. Quando uno screenshot di una guida non corrisponde più a ciò che visualizzi, imposta direttamente la chiave e verificala con /status, che elenca le origini delle impostazioni effettive.

Quando entra in vigore un nuovo stile di output

In Claude Code v2.1.251 o versioni successive, uno stile selezionato durante la sessione, dal comando, dal menu o dal file delle impostazioni, si applica a partire dal messaggio successivo. Non è necessario cancellare. Dalla v2.1.73 fino alla v2.1.251, la sessione in corso manteneva lo stile con cui era stata avviata e quello nuovo veniva caricato solo al successivo /clear o al successivo avvio.

Nel terminale, Claude Code legge i file degli stili all'avvio. Se crei o modifichi un file di stile personalizzato mentre una sessione è in esecuzione, riavvia Claude Code prima di selezionarlo. In VS Code v2.1.261 o versioni successive, la procedura guidata Build a custom style nel menu Output styles crea il file e mostra immediatamente il nuovo stile. In una build appartenente a quell'intervallo precedente, oppure dopo il riavvio necessario per una modifica a un file di stile del terminale, questi due comandi forniscono una sessione pulita e mostrano quindi ciò che è stato caricato:

/clear
/context

/context stampa ciò che occupa attualmente la finestra di contesto, suddiviso per categoria, incluso il prompt di sistema. Eseguilo in una sessione nuova con ciascuno stile: la riga del prompt di sistema costituisce il lato di input del confronto. È anche il modo più rapido per verificare che uno stile personalizzato sia stato effettivamente caricato. Per una panoramica più ampia di ciò che riempie quella finestra, consulta come si riempie il contesto in una sessione lunga di Claude Code.

Il caching spiega perché il cambio funziona in questo modo. L'API soddisfa le richieste ripetute usando una cache dei prompt che verifica la corrispondenza con l'inizio di ogni richiesta, e il prompt di sistema si trova proprio all'inizio. Riscriverlo durante la conversazione invaliderebbe tutto ciò che segue, quindi il turno successivo dovrebbe elaborare di nuovo l'intera cronologia come nuovo input. Le build dalla v2.1.73 fino alla v2.1.251 evitavano questo costo fissando lo stile all'avvio della sessione. Le build attuali forniscono invece le istruzioni del nuovo stile come un messaggio nella conversazione, quindi la richiesta successiva al cambio legge ancora il prompt di sistema e la conversazione precedente dalla cache. In ogni caso, cambiare stile ha un costo ridotto.

Cosa cambia ogni stile di output integrato nella trascrizione

  • Default è il prompt di sistema normale di Claude Code, scritto per attività di ingegneria del software.
  • Concise presenta subito il risultato. Elimina il preambolo e la narrazione passo per passo, mantenendo brevi le risposte finché non chiedi maggiori dettagli. Il lavoro tecnico eseguito rimane invariato. Non abbrevia mai un report di errore o un avviso di sicurezza e continua a chiedere conferma completa prima di un'azione distruttiva. Questo stile richiede Claude Code v2.1.237 o versioni successive.
  • Explanatory aggiunge "Insights" didattici tra i passaggi di un'attività. Spiega perché è stata scelta una determinata implementazione e quale pattern utilizza già il tuo codebase. Per questo la trascrizione diventa intenzionalmente più lunga.
  • Learning si spinge oltre. Claude condivide questi insights e poi ti chiede di scrivere personalmente piccole parti del codice, contrassegnando ogni punto con un commento TODO(human) nel file.
  • Proactive porta Claude ad agire invece di porre domande. Per le decisioni di routine, fa assunzioni ragionevoli invece di interrompersi per chiedere conferma.

Leggi attentamente l'ultimo punto, perché è quello che viene frainteso più spesso. Proactive è una direttiva del prompt di sistema. Cambia ciò che Claude tenta di fare. La modalità di autorizzazione decide comunque quali operazioni possono essere eseguite senza chiederti conferma. Questa è l'impostazione importante su un server che lasci in esecuzione senza supervisione. L'argomento è trattato in modalità automatica e modalità di autorizzazione di Claude Code.

In che modo uno stile di output differisce da CLAUDE.md, da un hook e da un subagent

Tutti questi meccanismi servono a indicare a Claude come comportarsi, ma operano a livelli diversi.

  • Uno stile di output fa parte delle istruzioni che Claude Code invia con ogni richiesta. Si applica a ogni risposta della conversazione principale.
  • CLAUDE.md viene aggiunto come messaggio dell'utente dopo il prompt di sistema. Qui vanno inserite le convenzioni del progetto e le informazioni sulla codebase.
  • --append-system-prompt aggiunge testo al prompt di sistema per una singola esecuzione, senza rimuovere nulla. È la versione temporanea di uno stile di output.
  • Un hook è un comando shell eseguito direttamente da Claude Code quando si verifica un evento. Viene applicato dall'harness, quindi viene eseguito indipendentemente dal fatto che Claude lo avrebbe scelto o meno. Vedere cosa può e non può fare un hook di Claude Code.
  • Un subagent viene eseguito con il proprio prompt di sistema e il proprio set di strumenti.

Un test semplice consente di scegliere tra i primi due meccanismi. Le informazioni sul progetto vanno in CLAUDE.md, perché Claude deve conoscerle. La formulazione va in uno stile di output, perché riguarda il modo in cui viene scritta la risposta. Tutto ciò che deve accadere sempre, indipendentemente dalla decisione del modello, va in un hook. Il livello in cui opera ciascun meccanismo dipende da il programma che esegue il modello, non dal modello stesso. Per questo uno stile può soltanto influenzare il comportamento, mentre un hook può imporlo.

Gli stili di output si applicano soltanto alla conversazione principale. Un subagent non eredita il tuo stile, perché avvia una propria conversazione con il proprio prompt di sistema. Un fork della conversazione corrente fa eccezione, perché eredita esattamente il prompt di sistema del processo padre. Se un subagent scrive in un modo che non ti piace, modifica il file di quell'agente invece del tuo stile. Una seconda sessione di Claude Code sullo stesso host segue lo stesso confine: all'avvio legge autonomamente i propri file di configurazione. Di conseguenza, quando affidi il lavoro a un'altra sessione eseguita insieme alla tua, le risposte arrivano con lo stile caricato da quella sessione, non con il tuo.

Come scrivere il proprio stile di output

Uno stile di output personalizzato è un file Markdown con frontmatter. Salvatelo nella directory home per usarlo in ogni progetto oppure all'interno del repository per conservarlo insieme al codice. La directory dell'utente è ~/.claude/output-styles/ e la directory del progetto è .claude/output-styles/.

mkdir -p ~/.claude/output-styles
cat > ~/.claude/output-styles/terse-ops.md <<'EOF'
---
name: Terse ops
description: Command first, explanation after, for SSH sessions
keep-coding-instructions: true
---

Lead with the command or the file change. Put the explanation after it, in two sentences or fewer.

Do not narrate what you are about to do. Report what you did.

When a command can fail, print the one check that proves it worked and say what a healthy result looks like.
EOF

Avviate una sessione e aprite /config. Lo stile viene visualizzato nell'elenco Output style, con la descrizione specificata. Se non compare, il file non viene letto: controllate il percorso e riavviate Claude Code se la sessione era già in esecuzione quando avete salvato il file. Se compare con il solo nome del file e senza descrizione, il frontmatter non è stato analizzato correttamente e claude --debug mostra l'errore di analisi. Il nome del file diventa il nome dello stile, a meno che il frontmatter non imposti name; per questo motivo questo stile si chiama Terse ops e non terse-ops.

Selezionatelo oppure impostate la chiave sul nome esatto, mantenendo le stesse maiuscole:

{
  "outputStyle": "Terse ops"
}

Un campo determina se il file è un'estensione o una sostituzione. keep-coding-instructions usa false come valore predefinito. Questo significa che uno stile personalizzato rimuove le istruzioni di ingegneria del software integrate in Claude Code e usa soltanto il testo fornito. Queste istruzioni integrate spiegano a Claude come definire l'ambito di una modifica e come verificarne il risultato. Omettete il campo per un assistente alla scrittura o per un analista di dati, perché in questi casi non si applica. Impostatelo su true per qualsiasi attività che coinvolga ancora del codice; in caso contrario, potreste chiedervi perché un ingegnere accurato abbia improvvisamente smesso di verificare il proprio lavoro. Solo il prompt di sistema completo di Claude Code contiene questa sezione, quindi il campo non ha effetto con il prompt di sistema più breve. Impostando la variabile d'ambiente CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT su 0 si seleziona il prompt completo su qualsiasi modello. Se il vostro obiettivo non è realmente usare una voce diversa, ma definire con maggiore precisione la quantità di lavoro che un'attività richiede, questa impostazione appartiene alle istruzioni di ingegneria e non al file di stile: la skill Ponytail è un esempio completo, con una singola regola che orienta un agente verso la modifica funzionante più piccola possibile.

description è la riga che il selettore /config mostra accanto al nome. Scrivetela pensando al momento in cui, tra sei mesi, dovrete scegliere tra due vostri stili.

Perché uno stile conciso è diverso tramite SSH

Su un VPS leggi il transcript attraverso livelli che un terminale locale non ha, e ogni livello penalizza la verbosità.

Lo scrollback viene per primo. In tmux, ogni pannello conserva un numero fisso di righe, impostato da history-limit, che per impostazione predefinita è 2000. Un transcript narrato riempie quel buffer più rapidamente, quindi la parte iniziale della sessione viene espulsa prima e l'output a cui volevi tornare scorrendo non è più disponibile. Aumentalo se vuoi più spazio:

echo 'set -g history-limit 20000' >> ~/.tmux.conf
tmux source-file ~/.tmux.conf

I pannelli creati dopo la modifica conservano 20000 righe ciascuno, al costo di una maggiore quantità di memoria per pannello. In tmux 3.7 o versioni successive, la modifica di history-limit aggiorna anche i pannelli già aperti; nelle versioni precedenti si applica soltanto ai nuovi pannelli. Se stai ancora costruendo il layout della sessione, eseguire Claude Code dentro tmux su un VPS spiega come procedere.

La latenza viene al secondo posto. La risposta viene trasmessa in streaming al terminale mentre viene generata. Su una connessione con un tempo di andata e ritorno elevato, un lungo preambolo è tempo che trascorri osservando il testo arrivare prima che compaia la risposta.

I token di output vengono al terzo posto. Ogni riga esplicativa viene conteggiata come output. Gli stili Explanatory e Learning sono più lunghi per progettazione. Concise è più breve per progettazione, perché indica a Claude di mantenere brevi le risposte per impostazione predefinita.

Non fidarti della percentuale indicata da altri, compresa quella di questa pagina. L'entità della differenza dipende dai prompt, dal modello e dal lavoro richiesto, quindi misura i tuoi risultati prima e dopo. Esegui la stessa attività reale in due sessioni nuove, una con Default e una con Concise, quindi confrontale. Una statusline è il contatore più semplice, perché Claude Code fornisce al tuo script un oggetto JSON tramite stdin che contiene già il nome dello stile, i token di output dell'ultima risposta e una stima cumulativa del costo della sessione:

cat > ~/.claude/statusline.sh <<'EOF'
#!/bin/bash
input=$(cat)
style=$(echo "$input" | jq -r '.output_style.name // "default"')
out=$(echo "$input" | jq -r '.context_window.total_output_tokens // 0')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
echo "style=$style out=$out cost=$cost"
EOF
chmod +x ~/.claude/statusline.sh

Imposta il valore statusLine su questo script:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

La barra nella parte inferiore della sessione mostra ora lo stile attivo accanto alla dimensione dell'ultima risposta e al costo stimato della sessione fino a quel momento. out riguarda soltanto l'ultima risposta, quindi mostra la lunghezza di ciascuna risposta in token di output. cost si accumula, quindi il valore alla fine di ogni esecuzione è il confronto prima e dopo. Leggilo prima di cancellare la sessione, perché il costo viene reimpostato su $0 quando /clear avvia una nuova sessione, e consideralo una stima, non l'importo fatturato. Lo script richiede jq, il parser JSON da riga di comando, quindi installalo prima con sudo apt install -y jq. Se la barra resta vuota, esegui manualmente lo script e passagli del JSON tramite pipe, perché una statusline che termina con un codice diverso da zero non stampa né restituisce alcun dato. Una statusline personalizzata di Claude Code elenca gli altri campi presenti nell'oggetto. Per la parte relativa alla fatturazione, anziché a quella della sessione, leggi dove finiscono realmente i token di Claude Code e gli strumenti che monitorano la spesa di Claude Code.

Come verificare quale stile di output è effettivamente caricato

Usa questi controlli invece di procedere per supposizioni.

  • /status elenca le origini delle impostazioni attive per questa sessione, indicando anche se sono in uso impostazioni gestite da un'organizzazione.
  • /context mostra il prompt di sistema caricato come categoria nella suddivisione della finestra di contesto.
  • claude doctor, eseguito dalla shell senza avviare una sessione, stampa la diagnostica dell'installazione e delle impostazioni e segnala i file delle impostazioni non validi.

Quando uno stile non si applica, la causa è quasi sempre una di due. La prima è la tempistica: in una build dalla v2.1.73 fino alla v2.1.251, un cambio durante la sessione attende /clear; nel terminale, invece, un file di stile creato o modificato durante la sessione richiede un riavvio. La seconda è la precedenza: .claude/settings.local.json ha la precedenza su .claude/settings.json, ed entrambi hanno la precedenza su ~/.claude/settings.json. Poiché il selettore /config e il comando /output-style scrivono nel file locale, uno stile che il team ha salvato in .claude/settings.json viene sostituito senza avvisi su qualsiasi macchina in cui qualcuno abbia usato una delle due opzioni. /status indica quali file sono stati caricati, ma non quale abbia fornito il valore; apri quindi ogni file elencato e cerca outputStyle.

Un errore di sintassi JSON produce lo stesso sintomo, ma richiede una correzione diversa. claude doctor indica il file che non è riuscito ad analizzare; vale la pena eseguirlo prima di cercare cause più complesse. Un valore con una combinazione errata di maiuscole e minuscole, come explanatory, è JSON valido ma restituisce comunque lo stile predefinito, quindi controlla anche le maiuscole.

FAQ

Perché il comando /output-style ha smesso di funzionare?

Nelle build attuali non ha smesso di funzionare. /output-style elenca gli stili e /output-style concise passa a uno di essi. Il comando presenta una discontinuità nella sua evoluzione: la v2.1.73 lo ha dichiarato obsoleto in favore di /config, mentre la v2.1.269 ha aggiunto l'attuale forma /output-style [name]. Di conseguenza, in una build compresa tra queste due versioni potrebbe non funzionare come descritto qui. Esegui claude --version per verificare la versione in uso. In qualsiasi build puoi selezionare lo stile da /config, nella sezione Stile di output, oppure impostare la chiave outputStyle in un file delle impostazioni. La documentazione non indica una versione minima per la chiave, quindi impostarla direttamente è l'istruzione che conviene annotare.

Ho cambiato lo stile di output, ma non è successo nulla. Perché?

Controlla prima la versione. In Claude Code v2.1.251 o versioni successive, uno stile cambiato durante la sessione si applica dal messaggio successivo. Dalla v2.1.73 fino alla v2.1.251, la modifica veniva salvata ma applicata solo dopo /clear o in una nuova sessione. Nel terminale, un file di stile personalizzato creato o modificato durante la sessione richiede un riavvio, perché Claude Code legge i file degli stili all'avvio. Se lo stile non viene ancora applicato, verifica che il valore corrisponda esattamente al nome dello stile, incluse le maiuscole, quindi esegui /status per vedere quali file delle impostazioni sono stati caricati, poiché .claude/settings.local.json ha la precedenza su .claude/settings.json ed entrambi hanno la precedenza su ~/.claude/settings.json.

Lo stile di output Concise consente di risparmiare?

Riduce i token di output nella direzione prevista, perché istruisce Claude a mantenere le risposte brevi per impostazione predefinita. L'entità della riduzione dipende dai prompt e dal modello, quindi considera ogni percentuale pubblicata come una misurazione del lavoro di qualcun altro. Misura il tuo caso: esegui /context in una sessione nuova con ogni stile per il lato di input, quindi esegui la stessa attività con ogni stile e confronta i token di output e il costo stimato. Concise non accorcia mai un report di errore o un avviso di sicurezza, quindi le parti che devi leggere con maggiore attenzione restano complete.

Uno stile di output modifica il modo in cui scrivono i miei subagent?

No. Gli stili di output si applicano solo alla conversazione principale, perché un subagent avvia una conversazione propria con un prompt di sistema e un set di strumenti propri. Un fork della conversazione corrente costituisce un'eccezione, perché eredita esattamente il prompt di sistema del processo padre. Per cambiare il comportamento di un subagent, modifica il file specifico di quell'agent.

Uno stile di output può consentire a Claude di eseguire comandi senza chiedere conferma?

No. Uno stile di output è testo nel prompt di sistema, quindi può soltanto influenzare ciò che Claude prova a fare. Lo stile Proactive porta Claude a prendere decisioni e agire invece di fermarsi sulle attività di routine, ma non può comunque approvare un comando. La modalità di autorizzazione determina quali operazioni vengono eseguite senza richiesta di conferma; è questa l'impostazione da controllare prima di lasciare una sessione in esecuzione su un server.

Questo articolo ti è stato utile?