Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 applica la stessa guida della modalità auto 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.
1

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

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

Passare al vostro stile

Eseguite /config e selezionate il vostro stile sotto Output style. Ha effetto dopo /clear o la prossima volta che avviate una sessione.
I Plugins possono anche fornire output styles in una directory output-styles/.

​
Frontmatter

I file di output style supportano questi campi frontmatter:
FrontmatterScopoPredefinito
nameNome dell’output style, se non il nome del fileEredita dal nome del file
descriptionDescrizione dell’output style, mostrata nel picker /configNessuno
keep-coding-instructionsMantenere le istruzioni integrate di ingegneria del software di Claude Codefalse
force-for-pluginSolo 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

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.
FunzionalitàCome funzionaUtilizzatela quando
Output stylesModifica il prompt di sistemaDesiderate un ruolo, tono o formato di risposta predefinito diverso ad ogni turno
CLAUDE.mdAggiunge un messaggio utente dopo il prompt di sistemaClaude dovrebbe sempre conoscere le convenzioni del vostro progetto e il contesto del codebase
--append-system-promptAggiunge al prompt di sistema senza rimuovere nullaDesiderate un’aggiunta una tantum per una singola invocazione
AgentsEsegue un subagent con il suo prompt di sistema, modello e strumentiDesiderate un helper con ambito separato per un compito focalizzato
SkillsCarica istruzioni specifiche per compiti quando invocate o rilevantiAvete un flusso di lavoro riutilizzabile

​
Risorse correlate

  • Settings: dove risiede il campo outputStyle e come funziona la precedenza delle impostazioni
  • Permission modes: lo stile Proactive rispecchia la modalità auto senza cambiare la vostra modalità di permesso
  • Plugins: pacchetto e distribuzione degli output styles insieme a skills, hooks e agents
  • Debug your configuration: diagnosticare perché uno output style non ha effetto