Blog

Claude Code: scegliere e creare uno stile di risposta

Markdown

Cosa sono gli stili di output in Claude Code e in cosa differiscono da CLAUDE.md: quattro stili integrati, come passare da uno all’altro tramite /config e come crearne uno personalizzato.

Leggi l’articolo completo

Se ti capita di chiedere a Claude Code ogni due messaggi di «rispondere in modo più breve», «spiegare più nel dettaglio» o «comportarsi da editor, non da programmatore», puoi impostarlo una volta sola. Per questo c’è un’impostazione separata: gli stili di risposta, chiamati stili di output nell’interfaccia. Uno stile cambia il ruolo, il tono e il formato di ogni risposta successiva finché non lo cambi.

Uno stile cambia come Claude risponde, non quello che sa del tuo progetto. Puoi impostare il contesto del progetto nel file CLAUDE.md; consulta la guida dedicata su come personalizzare Claude per te.

Le informazioni su come lavorare con Ailoot sono disponibili nella documentazione.

Che cos’è uno stile di risposta in Claude Code?

Punti chiave

Uno stile di risposta (stile di output) è un insieme di istruzioni che Claude Code aggiunge a ogni tua richiesta. Definisce il ruolo, il tono e il formato della risposta, ma non cambia le conoscenze del modello. Oltre allo stile predefinito, ci sono quattro stili integrati: Proactive, Concise, Explanatory e Learning. Puoi passare da uno all’altro tramite /config → Output style.

Claude Code è di solito configurato come un ingegnere: spiega i passaggi nel dettaglio, pianifica le modifiche e commenta ciò che sta facendo. Questo è lo stile predefinito, un insieme standard di istruzioni per lavorare con il codice.

Uno stile di risposta sostituisce questo insieme di istruzioni con il proprio. A ogni richiesta, Claude Code invia al modello le istruzioni dello stile attivo e, quando è selezionato uno stile diverso da quello predefinito, ricorda anche a Claude quale stile seguire man mano che la conversazione procede. Quindi non devi ripetere come vuoi che risponda.

Usa uno stile quando vuoi in modo costante la stessa modalità di risposta: risposte più brevi, spiegazioni oppure il ruolo di correttore di bozze o analista dei dati invece di quello di programmatore. Se vuoi che Claude ricordi le convenzioni e la struttura di un progetto specifico, usa il file CLAUDE.md.

In cosa differisce uno stile di risposta da CLAUDE.md?

Punti chiave

Uno stile di risposta sostituisce le istruzioni predefinite di Claude Code e si applica a ogni risposta. CLAUDE.md aggiunge un messaggio con il contesto del progetto. Uno stile definisce come rispondere, mentre CLAUDE.md specifica cosa tenere in considerazione quando si lavora al progetto. Questi strumenti non interferiscono tra loro.

Claude Code offre diversi modi per influenzarne il comportamento, ciascuno con uno scopo diverso.

StrumentoCosa faQuando usarlo
Stile di rispostaSostituisce le istruzioni predefinite e si applica a ogni rispostaVuoi ogni volta un ruolo, un tono o un formato di risposta diverso
CLAUDE.mdAggiunge il contesto del progetto dopo il messaggio di sistemaClaude deve conoscere sempre le convenzioni e la struttura del progetto
--append-system-promptAggiunge contenuto al messaggio di sistema all’avvioVuoi un’aggiunta una tantum tramite un flag di avvio
SubagentiAvviano un assistente con un proprio messaggio di sistema e i propri strumentiTi serve un assistente separato per un’attività specifica

Uno stile definisce il modo di rispondere, mentre CLAUDE.md conserva il contesto del progetto. Non serve modificare uno per svolgere il compito dell’altro.

Quali stili integrati sono disponibili e quando usarli?

Punti chiave

Oltre allo stile predefinito, ci sono quattro stili integrati. Proactive fa sì che Claude agisca subito e ponga meno domande di chiarimento. Concise fornisce risposte brevi, senza introduzioni. Explanatory aggiunge spiegazioni mentre Claude lavora. Learning lavora insieme a te e ti lascia piccoli frammenti di codice da completare. Concise è disponibile dalla versione 2.1.237 di Claude Code.

Proactive. Claude esegue subito l’attività, fa supposizioni ragionevoli quando ci sono incertezze minori e preferisce agire anziché discuterne. Questo comportamento è più autonomo della modalità automatica e funziona senza cambiare la modalità di accesso. La modalità di accesso continua a determinare cosa può essere eseguito senza la tua conferma: lo stile rende Claude più risoluto, ma non rimuove le protezioni contro i comandi pericolosi. Questo stile è adatto quando ti fidi dello strumento e non vuoi che si fermi per ogni piccolo chiarimento.

Concise. Claude inizia dal risultato, salta le introduzioni e le descrizioni del proprio processo e mantiene brevi le risposte. Svolge il lavoro con la stessa accuratezza dello stile predefinito e, se chiedi una spiegazione, risponde nel dettaglio. Le segnalazioni di errori, gli avvisi di sicurezza e le conferme prima di azioni pericolose restano complete: questo stile non le abbrevia. È adatto quando vuoi una risposta breve e diretta.

Explanatory. Mentre lavora, Claude spiega perché ha scelto una soluzione e com’è strutturato il codice del progetto. Le risposte sono più lunghe che nello stile predefinito. È adatto quando vuoi capire cosa sta succedendo oltre a ottenere il risultato.

Learning. Una modalità collaborativa: Claude non si limita a spiegare le proprie decisioni, ma lascia anche nel file piccoli frammenti di codice contrassegnati con TODO(human) perché sia tu a scriverli. È adatto quando vuoi imparare facendo e scrivere parte del codice da te.

Suggerimento

Se non sai da dove iniziare, scegli Concise per le risposte brevi oppure Explanatory per capire il ragionamento alla base delle decisioni. Entrambi sono utili anche se non scrivi codice a mano.

Come si cambia stile di risposta?

Punti chiave

Esegui il comando /config in Claude Code e seleziona Output style, quindi lo stile desiderato. La scelta viene salvata nel file .claude/settings.local.json del progetto. Dalla versione 2.1.251, il nuovo stile entra in vigore con il messaggio successivo. Nell’estensione VS Code, gli stili si selezionano dal menu Output styles, disponibile dalla versione 2.1.257.

In alcune istruzioni meno recenti potresti trovare un comando separato per gli stili. La documentazione disponibile descrive il percorso tramite /config.

  1. Apri le impostazioni

    /config
    

    Inserisci il comando nella chat di Claude Code. Si aprirà il menu delle impostazioni.

  2. Seleziona Output style

    Trova la riga Output style nel menu e aprila. Apparirà un elenco con Default e i quattro stili integrati, oltre agli eventuali stili personalizzati che hai creato.

  3. Scegli uno stile e continua a lavorare

    Seleziona lo stile desiderato. Claude Code salverà la scelta in .claude/settings.local.json nel progetto corrente. Dalla versione 2.1.251, il nuovo stile entrerà in vigore con il messaggio successivo.

Se usi l’estensione VS Code, apri il menu con il comando / e scegli Output styles. La scelta verrà salvata nello stesso file. Il menu degli stili nell’estensione è disponibile dalla versione 2.1.257.

Puoi anche impostare uno stile senza usare il menu, inserendolo nel file delle impostazioni:

{
  "outputStyle": "Explanatory"
}

Attenzione

Cambiare stile durante una sessione ha effetto dal messaggio successivo. Questo vale dalla versione 2.1.251 di Claude Code. Nelle versioni precedenti, il nuovo stile entrava in vigore solo dopo il comando /clear o in una nuova sessione: se lo stile «non cambia», controlla prima la versione.

Come si crea uno stile di risposta personalizzato?

Punti chiave

Uno stile personalizzato è un normale file Markdown con una breve intestazione e alcune istruzioni. Inseriscilo nella cartella .claude/output-styles, nella tua cartella home per renderlo disponibile in tutti i progetti oppure all’interno di un progetto. Il nome del file diventa il nome dello stile, a meno che nell’intestazione non sia impostato name. Se crei il file durante una sessione nel terminale, riavvia Claude Code e poi seleziona lo stile tramite /config.

Non serve saper programmare: scrivi le istruzioni in linguaggio semplice. Il file è composto da un’intestazione tra tre trattini (metadati) e dal testo delle istruzioni sottostante.

La posizione del file dipende da dove vuoi che sia disponibile lo stile:

  • ~/.claude/output-styles — lo stile è disponibile in tutti i tuoi progetti.
  • .claude/output-styles all’interno di un progetto — lo stile è disponibile solo per quel progetto.

Ecco un esempio di stile che chiede a Claude di rispondere come editor di testi aziendali anziché come programmatore:

---
name: Editor di testi
description: Rispondere come editor di testi aziendali, non come programmatore
---

Sei un editor di testi aziendali. Rispondi nella lingua preferita dall’utente, con paragrafi brevi.
Fornisci prima la versione corretta, poi un elenco delle modifiche con le relative motivazioni.
Non proporre codice né discutere dettagli tecnici, a meno che non ti venga chiesto.

Nell’intestazione, name è il nome dello stile che vedrai nel menu /config; se lo ometti, viene usato il nome del file. description è una breve spiegazione, visibile anch’essa nel menu.

Esiste anche il campo keep-coding-instructions. Per impostazione predefinita, uno stile personalizzato rimuove le istruzioni di ingegneria integrate in Claude Code, ad esempio su come scrivere commenti, verificare il lavoro e limitare le modifiche. Se vuoi che Claude continui a comportarsi da ingegnere quando usa il tuo stile di risposta, per esempio iniziando sempre con un diagramma, imposta keep-coding-instructions: true nell’intestazione. Se in questo stile Claude non deve lavorare con il codice, come nell’esempio del correttore di bozze, non serve questo campo.

  1. Crea la cartella degli stili

    mkdir -p ~/.claude/output-styles
    

    Così lo stile sarà disponibile in tutti i progetti. Per un singolo progetto, usa .claude/output-styles al suo interno.

  2. Salva il file Markdown

    Inserisci nella cartella un file come redaktor.md e aggiungi l’intestazione e le istruzioni. Puoi usare l’esempio precedente e adattarlo alla tua attività.

  3. Scegli lo stile e verificalo

    Se hai creato il file durante una sessione nel terminale, riavvia prima Claude Code. Apri /config, trova il tuo stile nell’elenco Output style e selezionalo. Assegna a Claude un’attività relativa allo stile e verifica se risponde nel modo desiderato.

Attenzione

Nel terminale di Claude Code, i file degli stili vengono letti all’avvio. Se crei o modifichi uno stile mentre una sessione è in corso, riavvia Claude Code; altrimenti non vedrà il nuovo file.

Il tuo stile personalizzato definisce il modo in cui lo strumento risponde: lo descrivi una volta e lo strumento lo mantiene da quel momento in poi.

Su cosa non influisce uno stile di risposta?

Punti chiave

Uno stile cambia il modo di rispondere, ma non fornisce nuove conoscenze al modello né sostituisce CLAUDE.md. Si applica alla conversazione principale e alla sua diramazione (fork), ma non cambia il comportamento dei subagenti, che hanno un proprio messaggio di sistema. Anche i plugin possono aggiungere stili personalizzati.

Uno stile non aggiunge fatti a ciò che sa il modello. Se Claude non conosce qualcosa del tuo progetto, cambiare stile non risolve il problema: puoi fornire il contesto del progetto tramite CLAUDE.md.

Uno stile si applica alla conversazione principale e alla sua diramazione, che eredita l’intera conversazione. I subagenti, assistenti separati per attività specifiche, usano un proprio messaggio di sistema e lo stile non influisce sulle loro risposte.

Gli stili possono provenire dai plugin, che li inseriscono nella propria cartella output-styles. In tal caso, appaiono nello stesso elenco dei tuoi.

Quanti token costa uno stile?

Punti chiave

Le istruzioni dello stile vengono aggiunte a ogni richiesta, quindi aumentano leggermente i token di input. Explanatory e Learning producono risposte più lunghe e aumentano i token di output, mentre Concise li riduce. La memorizzazione nella cache delle richieste riduce questo sovraccarico dopo il primo messaggio di una sessione.

Le istruzioni dello stile aggiungono token di input, ma la memorizzazione nella cache delle richieste riduce questo costo dopo la prima richiesta di una sessione. La differenza nei token di output è più evidente: Explanatory e Learning sono pensati per risposte più lunghe, mentre Concise le mantiene brevi. Con uno stile personalizzato, il numero di token di output dipende da ciò che specifichi nelle istruzioni.

Non è possibile promettere un risparmio esatto: dipende dalle attività e dal modello. Se vuoi risposte più brevi e meno costose, scegli Concise; se vuoi più dettagli, scegli Explanatory.

Cosa fare per prima cosa?

Punti chiave

Passa a uno degli stili integrati tramite /config e usalo per un giorno, per confrontare le risposte con quelle a cui sei abituato. Poi descrivi in testo semplice lo stile di risposta che usi di solito, salvalo in un file nella cartella .claude/output-styles e provalo su un’attività reale.

Apri /config, scegli Concise o Explanatory e usalo per un’attività abituale. Se ti accorgi di chiedere sempre la stessa cosa, crea uno stile personalizzato seguendo i passaggi qui sopra.

Prossime guide sull’argomento: come personalizzare Claude per te tramite CLAUDE.md, così Claude ricorda il contesto del progetto, e cosa scegliere in Claude Code: Skills, Subagents, MCP o Plugins, se vuoi conoscere altri modi per estenderlo. Se Claude non riesce a vedere i file di cui ha bisogno, consulta perché Claude Code non riesce a vedere i file del progetto.

Scopri Ailoot.

Maggiori dettagli

Domande frequenti

I dati del progetto vanno nello stile di output o in CLAUDE.md?

Inserisci dati, struttura e convenzioni del progetto in CLAUDE.md. Usa uno stile di output per un ruolo, un tono o un formato ricorrente. Lo stile cambia il modo in cui Claude risponde, ma non fornisce le informazioni mancanti sul progetto.

Perché il nuovo stile di output personalizzato non compare?

Salva il file Markdown nella cartella .claude/output-styles del progetto o dell’utente, quindi riavvia la sessione del terminale per caricarlo. Selezionalo da /config e prova un’attività pertinente. Usa keep-coding-instructions: true per conservare le istruzioni di ingegneria nello stile personalizzato.

Tutti gli articoli