Gli stili di output sono DEPRECATI. Il 5 novembre 2025 o successivamente, convertiremo automaticamente i tuoi file di stile di output a livello utente in plugin e interromperemo il supporto della funzione stili di output. Utilizza invece i plugin. (esempio di plugin per lo stile di output Explanatory integrato)

Timeline di deprecazione

A partire dal 5 novembre 2025, Claude Code:
  • Convertirà automaticamente i file di stile di output a livello utente (~/.claude/output-styles) in plugin
  • Interromperà il supporto della funzione stili di output
  • Rimuoverà il comando /output-style e la funzionalità correlata
Cosa devi fare:
  • Esegui la migrazione ai plugin prima del 5 novembre 2025 per una transizione più fluida
  • Rivedi la guida alla migrazione di seguito per comprendere le tue opzioni

Alternativa: Utilizza i plugin

I plugin forniscono modi più potenti e flessibili per personalizzare il comportamento di Claude Code. Il plugin explanatory-output-style ricrea la funzionalità dello stile di output Explanatory deprecato.

Esempio: Plugin dello stile di output esplicativo

Il plugin explanatory-output-style utilizza un hook SessionStart per iniettare contesto aggiuntivo che incoraggia Claude a fornire approfondimenti educativi. Ecco cosa fa:
  • Fornisce approfondimenti educativi sulle scelte di implementazione
  • Spiega i modelli e le decisioni della codebase
  • Bilancia il completamento dei compiti con le opportunità di apprendimento

Installazione di un plugin

Per installare un plugin come explanatory-output-style:
Aggiungi il marketplace (se non già aggiunto)
/plugin marketplace add anthropics/claude-code
Installa il plugin
/plugin install explanatory-output-style@claude-code-plugins
Riavvia Claude Code per attivare il plugin
/exit
Disabilita il plugin
/plugin manage explanatory-output-style@claude-code-plugins

1. Premi invio quando vedi claude-code-marketplace
2. Premi spazio quando vedi explanatory-output-style per attivare/disattivare
3. Premi giù su "Apply changes", quindi premi invio
    Dovresti vedere "Disabled 1 plugin. Restart Claude Code to apply changes."

/exit
Per ulteriori dettagli sui plugin, consulta la documentazione dei plugin.

Guida alla migrazione

Gli stili di output hanno modificato direttamente il prompt di sistema di Claude Code. Ecco come ottenere effetti simili con hook e subagent, entrambi disponibili tramite i plugin di Claude Code:

Utilizza gli hook SessionStart per l’iniezione di contesto

Se hai utilizzato stili di output per aggiungere contesto all’inizio delle sessioni, utilizza invece gli hook SessionStart. L’output dell’hook (stdout) viene aggiunto al contesto della conversazione. Puoi anche:
  • Eseguire script che generano dinamicamente il contesto
  • Caricare informazioni specifiche del progetto
Gli hook SessionStart, proprio come CLAUDE.md, non modificano il prompt di sistema.

Utilizza i Subagent per diversi prompt di sistema

Se hai utilizzato stili di output per modificare il comportamento di Claude per compiti specifici, utilizza invece i Subagent. I Subagent sono assistenti AI specializzati con:
  • Prompt di sistema personalizzati (devono essere in una finestra di contesto separata dal ciclo principale)
  • Autorizzazioni di accesso agli strumenti specifiche
  • Modello opzionale da utilizzare, se non il modello del ciclo principale

Riferimento: Documentazione originale degli stili di output

Il contenuto di seguito è conservato solo per riferimento. Gli stili di output sono deprecati e verranno rimossi il 5 novembre 2025. Esegui la migrazione ai plugin, agli hook o ai subagent.
Gli stili di output ti permettono di utilizzare Claude Code come qualsiasi tipo di agente mantenendo le sue capacità principali, come l’esecuzione di script locali, la lettura/scrittura di file e il tracciamento dei TODO.

Stili di output integrati

Lo stile di output Default di Claude Code è il prompt di sistema esistente, progettato per aiutarti a completare i compiti di ingegneria del software in modo efficiente. Ci sono due stili di output integrati aggiuntivi focalizzati sull’insegnarti la codebase e come opera Claude:
  • Explanatory: Fornisce “Insights” educativi tra l’aiutarti a completare i compiti di ingegneria del software. Ti aiuta a comprendere le scelte di implementazione e i modelli della codebase.
  • Learning: Modalità collaborativa di apprendimento pratico in cui Claude non solo condividerà “Insights” durante la codifica, ma ti chiederà anche di contribuire con piccoli e strategici pezzi di codice tu stesso. Claude Code aggiungerà marcatori TODO(human) nel tuo codice per te da implementare.

Come funzionano gli stili di output

Gli stili di output modificano direttamente il prompt di sistema di Claude Code.
  • Gli stili di output non predefiniti escludono le istruzioni specifiche per la generazione di codice e l’output efficiente normalmente integrati in Claude Code (come rispondere in modo conciso e verificare il codice con i test).
  • Invece, questi stili di output hanno le loro istruzioni personalizzate aggiunte al prompt di sistema.

Cambia il tuo stile di output

Puoi:
  • Eseguire /output-style per accedere al menu e selezionare il tuo stile di output (questo può essere accessibile anche dal menu /config)
  • Eseguire /output-style [style], come /output-style explanatory, per passare direttamente a uno stile
Questi cambiamenti si applicano al livello di progetto locale e vengono salvati in .claude/settings.local.json. Puoi anche creare i tuoi file Markdown di stile di output e salvarli a livello utente (~/.claude/output-styles) o a livello di progetto (.claude/output-styles).

Confronti con funzioni correlate

Stili di output vs. CLAUDE.md vs. —append-system-prompt

Gli stili di output “disattivano” completamente le parti del prompt di sistema predefinito di Claude Code specifiche per l’ingegneria del software. Né CLAUDE.md né --append-system-prompt modificano il prompt di sistema predefinito di Claude Code. CLAUDE.md aggiunge i contenuti come messaggio utente seguendo il prompt di sistema predefinito di Claude Code. --append-system-prompt aggiunge il contenuto al prompt di sistema.

Stili di output vs. Agenti

Gli stili di output influenzano direttamente il ciclo dell’agente principale e influenzano solo il prompt di sistema. Gli agenti vengono invocati per gestire compiti specifici e possono includere impostazioni aggiuntive come il modello da utilizzare, gli strumenti disponibili e un contesto su quando utilizzare l’agente.

Stili di output vs. Comandi Slash personalizzati

Puoi pensare agli stili di output come “prompt di sistema archiviati” e ai comandi slash personalizzati come “prompt archiviati”.