Riferimento degli errori

Consulta i messaggi di errore di runtime di Claude Code con il significato di ciascuno e come risolverli.

Questa pagina elenca gli errori di runtime che Claude Code visualizza e come recuperare da ciascuno, oltre a cosa controllare quando le risposte sembrano non corrette senza un errore. Per gli errori di installazione come command not found o errori TLS durante la configurazione, vedi Troubleshooting installation and login.

Questi errori e i comandi di recupero si applicano su CLI, l'app Desktop e Claude Code sul web, poiché tutti e tre avvolgono lo stesso Claude Code CLI. Per problemi specifici della superficie, vedi la sezione troubleshooting nella pagina di quella superficie.

Trova il tuo errore

Abbina il messaggio che vedi nel tuo terminale a una sezione sottostante.

Tentativi automatici

Claude Code ritenta i guasti transitori prima di mostrarti un errore. Gli errori del server, le risposte sovraccariche, i timeout delle richieste, i throttle 429 temporanei e le connessioni interrotte vengono tutti ritentati fino a 10 volte con backoff esponenziale. {/* min-version: 2.1.198 /}A partire da v2.1.198, questo copre le connessioni che si interrompono nel mezzo di una risposta prima che qualsiasi output visibile sia stato trasmesso: Claude Code ri-emette la richiesta con lo stesso backoff e il turno continua invece di fermarsi con un errore di connessione. {/ min-version: 2.1.199 */}A partire da v2.1.199, i throttle 429 temporanei che non portano le intestazioni di quota del tuo piano vengono anche ritentati quando sei connesso con un abbonamento claude.ai; le versioni precedenti li ritentavano solo per le chiavi API e gli accessi Enterprise.

Due classi di guasti non vengono ritentate, perché un tentativo non può avere successo:

• {/* min-version: 2.1.199 */}A partire da v2.1.199, un guasto di convalida del certificato TLS, come un proxy che ispeziona TLS, un bundle NODE_EXTRA_CA_CERTS mancante, o un certificato scaduto, fallisce al primo tentativo in modo che la correzione appaia immediatamente invece che dopo il budget di tentativo completo. Vedi Errori del certificato SSL. Le condizioni TLS transitorie come un timeout di handshake continuano a ritentare.
• {/* min-version: 2.1.199 */}A partire da v2.1.199, un errore del server che arriva dopo che Claude ha già trasmesso output visibile mantiene la risposta parziale e aggiunge un avviso di risposta incompleta invece di ritentare, poiché ri-eseguire la richiesta potrebbe eseguire le stesse chiamate di strumento due volte. Le versioni precedenti scartavano l'output parziale e segnalano il turno come un errore.

Durante il tentativo, lo spinner mostra un countdown Retrying in Ns · attempt x/y dopo un'etichetta di errore. L'etichetta nomina il motivo specifico dal primo tentativo per i guasti su cui puoi agire subito: la rete è inattiva, un handshake TLS non è riuscito, o hai raggiunto un limite di velocità. Per altri errori legge API error all'inizio. {/* min-version: 2.1.198 */}A partire da v2.1.198 passa al motivo specifico dal terzo tentativo, o al tentativo finale quando CLAUDE_CODE_MAX_RETRIES consente meno di tre; le versioni precedenti passano solo al tentativo finale.

{/* min-version: 2.1.198 */}A partire da v2.1.198, il suggerimento dello spinner usuale è soppresso durante i tentativi. Una volta rivelato il motivo dell'errore, se il guasto è un sovraccarico 529 la riga sotto il countdown nomina anche dove controllare lo stato del servizio: status.claude.com sull'API Anthropic, o l'host del provider o gateway indicato nel messaggio su altre configurazioni.

{/* min-version: 2.1.185 */}Se nessun dato arriva sul flusso di risposta per 20 secondi mentre una richiesta è ancora in sospeso, lo spinner mostra Waiting for API response · will retry in … · check your network prima che qualsiasi tentativo sia iniziato. La richiesta non è ancora fallita: il countdown viene eseguito fino al punto in cui Claude Code interrompe la connessione bloccata e ritenta, quindi il banner si cancella da solo una volta che i dati riprendono o il tentativo ha successo. A partire da v2.1.185 la soglia è di 20 secondi; le versioni precedenti mostrano il banner dopo 10 secondi con una formulazione diversa. Se riappare ad ogni tentativo, trattalo come un problema di rete.

Quando vedi uno degli errori in questa pagina, quei tentativi sono già stati esauriti, a meno che non appartenga a una classe che non viene ritentata, come un guasto di convalida del certificato. Puoi regolare il comportamento con queste variabili di ambiente:

Errori del server

Questi errori provengono dal provider di inferenza piuttosto che dal vostro account o dalla vostra richiesta. Sull'API Anthropic significa l'infrastruttura Anthropic. Su Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry o un gateway personalizzato significa l'infrastruttura di quel provider.

API Error: 500 Internal server error

Claude Code mostra il codice di stato e il messaggio di errore dell'API per qualsiasi risposta 5xx. L'esempio seguente mostra una risposta 500 sull'API Anthropic:

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

La frase finale indica dove controllare lo stato del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry indicano lo stato del servizio di quel provider. Un ANTHROPIC_BASE_URL personalizzato indica l'host del gateway.

Questo indica un errore imprevisto all'interno dell'API. Non è causato dal vostro prompt, dalle impostazioni o dall'account.

Cosa fare:

• Controllate status.claude.com, o la pagina di stato del provider indicata nel messaggio, per gli incidenti attivi
• Aspettate un minuto, quindi inviate di nuovo il vostro messaggio. Il vostro messaggio originale è ancora nella conversazione, quindi per un prompt lungo potete digitare try again invece di incollare l'intera cosa.
• Se l'errore persiste senza alcun incidente segnalato, eseguite /feedback in modo che Anthropic possa investigare con i dettagli della vostra richiesta. Consultate Report an error se /feedback non è disponibile nel vostro ambiente.

API Error: Repeated 529 Overloaded errors

L'API è temporaneamente al massimo della capacità per tutti gli utenti. Claude Code ha già ritentato più volte prima di mostrare questo messaggio:

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

La frase finale varia in base al provider nello stesso modo dell'errore 500 sopra.

Un 529 non è il vostro limite di utilizzo e non conta rispetto alla vostra quota.

Cosa fare:

• Controllate status.claude.com, o la pagina di stato del provider indicata nel messaggio, per gli avvisi di capacità
• Ritentate tra pochi minuti
• Eseguite /model e passate a un modello diverso per continuare a lavorare, poiché la capacità è tracciata per modello. Claude Code vi chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio Opus is experiencing high load, please use /model to switch to Sonnet.

Request timed out

L'API non ha risposto prima della scadenza della connessione.

Request timed out

Questo può accadere durante periodi di carico elevato o quando il modello sta generando una risposta molto grande. Il timeout di richiesta predefinito è di 10 minuti.

Cosa fare:

• Ritentate la richiesta
• Per attività di lunga durata, suddividete il lavoro in prompt più piccoli
• Se la causa è una rete lenta o un proxy, aumentate API_TIMEOUT_MS come descritto in Automatic retries
• Se i timeout sono frequenti e la vostra rete è altrimenti sana, consultate Network and connection errors di seguito

The response above may be incomplete

Una risposta in streaming non è riuscita dopo che Claude aveva già prodotto un output visibile. L'invio nuovamente della richiesta potrebbe eseguire le stesse chiamate di strumento due volte, quindi Claude Code mantiene ciò che è già stato trasmesso e aggiunge questo avviso invece di scartare il turno. La variante che vedete indica la causa:

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.

• {/* min-version: 2.1.199 */}Server error mid-response: un errore di server sovraccarico o 5xx a metà flusso. Questa variante richiede Claude Code v2.1.199 o successivo; prima di allora quel caso scartava l'output parziale e segnalava l'intero turno come errore.
• Connection closed mid-response: la connessione è stata interrotta.
• Response stalled mid-stream: il flusso ha smesso di inviare dati.

Cosa fare:

• Leggete la risposta che è stata trasmessa. Nulla è stato perso, ma le frasi finali o le chiamate di strumento potrebbero mancare.
• Rispondete con continue per fare in modo che Claude riprenda da dove si era fermato
• Se lo stesso errore appare prima di qualsiasi output visibile, Claude Code ritenta la richiesta invece di finalizzarla. Consultate Automatic retries.

Auto mode cannot determine the safety of an action

Il modello che auto mode utilizza per classificare le azioni non ha potuto produrre una decisione, quindi auto mode non ha approvato l'azione automaticamente. Il messaggio che vedete dipende dal motivo per cui il classificatore non è riuscito.

Le letture, le ricerche e le modifiche all'interno della vostra directory di lavoro saltano il classificatore, quindi continuano a funzionare in tutti questi casi.

Quando il modello classificatore è sovraccarico:

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

Cosa fare:

• Ritentate dopo pochi secondi; Claude vede lo stesso messaggio e di solito ritenta da solo
• Se i tentativi continuano a fallire, continuate con attività di sola lettura e tornate all'azione bloccata in seguito
• Questo è transitorio e non correlato all'idoneità di auto mode; non è necessario modificare le impostazioni

Quando il classificatore ha restituito una risposta non analizzabile:

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

Cosa fare:

• Ritentate l'azione; di solito ha successo al tentativo successivo
• Eseguite claude --debug e ripetete l'azione per vedere la risposta del classificatore sottostante nel log di debug

Quando un controllo di sicurezza API separato ha bloccato la richiesta del classificatore a causa del contenuto della conversazione precedente:

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

Cosa fare:

• Questa non è una decisione sulla vostra azione. Il contenuto già nella vostra conversazione ha attivato un filtro di sicurezza sull'API quando auto mode ha inviato la conversazione al classificatore
• Ritentare non aiuterà; lo stesso contenuto della conversazione attiverà di nuovo il filtro
• Passate a una modalità di autorizzazione diversa in modo da poter approvare l'azione quando richiesto, o iniziate una conversazione nuova senza il contenuto che attiva il filtro

Quando la conversazione è cresciuta oltre la finestra di contesto del classificatore:

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

In una sessione interattiva, auto mode ritorna a un normale prompt di autorizzazione per quell'azione in modo da poter approvare o negare manualmente. In modalità non interattiva l'esecuzione si interrompe perché la trascrizione cresce solo e ritentare non può avere successo.

Cosa fare:

• Approvate o negate l'azione nel prompt che appare
• Eseguite /compact per ridurre la dimensione della conversazione in modo che le azioni successive si adattino di nuovo alla finestra del classificatore

Agent terminated early due to an API error

{/* min-version: 2.1.199 */}La richiesta API di un subagent non è riuscita in modo terminale, ad esempio perché è stato raggiunto un limite di utilizzo o i tentativi per un errore del server si sono esauriti, quindi il subagent si è fermato prima di completare il suo compito. Questo messaggio richiede Claude Code v2.1.199 o successivo; prima di allora il testo di errore dell'API è stato restituito a Claude come se fosse il risultato del subagent.

Agent terminated early due to an API error: <error detail>

Cosa fare:

• Abbinate il dettaglio dell'errore dopo i due punti alla sua sezione su questa pagina, come Usage limits o Server errors, e seguite i passaggi di quella sezione
• Una volta che l'errore sottostante si risolve, chiedete a Claude di ritentare il compito o riprendere il subagent

Quando un limite di velocità, un sovraccarico o un errore del server interrompe un subagent in primo piano che ha già prodotto un output di testo, Claude riceve quell'output parziale contrassegnato come incompleto invece di questo errore. {/* min-version: 2.1.200 */}Un subagent il cui unico output era chiamate di strumento riceve anche questo errore; nella v2.1.199 quella forma ha restituito un risultato parziale vuoto. Consultate API errors in subagents.

Limiti di utilizzo

Questi errori significano che è stata raggiunta una quota associata al vostro account o piano. Sono distinti dagli errori del server, che interessano tutti.

Avete raggiunto il vostro limite di sessione

I piani di abbonamento includono un'indennità di utilizzo mobile. Quando si esaurisce, vedete uno di questi messaggi:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

Claude Code blocca ulteriori richieste fino all'ora di ripristino mostrata nel messaggio. I limiti di sessione e settimanali sono condivisi tra tutti i modelli, quindi il cambio di modello non ripristina l'accesso. Il limite di Opus si applica solo alle richieste di Opus, quindi il passaggio a un altro modello con /model vi permette di continuare a lavorare.

Cosa fare:

• Attendete l'ora di ripristino mostrata nell'errore
• Per il limite di Opus, eseguite /model e passate a un altro modello per continuare a lavorare
• Eseguite /usage per vedere i vostri limiti di piano e quando si ripristinano
• Eseguite /usage-credits per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al vostro amministratore su Team ed Enterprise. Consultate usage credits per piani a pagamento per informazioni su come viene fatturato.
• Per aggiornare il vostro piano per limiti di base più elevati, consultate claude.com/pricing

Per monitorare l'indennità rimanente prima di raggiungere il limite, aggiungete i campi rate_limits a una riga di stato personalizzata, oppure nell'app Desktop fate clic sull'anello di utilizzo accanto al selettore di modello.

Crediti di utilizzo richiesti per il contesto 1M

Il modello selezionato utilizza la finestra di contesto estesa da 1M token, e il vostro piano lo include solo tramite crediti di utilizzo.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

Questo è un controllo di diritto, non un esaurimento della quota. Si attiva anche quando le vostre indennità di sessione e settimanali hanno capacità rimanente. Consultate Extended context per sapere quali piani includono il contesto 1M direttamente e quali richiedono crediti di utilizzo.

{/* min-version: 2.1.172 */}Quando questo errore appare a metà conversazione perché il contesto è cresciuto oltre i 200K token, Claude Code compatta automaticamente la conversazione al di sotto del limite di contesto standard e mantiene la sessione a quel limite in seguito, quindi non è necessaria alcuna azione. Nelle versioni precedenti a v2.1.172, l'errore si ripeteva su ogni richiesta successiva incluso /compact; eseguite /clear su quelle versioni per recuperare. I passaggi seguenti si applicano quando avete esplicitamente selezionato un modello [1m].

Cosa fare:

• Eseguite /model e selezionate la variante senza il suffisso [1m] per tornare alla finestra di contesto standard
• Eseguite /usage-credits per attivare la fatturazione a consumo per la variante 1M su Pro e Max, o per richiederla al vostro amministratore su Team ed Enterprise
• Se l'errore persiste dopo /model, un ID modello 1M potrebbe essere impostato altrove. Consultate There's an issue with the selected model per i percorsi di configurazione da controllare in ordine di priorità.
• Per rimuovere completamente le varianti 1M dal selettore di modello, impostate CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Il server sta limitando temporaneamente le richieste

L'API ha applicato un throttle di breve durata non correlato alla vostra quota di piano.

API Error: Server is temporarily limiting requests (not your usage limit)

Claude Code distingue questi dai vostri limiti di piano dall'assenza delle intestazioni di quota unificate che una vera risposta di limite contiene. {/* min-version: 2.1.199 */}A partire da v2.1.199 questo viene ritentato automaticamente con backoff prima di essere mostrato, indipendentemente da come vi autenticate. Nelle versioni precedenti, una sessione acceduta con un abbonamento claude.ai falliva il turno alla prima occorrenza; solo le autenticazioni con chiave API ed Enterprise lo ritentavano.

Cosa fare:

• Attendete brevemente e riprovate
• Controllate status.claude.com se persiste

Richiesta rifiutata (429)

Avete raggiunto il limite di velocità configurato per la vostra chiave API, il progetto Amazon Bedrock o il progetto Google Cloud.

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

La frase finale indica dove controllare l'integrità del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry indicano lo stato del servizio di quel provider invece della pagina di stato di Anthropic. Un ANTHROPIC_BASE_URL personalizzato indica l'host del gateway.

Cosa fare:

• Eseguite /status e confermate che le credenziali attive siano quelle che vi aspettate. Un ANTHROPIC_API_KEY casuale nel vostro ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del vostro abbonamento.
• Controllate la console del vostro provider per i limiti attivi e richiedete un livello superiore se necessario
• Per le chiavi API di Anthropic, consultate il riferimento dei limiti di velocità per sapere come funzionano i livelli e come impostare i limiti di spesa per workspace
• Riducete la concorrenza: abbassate CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, evitate di eseguire molti subagent paralleli, o passate a un modello più piccolo con /model per esecuzioni scriptate ad alto volume

Il saldo dei crediti è troppo basso

La vostra organizzazione Console ha esaurito i crediti prepagati.

Credit balance is too low

Cosa fare:

• Aggiungete crediti su platform.claude.com/settings/billing, e considerate di abilitare l'auto-reload lì in modo che il saldo si ricarichi prima di raggiungere lo zero
• Passate all'autenticazione con abbonamento con /login se avete un piano Pro, Max, Team o Enterprise
• Impostate i limiti di spesa per workspace nella Console per evitare che un singolo progetto esaurisca il saldo dell'organizzazione. Consultate Manage costs effectively.

Errori di autenticazione

Questi errori significano che Claude Code non può provare la vostra identità all'API. Eseguite /status in qualsiasi momento per vedere quale credenziale è attualmente attiva.

Non connesso

Nessuna credenziale valida è disponibile per questa sessione.

Not logged in · Please run /login

Cosa fare:

• Eseguite /login per autenticarvi con il vostro abbonamento Claude o account Console
• Se vi aspettavate che una variabile d'ambiente vi autenticasse, confermate che ANTHROPIC_API_KEY sia impostata ed esportata nella shell dove avete lanciato claude
• Per CI o automazione dove il login interattivo non è possibile, configurate uno script apiKeyHelper che recuperi una chiave all'avvio
• Consultate Precedenza dell'autenticazione per comprendere quale credenziale Claude Code utilizza quando sono presenti più credenziali

Se vi viene richiesto di accedere ripetutamente, consultate Non connesso o token scaduto per le correzioni dell'orologio di sistema e del Portachiavi di macOS.

Impossibile risolvere il metodo di autenticazione

La sessione ha raggiunto il client API senza alcuna credenziale. Questo appare nelle sessioni in background, sessioni cloud e contesti Agent SDK dove il controllo del login interattivo non viene eseguito prima della prima richiesta.

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

{/* min-version: 2.1.174 */}Prima della v2.1.174, una sessione in background o cloud assegnata a un worker pre-inizializzato inattivo poteva fallire in questo modo anche quando erano configurate credenziali valide. Eseguite l'aggiornamento per recuperare. Nelle versioni attuali l'errore significa che nessuna credenziale era disponibile per il processo worker.

Cosa fare:

• Eseguite l'aggiornamento alla v2.1.174 o successiva se questo appare in una sessione in background o cloud e le vostre credenziali sono già configurate
• Confermate che ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN o le credenziali del vostro provider cloud siano impostate nell'ambiente che avvia il worker, non solo nella vostra shell interattiva
• Per Agent SDK, consultate configurazione dell'autenticazione
• Eseguite /status in una sessione interattiva nello stesso ambiente per confermare quale fonte di credenziale si risolve

Chiave API non valida

La variabile d'ambiente ANTHROPIC_API_KEY o lo script apiKeyHelper ha restituito una chiave che l'API ha rifiutato.

Invalid API key · Fix external API key

Cosa fare:

• Controllate gli errori di digitazione e confermate che la chiave non sia stata revocata nella Console
• Eseguite env | grep ANTHROPIC nella stessa shell. Strumenti come direnv, plugin shell dotenv e terminali IDE possono caricare una chiave obsoleta da un file .env nel vostro progetto senza che la impostiate esplicitamente.
• Annullate l'impostazione di ANTHROPIC_API_KEY ed eseguite /login per utilizzare invece l'autenticazione tramite abbonamento
• Se la chiave proviene da uno script apiKeyHelper, eseguite lo script direttamente per confermare che stampi una chiave valida su stdout
• Eseguite /status per confermare quale fonte di credenziale Claude Code sta effettivamente utilizzando

Questa organizzazione è stata disabilitata

Una ANTHROPIC_API_KEY obsoleta da un'organizzazione Console disabilitata sta sovrascrivendo il vostro login tramite abbonamento.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

Le variabili d'ambiente hanno la precedenza su /login, quindi una chiave esportata nel vostro profilo shell o caricata da un file .env viene utilizzata anche quando avete un abbonamento Pro o Max funzionante. In modalità non interattiva (-p), la chiave viene sempre utilizzata quando presente.

Cosa fare:

• Annullate l'impostazione di ANTHROPIC_API_KEY nella shell corrente e rimuovetela dal vostro profilo shell, quindi riavviate claude
• Eseguite /status in seguito per confermare che la credenziale attiva sia il vostro abbonamento
• Se nessuna variabile d'ambiente è impostata e l'errore persiste, l'organizzazione disabilitata è quella collegata al vostro /login. Contattate il supporto o accedete con un account diverso.

La vostra organizzazione ha disabilitato l'autenticazione tramite chiave API

Questo messaggio richiede Claude Code v2.1.169 o successiva. L'amministratore dell'organizzazione Console ha disattivato l'autenticazione tramite chiave API, quindi l'API rifiuta la chiave che Claude Code sta inviando. L'hint di recupero dopo il · varia a seconda di dove proviene la chiave:

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

Le variabili d'ambiente e apiKeyHelper hanno la precedenza su /login, quindi eseguire solo /login non aiuta mentre uno di essi sta ancora fornendo una chiave. Consultate Precedenza dell'autenticazione.

Cosa fare:

• Se il messaggio nomina ANTHROPIC_API_KEY, annullate l'impostazione nella shell corrente e rimuovetela dal vostro profilo shell o file .env, quindi riavviate claude
• Se il messaggio nomina apiKeyHelper, rimuovete l'impostazione apiKeyHelper dal vostro settings.json
• Eseguite /login per accedere con il vostro account claude.ai
• Eseguite /status in seguito per confermare che la credenziale attiva sia il vostro abbonamento piuttosto che una chiave API
• Se avete bisogno dell'autenticazione tramite chiave API per l'automazione, chiedete all'amministratore della vostra organizzazione di riattivarla nella Console

La vostra organizzazione ha disabilitato l'accesso tramite abbonamento Claude

La vostra organizzazione Claude non consente l'accesso a Claude Code con un login tramite abbonamento. Eseguire /login di nuovo con lo stesso account restituisce lo stesso errore.

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

Questa è un'impostazione dell'organizzazione lato server, quindi non può essere sovrascritta dalle impostazioni locali, variabili d'ambiente o flag CLI.

Agent SDK e modalità non interattiva -p presentano questo come il codice di errore oauth_org_not_allowed.

Cosa fare:

• Chiedete al vostro amministratore di abilitare l'accesso a Claude Code per la vostra organizzazione
• Autenticatevi con una chiave API Console invece del vostro abbonamento. Consultate Autenticazione Claude Console per la configurazione.
• Se siete l'amministratore e non vedete un'opzione per abilitare l'accesso, contattate il supporto Anthropic

Le routine sono disabilitate dalla politica della vostra organizzazione

Un Owner nella vostra organizzazione Team o Enterprise ha disattivato le routine a livello di organizzazione. L'errore appare quando tentate di creare o eseguire una routine, incluso da /schedule e dall'interfaccia utente Routines su claude.ai/code.

Routines are disabled by your organization's policy.

Questa è un'impostazione lato server, quindi non può essere sovrascritta dalle impostazioni locali, variabili d'ambiente o flag CLI.

Cosa fare:

• Chiedete a un Owner nella vostra organizzazione di abilitare l'interruttore Routines su claude.ai/admin-settings/claude-code
• Per lavori programmati una tantum che non richiedono routine a livello di organizzazione, consultate attività programmate

Remote Control richiede l'API Anthropic

La sessione non sta comunicando direttamente con l'API Anthropic, quindi non c'è un backend claude.ai per Remote Control con cui associarsi.

Remote Control is only available when using Claude via api.anthropic.com.

Questo appare su Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry. {/* min-version: 2.1.196 */}A partire dalla v2.1.196 appare anche quando ANTHROPIC_BASE_URL punta a un host diverso da api.anthropic.com, come un gateway LLM o proxy, anche quando vi accedete con claude.ai.

Cosa fare:

• Annullate l'impostazione di ANTHROPIC_BASE_URL e riavviate la sessione, oppure avviate Remote Control da una sessione che comunica direttamente con l'API Anthropic
• Per questo e gli altri messaggi di avvio di Remote Control, consultate Risoluzione dei problemi di Remote Control

Token OAuth revocato o scaduto

Il vostro login salvato non è più valido. Un token revocato significa che vi siete disconnessi ovunque o un amministratore ha rimosso l'accesso; un token scaduto significa che l'aggiornamento automatico ha fallito durante la sessione.

OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error

Cosa fare:

• Eseguite /login per accedere di nuovo
• Se l'errore ritorna nella stessa sessione dopo la ri-autenticazione, eseguite prima /logout per cancellare completamente il token memorizzato, quindi /login
• Per prompt ripetuti di accesso tra i lanci, consultate i controlli dell'orologio di sistema e del Portachiavi di macOS in Risoluzione dei problemi
• Per altri errori inclusi 403 Forbidden e problemi del browser OAuth, consultate Login e autenticazione

Requisito di ambito OAuth

Il token memorizzato precede un ambito di autorizzazione che una funzione più recente necessita. Lo vedete più spesso da /usage e dall'indicatore di utilizzo della riga di stato:

OAuth token does not meet scope requirement: user:profile

Cosa fare:

• Eseguite /login per ottenere un nuovo token con gli ambiti attuali. Non è necessario disconnettervi prima.

Credenziali AWS scadute o non valide

{/* min-version: 2.1.198 */}Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando awsAuthRefresh è impostato nel vostro file di impostazioni. Il vostro token di sessione AWS è scaduto o è stato rifiutato, e l'aggiornamento automatico che Claude Code ha già eseguito non ha prodotto una credenziale che l'API accetta. Appare su un 401 da Claude Platform on AWS o dall'endpoint Mantle, che è come questi provider segnalano un token di sicurezza scaduto.

L'hint di azione nel mezzo nomina il comando awsAuthRefresh dalle vostre impostazioni, quindi varia. La parte stabile è il AWS credentials expired or invalid iniziale:

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

Senza awsAuthRefresh configurato, lo stesso 401 mostra il messaggio generico Please run /login invece, che non può aggiornare le credenziali AWS.

Cosa fare:

• Eseguite il comando awsAuthRefresh nominato nel messaggio, come aws sso login --profile myprofile, in un altro terminale e completate l'accesso al browser, quindi riprovate
• In una sessione interattiva, eseguite /login, scegliete 3rd-party platform, quindi selezionate Claude Platform on AWS · refresh credentials sotto Using 3rd-party platforms per eseguire lo stesso comando senza riavviare Claude Code. Consultate Configurare le credenziali AWS
• Se l'errore si ripete dopo che il comando di aggiornamento ha avuto successo, confermate che l'identità sia valida al di fuori di Claude Code con aws sts get-caller-identity nella stessa shell e profilo

Autenticazione AWS non riuscita

{/* min-version: 2.1.198 */}Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando awsAuthRefresh è impostato nel vostro file di impostazioni. Il vostro provider AWS ha restituito un 403, oppure Amazon Bedrock ha restituito un 401.

Claude Code non può dire quale causa avete riscontrato. Amazon Bedrock segnala un token di sicurezza scaduto come un 403, ma un 403 è anche come segnala un diniego di autorizzazione, come un AccessDeniedException da un'autorizzazione IAM mancante o un modello che non è abilitato per il vostro account.

Un 401 da Amazon Bedrock finisce anche qui piuttosto che sotto Credenziali AWS scadute o non valide, perché Amazon Bedrock non segnala un token scaduto come un 401. Un 401 da quell'endpoint in genere proviene da qualcos'altro nel percorso della richiesta, come un proxy aziendale.

Un aggiornamento delle credenziali corregge un token scaduto e non può correggere le altre cause, quindi il messaggio offre entrambe:

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

L'hint di azione nel mezzo nomina il comando awsAuthRefresh dalle vostre impostazioni, quindi varia. La parte stabile è il AWS authentication failed iniziale.

Cosa fare:

• Eseguite il comando awsAuthRefresh nominato nel messaggio, o aws sso login, nel caso in cui una credenziale scaduta sia la causa
• Se le vostre credenziali sono attuali, confermate che le autorizzazioni IAM in Configurazione IAM siano allegate all'identità che state utilizzando e che il modello selezionato sia abilitato per il vostro account e regione
• Eseguite aws sts get-caller-identity per confermare quale identità utilizzano le vostre richieste; un AWS_PROFILE obsoleto o profilo predefinito è una causa comune di una mancata corrispondenza di autorizzazioni

Errori di rete e connessione

Questi errori significano che una richiesta di rete da Claude Code non ha raggiunto la sua destinazione. Di solito originano dalla vostra rete locale, proxy o firewall, oppure dalla politica di rete dell'ambiente cloud.

Impossibile connettersi all'API

La connessione TCP all'API non è riuscita o non si è mai completata.

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

Le cause comuni includono l'assenza di accesso a Internet, una VPN che blocca api.anthropic.com, o un proxy aziendale richiesto che non è configurato.

Cosa fare:

• Confermate di poter raggiungere l'host dell'API dalla stessa shell eseguendo curl -I https://api.anthropic.com. Su Windows PowerShell utilizzate curl.exe -I https://api.anthropic.com in modo che l'alias Invoke-WebRequest integrato non venga utilizzato.
• Se siete dietro un proxy aziendale, impostate HTTPS_PROXY prima di avviare Claude Code e consultate Configurazione di rete
• Se instradiate il traffico attraverso un gateway LLM o un relay, impostate ANTHROPIC_BASE_URL al suo indirizzo. Consultate Connettere Claude Code a un gateway LLM per la configurazione.
• Assicuratevi che il vostro firewall consenta gli host elencati in Requisiti di accesso di rete
• I guasti intermittenti vengono ritentati automaticamente; i guasti persistenti indicano un problema di rete locale

Se curl ha successo ma Claude Code continua a fallire, la causa è solitamente qualcosa tra il runtime e la rete piuttosto che la rete stessa:

• Su Linux e WSL, controllate /etc/resolv.conf per un nameserver non raggiungibile. WSL in particolare può ereditare un resolver rotto dall'host.
• Su macOS, un client VPN che è stato disconnesso o disinstallato può lasciare dietro un'interfaccia tunnel o una regola di routing. Controllate ifconfig per interfacce utun obsolete e rimuovete l'estensione di rete della VPN in Impostazioni di Sistema.
• Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudeteli e ritentate per escludere questa possibilità.

Errori di certificato SSL

Un proxy o un'appliance di sicurezza sulla vostra rete sta intercettando il traffico TLS con il proprio certificato, e Claude Code non lo considera attendibile.

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

{/* min-version: 2.1.199 */}A partire dalla v2.1.199, un guasto di convalida del certificato non viene ritentato, quindi questo errore appare al primo tentativo invece che dopo il completo budget di retry. Le versioni precedenti hanno speso alcuni minuti ritentando prima di mostrarlo. Le condizioni TLS transitorie, come un timeout di handshake, continuano a essere ritentate.

Durante /login e il controllo di connettività all'avvio, lo stesso guasto viene segnalato con il codice OpenSSL e la correzione inline:

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

Cosa fare:

• Esportate il bundle CA della vostra organizzazione e puntate Claude Code ad esso con NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Consultate Configurazione di rete per le istruzioni di configurazione complete
• Non impostate NODE_TLS_REJECT_UNAUTHORIZED=0, che disabilita completamente la convalida del certificato

Host non consentito in una sessione cloud

Una richiesta HTTP in uscita da una sessione cloud o routine è stata bloccata dalla politica di rete dell'ambiente.

HTTP 403
x-deny-reason: host_not_allowed

Potete anche vedere un certificato TLS che non corrisponde al certificato reale della destinazione. L'ambiente cloud instrada il traffico in uscita attraverso un proxy che applica la politica di rete, quindi un certificato non corrispondente significa che il proxy ha terminato la connessione, non la destinazione.

Questo non è un problema di rete lato client. Le sessioni cloud e le routine vengono eseguite all'interno di un ambiente sandbox il cui traffico in uscita è filtrato in base all'allowlist dell'ambiente. L'ambiente Default utilizza l'accesso Trusted, che consente l'allowlist predefinito dei registri di pacchetti, API dei provider cloud, registri di container e domini di sviluppo comuni, ma blocca tutto il resto.

Cosa fare:

• Aprite la routine per la modifica, o avviate una sessione cloud. Selezionate l'icona cloud che mostra il nome del vostro ambiente, come Default, per aprire il selettore. Passate il mouse sopra il vostro ambiente e fate clic sull'icona delle impostazioni.
• Nella finestra di dialogo Update cloud environment, cambiate Network access da Trusted a Custom, quindi aggiungete il dominio bloccato a Allowed domains. Inserite un dominio per riga. Selezionate Also include default list of common package managers per mantenere l'allowlist predefinito insieme ai vostri domini personalizzati. Selezionate Full invece se desiderate un accesso senza restrizioni.
• Fate clic su Save changes. L'esecuzione successiva utilizza l'allowlist aggiornato.

Consultate Accesso di rete per i livelli di accesso e l'allowlist predefinito. Le sessioni CLI locali non sono interessate da questa politica.

Impossibile riconnettersi alla sessione Remote Control

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

La ripresa con claude --resume o claude --continue si ricollega alla sessione Remote Control registrata in quella conversazione. Questo messaggio significa che la riconnessione non è riuscita per un motivo che potrebbe essere temporaneo, come un'interruzione di rete o un errore del server, quindi Claude Code non può confermare se la sessione remota esiste ancora. La vostra sessione locale continua a funzionare senza Remote Control.

Cosa fare:

• Eseguite /remote-control per ritentare la connessione
• Avviate Claude Code senza --resume per creare una nuova sessione Remote Control
• Per altri messaggi di avvio di Remote Control, consultate Risoluzione dei problemi di Remote Control

Non vedrete questo messaggio quando il server conferma che la sessione precedente non esiste più; Claude Code ne crea una nuova in quel caso. {/* min-version: 2.1.200 */}Prima della v2.1.200, qualsiasi guasto di riconnessione creava una nuova sessione Remote Control, il che lasciava sessioni extra nell'elenco delle sessioni su claude.ai/code.

Errori di richiesta

Questi errori riguardano il contenuto della tua richiesta. La maggior parte proviene dall'API dopo che ha rifiutato la richiesta; alcuni sono prodotti localmente da Claude Code prima che venga inviata qualsiasi richiesta.

Il prompt è troppo lungo

La conversazione più i file allegati superano la finestra di contesto del modello.

Prompt is too long

Cosa fare:

• Esegui /compact per riassumere i turni precedenti e liberare spazio, oppure /clear per ricominciare da capo
• Esegui /context per visualizzare una suddivisione di ciò che consuma la finestra: prompt di sistema, strumenti, file di memoria e messaggi
• Disabilita i server MCP che non stai utilizzando con /mcp disable <name> per rimuovere le loro definizioni di strumenti dal contesto
• Riduci i file di memoria CLAUDE.md di grandi dimensioni, oppure sposta le istruzioni in regole con ambito di percorso che si caricano solo quando rilevanti
• I subagent ereditano ogni definizione di strumento MCP dalla sessione padre, il che può riempire la loro finestra di contesto prima del primo turno. Disabilita i server MCP che non stai utilizzando prima di generare subagent.
• L'auto-compact è abilitato per impostazione predefinita e normalmente previene questo errore. Se hai impostato DISABLE_AUTO_COMPACT, riabilitalo o esegui /compact manualmente prima che la finestra si riempia.

Vedi Esplora la finestra di contesto per una visualizzazione interattiva di come il contesto si riempie.

Errore durante la compattazione: Conversazione troppo lunga

/compact stesso ha avuto esito negativo perché non c'è abbastanza contesto libero per contenere il riassunto che produce.

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

Questo può accadere quando la finestra è già piena nel momento in cui auto-compact si attiva, oppure quando esegui /compact dopo aver visto Prompt is too long.

Cosa fare:

• Premi Esc due volte per aprire l'elenco dei messaggi e tornare indietro di diversi turni. Questo elimina i messaggi più recenti dal contesto. Quindi esegui /compact di nuovo.
• Se tornare indietro non libera abbastanza spazio, esegui /clear per avviare una sessione nuova. La tua conversazione precedente viene preservata e può essere riaperta con /resume.

Richiesta troppo grande

Il corpo della richiesta grezza ha superato il limite di byte dell'API prima della tokenizzazione, di solito a causa di un file incollato di grandi dimensioni o di un allegato.

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

Questo è un limite di dimensione sulla richiesta HTTP, separato dal limite della finestra di contesto.

Cosa fare:

• Premi Esc due volte e torna indietro oltre il turno che ha aggiunto il contenuto di dimensioni eccessive
• Fai riferimento ai file di grandi dimensioni per percorso invece di incollarne i contenuti, in modo che Claude possa leggerli in blocchi
• Per le immagini, vedi L'immagine era troppo grande di seguito

L'immagine era troppo grande

Un'immagine incollata o allegata supera i limiti di dimensione o dimensione dell'API.

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

{/* min-version: 2.1.142 */}Claude Code sostituisce l'immagine non elaborabile con un segnaposto di testo e riprova, quindi i messaggi successivi hanno esito positivo. Nelle versioni precedenti a 2.1.142, un'immagine incollata potrebbe rimanere nella conversazione e ripetere lo stesso errore su ogni messaggio successivo. Per recuperare su quelle versioni, premi Esc due volte e torna indietro oltre il turno in cui è stata aggiunta l'immagine.

Cosa fare:

• Ridimensiona l'immagine prima di incollarla. L'API accetta immagini fino a 8000 pixel sul bordo più lungo per una singola immagine, o 2000 pixel quando molte immagini sono nel contesto.
• Fai uno screenshot più stretto della regione rilevante invece dello schermo intero

Impossibile ridimensionare l'immagine

Claude Code non ha potuto ridimensionare un'immagine allegata prima di inviarla all'API.

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code normalmente ridimensiona automaticamente le immagini di grandi dimensioni. Questi errori significano che il processore di immagini nativo non ha potuto caricarsi o ha restituito un errore, quindi l'immagine non potrebbe essere ridimensionata per rientrare nei limiti dell'API.

Cosa fare:

• Se il messaggio ti chiede di convertire l'immagine, convertila in PNG, JPEG, GIF o WebP e allegala di nuovo. Claude Code può verificare le dimensioni per questi formati senza il processore di immagini.
• Se il messaggio segnala un limite di dimensione o dimensione, ridimensiona o ricomprimi l'immagine al di sotto di quel limite prima di allegare.

Errori PDF

Il PDF che hai allegato non potrebbe essere elaborato.

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

Cosa fare:

• Per i PDF di grandi dimensioni, chiedi a Claude di leggere un intervallo di pagine con lo strumento Read invece di allegare l'intero file, oppure estrai il testo con uno strumento come pdftotext e fai riferimento al file di output per percorso
• Per i PDF protetti o non validi, rimuovi la password o riesporta il file dall'applicazione sorgente, quindi riprova

Gli input aggiuntivi non sono consentiti

Un proxy o un gateway LLM tra Claude Code e l'API ha rimosso l'intestazione della richiesta anthropic-beta, quindi l'API ha rifiutato i campi che dipendono da essa.

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code invia campi solo beta come context_management, effort e input_examples dello strumento insieme a un'intestazione anthropic-beta che li abilita. Quando un gateway inoltra il corpo ma elimina l'intestazione, l'API vede campi che non riconosce.

Cosa fare:

• Configura il tuo gateway per inoltrare l'intestazione anthropic-beta. Vedi feature pass-through per ciò che i gateway devono inoltrare.
• Come fallback, imposta CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 prima di avviare. Questo disabilita le funzioni che richiedono l'intestazione beta in modo che le richieste abbiano esito positivo attraverso un gateway che non può inoltrarla.

C'è un problema con il modello selezionato

Il nome del modello configurato non è stato riconosciuto o il tuo account non ha accesso ad esso. A partire da v2.1.160 il suggerimento finale, mostrato qui nella sua forma interattiva, varia in base alla superficie.

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

Cosa fare:

• CLI interattiva: esegui /model per scegliere dai modelli disponibili per il tuo account.
• Modalità non interattiva (-p): passa --model con un alias o ID valido, oppure imposta ANTHROPIC_MODEL. Il testo di errore mostra Run --model su questa superficie.
• Agent SDK: il testo di errore omette il suggerimento perché il modello è impostato a livello di programmazione. Imposta model su Options in TypeScript o ClaudeAgentOptions(model=...) in Python, e gestisci l'errore strutturato model_not_found per visualizzare il tuo ritentativo o selettore di modello.
• Usa un alias come sonnet o opus invece di un ID completamente versionato. Gli alias si risolvono in un valore predefinito mantenuto in modo che non diventino obsoleti. Vedi Configurazione del modello.
• Se il modello sbagliato continua a tornare nella CLI, un ID obsoleto è impostato da qualche parte. Controlla in ordine di priorità: il flag --model, la variabile di ambiente ANTHROPIC_MODEL, quindi il campo model in .claude/settings.local.json, il .claude/settings.json del tuo progetto e ~/.claude/settings.json. Rimuovi il valore obsoleto e Claude Code torna al valore predefinito del tuo account.
• Per le distribuzioni di Google Cloud's Agent Platform, vedi Risoluzione dei problemi di Google Cloud's Agent Platform.

Il modello non è un ID modello riconosciuto

La stringa del modello che hai passato a un cambio di modello non è un alias di modello, un ID di modello che questa versione di Claude Code conosce, o un ID che inizia con claude-. Le cause comuni sono un errore di battitura nell'ID, un nome visualizzato come Sonnet 5 dove è previsto l'ID claude-sonnet-5, o un alias che solo le versioni più recenti di Claude Code riconoscono. Claude Code rifiuta il cambio immediatamente. Prima di v2.1.200, Claude Code salvava la stringa e aveva esito negativo sulla richiesta successiva con C'è un problema con il modello selezionato.

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

Il suggerimento finale nomina l'alias o l'ID del modello più vicino. Quando nulla è abbastanza vicino, legge Run /model to see available models. invece.

Claude Code produce questo errore localmente nel momento in cui il cambio è richiesto, prima che venga effettuata qualsiasi richiesta API. Si applica quando un modello è impostato tramite il metodo Agent SDK setModel() o da un'app come l'app Desktop che esegue la CLI di Claude Code per te.

Cosa fare:

• Esegui /model senza argomenti per aprire il selettore e scegli dai modelli disponibili per il tuo account, quindi passa l'alias o l'ID mostrato lì
• Se hai utilizzato un alias che una versione più recente di Claude Code supporta, esegui claude update. Un ID completo che inizia con claude- passa questo controllo anche quando il modello è più recente della tua versione di Claude Code, quindi l'aggiornamento non è necessario per quelli.
• Un modello salvato prima di v2.1.200 non viene riparato da questo controllo. Se un valore obsoleto continua a tornare, rimuovilo dalle posizioni elencate in C'è un problema con il modello selezionato.
• Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS e dietro un gateway LLM o un ANTHROPIC_BASE_URL personalizzato, il tuo provider o gateway definisce i nomi dei modelli, quindi Claude Code accetta qualsiasi stringa e la passa attraverso.

Claude Opus non è disponibile con il piano Claude Pro

Il tuo piano di abbonamento attivo non include il modello che hai selezionato.

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

Cosa fare:

• Esegui /model e seleziona un modello che il tuo piano include
• Se hai aggiornato il tuo piano di recente e vedi ancora questo, esegui /logout quindi /login. Il token memorizzato riflette il tuo piano al momento dell'accesso, quindi l'aggiornamento sul web non ha effetto in una sessione esistente fino a quando non ti autentica di nuovo.
• Vedi claude.com/pricing per quali modelli ogni piano include

Il modello è limitato dalle impostazioni della tua organizzazione

L'amministratore della tua organizzazione ha disabilitato questo modello nella console di amministrazione di claude.ai, oppure è escluso da un elenco di autorizzazioni availableModels nelle impostazioni gestite. Quando il modello limitato è stato impostato con --model, ANTHROPIC_MODEL o l'impostazione model, Claude Code sostituisce un modello consentito e continua. Digitare /model <name> per un modello limitato viene rifiutato con Run /model to choose a different model. e la sessione mantiene il suo modello attuale.

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

Claude Code tratta un alias della famiglia di modelli, uno di opus, sonnet, haiku o fable, come una richiesta per quella famiglia piuttosto che per la sua versione più recente. Sull'API Anthropic e su Claude Platform on AWS, un alias della famiglia limitata si risolve nella versione più recente della famiglia che la tua organizzazione e l'elenco di autorizzazioni availableModels consentono, e l'avviso di sostituzione nomina quella versione. Claude Code rifiuta /model <alias> solo quando ogni versione della famiglia è limitata. Prima di v2.1.205, un alias della famiglia veniva sostituito o rifiutato in base alla sua versione più recente sola, anche quando una versione precedente della stessa famiglia era consentita.

Cosa fare:

• Esegui /model per scegliere dai modelli che la tua organizzazione consente. I modelli limitati sono nascosti dal selettore.
• Se il modello limitato è stato impostato in --model, ANTHROPIC_MODEL o il campo model di un file di impostazioni, rimuovi o aggiorna quel valore in modo che l'avviso non si ripeta ad ogni avvio
• Se hai bisogno di accesso al modello limitato, chiedi all'amministratore della tua organizzazione di abilitarlo. Vedi Restrizioni del modello dell'organizzazione.

thinking.type.enabled non è supportato per questo modello

La tua versione di Claude Code è più vecchia del minimo per Sonnet 5, Opus 4.8 o Opus 4.7. La CLI ha inviato una configurazione di thinking che il modello non accetta più.

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Cosa fare:

• Esegui claude update e riavvia Claude Code. Opus 4.7 ha bisogno di v2.1.111 o successivo. Opus 4.8 ha bisogno di v2.1.154 o successivo. Sonnet 5 ha bisogno di v2.1.197 o successivo
• Se non puoi aggiornare, esegui /model e seleziona Opus 4.6 o Sonnet 4.6 invece
• {/* min-version: agent-sdk@0.3.197 */}Se lo riscontri nell'Agent SDK, aggiorna il pacchetto SDK invece. Opus 4.8 ha bisogno di TypeScript SDK v0.3.154 o successivo e Python SDK v0.2.88 o successivo. Sonnet 5 ha bisogno di TypeScript SDK v0.3.197 o successivo

Il budget di thinking supera il limite di output

Il budget di thinking esteso configurato supera la lunghezza massima della risposta, quindi non c'è spazio rimasto per la risposta effettiva.

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code regola questi valori automaticamente sull'API Anthropic. Normalmente vedi questo errore su Amazon Bedrock o Google Cloud's Agent Platform quando MAX_THINKING_TOKENS è impostato più alto del limite di output del provider, o quando la modalità piano aumenta il budget di thinking.

Cosa fare:

• Abbassa MAX_THINKING_TOKENS, oppure aumenta CLAUDE_CODE_MAX_OUTPUT_TOKENS al di sopra del budget di thinking
• Vedi Extended thinking per come il budget interagisce con la lunghezza dell'output

Mancata corrispondenza tra l'uso dello strumento o il blocco di thinking

La cronologia della conversazione ha raggiunto l'API in uno stato incoerente, di solito dopo che una chiamata di strumento è stata interrotta o un turno è stato modificato a metà flusso.

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

Tutte e tre le varianti significano la stessa cosa: la sequenza di blocchi tool_use, tool_result e thinking nella cronologia non corrisponde più a ciò che l'API si aspetta.

Cosa fare:

• {/* max-version: 2.1.155 */}Se stai utilizzando Opus 4.7 o Opus 4.8, esegui prima claude update. Le versioni precedenti a v2.1.156 possono attivare questo errore durante l'uso normale dello strumento, e /rewind non lo cancella.
• Esegui /rewind, o premi Esc due volte, per tornare indietro a un checkpoint prima del turno corrotto e continua da lì. Vedi Checkpointing per come i checkpoint vengono creati e ripristinati.

Rifiuto della politica di utilizzo

L'API ha rifiutato di rispondere perché il contenuto nella conversazione ha attivato un controllo della Politica di utilizzo. Il messaggio include un ID di richiesta che puoi citare al supporto se ritieni che il rifiuto sia errato.

API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

Il controllo valuta la conversazione completa, non solo il tuo prompt più recente, quindi inviare un nuovo messaggio nella stessa sessione di solito riattiva lo stesso rifiuto. Lo stesso vale dopo l'uscita e la riapertura della sessione con --continue o --resume, poiché la trascrizione su disco contiene ancora il contenuto che attiva il controllo. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, questo messaggio copre anche le richieste che le misure di sicurezza del modello hanno contrassegnato come un argomento di cibersicurezza. Vedi Le misure di sicurezza hanno contrassegnato un argomento di cibersicurezza.

Cosa fare:

• Premi Esc due volte o esegui /rewind per tornare indietro a un checkpoint prima del turno che ha attivato il rifiuto, quindi riformula o prendi un approccio diverso. Vedi Checkpointing.
• Se non riesci a identificare quale turno l'ha causato, esegui /clear per avviare una conversazione nuova nello stesso progetto. La tua conversazione precedente viene preservata su disco e rimane disponibile in /resume.
• In modalità non interattiva (-p), dove il rewind non è disponibile, riprova con un prompt riformulato in una sessione nuova senza --continue. I controlli delle politiche variano in base al modello, quindi passare a un modello diverso con --model può anche risolvere il rifiuto in alcuni casi.

Le misure di sicurezza hanno contrassegnato un argomento di cibersicurezza

Le misure di sicurezza del modello hanno contrassegnato il contenuto nella conversazione come un argomento di cibersicurezza. Il messaggio nomina il modello che ha contrassegnato la richiesta:

API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

Il messaggio si collega al Cyber Verification Program, che concede l'accesso per il lavoro di cibersicurezza legittimo. La salvaguardia stessa è lato server e precede v2.1.203; questa versione ha cambiato solo la formulazione del messaggio e la pagina a cui si collega.

Quello che vedi dipende dal tuo provider e dalla modalità:

• Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, un flag di cibersicurezza produce il messaggio di rifiuto della politica di utilizzo invece.
• La modalità non interattiva omette la frase /feedback.

{/* max-version: 2.1.202 */}Prima di v2.1.203, il messaggio leggeva <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: seguito da un link del modulo di esenzione.

Cosa fare:

• Se il tuo lavoro richiede questo contenuto, richiedi l'accesso tramite il Cyber Verification Program
• Se la tua richiesta non riguardava un argomento di cibersicurezza, esegui /feedback per segnalare il falso positivo
• Per continuare a lavorare nella stessa sessione, premi Esc due volte o esegui /rewind per tornare indietro a un checkpoint prima del turno che ha attivato il flag, quindi prendi un approccio diverso. Vedi Checkpointing.

Errori di installazione

Questi errori compaiono durante l'installazione o l'aggiornamento di Claude Code, dallo script di installazione, claude install, o claude update. Per i problemi di command not found, PATH, permessi e TLS durante la configurazione, vedere Risoluzione dei problemi di installazione e accesso.

L'installazione è stata interrotta prima di poter terminare

Lo script di installazione segnala quando il passaggio claude install viene terminato da un segnale. Su Linux, il codice di uscita 137 significa che il processo ha ricevuto SIGKILL, e su un host con poca memoria è solitamente il killer out-of-memory (OOM) del kernel. Lo script stampa questa spiegazione ed esce con il codice 137:

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Per qualsiasi altro segnale fatale, e per il codice di uscita 137 su macOS, lo script stampa Installation was killed before it could finish (exit code <N>) con il codice di uscita effettivo e omette la spiegazione dell'esaurimento della memoria. Il messaggio proviene dallo script di installazione che macOS e Linux utilizzano, che copre anche le installazioni all'interno di WSL; gli script di installazione nativi di Windows non lo stampano mai. Prima della v2.1.200, lo script usciva con solo la riga Killed della shell.

Cosa fare:

• Interrompere altri processi per liberare memoria, quindi eseguire nuovamente il programma di installazione
• Aggiungere spazio di swap o passare a un'istanza più grande. Vedere Installazione interrotta su server Linux con poca memoria per i comandi del file di swap.

La connessione è stata interrotta durante il download dell'aggiornamento

La connessione al server di download si è chiusa mentre claude install, claude update, o l'aggiornatore automatico stava scaricando il binario di Claude Code, e i tentativi di ripetizione non hanno recuperato. Claude Code ritenta il download quando la connessione si interrompe, il trasferimento si blocca, o il file scaricato non supera il checksum, fino a tre tentativi in totale. Un errore HTTP completato, come un 404, non viene ritentato perché il server ha già risposto. {/* min-version: 2.1.202 */}Prima della v2.1.202, una singola connessione interrotta faceva fallire il download immediatamente con il semplice errore aborted invece di ritentare.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

Il testo tra parentesi nomina quale tentativo ha fallito e l'errore di rete sottostante. claude update precede il messaggio con Error: Failed to install native update su stderr.

Un download che rimane connesso ma non termina entro 10 minuti fallisce con Download timed out: exceeded the total deadline invece. Claude Code non ritenta un download scaduto, perché una connessione troppo lenta per terminare entro la scadenza non terminerà nemmeno su un tentativo immediato di ripetizione. I passaggi seguenti si applicano a entrambi i messaggi. Prima della v2.1.205, la stessa scadenza di 10 minuti era segnalata come il generico timeout of 600000ms exceeded del client HTTP.

La causa più comune è un proxy o un gateway che chiude un trasferimento lungo prima che termini. Il binario di Claude Code è un download di grandi dimensioni, quindi un limite di connessione proxy che non influisce mai sul traffico API normale può comunque interromperlo.

Cosa fare:

• Eseguire claude update di nuovo. Su una rete altrimenti sana, il download di solito ha successo alla prossima esecuzione. Per il messaggio di timeout, eseguirlo di nuovo da una rete più veloce o meno limitata.
• Se la rete richiede un proxy, impostare HTTPS_PROXY prima di eseguire il programma di installazione o claude update. Vedere Verificare la connettività di rete.
• Se un proxy aziendale continua a chiudere il trasferimento, chiedere al team di rete di consentire il download completo da downloads.claude.ai. Vedere Requisiti di accesso alla rete.
• Eseguire claude doctor dalla shell per la diagnostica dell'installazione

Errori da riga di comando

Questi errori provengono dal comando claude da riga di comando e dai suoi sottocomandi. Claude Code li stampa prima di eseguire il prompt o inviare qualsiasi richiesta API.

Conflitto tra --bg e --print

Questo messaggio richiede Claude Code v2.1.198 o successivo. Avete combinato --bg con -p o --print nella stessa invocazione di claude. --bg avvia una sessione in background a cui vi collegherete successivamente con claude agents, mentre --print esegue in modo non interattivo e non avvia mai la sessione interattiva a cui claude agents si collega. Prima della v2.1.198 questa combinazione creava silenziosamente un lavoro in background che non poteva mai essere collegato.

--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

Cosa fare:

• Eliminate -p o --print. --bg accetta il prompt come argomento posizionale, quindi claude --bg "<task>" è il comando completo. Vedere Dispatch new agents from your shell.
• Per eseguire il prompt in modo non interattivo e stampare il risultato invece di creare una sessione in background, eliminate --bg ed eseguite claude -p "<task>"

Il valore --json-schema non è uno JSON Schema valido

Lo schema che avete passato a --json-schema in modalità non interattiva non ha superato la compilazione dello JSON Schema, quindi claude esce con codice 1 invece di eseguire il prompt. Prima della v2.1.205, uno schema non valido produceva output non strutturato senza errore, e qualsiasi schema che utilizzava la parola chiave format era trattato come non valido.

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

Il testo dopo il secondo due punti è la diagnostica del validatore e nomina la parola chiave o la posizione che non ha superato il controllo. Gli schemi che utilizzano la parola chiave format, come "format": "email", sono validi: Claude Code accetta format come annotazione e non la applica.

Claude Code esegue due controlli prima della compilazione dello schema: rifiuta un valore che non è JSON analizzabile con Error: --json-schema is not valid JSON, e JSON valido che non è un oggetto con Error: --json-schema must be a JSON object.

Cosa fare:

• Correggete la parte dello schema che la diagnostica nomina, quindi rieseguite il comando
• Se la diagnostica è schema too large, riducete l'annidamento dello schema e il riutilizzo di $ref
• Vedere Get structured output per uno schema e un comando funzionanti

Impossibile importare un server da Claude Desktop

Claude Code non ha potuto aggiungere uno dei server che avete selezionato in claude mcp add-from-claude-desktop. Il comando importa comunque gli altri server selezionati e stampa una riga per ogni server che non ha potuto aggiungere. Prima della v2.1.205, il primo server che non riusciva fermava l'importazione e nessuno dei server selezionati veniva aggiunto.

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

Il testo dopo il nome del server è il motivo. Il più comune è il controllo del nome: Claude Desktop consente caratteri nei nomi dei server, come spazi e punti, che claude mcp limita a lettere, numeri, trattini e sottolineature. Altri motivi includono una configurazione del server che non supera la convalida e un server bloccato dalla politica MCP della vostra organizzazione.

Cosa fare:

• Rinominate il server in claude_desktop_config.json per utilizzare solo lettere, numeri, trattini e sottolineature, quindi eseguite di nuovo claude mcp add-from-claude-desktop
• Aggiungete quel server direttamente con claude mcp add o claude mcp add-json con un nome valido. Vedere Import MCP servers from Claude Desktop.

Errori dei plugin

Questi errori provengono dalla configurazione dei plugin e del marketplace. Per i problemi dei plugin che non producono uno dei messaggi in questa pagina, come un URL del marketplace che non si carica o un plugin che si installa ma non appare, vedere Risoluzione dei problemi dei plugin.

Il marketplace è registrato da una fonte non attendibile

Il marketplace è registrato con un nome che è riservato per i marketplace ufficiali di Anthropic, ma la sua fonte registrata non è un repository GitHub anthropics. Claude Code ricontrolla i nomi riservati ogni volta che carica o aggiorna un marketplace, quindi il marketplace e i plugin installati da esso smettono di caricarsi. Prima della v2.1.205, il nome veniva controllato solo quando il marketplace veniva aggiunto, quindi una voce registrata prima che il suo nome diventasse riservato continuava a caricarsi.

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

Cosa fare:

• Eseguire claude plugin marketplace remove <name>, quindi aggiungere di nuovo il marketplace dal repository ufficiale github.com/anthropics
• Se pubblicate un marketplace di terze parti che ha utilizzato il nome prima che diventasse riservato, rinominatelo e chiedete agli utenti di aggiungerlo di nuovo dalla vostra fonte
• Vedere l'elenco dei nomi riservati in Schema del marketplace

Avvisi di configurazione

Claude Code scrive questi messaggi su stderr all'avvio anziché mostrare un errore nella conversazione. Segnalano la configurazione che ha letto ma non ha applicato.

Lo spazio di lavoro non è stato considerato attendibile

Claude Code ha trovato regole permissions.allow o voci permissions.additionalDirectories nel file .claude/settings.json o .claude/settings.local.json del progetto e non le ha applicate, perché le regole di autorizzazione dal progetto richiedono l'attendibilità dello spazio di lavoro. Il conteggio, il nome dell'impostazione e il file denominato nel messaggio variano in base alla configurazione. Le regole deny e ask non sono interessate.

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

Cosa fare:

• Eseguire claude nella directory e accettare la finestra di dialogo di attendibilità. {/* min-version: 2.1.200 */}La finestra di dialogo viene visualizzata anche quando una directory padre è già considerata attendibile, elenca le regole che vengono trattenute e consente di rifiutare e continuare a lavorare senza di esse. Prima della v2.1.200, nessuna finestra di dialogo veniva visualizzata in quella situazione, quindi questo passaggio non poteva essere completato lì.
• In modalità non interattiva con -p nessuna finestra di dialogo viene visualizzata. Impostare la voce hasTrustDialogAccepted in ~/.claude.json utilizzando la chiave projects esatta che il messaggio stampa.
• {/* min-version: 2.1.200 */}Se il messaggio nomina .claude/settings.local.json e hai avviato Claude Code al di fuori di un repository git o nella directory home, aggiorna alla v2.1.200 o successiva. Le versioni da 2.1.196 a 2.1.199 hanno trattato il tuo .claude/settings.local.json come fornito dal repository in quegli spazi di lavoro. Vedi Regole di autorizzazione del progetto e attendibilità dello spazio di lavoro.

Le risposte sembrano di qualità inferiore al solito

Se le risposte di Claude sembrano meno capaci di quanto ti aspetti ma non viene visualizzato alcun errore, la causa è solitamente lo stato della conversazione piuttosto che il modello stesso. Claude Code non cambia silenziosamente le versioni del modello. Può passare a un modello di fallback in tre casi specifici:

• Un --fallback-model configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione
• Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud rileva che il tuo modello predefinito non è disponibile
• Il fallback automatico del modello su Fable 5 sposta la sessione al modello Opus predefinito e mostra un avviso nella trascrizione

Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio /model. La configurazione del modello spiega quando si applica ogni fallback.

Controlla prima questi elementi:

• Selezione del modello: esegui /model per confermare che sei sul modello che ti aspetti. Una scelta /model precedente o una variabile di ambiente ANTHROPIC_MODEL potrebbe averti messo su un modello più piccolo di quello che intendevi.
• Livello di sforzo: esegui /effort per controllare il livello di ragionamento attuale e aumentarlo per il debug difficile o il lavoro di progettazione. I valori predefiniti variano in base al modello, quindi controlla prima di assumere che sei al di sotto del massimo. Vedi Regola il livello di sforzo per i valori predefiniti per modello e il collegamento ultrathink.
• Pressione del contesto: esegui /context per vedere quanto è pieno il window. Se è vicino alla capacità, esegui /compact a un punto naturale o /clear per ricominciare da capo. Vedi Esplora la finestra di contesto per come auto-compact influisce sui turni precedenti.
• Istruzioni obsolete: i file CLAUDE.md di grandi dimensioni o obsoleti e le definizioni degli strumenti MCP consumano contesto e possono indirizzare le risposte. {/* min-version: 2.1.205 */}Il checkup /doctor contrassegna i file di memoria sovradimensionati e le estensioni inutilizzate, e /context mostra l'utilizzo dei token degli strumenti MCP. Prima della v2.1.205, /doctor apriva una schermata di diagnostica che contrassegnava i file di memoria sovradimensionati e le definizioni dei subagent.

Quando una risposta va male, il rewind di solito funziona meglio che rispondere con correzioni. Premi Esc due volte o esegui /rewind per tornare indietro al turno precedente a quello sbagliato, quindi riformula il prompt con più specifiche. Correggere nel thread mantiene il tentativo sbagliato nel contesto, il che può ancorare le risposte successive ad esso. Vedi Checkpointing.

Se la qualità sembra ancora non corretta dopo aver controllato quanto sopra, esegui /feedback e descrivi cosa ti aspettavi rispetto a quello che hai ottenuto. Il feedback inviato in questo modo include la trascrizione della conversazione, che è il modo più veloce per Anthropic per diagnosticare una vera regressione. Vedi Segnala un errore se /feedback non è disponibile nel tuo ambiente.

{/* min-version: 2.1.201 */}Se Sonnet 5 rifiuta una richiesta e cita un sospetto prompt injection su Claude Code v2.1.200 o versioni precedenti, esegui claude update per ottenere la correzione v2.1.201.

Segnalare un errore

Per gli errori dei componenti non trattati in questa pagina, consultare la guida pertinente:

• Il server MCP non è riuscito a connettersi o autenticarsi: MCP
• Lo script hook non è riuscito o ha bloccato uno strumento: Debug hooks
• Permesso negato o errori del filesystem durante l'installazione: Risoluzione dei problemi di installazione e accesso

Se un errore non è elencato qui o la correzione suggerita non aiuta:

• Eseguire /feedback all'interno di Claude Code per inviare la trascrizione e una descrizione ad Anthropic. Il comando offre anche di aprire un problema GitHub precompilato. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e altri provider di terze parti, /feedback salva un archivio locale che è possibile inviare al rappresentante dell'account Anthropic.
• Eseguire claude doctor dalla shell per una diagnostica di sola lettura dell'installazione, oppure eseguire il checkup /doctor all'interno di Claude Code per trovare e risolvere i problemi di configurazione
• Controllare status.claude.com per gli incidenti attivi
• Cercare i problemi esistenti su GitHub