21Abbina il messaggio che vedi nel tuo terminale a una sezione sottostante.21Abbina il messaggio che vedi nel tuo terminale a una sezione sottostante.
22 22
23| Messaggio | Sezione |23| Messaggio | Sezione |
24| :-------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |
25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Errori del server](#request-timed-out), o [Rete](#unable-to-connect-to-api) se il messaggio menziona la tua connessione internet |27| `Request timed out` | [Errori del server](#request-timed-out), o [Rete](#unable-to-connect-to-api) se il messaggio menziona la tua connessione internet |
39| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |39| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |
40| `Could not resolve authentication method` | [Autenticazione](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Autenticazione](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Autenticazione](#invalid-api-key) |41| `Invalid API key` | [Autenticazione](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Autenticazione](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [Autenticazione](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Autenticazione](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [Autenticazione](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Autenticazione](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [Autenticazione](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Autenticazione](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [Autenticazione](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Autenticazione](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticazione](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticazione](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [Autenticazione](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autenticazione](#login-expired) |
48| `does not meet scope requirement user:profile` | [Autenticazione](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Autenticazione](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [Autenticazione](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Autenticazione](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [Autenticazione](#aws-authentication-failed) |53| `AWS authentication failed` | [Autenticazione](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [Autenticazione](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [Rete](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Rete](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [Tentativi automatici](#automatic-retries), o [Rete](#unable-to-connect-to-api) se persiste |56| `Waiting for API response · will retry in` | [Tentativi automatici](#automatic-retries), o [Rete](#unable-to-connect-to-api) se persiste |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Rete](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [Rete](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Rete](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [Rete](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Rete](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Rete](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Rete](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [Errori della riga di comando](#command-line-errors) |81| `--bg and --print conflict` | [Errori della riga di comando](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [Errori della riga di comando](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Errori della riga di comando](#command-line-errors) |
78| `Could not import <server>: <reason>` | [Errori della riga di comando](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Errori della riga di comando](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Errori della riga di comando](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Errori dei plugin](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Errori dei plugin](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errori dei plugin](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errori dei plugin](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [Errori degli strumenti](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [Errori della sessione in background](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Errori della sessione in background](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |
81| Responses seem lower quality than usual | [Qualità della risposta](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Qualità della risposta](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude 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.100Claude 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.
88 101
89Due classi di guasti non vengono ritentate, perché un tentativo non può avere successo:102Alcune classi di guasti non vengono ritentate, perché un tentativo non può avere successo:
90 103
91* {/* 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](#ssl-certificate-errors). Le condizioni TLS transitorie come un timeout di handshake continuano a ritentare.104* {/* 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](#ssl-certificate-errors). Le condizioni TLS transitorie come un timeout di handshake continuano a ritentare.
92* {/* 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](#the-response-above-may-be-incomplete) 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.105* {/* 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](#the-response-above-may-be-incomplete) invece di ritentare, poiché ri-eseguire la richiesta potrebbe eseguire gli stessi strumenti due volte. Le versioni precedenti scartavano l'output parziale e segnalano il turno come un errore.
106* {/* min-version: 2.1.208 */}Una [risposta di streaming Amazon Bedrock con un content-type inaspettato](#bedrock-streaming-response-has-an-unexpected-content-type) fallisce al primo tentativo, perché il gateway o il proxy che riscrive la risposta riscriverebbero il tentativo nello stesso modo. Richiede Claude Code v2.1.208 o successivo.
93 107
94Durante 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.108Durante 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.
95 109
285 299
286Claude 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.300Claude 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.
287 301
302L'utilizzo conta contemporaneamente sulle indennità di sessione e settimanali. Un singolo picco di attività intensa, come un ampio fanout di flusso di lavoro, può esaurire l'indennità settimanale prima che la finestra di sessione si ripristini.
303
288**Cosa fare:**304**Cosa fare:**
289 305
290* Attendete l'ora di ripristino mostrata nell'errore306* Attendete l'ora di ripristino mostrata nell'errore
430* Se la chiave proviene da uno script [`apiKeyHelper`](/it/settings#available-settings), eseguite lo script direttamente per confermare che stampi una chiave valida su stdout446* Se la chiave proviene da uno script [`apiKeyHelper`](/it/settings#available-settings), eseguite lo script direttamente per confermare che stampi una chiave valida su stdout
431* Eseguite `/status` per confermare quale fonte di credenziale Claude Code sta effettivamente utilizzando447* Eseguite `/status` per confermare quale fonte di credenziale Claude Code sta effettivamente utilizzando
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 Lo script apiKeyHelper sta fallendo
451</h3>
452
453Il comando configurato nell'impostazione [`apiKeyHelper`](/it/settings#available-settings) è uscito con un errore, ha raggiunto il timeout o non ha stampato nulla su stdout. Senza una chiave dallo script, la richiesta raggiunge l'API con una credenziale segnaposto, e l'API la rifiuta con `401`.
454
455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```
458
459Claude Code esegue nuovamente lo script e ritenta la richiesta fino a due volte in più prima di mostrare questo messaggio, quindi il fallimento emerge entro tre tentativi. {/* min-version: 2.1.208 */}Prima della v2.1.208, Claude Code spendeva l'intero [budget di retry](#automatic-retries) reinviando la richiesta con la credenziale segnaposto e poi segnalava un errore di autenticazione generico `401` invece del fallimento dello script.
460
461Eseguire `/login` non aiuta qui: l'output dell'helper [ha la precedenza](/it/authentication#authentication-precedence) su un login salvato finché l'impostazione è presente.
462
463**Cosa fare:**
464
465* Eseguite il comando configurato in `apiKeyHelper` direttamente nella vostra shell per riprodurre il fallimento
466* Se il comando segnala una sessione scaduta, ri-autenticatevi con il vostro provider di credenziali, ad esempio accedendo di nuovo al vostro SSO o vault di segreti
467* Correggete il comando in modo che stampi la chiave su stdout e esca con codice 0. Consultate [ruotare le credenziali con apiKeyHelper](/it/llm-gateway-connect#rotate-credentials-with-apikeyhelper) per una configurazione funzionante.
468* Eseguite `/status` per confermare che `apiKeyHelper` è la fonte di credenziale attiva. Ogni volta che il comando fallisce, il suo codice di uscita e l'output di errore appaiono in un pannello `Cloud authentication` nel terminale.
469
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 Questa organizzazione è stata disabilitata471 Questa organizzazione è stata disabilitata
435</h3>472</h3>
532 569
533Il 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.570Il 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.
534 571
572Entrambi i messaggi segnalano un rifiuto che l'API ha restituito per una richiesta che Claude Code ha inviato. Quando il login salvato è già stato cancellato dopo un aggiornamento fallito, vedete invece [Login scaduto](#login-expired).
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* Per prompt ripetuti di accesso tra i lanci, consultate i controlli dell'orologio di sistema e del Portachiavi di macOS in [Risoluzione dei problemi](/it/troubleshoot-install#not-logged-in-or-token-expired)584* Per prompt ripetuti di accesso tra i lanci, consultate i controlli dell'orologio di sistema e del Portachiavi di macOS in [Risoluzione dei problemi](/it/troubleshoot-install#not-logged-in-or-token-expired)
546* Per altri errori inclusi `403 Forbidden` e problemi del browser OAuth, consultate [Login e autenticazione](/it/troubleshoot-install#login-and-authentication)585* Per altri errori inclusi `403 Forbidden` e problemi del browser OAuth, consultate [Login e autenticazione](/it/troubleshoot-install#login-and-authentication)
547 586
587<h3 id="login-expired">
588 Login scaduto
589</h3>
590
591Claude Code ha tentato di rinnovare il vostro login salvato claude.ai o Claude Console e il servizio OAuth ha rifiutato il token di aggiornamento memorizzato, quindi Claude Code ha cancellato le credenziali salvate. Dopo di che, ogni richiesta si ferma localmente prima di raggiungere l'API, perché solo `/login` può creare nuove credenziali. {/* min-version: 2.1.206 */}Prima della v2.1.206, Claude Code inviava comunque la richiesta con qualsiasi credenziale rimanesse nell'ambiente, e ogni modello falliva poi con [C'è un problema con il modello selezionato](#theres-an-issue-with-the-selected-model) o un 401 invece di un prompt per accedere.
592
593```text theme={null}
594Login expired · Please run /login
595```
596
597In [modalità non interattiva](/it/headless) (`-p`) e [Agent SDK](/it/agent-sdk/overview), il messaggio legge come segue, e il codice di errore strutturato è `authentication_failed`:
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
602
603Questo non è lo stesso stato di [Token OAuth revocato o scaduto](#oauth-token-revoked-or-expired). Quei messaggi segnalano un 401 che l'API ha restituito. Claude Code stesso produce `Login expired` per un login che ha già fallito a rinnovare, quindi non invia alcuna richiesta.
604
605Le sessioni autenticate con una chiave API, [`CLAUDE_CODE_OAUTH_TOKEN`](/it/env-vars) o un provider di terze parti non utilizzano il login salvato e non vedono mai questo messaggio.
606
607**Cosa fare:**
608
609* Eseguite `/login` per accedere di nuovo. Riprovare senza accedere mostra lo stesso messaggio su ogni richiesta.
610* In modalità non interattiva, eseguite `claude` nello stesso ambiente, completate `/login`, quindi rieseguite il vostro comando. Per l'automazione che non può accedere in modo interattivo, autenticatevi con `ANTHROPIC_API_KEY` o [generate un token di lunga durata con `claude setup-token`](/it/authentication#generate-a-long-lived-token).
611* Se l'accesso continua a fallire, consultate [Login e autenticazione](/it/troubleshoot-install#login-and-authentication)
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 Requisito di ambito OAuth614 Requisito di ambito OAuth
550</h3>615</h3>
603* Se le vostre credenziali sono attuali, confermate che le autorizzazioni IAM in [Configurazione IAM](/it/amazon-bedrock#iam-configuration) siano allegate all'identità che state utilizzando e che il modello selezionato sia abilitato per il vostro account e regione668* Se le vostre credenziali sono attuali, confermate che le autorizzazioni IAM in [Configurazione IAM](/it/amazon-bedrock#iam-configuration) siano allegate all'identità che state utilizzando e che il modello selezionato sia abilitato per il vostro account e regione
604* 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 autorizzazioni669* 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
605 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 Risoluzione della credenziale della catena predefinita AWS scaduta
673</h3>
674
675Il provider di credenziali della catena predefinita AWS non ha prodotto credenziali entro 60 secondi, quindi Claude Code ha fermato la risoluzione e ha fallito la richiesta. Il fallimento è la risoluzione locale delle credenziali: la richiesta non ha mai raggiunto [Amazon Bedrock](/it/amazon-bedrock), [Claude Platform on AWS](/it/claude-platform-on-aws) o l'[endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint). Claude Code cancella la [cache delle credenziali](/it/amazon-bedrock#credential-caching-and-resolution-timeout) e ritenta prima che questo errore emerga, quindi nel momento in cui lo vedete la catena si è bloccata su tentativi ripetuti.
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
680
681Le cause comuni sono un comando `credential_process` nel vostro profilo AWS che attende un input che non può ricevere, e un container o VM il cui servizio di metadati dell'istanza (IMDS) non risponde mai al probe della catena. {/* min-version: 2.1.207 */}Prima della v2.1.207, una catena bloccata lasciava la richiesta in attesa indefinitamente invece di fallire con questo messaggio.
682
683**Cosa fare:**
684
685* Eseguite `aws sts get-caller-identity` nella stessa shell con lo stesso `AWS_PROFILE`. Se si blocca anche, correggete il profilo; un comando `credential_process` che richiede in modo interattivo è una causa comune.
686* Completate il passaggio di accesso prima di avviare Claude Code, ad esempio `aws sso login --profile myprofile`, in modo che la catena si risolva dalla cache SSO locale invece di attendere un flusso del browser
687* Se la vostra catena esegue un accesso interattivo che legittimamente necessita di più di 60 secondi, come SSO con MFA attraverso un wrapper come `aws-vault`, aumentate il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/it/env-vars)
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 Errori di rete e connessione690 Errori di rete e connessione
608</h2>691</h2>
609 692
610Questi 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.693Questi errori significano che una richiesta di rete da Claude Code non ha raggiunto la sua destinazione, o qualcosa tra Claude Code e l'API ha alterato la risposta durante il percorso di ritorno. Di solito originano dalla vostra rete locale, proxy o firewall, oppure dalla politica di rete dell'ambiente cloud.
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 Impossibile connettersi all'API696 Impossibile connettersi all'API
640* 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.723* 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.
641* Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudeteli e ritentate per escludere questa possibilità.724* Docker Desktop e runtime di container simili possono intercettare il traffico in uscita. Chiudeteli e ritentate per escludere questa possibilità.
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 La risposta di streaming di Bedrock ha un content-type inaspettato
728</h3>
729
730Un gateway o un proxy tra Claude Code e [Amazon Bedrock](/it/amazon-bedrock) sta trasformando il corpo della risposta di streaming o la sua intestazione `Content-Type`. Amazon Bedrock trasmette le risposte come `application/vnd.amazon.eventstream`, e Claude Code rifiuta una risposta di streaming riuscita che segnala un content-type diverso invece di decodificare un corpo che non può leggere. La richiesta non viene ritentata.
731
732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```
735
736{/* min-version: 2.1.208 */}Prima della v2.1.208, la stessa configurazione errata si presentava come `API Error: Truncated event message received` dopo che l'intera risposta era stata memorizzata nel buffer.
737
738**Cosa fare:**
739
740* Configurate il gateway per passare il corpo della risposta `InvokeModelWithResponseStream` e la sua intestazione `Content-Type` senza modifiche. Un intermediario che riemette il flusso come server-sent events è una causa comune.
741* Se il gateway riscrive solo l'intestazione e passa il corpo binario intatto, impostate [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/it/env-vars) per saltare il controllo fino a quando il gateway non viene corretto. Consultate [Errori di streaming dietro un gateway o un proxy](/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 Errori di certificato SSL744 Errori di certificato SSL
645</h3>745</h3>
859* **Agent SDK**: il testo di errore omette il suggerimento perché il modello è impostato a livello di programmazione. Imposta [`model` su `Options`](/it/agent-sdk/typescript#options) in TypeScript o [`ClaudeAgentOptions(model=...)`](/it/agent-sdk/python#claudeagentoptions) in Python, e gestisci l'errore strutturato `model_not_found` per visualizzare il tuo ritentativo o selettore di modello.959* **Agent SDK**: il testo di errore omette il suggerimento perché il modello è impostato a livello di programmazione. Imposta [`model` su `Options`](/it/agent-sdk/typescript#options) in TypeScript o [`ClaudeAgentOptions(model=...)`](/it/agent-sdk/python#claudeagentoptions) in Python, e gestisci l'errore strutturato `model_not_found` per visualizzare il tuo ritentativo o selettore di modello.
860* 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](/it/model-config).960* 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](/it/model-config).
861* Se il modello sbagliato continua a tornare nella CLI, un ID obsoleto è impostato da qualche parte. Controlla in [ordine di priorità](/it/model-config#setting-your-model): 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.961* Se il modello sbagliato continua a tornare nella CLI, un ID obsoleto è impostato da qualche parte. Controlla in [ordine di priorità](/it/model-config#setting-your-model): 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.
962* {/* min-version: 2.1.206 */}Claude Code segnala un accesso a claude.ai scaduto come [Accesso scaduto](#login-expired), non come questo errore. Prima di v2.1.206, un accesso scaduto che non poteva più essere aggiornato ha avuto esito negativo con ogni modello con questo errore; esegui `/login` se vedi questo su una versione precedente.
862* Per le distribuzioni di Google Cloud's Agent Platform, vedi [Risoluzione dei problemi di Google Cloud's Agent Platform](/it/google-vertex-ai#troubleshooting).963* Per le distribuzioni di Google Cloud's Agent Platform, vedi [Risoluzione dei problemi di Google Cloud's Agent Platform](/it/google-vertex-ai#troubleshooting).
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
1064 Errori da riga di comando1165 Errori da riga di comando
1065</h2>1166</h2>
1066 1167
1067Questi 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.1168Questi errori provengono dal comando `claude` da riga di comando e dai suoi sottocomandi. Claude Code li stampa prima di eseguire il vostro prompt o di inviare qualsiasi richiesta API.
1068 1169
1069<h3 id="conflict-between-bg-and-print">1170<h3 id="conflict-between-bg-and-print">
1070 Conflitto tra --bg e --print1171 Conflitto tra --bg e --print
1071</h3>1172</h3>
1072 1173
1073Questo 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](/it/agent-view#from-your-shell) a cui vi collegherete successivamente con `claude agents`, mentre `--print` esegue [in modo non interattivo](/it/headless) 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.1174Questo 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](/it/agent-view#from-your-shell) a cui vi collegherete successivamente con `claude agents`, mentre `--print` esegue [in modo non interattivo](/it/headless) e non avvia mai la sessione interattiva a cui `claude agents` si collega. Prima della v2.1.198 questa combinazione creava silenziosamente un job in background che non poteva mai essere collegato.
1074 1175
1075```text theme={null}1176```text theme={null}
1076--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>'`.1177--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>'`.
1082* 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>"`1183* 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>"`
1083 1184
1084<h3 id="the-json-schema-value-is-not-a-valid-json-schema">1185<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
1085 Il valore --json-schema non è uno JSON Schema valido1186 Il valore di --json-schema non è uno schema JSON valido
1086</h3>1187</h3>
1087 1188
1088Lo schema che avete passato a [`--json-schema`](/it/cli-reference#cli-flags) in [modalità non interattiva](/it/headless#get-structured-output) 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.1189Lo schema che avete passato a [`--json-schema`](/it/cli-reference#cli-flags) in [modalità non interattiva](/it/headless#get-structured-output) non ha superato la compilazione dello schema JSON, 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.
1089 1190
1090```text theme={null}1191```text theme={null}
1091Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1118* 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`1219* 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`
1119* Aggiungete quel server direttamente con `claude mcp add` o `claude mcp add-json` con un nome valido. Vedere [Import MCP servers from Claude Desktop](/it/mcp#import-mcp-servers-from-claude-desktop).1220* Aggiungete quel server direttamente con `claude mcp add` o `claude mcp add-json` con un nome valido. Vedere [Import MCP servers from Claude Desktop](/it/mcp#import-mcp-servers-from-claude-desktop).
1120 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Strumento di prompt di autorizzazione MCP non trovato
1224</h3>
1225
1226Lo strumento che avete passato a [`--permission-prompt-tool`](/it/cli-reference#cli-flags) non era tra gli strumenti MCP connessi quando l'esecuzione ha avuto bisogno per la prima volta di una decisione di autorizzazione, sia perché il suo server non si è mai connesso sia perché nessun server connesso espone uno strumento con quel nome. Claude Code invia comunque il vostro prompt: l'esecuzione [non interattiva](/it/headless) esce con questo errore, e codice di uscita 1, alla prima chiamata di strumento che necessita di approvazione, quindi non produce alcuna risposta anche se la richiesta è stata effettuata. Prima del primo prompt, Claude Code attende fino al timeout di connessione per server di 30 secondi impostato da [`MCP_TIMEOUT`](/it/env-vars) affinché quel server si connetta. {/* min-version: 2.1.206 */}Prima della v2.1.206, l'avvio non attendeva che il server finisse di connettersi, quindi un server che si avvia lentamente ma sano produceva questo errore anche.
1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232L'elenco dopo `Available MCP tools:` nomina gli strumenti MCP che erano connessi quando l'attesa è terminata.
1233
1234**Cosa fare:**
1235
1236* Verificate che il server si avvii e rimanga connesso: eseguite `claude mcp list` nella stessa directory e confermate che il server è elencato come connesso
1237* Confermate che il nome dello strumento corrisponda al nome `mcp__<server>__<tool>` che il server espone
1238* Se il server ha bisogno di più di 30 secondi per avviarsi, aumentate [`MCP_TIMEOUT`](/it/env-vars)
1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 Errori dei plugin1241 Errori dei plugin
1123</h2>1242</h2>
1128 Il marketplace è registrato da una fonte non attendibile1247 Il marketplace è registrato da una fonte non attendibile
1129</h3>1248</h3>
1130 1249
1131Il marketplace è registrato con un nome che è [riservato per i marketplace ufficiali di Anthropic](/it/plugin-marketplaces#marketplace-schema), 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.1250Il marketplace è registrato con un nome che è [riservato per i marketplace ufficiali di Anthropic](/it/plugin-marketplaces#marketplace-schema), ma la sua fonte registrata non è un repository GitHub di `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.
1132 1251
1133```text theme={null}1252```text theme={null}
1134Marketplace "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.1253Marketplace "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.
1140* 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 fonte1259* 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
1141* Vedere l'elenco dei nomi riservati in [Schema del marketplace](/it/plugin-marketplaces#marketplace-schema)1260* Vedere l'elenco dei nomi riservati in [Schema del marketplace](/it/plugin-marketplaces#marketplace-schema)
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 Il comando del plugin fa riferimento a user\_config in un comando shell
1264</h3>
1265
1266Un hook del plugin, [monitor](/it/plugins-reference#monitors), o un comando MCP [`headersHelper`](/it/mcp#use-dynamic-headers-for-custom-authentication) fa riferimento a un'[opzione del plugin](/it/plugins-reference#user-configuration) `${user_config.KEY}`, e la stringa sostituita verrebbe passata a una shell. Un valore configurato contenente `$(...)`, backtick o `;` verrebbe eseguito come codice lì, quindi Claude Code rifiuta di avviare il componente invece di sostituire il valore. Il controllo viene eseguito sul modello di comando, quindi l'errore appare anche quando nessun valore è ancora configurato. Prima della v2.1.207, il valore veniva sostituito nel comando shell.
1267
1268La formulazione dipende da quale superficie ha fatto riferimento all'opzione. Un hook in forma shell segnala:
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274Un monitor segnala:
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280Un MCP `headersHelper` segnala:
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**Cosa fare:**
1287
1288* Per un hook, aggiungere un array `args` in modo che venga eseguito in [forma exec](/it/hooks#exec-form-and-shell-form), dove ogni `${user_config.KEY}` diventa un argomento senza shell in mezzo. Oppure eliminare il riferimento e leggere la variabile di ambiente `$CLAUDE_PLUGIN_OPTION_<KEY>` all'interno dello script
1289* Per un monitor, eliminare il riferimento e fare in modo che lo script del monitor legga il valore da un file di configurazione
1290* Per un `headersHelper`, spostare `${user_config.KEY}` nel campo `headers` del server, che non viene analizzato dalla shell, oppure leggere il valore all'interno dello script helper
1291
1292<h2 id="tool-errors">
1293 Errori degli strumenti
1294</h2>
1295
1296Questi errori provengono dai strumenti integrati di Claude che rifiutano un input. Claude corregge la maggior parte degli errori degli strumenti da solo; i due seguenti richiedono una modifica da parte vostra, perché provengono da una definizione di subagent o da una regola di autorizzazione che controllate.
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 L'agente verrebbe generato con zero strumenti
1300</h3>
1301
1302Nulla nell'[elenco `tools` di un subagent](/it/sub-agents#supported-frontmatter-fields) si è risolto in uno strumento, quindi Claude Code rifiuta di avviare il subagent piuttosto che avviarne uno che non può agire. Il messaggio raggruppa le voci in base al motivo per cui non si sono risolte: non è uno strumento riconosciuto, uno strumento che non è disponibile per i subagent, o riconosciuto ma che non corrisponde a nessuno strumento nella sessione corrente. L'omissione del campo `tools` non attiva mai questo rifiuto. Un pattern di server MCP come `mcp__github__*` non è esente: quando nessuno strumento connesso proviene da quel server, l'avvio viene rifiutato con il pattern nel gruppo matched-nothing. Prima della v2.1.208, il subagent veniva avviato senza strumenti e restituiva un risultato vuoto o confuso.
1303
1304```text theme={null}
1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
1306```
1307
1308**Cosa fare:**
1309
1310* Correggete ogni voce che l'errore nomina rispetto agli [strumenti disponibili per i subagent](/it/sub-agents#available-tools)
1311* Rimuovete le voci per gli strumenti che la sessione non ha, come gli strumenti MCP da un server che non è connesso
1312* Per dare al subagent ogni strumento che ha il genitore, eliminate il campo `tools` invece di elencare gli strumenti
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 Il file è coperto da una regola di negazione Read
1316</h3>
1317
1318Lo strumento Edit è stato chiamato su un percorso corrispondente a una [regola di negazione `Read`](/it/permissions#read-and-edit), inclusa la creazione di un nuovo file in quel percorso. La modifica riscrive il contenuto che Claude deve essere in grado di leggere di nuovo, quindi la chiamata viene rifiutata prima di qualsiasi accesso ai file. La regola blocca solo lo strumento Edit: Write e NotebookEdit non sono coperti da regole di negazione `Read`. Prima della v2.1.208, solo una regola di negazione `Edit` bloccava le modifiche, e una regola di negazione `Read` da sola non lo faceva.
1319
1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1322```
1323
1324**Cosa fare:**
1325
1326* Se Claude dovrebbe essere in grado di modificare il file, rimuovete o restringete la regola di negazione `Read` in `/permissions` o nelle [impostazioni](/it/settings#permission-settings)
1327* Se il file deve rimanere intatto, mantenete la regola e aggiungete una regola di negazione `Edit` per lo stesso percorso in modo che anche gli strumenti Write e NotebookEdit vengano bloccati
1328
1329<h2 id="background-session-errors">
1330 Errori di sessione in background
1331</h2>
1332
1333Le [sessioni in background](/it/agent-view) vengono eseguite senza un terminale interattivo proprio, quindi i comandi che ne richiedono uno si comportano diversamente lì. Questi messaggi appaiono nella trascrizione di una sessione in background, nella vista agente o dopo il collegamento.
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 Comandi rifiutati in una sessione in background
1337</h3>
1338
1339I comandi che aprono una finestra di dialogo interattiva vengono rifiutati in una sessione in background con un messaggio che nomina un modulo che funziona lì o che ti dice di eseguire il comando da un terminale regolare. `/install-github-app`, l'elenco delle impostazioni `/mcp` e le azioni di autenticazione nel menu del server MCP vengono tutti rifiutati in questo modo. Prima della versione 2.1.208, aprivano la loro finestra di dialogo all'interno della sessione in background.
1340{/* max-version: 2.1.208 */}Nella versione 2.1.208 solamente, il selettore `/model` è stato rifiutato anche in una sessione in background e `/upgrade` ha stampato l'URL di aggiornamento invece di aprire un browser.
1341
1342La formulazione nomina il comando che è stato rifiutato. L'elenco delle impostazioni `/mcp` riporta:
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**Cosa fare:**
1349
1350* Usa il modulo che il messaggio nomina, come `/mcp reconnect <server>`, `/mcp enable` o `/mcp disable`
1351* Per i flussi di accesso e autorizzazione, esegui il comando da una sessione `claude` regolare in un terminale
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 Errori del launcher CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>
1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/it/corporate-launcher) è impostato e il suo valore non può essere utilizzato, quindi Claude Code rifiuta di avviare il processo interessato piuttosto che eseguirlo senza il launcher. I problemi di configurazione vengono segnalati con un messaggio che inizia con il nome della variabile e dichiara il motivo, ad esempio:
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363Un launcher che si avvia ma esce senza sostituirsi con Claude Code non riesce nella sessione che stava avviando, e la riga della sessione nella vista agente riporta che il launcher `must exec, not daemonize`, seguito da qualsiasi cosa il launcher abbia stampato. Una sessione che non può avviarsi o raggiungere il servizio in background a causa del launcher riporta il problema del launcher come motivo all'interno di `Couldn't reach the background service (...)`.
1364
1365**Cosa fare:**
1366
1367* Imposta la variabile al percorso assoluto di un eseguibile che termina chiamando `exec "$@"`. Vedi [il contratto del launcher](/it/corporate-launcher#the-launcher-contract) per il contratto completo
1368* Controlla `/status`, che mostra il comando di avvio risolto nella sua voce Self-exec e avverte quando il servizio in background in esecuzione non corrisponde, oppure esegui `claude daemon status` da una shell
1369* Dopo aver corretto il valore nel blocco `env` delle [impostazioni](/it/corporate-launcher#set-up-the-launcher), riavvia il servizio in background con `claude daemon stop --any` in modo che il prossimo invio avvii uno avvolto
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 Avvisi di configurazione1372 Avvisi di configurazione
1145</h2>1373</h2>
1159**Cosa fare:**1387**Cosa fare:**
1160 1388
1161* 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ì.1389* 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ì.
1162* In [modalità non interattiva](/it/headless) con `-p` nessuna finestra di dialogo viene visualizzata. Impostare la voce `hasTrustDialogAccepted` in `~/.claude.json` utilizzando la chiave `projects` esatta che il messaggio stampa.1390* In [modalità non interattiva](/it/headless) con `-p` nessuna finestra di dialogo viene mostrata. Impostare la voce `hasTrustDialogAccepted` in `~/.claude.json` utilizzando la chiave `projects` esatta che il messaggio stampa.
1163* {/* 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](/it/permissions#project-allow-rules-and-workspace-trust).1391* {/* 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. {/* min-version: 2.1.207 */}Sulla v2.1.207 e successive, l'aggiornamento non è sufficiente al di fuori di un repository git se non hai considerato attendibile la cartella: determinare che una cartella non si trova all'interno di un repository esegue git, e Claude Code esegue quel controllo solo dopo che accetti la finestra di dialogo di attendibilità, quindi utilizza il primo passaggio. La directory home e qualsiasi altra [home di configurazione](/it/permissions#project-allow-rules-and-workspace-trust) sono esenti e non attendono la finestra di dialogo. Vedi [Regole di autorizzazione del progetto e attendibilità dello spazio di lavoro](/it/permissions#project-allow-rules-and-workspace-trust).
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 Le risposte sembrano di qualità inferiore al solito1394 Le risposte sembrano di qualità inferiore al solito
1167</h2>1395</h2>
1168 1396
1169Se 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:1397Se le risposte di Claude sembrano meno capaci di quanto ti aspetti ma non viene mostrato 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:
1170 1398
1171* Un [`--fallback-model`](/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione1399* Un [`--fallback-model`](/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione
1172* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud rileva che il tuo modello predefinito non è disponibile1400* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile
1173* Il [fallback automatico del modello](/it/model-config#automatic-model-fallback) su Fable 5 sposta la sessione al modello Opus predefinito e mostra un avviso nella trascrizione1401* Il [fallback automatico del modello](/it/model-config#automatic-model-fallback) su Fable 5 sposta la sessione al modello Opus predefinito e mostra un avviso nella trascrizione
1174 1402
1175Il 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](/it/model-config) spiega quando si applica ogni fallback.1403Il 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](/it/model-config) spiega quando si applica ogni fallback.
1179* **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.1407* **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.
1180* **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](/it/model-config#adjust-effort-level) per i valori predefiniti per modello e il collegamento `ultrathink`.1408* **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](/it/model-config#adjust-effort-level) per i valori predefiniti per modello e il collegamento `ultrathink`.
1181* **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](/it/context-window) per come auto-compact influisce sui turni precedenti.1409* **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](/it/context-window) per come auto-compact influisce sui turni precedenti.
1182* **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.1410* **Istruzioni obsolete**: file `CLAUDE.md` grandi o obsoleti e definizioni di strumenti MCP consumano contesto e possono indirizzare le risposte. {/* min-version: 2.1.205 */}Il controllo `/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.
1183 1411
1184Quando 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](/it/checkpointing).1412Quando una risposta va male, il rewind di solito funziona meglio che rispondere con correzioni. Premi Esc due volte o esegui `/rewind` per tornare indietro prima del turno 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](/it/checkpointing).
1185 1413
1186Se 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](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente.1414Se 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](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente.
1187 1415
1188{/* 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.1416Se Claude ti avverte di un sospetto prompt injection, o rifiuta una richiesta a causa di un sospetto injection, e il testo che l'avviso nomina è contesto che Claude Code aggiunge automaticamente alla conversazione piuttosto che contenuto di file o web, esegui `claude update` e riprova. Se l'avviso si ripete dopo l'aggiornamento, [segnalalo](#report-an-error) piuttosto che incollare il contenuto contrassegnato di nuovo nel prompt. {/* min-version: 2.1.201 */}Prima della v2.1.201, Sonnet 5 rifiutava alcune richieste allo stesso modo.
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 Segnalare un errore1419 Segnalare un errore
1199 1427
1200Se un errore non è elencato qui o la correzione suggerita non aiuta:1428Se un errore non è elencato qui o la correzione suggerita non aiuta:
1201 1429
1202* 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.1430* 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. L'invio ad Anthropic richiede l'[autenticazione](/it/authentication). Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e altri provider di terze parti, o quando non sono configurate credenziali Anthropic, `/feedback` salva un archivio locale che è possibile inviare al rappresentante dell'account Anthropic.
1203* 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 configurazione1431* 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
1204* Controllare [status.claude.com](https://status.claude.com) per gli incidenti attivi1432* Controllare [status.claude.com](https://status.claude.com) per gli incidenti attivi
1205* Cercare i [problemi esistenti](https://github.com/anthropics/claude-code/issues) su GitHub1433* Cercare i [problemi esistenti](https://github.com/anthropics/claude-code/issues) su GitHub
