6 6
7> Consulta i messaggi di errore di runtime di Claude Code con il significato di ciascuno e come risolverli.7> Consulta i messaggi di errore di runtime di Claude Code con il significato di ciascuno e come risolverli.
8 8
9Questa 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](/it/troubleshoot-install).9Questa 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](/docs/it/troubleshoot-install).
10 10
11Questi errori e i comandi di recupero si applicano su CLI, l'[app Desktop](/it/desktop) e [Claude Code sul web](/it/claude-code-on-the-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.11Questi errori e i comandi di recupero si applicano su CLI, l'[app Desktop](/docs/it/desktop) e [Claude Code sul web](/docs/it/claude-code-on-the-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.
12 12
13<Note>13<Note>
14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori di runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedi il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).14 Claude Code chiama l'API Claude per le risposte del modello, quindi la maggior parte degli errori di runtime si mappano a un codice di errore API sottostante. Questa pagina copre cosa significa ogni errore all'interno di Claude Code e come recuperare. Per le definizioni del codice di stato HTTP grezzo, vedi il [riferimento degli errori della piattaforma Claude](https://platform.claude.com/docs/en/api/errors).
97 Tentativi automatici97 Tentativi automatici
98</h2>98</h2>
99 99
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.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. 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. 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.
101 101
102Alcune 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:
103 103
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.104* 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.
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.105* 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.106* 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.
107 107
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.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. 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.
109 109
110{/* 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.110A 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.
111 111
112{/* 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](#unable-to-connect-to-api).112Se 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](#unable-to-connect-to-api).
113 113
114Quando 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:114Quando 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:
115 115
116| Variabile | Predefinito | Effetto |116| Variabile | Predefinito | Effetto |
117| :------------------------------------------- | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |117| :------------------------------------------- | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
118| [`CLAUDE_CODE_MAX_RETRIES`](/it/env-vars) | 10 | Numero di tentativi di ripetizione. {/* min-version: 2.1.186 */}Limitato a 15 a partire da v2.1.186; {/* min-version: 2.1.199 */}a partire da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Abbassalo per far emergere i guasti più velocemente negli script. |118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/it/env-vars) | 10 | Numero di tentativi di ripetizione. Limitato a 15 a partire da v2.1.186; a partire da v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Abbassalo per far emergere i guasti più velocemente negli script. |
119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/it/env-vars) | non impostato | Impostalo su `1` in sessioni incustodite come i job CI per ritentare gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. {/* min-version: 2.1.199 */}A partire da v2.1.199 aumenta anche il conteggio di tentativi predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backoff, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. |119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/it/env-vars) | non impostato | Impostalo su `1` in sessioni incustodite come i job CI per ritentare gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. A partire da v2.1.199 aumenta anche il conteggio di tentativi predefinito per altri errori transitori, come errori del server, timeout e connessioni interrotte, a 300, approssimativamente tre ore di backoff, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. |
120| [`API_TIMEOUT_MS`](/it/env-vars) | 600000 | Timeout per richiesta in millisecondi. Aumentalo per reti lente o proxy. |120| [`API_TIMEOUT_MS`](/docs/it/env-vars) | 600000 | Timeout per richiesta in millisecondi. Aumentalo per reti lente o proxy. |
121 121
122<h2 id="server-errors">122<h2 id="server-errors">
123 Errori del server123 Errori del server
196API Error: Response stalled mid-stream. The response above may be incomplete.196API Error: Response stalled mid-stream. The response above may be incomplete.
197```197```
198 198
199* {/* 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.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.
200* `Connection closed mid-response`: la connessione è stata interrotta.200* `Connection closed mid-response`: la connessione è stata interrotta.
201* `Response stalled mid-stream`: il flusso ha smesso di inviare dati.201* `Response stalled mid-stream`: il flusso ha smesso di inviare dati.
202 202
210 Auto mode cannot determine the safety of an action210 Auto mode cannot determine the safety of an action
211</h3>211</h3>
212 212
213Il modello che [auto mode](/it/permission-modes#eliminate-prompts-with-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.213Il modello che [auto mode](/docs/it/permission-modes#eliminate-prompts-with-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.
214 214
215Le letture, le ricerche e le modifiche all'interno della vostra directory di lavoro saltano il classificatore, quindi continuano a funzionare in tutti questi casi.215Le letture, le ricerche e le modifiche all'interno della vostra directory di lavoro saltano il classificatore, quindi continuano a funzionare in tutti questi casi.
216 216
224 224
225* Ritentate dopo pochi secondi; Claude vede lo stesso messaggio e di solito ritenta da solo225* Ritentate dopo pochi secondi; Claude vede lo stesso messaggio e di solito ritenta da solo
226* Se i tentativi continuano a fallire, continuate con attività di sola lettura e tornate all'azione bloccata in seguito226* Se i tentativi continuano a fallire, continuate con attività di sola lettura e tornate all'azione bloccata in seguito
227* Questo è transitorio e non correlato all'[idoneità di auto mode](/it/permission-modes#eliminate-prompts-with-auto-mode); non è necessario modificare le impostazioni227* Questo è transitorio e non correlato all'[idoneità di auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode); non è necessario modificare le impostazioni
228 228
229Quando il classificatore ha restituito una risposta non analizzabile:229Quando il classificatore ha restituito una risposta non analizzabile:
230 230
247 247
248* 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 classificatore248* 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
249* Ritentare non aiuterà; lo stesso contenuto della conversazione attiverà di nuovo il filtro249* Ritentare non aiuterà; lo stesso contenuto della conversazione attiverà di nuovo il filtro
250* Passate a una [modalità di autorizzazione](/it/permission-modes) diversa in modo da poter approvare l'azione quando richiesto, o iniziate una conversazione nuova senza il contenuto che attiva il filtro250* Passate a una [modalità di autorizzazione](/docs/it/permission-modes) diversa in modo da poter approvare l'azione quando richiesto, o iniziate una conversazione nuova senza il contenuto che attiva il filtro
251 251
252Quando la conversazione è cresciuta oltre la finestra di contesto del classificatore:252Quando la conversazione è cresciuta oltre la finestra di contesto del classificatore:
253 253
255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
256```256```
257 257
258In 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](/it/headless) l'esecuzione si interrompe perché la trascrizione cresce solo e ritentare non può avere successo.258In 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](/docs/it/headless) l'esecuzione si interrompe perché la trascrizione cresce solo e ritentare non può avere successo.
259 259
260**Cosa fare:**260**Cosa fare:**
261 261
266 Agent terminated early due to an API error266 Agent terminated early due to an API error
267</h3>267</h3>
268 268
269{/* min-version: 2.1.199 */}La richiesta API di un [subagent](/it/sub-agents) 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.269La richiesta API di un [subagent](/docs/it/sub-agents) 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.
270 270
271```text theme={null}271```text theme={null}
272Agent terminated early due to an API error: <error detail>272Agent terminated early due to an API error: <error detail>
275**Cosa fare:**275**Cosa fare:**
276 276
277* Abbinate il dettaglio dell'errore dopo i due punti alla sua sezione su questa pagina, come [Usage limits](#usage-limits) o [Server errors](#server-errors), e seguite i passaggi di quella sezione277* Abbinate il dettaglio dell'errore dopo i due punti alla sua sezione su questa pagina, come [Usage limits](#usage-limits) o [Server errors](#server-errors), e seguite i passaggi di quella sezione
278* Una volta che l'errore sottostante si risolve, chiedete a Claude di ritentare il compito o [riprendere il subagent](/it/sub-agents#resume-subagents)278* Una volta che l'errore sottostante si risolve, chiedete a Claude di ritentare il compito o [riprendere il subagent](/docs/it/sub-agents#resume-subagents)
279 279
280Quando 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](/it/sub-agents#api-errors-in-subagents).280Quando 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. 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](/docs/it/sub-agents#api-errors-in-subagents).
281 281
282<h2 id="usage-limits">282<h2 id="usage-limits">
283 Limiti di utilizzo283 Limiti di utilizzo
309* 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](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per informazioni su come viene fatturato.309* 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](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per informazioni su come viene fatturato.
310* Per aggiornare il vostro piano per limiti di base più elevati, consultate [claude.com/pricing](https://claude.com/pricing)310* Per aggiornare il vostro piano per limiti di base più elevati, consultate [claude.com/pricing](https://claude.com/pricing)
311 311
312Per monitorare l'indennità rimanente prima di raggiungere il limite, aggiungete i campi `rate_limits` a una [riga di stato personalizzata](/it/statusline#rate-limit-usage), oppure nell'app Desktop fate clic sull'[anello di utilizzo](/it/desktop#check-usage) accanto al selettore di modello.312Per monitorare l'indennità rimanente prima di raggiungere il limite, aggiungete i campi `rate_limits` a una [riga di stato personalizzata](/docs/it/statusline#rate-limit-usage), oppure nell'app Desktop fate clic sull'[anello di utilizzo](/docs/it/desktop#check-usage) accanto al selettore di modello.
313 313
314<h3 id="usage-credits-required-for-1m-context">314<h3 id="usage-credits-required-for-1m-context">
315 Crediti di utilizzo richiesti per il contesto 1M315 Crediti di utilizzo richiesti per il contesto 1M
321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
322```322```
323 323
324Questo è 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](/it/model-config#extended-context) per sapere quali piani includono il contesto 1M direttamente e quali richiedono crediti di utilizzo.324Questo è 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](/docs/it/model-config#extended-context) per sapere quali piani includono il contesto 1M direttamente e quali richiedono crediti di utilizzo.
325 325
326{/* 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]`.326Quando 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]`.
327 327
328**Cosa fare:**328**Cosa fare:**
329 329
330* Eseguite `/model` e selezionate la variante senza il suffisso `[1m]` per tornare alla finestra di contesto standard330* Eseguite `/model` e selezionate la variante senza il suffisso `[1m]` per tornare alla finestra di contesto standard
331* 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 Enterprise331* 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
332* Se l'errore persiste dopo `/model`, un ID modello 1M potrebbe essere impostato altrove. Consultate [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) per i percorsi di configurazione da controllare in ordine di priorità.332* Se l'errore persiste dopo `/model`, un ID modello 1M potrebbe essere impostato altrove. Consultate [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) per i percorsi di configurazione da controllare in ordine di priorità.
333* Per rimuovere completamente le varianti 1M dal selettore di modello, impostate [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/it/env-vars)333* Per rimuovere completamente le varianti 1M dal selettore di modello, impostate [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars)
334 334
335<h3 id="server-is-temporarily-limiting-requests">335<h3 id="server-is-temporarily-limiting-requests">
336 Il server sta limitando temporaneamente le richieste336 Il server sta limitando temporaneamente le richieste
342API Error: Server is temporarily limiting requests (not your usage limit)342API Error: Server is temporarily limiting requests (not your usage limit)
343```343```
344 344
345Claude 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](#automatic-retries) 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.345Claude Code distingue questi dai vostri limiti di piano dall'assenza delle intestazioni di quota unificate che una vera risposta di limite contiene. A partire da v2.1.199 questo viene [ritentato automaticamente](#automatic-retries) 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.
346 346
347**Cosa fare:**347**Cosa fare:**
348 348
366* 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.366* 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.
367* Controllate la console del vostro provider per i limiti attivi e richiedete un livello superiore se necessario367* Controllate la console del vostro provider per i limiti attivi e richiedete un livello superiore se necessario
368* Per le chiavi API di Anthropic, consultate il [riferimento dei limiti di velocità](https://platform.claude.com/docs/en/api/rate-limits) per sapere come funzionano i livelli e come impostare i limiti di spesa per workspace368* Per le chiavi API di Anthropic, consultate il [riferimento dei limiti di velocità](https://platform.claude.com/docs/en/api/rate-limits) per sapere come funzionano i livelli e come impostare i limiti di spesa per workspace
369* Riducete la concorrenza: abbassate [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/it/env-vars), evitate di eseguire molti subagent paralleli, o passate a un modello più piccolo con `/model` per esecuzioni scriptate ad alto volume369* Riducete la concorrenza: abbassate [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/it/env-vars), evitate di eseguire molti subagent paralleli, o passate a un modello più piccolo con `/model` per esecuzioni scriptate ad alto volume
370 370
371<h3 id="credit-balance-is-too-low">371<h3 id="credit-balance-is-too-low">
372 Il saldo dei crediti è troppo basso372 Il saldo dei crediti è troppo basso
382 382
383* Aggiungete crediti su [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considerate di abilitare l'auto-reload lì in modo che il saldo si ricarichi prima di raggiungere lo zero383* Aggiungete crediti su [platform.claude.com/settings/billing](https://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
384* Passate all'autenticazione con abbonamento con `/login` se avete un piano Pro, Max, Team o Enterprise384* Passate all'autenticazione con abbonamento con `/login` se avete un piano Pro, Max, Team o Enterprise
385* Impostate i limiti di spesa per workspace nella Console per evitare che un singolo progetto esaurisca il saldo dell'organizzazione. Consultate [Manage costs effectively](/it/costs).385* Impostate i limiti di spesa per workspace nella Console per evitare che un singolo progetto esaurisca il saldo dell'organizzazione. Consultate [Manage costs effectively](/docs/it/costs).
386 386
387<h2 id="authentication-errors">387<h2 id="authentication-errors">
388 Errori di autenticazione388 Errori di autenticazione
404 404
405* Eseguite `/login` per autenticarvi con il vostro abbonamento Claude o account Console405* Eseguite `/login` per autenticarvi con il vostro abbonamento Claude o account Console
406* 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`406* 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`
407* Per CI o automazione dove il login interattivo non è possibile, configurate uno script [`apiKeyHelper`](/it/settings#available-settings) che recuperi una chiave all'avvio407* Per CI o automazione dove il login interattivo non è possibile, configurate uno script [`apiKeyHelper`](/docs/it/settings#available-settings) che recuperi una chiave all'avvio
408* Consultate [Precedenza dell'autenticazione](/it/authentication#authentication-precedence) per comprendere quale credenziale Claude Code utilizza quando sono presenti più credenziali408* Consultate [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) per comprendere quale credenziale Claude Code utilizza quando sono presenti più credenziali
409 409
410Se vi viene richiesto di accedere ripetutamente, consultate [Non connesso o token scaduto](/it/troubleshoot-install#not-logged-in-or-token-expired) per le correzioni dell'orologio di sistema e del Portachiavi di macOS.410Se vi viene richiesto di accedere ripetutamente, consultate [Non connesso o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per le correzioni dell'orologio di sistema e del Portachiavi di macOS.
411 411
412<h3 id="could-not-resolve-authentication-method">412<h3 id="could-not-resolve-authentication-method">
413 Impossibile risolvere il metodo di autenticazione413 Impossibile risolvere il metodo di autenticazione
414</h3>414</h3>
415 415
416La sessione ha raggiunto il client API senza alcuna credenziale. Questo appare nelle [sessioni in background](/it/agent-view), sessioni cloud e contesti Agent SDK dove il controllo del login interattivo non viene eseguito prima della prima richiesta.416La sessione ha raggiunto il client API senza alcuna credenziale. Questo appare nelle [sessioni in background](/docs/it/agent-view), sessioni cloud e contesti Agent SDK dove il controllo del login interattivo non viene eseguito prima della prima richiesta.
417 417
418```text theme={null}418```text theme={null}
419Could 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 omitted419Could 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
420```420```
421 421
422{/* 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.422Prima 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.
423 423
424**Cosa fare:**424**Cosa fare:**
425 425
426* 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à configurate426* 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
427* 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 interattiva427* 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
428* Per Agent SDK, consultate [configurazione dell'autenticazione](/it/agent-sdk/overview#get-started)428* Per Agent SDK, consultate [configurazione dell'autenticazione](/docs/it/agent-sdk/overview#get-started)
429* Eseguite `/status` in una sessione interattiva nello stesso ambiente per confermare quale fonte di credenziale si risolve429* Eseguite `/status` in una sessione interattiva nello stesso ambiente per confermare quale fonte di credenziale si risolve
430 430
431<h3 id="invalid-api-key">431<h3 id="invalid-api-key">
443* Controllate gli errori di digitazione e confermate che la chiave non sia stata revocata nella [Console](https://platform.claude.com/settings/keys)443* Controllate gli errori di digitazione e confermate che la chiave non sia stata revocata nella [Console](https://platform.claude.com/settings/keys)
444* 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.444* 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.
445* Annullate l'impostazione di `ANTHROPIC_API_KEY` ed eseguite `/login` per utilizzare invece l'autenticazione tramite abbonamento445* Annullate l'impostazione di `ANTHROPIC_API_KEY` ed eseguite `/login` per utilizzare invece l'autenticazione tramite abbonamento
446* 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`](/docs/it/settings#available-settings), eseguite lo script direttamente per confermare che stampi una chiave valida su stdout
447* 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
448 448
449<h3 id="your-apikeyhelper-script-is-failing">449<h3 id="your-apikeyhelper-script-is-failing">
450 Lo script apiKeyHelper sta fallendo450 Lo script apiKeyHelper sta fallendo
451</h3>451</h3>
452 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`.453Il comando configurato nell'impostazione [`apiKeyHelper`](/docs/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 454
455```text theme={null}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 output456Your 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```457```
458 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.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. 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 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.461Eseguire `/login` non aiuta qui: l'output dell'helper [ha la precedenza](/docs/it/authentication#authentication-precedence) su un login salvato finché l'impostazione è presente.
462 462
463**Cosa fare:**463**Cosa fare:**
464 464
465* Eseguite il comando configurato in `apiKeyHelper` direttamente nella vostra shell per riprodurre il fallimento465* 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 segreti466* 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.467* Correggete il comando in modo che stampi la chiave su stdout e esca con codice 0. Consultate [ruotare le credenziali con apiKeyHelper](/docs/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.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 469
470<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account499Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
500```500```
501 501
502Le 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](/it/authentication#authentication-precedence).502Le 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](/docs/it/authentication#authentication-precedence).
503 503
504**Cosa fare:**504**Cosa fare:**
505 505
506* 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`506* 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`
507* Se il messaggio nomina `apiKeyHelper`, rimuovete l'impostazione [`apiKeyHelper`](/it/settings#available-settings) dal vostro `settings.json`507* Se il messaggio nomina `apiKeyHelper`, rimuovete l'impostazione [`apiKeyHelper`](/docs/it/settings#available-settings) dal vostro `settings.json`
508* Eseguite `/login` per accedere con il vostro account claude.ai508* Eseguite `/login` per accedere con il vostro account claude.ai
509* Eseguite `/status` in seguito per confermare che la credenziale attiva sia il vostro abbonamento piuttosto che una chiave API509* Eseguite `/status` in seguito per confermare che la credenziale attiva sia il vostro abbonamento piuttosto che una chiave API
510* Se avete bisogno dell'autenticazione tramite chiave API per l'automazione, chiedete all'amministratore della vostra organizzazione di riattivarla nella Console510* Se avete bisogno dell'autenticazione tramite chiave API per l'automazione, chiedete all'amministratore della vostra organizzazione di riattivarla nella Console
526**Cosa fare:**526**Cosa fare:**
527 527
528* Chiedete al vostro amministratore di abilitare l'accesso a Claude Code per la vostra organizzazione528* Chiedete al vostro amministratore di abilitare l'accesso a Claude Code per la vostra organizzazione
529* Autenticatevi con una chiave API Console invece del vostro abbonamento. Consultate [Autenticazione Claude Console](/it/authentication#claude-console-authentication) per la configurazione.529* Autenticatevi con una chiave API Console invece del vostro abbonamento. Consultate [Autenticazione Claude Console](/docs/it/authentication#claude-console-authentication) per la configurazione.
530* Se siete l'amministratore e non vedete un'opzione per abilitare l'accesso, contattate il [supporto Anthropic](https://support.claude.com)530* Se siete l'amministratore e non vedete un'opzione per abilitare l'accesso, contattate il [supporto Anthropic](https://support.claude.com)
531 531
532<h3 id="routines-are-disabled-by-your-organizations-policy">532<h3 id="routines-are-disabled-by-your-organizations-policy">
533 Le routine sono disabilitate dalla politica della vostra organizzazione533 Le routine sono disabilitate dalla politica della vostra organizzazione
534</h3>534</h3>
535 535
536Un 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](/it/routines) su claude.ai/code.536Un 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](/docs/it/routines) su claude.ai/code.
537 537
538```text theme={null}538```text theme={null}
539Routines are disabled by your organization's policy.539Routines are disabled by your organization's policy.
544**Cosa fare:**544**Cosa fare:**
545 545
546* Chiedete a un Owner nella vostra organizzazione di abilitare l'interruttore **Routines** su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)546* Chiedete a un Owner nella vostra organizzazione di abilitare l'interruttore **Routines** su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
547* Per lavori programmati una tantum che non richiedono routine a livello di organizzazione, consultate [attività programmate](/it/scheduled-tasks)547* Per lavori programmati una tantum che non richiedono routine a livello di organizzazione, consultate [attività programmate](/docs/it/scheduled-tasks)
548 548
549<h3 id="remote-control-requires-the-anthropic-api">549<h3 id="remote-control-requires-the-anthropic-api">
550 Remote Control richiede l'API Anthropic550 Remote Control richiede l'API Anthropic
551</h3>551</h3>
552 552
553La sessione non sta comunicando direttamente con l'API Anthropic, quindi non c'è un backend claude.ai per [Remote Control](/it/remote-control) con cui associarsi.553La sessione non sta comunicando direttamente con l'API Anthropic, quindi non c'è un backend claude.ai per [Remote Control](/docs/it/remote-control) con cui associarsi.
554 554
555```text theme={null}555```text theme={null}
556Remote Control is only available when using Claude via api.anthropic.com.556Remote Control is only available when using Claude via api.anthropic.com.
557```557```
558 558
559Questo 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`](/it/env-vars) punta a un host diverso da `api.anthropic.com`, come un [gateway LLM](/it/llm-gateway) o proxy, anche quando vi accedete con claude.ai.559Questo appare su Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry. A partire dalla v2.1.196 appare anche quando [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) punta a un host diverso da `api.anthropic.com`, come un [gateway LLM](/docs/it/llm-gateway) o proxy, anche quando vi accedete con claude.ai.
560 560
561**Cosa fare:**561**Cosa fare:**
562 562
563* Annullate l'impostazione di `ANTHROPIC_BASE_URL` e riavviate la sessione, oppure avviate Remote Control da una sessione che comunica direttamente con l'API Anthropic563* 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
564* Per questo e gli altri messaggi di avvio di Remote Control, consultate [Risoluzione dei problemi di Remote Control](/it/remote-control#troubleshooting)564* Per questo e gli altri messaggi di avvio di Remote Control, consultate [Risoluzione dei problemi di Remote Control](/docs/it/remote-control#troubleshooting)
565 565
566<h3 id="oauth-token-revoked-or-expired">566<h3 id="oauth-token-revoked-or-expired">
567 Token OAuth revocato o scaduto567 Token OAuth revocato o scaduto
581 581
582* Eseguite `/login` per accedere di nuovo582* Eseguite `/login` per accedere di nuovo
583* Se l'errore ritorna nella stessa sessione dopo la ri-autenticazione, eseguite prima `/logout` per cancellare completamente il token memorizzato, quindi `/login`583* Se l'errore ritorna nella stessa sessione dopo la ri-autenticazione, eseguite prima `/logout` per cancellare completamente il token memorizzato, quindi `/login`
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)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](/docs/it/troubleshoot-install#not-logged-in-or-token-expired)
585* 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](/docs/it/troubleshoot-install#login-and-authentication)
586 586
587<h3 id="login-expired">587<h3 id="login-expired">
588 Login scaduto588 Login scaduto
589</h3>589</h3>
590 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.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. 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 592
593```text theme={null}593```text theme={null}
594Login expired · Please run /login594Login expired · Please run /login
595```595```
596 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`:597In [modalità non interattiva](/docs/it/headless) (`-p`) e [Agent SDK](/docs/it/agent-sdk/overview), il messaggio legge come segue, e il codice di errore strutturato è `authentication_failed`:
598 598
599```text theme={null}599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed600Failed to authenticate: OAuth session expired and could not be refreshed
602 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.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 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.605Le sessioni autenticate con una chiave API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o un provider di terze parti non utilizzano il login salvato e non vedono mai questo messaggio.
606 606
607**Cosa fare:**607**Cosa fare:**
608 608
609* Eseguite `/login` per accedere di nuovo. Riprovare senza accedere mostra lo stesso messaggio su ogni richiesta.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).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`](/docs/it/authentication#generate-a-long-lived-token).
611* Se l'accesso continua a fallire, consultate [Login e autenticazione](/it/troubleshoot-install#login-and-authentication)611* Se l'accesso continua a fallire, consultate [Login e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)
612 612
613<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
614 Requisito di ambito OAuth614 Requisito di ambito OAuth
628 Credenziali AWS scadute o non valide628 Credenziali AWS scadute o non valide
629</h3>629</h3>
630 630
631{/* min-version: 2.1.198 */}Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando [`awsAuthRefresh`](/it/amazon-bedrock#advanced-credential-configuration) è 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](/it/claude-platform-on-aws) o dall'[endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint), che è come questi provider segnalano un token di sicurezza scaduto.631Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) è 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](/docs/it/claude-platform-on-aws) o dall'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint), che è come questi provider segnalano un token di sicurezza scaduto.
632 632
633L'hint di azione nel mezzo nomina il comando `awsAuthRefresh` dalle vostre impostazioni, quindi varia. La parte stabile è il `AWS credentials expired or invalid` iniziale:633L'hint di azione nel mezzo nomina il comando `awsAuthRefresh` dalle vostre impostazioni, quindi varia. La parte stabile è il `AWS credentials expired or invalid` iniziale:
634 634
641**Cosa fare:**641**Cosa fare:**
642 642
643* Eseguite il comando `awsAuthRefresh` nominato nel messaggio, come `aws sso login --profile myprofile`, in un altro terminale e completate l'accesso al browser, quindi riprovate643* 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
644* 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](/it/claude-platform-on-aws#1-configure-aws-credentials)644* 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](/docs/it/claude-platform-on-aws#1-configure-aws-credentials)
645* 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 profilo645* 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
646 646
647<h3 id="aws-authentication-failed">647<h3 id="aws-authentication-failed">
648 Autenticazione AWS non riuscita648 Autenticazione AWS non riuscita
649</h3>649</h3>
650 650
651{/* min-version: 2.1.198 */}Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando [`awsAuthRefresh`](/it/amazon-bedrock#advanced-credential-configuration) è impostato nel vostro file di impostazioni. Il vostro provider AWS ha restituito un 403, oppure [Amazon Bedrock](/it/amazon-bedrock) ha restituito un 401.651Questo messaggio richiede Claude Code v2.1.198 o successiva e appare solo quando [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) è impostato nel vostro file di impostazioni. Il vostro provider AWS ha restituito un 403, oppure [Amazon Bedrock](/docs/it/amazon-bedrock) ha restituito un 401.
652 652
653Claude 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.653Claude 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.
654 654
665**Cosa fare:**665**Cosa fare:**
666 666
667* Eseguite il comando `awsAuthRefresh` nominato nel messaggio, o `aws sso login`, nel caso in cui una credenziale scaduta sia la causa667* Eseguite il comando `awsAuthRefresh` nominato nel messaggio, o `aws sso login`, nel caso in cui una credenziale scaduta sia la causa
668* 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](/docs/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
669* 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
670 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 Risoluzione della credenziale della catena predefinita AWS scaduta672 Risoluzione della credenziale della catena predefinita AWS scaduta
673</h3>673</h3>
674 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.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](/docs/it/amazon-bedrock), [Claude Platform on AWS](/docs/it/claude-platform-on-aws) o l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Claude Code cancella la [cache delle credenziali](/docs/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 676
677```text theme={null}677```text theme={null}
678API Error: AWS default-chain credential resolve timed out678API Error: AWS default-chain credential resolve timed out
679```679```
680 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.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. Prima della v2.1.207, una catena bloccata lasciava la richiesta in attesa indefinitamente invece di fallire con questo messaggio.
682 682
683**Cosa fare:**683**Cosa fare:**
684 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.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 browser686* 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)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`](/docs/it/env-vars)
688 688
689<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
690 Errori di rete e connessione690 Errori di rete e connessione
712**Cosa fare:**712**Cosa fare:**
713 713
714* 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.714* 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.
715* Se siete dietro un proxy aziendale, impostate `HTTPS_PROXY` prima di avviare Claude Code e consultate [Configurazione di rete](/it/network-config)715* Se siete dietro un proxy aziendale, impostate `HTTPS_PROXY` prima di avviare Claude Code e consultate [Configurazione di rete](/docs/it/network-config)
716* Se instradiate il traffico attraverso un gateway LLM o un relay, impostate [`ANTHROPIC_BASE_URL`](/it/env-vars) al suo indirizzo. Consultate [Connettere Claude Code a un gateway LLM](/it/llm-gateway-connect) per la configurazione.716* Se instradiate il traffico attraverso un gateway LLM o un relay, impostate [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) al suo indirizzo. Consultate [Connettere Claude Code a un gateway LLM](/docs/it/llm-gateway-connect) per la configurazione.
717* Assicuratevi che il vostro firewall consenta gli host elencati in [Requisiti di accesso di rete](/it/network-config#network-access-requirements)717* Assicuratevi che il vostro firewall consenta gli host elencati in [Requisiti di accesso di rete](/docs/it/network-config#network-access-requirements)
718* I guasti intermittenti vengono [ritentati automaticamente](#automatic-retries); i guasti persistenti indicano un problema di rete locale718* I guasti intermittenti vengono [ritentati automaticamente](#automatic-retries); i guasti persistenti indicano un problema di rete locale
719 719
720Se `curl` ha successo ma Claude Code continua a fallire, la causa è solitamente qualcosa tra il runtime e la rete piuttosto che la rete stessa:720Se `curl` ha successo ma Claude Code continua a fallire, la causa è solitamente qualcosa tra il runtime e la rete piuttosto che la rete stessa:
727 La risposta di streaming di Bedrock ha un content-type inaspettato727 La risposta di streaming di Bedrock ha un content-type inaspettato
728</h3>728</h3>
729 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.730Un gateway o un proxy tra Claude Code e [Amazon Bedrock](/docs/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 731
732```text theme={null}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.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```734```
735 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.736Prima 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 737
738**Cosa fare:**738**Cosa fare:**
739 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.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).741* Se il gateway riscrive solo l'intestazione e passa il corpo binario intatto, impostate [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/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](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742 742
743<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
744 Errori di certificato SSL744 Errori di certificato SSL
751Unable to connect to API: Self-signed certificate detected751Unable to connect to API: Self-signed certificate detected
752```752```
753 753
754{/* 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](#automatic-retries). Le versioni precedenti hanno speso alcuni minuti ritentando prima di mostrarlo. Le condizioni TLS transitorie, come un timeout di handshake, continuano a essere ritentate.754A 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](#automatic-retries). Le versioni precedenti hanno speso alcuni minuti ritentando prima di mostrarlo. Le condizioni TLS transitorie, come un timeout di handshake, continuano a essere ritentate.
755 755
756Durante `/login` e il controllo di connettività all'avvio, lo stesso guasto viene segnalato con il codice OpenSSL e la correzione inline:756Durante `/login` e il controllo di connettività all'avvio, lo stesso guasto viene segnalato con il codice OpenSSL e la correzione inline:
757 757
762**Cosa fare:**762**Cosa fare:**
763 763
764* Esportate il bundle CA della vostra organizzazione e puntate Claude Code ad esso con `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`764* Esportate il bundle CA della vostra organizzazione e puntate Claude Code ad esso con `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
765* Consultate [Configurazione di rete](/it/network-config#custom-ca-certificates) per le istruzioni di configurazione complete765* Consultate [Configurazione di rete](/docs/it/network-config#custom-ca-certificates) per le istruzioni di configurazione complete
766* Non impostate `NODE_TLS_REJECT_UNAUTHORIZED=0`, che disabilita completamente la convalida del certificato766* Non impostate `NODE_TLS_REJECT_UNAUTHORIZED=0`, che disabilita completamente la convalida del certificato
767 767
768<h3 id="host-not-allowed-in-a-cloud-session">768<h3 id="host-not-allowed-in-a-cloud-session">
778 778
779Potete 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.779Potete 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.
780 780
781Questo non è un problema di rete lato client. Le sessioni cloud e le [routine](/it/routines) 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](/it/claude-code-on-the-web#default-allowed-domains) dei registri di pacchetti, API dei provider cloud, registri di container e domini di sviluppo comuni, ma blocca tutto il resto.781Questo non è un problema di rete lato client. Le sessioni cloud e le [routine](/docs/it/routines) 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](/docs/it/claude-code-on-the-web#default-allowed-domains) dei registri di pacchetti, API dei provider cloud, registri di container e domini di sviluppo comuni, ma blocca tutto il resto.
782 782
783**Cosa fare:**783**Cosa fare:**
784 784
785* 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.785* 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.
786* 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](/it/claude-code-on-the-web#default-allowed-domains) insieme ai vostri domini personalizzati. Selezionate **Full** invece se desiderate un accesso senza restrizioni.786* 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](/docs/it/claude-code-on-the-web#default-allowed-domains) insieme ai vostri domini personalizzati. Selezionate **Full** invece se desiderate un accesso senza restrizioni.
787* Fate clic su **Save changes**. L'esecuzione successiva utilizza l'allowlist aggiornato.787* Fate clic su **Save changes**. L'esecuzione successiva utilizza l'allowlist aggiornato.
788 788
789Consultate [Accesso di rete](/it/claude-code-on-the-web#network-access) per i livelli di accesso e l'allowlist predefinito. Le sessioni CLI locali non sono interessate da questa politica.789Consultate [Accesso di rete](/docs/it/claude-code-on-the-web#network-access) per i livelli di accesso e l'allowlist predefinito. Le sessioni CLI locali non sono interessate da questa politica.
790 790
791<h3 id="couldnt-reconnect-to-your-remote-control-session">791<h3 id="couldnt-reconnect-to-your-remote-control-session">
792 Impossibile riconnettersi alla sessione Remote Control792 Impossibile riconnettersi alla sessione Remote Control
796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
797```797```
798 798
799La ripresa con `claude --resume` o `claude --continue` si ricollega alla sessione [Remote Control](/it/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.799La ripresa con `claude --resume` o `claude --continue` si ricollega alla sessione [Remote Control](/docs/it/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.
800 800
801**Cosa fare:**801**Cosa fare:**
802 802
803* Eseguite `/remote-control` per ritentare la connessione803* Eseguite `/remote-control` per ritentare la connessione
804* Avviate Claude Code senza `--resume` per creare una nuova sessione Remote Control804* Avviate Claude Code senza `--resume` per creare una nuova sessione Remote Control
805* Per altri messaggi di avvio di Remote Control, consultate [Risoluzione dei problemi di Remote Control](/it/remote-control#troubleshooting)805* Per altri messaggi di avvio di Remote Control, consultate [Risoluzione dei problemi di Remote Control](/docs/it/remote-control#troubleshooting)
806 806
807Non 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.807Non vedrete questo messaggio quando il server conferma che la sessione precedente non esiste più; Claude Code ne crea una nuova in quel caso. 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.
808 808
809<h2 id="request-errors">809<h2 id="request-errors">
810 Errori di richiesta810 Errori di richiesta
827* Esegui `/compact` per riassumere i turni precedenti e liberare spazio, oppure `/clear` per ricominciare da capo827* Esegui `/compact` per riassumere i turni precedenti e liberare spazio, oppure `/clear` per ricominciare da capo
828* Esegui `/context` per visualizzare una suddivisione di ciò che consuma la finestra: prompt di sistema, strumenti, file di memoria e messaggi828* Esegui `/context` per visualizzare una suddivisione di ciò che consuma la finestra: prompt di sistema, strumenti, file di memoria e messaggi
829* Disabilita i server MCP che non stai utilizzando con `/mcp disable <name>` per rimuovere le loro definizioni di strumenti dal contesto829* Disabilita i server MCP che non stai utilizzando con `/mcp disable <name>` per rimuovere le loro definizioni di strumenti dal contesto
830* Riduci i file di memoria `CLAUDE.md` di grandi dimensioni, oppure sposta le istruzioni in [regole con ambito di percorso](/it/memory#path-specific-rules) che si caricano solo quando rilevanti830* Riduci i file di memoria `CLAUDE.md` di grandi dimensioni, oppure sposta le istruzioni in [regole con ambito di percorso](/docs/it/memory#path-specific-rules) che si caricano solo quando rilevanti
831* 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.831* 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.
832* L'auto-compact è abilitato per impostazione predefinita e normalmente previene questo errore. Se hai impostato [`DISABLE_AUTO_COMPACT`](/it/env-vars), riabilitalo o esegui `/compact` manualmente prima che la finestra si riempia.832* L'auto-compact è abilitato per impostazione predefinita e normalmente previene questo errore. Se hai impostato [`DISABLE_AUTO_COMPACT`](/docs/it/env-vars), riabilitalo o esegui `/compact` manualmente prima che la finestra si riempia.
833 833
834Vedi [Esplora la finestra di contesto](/it/context-window) per una visualizzazione interattiva di come il contesto si riempie.834Vedi [Esplora la finestra di contesto](/docs/it/context-window) per una visualizzazione interattiva di come il contesto si riempie.
835 835
836<h3 id="error-during-compaction-conversation-too-long">836<h3 id="error-during-compaction-conversation-too-long">
837 Errore durante la compattazione: Conversazione troppo lunga837 Errore durante la compattazione: Conversazione troppo lunga
879API Error: 400 ... image dimensions exceed max allowed size879API Error: 400 ... image dimensions exceed max allowed size
880```880```
881 881
882{/* 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.882Claude 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.
883 883
884**Cosa fare:**884**Cosa fare:**
885 885
939 939
940**Cosa fare:**940**Cosa fare:**
941 941
942* Configura il tuo gateway per inoltrare l'intestazione `anthropic-beta`. Vedi [feature pass-through](/it/llm-gateway-protocol#feature-pass-through) per ciò che i gateway devono inoltrare.942* Configura il tuo gateway per inoltrare l'intestazione `anthropic-beta`. Vedi [feature pass-through](/docs/it/llm-gateway-protocol#feature-pass-through) per ciò che i gateway devono inoltrare.
943* Come fallback, imposta [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/it/env-vars) 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.943* Come fallback, imposta [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/it/env-vars) 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.
944 944
945<h3 id="theres-an-issue-with-the-selected-model">945<h3 id="theres-an-issue-with-the-selected-model">
946 C'è un problema con il modello selezionato946 C'è un problema con il modello selezionato
955**Cosa fare:**955**Cosa fare:**
956 956
957* **CLI interattiva**: esegui `/model` per scegliere dai modelli disponibili per il tuo account.957* **CLI interattiva**: esegui `/model` per scegliere dai modelli disponibili per il tuo account.
958* **Modalità non interattiva (`-p`)**: passa `--model` con un alias o ID valido, oppure imposta [`ANTHROPIC_MODEL`](/it/env-vars). Il testo di errore mostra `Run --model` su questa superficie.958* **Modalità non interattiva (`-p`)**: passa `--model` con un alias o ID valido, oppure imposta [`ANTHROPIC_MODEL`](/docs/it/env-vars). Il testo di errore mostra `Run --model` su questa superficie.
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.959* **Agent SDK**: il testo di errore omette il suggerimento perché il modello è impostato a livello di programmazione. Imposta [`model` su `Options`](/docs/it/agent-sdk/typescript#options) in TypeScript o [`ClaudeAgentOptions(model=...)`](/docs/it/agent-sdk/python#claudeagentoptions) in Python, e gestisci l'errore strutturato `model_not_found` per visualizzare il tuo ritentativo o selettore di modello.
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).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](/docs/it/model-config).
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.961* Se il modello sbagliato continua a tornare nella CLI, un ID obsoleto è impostato da qualche parte. Controlla in [ordine di priorità](/docs/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.962* 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.
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).963* Per le distribuzioni di Google Cloud's Agent Platform, vedi [Risoluzione dei problemi di Google Cloud's Agent Platform](/docs/it/google-vertex-ai#troubleshooting).
964 964
965<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
966 Il modello non è un ID modello riconosciuto966 Il modello non è un ID modello riconosciuto
974 974
975Il suggerimento finale nomina l'alias o l'ID del modello più vicino. Quando nulla è abbastanza vicino, legge `Run /model to see available models.` invece.975Il suggerimento finale nomina l'alias o l'ID del modello più vicino. Quando nulla è abbastanza vicino, legge `Run /model to see available models.` invece.
976 976
977Claude 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](/it/agent-sdk/typescript) `setModel()` o da un'app come l'[app Desktop](/it/desktop) che esegue la CLI di Claude Code per te.977Claude 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](/docs/it/agent-sdk/typescript) `setModel()` o da un'app come l'[app Desktop](/docs/it/desktop) che esegue la CLI di Claude Code per te.
978 978
979**Cosa fare:**979**Cosa fare:**
980 980
981* 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ì981* 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ì
982* 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.982* 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.
983* 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](#theres-an-issue-with-the-selected-model).983* 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](#theres-an-issue-with-the-selected-model).
984* Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/it/claude-platform-on-aws) e dietro un [gateway LLM](/it/llm-gateway) 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.984* Il controllo viene eseguito solo sull'API Anthropic. Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e dietro un [gateway LLM](/docs/it/llm-gateway) 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.
985 985
986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
987 Claude Opus non è disponibile con il piano Claude Pro987 Claude Opus non è disponibile con il piano Claude Pro
1003 Il modello è limitato dalle impostazioni della tua organizzazione1003 Il modello è limitato dalle impostazioni della tua organizzazione
1004</h3>1004</h3>
1005 1005
1006L'amministratore della tua organizzazione ha disabilitato questo modello nella console di amministrazione di claude.ai, oppure è escluso da un elenco di autorizzazioni [`availableModels`](/it/model-config#restrict-model-selection) 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.1006L'amministratore della tua organizzazione ha disabilitato questo modello nella console di amministrazione di claude.ai, oppure è escluso da un elenco di autorizzazioni [`availableModels`](/docs/it/model-config#restrict-model-selection) 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.
1007 1007
1008```text theme={null}1008```text theme={null}
1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
1010```1010```
1011 1011
1012Claude 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](/it/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.1012Claude 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](/docs/it/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.
1013 1013
1014**Cosa fare:**1014**Cosa fare:**
1015 1015
1016* Esegui `/model` per scegliere dai modelli che la tua organizzazione consente. I modelli limitati sono nascosti dal selettore.1016* Esegui `/model` per scegliere dai modelli che la tua organizzazione consente. I modelli limitati sono nascosti dal selettore.
1017* 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 avvio1017* 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
1018* Se hai bisogno di accesso al modello limitato, chiedi all'amministratore della tua organizzazione di abilitarlo. Vedi [Restrizioni del modello dell'organizzazione](/it/model-config#organization-model-restrictions).1018* Se hai bisogno di accesso al modello limitato, chiedi all'amministratore della tua organizzazione di abilitarlo. Vedi [Restrizioni del modello dell'organizzazione](/docs/it/model-config#organization-model-restrictions).
1019 1019
1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">
1021 thinking.type.enabled non è supportato per questo modello1021 thinking.type.enabled non è supportato per questo modello
1031 1031
1032* 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 successivo1032* 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
1033* Se non puoi aggiornare, esegui `/model` e seleziona Opus 4.6 o Sonnet 4.6 invece1033* Se non puoi aggiornare, esegui `/model` e seleziona Opus 4.6 o Sonnet 4.6 invece
1034* {/* min-version: agent-sdk@0.3.197 */}Se lo riscontri nell'[Agent SDK](/it/agent-sdk/overview), 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 successivo1034* Se lo riscontri nell'[Agent SDK](/docs/it/agent-sdk/overview), 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
1035 1035
1036<h3 id="thinking-budget-exceeds-output-limit">1036<h3 id="thinking-budget-exceeds-output-limit">
1037 Il budget di thinking supera il limite di output1037 Il budget di thinking supera il limite di output
1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
1044```1044```
1045 1045
1046Claude 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`](/it/env-vars) è impostato più alto del limite di output del provider, o quando la modalità piano aumenta il budget di thinking.1046Claude 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`](/docs/it/env-vars) è impostato più alto del limite di output del provider, o quando la modalità piano aumenta il budget di thinking.
1047 1047
1048**Cosa fare:**1048**Cosa fare:**
1049 1049
1050* Abbassa `MAX_THINKING_TOKENS`, oppure aumenta [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/it/env-vars) al di sopra del budget di thinking1050* Abbassa `MAX_THINKING_TOKENS`, oppure aumenta [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/it/env-vars) al di sopra del budget di thinking
1051* Vedi [Extended thinking](/it/model-config#extended-thinking) per come il budget interagisce con la lunghezza dell'output1051* Vedi [Extended thinking](/docs/it/model-config#extended-thinking) per come il budget interagisce con la lunghezza dell'output
1052 1052
1053<h3 id="tool-use-or-thinking-block-mismatch">1053<h3 id="tool-use-or-thinking-block-mismatch">
1054 Mancata corrispondenza tra l'uso dello strumento o il blocco di thinking1054 Mancata corrispondenza tra l'uso dello strumento o il blocco di thinking
1066 1066
1067**Cosa fare:**1067**Cosa fare:**
1068 1068
1069* {/* 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.1069* 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.
1070* Esegui `/rewind`, o premi Esc due volte, per tornare indietro a un checkpoint prima del turno corrotto e continua da lì. Vedi [Checkpointing](/it/checkpointing) per come i checkpoint vengono creati e ripristinati.1070* Esegui `/rewind`, o premi Esc due volte, per tornare indietro a un checkpoint prima del turno corrotto e continua da lì. Vedi [Checkpointing](/docs/it/checkpointing) per come i checkpoint vengono creati e ripristinati.
1071 1071
1072<h3 id="usage-policy-refusal">1072<h3 id="usage-policy-refusal">
1073 Rifiuto della politica di utilizzo1073 Rifiuto della politica di utilizzo
1079API 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.1079API 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.
1080```1080```
1081 1081
1082Il 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](/it/amazon-bedrock), [Google Cloud's Agent Platform](/it/google-vertex-ai) e [Microsoft Foundry](/it/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](#safety-measures-flagged-a-cybersecurity-topic).1082Il 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](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/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](#safety-measures-flagged-a-cybersecurity-topic).
1083 1083
1084**Cosa fare:**1084**Cosa fare:**
1085 1085
1086* 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](/it/checkpointing).1086* 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](/docs/it/checkpointing).
1087* 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`.1087* 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`.
1088* In [modalità non interattiva](/it/headless) (`-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.1088* In [modalità non interattiva](/docs/it/headless) (`-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.
1089 1089
1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">
1091 Le misure di sicurezza hanno contrassegnato un argomento di cibersicurezza1091 Le misure di sicurezza hanno contrassegnato un argomento di cibersicurezza
1103 1103
1104Quello che vedi dipende dal tuo provider e dalla modalità:1104Quello che vedi dipende dal tuo provider e dalla modalità:
1105 1105
1106* Su [Amazon Bedrock](/it/amazon-bedrock), [Google Cloud's Agent Platform](/it/google-vertex-ai) e [Microsoft Foundry](/it/microsoft-foundry), un flag di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.1106* Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), un flag di cibersicurezza produce il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal) invece.
1107* [La modalità non interattiva](/it/headless) omette la frase `/feedback`.1107* [La modalità non interattiva](/docs/it/headless) omette la frase `/feedback`.
1108 1108
1109{/* 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.1109Prima 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.
1110 1110
1111**Cosa fare:**1111**Cosa fare:**
1112 1112
1113* Se il tuo lavoro richiede questo contenuto, richiedi l'accesso tramite il [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)1113* Se il tuo lavoro richiede questo contenuto, richiedi l'accesso tramite il [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
1114* Se la tua richiesta non riguardava un argomento di cibersicurezza, esegui `/feedback` per segnalare il falso positivo1114* Se la tua richiesta non riguardava un argomento di cibersicurezza, esegui `/feedback` per segnalare il falso positivo
1115* 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](/it/checkpointing).1115* 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](/docs/it/checkpointing).
1116 1116
1117<h2 id="installation-errors">1117<h2 id="installation-errors">
1118 Errori di installazione1118 Errori di installazione
1119</h2>1119</h2>
1120 1120
1121Questi errori compaiono durante l'installazione o l'aggiornamento di Claude Code, dallo [script di installazione](/it/setup#install-claude-code), `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](/it/troubleshoot-install).1121Questi errori compaiono durante l'installazione o l'aggiornamento di Claude Code, dallo [script di installazione](/docs/it/setup#install-claude-code), `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](/docs/it/troubleshoot-install).
1122 1122
1123<h3 id="installation-was-killed-before-it-could-finish">1123<h3 id="installation-was-killed-before-it-could-finish">
1124 L'installazione è stata interrotta prima di poter terminare1124 L'installazione è stata interrotta prima di poter terminare
1136**Cosa fare:**1136**Cosa fare:**
1137 1137
1138* Interrompere altri processi per liberare memoria, quindi eseguire nuovamente il programma di installazione1138* Interrompere altri processi per liberare memoria, quindi eseguire nuovamente il programma di installazione
1139* Aggiungere spazio di swap o passare a un'istanza più grande. Vedere [Installazione interrotta su server Linux con poca memoria](/it/troubleshoot-install#install-killed-on-low-memory-linux-servers) per i comandi del file di swap.1139* Aggiungere spazio di swap o passare a un'istanza più grande. Vedere [Installazione interrotta su server Linux con poca memoria](/docs/it/troubleshoot-install#install-killed-on-low-memory-linux-servers) per i comandi del file di swap.
1140 1140
1141<h3 id="the-connection-dropped-while-downloading-the-update">1141<h3 id="the-connection-dropped-while-downloading-the-update">
1142 La connessione è stata interrotta durante il download dell'aggiornamento1142 La connessione è stata interrotta durante il download dell'aggiornamento
1143</h3>1143</h3>
1144 1144
1145La connessione al server di download si è chiusa mentre `claude install`, `claude update`, o l'[aggiornatore automatico](/it/setup#auto-updates) 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.1145La connessione al server di download si è chiusa mentre `claude install`, `claude update`, o l'[aggiornatore automatico](/docs/it/setup#auto-updates) 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. Prima della v2.1.202, una singola connessione interrotta faceva fallire il download immediatamente con il semplice errore `aborted` invece di ritentare.
1146 1146
1147```text theme={null}1147```text theme={null}
1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
1157**Cosa fare:**1157**Cosa fare:**
1158 1158
1159* 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.1159* 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.
1160* 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](/it/troubleshoot-install#check-network-connectivity).1160* 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](/docs/it/troubleshoot-install#check-network-connectivity).
1161* 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](/it/network-config#network-access-requirements).1161* 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](/docs/it/network-config#network-access-requirements).
1162* Eseguire `claude doctor` dalla shell per la diagnostica dell'installazione1162* Eseguire `claude doctor` dalla shell per la diagnostica dell'installazione
1163 1163
1164<h2 id="command-line-errors">1164<h2 id="command-line-errors">
1171 Conflitto tra --bg e --print1171 Conflitto tra --bg e --print
1172</h3>1172</h3>
1173 1173
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.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](/docs/it/agent-view#from-your-shell) a cui vi collegherete successivamente con `claude agents`, mentre `--print` esegue [in modo non interattivo](/docs/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.
1175 1175
1176```text theme={null}1176```text theme={null}
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>'`.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>'`.
1179 1179
1180**Cosa fare:**1180**Cosa fare:**
1181 1181
1182* 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](/it/agent-view#from-your-shell).1182* 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](/docs/it/agent-view#from-your-shell).
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>"`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>"`
1184 1184
1185<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">
1186 Il valore di --json-schema non è uno schema JSON valido1186 Il valore di --json-schema non è uno schema JSON valido
1187</h3>1187</h3>
1188 1188
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.1189Lo schema che avete passato a [`--json-schema`](/docs/it/cli-reference#cli-flags) in [modalità non interattiva](/docs/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.
1190 1190
1191```text theme={null}1191```text theme={null}
1192Error: --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
1200 1200
1201* Correggete la parte dello schema che la diagnostica nomina, quindi rieseguite il comando1201* Correggete la parte dello schema che la diagnostica nomina, quindi rieseguite il comando
1202* Se la diagnostica è `schema too large`, riducete l'annidamento dello schema e il riutilizzo di `$ref`1202* Se la diagnostica è `schema too large`, riducete l'annidamento dello schema e il riutilizzo di `$ref`
1203* Vedere [Get structured output](/it/headless#get-structured-output) per uno schema e un comando funzionanti1203* Vedere [Get structured output](/docs/it/headless#get-structured-output) per uno schema e un comando funzionanti
1204 1204
1205<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1206 Impossibile importare un server da Claude Desktop1206 Impossibile importare un server da Claude Desktop
1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.1212Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
1213```1213```
1214 1214
1215Il 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](/it/managed-mcp) della vostra organizzazione.1215Il 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](/docs/it/managed-mcp) della vostra organizzazione.
1216 1216
1217**Cosa fare:**1217**Cosa fare:**
1218 1218
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`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`
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).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](/docs/it/mcp#import-mcp-servers-from-claude-desktop).
1221 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Strumento di prompt di autorizzazione MCP non trovato1223 Strumento di prompt di autorizzazione MCP non trovato
1224</h3>1224</h3>
1225 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.1226Lo strumento che avete passato a [`--permission-prompt-tool`](/docs/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](/docs/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`](/docs/it/env-vars) affinché quel server si connetta. 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 1227
1228```text theme={null}1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1235 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 connesso1236* 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 espone1237* 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)1238* Se il server ha bisogno di più di 30 secondi per avviarsi, aumentate [`MCP_TIMEOUT`](/docs/it/env-vars)
1239 1239
1240<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1241 Errori dei plugin1241 Errori dei plugin
1242</h2>1242</h2>
1243 1243
1244Questi errori provengono dalla configurazione dei [plugin](/it/plugins) e del [marketplace](/it/plugin-marketplaces). 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](/it/discover-plugins#troubleshooting).1244Questi errori provengono dalla configurazione dei [plugin](/docs/it/plugins) e del [marketplace](/docs/it/plugin-marketplaces). 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](/docs/it/discover-plugins#troubleshooting).
1245 1245
1246<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1247 Il marketplace è registrato da una fonte non attendibile1247 Il marketplace è registrato da una fonte non attendibile
1248</h3>1248</h3>
1249 1249
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.1250Il marketplace è registrato con un nome che è [riservato per i marketplace ufficiali di Anthropic](/docs/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.
1251 1251
1252```text theme={null}1252```text theme={null}
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.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.
1257 1257
1258* Eseguire `claude plugin marketplace remove <name>`, quindi aggiungere di nuovo il marketplace dal repository ufficiale `github.com/anthropics`1258* Eseguire `claude plugin marketplace remove <name>`, quindi aggiungere di nuovo il marketplace dal repository ufficiale `github.com/anthropics`
1259* 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
1260* 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](/docs/it/plugin-marketplaces#marketplace-schema)
1261 1261
1262<h3 id="plugin-command-references-user-config">1262<h3 id="plugin-command-references-user-config">
1263 Il comando del plugin fa riferimento a user\_config in un comando shell1263 Il comando del plugin fa riferimento a user\_config in un comando shell
1264</h3>1264</h3>
1265 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.1266Un hook del plugin, [monitor](/docs/it/plugins-reference#monitors), o un comando MCP [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication) fa riferimento a un'[opzione del plugin](/docs/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 1267
1268La formulazione dipende da quale superficie ha fatto riferimento all'opzione. Un hook in forma shell segnala:1268La formulazione dipende da quale superficie ha fatto riferimento all'opzione. Un hook in forma shell segnala:
1269 1269
1285 1285
1286**Cosa fare:**1286**Cosa fare:**
1287 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 script1288* Per un hook, aggiungere un array `args` in modo che venga eseguito in [forma exec](/docs/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 configurazione1289* 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 helper1290* 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 1291
1299 L'agente verrebbe generato con zero strumenti1299 L'agente verrebbe generato con zero strumenti
1300</h3>1300</h3>
1301 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.1302Nulla nell'[elenco `tools` di un subagent](/docs/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 1303
1304```text theme={null}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.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.
1307 1307
1308**Cosa fare:**1308**Cosa fare:**
1309 1309
1310* Correggete ogni voce che l'errore nomina rispetto agli [strumenti disponibili per i subagent](/it/sub-agents#available-tools)1310* Correggete ogni voce che l'errore nomina rispetto agli [strumenti disponibili per i subagent](/docs/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 è connesso1311* 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 strumenti1312* Per dare al subagent ogni strumento che ha il genitore, eliminate il campo `tools` invece di elencare gli strumenti
1313 1313
1315 Il file è coperto da una regola di negazione Read1315 Il file è coperto da una regola di negazione Read
1316</h3>1316</h3>
1317 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.1318Lo strumento Edit è stato chiamato su un percorso corrispondente a una [regola di negazione `Read`](/docs/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 1319
1320```text theme={null}1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1323 1323
1324**Cosa fare:**1324**Cosa fare:**
1325 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)1326* Se Claude dovrebbe essere in grado di modificare il file, rimuovete o restringete la regola di negazione `Read` in `/permissions` o nelle [impostazioni](/docs/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 bloccati1327* 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 1328
1329<h2 id="background-session-errors">1329<h2 id="background-session-errors">
1330 Errori di sessione in background1330 Errori di sessione in background
1331</h2>1331</h2>
1332 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.1333Le [sessioni in background](/docs/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 1334
1335<h3 id="commands-refused-in-a-background-session">1335<h3 id="commands-refused-in-a-background-session">
1336 Comandi rifiutati in una sessione in background1336 Comandi rifiutati in una sessione in background
1337</h3>1337</h3>
1338 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.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.1340Nella 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 1341
1342La formulazione nomina il comando che è stato rifiutato. L'elenco delle impostazioni `/mcp` riporta:1342La formulazione nomina il comando che è stato rifiutato. L'elenco delle impostazioni `/mcp` riporta:
1343 1343
1354 Errori del launcher CLAUDE\_CODE\_PROCESS\_WRAPPER1354 Errori del launcher CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>1355</h3>
1356 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:1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/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 1358
1359```text theme={null}1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1364 1364
1365**Cosa fare:**1365**Cosa fare:**
1366 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 completo1367* Imposta la variabile al percorso assoluto di un eseguibile che termina chiamando `exec "$@"`. Vedi [il contratto del launcher](/docs/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 shell1368* 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 avvolto1369* Dopo aver corretto il valore nel blocco `env` delle [impostazioni](/docs/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 1370
1371<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1372 Avvisi di configurazione1372 Avvisi di configurazione
1378 Lo spazio di lavoro non è stato considerato attendibile1378 Lo spazio di lavoro non è stato considerato attendibile
1379</h3>1379</h3>
1380 1380
1381Claude 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](/it/permissions#project-allow-rules-and-workspace-trust). 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.1381Claude 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](/docs/it/permissions#project-allow-rules-and-workspace-trust). 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.
1382 1382
1383```text theme={null}1383```text theme={null}
1384Ignoring 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.1384Ignoring 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.
1386 1386
1387**Cosa fare:**1387**Cosa fare:**
1388 1388
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ì.1389* Eseguire `claude` nella directory e accettare la finestra di dialogo di attendibilità. 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ì.
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.1390* In [modalità non interattiva](/docs/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.
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).1391* 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. 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](/docs/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](/docs/it/permissions#project-allow-rules-and-workspace-trust).
1392 1392
1393<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1394 Le risposte sembrano di qualità inferiore al solito1394 Le risposte sembrano di qualità inferiore al solito
1396 1396
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: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:
1398 1398
1399* 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`](/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione
1400* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova 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
1401* 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](/docs/it/model-config#automatic-model-fallback) su Fable 5 sposta la sessione al modello Opus predefinito e mostra un avviso nella trascrizione
1402 1402
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.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](/docs/it/model-config) spiega quando si applica ogni fallback.
1404 1404
1405Controlla prima questi elementi:1405Controlla prima questi elementi:
1406 1406
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.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.
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`.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](/docs/it/model-config#adjust-effort-level) per i valori predefiniti per modello e il collegamento `ultrathink`.
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.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](/docs/it/context-window) per come auto-compact influisce sui turni precedenti.
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.1410* **Istruzioni obsolete**: file `CLAUDE.md` grandi o obsoleti e definizioni di strumenti MCP consumano contesto e possono indirizzare le risposte. 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.
1411 1411
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).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](/docs/it/checkpointing).
1413 1413
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.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.
1415 1415
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.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. Prima della v2.1.201, Sonnet 5 rifiutava alcune richieste allo stesso modo.
1417 1417
1418<h2 id="report-an-error">1418<h2 id="report-an-error">
1419 Segnalare un errore1419 Segnalare un errore
1421 1421
1422Per gli errori dei componenti non trattati in questa pagina, consultare la guida pertinente:1422Per gli errori dei componenti non trattati in questa pagina, consultare la guida pertinente:
1423 1423
1424* Il server MCP non è riuscito a connettersi o autenticarsi: [MCP](/it/mcp)1424* Il server MCP non è riuscito a connettersi o autenticarsi: [MCP](/docs/it/mcp)
1425* Lo script hook non è riuscito o ha bloccato uno strumento: [Debug hooks](/it/hooks#debug-hooks)1425* Lo script hook non è riuscito o ha bloccato uno strumento: [Debug hooks](/docs/it/hooks#debug-hooks)
1426* Permesso negato o errori del filesystem durante l'installazione: [Risoluzione dei problemi di installazione e accesso](/it/troubleshoot-install)1426* Permesso negato o errori del filesystem durante l'installazione: [Risoluzione dei problemi di installazione e accesso](/docs/it/troubleshoot-install)
1427 1427
1428Se un errore non è elencato qui o la correzione suggerita non aiuta:1428Se un errore non è elencato qui o la correzione suggerita non aiuta:
1429 1429
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.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](/docs/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.
1431* 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
1432* Controllare [status.claude.com](https://status.claude.com) per gli incidenti attivi1432* Controllare [status.claude.com](https://status.claude.com) per gli incidenti attivi
1433* 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
