CLAUDE_CODE_MAX_OUTPUT_TOKENS: spiegazione dei limiti di output e delle cartelle dei plugin in Claude Code 2.1.265

Che cosa controlla claude_code_max_output_tokens

La documentazione di riferimento delle variabili d’ambiente descrive CLAUDE_CODE_MAX_OUTPUT_TOKENS come la variabile che imposta «il numero massimo di token di output per la maggior parte delle richieste». Questa formulazione è importante: descrive un budget di output per le richieste, con valori predefiniti e limiti massimi che variano in base al modello.

La variabile è quindi pertinente quando si esamina un limite di output di Claude Code. Non va considerata un limite universale per ogni tipo di dato gestito da Claude Code. La versione 2.1.265 introduce anche un limite su disco per i risultati degli strumenti salvati, ma tale limite misura i dati degli strumenti archiviati in gigabyte, non l’output generato in token.

La documentazione della configurazione richiede una precisazione sul piano storico. La documentazione di riferimento delle variabili d’ambiente viene aggiornata continuamente e non è stato possibile recuperare la sua esatta revisione di settembre 10. La descrizione spiega lo scopo della variabile, ma la pagina non attesta tutti i valori predefiniti applicabili a Claude Code 2.1.265.

Per un articolo riferito a una data precisa, le prove numeriche più solide provengono dalle note di rilascio contrassegnate con un tag di versione. Queste note attestano specifiche modifiche precedenti senza dover ricavare una tabella completa dei valori predefiniti dalla documentazione corrente.

Tre limiti da tenere distinti

Quando si analizza un limite, occorre prima identificare quale di questi si applica. Un’impostazione del budget di token e un limite di archiviazione su disco richiedono interpretazioni diverse, anche quando entrambi compaiono nella stessa sessione di sviluppo.

Valori predefiniti e limiti massimi di output verificati

La Note di rilascio della v2.1.77, datate 17 marzo 2026, documentano due modifiche pertinenti: il valore predefinito di Claude Opus 4.6 è stato aumentato a 64k token di output e il limite superiore per Opus 4.6 e Sonnet 4.6 è stato aumentato a 128k token. Queste modifiche sono riportate anche nel registro delle modifiche contrassegnato con il tag v2.1.265.

Queste prove escludono che «32,000 come valore predefinito, 64,000 come massimo» possa essere presentato come una regola universale di Claude Code. Non giustificano neppure l’inserimento dei valori predefiniti mancanti per altri modelli.

La distinzione da mantenere è quella tra una modifica documentata e una documentazione di riferimento completa della configurazione. Il rilascio di marzo attesta le modifiche sopra indicate; le fonti datate disponibili non attestano una tabella completa dei valori predefiniti per ciascun modello nella v2.1.265.

Le specifiche dei modelli più recenti non attestano i valori predefiniti della CLI

La note di rilascio dei modelli documentano un output massimo di 128k e una finestra di contesto di 1 milioni di token per Claude Sonnet 5, Claude Opus 5 e Claude Fable 5.1. I rispettivi ID API esatti sono claude-sonnet-5, claude-opus-5e claude-fable-5-1, rispettivamente.

Questi annunci erano disponibili prima della data limite di pubblicazione: Sonnet 5 il 30 giugno, Opus 5 il 24 luglio e Fable 5.1 il 1 settembre 2026. Tuttavia, le specifiche dei modelli non costituiscono una prova del budget predefinito delle richieste di Claude Code.

Per gli sviluppatori che devono scegliere un modello, la guida ai modelli di Claude Code offre letture correlate. Occorre tenere distinto il massimo pubblicato del modello dal budget di output predefinito utilizzato dalla CLI.

Impostare la variabile e comprendere la compattazione

La documentazione corrente prevede la possibilità di impostare la variabile prima di avviare claude, oppure di inserirla sotto la env chiave in settings.json. Poiché non è stato possibile recuperare l’esatta revisione della documentazione disponibile il 10 settembre, gli esempi seguenti rappresentano schemi di configurazione documentati, con questa precisazione storica.

Configurazione nella shell

L’esempio di shell fornito imposta il budget di output a 64,000 token:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

Lo schema documentato consiste nell’impostare la variabile prima di avviare Claude Code. Il numero riportato in questo esempio è un valore di configurazione scelto; non implica che 64,000 sia il valore predefinito o massimo per ogni modello.

Quando si registra la configurazione per un progetto o una sessione di risoluzione dei problemi, occorre indicare il modello selezionato insieme al budget richiesto. Senza il modello, un valore da solo non permette di capire se corrisponde a un valore predefinito documentato o rientra in un limite superiore documentato.

Configurazione in settings.json

L’esempio equivalente fornito in JSON inserisce la variabile sotto env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

In questo esempio il valore è una stringa. Come per l’impostazione nella shell, il frammento esprime un budget richiesto e non dimostra un valore predefinito specifico del modello.

Per informazioni correlate sull’uso della riga di comando, consultare la riferimento della CLI di Claude Code. Le prove storiche qui riportate confermano il ruolo della variabile e gli esempi di configurazione forniti, lasciando però indeterminato l’insieme completo dei valori predefiniti della v2.1.265.

Che cosa è stato verificato sulla compattazione?

Il registro delle modifiche contrassegnato con il tag v2.1.265 riporta una precedente correzione nella v2.1.69 relativa a CLAUDE_CODE_MAX_OUTPUT_TOKENS che veniva ignorata durante la compattazione della conversazione. Si tratta di un collegamento verificato tra questa impostazione e il comportamento della compattazione.

La documentazione corrente di riferimento delle variabili d’ambiente spiega anche che aumentare l’impostazione riduce il contesto effettivamente disponibile prima della compattazione automatica. La data di pubblicazione di questa spiegazione è incerta, quindi non può essere presentata come una descrizione verificata di settembre 10.

L’impostazione non va quindi descritta come un modo per ampliare la finestra di contesto pubblicata del modello. Le prove datate attestano un controllo del budget di output e una correzione relativa alla compattazione; non attestano una soglia di compattazione precisa per ogni modello nella v2.1.265.

Come Claude Code 2.1.265 carica le cartelle dei plugin

Claude Code v2.1.265 è stato rilasciato il 8 settembre 2026, con il commit di rilascio 8e02f6d. La modifica al caricamento delle cartelle consente a --plugin-dir di puntare a una cartella contenente più plugin.

Il comando fornito è:

claude --plugin-dir ./plugins

Il rilascio descrive direttamente la regola di individuazione: «viene caricata ogni sottocartella dotata di un manifest». Specifica inoltre che le aggiunte e le rimozioni vengono rilevate durante l’esecuzione di Claude Code.

Questo rende la cartella padre l’unità utile per gestire più plugin insieme. Il comportamento garantito dalla documentazione riguarda le sottocartelle che contengono manifest; le note di rilascio non specificano un’individuazione ricorsiva. Non bisogna presumere che venga esplorato un albero di directory con livelli di annidamento arbitrari.

Struttura del manifest e precisazione storica

La documentazione corrente di riferimento dei plugin colloca il manifest in .claude-plugin/plugin.json e le directory dei componenti, come skills/, commands/e hooks/ nella directory radice del plugin. Non è stato possibile recuperare questa documentazione come snapshot datato della v2.1.265.

Per l’articolo del 10 settembre, occorre distinguere queste indicazioni correnti sulla struttura dalla garanzia esplicita del rilascio: le sottocartelle dotate di manifest vengono caricate. Il rilascio attesta l’individuazione dei plugin in una cartella che ne contiene più di uno, senza attestare ogni dettaglio della documentazione sulla struttura disponibile all’epoca.

Correzioni dei plugin incluse nel rilascio

La versione 2.1.265 corregge anche tre problemi dei plugin:

• Un percorso di plugin contenente barre rovesciate poteva aggirare il controllo di contenimento dei collegamenti simbolici su macOS e Linux.
• Le directory il cui nome iniziava con due punti venivano erroneamente rifiutate.
• Le cartelle predefinite dei componenti non leggibili venivano ignorate senza segnalazioni; ora compaiono in /plugin con un codice di errore.

Queste correzioni riguardano i percorsi dei plugin e il caricamento dei componenti. Se una cartella di plugin non viene caricata, forniscono un contesto pertinente al rilascio, ma l’impostazione dei token di output non spiega questi problemi di gestione delle directory.

Il limite di 1 GB per i risultati degli strumenti salvati è un limite distinto

La versione 2.1.265 aggiunge un limite di 1 GB ai risultati degli strumenti salvati su disco. L’anteprima della conversazione segnala il troncamento.

Questo limite riguarda i dati degli strumenti archiviati. CLAUDE_CODE_MAX_OUTPUT_TOKENS riguarda il numero massimo di token di output per la maggior parte delle richieste. Il rilascio non descrive la variabile d’ambiente come un controllo del limite su disco, quindi aumentarne il valore non va presentato come un rimedio al troncamento dei risultati degli strumenti salvati.

Le note di rilascio non specificano neppure se il limite di 1 GB si applichi a ciascun risultato, a ciascuna sessione o a un altro raggruppamento. Questa incertezza va mantenuta quando si documenta il comportamento: «limite di 1 GB ai risultati degli strumenti salvati su disco» è la descrizione verificata.

Una distinzione utile nella risoluzione dei problemi riguarda le informazioni mostrate allo sviluppatore. Un’anteprima della conversazione che segnala un troncamento è legata al nuovo comportamento dei risultati salvati. Una domanda sul budget dell’output generato da un modello va esaminata in relazione al modello selezionato e all’impostazione dei token. Un codice di errore del plugin in /plugin è legato al caricamento dei plugin.

Si tratta di controlli e strumenti diagnostici distinti, introdotti o discussi nel contesto della stessa release. Trattarli separatamente evita di usare una modifica alla configurazione dei token per spiegare comportamenti non correlati relativi all'archiviazione o alle cartelle.

L'aggiornamento correttivo del gateway disponibile entro il 10 settembre

Anche la versione 2.1.266 è stata rilasciata il 8 settembre, quindi rientra nella data limite considerata da questo articolo. Le Note di rilascio della v2.1.266 correggono una regressione nell'autenticazione del gateway della v2.1.265 che riguarda CLAUDE_CODE_USE_GATEWAY.

L'errore in questione è «Accesso al gateway cloud non effettuato». La release indica che non è necessaria alcuna modifica alla configurazione.

Per uno sviluppatore che riscontra esattamente questa regressione nella v2.1.265, la release correttiva è direttamente pertinente. Aumentare il budget dei token di output o riorganizzare le cartelle dei plugin non è la soluzione documentata.

Gli stessi flussi di lavoro possono essere eseguiti tramite un gateway API come AI Prime Tech; consulta usare Claude Code con una chiave API per indicazioni correlate sulla configurazione. AI Prime Tech opera in modo indipendente e non è affiliata ad Anthropic o OpenAI.

Punti chiave

• CLAUDE_CODE_MAX_OUTPUT_TOKENS imposta il numero massimo di token di output per la maggior parte delle richieste; i valori predefiniti e i limiti massimi variano in base al modello.
• La v2.1.77 ha aumentato il valore predefinito di Opus 4.6 a 64k e il limite massimo di Opus 4.6/Sonnet 4.6 a 128k. Una tabella completa dei valori predefiniti della v2.1.265 resta da verificare.
• Il numero massimo di token di output del modello, la capacità del contesto del modello e lo spazio di archiviazione dei risultati degli strumenti salvati sono limiti distinti.
• Nella v2.1.265, --plugin-dir può caricare più plugin dalle sottocartelle dotate di manifest e rilevare aggiunte e rimozioni durante l'esecuzione.
• La v2.1.265 introduce il limite di 1 GB per i risultati degli strumenti salvati; la v2.1.266 corregge la regressione nell'autenticazione del gateway senza richiedere modifiche alla configurazione.

FAQ

Che cosa controlla CLAUDE_CODE_MAX_OUTPUT_TOKENS?

CLAUDE_CODE_MAX_OUTPUT_TOKENS imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti massimi variano in base al modello ed è un'impostazione distinta dal limite di 1 GB della v2.1.265 per i risultati degli strumenti salvati su disco.

Quali sono i limiti di output predefiniti e massimi?

La v2.1.77 ha aumentato il valore predefinito di Claude Opus 4.6 a 64k token di output e il limite massimo di Opus 4.6/Sonnet 4.6 a 128k. Le fonti datate esaminate non permettono di stabilire il valore predefinito di Sonnet 4.6 né una tabella completa dei valori predefiniti per ciascun modello nella v2.1.265.

Aumentare il valore dell'impostazione amplia la finestra di contesto?

Lo scopo documentato è impostare un budget di token di output, non ampliare la finestra di contesto pubblicata del modello. La v2.1.69 ha corretto il problema per cui la variabile veniva ignorata durante la compattazione, ma la spiegazione del suo effetto sulla compattazione automatica nella documentazione corrente ha una data di pubblicazione incerta.

In che modo --plugin-dir individua più plugin?

In Claude Code 2.1.265, --plugin-dir può puntare a una cartella principale e ogni sottocartella dotata di manifest viene caricata. Le aggiunte e le rimozioni vengono rilevate durante l'esecuzione di Claude Code; le note di rilascio non specificano se l'individuazione sia ricorsiva.