15</Note>15</Note>
16 16
17<h2 id="find-your-error">17<h2 id="find-your-error">
18 Trovare il vostro errore18 Trova il tuo errore
19</h2>19</h2>
20 20
21Abbinate il messaggio che vedete a una sezione qui sotto.21Abbina il messaggio che vedi a una sezione qui sotto.
22 22
23| Messaggio | Sezione |23| Messaggio | Sezione |
24| :- | :- |24| :- | :- |
25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Errori del server](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Errori del server](#api-error-repeated-529-overloaded-errors) |
27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Errori del server](#api-error-repeated-529-overloaded-errors) |27| `Opus is experiencing high load` / `Fable is experiencing high load` | [Errori del server](#api-error-repeated-529-overloaded-errors) |
28| `Request timed out` | [Errori del server](#request-timed-out), oppure [Rete](#unable-to-connect-to-api) se il messaggio menziona la vostra connessione internet |28| `Request timed out` | [Errori del server](#request-timed-out), oppure [Rete](#unable-to-connect-to-api) se il messaggio menziona la tua connessione internet |
29| `API Error: No response from API` | [Errori del server](#no-response-from-api) |29| `API Error: No response from API` | [Errori del server](#no-response-from-api) |
30| `Server error mid-response. The response above may be incomplete.` | [Errori del server](#the-response-above-may-be-incomplete) |30| `Server error mid-response. The response above may be incomplete.` | [Errori del server](#the-response-above-may-be-incomplete) |
31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Errori del server](#the-response-above-may-be-incomplete) |31| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Errori del server](#the-response-above-may-be-incomplete) |
186| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |186| `The connection dropped while downloading the update` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |
187| `Download timed out: exceeded the total deadline` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |187| `Download timed out: exceeded the total deadline` | [Errori di installazione](#the-connection-dropped-while-downloading-the-update) |
188| `--bg and --print conflict` | [Errori della riga di comando](#conflict-between-bg-and-print) |188| `--bg and --print conflict` | [Errori della riga di comando](#conflict-between-bg-and-print) |
189| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Errori della riga di comando](#conflict-between-a-system-prompt-flag-and-its-file-form) |
189| `Cloud sessions cannot be created from a --restricted session` | [Errori della riga di comando](#cloud-sessions-cannot-be-created-from-a-restricted-session) |190| `Cloud sessions cannot be created from a --restricted session` | [Errori della riga di comando](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
190| `Cloud sessions are disabled by your organization's policy` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |191| `Cloud sessions are disabled by your organization's policy` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |
191| `Couldn't verify your organization's policy for cloud sessions` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |192| `Couldn't verify your organization's policy for cloud sessions` | [Errori della riga di comando](#cloud-sessions-are-disabled-by-your-organizations-policy) |
250| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errori dei plugin](#plugin-command-references-user-config) |251| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Errori dei plugin](#plugin-command-references-user-config) |
251| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errori dei plugin](#plugin-command-references-user-config) |252| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Errori dei plugin](#plugin-command-references-user-config) |
252| `Plugin archive integrity check failed` | [Errori dei plugin](#plugin-archive-integrity-check-failed) |253| `Plugin archive integrity check failed` | [Errori dei plugin](#plugin-archive-integrity-check-failed) |
254| `An npm plugin source must name a registry package` | [Risoluzione dei problemi dei plugin](/docs/it/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |
253| `path escapes plugin directory` | [Errori dei plugin](#path-escapes-plugin-directory) |255| `path escapes plugin directory` | [Errori dei plugin](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Errori dei plugin](#path-could-not-be-checked) |256| `path could not be checked` | [Errori dei plugin](#path-could-not-be-checked) |
255| `its marketplace entry path does not stay inside the marketplace directory` | [Errori dei plugin](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |257| `its marketplace entry path does not stay inside the marketplace directory` | [Errori dei plugin](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
418 Errori del server420 Errori del server
419</h2>421</h2>
420 422
421La maggior parte di questi errori proviene dal provider di inferenza: il servizio Anthropic su Anthropic API e il servizio dietro l'endpoint di quel provider su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizzato. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) coprono anche cause dal vostro lato, come un account Amazon Bedrock che non può invocare il modello di classificazione o un subagent che ha raggiunto un limite di utilizzo.423La maggior parte di questi errori proviene dal provider di inferenza: il servizio di Anthropic su Anthropic API e il servizio dietro l'endpoint di quel provider su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway personalizzato. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) e [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) coprono anche cause dal tuo lato, come un account Amazon Bedrock che non può invocare il modello del classificatore o un subagent che ha raggiunto un limite di utilizzo.
422 424
423<h3 id="api-error-500-internal-server-error">425<h3 id="api-error-500-internal-server-error">
424 API Error: 500 Internal server error426 API Error: 500 Internal server error
432 434
433La frase finale indica dove controllare lo stato del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry indicano lo stato del servizio di quel provider. Un `ANTHROPIC_BASE_URL` personalizzato indica l'host del gateway.435La frase finale indica dove controllare lo stato del servizio e varia in base al provider. Le configurazioni di Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry indicano lo stato del servizio di quel provider. Un `ANTHROPIC_BASE_URL` personalizzato indica l'host del gateway.
434 436
435Un 5xx dall'API stessa indica un errore imprevisto all'interno dell'API. Non è causato dal vostro prompt, dalle impostazioni o dall'account.437Un 5xx dall'API stessa indica un errore imprevisto all'interno dell'API. Non è causato dal tuo prompt, dalle tue impostazioni o dal tuo account.
436 438
437Quando un proxy, un load balancer o un gateway risponde con una pagina di errore HTML, il messaggio mostra il codice di stato e il titolo della pagina, come `API Error: 502 Bad Gateway`. Per una pagina senza titolo, il messaggio mostra il codice di stato e il suo nome standard. Prima della v2.1.281, il codice di stato veniva eliminato quando la pagina aveva un titolo e il markup grezzo della pagina veniva stampato quando non ne aveva uno.439Quando un proxy, un load balancer o un gateway risponde con una pagina di errore HTML, il messaggio mostra il codice di stato e il titolo della pagina, come `API Error: 502 Bad Gateway`. Per una pagina senza titolo, il messaggio mostra invece il codice di stato e il suo nome standard. Prima della v2.1.281, il codice di stato veniva omesso quando la pagina aveva un titolo e il markup grezzo della pagina veniva stampato quando non ne aveva uno.
438 440
439**Cosa fare:**441**Cosa fare:**
440 442
441* Controllate [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per gli incidenti attivi443* Controlla [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per eventuali incidenti in corso
442* Aspettate un minuto, quindi inviate di nuovo il vostro messaggio. Il vostro messaggio originale è ancora nella conversazione, quindi per un prompt lungo potete digitare `try again` invece di incollare l'intera cosa.444* Aspetta un minuto, quindi invia di nuovo il messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare `try again` invece di incollarlo tutto.
443* Se l'errore persiste senza alcun incidente pubblicato, eseguite `/feedback` in modo che Anthropic possa investigare con i dettagli della vostra richiesta. Vedete [Report an error](#report-an-error) se `/feedback` non è disponibile nel vostro ambiente.445* Se l'errore persiste senza alcun incidente pubblicato, esegui `/feedback` in modo che Anthropic possa indagare con i dettagli della tua richiesta. Consulta [Segnalare un errore](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente.
444 446
445<h3 id="api-error-repeated-529-overloaded-errors">447<h3 id="api-error-repeated-529-overloaded-errors">
446 API Error: Repeated 529 Overloaded errors448 API Error: Repeated 529 Overloaded errors
447</h3>449</h3>
448 450
449L'API è temporaneamente al massimo della capacità per tutti gli utenti. Claude Code ha già riprovato più volte prima di mostrare questo messaggio:451L'API è temporaneamente al limite della capacità per tutti gli utenti. Claude Code ha già riprovato più volte prima di mostrare questo messaggio:
450 452
451```text theme={null}453```text theme={null}
452API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.454API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
453```455```
454 456
455La frase finale varia in base al provider nello stesso modo dell'errore 500 sopra.457La frase finale varia in base al provider nello stesso modo dell'errore 500 descritto sopra.
456 458
457Un 529 non è il vostro limite di utilizzo e non conta rispetto alla vostra quota.459Un 529 non è il tuo limite di utilizzo e non viene conteggiato nella tua quota.
458 460
459**Cosa fare:**461**Cosa fare:**
460 462
461* Controllate [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per gli avvisi di capacità463* Controlla [status.claude.com](https://status.claude.com) o la pagina di stato del provider indicata nel messaggio per eventuali avvisi sulla capacità
462* Riprovate tra pochi minuti464* Riprova tra qualche minuto
463* Eseguite `/model` e passate a un modello diverso per continuare a lavorare, poiché la capacità è tracciata per modello. Claude Code vi chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio `Opus is experiencing high load, please use /model to switch to Sonnet`. Su modelli Fable il messaggio nomina Fable.465* Esegui `/model` e passa a un modello diverso per continuare a lavorare, poiché la capacità è monitorata per modello. Claude Code ti chiede di farlo quando un modello è sotto un carico particolarmente elevato, ad esempio `Opus is experiencing high load, please use /model to switch to Sonnet`. Sui modelli Fable il messaggio indica Fable.
464 466
465 In una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, il messaggio legge `Opus is experiencing high load. Switch to Sonnet.` e cambiate i modelli con il selettore di modelli dell'app.467 In una sessione eseguita dall'app Claude Desktop, come la scheda Code o Cowork, il messaggio è `Opus is experiencing high load. Switch to Sonnet.` e cambi modello con il selettore di modelli dell'app.
466 468
467<h3 id="request-timed-out">469<h3 id="request-timed-out">
468 Request timed out470 Request timed out
469</h3>471</h3>
470 472
471L'API non ha risposto prima della scadenza della connessione.473L'API non ha risposto entro la scadenza della connessione.
472 474
473```text theme={null}475```text theme={null}
474Request timed out476Request timed out
475```477```
476 478
477Questo può accadere durante periodi di carico elevato o quando il modello sta generando una risposta molto grande. Il timeout di richiesta predefinito è di 10 minuti.479Questo può accadere durante periodi di carico elevato o quando il modello sta generando una risposta molto lunga. Il timeout predefinito della richiesta è di 10 minuti.
478 480
479**Cosa fare:**481**Cosa fare:**
480 482
481* Riprovate la richiesta483* Riprova la richiesta
482* Se la causa è una rete lenta o un proxy, aumentate `API_TIMEOUT_MS` come descritto in [Automatic retries](#automatic-retries)484* Se la causa è una rete lenta o un proxy, aumenta `API_TIMEOUT_MS` come descritto in [Nuovi tentativi automatici](#automatic-retries)
483* Se i timeout sono frequenti e la vostra rete è altrimenti sana, vedete [Network and connection errors](#network-and-connection-errors) di seguito485* Se i timeout sono frequenti e la tua rete per il resto funziona correttamente, consulta [Errori di rete e di connessione](#network-and-connection-errors) più avanti
484 486
485<h3 id="no-response-from-api">487<h3 id="no-response-from-api">
486 No response from API488 No response from API
487</h3>489</h3>
488 490
489Claude Code ha inviato una richiesta di streaming e l'API non ha restituito intestazioni di risposta entro la scadenza per il primo byte, quindi Claude Code ha interrotto la richiesta invece di aspettare il timeout di richiesta completo `API_TIMEOUT_MS`, 10 minuti per impostazione predefinita. Claude Code invia di nuovo la richiesta al massimo una volta, se il [retry budget](#tune-retry-behavior) lo consente. Quando il nuovo tentativo rimane senza risposta, il turno termina con questo messaggio, che mostra quanto tempo ha aspettato ogni tentativo. Quando impostate [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/it/env-vars), il limite di un nuovo tentativo non si applica e Claude Code riprova secondo il budget descritto in [Tune retry behavior](#tune-retry-behavior).491Claude Code ha inviato una richiesta in streaming e l'API non ha restituito intestazioni di risposta entro la scadenza per il primo byte, quindi Claude Code ha interrotto la richiesta invece di attendere l'intero timeout di richiesta `API_TIMEOUT_MS`, 10 minuti per impostazione predefinita. Claude Code invia di nuovo la richiesta al massimo una volta, se il [budget dei nuovi tentativi](#tune-retry-behavior) lo consente. Quando anche il nuovo tentativo resta senza risposta, il turno termina con questo messaggio, che mostra quanto ha atteso ciascun tentativo. Quando imposti [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/it/env-vars), il limite di un solo nuovo tentativo non si applica e Claude Code riprova secondo il budget descritto in [Regolare il comportamento dei nuovi tentativi](#tune-retry-behavior).
490 492
491```text theme={null}493```text theme={null}
492API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.494API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
493```495```
494 496
495Claude Code imposta l'attesa per le intestazioni di risposta del primo tentativo e l'attesa del nuovo tentativo separatamente:497Claude Code imposta separatamente l'attesa delle intestazioni di risposta per il primo tentativo e l'attesa per il nuovo tentativo:
496 498
497* **First attempt**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/it/env-vars) quando lo impostate su 1 o più, limitato tra 10 secondi e 30 minuti. Altrimenti Claude Code utilizza il timeout del watchdog a livello di byte elencato in [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs), quindi le variabili che cambiano quel timeout cambiano anche questa attesa. In entrambi i casi, Claude Code aggiunge un secondo per ogni 32KB del corpo della richiesta.499* **Primo tentativo**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/it/env-vars) quando lo imposti su 1 o più, limitato a un valore compreso tra 10 secondi e 30 minuti. Altrimenti Claude Code usa il timeout del watchdog a livello di byte indicato in [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs), quindi le variabili che modificano quel timeout modificano anche questa attesa. In entrambi i casi, Claude Code aggiunge un secondo per ogni 32KB del corpo della richiesta.
498* **Retry**: un secondo in meno di `API_TIMEOUT_MS`, poco meno di 10 minuti per impostazione predefinita, in modo che il nuovo tentativo possa durare più a lungo di un proxy o gateway che tiene la risposta fino al completamento della generazione. Su Amazon Bedrock, il nuovo tentativo utilizza la stessa scadenza del primo tentativo e il messaggio mostra una durata invece di due.500* **Nuovo tentativo**: un secondo in meno di `API_TIMEOUT_MS`, poco meno di 10 minuti per impostazione predefinita, in modo che il nuovo tentativo possa durare più a lungo di un proxy o gateway che trattiene la risposta fino al completamento della generazione. Su Amazon Bedrock, il nuovo tentativo usa la stessa scadenza del primo tentativo e il messaggio mostra una sola durata invece di due.
499 501
500Nessuna attesa supera un secondo in meno di un `API_TIMEOUT_MS` positivo, e un `API_TIMEOUT_MS` positivo inferiore a 11 secondi disattiva la scadenza. Il watchdog a livello di byte inizia solo una volta che le intestazioni di risposta arrivano, quindi una risposta che smette di inviare byte dopo quello segue le [stalled-stream rules](#automatic-retries) invece di questa scadenza.502Nessuna delle due attese supera un secondo in meno di un `API_TIMEOUT_MS` positivo, e un `API_TIMEOUT_MS` positivo inferiore a 11 secondi disattiva la scadenza. Il watchdog a livello di byte parte solo quando arrivano le intestazioni di risposta, quindi una risposta che smette di inviare byte dopo quel momento segue le [regole per i flussi bloccati](#automatic-retries) invece di questa scadenza.
501 503
502**Cosa fare:**504**Cosa fare:**
503 505
504* Inviate di nuovo il vostro messaggio. Il vostro messaggio originale è ancora nella conversazione, quindi per un prompt lungo potete digitare `try again` invece di incollare l'intera cosa.506* Invia di nuovo il messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare `try again` invece di incollarlo tutto.
505* Se si ripete, trattarlo come un [network or proxy problem](#unable-to-connect-to-api).507* Se si ripete, trattalo come un [problema di rete o di proxy](#unable-to-connect-to-api).
506* Se un proxy o gateway sulla vostra rete tiene le risposte fino al completamento, aumentate `API_TIMEOUT_MS` in modo che il nuovo tentativo aspetti più a lungo. Su Amazon Bedrock, aumentate anche `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.508* Se un proxy o gateway sulla tua rete trattiene le risposte fino al loro completamento, aumenta `API_TIMEOUT_MS` in modo che il nuovo tentativo attenda più a lungo. Su Amazon Bedrock, aumenta anche `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.
507* Se il primo tentativo continua a scadere e il nuovo tentativo ha successo, aumentate `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` in modo che il primo tentativo aspetti abbastanza a lungo.509* Se il primo tentativo continua ad andare in timeout e poi il nuovo tentativo riesce, aumenta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` in modo che anche il primo tentativo attenda abbastanza a lungo.
508 510
509Prima della v2.1.242, Claude Code aspettava il timeout di richiesta completo `API_TIMEOUT_MS`, 10 minuti per impostazione predefinita, prima di fallire una richiesta di streaming senza risposta. Prima della v2.1.261, il nuovo tentativo aspettava la stessa scadenza del primo tentativo e il messaggio non mostrava durate.511Prima della v2.1.242, Claude Code attendeva l'intero timeout di richiesta `API_TIMEOUT_MS`, 10 minuti per impostazione predefinita, prima di far fallire una richiesta in streaming senza risposta. Prima della v2.1.261, il nuovo tentativo attendeva la stessa scadenza del primo tentativo e il messaggio non mostrava alcuna durata.
510 512
511<h3 id="the-response-above-may-be-incomplete">513<h3 id="the-response-above-may-be-incomplete">
512 The response above may be incomplete514 The response above may be incomplete
513</h3>515</h3>
514 516
515Una richiesta di streaming non è riuscita mentre la risposta era ancora in corso, dopo che Claude aveva completato un blocco di testo o una chiamata di strumento, o ne aveva iniziato uno dopo aver terminato il suo pensiero. L'invio di nuovo della richiesta potrebbe eseguire le stesse chiamate di strumento due volte, quindi Claude Code mantiene l'output che Claude ha completato e aggiunge questo avviso invece di scartare il turno. Quale variante vedete indica la causa:517Una richiesta in streaming non è riuscita mentre la risposta era ancora in corso, dopo che Claude aveva completato un blocco di testo o una chiamata a uno strumento, oppure ne aveva iniziato uno dopo aver terminato il ragionamento. Inviare di nuovo la richiesta potrebbe eseguire due volte le stesse chiamate agli strumenti, quindi Claude Code conserva l'output che Claude ha completato e aggiunge questo avviso invece di scartare il turno. La variante che vedi indica la causa:
516 518
517```text theme={null}519```text theme={null}
518API Error: Server error mid-response. The response above may be incomplete.520API Error: Server error mid-response. The response above may be incomplete.
523API Error: The response stream was malformed. The response above may be incomplete.525API Error: The response stream was malformed. The response above may be incomplete.
524```526```
525 527
526* `Server error mid-response`: un errore del server di 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.528* `Server error mid-response`: un errore di sovraccarico o un errore del server 5xx a metà flusso. Questa variante richiede Claude Code v2.1.199 o successivo; prima di allora, in questo caso l'output parziale veniva scartato e l'intero turno veniva segnalato come errore.
527* `Connection lost mid-response`: la connessione è stata interrotta. Vedete anche questa variante quando un proxy o gateway termina il corpo della risposta in modo pulito prima che la risposta sia terminata.529* `Connection lost mid-response`: la connessione si è interrotta. Vedi questa variante anche quando un proxy o gateway chiude regolarmente il corpo della risposta prima che la risposta sia terminata.
528* `Your computer went to sleep mid-response`: Claude Code ha rilevato che il vostro computer si è addormentato mentre la risposta era in streaming. Una volta che il vostro computer si sveglia, Claude Code tratta la connessione come interrotta e smette di leggerla.530* `Your computer went to sleep mid-response`: Claude Code ha rilevato che il tuo computer è entrato in sospensione mentre la risposta era in streaming. Quando il computer si riattiva, Claude Code considera la connessione interrotta e smette di leggerla.
529* `Part of the response never arrived`: un evento di flusso è stato perso tra l'API e Claude Code, quindi un evento successivo ha fatto riferimento a contenuto che non è mai arrivato. Prima della v2.1.281, questo caso ha terminato il turno con `API Error: Content block not found`.531* `Part of the response never arrived`: un evento del flusso è andato perso tra l'API e Claude Code, quindi un evento successivo ha fatto riferimento a contenuto mai arrivato. Prima della v2.1.281, questo caso terminava il turno con `API Error: Content block not found`.
530* `The response stream was malformed`: un evento è arrivato per un blocco di contenuto che era già terminato, o un evento è arrivato danneggiato. Un evento danneggiato è uno i cui dati non sono JSON valido, il cui contenuto è mancante o il cui contenuto non corrisponde al tipo dell'evento. Prima della v2.1.284, l'errore grezzo del parser, come uno che inizia con `API Error: JSON Parse error`, appariva invece quando un evento con JSON non valido arrivava dopo che Claude aveva completato il suo pensiero, un blocco di testo o una chiamata di strumento.532* `The response stream was malformed`: è arrivato un evento per un blocco di contenuto già terminato, oppure è arrivato un evento danneggiato. Un evento danneggiato è un evento i cui dati non sono JSON valido, il cui contenuto manca o il cui contenuto non corrisponde al tipo dell'evento. Prima della v2.1.284, quando un evento con JSON non valido arrivava dopo che Claude aveva completato il ragionamento, un blocco di testo o una chiamata a uno strumento, veniva invece mostrato l'errore grezzo del parser, ad esempio uno che inizia con `API Error: JSON Parse error`. Prima della v2.1.287, quando un [guardrail di Amazon Bedrock](/docs/it/amazon-bedrock#aws-guardrails) bloccava una risposta che aveva già trasmesso in streaming il ragionamento e parte del testo, questa variante appariva al posto del messaggio del guardrail.
531* `The response stopped arriving`: la connessione è rimasta aperta ma ha smesso di consegnare dati, quindi il watchdog di inattività dello streaming l'ha interrotta. Prima della v2.1.222, Claude Code poteva anche segnalare questo errore su connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` mentre i ping keep-alive del server stavano ancora arrivando, perché contava solo gli eventi di risposta analizzati lì; l'aggiornamento interrompe quei timeout spuri su quelle rotte. I gateway raggiunti tramite un URL di base del provider come `ANTHROPIC_BEDROCK_BASE_URL` non sono avvolti dal watchdog di byte; vedete [Streaming idle watchdogs](/docs/it/network-config#streaming-idle-watchdogs).533* `The response stopped arriving`: la connessione è rimasta aperta ma ha smesso di trasmettere dati, quindi il watchdog di inattività dello streaming l'ha interrotta. Prima della v2.1.222, Claude Code poteva segnalare questo errore anche sulle connessioni [gateway](/docs/it/gateways) raggiunte tramite `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` mentre i ping keep-alive del server continuavano ad arrivare, perché su quelle connessioni contava solo gli eventi di risposta analizzati; l'aggiornamento elimina quei timeout spuri su quei percorsi. I gateway raggiunti tramite un URL di base del provider come `ANTHROPIC_BEDROCK_BASE_URL` non sono coperti dal watchdog a livello di byte; consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs).
532 534
533Prima della v2.1.227, `Connection lost mid-response` leggeva `Connection closed mid-response` e `The response stopped arriving` leggeva `Response stalled mid-stream`.535Prima della v2.1.227, `Connection lost mid-response` era `Connection closed mid-response` e `The response stopped arriving` era `Response stalled mid-stream`.
534 536
535Quando un evento di flusso perso, duplicato o danneggiato arriva prima che Claude abbia iniziato qualsiasi testo o chiamata di strumento, non vedete questo avviso:537Quando un evento del flusso perso, duplicato o danneggiato arriva prima che Claude abbia iniziato qualsiasi testo o chiamata a uno strumento, non vedi questo avviso:
536 538
537* Se Claude aveva completato solo il suo pensiero, Claude Code invia di nuovo la richiesta. Quando i flussi inviati di nuovo si rompono nello stesso modo, il turno termina con `Part of the response never arrived and no response was produced. Try again.` o `The response stream was malformed and no response was produced. Try again.`539* Se Claude aveva completato solo il ragionamento, Claude Code invia di nuovo la richiesta. Quando i flussi inviati di nuovo si interrompono allo stesso modo, il turno termina con `Part of the response never arrived and no response was produced. Try again.` o `The response stream was malformed and no response was produced. Try again.`
538* Se nulla era stato completato, Claude Code invia di nuovo la richiesta senza streaming. Se avete disattivato quel fallback con [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/it/env-vars), il turno termina con `API Error: Content block not found` per un evento perso o `API Error: Content block already closed` per uno duplicato. Per un evento danneggiato con il fallback disattivato, il turno termina con `API Error: Stream event unreadable` o l'errore grezzo del parser.540* Se non era stato completato nulla, Claude Code invia invece di nuovo la richiesta senza streaming. Se hai disattivato quel fallback con [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/it/env-vars), il turno termina con `API Error: Content block not found` per un evento perso o con `API Error: Content block already closed` per un evento duplicato. Per un evento danneggiato con il fallback disattivato, il turno termina con `API Error: Stream event unreadable` o con l'errore grezzo del parser.
539 541
540In quattro casi, Claude Code gestisce l'errore senza mostrare questo avviso subito:542In quattro casi, Claude Code gestisce l'errore senza mostrare subito questo avviso:
541 543
542* Più in alto nella risposta, Claude Code riprova l'errore o termina il turno con un errore diverso. Vedete [Automatic retries](#automatic-retries).544* Nelle fasi iniziali della risposta, Claude Code riprova dopo l'errore oppure termina il turno con un errore diverso. Consulta [Nuovi tentativi automatici](#automatic-retries).
543* Quando uno di questi errori arriva dopo che Claude ha terminato la risposta, Claude Code mantiene la risposta completa e termina il turno normalmente, senza questo avviso. Prima della v2.1.222, Claude Code mostrava questo avviso quando la connessione veniva interrotta o si bloccava dopo il completamento della risposta e segnalava il turno come errore anche se la risposta era completa.545* Quando uno di questi errori arriva dopo che Claude ha terminato la risposta, Claude Code conserva la risposta completa e termina il turno normalmente, senza questo avviso. Prima della v2.1.222, Claude Code mostrava questo avviso quando la connessione si interrompeva o si bloccava dopo il completamento della risposta e segnalava il turno come errore anche se la risposta era completa.
544* In una [non-interactive session](/docs/it/headless), come una esecuzione `-p`, un'esecuzione [Agent SDK](/docs/it/agent-sdk/overview) o una [cloud session](/docs/it/claude-code-on-the-web), non dovete inviare `continue` voi stessi quando la risposta tagliata è nella conversazione principale e contiene testo ma nessuna chiamata di strumento: Claude Code mantiene l'output parziale e chiede a Claude di continuare da dove si è fermato, fino a tre volte di seguito. Vedete questo avviso per tale risposta solo una volta che Claude Code ha esaurito quelle continuazioni. Prima della v2.1.246, Claude Code terminava un turno non interattivo con questo avviso al primo taglio.546* In una [sessione non interattiva](/docs/it/headless), come un'esecuzione `-p`, un'esecuzione dell'[Agent SDK](/docs/it/agent-sdk/overview) o una [sessione cloud](/docs/it/claude-code-on-the-web), non devi inviare tu `continue` quando la risposta interrotta si trova nella conversazione principale e contiene testo ma nessuna chiamata a uno strumento: Claude Code conserva l'output parziale e chiede a Claude di continuare da dove si era fermato, fino a tre volte di seguito. Vedi questo avviso per una risposta di questo tipo solo quando Claude Code ha esaurito quelle continuazioni. Prima della v2.1.246, Claude Code terminava un turno non interattivo con questo avviso alla prima interruzione.
545* In un [subagent](/docs/it/sub-agents#api-errors-in-subagents), indipendentemente dal fatto che la sessione sia interattiva o meno: quando la sua risposta tagliata contiene testo ma nessuna chiamata di strumento, Claude Code chiede al subagent di continuare. L'avviso diventa l'ultimo messaggio del subagent solo una volta che quelle continuazioni sono esaurite. Prima della v2.1.257, un subagent mostrava questo avviso al primo taglio.547* In un [subagent](/docs/it/sub-agents#api-errors-in-subagents), che la sessione sia interattiva o meno: quando la sua risposta interrotta contiene testo ma nessuna chiamata a uno strumento, Claude Code chiede al subagent di continuare. L'avviso diventa l'ultimo messaggio del subagent solo quando quelle continuazioni sono esaurite. Prima della v2.1.257, un subagent mostrava questo avviso alla prima interruzione.
546 548
547**Cosa fare:**549**Cosa fare:**
548 550
549* In una sessione interattiva, leggete la risposta che rimane sullo schermo: Claude Code mantiene ogni blocco che Claude ha completato prima dell'errore, ma scarta un blocco finale interrotto quando il turno termina, quindi le frasi o le chiamate di strumento finali potrebbero mancare. Rispondete con `continue` per far riprendere a Claude dal suo ultimo blocco completato.551* In una sessione interattiva, leggi la risposta che rimane sullo schermo: Claude Code conserva ogni blocco che Claude ha completato prima dell'errore, ma scarta un blocco finale interrotto quando il turno termina, quindi le frasi finali o le chiamate agli strumenti finali potrebbero mancare. Rispondi con `continue` per far riprendere Claude dal suo ultimo blocco completato.
550* In [non-interactive mode](/docs/it/headless) (`-p`):552* In [modalità non interattiva](/docs/it/headless) (`-p`):
551 * Con l'output di testo predefinito, Claude Code stampa l'ultimo blocco di testo completato che ancora mantiene da prima nel turno, seguito da questo messaggio. Quando non ne mantiene nessuno, Claude Code stampa solo questo messaggio, ad esempio perché Claude Code ha compattato la conversazione a metà turno e ha cancellato quel testo. Prima della v2.1.219, Claude Code stampava solo questo messaggio nell'output di testo `-p` e scartava la risposta che aveva già prodotto.553 * Con l'output di testo predefinito, Claude Code stampa l'ultimo blocco di testo completato che conserva ancora da un punto precedente del turno, seguito da questo messaggio. Quando non ne conserva nessuno, Claude Code stampa solo questo messaggio, ad esempio perché ha compattato la conversazione a metà turno e ha eliminato quel testo. Prima della v2.1.219, Claude Code stampava solo questo messaggio nell'output di testo di `-p` e scartava la risposta già prodotta.
552 * Con `--output-format json` o `stream-json`, Claude Code segnala questo messaggio nel campo `result`.554 * Con `--output-format json` o `stream-json`, Claude Code riporta questo messaggio nel campo `result`.
553 * Per continuare il turno una volta che la connessione è stabile, riprendete la sessione e inviate `continue` come descritto in [Continue conversations](/docs/it/headless#continue-conversations).555 * Per continuare il turno quando la connessione è stabile, riprendi la sessione e invia `continue` come descritto in [Continuare le conversazioni](/docs/it/headless#continue-conversations).
554 556
555<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">557<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">
556 Auto mode cannot determine the safety of an action558 Auto mode cannot determine the safety of an action
557</h3>559</h3>
558 560
559Il modello che [auto mode](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) utilizza per classificare le azioni non poteva produrre una decisione, quindi auto mode non ha approvato l'azione automaticamente. Il messaggio che vedete dipende da come il classificatore non è riuscito.561Il modello che la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) usa per classificare le azioni non è riuscito a produrre una decisione, quindi la modalità auto non ha approvato automaticamente l'azione. Il messaggio che vedi dipende da come il classificatore non è riuscito.
560 562
561Le letture, le ricerche e le modifiche all'interno della vostra directory di lavoro saltano il classificatore, quindi continuano a funzionare in tutti questi casi.563Le letture, le ricerche e le modifiche all'interno della tua directory di lavoro non passano dal classificatore, quindi continuano a funzionare in tutti questi casi.
562 564
563Quando il modello di classificazione non è disponibile:565Quando il modello del classificatore non è disponibile:
564 566
565```text theme={null}567```text theme={null}
566<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.568<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
567```569```
568 570
569Quando Claude Code può determinare la categoria di errore, la nomina tra parentesi dopo `temporarily unavailable`, ad esempio `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Le categorie sono `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` e `(connection failed)`. Se `(timed out)` o `(connection failed)` si ripete, controllate la vostra connessione; vedete [Unable to connect to API](#unable-to-connect-to-api). Prima della v2.1.229, il messaggio non nominava mai una categoria e leggeva `Wait briefly and then try this action again`.571Quando Claude Code riesce a determinare la categoria dell'errore, la indica tra parentesi dopo `temporarily unavailable`, ad esempio `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Le categorie sono `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` e `(connection failed)`. Se `(timed out)` o `(connection failed)` si ripete, controlla la tua connessione; consulta [Unable to connect to API](#unable-to-connect-to-api). Prima della v2.1.229, il messaggio non indicava mai una categoria e diceva `Wait briefly and then try this action again`.
570 572
571Quando nessuna categoria si adatta, il messaggio appare senza categoria tra parentesi; più di un errore produce quella forma. Su [Amazon Bedrock](/docs/it/amazon-bedrock), incluso l'[Mantle endpoint](/docs/it/amazon-bedrock#use-the-mantle-endpoint), appare anche quando il vostro account AWS non può invocare il modello indicato nel messaggio e quel fallimento si ripete ad ogni nuovo tentativo fino a quando al vostro account non viene concesso l'accesso al modello.573Quando nessuna categoria è adatta, il messaggio appare senza categoria tra parentesi; più errori diversi producono questa forma. Su [Amazon Bedrock](/docs/it/amazon-bedrock), incluso l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint), appare anche quando il tuo account AWS non può invocare il modello indicato nel messaggio, e quell'errore si ripete a ogni nuovo tentativo finché al tuo account non viene concesso l'accesso al modello.
572 574
573**Cosa fare:**575**Cosa fare:**
574 576
575* Riprovate dopo pochi secondi; Claude vede lo stesso messaggio e di solito riprova da solo. Un errore transitorio non è correlato all'[auto mode eligibility](/docs/it/permission-modes#eliminate-prompts-with-auto-mode); non dovete cambiare le impostazioni577* Riprova dopo qualche secondo; Claude vede lo stesso messaggio e di solito riprova da solo. Un errore temporaneo non è legato all'[idoneità alla modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode); non devi modificare le impostazioni
576* Se i nuovi tentativi continuano a fallire, continuate con attività di sola lettura e tornate all'azione bloccata in seguito578* Se i nuovi tentativi continuano a non riuscire, prosegui con attività di sola lettura e torna più tardi all'azione bloccata
577* Su Amazon Bedrock, se il messaggio ritorna ad ogni nuovo tentativo, controllate che il vostro account possa invocare il modello che nomina: per i modelli Amazon Bedrock standard, confermate che la vostra [IAM policy](/docs/it/amazon-bedrock#iam-configuration) consente di invocarlo; per gli ID modello Mantle, [contattate il vostro team di account AWS](/docs/it/amazon-bedrock#mantle-endpoint-errors)579* Su Amazon Bedrock, se il messaggio si ripresenta a ogni nuovo tentativo, verifica che il tuo account possa invocare il modello indicato: per i modelli Amazon Bedrock standard, conferma che la tua [policy IAM](/docs/it/amazon-bedrock#iam-configuration) ne consenta l'invocazione; per gli ID modello Mantle, [contatta il team del tuo account AWS](/docs/it/amazon-bedrock#mantle-endpoint-errors)
578 580
579Quando una richiesta di classificazione non riesce perché il vostro token OAuth è scaduto o è stato ruotato da un'altra sessione, Claude Code aggiorna il token e riprova la richiesta una volta, quindi una scadenza di token di routine non emerge come questo messaggio. Prima della v2.1.216, un token scaduto o ruotato non riusciva ad ogni richiesta di classificazione e auto mode negava ogni azione controllata con questo messaggio fino a quando il token non veniva aggiornato.581Quando una richiesta al classificatore non riesce perché il tuo token OAuth è scaduto o è stato ruotato da un'altra sessione, Claude Code aggiorna il token e riprova la richiesta una volta, quindi una normale scadenza del token non si manifesta con questo messaggio. Prima della v2.1.216, un token scaduto o ruotato faceva fallire ogni richiesta al classificatore e la modalità auto negava ogni azione controllata con questo messaggio finché il token non veniva aggiornato.
580 582
581Quando il classificatore ha restituito una risposta non analizzabile:583Quando il classificatore ha restituito una risposta non analizzabile:
582 584
586 588
587**Cosa fare:**589**Cosa fare:**
588 590
589* Riprovate l'azione; questo di solito ha successo al tentativo successivo591* Riprova l'azione; di solito riesce al tentativo successivo
590* Eseguite `claude --debug` e ripetete l'azione per i dettagli nel registro di debug592* Esegui `claude --debug` e ripeti l'azione per vedere i dettagli nel log di debug
591 593
592Quando un controllo di sicurezza API separato ha bloccato la richiesta del classificatore a causa del contenuto della conversazione precedente:594Quando un controllo di sicurezza dell'API separato ha bloccato la richiesta al classificatore a causa di contenuti precedenti della conversazione:
593 595
594```text theme={null}596```text theme={null}
595Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details597Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
596```598```
597 599
598Claude Code nega l'azione ma dice a Claude che questo non è un giudizio che l'azione sia pericolosa e di continuare con altri compiti piuttosto che riprovare. Questi rifiuti non contano verso le [auto mode's pause thresholds](/docs/it/permission-modes#when-auto-mode-falls-back). In un'esecuzione `-p` [non-interactive](/docs/it/headless), Claude Code non interrompe l'esecuzione. Quello che Claude riceve dipende da dove ha richiesto l'azione:600Claude Code nega l'azione ma comunica a Claude che non si tratta di un giudizio sulla pericolosità dell'azione e che deve proseguire con altre attività invece di riprovare. Questi rifiuti non vengono conteggiati nelle [soglie di pausa della modalità auto](/docs/it/permission-modes#when-auto-mode-falls-back). In un'esecuzione `-p` [non interattiva](/docs/it/headless), Claude Code non interrompe l'esecuzione. Ciò che Claude riceve dipende da dove ha richiesto l'azione:
599 601
600* A un [background subagent](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in un'esecuzione `-p` senza `--input-format stream-json`, Claude Code restituisce un risultato di errore contenente `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`602* A un [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in un'esecuzione `-p` senza `--input-format stream-json`, Claude Code restituisce un risultato di errore contenente `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`
601* Ovunque, incluse le sessioni interattive e la conversazione principale di un'esecuzione `-p`, Claude Code restituisce quel rifiuto a Claude603* In tutti gli altri casi, incluse le sessioni interattive e la conversazione principale di un'esecuzione `-p`, Claude Code restituisce quel rifiuto a Claude
602 604
603Prima della v2.1.225, Claude Code contava questi rifiuti verso le soglie di pausa e restituiva lo stesso messaggio di rifiuto di un blocco di classificatore genuino.605Prima della v2.1.225, Claude Code conteggiava questi rifiuti nelle soglie di pausa e restituiva lo stesso messaggio di rifiuto di un vero blocco del classificatore.
604 606
605**Cosa fare:**607**Cosa fare:**
606 608
607* Questo non è un giudizio 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 classificatore609* Non si tratta di una decisione sulla tua azione. Contenuti già presenti nella tua conversazione hanno attivato un filtro di sicurezza dell'API quando la modalità auto ha inviato la conversazione al classificatore
608* Riprovare non aiuterà; lo stesso contenuto della conversazione attiverà di nuovo il filtro610* Riprovare non servirà; gli stessi contenuti della conversazione attiveranno di nuovo il filtro
609* In una sessione interattiva, passate a una [permission mode](/docs/it/permission-modes) diversa in modo da poter approvare l'azione quando richiesto611* In una sessione interattiva, passa a una [modalità di permesso](/docs/it/permission-modes) diversa in modo da poter approvare l'azione quando ti viene chiesto
610* Iniziate una conversazione nuova senza il contenuto che attiva612* Avvia una nuova conversazione senza i contenuti che attivano il filtro
611 613
612Quando la conversazione è cresciuta più grande della finestra di contesto del classificatore:614Quando la conversazione è diventata più grande della finestra di contesto del classificatore:
613 615
614```text theme={null}616```text theme={null}
615Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)617Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
616```618```
617 619
618Quello che accade all'azione dipende da dove Claude l'ha richiesta:620Ciò che accade all'azione dipende da dove Claude l'ha richiesta:
619 621
620* In una sessione interattiva, auto mode torna a un normale prompt di autorizzazione per quell'azione in modo da poter approvarla o negarla manualmente622* In una sessione interattiva, la modalità auto ripiega su una normale richiesta di permesso per quell'azione, così puoi approvarla o negarla manualmente
621* A un [background subagent](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in un'esecuzione `-p` [non-interactive](/docs/it/headless) senza `--input-format stream-json`, Claude Code restituisce un risultato di errore contenente `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` e l'esecuzione continua623* A un [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) in un'esecuzione `-p` [non interattiva](/docs/it/headless) senza `--input-format stream-json`, Claude Code restituisce un risultato di errore contenente `Agent aborted: auto mode classifier transcript exceeded context window in headless mode` e l'esecuzione continua
622* Altrove in un'esecuzione `-p` senza un [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags), non c'è alcun prompt a cui tornare, quindi l'azione non viene eseguita e l'esecuzione continua624* Altrove in un'esecuzione `-p` senza un [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags), non c'è alcuna richiesta di permesso su cui ripiegare, quindi l'azione non viene eseguita e l'esecuzione continua
623 625
624**Cosa fare:**626**Cosa fare:**
625 627
626* In una sessione interattiva, approvate o negate l'azione nel prompt che appare628* In una sessione interattiva, approva o nega l'azione nella richiesta che appare
627* In una sessione interattiva, eseguite `/compact` per ridurre la dimensione della conversazione in modo che le azioni successive si adattino di nuovo alla finestra del classificatore629* In una sessione interattiva, esegui `/compact` per ridurre le dimensioni della conversazione in modo che le azioni successive rientrino di nuovo nella finestra del classificatore
628 630
629<h3 id="the-server-returned-no-safety-verdict">631<h3 id="the-server-returned-no-safety-verdict">
630 The server returned no safety verdict632 The server returned no safety verdict
631</h3>633</h3>
632 634
633Sotto [server-side classifier review](/docs/it/permission-modes#server-side-classifier-review), auto mode nega un'azione quando il server non dà un verdetto per essa. Il rifiuto nomina una categoria tra parentesi quando Claude Code può determinarne una, come `(timed out)`:635Con la [revisione del classificatore lato server](/docs/it/permission-modes#server-side-classifier-review), la modalità auto nega un'azione quando il server non fornisce un verdetto su di essa. Il rifiuto indica una categoria tra parentesi quando Claude Code riesce a determinarla, come `(timed out)`:
634 636
635```text theme={null}637```text theme={null}
636The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.638The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
637```639```
638 640
639Il resto del messaggio dice a Claude se un nuovo tentativo può aiutare. Prima di alcuni di questi rifiuti, Claude Code aspetta in modo che il prossimo tentativo di Claude non segua subito. Durante l'attesa in una sessione interattiva, lo spinner mostra `Auto mode check unavailable` con un conto alla rovescia, e premere `Esc` interrompe il turno.641Il resto del messaggio indica a Claude se un nuovo tentativo può essere utile. Prima di alcuni di questi rifiuti, Claude Code attende, in modo che il tentativo successivo di Claude non segua immediatamente. Durante l'attesa in una sessione interattiva, lo spinner mostra `Auto mode check unavailable` con un conto alla rovescia, e premendo `Esc` interrompi il turno.
640 642
641Dopo dieci risposte di fila senza verdetto, auto mode interrompe il turno:643Dopo dieci risposte consecutive senza verdetto, la modalità auto interrompe il turno:
642 644
643```text theme={null}645```text theme={null}
644Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.646Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.
645```647```
646 648
647Il messaggio di arresto appare in un posto diverso in ogni tipo di sessione:649Il messaggio di interruzione appare in un punto diverso a seconda del tipo di sessione:
648 650
649* In una sessione interattiva, il messaggio appare come un avviso nella trascrizione e il turno termina651* In una sessione interattiva, il messaggio appare come avviso nella trascrizione e il turno termina
650* In un'esecuzione `-p` [non-interactive](/docs/it/headless), l'esecuzione termina e segnala un errore di esecuzione. Con l'output di testo predefinito, il messaggio stampa su stderr.652* In un'esecuzione `-p` [non interattiva](/docs/it/headless), l'esecuzione termina e segnala un errore di esecuzione. Con l'output di testo predefinito, il messaggio viene stampato su stderr.
651* Quando un [subagent](/docs/it/sub-agents) ha raggiunto il limite, il subagent si ferma prima di finire, e Claude riceve quello che ha prodotto con una nota che auto mode l'ha fermato653* Quando un [subagent](/docs/it/sub-agents) ha raggiunto il limite, il subagent si ferma prima di terminare e Claude riceve ciò che ha prodotto, con una nota che indica che la modalità auto lo ha fermato
652 654
653**Cosa fare:**655**Cosa fare:**
654 656
655* Inviate un altro messaggio per far riprovare a Claude. Il conteggio delle risposte ricomincia da capo.657* Invia un altro messaggio per far riprovare Claude. Il conteggio delle risposte riparte da zero.
656* Se l'arresto si ripete e le vostre richieste passano attraverso un [LLM gateway or proxy](/docs/it/llm-gateway), controllate se taglia le risposte di streaming corte o le riscrive. [Server-side classifier review](/docs/it/permission-modes#server-side-classifier-review) dice quale comportamento del gateway causa rifiuti, e la [gateway compatibility guide](/docs/it/llm-gateway-protocol#feature-pass-through) elenca cosa passare attraverso invariato.658* Se l'interruzione si ripete e le tue richieste passano attraverso un [gateway o proxy LLM](/docs/it/llm-gateway), verifica se tronca o riscrive le risposte in streaming. La sezione [Revisione del classificatore lato server](/docs/it/permission-modes#server-side-classifier-review) indica quale comportamento del gateway causa i rifiuti, e la [guida alla compatibilità dei gateway](/docs/it/llm-gateway-protocol#feature-pass-through) elenca cosa deve essere inoltrato senza modifiche.
657* Impostate `CLAUDE_CODE_AUTO_MODE_SERVER=0` prima di avviare Claude Code per utilizzare le sue richieste di classificatore. Prima della v2.1.281, Claude Code non leggeva la variabile su una connessione diretta a Anthropic API.659* Imposta `CLAUDE_CODE_AUTO_MODE_SERVER=0` prima di avviare Claude Code per usare invece le sue richieste al classificatore. Prima della v2.1.281, Claude Code non leggeva la variabile su una connessione diretta ad Anthropic API.
658* Per approvare le azioni voi stessi, [switch out of auto mode](/docs/it/permission-modes#switch-permission-modes)660* Per approvare tu stesso le azioni, [esci dalla modalità auto](/docs/it/permission-modes#switch-permission-modes)
659 661
660Prima della v2.1.280, Claude Code negava ogni azione da una risposta senza verdetto immediatamente e non interrompeva mai il turno.662Prima della v2.1.280, Claude Code negava immediatamente ogni azione proveniente da una risposta senza verdetto e non interrompeva mai il turno.
661 663
662<h3 id="agent-terminated-early-due-to-an-api-error">664<h3 id="agent-terminated-early-due-to-an-api-error">
663 Agent terminated early due to an API error665 Agent terminated early due to an API error
664</h3>666</h3>
665 667
666Una 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 nuovi tentativi per un errore del server 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 veniva restituito a Claude come se fosse il risultato del subagent.668Una richiesta API di un [subagent](/docs/it/sub-agents) non è riuscita in modo definitivo, ad esempio perché è stato raggiunto un limite di utilizzo o perché i nuovi tentativi per un errore del server si sono esauriti, quindi il subagent si è fermato prima di completare la sua attività. Questo messaggio richiede Claude Code v2.1.199 o successivo; prima di allora il testo dell'errore API veniva restituito a Claude come se fosse il risultato del subagent.
667 669
668```text theme={null}670```text theme={null}
669Agent terminated early due to an API error: <error detail>671Agent terminated early due to an API error: <error detail>
671 673
672**Cosa fare:**674**Cosa fare:**
673 675
674* 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 sezione676* Individua la sezione di questa pagina corrispondente al dettaglio dell'errore dopo i due punti, come [Limiti di utilizzo](#usage-limits) o [Errori del server](#server-errors), e segui i passaggi di quella sezione
675* Una volta che l'errore sottostante si risolve, chiedete a Claude di riprovare il compito o di [resume the subagent](/docs/it/sub-agents#resume-subagents)677* Una volta risolto l'errore sottostante, chiedi a Claude di riprovare l'attività o di [riprendere il subagent](/docs/it/sub-agents#resume-subagents)
676 678
677Quando un limite di velocità, sovraccarico o errore del server interrompe un subagent in primo piano che ha già prodotto 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 restituiva un risultato parziale vuoto. Vedete [API errors in subagents](/docs/it/sub-agents#api-errors-in-subagents).679Quando un rate limit, un sovraccarico o un errore del server interrompe un subagent in primo piano che ha già prodotto output di testo, Claude riceve quell'output parziale contrassegnato come incompleto invece di questo errore. Anche un subagent il cui unico output erano chiamate agli strumenti riceve questo errore; nella v2.1.199 quel caso restituiva invece un risultato parziale vuoto. Consulta [Errori API nei subagent](/docs/it/sub-agents#api-errors-in-subagents).
678 680
679<h2 id="usage-limits">681<h2 id="usage-limits">
680 Limiti di utilizzo682 Limiti di utilizzo
885 Errori di autenticazione887 Errori di autenticazione
886</h2>888</h2>
887 889
888Questi errori significano che Claude Code non può provare la Vostra identità all'API. Eseguite `/status` in qualsiasi momento per vedere quale credenziale è attualmente attiva.890Questi errori indicano che Claude Code non riesce a dimostrare la tua identità all'API. Esegui `/status` in qualsiasi momento per vedere quale credenziale è attualmente attiva.
889 891
890<h3 id="not-logged-in">892<h3 id="not-logged-in">
891 Non connesso893 Non hai effettuato l'accesso
892</h3>894</h3>
893 895
894Nessuna credenziale valida è disponibile per questa sessione.896Non è disponibile alcuna credenziale valida per questa sessione.
895 897
896```text theme={null}898```text theme={null}
897Not logged in · Please run /login899Not logged in · Please run /login
898```900```
899 901
900In una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, il messaggio legge `Authentication required · Sign in again to continue`, e vi accedete di nuovo dall'app.902In una sessione eseguita dall'app Claude Desktop, come la scheda Code o Cowork, il messaggio è `Authentication required · Sign in again to continue` e devi accedere di nuovo dall'app.
903
904Se accedi con il tuo account claude.ai in un'altra finestra di Claude Code che usa la stessa [directory di configurazione](/docs/it/claude-directory), una sessione interattiva che mostra questo messaggio inizia a usare quell'accesso da sola. Non devi riavviarla.
905
906Prima della v2.1.286 su macOS, la sessione poteva continuare a mostrare il messaggio dopo che avevi effettuato l'accesso da un'altra finestra. In quelle versioni, riavvia la sessione che mostra il messaggio.
901 907
902**Cosa fare:**908**Cosa fare:**
903 909
904* Eseguite `/login` per autenticarvi con il Vostro abbonamento Claude o l'account Console910* Esegui `/login` per autenticarti con il tuo abbonamento Claude o con il tuo account Console
905* 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`911* Se ti aspettavi che una variabile d'ambiente ti autenticasse, verifica che `ANTHROPIC_API_KEY` sia impostata ed esportata nella shell da cui hai avviato `claude`
906* Per CI o automazione dove il login interattivo non è possibile, configurate uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) che recuperi una chiave all'avvio912* Per CI o automazioni in cui l'accesso interattivo non è possibile, configura uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) che recuperi una chiave all'avvio
907* Vedete [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) per capire quale credenziale Claude Code utilizza quando sono presenti più credenziali913* Consulta [Precedenza di autenticazione](/docs/it/authentication#authentication-precedence) per capire quale credenziale usa Claude Code quando ne sono presenti diverse
908 914
909Se vi viene chiesto di accedere ripetutamente, vedete [Non connesso o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per i controlli dell'orologio di sistema e i passaggi di recupero dell'archiviazione delle credenziali di macOS.915Se ti viene chiesto ripetutamente di accedere, consulta [Accesso non effettuato o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per i controlli dell'orologio di sistema e i passaggi di ripristino dell'archiviazione delle credenziali su macOS.
910 916
911<h3 id="could-not-resolve-authentication-method">917<h3 id="could-not-resolve-authentication-method">
912 Impossibile risolvere il metodo di autenticazione918 Impossibile determinare il metodo di autenticazione
913</h3>919</h3>
914 920
915La sessione ha raggiunto il client API senza alcuna credenziale. Le [sessioni in background](/docs/it/agent-view) e le sessioni cloud mostrano questo messaggio quando il worker si avvia senza una credenziale. Le esecuzioni interattive, `-p` e Agent SDK segnalano la stessa condizione di [Non connesso](#not-logged-in) e scrivono questa stringa solo nel loro log di debug, quindi se l'avete trovata lì, seguite quella voce invece.921La sessione ha raggiunto il client API senza alcuna credenziale. Le [sessioni in background](/docs/it/agent-view) e le sessioni cloud mostrano questo messaggio quando il worker si avvia senza una credenziale. Le esecuzioni interattive, con `-p` e con l'Agent SDK segnalano la stessa condizione come [Non hai effettuato l'accesso](#not-logged-in) e scrivono questa stringa solo nel proprio log di debug, quindi se l'hai trovata lì, segui invece quella voce.
916 922
917```text theme={null}923```text theme={null}
918Could 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 omitted924Could 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
919```925```
920 926
921Sulle versioni attuali l'errore significa che nessuna credenziale era disponibile al processo worker. Prima della v2.1.174, una sessione in background assegnata a un worker pre-inizializzato inattivo poteva fallire in questo modo anche quando le credenziali valide erano configurate. Prima della v2.1.176, anche una sessione cloud che era rimasta inattiva prima di essere rivendicata poteva farlo. Aggiornate per recuperare.927Nelle versioni attuali l'errore significa che nessuna credenziale era disponibile per il processo worker. Prima della v2.1.174, una sessione in background assegnata a un worker pre-inizializzato inattivo poteva fallire in questo modo anche quando erano configurate credenziali valide. Prima della v2.1.176, poteva succedere anche a una sessione cloud rimasta inattiva prima di essere presa in carico. Aggiorna per risolvere.
922 928
923**Cosa fare:**929**Cosa fare:**
924 930
925* Aggiornate alla v2.1.176 o successiva se questo appare in una sessione in background o cloud e le Vostre credenziali sono già configurate931* Aggiorna alla v2.1.176 o successiva se questo appare in una sessione in background o cloud e le tue credenziali sono già configurate
926* Confermate che `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` o le Vostre credenziali del provider cloud siano impostati nell'ambiente che avvia il worker, non solo nella Vostra shell interattiva932* Verifica che `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` o le credenziali del tuo provider cloud siano impostate nell'ambiente che avvia il worker, non solo nella tua shell interattiva
927* Per Agent SDK, vedete [configurazione dell'autenticazione nella guida rapida](/docs/it/agent-sdk/quickstart#setup)933* Per l'Agent SDK, consulta [la configurazione dell'autenticazione nella guida rapida](/docs/it/agent-sdk/quickstart#setup)
928* Eseguite `/status` in una sessione interattiva nello stesso ambiente per confermare quale fonte di credenziale si risolve934* Esegui `/status` in una sessione interattiva nello stesso ambiente per verificare quale origine delle credenziali viene determinata
929 935
930<h3 id="invalid-api-key">936<h3 id="invalid-api-key">
931 Chiave API non valida937 Chiave API non valida
937Invalid API key · Fix external API key943Invalid API key · Fix external API key
938```944```
939 945
940Quando il messaggio continua oltre `Fix external API key` con una descrizione come `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, l'API non ha mai visto la chiave. Claude Code ha trovato un carattere che le intestazioni HTTP non possono trasportare e ha fermato la richiesta prima di inviarla. Vedete [Valore di intestazione di richiesta non valido](#invalid-request-header-value) per come leggere la descrizione e correggere il valore.946Quando il messaggio prosegue dopo `Fix external API key` con una descrizione come `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, l'API non ha mai visto la chiave. Claude Code ha trovato un carattere che le intestazioni HTTP non possono trasportare e ha fermato la richiesta prima di inviarla. Consulta [Valore dell'intestazione della richiesta non valido](#invalid-request-header-value) per sapere come leggere la descrizione e correggere il valore.
941 947
942**Cosa fare:**948**Cosa fare:**
943 949
944* Controllate gli errori di battitura e confermate che la chiave non sia stata revocata nella [Console](https://platform.claude.com/settings/keys)950* Controlla eventuali errori di battitura e verifica che la chiave non sia stata revocata nella [Console](https://platform.claude.com/settings/keys)
945* Nella stessa shell, eseguite `env | grep ANTHROPIC`, oppure in PowerShell `Get-ChildItem Env:ANTHROPIC*`. 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.951* Nella stessa shell, esegui `env | grep ANTHROPIC`, oppure in PowerShell `Get-ChildItem Env:ANTHROPIC*`. Strumenti come direnv, i plugin della shell per dotenv e i terminali degli IDE possono caricare una chiave obsoleta da un file `.env` nel tuo progetto senza che tu l'abbia impostata esplicitamente.
946* Annullate l'impostazione di `ANTHROPIC_API_KEY` ed eseguite `/login` per utilizzare invece l'autenticazione dell'abbonamento952* Rimuovi l'impostazione di `ANTHROPIC_API_KEY` ed esegui `/login` per usare invece l'autenticazione tramite abbonamento
947* Se la chiave proviene da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper), eseguite lo script direttamente per confermare che stampi una chiave valida su stdout953* Se la chiave proviene da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper), esegui direttamente lo script per verificare che stampi una chiave valida su stdout
948* Eseguite `/status` per confermare quale fonte di credenziale Claude Code sta effettivamente utilizzando954* Esegui `/status` per verificare quale origine delle credenziali sta effettivamente usando Claude Code
949 955
950<h3 id="your-apikeyhelper-script-is-failing">956<h3 id="your-apikeyhelper-script-is-failing">
951 Lo script apiKeyHelper non funziona957 Il tuo script apiKeyHelper non funziona
952</h3>958</h3>
953 959
954Claude Code ha eseguito il comando nella Vostra impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) e non ha ottenuto una chiave indietro. Senza una, la richiesta raggiunge l'API con una credenziale segnaposto e l'API la rifiuta con `401`. Il pannello `Authentication` nel terminale mostra quale di questi è accaduto:960Claude Code ha eseguito il comando nella tua impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) e non ha ricevuto una chiave. Senza di essa, la richiesta raggiunge l'API con una credenziale segnaposto e l'API la rifiuta con `401`. Il pannello `Authentication` nel terminale mostra quale di questi casi si è verificato:
955 961
956* Il comando è uscito con un errore o è scaduto962* Il comando è terminato con un errore o è andato in timeout
957* Il comando non ha stampato nulla su stdout963* Il comando non ha stampato nulla su stdout
958* Il comando ha stampato qualcosa di diverso dalla chiave, come un banner di login o una riga di log. Il pannello mostra `returned output that cannot be used as an API key` e dice cosa c'è di sbagliato, senza ripetere l'output. Prima della v2.1.227, Claude Code inviava tutto ciò che il comando stampava, dopo aver tagliato gli spazi bianchi circostanti.964* Il comando ha stampato qualcosa oltre alla chiave, come un banner di accesso o una riga di log. Il pannello mostra `returned output that cannot be used as an API key` e indica cosa non va, senza ripetere l'output. Prima della v2.1.227, Claude Code inviava qualunque cosa il comando stampasse, dopo aver rimosso gli spazi circostanti.
959 965
960```text theme={null}966```text theme={null}
961Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output967Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
962```968```
963 969
964In [modalità non interattiva](/docs/it/headless), stderr trasporta anche il motivo specifico, con il prefisso `apiKeyHelper failed:`.970In [modalità non interattiva](/docs/it/headless), anche stderr riporta il motivo specifico, preceduto da `apiKeyHelper failed:`.
965 971
966Claude Code riesegue lo script e ritenta la richiesta fino a due volte in più prima di mostrare questo messaggio, quindi l'errore emerge entro tre tentativi. Prima della v2.1.208, Claude Code spendeva l'intero [budget di ripetizione](#automatic-retries) reinviando la richiesta con la credenziale segnaposto e poi segnalava un errore di autenticazione generico `401` invece dell'errore dello script.972Claude Code esegue di nuovo lo script e riprova la richiesta fino ad altre due volte prima di mostrare questo messaggio, quindi l'errore emerge entro tre tentativi. Prima della v2.1.208, Claude Code esauriva l'intero [budget di nuovi tentativi](#automatic-retries) reinviando la richiesta con la credenziale segnaposto e poi segnalava un generico errore di autenticazione `401` invece dell'errore dello script.
967 973
968L'esecuzione di `/login` non aiuta qui: l'output dell'helper [ha la precedenza](/docs/it/authentication#authentication-precedence) su un login salvato finché l'impostazione è presente.974Eseguire `/login` non aiuta in questo caso: l'output dell'helper [ha la precedenza](/docs/it/authentication#authentication-precedence) su un accesso salvato finché l'impostazione è presente.
969 975
970**Cosa fare:**976**Cosa fare:**
971 977
972* Eseguite il comando configurato in `apiKeyHelper` direttamente nella Vostra shell per riprodurre l'errore978* Esegui direttamente nella tua shell il comando configurato in `apiKeyHelper` per riprodurre l'errore
973* Se il comando segnala una sessione scaduta, riauthenticate con il Vostro provider di credenziali, ad esempio accedendo di nuovo al Vostro SSO o vault di segreti979* Se il comando segnala una sessione scaduta, autenticati di nuovo con il tuo provider di credenziali, ad esempio accedendo di nuovo al tuo SSO o al tuo vault dei segreti
974* Correggete il comando in modo che stampi solo la chiave su stdout, come un singolo token di ASCII stampabile fino a 16.384 caratteri, e uscite con codice 0. Vedete [ruotare le credenziali con apiKeyHelper](/docs/it/llm-gateway-connect#rotate-credentials-with-apikeyhelper) per una configurazione funzionante.980* Correggi il comando in modo che stampi su stdout solo la chiave, come un singolo token di ASCII stampabile fino a 16.384 caratteri, e termini con codice 0. Consulta [ruotare le credenziali con apiKeyHelper](/docs/it/llm-gateway-connect#rotate-credentials-with-apikeyhelper) per una configurazione funzionante.
975* Eseguite `/status` per vedere l'errore e confermare che `apiKeyHelper` sia la fonte di credenziale attiva. La riga `apiKeyHelper` mostra `Failing` con il dettaglio dell'ultimo errore, come il codice di uscita e l'output di errore del comando, e scompare dopo il prossimo esecuzione riuscita. Prima della v2.1.274, `/status` mostrava solo la fonte di credenziale, non l'errore.981* Esegui `/status` per vedere l'errore e verificare che `apiKeyHelper` sia l'origine delle credenziali attiva. La riga `apiKeyHelper` mostra `Failing` con i dettagli dell'ultimo errore, come il codice di uscita e l'output di errore del comando, e scompare dopo la successiva esecuzione riuscita. Prima della v2.1.274, `/status` mostrava solo l'origine delle credenziali, non l'errore.
976* Ogni volta che il comando fallisce, il suo codice di uscita e l'output di errore appaiono anche in un pannello `Authentication` nel terminale. Prima della v2.1.212, il pannello era intitolato `Cloud authentication`.982* Ogni volta che il comando fallisce, il suo codice di uscita e l'output di errore appaiono anche in un pannello `Authentication` nel terminale. Prima della v2.1.212, il pannello si chiamava `Cloud authentication`.
977 983
978<h3 id="invalid-request-header-value">984<h3 id="invalid-request-header-value">
979 Valore di intestazione di richiesta non valido985 Valore dell'intestazione della richiesta non valido
980</h3>986</h3>
981 987
982Un valore che Claude Code stava per inviare come intestazione di richiesta contiene un carattere che le intestazioni HTTP non possono trasportare: un'interruzione di riga, un byte NUL o un carattere sopra `U+00FF`, come una virgoletta ricurva o uno spazio di larghezza zero. Claude Code ferma la richiesta prima che qualsiasi cosa sia inviata e nomina la variabile o l'impostazione da correggere. La causa usuale è una credenziale incollata da un documento o chat che trasportava un carattere invisibile o un'interruzione di riga errata.988Un valore che Claude Code stava per inviare come intestazione di una richiesta contiene un carattere che le intestazioni HTTP non possono trasportare: un'interruzione di riga, un byte NUL o un carattere oltre `U+00FF`, come una virgoletta curva o uno spazio a larghezza zero. Claude Code ferma la richiesta prima che venga inviato qualsiasi cosa e indica la variabile o l'impostazione da correggere. La causa tipica è una credenziale incollata da un documento o da una chat che conteneva un carattere invisibile o un'interruzione di riga accidentale.
983 989
984Claude Code esegue questo controllo quando invia richieste all'API Claude direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway). Su un provider cloud di terze parti come [Amazon Bedrock](/docs/it/amazon-bedrock), Claude Code non lo esegue prima di inviare.990Claude Code esegue questo controllo quando invia richieste all'API Claude direttamente o tramite un [gateway LLM](/docs/it/llm-gateway). Su un provider cloud di terze parti come [Amazon Bedrock](/docs/it/amazon-bedrock), Claude Code non lo esegue prima dell'invio.
985 991
986```text theme={null}992```text theme={null}
987Invalid auth token · Fix external auth token993Invalid auth token · Fix external auth token
989Invalid request header from the environment · Fix the environment variable995Invalid request header from the environment · Fix the environment variable
990```996```
991 997
992La prima parte del messaggio dipende da dove proviene il valore errato:998La prima parte del messaggio dipende dalla provenienza del valore errato:
993 999
994* `Invalid auth token`: un token bearer da [`ANTHROPIC_AUTH_TOKEN`](/docs/it/env-vars) o [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars)1000* `Invalid auth token`: un bearer token da [`ANTHROPIC_AUTH_TOKEN`](/docs/it/env-vars) o [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars)
995* `Invalid ANTHROPIC_CUSTOM_HEADERS`: un nome o valore di intestazione che avete impostato in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/it/env-vars). La descrizione conta quale coppia `Name: Value` è in colpa, come `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, senza ripetere il nome o il valore, poiché li avete scelti entrambi.1001* `Invalid ANTHROPIC_CUSTOM_HEADERS`: un nome o un valore di intestazione che hai impostato in [`ANTHROPIC_CUSTOM_HEADERS`](/docs/it/env-vars). La descrizione indica con un numero quale coppia `Name: Value` è responsabile, ad esempio `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, senza ripetere il nome o il valore, dato che li hai scelti entrambi tu.
996* `Invalid request header from the environment`: un valore che Claude Code copia in un'intestazione di richiesta da un'altra variabile d'ambiente, come `CLAUDE_AGENT_SDK_CLIENT_APP`. La descrizione nomina la variabile da correggere.1002* `Invalid request header from the environment`: un valore che Claude Code copia in un'intestazione della richiesta da un'altra variabile d'ambiente, come `CLAUDE_AGENT_SDK_CLIENT_APP`. La descrizione indica la variabile da correggere.
997 1003
998Claude Code segnala un `ANTHROPIC_API_KEY` errato catturato da questo controllo come [Chiave API non valida](#invalid-api-key), con la stessa descrizione finale. Segnala una credenziale `/login` salvata errata come [Non connesso](#not-logged-in) invece; eseguite `/login` per salvarne una nuova. L'output di uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non raggiunge mai questo controllo: Claude Code lo convalida quando lo script viene eseguito e l'output che un'intestazione HTTP non può trasportare fallisce con [Lo script apiKeyHelper non funziona](#your-apikeyhelper-script-is-failing).1004Claude Code segnala una `ANTHROPIC_API_KEY` errata intercettata da questo controllo come [Chiave API non valida](#invalid-api-key), con la stessa descrizione finale. Segnala invece una credenziale `/login` salvata errata come [Non hai effettuato l'accesso](#not-logged-in); esegui `/login` per salvarne una nuova. L'output di uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) non raggiunge mai questo controllo: Claude Code lo convalida quando lo script viene eseguito, e un output che un'intestazione HTTP non può trasportare fallisce con [Il tuo script apiKeyHelper non funziona](#your-apikeyhelper-script-is-failing).
999 1005
1000Dopo il secondo `·`, il messaggio descrive il problema, come in questo esempio completo:1006Dopo il secondo `·`, il messaggio descrive il problema, come in questo esempio completo:
1001 1007
1003Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).1009Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
1004```1010```
1005 1011
1006Le posizioni contano i caratteri a partire da uno. La descrizione è costruita da frasi fisse e conteggi di caratteri, quindi non include mai il valore stesso. Nomina il carattere offensivo solo quando è un carattere invisibile o tipografico ben noto, come un byte order mark, uno spazio di larghezza zero o una virgoletta ricurva, e segnala tutto il resto come `a non-ASCII character`.1012Le posizioni contano i caratteri a partire da uno. La descrizione è costruita con frasi fisse e conteggi di caratteri, quindi non include mai il valore stesso. Nomina il carattere problematico solo quando si tratta di un carattere invisibile o tipografico ben noto, come un byte-order mark, uno spazio a larghezza zero o una virgoletta curva, e segnala qualsiasi altro carattere come `a non-ASCII character`.
1007 1013
1008**Cosa fare:**1014**Cosa fare:**
1009 1015
1010* Reimpostate la variabile o l'impostazione che il messaggio nomina, riscrivendo i caratteri intorno alla posizione segnalata piuttosto che incollando dalla stessa fonte di nuovo1016* Imposta di nuovo la variabile o l'impostazione indicata dal messaggio, ridigitando i caratteri intorno alla posizione segnalata anziché incollarli di nuovo dalla stessa origine
1011* Per `ANTHROPIC_CUSTOM_HEADERS`, mantenete una coppia `Name: Value` per riga e riscritte la coppia che il messaggio conta1017* Per `ANTHROPIC_CUSTOM_HEADERS`, mantieni una coppia `Name: Value` per riga e riscrivi la coppia indicata dal messaggio
1012* Eseguite `/status` per confermare quale fonte di credenziale è attiva1018* Esegui `/status` per verificare quale origine delle credenziali è attiva
1013 1019
1014<h3 id="this-organization-has-been-disabled">1020<h3 id="this-organization-has-been-disabled">
1015 Questa organizzazione è stata disabilitata1021 Questa organizzazione è stata disabilitata
1016</h3>1022</h3>
1017 1023
1018Claude Code sta utilizzando un `ANTHROPIC_API_KEY` obsoleto da un'organizzazione Console disabilitata. Quando avete un login di abbonamento salvato, la chiave lo sostituisce.1024Claude Code sta usando una `ANTHROPIC_API_KEY` obsoleta proveniente da un'organizzazione Console disabilitata. Quando hai un accesso con abbonamento salvato, la chiave ha la precedenza su di esso.
1019 1025
1020```text theme={null}1026```text theme={null}
1021Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1027Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
1023API Error: 400 ... This organization has been disabled.1029API Error: 400 ... This organization has been disabled.
1024```1030```
1025 1031
1026Il suggerimento dopo il `·` dipende dalle Vostre credenziali salvate: la prima forma appare quando un `/login` memorizzato può subentrare dopo aver annullato l'impostazione della chiave, e la seconda quando la chiave è la Vostra unica credenziale.1032Il suggerimento dopo il `·` dipende dalle tue credenziali salvate: la prima forma appare quando un `/login` memorizzato può subentrare dopo che hai rimosso la chiave, la seconda quando la chiave è la tua unica credenziale.
1027 1033
1028Le variabili d'ambiente hanno la precedenza su `/login`, quindi una chiave esportata nel Vostro profilo shell o caricata da un file `.env` è utilizzata anche quando avete un abbonamento Pro o Max funzionante. In modalità non interattiva (`-p`), la chiave è sempre utilizzata quando presente.1034Le variabili d'ambiente hanno la precedenza su `/login`, quindi una chiave esportata nel profilo della tua shell o caricata da un file `.env` viene usata anche quando hai un abbonamento Pro o Max funzionante. In modalità non interattiva (`-p`), la chiave viene sempre usata quando è presente.
1029 1035
1030**Cosa fare:**1036**Cosa fare:**
1031 1037
1032* Annullate l'impostazione di `ANTHROPIC_API_KEY` nella shell corrente e rimuovetela dal Vostro profilo shell, quindi riavviate `claude`1038* Rimuovi `ANTHROPIC_API_KEY` nella shell corrente e dal profilo della tua shell, poi riavvia `claude`
1033* Se il messaggio dice `Update or unset`, non avete un login salvato su cui ricadere. Annullate l'impostazione della chiave ed eseguite `/login`, oppure sostituite la chiave con una da un'organizzazione Console attiva.1039* Se il messaggio dice `Update or unset`, non hai un accesso salvato su cui ripiegare. Rimuovi la chiave ed esegui `/login`, oppure sostituisci la chiave con una di un'organizzazione Console attiva.
1034* Eseguite `/status` in seguito per confermare che la credenziale attiva sia il Vostro abbonamento1040* Esegui poi `/status` per verificare che la credenziale attiva sia il tuo abbonamento
1035* Se nessuna variabile d'ambiente è impostata e l'errore persiste, contattate il supporto o accedete con un account diverso.1041* Se nessuna variabile d'ambiente è impostata e l'errore persiste, contatta l'assistenza o accedi con un account diverso.
1036 1042
1037<h3 id="your-organization-has-disabled-api-key-authentication">1043<h3 id="your-organization-has-disabled-api-key-authentication">
1038 La Vostra organizzazione ha disabilitato l'autenticazione con chiave API1044 La tua organizzazione ha disabilitato l'autenticazione con chiave API
1039</h3>1045</h3>
1040 1046
1041Questo messaggio richiede Claude Code v2.1.169 o successiva. L'amministratore dell'organizzazione Console ha disattivato l'autenticazione con chiave API, quindi l'API rifiuta la chiave che Claude Code sta inviando. Il suggerimento di recupero dopo il `·` varia a seconda di dove proviene la chiave:1047Questo messaggio richiede Claude Code v2.1.169 o successiva. L'amministratore della tua organizzazione Console ha disattivato l'autenticazione con chiave API, quindi l'API rifiuta la chiave che Claude Code sta inviando. Il suggerimento di ripristino dopo il `·` varia a seconda della provenienza della chiave:
1042 1048
1043```text theme={null}1049```text theme={null}
1044Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1050Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
1048Your organization has disabled API key authentication · Sign in again with your claude.ai account1054Your organization has disabled API key authentication · Sign in again with your claude.ai account
1049```1055```
1050 1056
1051L'ultima forma appare in una sessione che l'app Claude Desktop esegue, come la scheda Code o Cowork, dove vi accedete di nuovo dall'app.1057L'ultima forma appare in una sessione eseguita dall'app Claude Desktop, come la scheda Code o Cowork, dove devi accedere di nuovo dall'app.
1052 1058
1053Le variabili d'ambiente e `apiKeyHelper` hanno la precedenza su `/login`, quindi eseguire `/login` da solo non aiuta mentre uno dei due sta ancora fornendo una chiave. Vedete [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence).1059Le variabili d'ambiente e `apiKeyHelper` hanno la precedenza su `/login`, quindi eseguire solo `/login` non aiuta finché una delle due fornisce ancora una chiave. Consulta [Precedenza di autenticazione](/docs/it/authentication#authentication-precedence).
1054 1060
1055**Cosa fare:**1061**Cosa fare:**
1056 1062
1057* 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`1063* Se il messaggio nomina `ANTHROPIC_API_KEY`, rimuovila nella shell corrente e dal profilo della tua shell o dal file `.env`, poi riavvia `claude`
1058* Se il messaggio nomina `apiKeyHelper`, rimuovete l'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) dal Vostro `settings.json`1064* Se il messaggio nomina `apiKeyHelper`, rimuovi l'impostazione [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) dal tuo `settings.json`
1059* Eseguite `/login` per accedere con il Vostro account claude.ai1065* Esegui `/login` per accedere con il tuo account claude.ai
1060* Eseguite `/status` in seguito per confermare che la credenziale attiva sia il Vostro abbonamento piuttosto che una chiave API1066* Esegui poi `/status` per verificare che la credenziale attiva sia il tuo abbonamento e non una chiave API
1061* Se avete bisogno dell'autenticazione con chiave API per l'automazione, chiedete all'amministratore dell'organizzazione di riattivarla nella Console1067* Se ti serve l'autenticazione con chiave API per le automazioni, chiedi all'amministratore della tua organizzazione di riabilitarla nella Console
1062 1068
1063<h3 id="your-organization-has-disabled-claude-subscription-access">1069<h3 id="your-organization-has-disabled-claude-subscription-access">
1064 La Vostra organizzazione ha disabilitato l'accesso all'abbonamento Claude1070 La tua organizzazione ha disabilitato l'accesso tramite abbonamento Claude
1065</h3>1071</h3>
1066 1072
1067La Vostra organizzazione Claude non consente l'accesso a Claude Code con un login di abbonamento. L'esecuzione di `/login` di nuovo con lo stesso account restituisce lo stesso errore.1073La tua organizzazione Claude non consente di accedere a Claude Code con un accesso tramite abbonamento. Eseguire di nuovo `/login` con lo stesso account restituisce lo stesso errore.
1068 1074
1069```text theme={null}1075```text theme={null}
1070Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1076Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1071```1077```
1072 1078
1073Questa è un'impostazione dell'organizzazione lato server, quindi non può essere ignorata dalle impostazioni locali, dalle variabili d'ambiente o dai flag CLI.1079Si tratta di un'impostazione dell'organizzazione lato server, quindi non può essere sovrascritta da impostazioni locali, variabili d'ambiente o flag della CLI.
1074 1080
1075Agent SDK e la modalità non interattiva `-p` presentano questo come il codice di errore `oauth_org_not_allowed`.1081L'Agent SDK e la modalità non interattiva `-p` lo segnalano con il codice di errore `oauth_org_not_allowed`.
1076 1082
1077**Cosa fare:**1083**Cosa fare:**
1078 1084
1079* Chiedete al Vostro amministratore di abilitare l'accesso a Claude Code per la Vostra organizzazione1085* Chiedi al tuo amministratore di abilitare l'accesso a Claude Code per la tua organizzazione
1080* Autenticate con una chiave API Console invece del Vostro abbonamento. Vedete [Autenticazione Claude Console](/docs/it/authentication#claude-console-authentication) per la configurazione.1086* Autenticati con una chiave API della Console invece che con il tuo abbonamento. Consulta [Autenticazione con Claude Console](/docs/it/authentication#claude-console-authentication) per la configurazione.
1081* Se siete l'amministratore e non vedete un'opzione per abilitare l'accesso, contattate il [supporto Anthropic](https://support.claude.com)1087* Se sei l'amministratore e non vedi un'opzione per abilitare l'accesso, contatta l'[assistenza Anthropic](https://support.claude.com)
1082 1088
1083<h3 id="routines-are-disabled-by-your-organizations-policy">1089<h3 id="routines-are-disabled-by-your-organizations-policy">
1084 Le routine sono disabilitate dalla politica dell'organizzazione1090 Le routine sono disabilitate dai criteri della tua organizzazione
1085</h3>1091</h3>
1086 1092
1087Un Proprietario 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, ad esempio dall'interfaccia utente [Routine](/docs/it/routines) su claude.ai/code. Su Claude Code v2.1.227 o successiva, la stessa impostazione [nasconde anche `/schedule`](/docs/it/routines#troubleshooting) nella CLI.1093Un Owner della tua organizzazione Team o Enterprise ha disattivato le routine a livello di organizzazione. L'errore appare quando provi a creare o eseguire una routine, ad esempio dall'interfaccia [Routine](/docs/it/routines) su claude.ai/code. In Claude Code v2.1.227 o successiva, la stessa impostazione [nasconde anche `/schedule`](/docs/it/routines#troubleshooting) nella CLI.
1088 1094
1089```text theme={null}1095```text theme={null}
1090Routines are disabled by your organization's policy.1096Routines are disabled by your organization's policy.
1091```1097```
1092 1098
1093Questa è un'impostazione lato server, quindi non può essere ignorata dalle impostazioni locali, dalle variabili d'ambiente o dai flag CLI.1099Si tratta di un'impostazione lato server, quindi non può essere sovrascritta da impostazioni locali, variabili d'ambiente o flag della CLI.
1094 1100
1095**Cosa fare:**1101**Cosa fare:**
1096 1102
1097* Chiedete a un Proprietario nella Vostra organizzazione di abilitare l'interruttore **Routines** su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)1103* Chiedi a un Owner della tua organizzazione di attivare l'interruttore **Routines** su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
1098* Per lavoro programmato una tantum che non richiede routine a livello di organizzazione, vedete [attività programmate](/docs/it/scheduled-tasks)1104* Per lavori pianificati occasionali che non richiedono routine a livello di organizzazione, consulta [attività pianificate](/docs/it/scheduled-tasks)
1099 1105
1100<h3 id="remote-control-requires-the-anthropic-api">1106<h3 id="remote-control-requires-the-anthropic-api">
1101 Remote Control richiede l'API Anthropic1107 Remote Control richiede l'API Anthropic
1102</h3>1108</h3>
1103 1109
1104La sessione non sta parlando direttamente all'API Anthropic, che [Remote Control](/docs/it/remote-control) richiede.1110La sessione non comunica direttamente con l'API Anthropic, come richiesto da [Remote Control](/docs/it/remote-control).
1105 1111
1106```text theme={null}1112```text theme={null}
1107Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1113Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
1108```1114```
1109 1115
1110Una seconda frase spiega cosa ha instradato la sessione lontano dall'API Anthropic; prima della v2.1.219, il messaggio era solo la prima frase. A seconda della causa, il messaggio nomina:1116Una seconda frase spiega cosa ha instradato la sessione lontano dall'API Anthropic; prima della v2.1.219, il messaggio era composto solo dalla prima frase. A seconda della causa, il messaggio nomina:
1111 1117
1112* Una variabile del provider `CLAUDE_CODE_USE_*`, come `CLAUDE_CODE_USE_BEDROCK` per [Amazon Bedrock](/docs/it/amazon-bedrock) o `CLAUDE_CODE_USE_VERTEX` per [Agent Platform di Google Cloud](/docs/it/google-vertex-ai)1118* Una variabile di provider `CLAUDE_CODE_USE_*`, come `CLAUDE_CODE_USE_BEDROCK` per [Amazon Bedrock](/docs/it/amazon-bedrock) o `CLAUDE_CODE_USE_VERTEX` per [Agent Platform di Google Cloud](/docs/it/google-vertex-ai)
1113* [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) che 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; prima della v2.1.196, un URL di base personalizzato non bloccava Remote Control1119* [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) che punta a un host diverso da `api.anthropic.com`, come un [gateway LLM](/docs/it/llm-gateway) o un proxy, anche quando accedi con claude.ai; prima della v2.1.196, un URL di base personalizzato non bloccava Remote Control
1114* `ANTHROPIC_UNIX_SOCKET` impostato, quindi la sessione invia le sue richieste attraverso un socket locale piuttosto che a `api.anthropic.com`1120* `ANTHROPIC_UNIX_SOCKET` impostata, per cui la sessione invia le sue richieste tramite un socket locale anziché a `api.anthropic.com`
1115* Un accesso [gateway cloud](/docs/it/claude-apps-gateway) aziendale effettuato tramite `/login`, che non supporta Remote Control e non ha alcuna variabile da annullare1121* Un accesso a un [gateway cloud](/docs/it/claude-apps-gateway) aziendale effettuato tramite `/login`, che non supporta Remote Control e non ha alcuna variabile da rimuovere
1116 1122
1117**Cosa fare:**1123**Cosa fare:**
1118 1124
1119* Annullate l'impostazione della variabile che il messaggio nomina, come `CLAUDE_CODE_USE_BEDROCK` o `ANTHROPIC_BASE_URL`, e riavviate la sessione, oppure avviate Remote Control da una sessione che parla direttamente all'API Anthropic1125* Rimuovi la variabile indicata dal messaggio, come `CLAUDE_CODE_USE_BEDROCK` o `ANTHROPIC_BASE_URL`, e riavvia la sessione, oppure avvia Remote Control da una sessione che comunica direttamente con l'API Anthropic
1120* Se la variabile non è impostata nella Vostra shell, controllate la chiave `env` nei Vostri [file di impostazioni](/docs/it/settings#where-settings-live), che applica le variabili d'ambiente a ogni sessione1126* Se la variabile non è impostata nella tua shell, controlla la chiave `env` nei tuoi [file di impostazioni](/docs/it/settings#where-settings-live), che applica variabili d'ambiente a ogni sessione
1121* Per questo e gli altri messaggi di avvio di Remote Control, vedete [Risolvere i problemi di Remote Control](/docs/it/remote-control#troubleshooting)1127* Per questo e per gli altri messaggi di avvio di Remote Control, consulta [Risoluzione dei problemi di Remote Control](/docs/it/remote-control#troubleshooting)
1122 1128
1123<h3 id="remote-control-couldnt-refresh-your-login">1129<h3 id="remote-control-couldnt-refresh-your-login">
1124 Remote Control non ha potuto aggiornare il Vostro login1130 Remote Control non è riuscito ad aggiornare il tuo accesso
1125</h3>1131</h3>
1126 1132
1127Claude Code esegue una connessione [Remote Control](/docs/it/remote-control) dal vivo su credenziali di breve durata che ottiene e rinnova utilizzando il Vostro login claude.ai salvato. Quando claude.ai smette di accettare quel login, o Claude Code non ha più alcun login salvato, Claude Code ferma Remote Control e ha bisogno che vi accediate di nuovo. Uno qualsiasi dei due errori può accadere mentre Claude Code sta ancora connettendosi o più tardi, quando rinnova le credenziali.1133Claude Code mantiene una connessione [Remote Control](/docs/it/remote-control) attiva con credenziali a breve durata che ottiene e rinnova usando il tuo accesso claude.ai salvato. Quando claude.ai smette di accettare quell'accesso, o Claude Code non ha più alcun accesso salvato, Claude Code interrompe Remote Control e ti chiede di accedere di nuovo. Entrambi gli errori possono verificarsi mentre Claude Code si sta ancora connettendo oppure più tardi, quando rinnova le credenziali.
1128 1134
1129Quando Claude Code chiede al servizio di login di aggiornare il Vostro login salvato e non riceve risposta, mantiene Remote Control in esecuzione e ritenta l'aggiornamento mentre la credenziale corrente della connessione è ancora valida. Un aggiornamento non riceve risposta quando Claude Code non può raggiungere il servizio di login, la richiesta scade o il servizio fallisce senza rifiutare il Vostro login. Se il servizio di login non sta ancora rispondendo quando quella credenziale scade, Claude Code ferma Remote Control e segnala `OAuth token refresh failed`.1135Quando Claude Code chiede al servizio di accesso di aggiornare il tuo accesso salvato e non riceve risposta, mantiene Remote Control in esecuzione e riprova l'aggiornamento finché la credenziale corrente della connessione è ancora valida. Un aggiornamento non riceve risposta quando Claude Code non riesce a raggiungere il servizio di accesso, la richiesta va in timeout o il servizio fallisce senza rifiutare il tuo accesso. Se il servizio di accesso continua a non rispondere quando quella credenziale scade, Claude Code interrompe Remote Control e segnala `OAuth token refresh failed`.
1130 1136
1131Quando Claude Code ferma Remote Control, mostra il motivo in un avviso e in una riga di trascrizione che inizia con `Remote Control disconnected`. La Vostra sessione locale continua a funzionare senza Remote Control. Questa sezione copre queste righe:1137Quando Claude Code interrompe Remote Control, mostra il motivo in un avviso e in una riga della trascrizione che inizia con `Remote Control disconnected`. La tua sessione locale continua a funzionare senza Remote Control. Questa sezione tratta queste righe:
1132 1138
1133```text theme={null}1139```text theme={null}
1134Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1140Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1140Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1146Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1141```1147```
1142 1148
1143Claude Code nomina la causa nel mezzo del messaggio:1149Claude Code indica la causa nella parte centrale del messaggio:
1144 1150
1145* `Claude.ai login expired` e `Claude.ai login was rejected`: claude.ai non accetta più il Vostro token di login salvato, perché è scaduto o è stato revocato1151* `Claude.ai login expired` e `Claude.ai login was rejected`: claude.ai non accetta più il token di accesso salvato, perché è scaduto o è stato revocato
1146* `OAuth token unavailable`: Claude Code non aveva alcun token di login salvato quando la credenziale della connessione è scaduta per il rinnovo1152* `OAuth token unavailable`: Claude Code non aveva alcun token di accesso salvato quando la credenziale della connessione doveva essere rinnovata
1147* `OAuth token refresh failed`: claude.ai ha rifiutato il Vostro token di login salvato mentre Claude Code stava riconnettendosi e l'aggiornamento del token non ha prodotto uno nuovo1153* `OAuth token refresh failed`: claude.ai ha rifiutato il tuo token di accesso salvato mentre Claude Code si stava riconnettendo, e l'aggiornamento del token non ne ha prodotto uno nuovo
1148* `JWT refresh failed: no OAuth token`: Claude Code non ha trovato alcun token di login salvato per rinnovare1154* `JWT refresh failed: no OAuth token`: Claude Code non ha trovato alcun token di accesso salvato con cui effettuare il rinnovo
1149* `Signed out of Claude`: vi siete disconnessi su questa macchina, ad esempio eseguendo `/logout` in un altro terminale, quindi Claude Code non ha alcun login salvato rimasto per rinnovare la connessione1155* `Signed out of Claude`: sei uscito su questa macchina, ad esempio eseguendo `/logout` in un altro terminale, quindi Claude Code non ha più alcun accesso salvato con cui rinnovare la connessione
1150 1156
1151**Cosa fare:**1157**Cosa fare:**
1152 1158
1153* Eseguite `/login` per accedere di nuovo1159* Esegui `/login` per accedere di nuovo
1154* Eseguite `/remote-control` per riconnettere la sessione. I messaggi che terminano con `run /login to restore Remote Control` non hanno bisogno di questo passaggio: Claude Code si riconnette automaticamente una volta che vi siete acceduti.1160* Esegui `/remote-control` per riconnettere la sessione. I messaggi che terminano con `run /login to restore Remote Control` non richiedono questo passaggio: Claude Code si riconnette da solo una volta che hai effettuato l'accesso.
1155 1161
1156Prima della v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` leggeva `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` leggeva `no OAuth token available for recovery (code <N>)`. I messaggi `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` sono stati aggiunti nella v2.1.225.1162Prima della v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` era `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, e `JWT refresh failed: no OAuth token — run /login` era `no OAuth token available for recovery (code <N>)`. I messaggi `Claude.ai login expired`, `Claude.ai login was rejected` e `OAuth token unavailable` sono stati aggiunti nella v2.1.225.
1157 1163
1158Prima della v2.1.238, Claude Code segnalava i casi che ora dicono `Signed out of Claude` come `JWT refresh failed: no OAuth token — run /login`, e fermava Remote Control con `Claude.ai login expired — run /login to restore Remote Control` non appena un aggiornamento di login non riceveva risposta.1164Prima della v2.1.238, Claude Code segnalava i casi che ora indicano `Signed out of Claude` come `JWT refresh failed: no OAuth token — run /login`, e interrompeva Remote Control con `Claude.ai login expired — run /login to restore Remote Control` non appena un aggiornamento dell'accesso non riceveva risposta.
1159 1165
1160<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1166<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1161 Remote Control si è fermato perché l'account connesso è cambiato1167 Remote Control interrotto perché l'account con cui hai effettuato l'accesso è cambiato
1162</h3>1168</h3>
1163 1169
1164Claude Code mostra questa riga durante una sessione [Remote Control](/docs/it/remote-control) quando vi accedete a un account claude.ai diverso o a un'organizzazione diversa su questa macchina. Avete effettuato il cambio al di fuori della sessione Claude Code, ad esempio eseguendo `/login` in un altro terminale.1170Claude Code mostra questa riga durante una sessione [Remote Control](/docs/it/remote-control) quando accedi a un account o a un'organizzazione claude.ai diversi su questa macchina. Hai effettuato il cambio al di fuori della sessione di Claude Code, ad esempio eseguendo `/login` in un altro terminale.
1165 1171
1166Una sessione Remote Control che avete avviato mentre eravate connessi tramite `/login` appartiene all'account claude.ai e all'organizzazione che erano connessi al momento.1172Una sessione Remote Control avviata mentre eri connesso tramite `/login` appartiene all'account e all'organizzazione claude.ai con cui avevi effettuato l'accesso in quel momento.
1167 1173
1168```text theme={null}1174```text theme={null}
1169Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1175Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
1170```1176```
1171 1177
1172Claude Code ferma la sessione Remote Control non appena claude.ai conferma che l'account o l'organizzazione è cambiato. La Vostra sessione locale continua a funzionare senza Remote Control.1178Claude Code interrompe la sessione Remote Control non appena claude.ai conferma che l'account o l'organizzazione sono cambiati. La tua sessione locale continua a funzionare senza Remote Control.
1173 1179
1174**Cosa fare:**1180**Cosa fare:**
1175 1181
1176* Eseguite `/remote-control` per avviare una nuova sessione Remote Control con l'account o l'organizzazione corrente1182* Esegui `/remote-control` per avviare una nuova sessione Remote Control con l'account o l'organizzazione corrente
1177* Per tornare indietro, eseguite `/login` e accedete di nuovo all'account o all'organizzazione precedente. Quindi eseguite `/remote-control`.1183* Per tornare indietro, esegui `/login` e accedi di nuovo all'account o all'organizzazione precedente. Poi esegui `/remote-control`.
1178 1184
1179Prima della v2.1.234, Claude Code non notava quando vi passavate a un account o un'organizzazione diversa al di fuori della sessione Claude Code. Claude Code manteneva la sessione Remote Control connessa fino a quando una richiesta successiva al server Remote Control non falliva con `Remote Control server rejected the request (HTTP 404)`. Quel fallimento potrebbe arrivare ore dopo il cambio.1185Prima della v2.1.234, Claude Code non si accorgeva del passaggio a un account o a un'organizzazione diversi al di fuori della sessione di Claude Code. Claude Code manteneva la sessione Remote Control connessa finché una richiesta successiva al server Remote Control non falliva con `Remote Control server rejected the request (HTTP 404)`. Quell'errore poteva arrivare ore dopo il cambio.
1180 1186
1181<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1187<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1182 Remote Control si è fermato perché l'app che esegue la sessione si è disconnessa o ha cambiato account1188 Remote Control interrotto perché l'app che esegue la sessione è uscita o ha cambiato account
1183</h3>1189</h3>
1184 1190
1185Quando l'app desktop Claude o un IDE ospita la Vostra sessione, Claude Code ottiene il Vostro token di login da quell'app piuttosto che da `/login`. Quando claude.ai rifiuta quel token, Claude Code chiede all'app uno nuovo. Se l'app risponde che è disconnessa, o che è ora connessa a un account Claude diverso, Claude Code termina la sessione [Remote Control](/docs/it/remote-control) e invia all'app una di queste righe:1191Quando l'app desktop di Claude o un IDE ospita la tua sessione, Claude Code ottiene il token di accesso da quell'app anziché da `/login`. Quando claude.ai rifiuta quel token, Claude Code ne chiede uno nuovo all'app. Se l'app risponde di essere uscita, o di aver ora effettuato l'accesso a un account Claude diverso, Claude Code termina la sessione [Remote Control](/docs/it/remote-control) e invia all'app una di queste righe:
1186 1192
1187```text theme={null}1193```text theme={null}
1188Remote Control stopped — the app running this session is now signed in to a different Claude account1194Remote Control stopped — the app running this session is now signed in to a different Claude account
1189Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on1195Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1190```1196```
1191 1197
1192La Vostra sessione locale continua a funzionare senza Remote Control.1198La tua sessione locale continua a funzionare senza Remote Control.
1193 1199
1194**Cosa fare:**1200**Cosa fare:**
1195 1201
1196* Se l'app è disconnessa, accedete di nuovo, quindi riattivate Remote Control nell'app1202* Se l'app è uscita, accedi di nuovo all'app, poi riattiva Remote Control nell'app
1197* Se l'app ha cambiato account, Claude Code non può continuare la sessione terminata con il nuovo account. Avviate una nuova sessione Remote Control con quell'account.1203* Se l'app ha cambiato account, Claude Code non può proseguire la sessione terminata con il nuovo account. Avvia una nuova sessione Remote Control con quell'account.
1198 1204
1199Prima della v2.1.238, Claude Code inviava all'app i messaggi `run /login` elencati sotto [Remote Control non ha potuto aggiornare il Vostro login](#remote-control-couldnt-refresh-your-login) in entrambi i casi.1205Prima della v2.1.238, in entrambi i casi Claude Code inviava all'app i messaggi `run /login` elencati in [Remote Control non è riuscito ad aggiornare il tuo accesso](#remote-control-couldnt-refresh-your-login).
1200 1206
1201<h3 id="oauth-token-revoked-or-expired">1207<h3 id="oauth-token-revoked-or-expired">
1202 Token OAuth revocato o scaduto1208 Token OAuth revocato o scaduto
1203</h3>1209</h3>
1204 1210
1205Il Vostro login salvato non è più valido. Un token revocato significa che vi siete disconnessi ovunque o un amministratore ha rimosso l'accesso; un token scaduto significa che l'aggiornamento automatico è fallito a metà sessione.1211Il tuo accesso salvato non è più valido. Un token revocato significa che sei uscito ovunque o che un amministratore ha rimosso l'accesso; un token scaduto significa che l'aggiornamento automatico non è riuscito durante la sessione.
1206 1212
1207Entrambi i messaggi segnalano un rifiuto che l'API ha restituito per una richiesta che Claude Code ha inviato. Quando il login salvato è già stato cancellato dopo un aggiornamento fallito, vedete [Login scaduto](#login-expired) invece. Se vi autenticate con un token di lunga durata in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars), vedete gli stessi messaggi quando quel token scade o viene revocato.1213Entrambi i messaggi riportano un rifiuto restituito dall'API per una richiesta inviata da Claude Code. Quando l'accesso salvato è già stato cancellato dopo un aggiornamento non riuscito, vedi invece [Accesso scaduto](#login-expired). Se ti autentichi con un token a lunga durata in [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars), vedi gli stessi messaggi quando quel token scade o viene revocato.
1208 1214
1209```text theme={null}1215```text theme={null}
1210OAuth token revoked · Please run /login1216OAuth token revoked · Please run /login
1213 1219
1214**Cosa fare:**1220**Cosa fare:**
1215 1221
1216* Eseguite `/login` per accedere di nuovo1222* Esegui `/login` per accedere di nuovo
1217* Se vi autenticate con la variabile d'ambiente `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code continua a inviare il valore che avete impostato dopo che una richiesta fallisce con un 401, piuttosto che passare al token di un login salvato. [`/status`](/docs/it/commands) mostra questa credenziale come una riga `Auth token` che legge `CLAUDE_CODE_OAUTH_TOKEN`. Generare un token fresco con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token) e riavviare con esso, oppure annullate l'impostazione della variabile ed eseguite `/login`. Prima della v2.1.225, Claude Code poteva sostituire il valore della variabile a metà sessione con il token di accesso di breve durata da un login salvato, e la sessione falliva di nuovo con errori 401 una volta che quel token scadeva.1223* Se ti autentichi con la variabile d'ambiente `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code continua a inviare il valore che hai impostato dopo che una richiesta fallisce con un 401, anziché passare al token di un accesso memorizzato. [`/status`](/docs/it/commands) mostra questa credenziale come una riga `Auth token` con il valore `CLAUDE_CODE_OAUTH_TOKEN`. Genera un nuovo token con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token) e riavvia con quello, oppure rimuovi la variabile ed esegui `/login`. Prima della v2.1.225, Claude Code poteva sostituire il valore della variabile durante la sessione con il token di accesso a breve durata di un accesso memorizzato, e la sessione falliva di nuovo con errori 401 quando quel token scadeva.
1218* Per i prompt ripetuti di accesso tra i lanci, vedete i controlli dell'orologio di sistema e i passaggi di recupero dell'archiviazione delle credenziali di macOS in [Risoluzione dei problemi](/docs/it/troubleshoot-install#not-logged-in-or-token-expired)1224* Se ti viene chiesto ripetutamente di accedere a ogni avvio, consulta i controlli dell'orologio di sistema e i passaggi di ripristino dell'archiviazione delle credenziali su macOS in [Risoluzione dei problemi](/docs/it/troubleshoot-install#not-logged-in-or-token-expired)
1219* Per altri errori inclusi `403 Forbidden` e problemi del browser OAuth, vedete [Login e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)1225* Per altri errori, inclusi `403 Forbidden` e i problemi del browser con OAuth, consulta [Accesso e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)
1220 1226
1221<h3 id="api-error-401-invalid-authentication-credentials">1227<h3 id="api-error-401-invalid-authentication-credentials">
1222 API Error: 401 Credenziali di autenticazione non valide1228 API Error: 401 Invalid authentication credentials
1223</h3>1229</h3>
1224 1230
1225L'API ha riconosciuto il formato della Vostra credenziale ma ha rifiutato l'account o l'organizzazione dietro di essa. Anthropic restituisce questo messaggio quando una credenziale è stata revocata di recente, quando un'organizzazione è stata disabilitata o ha rimosso il Vostro accesso, o quando l'account stesso è stato disattivato, quindi un token scaduto non è la causa. La credenziale può essere il Vostro login salvato o un `ANTHROPIC_API_KEY` approvato, e la correzione differisce, quindi iniziate eseguendo `/status` per vedere quale è attivo.1231L'API ha riconosciuto il formato della tua credenziale ma ha rifiutato l'account o l'organizzazione a cui appartiene. Anthropic restituisce questo messaggio quando una credenziale è stata revocata di recente, quando un'organizzazione è stata disabilitata o ha rimosso il tuo accesso, o quando l'account stesso è stato disattivato, quindi la causa non è un token scaduto. La credenziale può essere il tuo accesso salvato o una `ANTHROPIC_API_KEY` approvata, e la soluzione è diversa, quindi inizia eseguendo `/status` per vedere quale delle due è attiva.
1226 1232
1227```text theme={null}1233```text theme={null}
1228Please run /login · API Error: 401 Invalid authentication credentials1234Please run /login · API Error: 401 Invalid authentication credentials
1230 1236
1231**Cosa fare:**1237**Cosa fare:**
1232 1238
1233* Se `/status` mostra una riga `API key` che non è contrassegnata come non in uso, un [`ANTHROPIC_API_KEY`](/docs/it/authentication#authentication-precedence) approvato è la credenziale attiva e ha la precedenza sul Vostro login, quindi `/login` non lo sostituisce. Ruotate la chiave nella Console Claude, oppure ricadete sul Vostro abbonamento eseguendo `unset ANTHROPIC_API_KEY`, oppure in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1239* Se `/status` mostra una riga `API key` che non è contrassegnata come non in uso, una [`ANTHROPIC_API_KEY`](/docs/it/authentication#authentication-precedence) approvata è la credenziale attiva e ha la precedenza sul tuo accesso, quindi `/login` non la sostituisce. Ruota la chiave nella Claude Console, oppure torna al tuo abbonamento eseguendo `unset ANTHROPIC_API_KEY`, o in PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
1234* Se `/status` mostra solo il Vostro login, eseguite `/login` una volta. Se la credenziale è stata revocata, un login fresco la sostituisce.1240* Se `/status` mostra solo il tuo accesso, esegui `/login` una volta. Se la credenziale è stata revocata, un nuovo accesso la sostituisce.
1235* Se lo stesso messaggio ritorna per lo stesso account di login, l'account o l'organizzazione non è più attivo. Controllate l'account e l'organizzazione che `/status` segnala, e chiedete al Vostro amministratore dell'organizzazione di ripristinare l'accesso.1241* Se lo stesso messaggio ricompare per lo stesso account di accesso, l'account o l'organizzazione non sono più attivi. Controlla l'account e l'organizzazione riportati da `/status` e chiedi all'amministratore della tua organizzazione di ripristinare l'accesso.
1236* Se [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) punta a un [gateway LLM](/docs/it/llm-gateway), il testo dopo `401` è il messaggio del Vostro gateway piuttosto che di Anthropic, e `/login` non lo cambia. Correggete invece la credenziale che il Vostro gateway si aspetta.1242* Se [`ANTHROPIC_BASE_URL`](/docs/it/env-vars) punta a un [gateway LLM](/docs/it/llm-gateway), il testo dopo `401` è il messaggio del tuo gateway e non di Anthropic, e `/login` non lo cambia. Correggi invece la credenziale che il tuo gateway si aspetta.
1237 1243
1238<h3 id="login-expired">1244<h3 id="login-expired">
1239 Login scaduto1245 Accesso scaduto
1240</h3>1246</h3>
1241 1247
1242Claude Code ha tentato di rinnovare il Vostro login claude.ai salvato e il servizio OAuth ha rifiutato il token di aggiornamento memorizzato, quindi Claude Code ha cancellato le credenziali salvate. Dopo di che, ogni richiesta di modello si ferma localmente con questo messaggio prima di raggiungere l'API, perché solo `/login` può creare nuove credenziali.1248Claude Code ha provato a rinnovare il tuo accesso claude.ai salvato e il servizio OAuth ha rifiutato il refresh token memorizzato, quindi Claude Code ha cancellato le credenziali salvate. Da quel momento, ogni richiesta al modello si ferma localmente con questo messaggio prima di raggiungere l'API, perché solo `/login` può creare nuove credenziali.
1243 1249
1244Prima della v2.1.206, Claude Code inviava comunque la richiesta del modello con qualsiasi credenziale rimanesse nell'ambiente, e ogni modello falliva con [C'è un problema con il modello selezionato](#theres-an-issue-with-the-selected-model) o un 401 invece di un prompt per accedere.1250Prima della v2.1.206, Claude Code inviava comunque la richiesta al modello con qualunque credenziale rimanesse nell'ambiente, e ogni modello falliva quindi con [C'è un problema con il modello selezionato](#theres-an-issue-with-the-selected-model) o con un 401 anziché con una richiesta di accesso.
1245 1251
1246```text theme={null}1252```text theme={null}
1247Login expired · Please run /login1253Login expired · Please run /login
1248```1254```
1249 1255
1250In [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`:1256In [modalità non interattiva](/docs/it/headless) (`-p`) e nell'[Agent SDK](/docs/it/agent-sdk/overview), il messaggio è il seguente e il codice di errore strutturato è `authentication_failed`:
1251 1257
1252```text theme={null}1258```text theme={null}
1253Failed to authenticate: OAuth session expired and could not be refreshed1259Failed to authenticate: OAuth session expired and could not be refreshed
1254```1260```
1255 1261
1256Questo non è lo stesso stato di [Token OAuth revocato o scaduto](#oauth-token-revoked-or-expired). Quei messaggi segnalano un rifiuto che l'API ha restituito. Claude Code stesso produce `Login expired` per un login che ha già fallito di rinnovare, quindi non invia alcuna richiesta. Quando il rinnovo fallisce perché l'account stesso è sospeso piuttosto che il login essere obsoleto, Claude Code mostra [Il Vostro account è in sospeso](#your-account-is-on-hold) invece.1262Non è lo stesso stato di [Token OAuth revocato o scaduto](#oauth-token-revoked-or-expired). Quei messaggi riportano un rifiuto restituito dall'API. Claude Code stesso produce `Login expired` per un accesso che non è già riuscito a rinnovare, quindi non invia alcuna richiesta. Quando il rinnovo fallisce perché l'account stesso è sospeso e non perché l'accesso è obsoleto, Claude Code mostra invece [Il tuo account è sospeso](#your-account-is-on-hold).
1257 1263
1258Le 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.1264Le sessioni autenticate con una chiave API, con [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o con un provider di terze parti non usano l'accesso salvato e non vedono mai questo messaggio.
1259 1265
1260Potete controllare questo stato prima che una richiesta fallisca: [`/status`](/docs/it/commands) mostra una riga `Login` che legge `Expired — log in again`, più l'organizzazione e l'email che ha salvato per il login scaduto. La riga appare solo quando il login salvato è la Vostra credenziale attiva e non può più essere rinnovato. Le sessioni autenticate in un altro modo non mostrano la riga, anche se un login scaduto rimane salvato. Prima della v2.1.210, `/status` non dava alcuna indicazione in questo stato che un login fosse mai esistito, perché la credenziale cancellata non le lasciava nulla da segnalare.1266Puoi verificare questo stato prima che una richiesta fallisca: [`/status`](/docs/it/commands) mostra una riga `Login` con il valore `Expired — log in again`, oltre all'organizzazione e all'email salvate per l'accesso scaduto. La riga appare solo quando l'accesso salvato è la tua credenziale attiva e non può più essere aggiornato. Le sessioni autenticate in altro modo non mostrano la riga, anche se rimane salvato un accesso scaduto. Prima della v2.1.210, in questo stato `/status` non dava alcuna indicazione che fosse mai esistito un accesso, perché la credenziale cancellata non lasciava nulla da riportare.
1261 1267
1262**Cosa fare:**1268**Cosa fare:**
1263 1269
1264* Eseguite `/login` per accedere di nuovo. Riprovare senza accedere mostra lo stesso messaggio su ogni richiesta.1270* Esegui `/login` per accedere di nuovo. Riprovare senza accedere mostra lo stesso messaggio a ogni richiesta.
1265* 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, autenticate con `ANTHROPIC_API_KEY` o [generate un token di lunga durata con `claude setup-token`](/docs/it/authentication#generate-a-long-lived-token).1271* Se accedi con il tuo account claude.ai in un'altra finestra di Claude Code, consulta [Non hai effettuato l'accesso](#not-logged-in) per sapere quando questa sessione inizia a usare quell'accesso da sola.
1266* Se l'accesso continua a fallire, vedete [Login e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)1272* In modalità non interattiva, esegui `claude` nello stesso ambiente, completa `/login`, poi esegui di nuovo il tuo comando. Per le automazioni che non possono accedere in modo interattivo, autenticati con `ANTHROPIC_API_KEY` oppure [genera un token a lunga durata con `claude setup-token`](/docs/it/authentication#generate-a-long-lived-token).
1273* Se l'accesso continua a non riuscire, consulta [Accesso e autenticazione](/docs/it/troubleshoot-install#login-and-authentication)
1267 1274
1268<h3 id="could-not-refresh-your-login">1275<h3 id="could-not-refresh-your-login">
1269 Impossibile aggiornare il Vostro login perché un altro processo Claude Code lo sta aggiornando1276 Impossibile aggiornare il tuo accesso perché un altro processo di Claude Code lo sta aggiornando
1270</h3>1277</h3>
1271 1278
1272Questo messaggio non significa che il Vostro login sia stato rifiutato. Il Vostro login claude.ai salvato era scaduto e aveva bisogno di rinnovamento. Un altro processo Claude Code sulla stessa macchina teneva il blocco di aggiornamento condiviso, o è uscito e lo ha lasciato dietro, e l'aggiornamento non ha fatto progressi mentre questa sessione aspettava. Claude Code ferma la richiesta prima di inviarla:1279Questo messaggio non significa che il tuo accesso sia stato rifiutato. Il tuo accesso claude.ai salvato era scaduto e doveva essere rinnovato. Un altro processo di Claude Code sulla stessa macchina deteneva il lock di aggiornamento condiviso, oppure è terminato lasciandolo attivo, e l'aggiornamento non ha fatto progressi mentre questa sessione attendeva. Claude Code ferma la richiesta prima di inviarla:
1273 1280
1274```text theme={null}1281```text theme={null}
1275Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login1282Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
1276```1283```
1277 1284
1278In [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 è `server_error`:1285In [modalità non interattiva](/docs/it/headless) (`-p`) e nell'[Agent SDK](/docs/it/agent-sdk/overview), il messaggio è il seguente e il codice di errore strutturato è `server_error`:
1279 1286
1280```text theme={null}1287```text theme={null}
1281Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1288Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1282```1289```
1283 1290
1284Le 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.1291Le sessioni autenticate con una chiave API, con [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o con un provider di terze parti non usano l'accesso salvato e non vedono mai questo messaggio.
1285 1292
1286**Cosa fare:**1293**Cosa fare:**
1287 1294
1288* Riprovate tra un minuto. Se un altro processo completa l'aggiornamento per primo, questa sessione utilizza il login rinnovato.1295* Riprova tra un minuto. Se un altro processo completa prima l'aggiornamento, questa sessione usa l'accesso rinnovato.
1289* Se il messaggio continua a ritornare, chiudete altri processi e finestre Claude Code, quindi riprovate.1296* Se il messaggio continua a ripresentarsi, chiudi le altre finestre e gli altri processi di Claude Code, poi riprova.
1290* Se ritorna senza alcun altro processo Claude Code in esecuzione, eseguite `/login`. L'accesso di nuovo non aspetta il blocco di aggiornamento.1297* Se si ripresenta senza altri processi di Claude Code in esecuzione, esegui `/login`. Accedere di nuovo non attende il lock di aggiornamento.
1291 1298
1292<h3 id="couldnt-save-your-login">1299<h3 id="couldnt-save-your-login">
1293 Impossibile salvare il Vostro login1300 Impossibile salvare il tuo accesso
1294</h3>1301</h3>
1295 1302
1296Vi siete acceduti con claude.ai, ma Claude Code non ha potuto salvare il login nel suo archivio di credenziali, quindi l'accesso non è stato completato. Su macOS questo può accadere quando il keychain di login si blocca, ad esempio al sonno o inattività, dopo che Claude Code ha già letto o salvato credenziali in esso durante la stessa sessione.1303Hai effettuato l'accesso con claude.ai, ma Claude Code non è riuscito a salvare l'accesso nel suo archivio delle credenziali, quindi l'accesso non è stato completato. Su macOS questo può succedere quando il portachiavi login si blocca, ad esempio durante lo stop o per inattività, dopo che Claude Code vi ha già letto o salvato credenziali durante la stessa sessione.
1297 1304
1298```text theme={null}1305```text theme={null}
1299Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1306Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
1300Couldn't save your login. Try logging in again.1307Couldn't save your login. Try logging in again.
1301```1308```
1302 1309
1303La prima forma appare su macOS e la seconda ovunque. Un errore transitorio dell'archivio di credenziali, come un timeout o un archivio illeggibile, produce lo stesso messaggio.1310La prima forma appare su macOS e la seconda ovunque altrove. Un errore temporaneo dell'archivio delle credenziali, come un timeout o un archivio illeggibile, produce lo stesso messaggio.
1304 1311
1305**Cosa fare:**1312**Cosa fare:**
1306 1313
1307* Su macOS, sbloccare il keychain di login, quindi eseguire `/login` di nuovo1314* Su macOS, sblocca il portachiavi login, poi esegui di nuovo `/login`
1308* Su altre piattaforme, eseguire `/login` di nuovo1315* Sulle altre piattaforme, esegui di nuovo `/login`
1309* Se il login ancora non si salva, vedete [Non connesso o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per il comando di sblocco del keychain e altri passaggi di recupero dell'archiviazione delle credenziali1316* Se l'accesso continua a non essere salvato, consulta [Accesso non effettuato o token scaduto](/docs/it/troubleshoot-install#not-logged-in-or-token-expired) per il comando di sblocco del portachiavi e altri passaggi di ripristino dell'archiviazione delle credenziali
1310 1317
1311<h3 id="failed-to-start-oauth-callback-server">1318<h3 id="failed-to-start-oauth-callback-server">
1312 Failed to start OAuth callback server1319 Impossibile avviare il server di callback OAuth
1313</h3>1320</h3>
1314 1321
1315Quando `/login`, `claude auth login`, o `claude setup-token` vi accede attraverso il browser, Claude Code apre una porta in ascolto su `127.0.0.1` in modo che il Vostro browser possa restituire il risultato dell'accesso a esso. Questo messaggio significa che Claude Code non ha potuto aprire quella porta, e l'accesso si ferma prima che una finestra del browser o un URL di login appaia:1322Quando `/login`, `claude auth login` o `claude setup-token` ti fanno accedere tramite il browser, Claude Code apre una porta in ascolto su `127.0.0.1` in modo che il browser possa restituirgli il risultato dell'accesso. Questo messaggio significa che Claude Code non è riuscito ad aprire quella porta, e l'accesso si interrompe prima che appaia una finestra del browser o un URL di accesso:
1316 1323
1317```text theme={null}1324```text theme={null}
1318Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1325Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1319```1326```
1320 1327
1321Se il Vostro messaggio termina con `Is port 0 in use?`, il tentativo di ascoltare sull'indirizzo loopback IPv4 `127.0.0.1` è fallito completamente. Poiché l'errore accade prima che esista un URL di login, il flusso `Paste code here if prompted` non è disponibile come soluzione alternativa.1328Se il tuo messaggio termina con `Is port 0 in use?`, il tentativo di mettersi in ascolto sull'indirizzo di loopback IPv4 `127.0.0.1` è fallito del tutto. Poiché l'errore si verifica prima che esista un URL di accesso, il flusso `Paste code here if prompted` non è disponibile come soluzione alternativa.
1322 1329
1323**Cosa fare:**1330**Cosa fare:**
1324 1331
1325* Per accedere subito senza il listener locale: se utilizzate un abbonamento claude.ai, eseguite [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token) su una macchina dove l'accesso funziona e impostate il token che stampa come `CLAUDE_CODE_OAUTH_TOKEN` su questa macchina. Altrimenti impostate `ANTHROPIC_API_KEY` a una chiave dalla [Console Claude](https://platform.claude.com/settings/keys). [Precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) spiega come Claude Code sceglie tra le credenziali.1332* Per accedere subito senza il listener locale: se usi un abbonamento claude.ai, esegui [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token) su una macchina in cui l'accesso funziona e imposta il token che stampa come `CLAUDE_CODE_OAUTH_TOKEN` su questa macchina. Altrimenti imposta `ANTHROPIC_API_KEY` su una chiave della [Claude Console](https://platform.claude.com/settings/keys). [Precedenza di autenticazione](/docs/it/authentication#authentication-precedence) spiega come Claude Code sceglie tra le credenziali.
1326* Per utilizzare l'accesso del browser su questa macchina invece, Claude Code deve essere in grado di ascoltare su `127.0.0.1`. Se viene eseguito all'interno di una sandbox, controllate che la politica della sandbox consenta l'ascolto su porte locali, quindi eseguite `/login` di nuovo. Se dovrebbe essere in grado di farlo e ancora fallisce, eseguite `/feedback` in modo che il rapporto includa i dettagli del Vostro ambiente.1333* Per usare invece l'accesso tramite browser su questa macchina, Claude Code deve potersi mettere in ascolto su `127.0.0.1`. Se è in esecuzione all'interno di una sandbox, verifica che i criteri della sandbox consentano l'ascolto sulle porte locali, poi esegui di nuovo `/login`. Se dovrebbe poterlo fare e continua a non riuscire, esegui `/feedback` in modo che la segnalazione includa i dettagli del tuo ambiente.
1327 1334
1328<h3 id="claude-login-not-accepted">1335<h3 id="claude-login-not-accepted">
1329 Claude login non accettato1336 Accesso Claude non accettato
1330</h3>1337</h3>
1331 1338
1332Avete tentato di avviare una [sessione cloud](/docs/it/claude-code-on-the-web), e il server ha rifiutato di crearla con un 401: non ha accettato il login Claude che questa macchina ha inviato, di solito perché il login è scaduto o è stato revocato.1339Hai provato ad avviare una [sessione cloud](/docs/it/claude-code-on-the-web) e il server si è rifiutato di crearla con un 401: non ha accettato l'accesso Claude inviato da questa macchina, di solito perché l'accesso è scaduto o è stato revocato.
1333 1340
1334La prima parte della riga è il motivo del server quando ne fornisce uno. Altrimenti la riga legge:1341La prima parte della riga è il motivo fornito dal server, quando ne fornisce uno. Altrimenti la riga è:
1335 1342
1336```text theme={null}1343```text theme={null}
1337Claude login not accepted · Run /login, then try again1344Claude login not accepted · Run /login, then try again
1339 1346
1340**Cosa fare:**1347**Cosa fare:**
1341 1348
1342* Eseguite `/login`, completate l'accesso, quindi avviate di nuovo la sessione1349* Esegui `/login`, completa l'accesso, poi avvia di nuovo la sessione
1343 1350
1344<h3 id="artifacts-need-a-claude-ai-login">1351<h3 id="artifacts-need-a-claude-ai-login">
1345 Artifacts hanno bisogno di un login claude.ai1352 Gli artefatti richiedono un accesso claude.ai
1346</h3>1353</h3>
1347 1354
1348Claude Code ha rifiutato una pubblicazione o lettura di [artifact](/docs/it/artifacts) perché la sessione non ha alcun login claude.ai che possa utilizzare per gli artifact.1355Claude Code ha rifiutato la pubblicazione o la lettura di un [artefatto](/docs/it/artifacts) perché la sessione non ha un accesso claude.ai utilizzabile per gli artefatti.
1349 1356
1350Ogni forma del messaggio inizia con le stesse parole, seguita da un rimedio che dipende da come la Vostra sessione si autentica. Senza alcuna credenziale in competizione legge:1357Ogni forma del messaggio inizia con le stesse parole, seguite da un rimedio che dipende da come si autentica la tua sessione. Senza alcuna credenziale concorrente, il messaggio è:
1351 1358
1352```text theme={null}1359```text theme={null}
1353Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1360Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
1355 1362
1356**Cosa fare:**1363**Cosa fare:**
1357 1364
1358* Eseguite `/login` e selezionate **Claude account with subscription**. L'opzione **Anthropic Console account** non fornisce credenziali claude.ai.1365* Esegui `/login` e seleziona **Claude account with subscription**. L'opzione **Anthropic Console account** non fornisce credenziali claude.ai.
1359* Quando il messaggio nomina una credenziale che ha la precedenza, come `ANTHROPIC_API_KEY`, un'impostazione `apiKeyHelper` o una chiave Console salvata da un `/login` precedente, rimuovetela nel modo che il messaggio dice, quindi eseguite `/login`1366* Quando il messaggio nomina una credenziale che ha la precedenza, come `ANTHROPIC_API_KEY`, un'impostazione `apiKeyHelper` o una chiave Console salvata da un `/login` precedente, rimuovila come indicato dal messaggio, poi esegui `/login`
1360* Quando il messaggio dice che questa sessione remota si autentica attraverso la macchina che l'ha lanciata, accedete a claude.ai su quella macchina, quindi riconnettete la sessione1367* Quando il messaggio dice che questa sessione remota si autentica tramite la macchina che l'ha avviata, accedi a claude.ai su quella macchina, poi riconnetti la sessione
1361* Quando il messaggio dice che la credenziale è iniettata dall'ambiente host della sessione, non potete cambiarla in quella sessione; avviate una sessione che è connessa a claude.ai1368* Quando il messaggio dice che la credenziale è iniettata dall'ambiente host della sessione, non puoi cambiarla in quella sessione; avvia una sessione in cui hai effettuato l'accesso a claude.ai
1362* Vedete [Disponibilità](/docs/it/artifacts#availability) per gli altri requisiti che gli artifact hanno, come piano, provider di modello e politica dell'organizzazione1369* Consulta [Disponibilità](/docs/it/artifacts#availability) per gli altri requisiti degli artefatti, come il piano, il provider del modello e i criteri dell'organizzazione
1363 1370
1364<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1371<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1365 La politica dell'amministratore richiede un accesso al gateway Cloud1372 I criteri dell'amministratore richiedono un accesso al Cloud gateway
1366</h3>1373</h3>
1367 1374
1368Un [impostazione gestita](/docs/it/managed-settings) di un amministratore su questa macchina ha impostato [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) a `"gateway"` o ha impostato [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl). A meno che non selezioniate un provider cloud attraverso una variabile come `CLAUDE_CODE_USE_BEDROCK`, Claude Code accetta quindi solo l'accesso [gateway delle app Claude](/docs/it/claude-apps-gateway). Vedete uno di due messaggi:1375Le [impostazioni gestite](/docs/it/managed-settings) di un amministratore su questa macchina impostano [`forceLoginMethod`](/docs/it/settings-reference#forceloginmethod) su `"gateway"` oppure impostano [`forceLoginGatewayUrl`](/docs/it/settings-reference#forcelogingatewayurl). A meno che tu non selezioni un provider cloud tramite una variabile come `CLAUDE_CODE_USE_BEDROCK`, Claude Code accetta quindi solo l'accesso tramite il [gateway delle app Claude](/docs/it/claude-apps-gateway). Vedi uno di due messaggi:
1369 1376
1370```text theme={null}1377```text theme={null}
1371Not signed in to the Cloud gateway — run /login.1378Not signed in to the Cloud gateway — run /login.
1372```1379```
1373 1380
1374Le richieste di modello falliscono con questo messaggio quando la sessione non ha alcun accesso al gateway, ad esempio perché non avete eseguito `/login` da quando la politica ha raggiunto la macchina.1381Le richieste al modello falliscono con questo messaggio quando la sessione non ha un accesso al gateway, ad esempio perché non hai eseguito `/login` da quando i criteri sono arrivati sulla macchina.
1375 1382
1376Se avete anche una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` configurata e le impostazioni gestite impostano `forceLoginMethod`, Claude Code esce all'avvio invece con un messaggio che inizia:1383Se la macchina contiene anche una credenziale emessa da Anthropic e le impostazioni gestite impostano `forceLoginMethod` o `forceLoginOrgUUID`, Claude Code termina invece all'avvio. Quella credenziale può essere una variabile `ANTHROPIC_API_KEY` o `ANTHROPIC_AUTH_TOKEN`, un'impostazione `apiKeyHelper` o una chiave API salvata da un precedente accesso alla Claude Console. Il messaggio inizia così:
1377 1384
1378```text theme={null}1385```text theme={null}
1379Administrator policy requires a Cloud gateway sign-in on this machine; the1386Administrator policy requires a Cloud gateway sign-in on this machine; the
1383 1390
1384**Cosa fare:**1391**Cosa fare:**
1385 1392
1386* Eseguite `/login` e completate l'accesso sulla schermata **Cloud gateway**1393* Esegui `/login` e completa l'accesso nella schermata **Cloud gateway**
1387* Per il messaggio di avvio, rimuovete l'impostazione `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` che avete configurato, quindi avviate `claude` ed eseguite `/login`1394* Per il messaggio all'avvio, rimuovi l'impostazione `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` che hai configurato. Per rimuovere una chiave API della Console salvata, esegui `claude auth logout`, che rimuove anche un accesso claude.ai salvato. Se selezioni un provider cloud con `CLAUDE_CODE_USE_*`, la sessione si avvia quindi senza alcun accesso. Altrimenti avvia `claude` ed esegui `/login`
1388* Se ritenete che la macchina non dovrebbe richiedere il gateway, chiedete all'amministratore che la gestisce di rimuovere `forceLoginMethod` e `forceLoginGatewayUrl` dalle sue impostazioni gestite1395* Se ritieni che la macchina non debba richiedere il gateway, chiedi all'amministratore che la gestisce di rimuovere `forceLoginMethod` e `forceLoginGatewayUrl` dalle sue impostazioni gestite
1389 1396
1390Su v2.1.265, una regressione ha anche mostrato il primo messaggio in alcune configurazioni di gateway LLM e proxy che si autenticano con una chiave API, `apiKeyHelper` o intestazioni personalizzate, anche senza alcun requisito di amministratore sulla macchina. Aggiornate alla v2.1.266 o successiva. Non è necessario modificare la Vostra configurazione.1397Nella v2.1.265, una regressione mostrava il primo messaggio anche in alcune configurazioni con gateway LLM e proxy che si autenticano con una chiave API, `apiKeyHelper` o intestazioni personalizzate, anche senza alcun requisito dell'amministratore sulla macchina. Aggiorna alla v2.1.266 o successiva. Non devi modificare la tua configurazione.
1391 1398
1392Prima della v2.1.261, su macchine che impostano `forceLoginMethod` a `"gateway"`, Claude Code utilizzava un login salvato rimasto invece di fallire le richieste di modello, e segnalava una credenziale d'ambiente configurata con `This machine's managed settings require a first-party login` invece del messaggio di avvio. Prima della v2.1.265, una macchina le cui impostazioni gestite impostano solo `forceLoginGatewayUrl` non richiedeva l'accesso al gateway, e Claude Code utilizzava una credenziale rimasta lì.1399Prima della v2.1.261, sulle macchine che impostavano `forceLoginMethod` su `"gateway"`, Claude Code usava un accesso salvato residuo invece di far fallire le richieste al modello, e segnalava una credenziale d'ambiente configurata con `This machine's managed settings require a first-party login` invece del messaggio all'avvio. Prima della v2.1.265, una macchina le cui impostazioni gestite impostavano solo `forceLoginGatewayUrl` non richiedeva l'accesso al gateway, e lì Claude Code usava una credenziale residua.
1393 1400
1394<h3 id="your-account-is-on-hold">1401<h3 id="your-account-is-on-hold">
1395 Il Vostro account è in sospeso1402 Il tuo account è sospeso
1396</h3>1403</h3>
1397 1404
1398L'account Claude dietro il Vostro login è stato sospeso. Claude Code mostra il primo messaggio quando tenta di rinnovare il Vostro login salvato e apprende della sospensione, e il secondo quando un accesso che completate nel browser lo segnala:1405L'account Claude associato al tuo accesso è stato sospeso. Claude Code mostra il primo messaggio quando prova a rinnovare il tuo accesso salvato e viene a sapere della sospensione, e il secondo quando lo segnala un accesso che completi nel browser:
1399 1406
1400```text theme={null}1407```text theme={null}
1401Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1408Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
1402Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1409Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1403```1410```
1404 1411
1405L'accesso di nuovo con lo stesso account non cancella il messaggio, perché la sospensione è sull'account piuttosto che sul login. In [modalità non interattiva](/docs/it/headless) (`-p`) e [Agent SDK](/docs/it/agent-sdk/overview), il codice di errore strutturato è `account_on_hold`. Prima della v2.1.235, Claude Code segnalava un account sospeso come [Login scaduto · Please run /login](#login-expired), i cui passaggi di recupero non possono cancellare una sospensione.1412Accedere di nuovo con lo stesso account non elimina il messaggio, perché la sospensione riguarda l'account e non l'accesso. In [modalità non interattiva](/docs/it/headless) (`-p`) e nell'[Agent SDK](/docs/it/agent-sdk/overview), il codice di errore strutturato è `account_on_hold`. Prima della v2.1.235, Claude Code segnalava un account sospeso come [Login expired · Please run /login](#login-expired), i cui passaggi di ripristino non possono eliminare una sospensione.
1406 1413
1407**Cosa fare:**1414**Cosa fare:**
1408 1415
1409* Aprite il link nel messaggio per visualizzare i dettagli della sospensione o presentare ricorso1416* Apri il link nel messaggio per visualizzare i dettagli della sospensione o presentare ricorso
1410* Se avete un altro account Claude o una chiave API che non è interessata dalla sospensione, potete continuare a lavorare mentre la sospensione viene risolta: eseguite `/login` con quell'account, oppure impostate la chiave con `ANTHROPIC_API_KEY`1417* Se hai un altro account Claude o una chiave API non interessati dalla sospensione, puoi continuare a lavorare mentre la sospensione viene risolta: esegui `/login` con quell'account, oppure imposta la chiave con `ANTHROPIC_API_KEY`
1411 1418
1412<h3 id="anthropic-profile-login-expired">1419<h3 id="anthropic-profile-login-expired">
1413 Login del profilo Anthropic scaduto1420 Accesso al profilo Anthropic scaduto
1414</h3>1421</h3>
1415 1422
1416Claude Code si sta autenticando attraverso un profilo di credenziale Anthropic la cui credenziale di login salvata è scaduta, e il profilo non contiene alcuna credenziale di aggiornamento che Claude Code possa utilizzare per rinnovarla. Claude Code ferma ogni richiesta localmente senza riprovare, perché un nuovo tentativo leggerebbe la stessa credenziale scaduta.1423Claude Code si sta autenticando tramite un profilo di credenziali Anthropic la cui credenziale di accesso salvata è scaduta, e il profilo non contiene alcuna credenziale di aggiornamento che Claude Code possa usare per rinnovarla. Claude Code ferma localmente ogni richiesta senza riprovare, perché un nuovo tentativo leggerebbe la stessa credenziale scaduta.
1417 1424
1418```text theme={null}1425```text theme={null}
1419Anthropic profile login expired · Re-authenticate your Anthropic profile1426Anthropic profile login expired · Re-authenticate your Anthropic profile
1420Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1427Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1421```1428```
1422 1429
1423Questo appare solo quando la credenziale attiva proviene da un profilo di credenziale Anthropic, uno che selezionate con la variabile d'ambiente `ANTHROPIC_PROFILE`, che Claude Code scopre come il profilo attivo nella Vostra directory di configurazione Anthropic, o che Claude Code ha scritto quando vi siete [acceduti senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Le sessioni che si autenticano con l'opzione claude.ai di `/login`, una chiave API, un token bearer come `ANTHROPIC_AUTH_TOKEN` o un provider di terze parti non vedono mai questo messaggio.1430Questo appare solo quando la credenziale attiva proviene da un profilo di credenziali Anthropic: uno che selezioni con la variabile d'ambiente `ANTHROPIC_PROFILE`, che Claude Code individua come profilo attivo nella tua directory di configurazione Anthropic, o che Claude Code ha scritto quando hai [effettuato l'accesso senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Le sessioni che si autenticano con una chiave API, con un bearer token come `ANTHROPIC_AUTH_TOKEN` o con un provider di terze parti non vedono mai questo messaggio.
1424 1431
1425Su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), eseguite `/login`, scegliete l'account Anthropic Console e accedete di nuovo per rinnovare un profilo che l'accesso Console senza chiave o il CLI della Claude Platform `ant auth login` ha scritto. Claude Code sostituisce la credenziale scaduta in quel profilo. Per un profilo di federazione o uno che un altro strumento ha creato, `/login` non rinnova la credenziale. Quale forma vedete dipende dal fatto che abbiate selezionato il profilo o Claude Code l'abbia scoperto:1432Su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), esegui `/login`, scegli l'account Anthropic Console e accedi di nuovo per rinnovare un profilo scritto dall'accesso alla Console senza chiave o da `ant auth login` della Claude Platform CLI. Claude Code sostituisce la credenziale scaduta in quel profilo. Per un profilo di federazione o creato da un altro strumento, `/login` non rinnova la credenziale. La forma che vedi dipende dal fatto che tu abbia selezionato il profilo o che Claude Code lo abbia individuato:
1426 1433
1427* Quando impostate `ANTHROPIC_PROFILE` esplicitamente, il messaggio termina con `Re-authenticate your Anthropic profile`.1434* Quando imposti esplicitamente `ANTHROPIC_PROFILE`, il messaggio termina con `Re-authenticate your Anthropic profile`.
1428* Quando Claude Code ha scoperto il profilo dalla Vostra directory di configurazione, il messaggio offre `/login`, perché Claude Code dà la precedenza a un `/login` funzionante rispetto al profilo scoperto e quindi si autentica con il Vostro account claude.ai o Console invece. Prima della v2.1.234, Claude Code mostrava il modulo `Re-authenticate your Anthropic profile` anche in questo caso.1435* Quando Claude Code ha individuato il profilo dalla tua directory di configurazione, il messaggio propone `/login`, perché Claude Code dà a un `/login` funzionante la precedenza sul profilo individuato e si autentica quindi con il tuo account claude.ai o Console. Prima della v2.1.234, Claude Code mostrava anche in questo caso la forma `Re-authenticate your Anthropic profile`.
1429 1436
1430**Cosa fare:**1437**Cosa fare:**
1431 1438
1432* Accedete di nuovo al profilo, quindi riprovate: su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), eseguite `/login` e scegliete l'account Anthropic Console per un profilo che l'accesso Console senza chiave o il CLI della Claude Platform `ant auth login` ha scritto; per altri profili, utilizzate lo strumento che li ha creati1439* Accedi di nuovo al profilo, poi riprova: su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), esegui `/login` e scegli l'account Anthropic Console per un profilo scritto dall'accesso alla Console senza chiave o da `ant auth login` della Claude Platform CLI; per gli altri profili, usa lo strumento che li ha creati
1433* Se un amministratore ha fornito la credenziale del profilo, chiedetegli di emetterne una nuova1440* Se la credenziale del profilo è stata fornita da un amministratore, chiedigli di emetterne una nuova
1434* Eseguite `/status` per confermare la fonte di credenziale attiva e il nome del profilo1441* Esegui `/status` per verificare l'origine delle credenziali attiva e il nome del profilo
1435* Per smettere di utilizzare il profilo, annullate l'impostazione di `ANTHROPIC_PROFILE` se l'avete impostato, quindi autenticate in un altro modo, come `/login` o `ANTHROPIC_API_KEY`1442* Per smettere di usare il profilo, rimuovi `ANTHROPIC_PROFILE` se l'hai impostata, poi autenticati in un altro modo, ad esempio con `/login` o `ANTHROPIC_API_KEY`
1436 1443
1437<h3 id="oauth-scope-requirement">1444<h3 id="oauth-scope-requirement">
1438 Requisito di ambito OAuth1445 Requisito di scope OAuth
1439</h3>1446</h3>
1440 1447
1441Il token memorizzato precede un ambito di autorizzazione che una funzione più recente necessita:1448Il token memorizzato è precedente a uno scope di permesso richiesto da una funzionalità più recente:
1442 1449
1443```text theme={null}1450```text theme={null}
1444OAuth token does not meet scope requirement: user:profile1451OAuth token does not meet scope requirement: user:profile
1446 1453
1447**Cosa fare:**1454**Cosa fare:**
1448 1455
1449* Eseguite `/login` per ottenere un nuovo token con gli ambiti attuali. Non è necessario disconnettervi prima.1456* Esegui `/login` per ottenere un nuovo token con gli scope attuali. Non devi prima uscire.
1450 1457
1451<h3 id="claude-ai-rejected-the-session-token">1458<h3 id="claude-ai-rejected-the-session-token">
1452 claude.ai ha rifiutato il token della sessione1459 claude.ai ha rifiutato il token di sessione
1453</h3>1460</h3>
1454 1461
1455Una richiesta [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) è fallita perché claude.ai ha rifiutato il token dal Vostro login Claude Code. Il token rifiutato è il Vostro login, non l'autorizzazione del connettore in claude.ai, quindi autorizzare di nuovo il connettore non lo risolve. In `/mcp`, il connettore mostra come `session token rejected` e la sua vista dettagliata legge:1462Una richiesta di un [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) è fallita perché claude.ai ha rifiutato il token del tuo accesso a Claude Code. Il token rifiutato è il tuo accesso, non l'autorizzazione del connettore stesso in claude.ai, quindi autorizzare di nuovo il connettore non risolve il problema. In `/mcp`, il connettore appare come `session token rejected` e la sua vista dettagliata riporta:
1456 1463
1457```text theme={null}1464```text theme={null}
1458claude.ai rejected the session token. Run /login, then reconnect.1465claude.ai rejected the session token. Run /login, then reconnect.
1460 1467
1461**Cosa fare:**1468**Cosa fare:**
1462 1469
1463* Eseguite `/login` per accedere di nuovo1470* Esegui `/login` per accedere di nuovo
1464* Riconnettete il connettore da `/mcp`, oppure eseguite `/mcp reconnect <server>`. Riconnettere prima di accedere di nuovo lascia il connettore nello stesso stato. L'opzione **Reconnect** del pannello `/mcp` segnala `your claude.ai session token was rejected`; il modulo `/mcp reconnect <server>` digitato segnala una riconnessione riuscita anche se il token è ancora rifiutato.1471* Riconnetti il connettore da `/mcp`, oppure esegui `/mcp reconnect <server>`. Riconnettersi prima di aver effettuato di nuovo l'accesso lascia il connettore nello stesso stato. L'opzione **Reconnect** del pannello `/mcp` segnala `your claude.ai session token was rejected`; la forma digitata `/mcp reconnect <server>` segnala una riconnessione riuscita anche se il token viene ancora rifiutato.
1465 1472
1466Prima della v2.1.222, Claude Code contrassegnava il connettore come necessitante di autenticazione invece, che vi indicava il flusso di autorizzazione del connettore anche se completarlo non risolveva lo stato.1473Prima della v2.1.222, Claude Code contrassegnava invece il connettore come bisognoso di autenticazione, indirizzandoti al flusso di autorizzazione del connettore anche se completarlo non risolveva lo stato.
1467 1474
1468<h3 id="mcp-server-needs-you-to-sign-in-again">1475<h3 id="mcp-server-needs-you-to-sign-in-again">
1469 MCP server ha bisogno che vi accediate di nuovo1476 Il server MCP richiede di accedere di nuovo
1470</h3>1477</h3>
1471 1478
1472Un server [MCP](/docs/it/mcp) remoto ha rifiutato la credenziale su una chiamata di strumento a metà sessione, di solito perché un accesso o un token è scaduto o perché il token manca di un'autorizzazione che lo strumento necessita. La chiamata di strumento fallisce, e `/mcp` contrassegna il server come [necessitante di autenticazione](/docs/it/mcp#authenticate-with-remote-mcp-servers).1479Un [server MCP](/docs/it/mcp) remoto ha rifiutato la credenziale durante una chiamata a uno strumento a sessione in corso, di solito perché un accesso o un token è scaduto o perché il token non dispone di un permesso richiesto dallo strumento. La chiamata allo strumento fallisce e `/mcp` contrassegna il server come [bisognoso di autenticazione](/docs/it/mcp#authenticate-with-remote-mcp-servers).
1473 1480
1474Per un server a cui vi accedete da Claude Code, incluso un connettore claude.ai, l'accesso è scaduto o è stato revocato:1481Per un server a cui accedi da Claude Code, incluso un connettore claude.ai, l'accesso è scaduto o è stato revocato:
1475 1482
1476```text theme={null}1483```text theme={null}
1477MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1484MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1478```1485```
1479 1486
1480Eseguite `/mcp`, selezionate il server e accedete di nuovo dal suo menu.1487Esegui `/mcp`, seleziona il server e accedi di nuovo dal suo menu.
1481 1488
1482Per un server configurato con uno script [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication), Claude Code ha già rieseguito l'helper e ritentato la chiamata una volta prima di mostrare questo:1489Per un server configurato con uno script [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication), Claude Code ha già eseguito di nuovo l'helper e riprovato la chiamata una volta prima di mostrare questo:
1483 1490
1484```text theme={null}1491```text theme={null}
1485MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1492MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
1486```1493```
1487 1494
1488Controllate che l'helper restituisca una credenziale che il server accetta, quindi riconnettete da `/mcp`, che riesegue l'helper.1495Verifica che l'helper restituisca una credenziale accettata dal server, poi riconnetti da `/mcp`, che esegue di nuovo l'helper.
1489 1496
1490Per un server con un'intestazione `Authorization` statica nella sua configurazione:1497Per un server con un'intestazione `Authorization` statica nella sua configurazione:
1491 1498
1493MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1500MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1494```1501```
1495 1502
1496Aggiornate il valore dell'intestazione dove il server è configurato, quindi riconnettete da `/mcp`.1503Aggiorna il valore dell'intestazione dove è configurato il server, poi riconnetti da `/mcp`.
1497 1504
1498Prima della v2.1.273, i casi di accesso scaduto, `headersHelper` e intestazione `Authorization` mostravano tutti `MCP server "<name>" requires re-authorization (token expired)`.1505Prima della v2.1.273, i casi di accesso scaduto, `headersHelper` e intestazione `Authorization` mostravano tutti `MCP server "<name>" requires re-authorization (token expired)`.
1499 1506
1500Un server può anche rifiutare una chiamata di strumento con HTTP 403 `insufficient_scope` per chiedere di autorizzare un ambito, a volte uno che il Vostro token già elenca. Il messaggio nomina quell'ambito:1507Un server può anche rifiutare una chiamata a uno strumento con HTTP 403 `insufficient_scope` per chiederti di autorizzare uno scope, a volte uno già elencato nel tuo token. Il messaggio nomina quello scope:
1501 1508
1502```text theme={null}1509```text theme={null}
1503MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1510MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1504```1511```
1505 1512
1506Eseguite `/mcp`, selezionate il server e autenticate di nuovo dal suo menu.1513Esegui `/mcp`, seleziona il server e autenticati di nuovo dal suo menu.
1507 1514
1508Quando la configurazione del server non imposta né [`oauth.scopes`](/docs/it/mcp#restrict-oauth-scopes) né [`authServerMetadataUrl`](/docs/it/mcp#override-oauth-metadata-discovery), Claude Code richiede l'ambito che il server ha nominato. Con una delle due impostazioni, Claude Code richiede gli ambiti di quell'impostazione invece. Se avete fissato `oauth.scopes`, aggiungete l'ambito mancante a quell'elenco prima di autenticare di nuovo.1515Quando la configurazione del server non imposta né [`oauth.scopes`](/docs/it/mcp#restrict-oauth-scopes) né [`authServerMetadataUrl`](/docs/it/mcp#override-oauth-metadata-discovery), Claude Code richiede lo scope indicato dal server. Con una delle due impostazioni, Claude Code richiede invece gli scope di quell'impostazione. Se hai fissato `oauth.scopes`, aggiungi lo scope mancante a quell'elenco prima di autenticarti di nuovo.
1509 1516
1510Prima della v2.1.274, questo caso mostrava il messaggio `needs you to sign in again`, e prima della v2.1.273 mostrava `requires re-authorization (token expired)` come gli altri casi.1517Prima della v2.1.274, questo caso mostrava il messaggio `needs you to sign in again`, e prima della v2.1.273 mostrava `requires re-authorization (token expired)` come gli altri casi.
1511 1518
1512<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1519<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">
1513 URL del server MCP mancante o non valido1520 L'URL del server MCP manca o non è un URL valido
1514</h3>1521</h3>
1515 1522
1516Claude Code ha rifiutato di avviare un accesso OAuth per un server MCP remoto perché l'URL `url` configurato del server non viene analizzato come un URL. A meno che Claude Code non abbia un problema di configurazione più specifico da segnalare per il server, l'esecuzione di [`claude mcp login <name>`](/docs/it/mcp#authenticate-from-the-command-line) nella Vostra shell stampa il rifiuto come:1523Claude Code si è rifiutato di avviare un accesso OAuth per un server MCP remoto perché l'`url` configurato per il server non viene interpretato come URL. A meno che Claude Code non abbia un problema di configurazione più specifico da segnalare per il server, eseguire [`claude mcp login <name>`](/docs/it/mcp#authenticate-from-the-command-line) nella tua shell stampa il rifiuto così:
1517 1524
1518```text theme={null}1525```text theme={null}
1519Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.1526Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
1521 1528
1522**Cosa fare:**1529**Cosa fare:**
1523 1530
1524* Impostate la voce `url` all'endpoint reale del server dove il server è configurato, o impostate la variabile d'ambiente che il suo riferimento [`${VAR}`](/docs/it/mcp#environment-variable-expansion-in-mcp-json) nomina, quindi eseguite di nuovo l'accesso.1531* Imposta l'`url` della voce sull'endpoint reale del server dove il server è configurato, oppure imposta la variabile d'ambiente indicata dal suo [riferimento `${VAR}`](/docs/it/mcp#environment-variable-expansion-in-mcp-json), poi esegui di nuovo l'accesso.
1525 1532
1526<h3 id="issuer-mismatch-in-authorization-response">1533<h3 id="issuer-mismatch-in-authorization-response">
1527 Mancata corrispondenza dell'emittente nella risposta di autorizzazione1534 Issuer non corrispondente nella risposta di autorizzazione
1528</h3>1535</h3>
1529 1536
1530Durante un [accesso MCP OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers), il server di autorizzazione ha reindirizzato di nuovo a Claude Code con un parametro `iss` che non nomina l'emittente che Claude Code si aspettava dai metadati OAuth del server. Un emittente sbagliato a questo passaggio è come appare un attacco di mix-up del server di autorizzazione, quindi Claude Code fallisce l'accesso invece di scambiare il codice di autorizzazione. Claude Code mostra l'errore nel menu del server `/mcp` dopo l'accesso del browser:1537Durante un [accesso OAuth MCP](/docs/it/mcp#authenticate-with-remote-mcp-servers), il server di autorizzazione ha reindirizzato a Claude Code con un parametro `iss` che non indica l'issuer che Claude Code si aspettava dai metadati OAuth del server. Un issuer errato in questo passaggio è il segno di un attacco di mix-up del server di autorizzazione, quindi Claude Code fa fallire l'accesso invece di scambiare il codice di autorizzazione. Claude Code mostra l'errore nel menu del server in `/mcp` dopo l'accesso tramite browser:
1531 1538
1532```text theme={null}1539```text theme={null}
1533Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1540Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1534```1541```
1535 1542
1536`expected` è l'emittente dai metadati OAuth del server, e `received` è il valore `iss` che il reindirizzamento ha trasportato. Un accesso il cui reindirizzamento non trasporta alcun parametro `iss` passa il controllo, a meno che i metadati del server non impostino `authorization_response_iss_parameter_supported`, nel qual caso Claude Code fallisce l'accesso.1543`expected` è l'issuer dai metadati OAuth del server, e `received` è il valore `iss` trasportato dal reindirizzamento. Un accesso il cui reindirizzamento non contiene alcun parametro `iss` supera il controllo, a meno che i metadati del server non impostino `authorization_response_iss_parameter_supported`, nel qual caso Claude Code fa fallire l'accesso.
1537 1544
1538**Cosa fare:**1545**Cosa fare:**
1539 1546
1540* Riprovate l'accesso da `/mcp`1547* Riprova l'accesso da `/mcp`
1541* Se l'errore si ripete, segnalarlo all'operatore del server. La correzione è lato server: il server di autorizzazione deve restituire lo stesso emittente nel parametro `iss` che pubblicizza nei suoi metadati1548* Se l'errore si ripete, segnalalo al gestore del server. La soluzione è lato server: il server di autorizzazione deve restituire nel parametro `iss` lo stesso issuer che pubblica nei suoi metadati
1542* Per connettervi mentre il server viene corretto, avviate Claude Code con [`MCP_SDK_GENERATION=v1`](/docs/it/env-vars), il cui [runtime](/docs/it/mcp#mcp-client-runtimes) non esegue questo controllo. Questo rimuove una protezione contro gli attacchi di mix-up, quindi preferite la correzione lato server1549* Per connetterti mentre il server viene corretto, avvia Claude Code con [`MCP_SDK_GENERATION=v1`](/docs/it/env-vars), il cui [runtime](/docs/it/mcp#mcp-client-runtimes) non esegue questo controllo. Questo rimuove una protezione contro gli attacchi di mix-up, quindi preferisci la soluzione lato server
1543 1550
1544Prima della v2.1.232, Claude Code utilizzava il runtime v2 solo in un rollout graduale o quando impostavate `MCP_SDK_GENERATION=v2`.1551Prima della v2.1.232, Claude Code usava il runtime v2 solo in un rilascio graduale o quando impostavi `MCP_SDK_GENERATION=v2`.
1545 1552
1546<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1553<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1547 Rifiuto di inviare credenziali a un endpoint token non HTTPS1554 Rifiuto di inviare credenziali a un endpoint del token non https
1548</h3>1555</h3>
1549 1556
1550Sul [runtime v2](/docs/it/mcp#mcp-client-runtimes), Claude Code invia una richiesta di token [MCP OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers) solo a un endpoint token servito su HTTPS o su `localhost`, `127.0.0.1` o `::1`. Questo messaggio significa che l'endpoint token del server non è nessuno dei due, quindi Claude Code si è fermato prima di inviare la richiesta. Questo accade dopo l'accesso del browser, quindi il passaggio del browser ha successo per primo, e di nuovo ogni volta che Claude Code aggiorna il token del server.1557Sul [runtime v2](/docs/it/mcp#mcp-client-runtimes), Claude Code invia una richiesta di token [OAuth MCP](/docs/it/mcp#authenticate-with-remote-mcp-servers) solo a un endpoint del token servito tramite HTTPS o su `localhost`, `127.0.0.1` o `::1`. Questo messaggio significa che l'endpoint del token del server non rientra in nessuno di questi casi, quindi Claude Code si è fermato prima di inviare la richiesta. Questo accade dopo l'accesso tramite browser, quindi il passaggio nel browser riesce prima, e di nuovo ogni volta che Claude Code aggiorna il token del server.
1551 1558
1552Nella sua forma completa, il messaggio proviene dall'SDK MCP e cita l'endpoint token che ha rifiutato. Nel log di debug, segue `Error during auth completion:` per un accesso o `Token refresh failed:` per un aggiornamento. Nella Vostra shell, `claude mcp login <name>` lo stampa dopo `Couldn't complete authentication for "<name>":`, e in una sessione, `/mcp` lo mostra sotto il menu del server:1559Nella sua forma completa, il messaggio proviene dall'MCP SDK e cita l'endpoint del token che ha rifiutato. Nel log di debug, segue `Error during auth completion:` per un accesso o `Token refresh failed:` per un aggiornamento. Nella tua shell, `claude mcp login <name>` lo stampa dopo `Couldn't complete authentication for "<name>":`, e in una sessione `/mcp` lo mostra nel menu del server:
1553 1560
1554```text theme={null}1561```text theme={null}
1555Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).1562Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
1556```1563```
1557 1564
1558Claude Code tratta un URL del server che ha una stringa di query o un segmento di percorso lungo e casuale come possibilmente segreto. Per un tale server, redige gli errori di accesso che l'SDK MCP solleva prima di mostrarli o registrarli. Questo errore legge quindi come un nome breve che può cambiare tra i rilasci, come `io`, seguito da `from the MCP SDK for` e l'URL del server redatto. Gli altri errori dall'SDK MCP assumono la stessa forma lì. Il messaggio redatto può essere questo errore solo quando l'endpoint token del server è `http://` semplice a un indirizzo diverso da `localhost`, `127.0.0.1` o `::1`.1565Claude Code considera potenzialmente segreto un URL di server che contiene una query string o un segmento di percorso lungo e dall'aspetto casuale. Per un server di questo tipo, oscura gli errori di accesso generati dall'MCP SDK prima di mostrarli o registrarli nei log. Questo errore appare quindi come un nome breve che può cambiare tra una versione e l'altra, come `io`, seguito da `from the MCP SDK for` e dall'URL del server oscurato. Anche gli altri errori dell'MCP SDK assumono lì la stessa forma. Il messaggio oscurato può corrispondere a questo errore solo quando l'endpoint del token del server è un semplice `http://` su un indirizzo diverso da `localhost`, `127.0.0.1` o `::1`.
1559 1566
1560**Cosa fare:**1567**Cosa fare:**
1561 1568
1562* Servite quell'endpoint token su HTTPS, ad esempio mettendo il server dietro un proxy inverso o un tunnel che termina TLS e configurando il server per pubblicizzare l'indirizzo `https://`1569* Servi quell'endpoint del token tramite HTTPS, ad esempio mettendo il server dietro un reverse proxy o un tunnel che termina TLS e configurando il server per pubblicare l'indirizzo `https://`
1563* Per connettervi senza modificare il server, avviate Claude Code con [`MCP_SDK_GENERATION=v1`](/docs/it/env-vars), il cui [runtime](/docs/it/mcp#mcp-client-runtimes) non applica questa regola e invia la richiesta di token su HTTP semplice. Quella scelta dura fino a quando non uscite e si applica a ogni server. Il runtime v1 salta anche il [controllo dell'emittente](#issuer-mismatch-in-authorization-response), quindi preferite servire l'endpoint su HTTPS1570* Per connetterti senza modificare il server, avvia Claude Code con [`MCP_SDK_GENERATION=v1`](/docs/it/env-vars), il cui [runtime](/docs/it/mcp#mcp-client-runtimes) non applica questa regola e invia la richiesta di token tramite HTTP semplice. Questa scelta dura finché non esci e si applica a ogni server. Il runtime v1 salta anche il [controllo dell'issuer](#issuer-mismatch-in-authorization-response), quindi preferisci servire l'endpoint tramite HTTPS
1564 1571
1565<h3 id="aws-credentials-expired-or-invalid">1572<h3 id="aws-credentials-expired-or-invalid">
1566 Credenziali AWS scadute o non valide1573 Credenziali AWS scadute o non valide
1567</h3>1574</h3>
1568 1575
1569Il Vostro token di sessione AWS è scaduto o è stato rifiutato. Questo messaggio appare su un 401 da [Claude Platform su AWS](/docs/it/claude-platform-on-aws) o dall'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint), che è come quei provider segnalano un token di sicurezza scaduto.1576Il tuo token di sessione AWS è scaduto o è stato rifiutato. Questo messaggio appare in seguito a 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 è il modo in cui quei provider segnalano un token di sicurezza scaduto.
1570 1577
1571Il suggerimento di azione nel mezzo varia a seconda della Vostra configurazione. La parte stabile è il `AWS credentials expired or invalid` iniziale:1578Il suggerimento di azione nella parte centrale varia in base alla tua configurazione. La parte stabile è l'inizio `AWS credentials expired or invalid`:
1572 1579
1573```text theme={null}1580```text theme={null}
1574AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1581AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
1575```1582```
1576 1583
1577Prima della v2.1.273, questo messaggio appariva solo quando `awsAuthRefresh` era configurato.1584Prima della v2.1.273, questo messaggio appariva solo quando era configurato `awsAuthRefresh`.
1578 1585
1579**Cosa fare:**1586**Cosa fare:**
1580 1587
1581* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l'app che ha lanciato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprovate, o contattate il Vostro amministratore1588* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, la credenziale appartiene all'app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova o contatta il tuo amministratore
1582* Se [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) è impostato, eseguite il comando nominato nel messaggio, come `aws sso login --profile myprofile`, in un altro terminale e completate l'accesso del browser, quindi riprovate. Altrimenti aggiornate la credenziale AWS che utilizzate voi stessi: il Vostro accesso SSO, le chiavi di accesso, la chiave API o il token proxy1589* Se [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) è impostato, esegui il comando indicato nel messaggio, come `aws sso login --profile myprofile`, in un altro terminale e completa l'accesso nel browser, poi riprova. Altrimenti aggiorna tu stesso la credenziale AWS che usi: il tuo accesso SSO, le chiavi di accesso, la chiave API o il token del proxy
1583* Con `awsAuthRefresh` impostato in una sessione interattiva, potete invece eseguire `/login`, scegliere **3rd-party platform**, quindi selezionare **Claude Platform on AWS · refresh credentials** sotto **Using 3rd-party platforms** per eseguire lo stesso comando senza riavviare Claude Code. Vedete [Configurare le credenziali AWS](/docs/it/claude-platform-on-aws#1-configure-aws-credentials)1590* Con `awsAuthRefresh` impostato in una sessione interattiva, puoi invece eseguire `/login`, scegliere **3rd-party platform**, poi selezionare **Claude Platform on AWS · refresh credentials** in **Using 3rd-party platforms** per eseguire lo stesso comando senza riavviare Claude Code. Consulta [Configurare le credenziali AWS](/docs/it/claude-platform-on-aws#1-configure-aws-credentials)
1584* Se l'errore si ripete dopo che il comando di aggiornamento ha avuto successo, confermate che l'identità è valida al di fuori di Claude Code con `aws sts get-caller-identity` nella stessa shell e profilo1591* Se l'errore si ripete dopo che il comando di aggiornamento è riuscito, verifica che l'identità sia valida al di fuori di Claude Code con `aws sts get-caller-identity` nella stessa shell e con lo stesso profilo
1585 1592
1586<h3 id="aws-authentication-failed">1593<h3 id="aws-authentication-failed">
1587 Autenticazione AWS non riuscita1594 Autenticazione AWS non riuscita
1588</h3>1595</h3>
1589 1596
1590Il Vostro provider AWS ha restituito un 403, oppure [Amazon Bedrock](/docs/it/amazon-bedrock) ha restituito un 401.1597Il tuo provider AWS ha restituito un 403, oppure [Amazon Bedrock](/docs/it/amazon-bedrock) ha restituito un 401.
1591 1598
1592Amazon Bedrock segnala un token di sicurezza scaduto come un 403, ma un 403 è anche come segnala un rifiuto di autorizzazione, come un `AccessDeniedException` da un'autorizzazione IAM mancante. Claude Code non può dire quale causa avete colpito.1599Amazon Bedrock segnala un token di sicurezza scaduto come 403, ma un 403 è anche il modo in cui segnala un diniego di autorizzazione, come una `AccessDeniedException` dovuta a un permesso IAM mancante. Claude Code non può distinguere queste due cause.
1593 1600
1594Un 401 da Amazon Bedrock atterra anche qui piuttosto che sotto [Credenziali AWS scadute o non valide](#aws-credentials-expired-or-invalid), perché Amazon Bedrock non segnala un token scaduto come un 401. Un 401 da quell'endpoint di solito proviene da qualcos'altro nel percorso della richiesta, come un proxy aziendale.1601Anche un 401 da Amazon Bedrock finisce qui anziché in [Credenziali AWS scadute o non valide](#aws-credentials-expired-or-invalid), perché Amazon Bedrock non segnala un token scaduto come 401. Un 401 da quell'endpoint proviene in genere da qualcos'altro nel percorso della richiesta, come un proxy aziendale.
1595 1602
1596Un aggiornamento delle credenziali corregge un token scaduto e non può correggere le altre cause, quindi il messaggio offre entrambi:1603Un aggiornamento delle credenziali risolve un token scaduto ma non può risolvere le altre cause, quindi il messaggio propone entrambe le soluzioni:
1597 1604
1598```text theme={null}1605```text theme={null}
1599AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1606AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
1600```1607```
1601 1608
1602Il suggerimento di azione nel mezzo varia a seconda della Vostra configurazione. La parte stabile è il `AWS authentication failed` iniziale.1609Il suggerimento di azione nella parte centrale varia in base alla tua configurazione. La parte stabile è l'inizio `AWS authentication failed`.
1603 1610
1604Quando il 403 è la risposta di Amazon Bedrock che non avete accesso al modello con l'ID modello specificato, il suggerimento invece vi dice di abilitare il modello per il Vostro account e la Vostra regione nella console Amazon Bedrock.1611Quando il 403 è la risposta di Amazon Bedrock che indica che non hai accesso al modello con l'ID modello specificato, il suggerimento ti dice invece di abilitare il modello per il tuo account e la tua regione nella console di Amazon Bedrock.
1605 1612
1606Prima della v2.1.273, questo messaggio appariva solo quando `awsAuthRefresh` era configurato.1613Prima della v2.1.273, questo messaggio appariva solo quando era configurato `awsAuthRefresh`.
1607 1614
1608**Cosa fare:**1615**Cosa fare:**
1609 1616
1610* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l'app che ha lanciato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprovate, o contattate il Vostro amministratore1617* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, la credenziale appartiene all'app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova o contatta il tuo amministratore
1611* Aggiornate le Vostre credenziali AWS nel caso in cui una credenziale scaduta sia la causa: eseguite il comando [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) nominato nel messaggio quando uno è impostato, o aggiornate il Vostro accesso SSO, le chiavi di accesso, la chiave API o il token proxy voi stessi1618* Aggiorna le tue credenziali AWS nel caso in cui la causa sia una credenziale scaduta: esegui il comando [`awsAuthRefresh`](/docs/it/amazon-bedrock#advanced-credential-configuration) indicato nel messaggio quando è impostato, oppure aggiorna tu stesso il tuo accesso SSO, le chiavi di accesso, la chiave API o il token del proxy
1612* 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 la Vostra regione1619* Se le tue credenziali sono aggiornate, verifica che i permessi IAM indicati in [Configurazione IAM](/docs/it/amazon-bedrock#iam-configuration) siano associati all'identità che stai usando e che il modello selezionato sia abilitato per il tuo account e la tua regione
1613* Eseguite `aws sts get-caller-identity` per confermare quale identità le Vostre richieste utilizzano1620* Esegui `aws sts get-caller-identity` per verificare quale identità usano le tue richieste
1614 1621
1615<h3 id="google-cloud-credentials-expired-or-invalid">1622<h3 id="google-cloud-credentials-expired-or-invalid">
1616 Credenziali Google Cloud scadute o non valide1623 Credenziali Google Cloud scadute o non valide
1617</h3>1624</h3>
1618 1625
1619Le Vostre credenziali Google Cloud per [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) sono scadute o sono state rifiutate: la richiesta ha restituito un 401, che è come Agent Platform segnala la scadenza delle credenziali.1626Le tue credenziali Google Cloud per [Agent Platform di Google Cloud](/docs/it/google-vertex-ai) sono scadute o sono state rifiutate: la richiesta ha restituito un 401, che è il modo in cui Agent Platform segnala la scadenza delle credenziali.
1620 1627
1621Il suggerimento di azione nel mezzo varia a seconda della Vostra configurazione. La parte stabile è il `Google Cloud credentials expired or invalid` iniziale:1628Il suggerimento di azione nella parte centrale varia in base alla tua configurazione. La parte stabile è l'inizio `Google Cloud credentials expired or invalid`:
1622 1629
1623```text theme={null}1630```text theme={null}
1624Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1631Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
1626 1633
1627**Cosa fare:**1634**Cosa fare:**
1628 1635
1629* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l'app che ha lanciato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprovate, o contattate il Vostro amministratore1636* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, la credenziale appartiene all'app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova o contatta il tuo amministratore
1630* Se vi autenticate con le credenziali predefinite dell'applicazione, eseguite il comando [`gcpAuthRefresh`](/docs/it/google-vertex-ai#advanced-credential-configuration) nominato nel messaggio, o `gcloud auth application-default login`, e completate l'accesso, quindi riprovate1637* Se ti autentichi con le credenziali predefinite dell'applicazione, esegui il comando [`gcpAuthRefresh`](/docs/it/google-vertex-ai#advanced-credential-configuration) indicato nel messaggio, oppure `gcloud auth application-default login`, e completa l'accesso, poi riprova
1631* Se instradare attraverso un [gateway LLM](/docs/it/llm-gateway) con `CLAUDE_CODE_SKIP_VERTEX_AUTH` impostato, aggiornate il token del gateway in `ANTHROPIC_AUTH_TOKEN` o `ANTHROPIC_CUSTOM_HEADERS`, quindi riprovate1638* Se instradi il traffico tramite un [gateway LLM](/docs/it/llm-gateway) con `CLAUDE_CODE_SKIP_VERTEX_AUTH` impostata, aggiorna il token del gateway in `ANTHROPIC_AUTH_TOKEN` o `ANTHROPIC_CUSTOM_HEADERS`, poi riprova
1632* Se vi autenticate con un file di chiave dell'account di servizio, confermate che `GOOGLE_APPLICATION_CREDENTIALS` punti a una chiave valida. Vedete [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials)1639* Se ti autentichi con un file di chiave di un account di servizio, verifica che `GOOGLE_APPLICATION_CREDENTIALS` punti a una chiave valida. Consulta [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials)
1633* Se l'errore si ripete dopo un aggiornamento, confermate che l'identità funziona al di fuori di Claude Code con `gcloud auth application-default print-access-token` nella stessa shell1640* Se l'errore si ripete dopo un aggiornamento, verifica che l'identità funzioni al di fuori di Claude Code con `gcloud auth application-default print-access-token` nella stessa shell
1634 1641
1635Prima della v2.1.273, un 401 da Agent Platform mostrava il messaggio generico `Please run /login` o `Failed to authenticate` invece, che non può aggiornare le credenziali Google Cloud.1642Prima della v2.1.273, un 401 da Agent Platform mostrava invece il messaggio generico `Please run /login` o `Failed to authenticate`, che non può aggiornare le credenziali Google Cloud.
1636 1643
1637<h3 id="google-cloud-authentication-failed">1644<h3 id="google-cloud-authentication-failed">
1638 Autenticazione Google Cloud non riuscita1645 Autenticazione Google Cloud non riuscita
1639</h3>1646</h3>
1640 1647
1641[Agent Platform di Google Cloud](/docs/it/google-vertex-ai) ha restituito un 403, che utilizza per i rifiuti di autorizzazione piuttosto che per le credenziali scadute. Di solito l'identità con cui vi autenticate manca di un'autorizzazione IAM, oppure il modello non è abilitato per il Vostro progetto.1648[Agent Platform di Google Cloud](/docs/it/google-vertex-ai) ha restituito un 403, che usa per i dinieghi di autorizzazione e non per le credenziali scadute. Di solito all'identità con cui ti autentichi manca un permesso IAM, oppure il modello non è abilitato per il tuo progetto.
1642 1649
1643Il suggerimento di azione nel mezzo varia a seconda della Vostra configurazione. La parte stabile è il `Google Cloud authentication failed` iniziale:1650Il suggerimento di azione nella parte centrale varia in base alla tua configurazione. La parte stabile è l'inizio `Google Cloud authentication failed`:
1644 1651
1645```text theme={null}1652```text theme={null}
1646Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1653Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
1648 1655
1649**Cosa fare:**1656**Cosa fare:**
1650 1657
1651* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l'app che ha lanciato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprovate, o contattate il Vostro amministratore1658* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, la credenziale appartiene all'app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova o contatta il tuo amministratore
1652* Confermate che i ruoli in [Configurazione IAM](/docs/it/google-vertex-ai#iam-configuration) siano concessi all'identità con cui vi autenticate1659* Verifica che i ruoli indicati in [Configurazione IAM](/docs/it/google-vertex-ai#iam-configuration) siano concessi all'identità con cui ti autentichi
1653* Confermate che il modello sia abilitato per il Vostro progetto. Vedete [Richiedere l'accesso al modello](/docs/it/google-vertex-ai#2-request-model-access)1660* Verifica che il modello sia abilitato per il tuo progetto. Consulta [Richiedere l'accesso al modello](/docs/it/google-vertex-ai#2-request-model-access)
1654 1661
1655Prima della v2.1.273, un 403 da Agent Platform mostrava il messaggio generico `Please run /login` o `Failed to authenticate` invece, che non può aggiornare le credenziali Google Cloud.1662Prima della v2.1.273, un 403 da Agent Platform mostrava invece il messaggio generico `Please run /login` o `Failed to authenticate`, che non può aggiornare le credenziali Google Cloud.
1656 1663
1657<h3 id="microsoft-foundry-authentication-failed">1664<h3 id="microsoft-foundry-authentication-failed">
1658 Autenticazione Microsoft Foundry non riuscita1665 Autenticazione Microsoft Foundry non riuscita
1659</h3>1666</h3>
1660 1667
1661[Microsoft Foundry](/docs/it/microsoft-foundry) ha restituito un 401 o 403: la credenziale Azure sulla richiesta è stata rifiutata, oppure l'identità dietro di essa non ha accesso alla risorsa Foundry. `/login` non può coniare credenziali Azure. Il suggerimento di azione nel mezzo varia a seconda della Vostra configurazione. La parte stabile è il `Microsoft Foundry authentication failed` iniziale:1668[Microsoft Foundry](/docs/it/microsoft-foundry) ha restituito un 401 o un 403: la credenziale Azure nella richiesta è stata rifiutata, oppure l'identità associata non ha accesso alla risorsa Foundry. `/login` non può generare credenziali Azure. Il suggerimento di azione al centro varia in base alla tua configurazione. La parte stabile è quella iniziale, `Microsoft Foundry authentication failed`:
1662 1669
1663```text theme={null}1670```text theme={null}
1664Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1671Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
1666 1673
1667**Cosa fare:**1674**Cosa fare:**
1668 1675
1669* Se il suggerimento dice che le credenziali sono gestite da questo ambiente, l'app che ha lanciato Claude Code possiede la credenziale e gli altri passaggi qui non si applicano: riprovate, o contattate il Vostro amministratore1676* Se il suggerimento indica che le credenziali sono gestite da questo ambiente, la credenziale appartiene all'app che ha avviato Claude Code e gli altri passaggi qui non si applicano: riprova oppure contatta il tuo amministratore
1670* Aggiornate la credenziale che avete configurato in [Configurare le credenziali Azure](/docs/it/microsoft-foundry#2-configure-azure-credentials): ruotate `ANTHROPIC_FOUNDRY_API_KEY`, coniate un `ANTHROPIC_FOUNDRY_AUTH_TOKEN` fresco, o eseguite `az login` in modo che la catena di credenziali Microsoft Entra predefinita possa accedere di nuovo1677* Aggiorna la credenziale che hai configurato in [Configurare le credenziali Azure](/docs/it/microsoft-foundry#2-configure-azure-credentials): ruota `ANTHROPIC_FOUNDRY_API_KEY`, genera un nuovo `ANTHROPIC_FOUNDRY_AUTH_TOKEN` oppure esegui `az login` in modo che la catena di credenziali predefinita di Microsoft Entra possa accedere di nuovo
1671* Se la credenziale è attuale, confermate che l'identità ha accesso alla risorsa Foundry. Vedete [Configurazione RBAC di Azure](/docs/it/microsoft-foundry#azure-rbac-configuration)1678* Se la credenziale è aggiornata, verifica che l'identità abbia accesso alla risorsa Foundry. Consulta [Configurazione di Azure RBAC](/docs/it/microsoft-foundry#azure-rbac-configuration)
1672 1679
1673Prima della v2.1.273, un 401 o 403 da Microsoft Foundry mostrava il messaggio generico `Please run /login` o `Failed to authenticate` invece, che non può aggiornare le credenziali Azure.1680Prima della v2.1.273, un 401 o un 403 da Microsoft Foundry mostrava invece il messaggio generico `Please run /login` o `Failed to authenticate`, che non può aggiornare le credenziali Azure.
1674 1681
1675<h3 id="could-not-load-aws-or-google-cloud-credentials">1682<h3 id="could-not-load-aws-or-google-cloud-credentials">
1676 Impossibile caricare le credenziali AWS o Google Cloud1683 Impossibile caricare le credenziali AWS o Google Cloud
1677</h3>1684</h3>
1678 1685
1679Claude Code non ha potuto ottenere credenziali utilizzabili dalla catena del provider di credenziali AWS o dalle Vostre credenziali predefinite dell'applicazione Google sulla macchina su cui viene eseguito, quindi nessuna richiesta ha raggiunto il Vostro provider cloud. Claude Code cancella le Vostre credenziali memorizzate nella cache e ritenta due volte prima di mostrare questo messaggio. Il dettaglio dopo il `·` nomina la causa specifica, come una sessione SSO scaduta, credenziali predefinite mancanti segnalate come `Could not load the default credentials`, o un accesso revocato segnalato come `invalid_grant`:1686Claude Code non è riuscito a ottenere credenziali utilizzabili dalla catena di provider di credenziali AWS o dalle credenziali predefinite dell'applicazione Google sulla macchina su cui è in esecuzione, quindi nessuna richiesta ha raggiunto il tuo provider cloud. Claude Code cancella le credenziali memorizzate nella cache e riprova due volte prima di mostrare questo messaggio. Il dettaglio dopo il `·` indica la causa specifica, come una sessione SSO scaduta, credenziali predefinite dell'applicazione mancanti segnalate come `Could not load the default credentials`, oppure un accesso revocato segnalato come `invalid_grant`:
1680 1687
1681```text theme={null}1688```text theme={null}
1682API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1689API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1683API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.1690API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1684```1691```
1685 1692
1686In [modalità non interattiva](/docs/it/headless) con `-p` e in [Agent SDK](/docs/it/agent-sdk/overview), il codice di errore strutturato è `cloud_credential_error`. Prima della v2.1.267, il messaggio mostrava solo il testo di dettaglio dopo `API Error:`, e il codice strutturato era `server_error` o `unknown`.1693In [modalità non interattiva](/docs/it/headless) con `-p` e nell'[Agent SDK](/docs/it/agent-sdk/overview), il codice di errore strutturato è `cloud_credential_error`. Prima della v2.1.267, il messaggio mostrava solo il testo di dettaglio dopo `API Error:` e il codice strutturato era `server_error` o `unknown`.
1687 1694
1688**Cosa fare:**1695**Cosa fare:**
1689 1696
1690* Eseguite il comando di accesso del Vostro provider, come `aws sso login --profile myprofile` o `gcloud auth application-default login`, quindi riprovate. [Credenziali Bedrock, Agent Platform o Foundry non si caricano](/docs/it/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra come confermare le credenziali al di fuori di Claude Code1697* Esegui il comando di accesso del tuo provider, come `aws sso login --profile myprofile` o `gcloud auth application-default login`, quindi riprova. [Credenziali Bedrock, Agent Platform o Foundry non caricate](/docs/it/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) mostra come verificare le credenziali al di fuori di Claude Code
1691* Se il dettaglio legge `AWS default-chain credential resolve timed out`, la catena si è bloccata piuttosto che fallire, quindi seguite [Timeout della risoluzione delle credenziali della catena predefinita AWS](#aws-default-chain-credential-resolve-timed-out) invece1698* Se il dettaglio riporta `AWS default-chain credential resolve timed out`, la catena si è bloccata anziché fallire, quindi segui invece [Timeout nella risoluzione delle credenziali della catena predefinita AWS](#aws-default-chain-credential-resolve-timed-out)
1692 1699
1693<h3 id="aws-default-chain-credential-resolve-timed-out">1700<h3 id="aws-default-chain-credential-resolve-timed-out">
1694 Timeout della risoluzione delle credenziali della catena predefinita AWS1701 Timeout nella risoluzione delle credenziali della catena predefinita AWS
1695</h3>1702</h3>
1696 1703
1697La catena del provider di credenziali predefinite AWS non ha prodotto credenziali entro 60 secondi, quindi Claude Code ha fermato la risoluzione e ha fallito la richiesta. Questo timeout è una causa di [Impossibile caricare le credenziali AWS o Google Cloud](#could-not-load-aws-or-google-cloud-credentials). L'errore è la risoluzione delle credenziali locali: la richiesta non ha mai raggiunto [Amazon Bedrock](/docs/it/amazon-bedrock), [Claude Platform su AWS](/docs/it/claude-platform-on-aws) o l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Claude Code cancella la Vostra [cache delle credenziali](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout) e ritenta prima che questo errore emerga, quindi al momento in cui lo vedete la catena si è bloccata su tentativi ripetuti.1704La catena di provider di credenziali predefinita AWS non ha prodotto credenziali entro 60 secondi, quindi Claude Code ha interrotto la risoluzione e fatto fallire la richiesta. Questo timeout è una delle cause di [Impossibile caricare le credenziali AWS o Google Cloud](#could-not-load-aws-or-google-cloud-credentials). Il problema riguarda 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 sua [cache delle credenziali](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout) e riprova prima che venga mostrato questo errore, quindi quando lo vedi la catena si è bloccata in più tentativi.
1698 1705
1699```text theme={null}1706```text theme={null}
1700API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1707API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1701```1708```
1702 1709
1703Le cause comuni sono un comando `credential_process` nel Vostro profilo AWS che attende un input che non può ricevere, e un contenitore o una VM il cui servizio di metadati dell'istanza (IMDS) non risponde mai al probe della catena.1710Le cause comuni sono un comando `credential_process` nel tuo profilo AWS che attende un input che non può ricevere, e un container o una VM il cui servizio di metadati dell'istanza (IMDS) non risponde mai alla verifica della catena.
1704 1711
1705Prima della v2.1.267, il messaggio leggeva `API Error: AWS default-chain credential resolve timed out`.1712Prima della v2.1.267, il messaggio era `API Error: AWS default-chain credential resolve timed out`.
1706Prima della v2.1.207, una catena bloccata lasciava la richiesta in attesa indefinitamente invece di fallire.1713Prima della v2.1.207, una catena bloccata lasciava la richiesta in attesa indefinitamente anziché farla fallire.
1707 1714
1708**Cosa fare:**1715**Cosa fare:**
1709 1716
1710* 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.1717* Esegui `aws sts get-caller-identity` nella stessa shell con lo stesso `AWS_PROFILE`. Se anche questo si blocca, correggi il profilo; un comando `credential_process` che chiede un input in modo interattivo è una causa comune.
1711* 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 browser1718* Completa il passaggio di accesso prima di avviare Claude Code, ad esempio `aws sso login --profile myprofile`
1712* Se la Vostra catena esegue un accesso interattivo che legittimamente ha bisogno 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)1719* Se la tua catena esegue un accesso interattivo che richiede legittimamente più di 60 secondi, come SSO con MFA tramite un wrapper come `aws-vault`, aumenta il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars)
1713 1720
1714<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1721<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1715 Timeout della verifica della configurazione di Bedrock in attesa di AWS1722 Timeout della verifica della configurazione di Bedrock in attesa di AWS
1716</h3>1723</h3>
1717 1724
1718Una chiamata ad AWS durante la [procedura guidata di configurazione di Bedrock](/docs/it/amazon-bedrock#sign-in-with-bedrock), come la ricerca delle credenziali o il controllo dell'identità, non è stata completata entro il limite di 60 secondi. La procedura guidata smette di attendere e fallisce il passaggio di verifica:1725Una chiamata ad AWS durante la verifica delle credenziali della [procedura guidata di configurazione di Bedrock](/docs/it/amazon-bedrock#sign-in-with-bedrock), come la ricerca delle credenziali o il controllo dell'identità, non è stata completata entro il limite di 60 secondi. La procedura guidata smette di attendere e fa fallire il passaggio di verifica:
1719 1726
1720```text theme={null}1727```text theme={null}
1721Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1728Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
1722```1729```
1723 1730
1724Il numero riflette il Vostro limite: 60 secondi per impostazione predefinita, o il valore che impostate in [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars).1731Il numero riflette il tuo limite: 60 secondi per impostazione predefinita, oppure il valore che hai impostato in [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars).
1725 1732
1726Le cause comuni sono una rete o un proxy che blocca le richieste ad AWS, incluso l'aggiornamento del token SSO, e un helper di credenziali ancora in attesa di input che non potete vedere. Aumentate il limite solo quando l'helper legittimamente ha bisogno di più tempo.1733Le cause comuni sono una rete o un proxy che blocca le richieste ad AWS, incluso l'aggiornamento del token SSO, e un helper delle credenziali ancora in attesa di un input che non puoi vedere. Aumenta il limite solo quando l'helper ha legittimamente bisogno di più tempo.
1727 1734
1728Una singola richiesta bloccata ad AWS può anche fallire sul suo timeout per richiesta, che mostra un messaggio più breve sullo stesso passaggio:1735Anche una singola richiesta bloccata ad AWS può fallire per il proprio timeout per richiesta, che mostra un messaggio più breve nello stesso passaggio:
1729 1736
1730```text theme={null}1737```text theme={null}
1731A request to AWS timed out. Check your network and proxy settings, then try again.1738A request to AWS timed out. Check your network and proxy settings, then try again.
1732```1739```
1733 1740
1734Quando gli stessi timeout si verificano sul passaggio di pin del modello, la procedura guidata contrassegna un modello come `unreachable` invece di mostrare uno dei due messaggi.1741Quando gli stessi timeout si verificano nel passaggio di fissaggio del modello, la procedura guidata contrassegna un modello come `unreachable` anziché mostrare uno dei due messaggi.
1735 1742
1736**Cosa fare:**1743**Cosa fare:**
1737 1744
1738* Eseguite `aws sts get-caller-identity` nella stessa shell. Se si blocca anche, il blocco è al di fuori di Claude Code, nella Vostra rete, nel Vostro proxy o nell'helper di credenziali nel Vostro profilo AWS; correggete prima quello.1745* Esegui `aws sts get-caller-identity` nella stessa shell. Se anche questo si blocca, il blocco è al di fuori di Claude Code, nella tua rete, nel tuo proxy o nell'helper delle credenziali nel tuo profilo AWS; risolvi prima quello.
1739* Completate qualsiasi accesso interattivo prima di aprire la procedura guidata, ad esempio `aws sso login --profile myprofile`1746* Completa qualsiasi accesso interattivo prima di aprire la procedura guidata, ad esempio `aws sso login --profile myprofile`
1740* Se un helper di credenziali nel Vostro profilo AWS legittimamente ha bisogno di più di 60 secondi per richiedervi, aumentate il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars)1747* Se un helper delle credenziali nel tuo profilo AWS ha legittimamente bisogno di più di 60 secondi per chiederti un input, aumenta il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars)
1741 1748
1742<h3 id="cloud-gateway-session-expired">1749<h3 id="cloud-gateway-session-expired">
1743 Sessione del gateway cloud scaduta1750 Sessione del gateway cloud scaduta
1744</h3>1751</h3>
1745 1752
1746Vi siete acceduti attraverso un [gateway delle app Claude](/docs/it/claude-apps-gateway), e la sessione del gateway salvata su questa macchina è scaduta e non ha potuto essere rinnovata, oppure il gateway non la accetta più, ad esempio dopo che il [JWT secret del gateway è stato sostituito](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation). Se vedete questa riga quando avviate `claude` in modo interattivo, la sessione si è aperta disconnessa dal gateway:1753Hai eseguito l'accesso tramite un [gateway delle app Claude](/docs/it/claude-apps-gateway) e la sessione del gateway salvata su questa macchina è scaduta e non è stato possibile rinnovarla, oppure il gateway non la accetta più, ad esempio dopo che il [segreto JWT del gateway è stato sostituito](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation). Se vedi questa riga quando avvii `claude` in modo interattivo, la sessione si è aperta senza accesso al gateway:
1747 1754
1748```text theme={null}1755```text theme={null}
1749Cloud gateway session expired — run /login to reconnect.1756Cloud gateway session expired — run /login to reconnect.
1750```1757```
1751 1758
1752La stessa riga può apparire a metà sessione quando la credenziale del gateway scade e Claude Code non può rinnovarla.1759La stessa riga può comparire a metà sessione quando la credenziale del gateway scade e Claude Code non riesce a rinnovarla.
1753 1760
1754In un'esecuzione [non interattiva](/docs/it/headless), una sessione in background o altra sessione incustodita, o un sottocomando `claude` diverso da `claude auth`, Claude Code esce con questo messaggio invece quando il gateway non accetta più la sessione:1761In un'esecuzione [non interattiva](/docs/it/headless), in una sessione in background o comunque non presidiata, oppure in un sottocomando `claude` diverso da `claude auth`, Claude Code termina invece con questo messaggio quando il gateway non accetta più la sessione:
1755 1762
1756```text theme={null}1763```text theme={null}
1757Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1764Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1759 1766
1760**Cosa fare:**1767**Cosa fare:**
1761 1768
1762* Eseguite `/login` nella sessione e completate l'accesso del browser1769* Esegui `/login` nella sessione e completa l'accesso nel browser
1763* Per un lancio non interattivo, avviate `claude` nello stesso ambiente, eseguite `/login`, quindi rieseguite il Vostro comando1770* Per un avvio non interattivo, avvia `claude` nello stesso ambiente, esegui `/login`, quindi esegui di nuovo il tuo comando
1764 1771
1765<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1772<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1766 Sign-in scaduto mentre vi aspettava di continuare1773 Accesso scaduto durante l'attesa della tua conferma
1767</h3>1774</h3>
1768 1775
1769Durante un [accesso al gateway delle app Claude](/docs/it/claude-apps-gateway), il gateway ha nominato l'account che ha effettuato l'accesso, e Claude Code vi ha chiesto di confermarlo prima di salvare la credenziale. Avete lasciato la conferma aperta oltre la scadenza dell'accesso stesso, e il gateway non ha emesso alcun token di aggiornamento che potesse rinnovarlo, quindi Claude Code non ha memorizzato nulla quando avete continuato:1776Durante un accesso tramite un [gateway delle app Claude](/docs/it/claude-apps-gateway), il gateway ha indicato l'account che ha eseguito l'accesso e Claude Code ti ha chiesto di confermarlo prima di salvare la credenziale. Hai lasciato la conferma aperta oltre la scadenza dell'accesso stesso e il gateway non ha emesso alcun token di aggiornamento in grado di rinnovarlo, quindi Claude Code non ha memorizzato nulla quando hai continuato:
1770 1777
1771```text theme={null}1778```text theme={null}
1772Sign-in timed out while waiting for you to continue. Try again.1779Sign-in timed out while waiting for you to continue. Try again.
1774 1781
1775**Cosa fare:**1782**Cosa fare:**
1776 1783
1777* Eseguite `/login` di nuovo e confermate l'account prima che l'accesso scada1784* Esegui di nuovo `/login` e conferma l'account prima che l'accesso scada
1778 1785
1779<h3 id="gateway-refused-the-request">1786<h3 id="gateway-refused-the-request">
1780 Il gateway ha rifiutato la richiesta1787 Il gateway ha rifiutato la richiesta
1781</h3>1788</h3>
1782 1789
1783Siete connessi attraverso un [gateway delle app Claude](/docs/it/claude-apps-gateway), e una richiesta ha restituito un 403: il gateway, o l'upstream dietro di esso, l'ha rifiutata. L'accesso di nuovo non cambia un rifiuto, quindi il messaggio punta al Vostro amministratore del gateway:1790Hai eseguito l'accesso tramite un [gateway delle app Claude](/docs/it/claude-apps-gateway) e una richiesta ha restituito un 403: il gateway, o il servizio upstream dietro di esso, l'ha rifiutata. Accedere di nuovo non cambia un rifiuto, quindi il messaggio rimanda all'amministratore del tuo gateway:
1784 1791
1785```text theme={null}1792```text theme={null}
1786Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1793Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1788 1795
1789**Cosa fare:**1796**Cosa fare:**
1790 1797
1791* Chiedete al Vostro amministratore del gateway di cercare la richiesta. La coda `API Error:` trasporta il rifiuto che il gateway ha restituito1798* Chiedi all'amministratore del tuo gateway di esaminare la richiesta. La parte finale `API Error:` contiene il rifiuto restituito dal gateway
1792* Per gli amministratori: una [regola di controllo dell'accesso](/docs/it/claude-apps-gateway-config#http-tuning) sul gateway restituisce un 403 che il [log di audit](/docs/it/claude-apps-gateway-deploy#logs) registra con il suo motivo, e un rifiuto di autorizzazione dell'upstream passa attraverso per [Messaggi di errore dell'upstream](/docs/it/claude-apps-gateway-config#upstream-error-messages)1799* Per gli amministratori: una [regola di controllo degli accessi](/docs/it/claude-apps-gateway-config#http-tuning) sul gateway restituisce un 403 che il [log di audit](/docs/it/claude-apps-gateway-deploy#logs) registra insieme al motivo, e un rifiuto di autorizzazione di un servizio upstream viene inoltrato come descritto in [Messaggi di errore upstream](/docs/it/claude-apps-gateway-config#upstream-error-messages)
1793 1800
1794Prima della v2.1.273, un 403 su una sessione del gateway mostrava il messaggio generico `Please run /login` o `Failed to authenticate` invece, e l'accesso di nuovo non cancellava il rifiuto.1801Prima della v2.1.273, un 403 su una sessione del gateway mostrava invece il messaggio generico `Please run /login` o `Failed to authenticate`, e accedere di nuovo non eliminava il rifiuto.
1795 1802
1796<h2 id="network-and-connection-errors">1803<h2 id="network-and-connection-errors">
1797 Errori di rete e connessione1804 Errori di rete e connessione
2849* Eseguire `claude doctor` dalla shell per la diagnostica dell'installazione2856* Eseguire `claude doctor` dalla shell per la diagnostica dell'installazione
2850 2857
2851<h2 id="command-line-errors">2858<h2 id="command-line-errors">
2852 Errori da riga di comando2859 Errori della riga di comando
2853</h2>2860</h2>
2854 2861
2855Questi errori provengono dal comando `claude` da riga di comando e dai suoi sottocomandi, da un nome di comando che invii al prompt e da comandi come `/security-review` che raccolgono il contesto eseguendo comandi shell prima dell'esecuzione del loro prompt. Provengono anche da `/tui`, che riavvia la CLI.2862Questi errori provengono dalla riga di comando `claude` e dai suoi sottocomandi, da un nome di comando che invii al prompt e da comandi come `/security-review` che raccolgono il contesto eseguendo comandi della shell prima che il loro prompt venga eseguito. Provengono anche da `/tui`, che riavvia la CLI.
2856 2863
2857<h3 id="conflict-between-bg-and-print">2864<h3 id="conflict-between-bg-and-print">
2858 Conflitto tra `--bg` e `--print`2865 Conflitto tra `--bg` e `--print`
2859</h3>2866</h3>
2860 2867
2861Questo 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 lavoro in background che non poteva mai essere collegato.2868Questo messaggio richiede Claude Code v2.1.198 o versioni successive. Hai 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 ti colleghi in seguito con `claude agents`, mentre `--print` viene eseguito in [modalità non interattiva](/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 a cui non era mai possibile collegarsi.
2862 2869
2863```text theme={null}2870```text theme={null}
2864--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>'`.2871--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>'`.
2866 2873
2867**Cosa fare:**2874**Cosa fare:**
2868 2875
2869* Eliminate `-p` o `--print`. `--bg` accetta il prompt come argomento posizionale, quindi `claude --bg "<task>"` è il comando completo. Vedete [Dispatch new agents from your shell](/docs/it/agent-view#from-your-shell).2876* Rimuovi `-p` o `--print`. `--bg` accetta il prompt come argomento posizionale, quindi `claude --bg "<task>"` è il comando completo. Consulta [Avvia nuovi agenti dalla tua shell](/docs/it/agent-view#from-your-shell).
2870* 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>"`2877* Per eseguire il prompt in modalità non interattiva e stampare il risultato invece di creare una sessione in background, rimuovi `--bg` ed esegui `claude -p "<task>"`
2878
2879<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2880 Conflitto tra un flag del prompt di sistema e la sua forma file
2881</h3>
2882
2883Hai passato [`--append-subagent-system-prompt`](/docs/it/cli-reference#cli-flags) insieme a `--append-subagent-system-prompt-file` in un'unica invocazione di `claude`, quindi `claude` termina con codice di uscita 1 invece di avviare la sessione:
2884
2885```text theme={null}
2886Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2887```
2888
2889Prima della v2.1.283, `claude` terminava allo stesso modo quando passavi `--system-prompt` con `--system-prompt-file`, oppure `--append-system-prompt` con `--append-system-prompt-file`, perché quelle coppie andavano in conflitto invece di [combinarsi](/docs/it/cli-reference#system-prompt-flags). In quelle versioni il messaggio indica la coppia che hai combinato.
2890
2891**Cosa fare:**
2892
2893* Mantieni una forma del flag e rimuovi l'altra. Per combinare un file di prompt fisso con testo specifico per ogni esecuzione, unisci il testo nel file prima dell'avvio invece di passare entrambi i flag
2871 2894
2872<h3 id="invalid-agents-configuration">2895<h3 id="invalid-agents-configuration">
2873 Configurazione `--agents` non valida2896 Configurazione `--agents` non valida
2874</h3>2897</h3>
2875 2898
2876Il valore che avete passato a `--agents` non è valido, quindi `claude` esce con codice 1 invece di avviare la sessione. Quando passate `--safe-mode` o impostate [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars#variables), Claude Code ignora completamente `--agents`. Con `--resume` o `--continue`, un valore JSON inline non viene controllato e la sessione si avvia; un valore letto da un file viene controllato ad ogni avvio. Prima della v2.1.242, Claude Code avviava comunque la sessione.2899Il valore che hai passato a `--agents` non è valido, quindi `claude` termina con codice di uscita 1 invece di avviare la sessione. Quando passi `--safe-mode` o imposti [`CLAUDE_CODE_SAFE_MODE`](/docs/it/env-vars#variables), Claude Code ignora completamente `--agents`. Con `--resume` o `--continue`, un valore JSON inline non viene controllato e la sessione si avvia; un valore letto da un file viene controllato a ogni avvio. Prima della v2.1.242, Claude Code avviava comunque la sessione.
2877 2900
2878```text theme={null}2901```text theme={null}
2879Error: Invalid --agents configuration:2902Error: Invalid --agents configuration:
2880<what failed>2903<what failed>
2881```2904```
2882 2905
2883Quello che segue la prima riga dipende da come il valore ha fallito. Claude Code esegue questi controlli in ordine e si ferma al primo che fallisce. Se il vostro valore ha due tipi di problema, vedete il secondo solo dopo aver corretto il primo:2906Ciò che segue la prima riga dipende da come il valore non è riuscito. Claude Code esegue questi controlli in ordine e si ferma al primo che fallisce. Se il tuo valore ha due tipi di problema, vedi il secondo solo dopo aver corretto il primo:
2884 2907
28851. Quando il valore inizia con `{` ma non viene analizzato come JSON, o il contenuto di un file `--agents` non viene analizzato, Claude Code stampa una riga `invalid JSON:` con il messaggio del parser JSON stesso29081. Quando il valore inizia con `{` ma non viene analizzato come JSON, oppure il contenuto di un file `--agents` non viene analizzato, Claude Code stampa una riga `invalid JSON:` che riporta il messaggio del parser JSON stesso
28862. Quando viene analizzato ma una definizione di agente non corrisponde allo schema per [subagenti definiti da CLI](/docs/it/sub-agents#choose-the-subagent-scope), Claude Code stampa una riga per problema29092. Quando viene analizzato ma una definizione di agente non corrisponde allo schema per i [subagent definiti dalla CLI](/docs/it/sub-agents#choose-the-subagent-scope), Claude Code stampa una riga per ogni problema
28873. Quando un nome di agente inizia con `-`, Claude Code stampa `<name>: agent names must not start with '-'`29103. Quando il nome di un agente inizia con `-`, Claude Code stampa `<name>: agent names must not start with '-'`
2888 2911
2889Quando ci sono più di 20 righe di problema, Claude Code stampa le prime 20 e sostituisce il resto con `…and N more`.2912Quando ci sono più di 20 righe di problemi, Claude Code stampa le prime 20 e sostituisce le restanti con `…and N more`.
2890 2913
2891Con `--print`, `--agents` accetta anche [il percorso di un file JSON](/docs/it/sub-agents#choose-the-subagent-scope) al posto dell'oggetto inline. Prima della v2.1.281, `--agents` accettava solo JSON inline e trattava un percorso di file come JSON non valido. La forma di file ha i suoi rifiuti, stampati al posto di questo messaggio, inclusi questi:2914Con `--print`, `--agents` accetta anche [il percorso di un file JSON](/docs/it/sub-agents#choose-the-subagent-scope) al posto dell'oggetto inline. Prima della v2.1.281, `--agents` accettava solo JSON inline e trattava un percorso di file come JSON non valido. La forma file ha i propri rifiuti, stampati al posto di questo messaggio, tra cui questi:
2892 2915
2893* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code ha letto il valore come percorso di file in una sessione interattiva. Passate le definizioni come JSON inline, oppure aggiungete `-p` per leggerle da un file.2916* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code ha letto il valore come percorso di file in una sessione interattiva. Passa le definizioni come JSON inline, oppure aggiungi `-p` per leggerle da un file.
2894* **`Error: --agents file not found: <path>`**: nessun file esiste in quel percorso. Un valore che non inizia con `{` e non è JSON valido viene letto come percorso, quindi JSON inline che la vostra shell ha danneggiato può fallire in questo modo. Controllate il percorso o le virgolette e eseguite di nuovo il comando.2917* **`Error: --agents file not found: <path>`**: non esiste alcun file in quel percorso. Un valore che non inizia con `{` e non è JSON valido viene letto come percorso, quindi anche un JSON inline alterato dalla tua shell può fallire in questo modo. Controlla il percorso o le virgolette ed esegui di nuovo il comando.
2895 2918
2896**Cosa fare:**2919**Cosa fare:**
2897 2920
2898* Correggete ogni problema che il messaggio elenca, quindi eseguite di nuovo il comando. Vedete [i campi che un subagente definito da CLI accetta](/docs/it/sub-agents#choose-the-subagent-scope).2921* Correggi ogni problema elencato nel messaggio, quindi esegui di nuovo il comando. Consulta [i campi accettati da un subagent definito dalla CLI](/docs/it/sub-agents#choose-the-subagent-scope).
2899 2922
2900<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2923<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2901 Le sessioni cloud non possono essere create da una sessione `--restricted`2924 Le sessioni cloud non possono essere create da una sessione `--restricted`
2902</h3>2925</h3>
2903 2926
2904Quando avviate una sessione con [`--restricted`](/docs/it/cli-reference#cli-flags), Claude Code rifiuta di creare [sessioni cloud](/docs/it/claude-code-on-the-web#from-terminal-to-cloud) da essa, perché la nuova sessione verrebbe eseguita al di fuori del processo ristretto e non farebbe rispettare la modalità ristretta. Claude Code rifiuta dal client, prima di contattare il server, quindi nessuna sessione cloud viene creata:2927Quando avvii una sessione con [`--restricted`](/docs/it/cli-reference#cli-flags), Claude Code si rifiuta di creare [sessioni cloud](/docs/it/claude-code-on-the-web#from-terminal-to-cloud) a partire da essa, perché la nuova sessione verrebbe eseguita al di fuori del processo con restrizioni e non applicherebbe la modalità con restrizioni. Claude Code rifiuta sul client, prima di contattare il server, quindi non viene creata alcuna sessione cloud:
2905 2928
2906```text theme={null}2929```text theme={null}
2907Cloud sessions cannot be created from a --restricted session: they would not enforce it.2930Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2909 2932
2910**Cosa fare:**2933**Cosa fare:**
2911 2934
2912* Eseguite l'attività localmente nella sessione ristretta2935* Esegui l'attività localmente nella sessione con restrizioni
2913* Se controllate come è stata avviata la sessione, avviate una nuova sessione `claude` senza `--restricted` e create la sessione cloud da lì2936* Se controlli il modo in cui è stata avviata la sessione, avvia una nuova sessione `claude` senza `--restricted` e crea la sessione cloud da lì
2914 2937
2915Prima della v2.1.248, Claude Code non aveva il flag `--restricted`; le versioni precedenti rifiutano il flag stesso con un errore di opzione sconosciuta.2938Prima della v2.1.248, Claude Code non aveva il flag `--restricted`; le versioni precedenti rifiutano il flag stesso con un errore di opzione sconosciuta.
2916 2939
2917<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2940<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">
2918 Le sessioni cloud sono disabilitate dalla politica della vostra organizzazione2941 Le sessioni cloud sono disabilitate dalla policy della tua organizzazione
2919</h3>2942</h3>
2920 2943
2921La politica `allow_remote_sessions` della vostra organizzazione è disattivata, quindi [le sessioni cloud](/docs/it/claude-code-on-the-web) e i comandi che le utilizzano non sono disponibili:2944La policy `allow_remote_sessions` della tua organizzazione è disattivata, quindi le [sessioni cloud](/docs/it/claude-code-on-the-web) e i comandi che le usano non sono disponibili:
2922 2945
2923```text theme={null}2946```text theme={null}
2924Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2947Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
2925```2948```
2926 2949
2927Il messaggio appare quando [create una sessione cloud dal terminale](/docs/it/claude-code-on-the-web#from-terminal-to-cloud) e quando inviate un comando che ha bisogno di sessioni cloud, come `/teleport`, `/remote-env` o `/web-setup`. Prima della v2.1.268, l'invio di uno di questi comandi restituiva [`Unknown command`](#unknown-command) invece.2950Il messaggio appare quando [crei una sessione cloud dal terminale](/docs/it/claude-code-on-the-web#from-terminal-to-cloud) e quando invii un comando che richiede le sessioni cloud, come `/teleport`, `/remote-env` o `/web-setup`. Prima della v2.1.268, l'invio di uno di questi comandi restituiva invece [`Unknown command`](#unknown-command).
2928 2951
2929Questa è una politica organizzativa lato server, quindi non può essere ignorata dalle impostazioni locali, dalle variabili di ambiente o dai flag CLI.2952Si tratta di una policy dell'organizzazione lato server, quindi non può essere sovrascritta da impostazioni locali, variabili d'ambiente o flag della CLI.
2930 2953
2931Se Claude Code non ha ancora caricato la politica della vostra organizzazione o non riesce a recuperarla, questi comandi rispondono `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` invece.2954Se Claude Code non ha ancora caricato la policy della tua organizzazione o non riesce a recuperarla, quei comandi rispondono invece `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.`.
2932 2955
2933**Cosa fare:**2956**Cosa fare:**
2934 2957
2935* Chiedete a un [Owner](/docs/it/server-managed-settings#access-control) della vostra organizzazione di abilitare le sessioni cloud nelle impostazioni di amministrazione di Claude Code su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)2958* Chiedi a un [Owner](/docs/it/server-managed-settings#access-control) della tua organizzazione di abilitare le sessioni cloud nelle impostazioni di amministrazione di Claude Code su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
2936* Se il messaggio dice che non ha potuto verificare la politica, controllate la vostra connessione di rete, quindi riavviate Claude Code e riprovate2959* Se il messaggio indica che non è stato possibile verificare la policy, controlla la connessione di rete, quindi riavvia Claude Code e riprova
2937 2960
2938<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2961<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2939 Il valore `--json-schema` non è uno schema JSON valido2962 Il valore di `--json-schema` non è un JSON Schema valido
2940</h3>2963</h3>
2941 2964
2942Lo schema che avete passato a [`--json-schema`](/docs/it/cli-reference#cli-flags) in [modalità non interattiva](/docs/it/headless#get-structured-output) ha fallito 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.2965Lo schema che hai 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 JSON Schema, quindi `claude` termina con codice di uscita 1 invece di eseguire il prompt. Prima della v2.1.205, uno schema non valido produceva un output non strutturato senza errori, e qualsiasi schema che usava la parola chiave `format` veniva trattato come non valido.
2943 2966
2944```text theme={null}2967```text theme={null}
2945Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2968Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2946```2969```
2947 2970
2948Il testo dopo il secondo due punti è la diagnostica del validatore e nomina la parola chiave o la posizione che ha fallito. Gli schemi che utilizzano la parola chiave `format`, come `"format": "email"`, sono validi: Claude Code accetta `format` come annotazione e non la applica.2971Il testo dopo i secondi due punti è la diagnostica del validatore e indica la parola chiave o la posizione che ha fallito. Gli schemi che usano la parola chiave `format`, come `"format": "email"`, sono validi: Claude Code accetta `format` come annotazione e non lo applica.
2949 2972
2950Claude Code esegue due controlli prima della compilazione dello schema: rifiuta un valore che non è JSON analizzabile con `Error: --json-schema is not valid JSON`, e JSON valido che non è un oggetto con `Error: --json-schema must be a JSON object`.2973Claude Code esegue due controlli prima della compilazione dello schema: rifiuta un valore che non è JSON analizzabile con `Error: --json-schema is not valid JSON`, e un JSON valido che non è un oggetto con `Error: --json-schema must be a JSON object`.
2951 2974
2952**Cosa fare:**2975**Cosa fare:**
2953 2976
2954* Correggete la parte dello schema che la diagnostica nomina, quindi rieseguite il comando2977* Correggi la parte dello schema indicata dalla diagnostica, quindi esegui di nuovo il comando
2955* Vedete [Get structured output](/docs/it/headless#get-structured-output) per uno schema funzionante e un comando2978* Consulta [Ottenere output strutturato](/docs/it/headless#get-structured-output) per uno schema e un comando funzionanti
2956 2979
2957<h3 id="settings-file-exceeds-the-2mib-limit">2980<h3 id="settings-file-exceeds-the-2mib-limit">
2958 Il file di impostazioni supera il limite di 2MiB2981 Il file delle impostazioni supera il limite di 2MiB
2959</h3>2982</h3>
2960 2983
2961Il file che avete passato a [`--settings`](/docs/it/cli-reference#cli-flags) è più grande di 2 MiB, quindi `claude` esce con codice 1 all'avvio invece di caricarlo. Prima della v2.1.214, Claude Code leggeva il file senza controllo delle dimensioni, e un file di più gigabyte o un file di dispositivo come `/dev/zero` faceva crescere la memoria senza limiti.2984Il file che hai passato a [`--settings`](/docs/it/cli-reference#cli-flags) è più grande di 2 MiB, quindi `claude` termina con codice di uscita 1 all'avvio invece di caricarlo. Prima della v2.1.214, Claude Code leggeva il file senza alcun controllo delle dimensioni, e un file di più gigabyte o un file di dispositivo come `/dev/zero` faceva crescere la memoria senza limiti.
2962 2985
2963```text theme={null}2986```text theme={null}
2964Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2987Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2965```2988```
2966 2989
2967Claude Code rifiuta un percorso `--settings` che non è un file regolare allo stesso modo: un dispositivo, FIFO o socket segnala `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` seguito dal percorso, e una directory segnala un motivo `EISDIR`.2990Claude Code rifiuta allo stesso modo un percorso `--settings` che non è un file regolare: un dispositivo, una FIFO o un socket riporta `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` seguito dal percorso, e una directory riporta un motivo `EISDIR`.
2968 2991
2969**Cosa fare:**2992**Cosa fare:**
2970 2993
2971* Puntate `--settings` a un file JSON di impostazioni regolare sotto 2 MiB. Vedete [Settings](/docs/it/settings) per il formato.2994* Fai puntare `--settings` a un normale file JSON di impostazioni inferiore a 2 MiB. Consulta [Impostazioni](/docs/it/settings) per il formato.
2972 2995
2973<h3 id="the-current-directory-no-longer-exists">2996<h3 id="the-current-directory-no-longer-exists">
2974 La directory corrente non esiste più2997 La directory corrente non esiste più
2975</h3>2998</h3>
2976 2999
2977Avete avviato `claude` da una directory che è stata eliminata o spostata dopo che la vostra shell vi è entrata, ad esempio una worktree o una directory temporanea che un'altra shell ha rimosso. Claude Code non riesce a leggere la sua directory di lavoro, quindi esce con codice 1 prima di avviare la sessione, sia in modalità interattiva che [non interattiva](/docs/it/headless). Prima della v2.1.239, Claude Code si bloccava con il codice sorgente del bundle minificato e uno stack `ENOENT ... uv_cwd` grezzo su stderr invece di questo messaggio.3000Hai avviato `claude` da una directory che è stata eliminata o spostata dopo che la tua shell vi era entrata, ad esempio un worktree o una directory temporanea rimossa da un'altra shell. Claude Code non riesce a leggere la propria directory di lavoro, quindi termina con codice di uscita 1 prima di avviare la sessione, sia in modalità interattiva sia in modalità [non interattiva](/docs/it/headless). Prima della v2.1.239, Claude Code si arrestava in modo anomalo mostrando sorgente del bundle minificato e uno stack `ENOENT ... uv_cwd` grezzo su stderr invece di questo messaggio.
2978 3001
2979```text theme={null}3002```text theme={null}
2980The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3003The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2983 3006
2984La causa e la soluzione sono le stesse per entrambe le forme.3007La causa e la soluzione sono le stesse per entrambe le forme.
2985 3008
2986Quando Claude Code non riesce a leggere la directory di lavoro per un motivo diverso, come un cambio di permessi, il messaggio nomina il codice di errore invece: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3009Quando Claude Code non riesce a leggere la directory di lavoro per un motivo diverso, ad esempio una modifica dei permessi, il messaggio indica invece il codice di errore: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`
2987 3010
2988Su macOS, `EPERM` per una directory in `~/Desktop`, `~/Documents`, `~/Downloads` o iCloud Drive di solito significa che macOS sta bloccando l'accesso della vostra app terminale a quella cartella. Altri comandi che leggono quella cartella falliscono allo stesso modo: `ls` lì segnala `Operation not permitted`, anche con `sudo`.3011Su macOS, `EPERM` per una directory in `~/Desktop`, `~/Documents`, `~/Downloads` o iCloud Drive di solito significa che macOS sta bloccando l'accesso della tua app del terminale a quella cartella. Anche altri comandi che leggono quella cartella falliscono allo stesso modo: `ls` lì riporta `Operation not permitted`, anche con `sudo`.
2989 3012
2990**Cosa fare:**3013**Cosa fare:**
2991 3014
2992* Cambiate a una directory che esiste, come la vostra home o la directory del progetto, quindi eseguite di nuovo `claude`3015* Spostati in una directory esistente, come la tua directory home o la directory del progetto, quindi esegui di nuovo `claude`
2993* Se la directory è stata ricreata nello stesso percorso, la vostra shell tiene ancora quella eliminata. Eseguite `cd "$PWD"` o lasciate e rientrate nella directory, quindi eseguite di nuovo `claude`3016* Se la directory è stata ricreata nello stesso percorso, la tua shell mantiene ancora quella eliminata. Esegui `cd "$PWD"` oppure esci e rientra nella directory, quindi esegui di nuovo `claude`
2994* Per `EPERM` su macOS, chiudete la vostra app terminale con Cmd+Q, apritela di nuovo, tornate a quella cartella ed eseguite `claude`. Se `ls` in quella cartella continua a fallire, aprite **System Settings > Privacy & Security > Files and Folders**, attivate la cartella per la vostra app terminale, quindi riaprire il terminale3017* Per `EPERM` su macOS, chiudi la tua app del terminale con Cmd+Q, riaprila, torna in quella cartella ed esegui `claude`. Se `ls` in quella cartella continua a fallire, apri **Impostazioni di Sistema > Privacy e sicurezza > File e cartelle**, attiva la cartella per la tua app del terminale, quindi riapri il terminale
2995 3018
2996<h3 id="temp-directory-refused-or-cannot-be-created">3019<h3 id="temp-directory-refused-or-cannot-be-created">
2997 La directory temporanea è stata rifiutata o non può essere creata3020 Directory temporanea rifiutata o impossibile da creare
2998</h3>3021</h3>
2999 3022
3000Su macOS e Linux, Claude Code crea una directory temporanea privata all'avvio, `claude-<uid>` sotto la directory temporanea di sistema o l'override [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars). Quando la directory non può essere creata, o una voce già in quel percorso fallisce i controlli di sicurezza, Claude Code stampa l'errore su stderr ed esce con codice 1 piuttosto che avviare la sessione:3023Su macOS e Linux, Claude Code crea all'avvio una directory temporanea privata, `claude-<uid>`, sotto la directory temporanea di sistema o l'override [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars). Quando la directory non può essere creata, oppure una voce già presente in quel percorso non supera i controlli di sicurezza, Claude Code stampa l'errore su stderr e termina con codice di uscita 1 invece di avviare la sessione:
3001 3024
3002```text wrap theme={null}3025```text wrap theme={null}
3003ENOSPC: no space left on device, mkdir '/tmp/claude-501'3026ENOSPC: no space left on device, mkdir '/tmp/claude-501'
3011 3034
3012**Cosa fare:**3035**Cosa fare:**
3013 3036
3014* Per `ENOSPC`, liberate spazio su disco nel volume che contiene la directory temporanea3037* Per `ENOSPC`, libera spazio su disco nel volume che contiene la directory temporanea
3015* Per le forme `Refusing to use it`, rimuovete la voce denominata stessa, non quello a cui un link punta, e avviate di nuovo Claude Code; per la forma `owned by uid`, solo un amministratore o quell'utente può rimuoverla3038* Per le forme `Refusing to use it`, rimuovi la voce indicata stessa, non ciò a cui punta un collegamento, e avvia di nuovo Claude Code; per la forma `owned by uid`, solo un amministratore o quell'utente può rimuoverla
3016* Per `is not readable`, eseguite `chmod 0700` sulla directory denominata, oppure rimuovetela e avviate di nuovo3039* Per `is not readable`, esegui `chmod 0700` sulla directory indicata, oppure rimuovila e riavvia
3017* In uno qualsiasi di questi casi, impostate [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) a una directory che controllate e avviate di nuovo Claude Code, lasciando il percorso rifiutato da solo3040* In uno qualsiasi di questi casi, imposta [`CLAUDE_CODE_TMPDIR`](/docs/it/env-vars) su una directory che controlli e avvia di nuovo Claude Code, lasciando intatto il percorso rifiutato
3018 3041
3019<h3 id="directory-couldnt-be-resolved-to-a-real-location">3042<h3 id="directory-couldnt-be-resolved-to-a-real-location">
3020 La directory non ha potuto essere risolta a una posizione reale3043 Impossibile risolvere la directory in una posizione reale
3021</h3>3044</h3>
3022 3045
3023Avete eseguito `/add-dir` per una sottodirectory della vostra directory di lavoro, e Claude Code non ha potuto risolvere la directory alla sua posizione reale.3046Hai eseguito `/add-dir` per una sottodirectory della tua directory di lavoro e Claude Code non è riuscito a risolvere la directory nella sua posizione reale.
3024 3047
3025Avete già accesso ai file a una sottodirectory della directory di lavoro, quindi `/add-dir` carica solo le sue skills, comandi e agenti. Prima di caricarli, Claude Code controlla che la posizione reale della directory, con qualsiasi symlink risolto, sia dentro la directory di lavoro. Quando Claude Code non riesce a risolvere quella posizione, non carica nulla e mostra questo messaggio:3048Hai già accesso ai file di una sottodirectory della directory di lavoro, quindi `/add-dir` carica solo le sue skill, i suoi comandi e i suoi agenti. Prima di caricarli, Claude Code verifica che la posizione reale della directory, con tutti i collegamenti simbolici risolti, si trovi all'interno della directory di lavoro. Quando Claude Code non riesce a risolvere quella posizione, non carica nulla e mostra questo messaggio:
3026 3049
3027```text theme={null}3050```text theme={null}
3028packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3051packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
3030 3053
3031**Cosa fare:**3054**Cosa fare:**
3032 3055
3033* Controllate che il percorso nomini una directory reale dentro la directory di lavoro, quindi eseguite di nuovo `/add-dir`3056* Verifica che il percorso indichi una directory reale all'interno della directory di lavoro, quindi esegui di nuovo `/add-dir`
3034* Il messaggio non cambia l'accesso ai vostri file; riporta solo che il contenuto `.claude/` della directory non è stato caricato3057* Il messaggio non modifica il tuo accesso ai file; segnala solo che il contenuto `.claude/` della directory non è stato caricato
3035 3058
3036Prima della v2.1.261, questo messaggio appariva anche per ogni `/add-dir <subdirectory>` quando la directory di lavoro era su un automount `/net/<host>`, dove Claude Code rifiuta di risolvere i percorsi per progettazione; la directory era fine e riprovare non poteva aiutare.3059Prima della v2.1.261, questo messaggio appariva anche per ogni `/add-dir <subdirectory>` quando la directory di lavoro si trovava su un automount `/net/<host>`, dove Claude Code per scelta progettuale non risolve i percorsi; la directory era a posto e riprovare non poteva essere d'aiuto.
3037 3060
3038<h3 id="workspace-not-trusted-when-starting-remote-control">3061<h3 id="workspace-not-trusted-when-starting-remote-control">
3039 Workspace non attendibile all'avvio di Remote Control3062 Workspace non attendibile all'avvio di Remote Control
3040</h3>3063</h3>
3041 3064
3042Avete avviato la modalità server [Remote Control](/docs/it/remote-control) con `claude remote-control` o il suo alias `claude rc` in una directory che non avete attendibile, e il comando non ha potuto chiedervi se fidarvi di essa. Ad esempio, l'input standard o l'output standard del comando non è un terminale perché uno di essi è reindirizzato o pipato. Il comando esce con codice 1:3065Hai avviato la modalità server di [Remote Control](/docs/it/remote-control) con `claude remote-control` o il suo alias `claude rc` in una directory che non hai considerato attendibile, e il comando non ha potuto chiederti se considerarla attendibile. Ad esempio, lo standard input o lo standard output del comando non è un terminale perché uno dei due è reindirizzato o inviato tramite pipe. Il comando termina con codice di uscita 1:
3043 3066
3044```text theme={null}3067```text theme={null}
3045Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3068Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3046```3069```
3047 3070
3048Due varianti che iniziano anche con `Error: Workspace not trusted.` appaiono anche in un terminale troppo piccolo per mostrare cosa attiva l'attendibilità della directory, o uno che non ha segnalato le sue dimensioni. Ingrandite la finestra o passate a una finestra terminale normale, quindi eseguite di nuovo `claude rc`.3071Due varianti che iniziano anch'esse con `Error: Workspace not trusted.` appaiono in un terminale troppo piccolo per mostrare ciò che l'attendibilità della directory attiva, o in uno che non ha comunicato le proprie dimensioni. Ingrandisci la finestra o passa a una normale finestra del terminale, quindi esegui di nuovo `claude rc`.
3049 3072
3050Nella vostra home directory il messaggio è diverso, perché la finestra di dialogo di attendibilità dell'area di lavoro non salva mai l'attendibilità per la home directory, quindi accettarla lì non può soddisfare questo controllo. Prima della v2.1.214, la home directory mostrava il messaggio sopra, il cui consiglio non può avere successo lì.3073Nella tua directory home il messaggio è diverso, perché la finestra di dialogo di attendibilità del workspace non salva mai l'attendibilità per la directory home, quindi accettarla lì non può soddisfare questo controllo. Prima della v2.1.214, la directory home mostrava il messaggio precedente, il cui consiglio lì non può avere successo.
3051 3074
3052```text theme={null}3075```text theme={null}
3053Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3076Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
3054```3077```
3055 3078
3056Se rispondete `n` o premete Invio alla domanda [`Trust <directory>?`](/docs/it/remote-control#requirements), il comando stampa un messaggio `Remote Control did not start` che nomina la directory ed esce con codice 1. Eseguite di nuovo `claude rc` per rispondere `y`.3079Se rispondi `n` o premi Invio alla [domanda `Trust <directory>?`](/docs/it/remote-control#requirements), il comando stampa un messaggio `Remote Control did not start` che indica la directory e termina con codice di uscita 1. Esegui di nuovo `claude rc` per rispondere `y`.
3057 3080
3058**Cosa fare:**3081**Cosa fare:**
3059 3082
3060* Attendete la directory da un terminale prima: eseguite `claude rc` lì e rispondete `y`, oppure eseguite `claude` lì e accettate la [finestra di dialogo di attendibilità dell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi eseguite di nuovo il vostro comando originale3083* Considera prima attendibile la directory da un terminale: esegui lì `claude rc` e rispondi `y`, oppure esegui lì `claude` e accetta la [finestra di dialogo di attendibilità del workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi esegui di nuovo il comando originale
3061* Nella vostra home directory, cambiate a una directory di progetto e avviate Remote Control lì3084* Nella tua directory home, spostati in una directory di progetto e avvia Remote Control da lì
3062 3085
3063Prima della v2.1.284, il comando non ha mai chiesto, nemmeno in un terminale.3086Prima della v2.1.284, il comando non chiedeva mai, nemmeno in un terminale.
3064 3087
3065<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3088<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
3066 Non trasportato alle sessioni che Remote Control avvia3089 Non trasferito alle sessioni avviate da Remote Control
3067</h3>3090</h3>
3068 3091
3069Avete avviato [Remote Control](/docs/it/remote-control) con un flag `claude` globale prima del verbo `remote-control`, uno che limiterebbe o configurerebbe le sessioni che Remote Control avvia, come `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag posizionato prima del verbo non raggiunge mai quelle sessioni. Claude Code rifiuta di avviare invece, nominando il flag:3092Hai avviato [Remote Control](/docs/it/remote-control) con un flag globale di `claude` prima del verbo `remote-control`, uno che limiterebbe o configurerebbe le sessioni avviate da Remote Control, come `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` o `--mcp-config`. Un flag posto prima del verbo non raggiunge mai quelle sessioni. Claude Code si rifiuta invece di avviarsi, indicando il flag:
3070 3093
3071```text theme={null}3094```text theme={null}
3072Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3095Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).
3073```3096```
3074 3097
3075Claude Code non rifiuta i flag globali che sono innocui da eliminare, come `--verbose`, `--model` o un `--session-id` o `--plugin-dir` iniettato da wrapper: li ignora e Remote Control si avvia.3098Claude Code non rifiuta i flag globali che è innocuo tralasciare, come `--verbose`, `--model`, o un `--session-id` o `--plugin-dir` iniettato da un wrapper: li ignora e Remote Control si avvia.
3076 3099
3077Claude Code rifiuta anche di avviare per un flag globale che non riconosce ancora come innocuo, quindi un flag aggiunto in una versione più recente può apparire in questo messaggio fino a quando una versione successiva non lo contrassegna come innocuo.3100Claude Code si rifiuta di avviarsi anche per un flag globale che non riconosce ancora come innocuo, quindi un flag aggiunto in una versione più recente può apparire in questo messaggio finché una versione successiva non lo contrassegna come innocuo.
3078 3101
3079**Cosa fare:**3102**Cosa fare:**
3080 3103
3081* Rimuovete il flag da prima del verbo e passate [le opzioni proprie di Remote Control](/docs/it/remote-control#start-a-remote-control-session) dopo di esso; `claude remote-control --help` le elenca3104* Rimuovi il flag da prima del verbo e passa [le opzioni proprie di Remote Control](/docs/it/remote-control#start-a-remote-control-session) dopo di esso; `claude remote-control --help` le elenca
3082* Quando il flag rifiutato è `--permission-mode`, eseguite `claude remote-control --permission-mode <mode>` per impostare la modalità di permesso per le sessioni che Remote Control avvia3105* Quando il flag rifiutato è `--permission-mode`, esegui `claude remote-control --permission-mode <mode>` per impostare la modalità di permesso per le sessioni avviate da Remote Control
3083 3106
3084Prima della v2.1.248, `claude remote-control` non accettava i suoi flag quando un flag globale veniva per primo, e il comando falliva con un errore di opzione sconosciuta.3107Prima della v2.1.248, `claude remote-control` non accettava i propri flag quando un flag globale veniva prima, e il comando falliva con un errore `unknown option`.
3085 3108
3086<h3 id="claude-import-is-not-yet-available-in-this-build">3109<h3 id="claude-import-is-not-yet-available-in-this-build">
3087 claude import non è ancora disponibile in questa build3110 claude import non è ancora disponibile in questa build
3088</h3>3111</h3>
3089 3112
3090Avete eseguito [`claude import`](/docs/it/cli-reference#cli-commands), e Claude Code ha trovato il flusso di importazione disattivato, quindi il comando esce con codice 1 invece di avviare l'importazione. Prima della v2.1.222, una build con il flusso di importazione disattivato trattava `import` come un prompt e avviava una sessione interattiva invece di stampare questo messaggio.3113Hai eseguito [`claude import`](/docs/it/cli-reference#cli-commands) e Claude Code ha trovato il flusso di importazione disattivato, quindi il comando termina con codice di uscita 1 invece di avviare l'importazione. Prima della v2.1.222, una build con il flusso di importazione disattivato trattava `import` come un prompt e avviava una sessione interattiva invece di stampare questo messaggio.
3091 3114
3092```text theme={null}3115```text theme={null}
3093`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3116`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3094```3117```
3095 3118
3096Claude Code attiva `claude import` attraverso un feature flag che recupera da Anthropic e memorizza nella cache su disco. Questo messaggio significa che il valore memorizzato nella cache è disattivato. La causa è di solito una delle seguenti:3119Claude Code attiva `claude import` tramite un feature flag che recupera da Anthropic e memorizza nella cache su disco. Questo messaggio significa che il valore nella cache è disattivato. La causa è di solito una delle seguenti:
3097 3120
3098* Non avete avviato una sessione dall'installazione, quindi Claude Code non ha ancora recuperato il flag. Il primo `claude import` può stampare questo anche quando la funzione è disponibile per voi.3121* Non hai avviato una sessione dopo l'installazione, quindi Claude Code non ha ancora recuperato il flag. Il primo `claude import` può stampare questo messaggio anche quando la funzionalità è disponibile per te.
3099* Utilizzate Claude Code attraverso Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform su AWS, o attraverso un [gateway di app Claude](/docs/it/claude-apps-gateway#availability-and-limitations). Claude Code non recupera i feature flag in queste sessioni, quindi `claude import` rimane non disponibile.3122* Usi Claude Code tramite Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry o Claude Platform su AWS, oppure tramite un [gateway delle app Claude](/docs/it/claude-apps-gateway#availability-and-limitations). Claude Code non recupera i feature flag in queste sessioni, quindi `claude import` rimane non disponibile.
3100* Avete impostato `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars), che disattivano il recupero dei feature flag, quindi `claude import` rimane non disponibile.3123* Hai impostato `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` o [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars), che disattivano il recupero dei feature flag, quindi `claude import` rimane non disponibile.
3101 3124
3102**Cosa fare:**3125**Cosa fare:**
3103 3126
3104* Su un'installazione nuova, avviate `claude`, aspettate che la sessione si carichi, uscite ed eseguite di nuovo `claude import`3127* Su una nuova installazione, avvia `claude`, attendi il caricamento della sessione, esci ed esegui di nuovo `claude import`
3105* Dove il recupero dei feature flag rimane disattivato, impostate la configurazione voi stessi: aggiungete server MCP con [`claude mcp add`](/docs/it/mcp#installing-mcp-servers), e create i file [`CLAUDE.md`](/docs/it/memory#how-claude-md-files-load), [skills e comandi](/docs/it/skills#where-skills-live) e [subagenti](/docs/it/sub-agents#choose-the-subagent-scope) che volete trasportare. Il messaggio nomina anche `~/.claude/settings.json`. Della configurazione che `claude import` trasporta, quel file contiene solo la [modalità di permesso](/docs/it/settings-reference#permission-settings); Claude Code non legge i server MCP da esso.3128* Dove il recupero dei feature flag rimane disattivato, imposta tu stesso la configurazione: aggiungi i server MCP con [`claude mcp add`](/docs/it/mcp#installing-mcp-servers) e crea i [file `CLAUDE.md`](/docs/it/memory#how-claude-md-files-load), le [skill e i comandi](/docs/it/skills#where-skills-live) e i [subagent](/docs/it/sub-agents#choose-the-subagent-scope) che vuoi trasferire. Il messaggio indica anche `~/.claude/settings.json`. Della configurazione trasferita da `claude import`, quel file contiene solo la [modalità di permesso](/docs/it/settings-reference#permission-settings); Claude Code non legge i server MCP da esso.
3106 3129
3107<h3 id="could-not-read-claude-code-config">3130<h3 id="could-not-read-claude-code-config">
3108 Non è stato possibile leggere la configurazione di Claude Code3131 Impossibile leggere la configurazione di Claude Code
3109</h3>3132</h3>
3110 3133
3111Avete eseguito [`claude import`](/docs/it/cli-reference#cli-commands) mentre Claude Code non poteva analizzare `~/.claude.json`, il file dove memorizza il vostro login e lo stato per progetto. Il sottocomando legge quel file per controllare la disponibilità ma non mostra la finestra di dialogo di recupero che la sessione interattiva mostra, quindi esce con codice 1. Prima della v2.1.222, `claude import` con un file di configurazione illeggibile avviava una sessione interattiva, la cui finestra di dialogo di recupero gestiva il file.3134Hai eseguito [`claude import`](/docs/it/cli-reference#cli-commands) mentre Claude Code non riusciva ad analizzare `~/.claude.json`, il file in cui memorizza il tuo accesso e lo stato per progetto. Il sottocomando legge quel file per verificare la disponibilità ma non mostra la finestra di dialogo di ripristino che mostra la sessione interattiva, quindi termina con codice di uscita 1. Prima della v2.1.222, `claude import` con un file di configurazione illeggibile avviava una sessione interattiva, la cui finestra di dialogo di ripristino gestiva il file.
3112 3135
3113```text theme={null}3136```text theme={null}
3114Could not read Claude Code config — run `claude` with no arguments to recover it.3137Could not read Claude Code config — run `claude` with no arguments to recover it.
3116 3139
3117**Cosa fare:**3140**Cosa fare:**
3118 3141
3119* Eseguite `claude` senza argomenti. Claude Code rileva il file non valido e offre di ripristinarlo. Quindi eseguite di nuovo `claude import`.3142* Esegui `claude` senza argomenti. Claude Code rileva il file non valido e offre di reimpostarlo. Quindi esegui di nuovo `claude import`.
3120* Per mantenere le modifiche manuali che avete fatto, correggete la sintassi JSON in `~/.claude.json` in un editor invece, quindi rieseguite `claude import`3143* Per mantenere le modifiche manuali che hai apportato, correggi invece la sintassi JSON in `~/.claude.json` in un editor, quindi esegui di nuovo `claude import`
3121 3144
3122<h3 id="could-not-import-a-server-from-claude-desktop">3145<h3 id="could-not-import-a-server-from-claude-desktop">
3123 Non è stato possibile importare un server da Claude Desktop3146 Impossibile importare un server da Claude Desktop
3124</h3>3147</h3>
3125 3148
3126Claude Code non ha potuto aggiungere uno dei server che avete selezionato in `claude mcp add-from-claude-desktop`. Il comando importa comunque gli altri server selezionati e stampa una riga per server che non ha potuto aggiungere. Prima della v2.1.205, il primo server che falliva fermava l'importazione.3149Claude Code non è riuscito ad aggiungere uno dei server che hai selezionato in `claude mcp add-from-claude-desktop`. Il comando importa comunque gli altri server selezionati e stampa una riga per ogni server che non è riuscito ad aggiungere. Prima della v2.1.205, il primo server che falliva interrompeva l'importazione.
3127 3150
3128```text theme={null}3151```text theme={null}
3129Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3152Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3130```3153```
3131 3154
3132Il 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 fallisce la convalida e un server bloccato dalla [politica MCP](/docs/it/managed-mcp) della vostra organizzazione.3155Il testo dopo il nome del server è il motivo. Il più comune è il controllo del nome: Claude Desktop consente nei nomi dei server caratteri, come spazi e punti, che `claude mcp` limita a lettere, numeri, trattini e trattini bassi. Altri motivi includono una configurazione del server che non supera la validazione e un server bloccato dalla [policy MCP](/docs/it/managed-mcp) della tua organizzazione.
3133 3156
3134**Cosa fare:**3157**Cosa fare:**
3135 3158
3136* 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`3159* Rinomina il server in `claude_desktop_config.json` usando solo lettere, numeri, trattini e trattini bassi, quindi esegui di nuovo `claude mcp add-from-claude-desktop`
3137* Aggiungete quel server direttamente con `claude mcp add` o `claude mcp add-json` con un nome valido. Vedete [Import MCP servers from Claude Desktop](/docs/it/mcp#import-mcp-servers-from-claude-desktop).3160* Aggiungi quel server direttamente con `claude mcp add` o `claude mcp add-json` con un nome valido. Consulta [Importare server MCP da Claude Desktop](/docs/it/mcp#import-mcp-servers-from-claude-desktop).
3138 3161
3139<h3 id="cannot-add-mcp-server-to-the-managed-scope">3162<h3 id="cannot-add-mcp-server-to-the-managed-scope">
3140 Non è possibile aggiungere un server MCP all'ambito gestito3163 Impossibile aggiungere il server MCP all'ambito gestito
3141</h3>3164</h3>
3142 3165
3143Avete eseguito `claude mcp add` o `claude mcp add-json` con `--scope managed`. Quell'ambito contiene i server che la vostra organizzazione fornisce attraverso l'impostazione gestita [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers). Claude Code li legge dalle impostazioni gestite solo, quindi il comando non può scrivere un server in quell'ambito.3166Hai eseguito `claude mcp add` o `claude mcp add-json` con `--scope managed`. Quell'ambito contiene i server che la tua organizzazione fornisce tramite l'impostazione gestita [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers). Claude Code li legge solo dalle impostazioni gestite, quindi il comando non può scrivere un server in quell'ambito.
3144 3167
3145```text theme={null}3168```text theme={null}
3146Cannot add MCP server to scope: managed3169Cannot add MCP server to scope: managed
3148 3171
3149**Cosa fare:**3172**Cosa fare:**
3150 3173
3151* Aggiungete il server a un ambito in cui potete scrivere: `local`, `user` o `project`. Senza `--scope`, il comando utilizza `local`. Vedete [MCP installation scopes](/docs/it/mcp#mcp-installation-scopes)3174* Aggiungi il server a un ambito in cui puoi scrivere: `local`, `user` o `project`. Senza `--scope`, il comando usa `local`. Consulta [Ambiti di installazione MCP](/docs/it/mcp#mcp-installation-scopes)
3152* Per fornire il server a ogni utente della vostra organizzazione, aggiungetelo a [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers) nelle impostazioni gestite che distribuite3175* Per fornire il server a ogni utente della tua organizzazione, aggiungilo a [`managedMcpServers`](/docs/it/settings-reference#managedmcpservers) nelle impostazioni gestite che distribuisci
3153 3176
3154<h3 id="cant-read-mcp-json">3177<h3 id="cant-read-mcp-json">
3155 Non è possibile leggere .mcp.json3178 Impossibile leggere .mcp.json
3156</h3>3179</h3>
3157 3180
3158Un comando che legge il [`.mcp.json`](/docs/it/mcp#project-scope) del progetto, come `claude mcp add` o `claude mcp add-json` con `--scope project`, o `claude mcp remove`, ha trovato che il file nella vostra directory corrente non è un file regolare o è più grande di 2 MiB, quindi esce con questo errore invece di leggere il file.3181Un comando che legge il file [`.mcp.json`](/docs/it/mcp#project-scope) del progetto, come `claude mcp add` o `claude mcp add-json` con `--scope project`, oppure `claude mcp remove`, ha rilevato che il file nella tua directory corrente non è un file regolare o è più grande di 2 MiB, quindi termina con questo errore invece di leggere il file.
3159 3182
3160```text theme={null}3183```text theme={null}
3161Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3184Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
3162```3185```
3163 3186
3164Prima della v2.1.257, un FIFO in `.mcp.json` lasciava il comando in attesa per sempre senza output, e un symlink a un file di dispositivo come `/dev/zero` faceva crescere la memoria fino a quando il processo non veniva ucciso.3187Prima della v2.1.257, una FIFO in `.mcp.json` lasciava il comando in attesa all'infinito senza output, e un collegamento simbolico a un file di dispositivo come `/dev/zero` faceva crescere la memoria finché il processo non veniva terminato.
3165 3188
3166**Cosa fare:**3189**Cosa fare:**
3167 3190
3168* Controllate cosa si trova in `.mcp.json` nella vostra directory corrente. Sostituitelo con un file JSON ordinario nel [formato project-scope](/docs/it/mcp#project-scope), oppure eliminatelo, quindi eseguite di nuovo il comando.3191* Controlla cosa si trova in `.mcp.json` nella tua directory corrente. Sostituiscilo con un normale file JSON nel [formato dell'ambito di progetto](/docs/it/mcp#project-scope), oppure eliminalo, quindi esegui di nuovo il comando.
3169 3192
3170<h3 id="mcp-server-was-not-saved-or-removed">3193<h3 id="mcp-server-was-not-saved-or-removed">
3171 Il server MCP non è stato salvato o rimosso3194 Il server MCP non è stato salvato o rimosso
3172</h3>3195</h3>
3173 3196
3174Avete eseguito `claude mcp add`, `claude mcp add-json` o `claude mcp remove` per un server nell'ambito `user` o `local` [scope](/docs/it/mcp#mcp-installation-scopes). Entrambi gli ambiti sono memorizzati in `~/.claude.json`, e la modifica non è in quel file quando Claude Code lo legge di nuovo dopo la scrittura. Il comando esce con questo errore invece della sua riga di successo.3197Hai eseguito `claude mcp add`, `claude mcp add-json` o `claude mcp remove` per un server nell'[ambito](/docs/it/mcp#mcp-installation-scopes) `user` o `local`. Entrambi gli ambiti sono memorizzati in `~/.claude.json`, e la modifica non è presente in quel file quando Claude Code lo rilegge dopo la scrittura. Il comando termina con questo errore invece della sua riga di successo.
3175 3198
3176```text theme={null}3199```text theme={null}
3177MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3200MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.
3178```3201```
3179 3202
3180Dopo una rimozione, il messaggio legge `was not removed from` e termina con `then remove the server again`. Per un server `local`-scope, il percorso è seguito dalla directory del progetto a cui appartiene la voce, come `(local scope for /path/to/project)`.3203Dopo una rimozione, il messaggio riporta `was not removed from` e termina con `then remove the server again`. Per un server con ambito `local`, il percorso è seguito dalla directory del progetto a cui appartiene la voce, come `(local scope for /path/to/project)`.
3181 3204
3182Prima della v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` segnalano il successo anche quando la modifica non raggiungeva il file.3205Prima della v2.1.283, `claude mcp add`, `claude mcp add-json` e `claude mcp remove` riportavano un successo anche quando la modifica non raggiungeva il file.
3183 3206
3184**Cosa fare:**3207**Cosa fare:**
3185 3208
3186* Rendete il file che il messaggio nomina scrivibile, oppure eseguite il comando al di fuori della sandbox, quindi eseguite di nuovo lo stesso comando di aggiunta o rimozione.3209* Rendi scrivibile il file indicato dal messaggio, oppure esegui il comando al di fuori della sandbox, quindi esegui di nuovo lo stesso comando di aggiunta o rimozione.
3187 3210
3188<h3 id="mcp-server-may-not-have-been-saved-or-removed">3211<h3 id="mcp-server-may-not-have-been-saved-or-removed">
3189 Il server MCP potrebbe non essere stato salvato o rimosso3212 Il server MCP potrebbe non essere stato salvato o rimosso
3190</h3>3213</h3>
3191 3214
3192Avete eseguito `claude mcp add`, `claude mcp add-json` o `claude mcp remove` per un server nell'ambito `user` o `local` [scope](/docs/it/mcp#mcp-installation-scopes), e Claude Code non ha potuto leggere `~/.claude.json` di nuovo per confermare la modifica. La modifica potrebbe essere o non essere su disco. Il testo tra parentesi è l'errore da quella lettura.3215Hai eseguito `claude mcp add`, `claude mcp add-json` o `claude mcp remove` per un server nell'[ambito](/docs/it/mcp#mcp-installation-scopes) `user` o `local`, e Claude Code non è riuscito a rileggere `~/.claude.json` per confermare la modifica. La modifica potrebbe essere o non essere su disco. Il testo tra parentesi è l'errore di quella lettura.
3193 3216
3194```text theme={null}3217```text theme={null}
3195MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3218MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
3196```3219```
3197 3220
3198Dopo una rimozione, il messaggio legge `may not have been removed` e termina con `then remove the server again if it is still listed`.3221Dopo una rimozione, il messaggio riporta `may not have been removed` e termina con `then remove the server again if it is still listed`.
3199 3222
3200Prima della v2.1.283, i comandi segnalano il successo anche quando la modifica non poteva essere confermata.3223Prima della v2.1.283, i comandi riportavano un successo anche quando non era possibile confermare la modifica.
3201 3224
3202**Cosa fare:**3225**Cosa fare:**
3203 3226
3204* Eseguite `claude mcp get <name>` per controllare se la modifica è su disco. Per un server `local`-scope, eseguitelo dalla directory del progetto a cui appartiene il server, poiché l'ambito locale è per progetto.3227* Esegui `claude mcp get <name>` per verificare se la modifica è su disco. Per un server con ambito `local`, eseguilo dalla directory del progetto a cui appartiene il server, poiché l'ambito locale è per progetto.
3205* Se il server manca dopo un'aggiunta, o è ancora elencato dopo una rimozione, eseguite di nuovo lo stesso comando di aggiunta o rimozione.3228* Se il server manca dopo un'aggiunta, o è ancora elencato dopo una rimozione, esegui di nuovo lo stesso comando di aggiunta o rimozione.
3206 3229
3207<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3230<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
3208 Il server è ospitato da Anthropic e non supporta OAuth locale3231 Il server è ospitato da Anthropic e non supporta OAuth locale
3209</h3>3232</h3>
3210 3233
3211Avete avviato un accesso per un server MCP il cui URL punta a un host di connettore ospitato da Anthropic che si autentica attraverso un provider di identità di terze parti. Questi host includono `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` e `gcal.mcp.claude.com`. Claude Code rifiuta di avviare il suo flusso OAuth locale per questi host sia dal pannello `/mcp` che da `claude mcp login`, perché [il loro accesso funziona solo attraverso claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai).3234Hai avviato un accesso per un server MCP il cui URL punta a un host di connettori ospitato da Anthropic che esegue l'autenticazione tramite un provider di identità di terze parti. Questi host includono `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` e `gcal.mcp.claude.com`. Claude Code si rifiuta di avviare il proprio flusso OAuth locale per questi host sia dal pannello `/mcp` sia da `claude mcp login`, perché [il loro accesso funziona solo tramite claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai).
3212 3235
3213```text theme={null}3236```text theme={null}
3214"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3237"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
3216 3239
3217**Cosa fare:**3240**Cosa fare:**
3218 3241
3219* Rimuovete la vostra voce con `claude mcp remove <name>`, in modo che non possa nascondere il connettore claude.ai allo stesso URL3242* Rimuovi la tua voce con `claude mcp remove <name>`, in modo che non possa nascondere il connettore di claude.ai allo stesso URL
3220* Dopo averlo rimosso, collegate il servizio su [claude.ai/customize/connectors](https://claude.ai/customize/connectors), mentre siete connessi all'account che utilizzate in Claude Code. Una volta collegato, [il connettore appare in Claude Code automaticamente](/docs/it/mcp#use-mcp-servers-from-claude-ai) se il vostro metodo di autenticazione attivo è un accesso di sottoscrizione a claude.ai3243* Dopo averla rimossa, connetti il servizio su [claude.ai/customize/connectors](https://claude.ai/customize/connectors), avendo effettuato l'accesso con l'account che usi in Claude Code. Una volta connesso, [il connettore appare automaticamente in Claude Code](/docs/it/mcp#use-mcp-servers-from-claude-ai) se il tuo metodo di autenticazione attivo è un accesso con abbonamento claude.ai
3221 3244
3222<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3245<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
3223 Il server ha rifiutato l'intestazione Authorization creata dal headersHelper configurato3246 Il server ha rifiutato l'header Authorization generato dal headersHelper configurato
3224</h3>3247</h3>
3225 3248
3226Un server MCP il cui [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication) fornisce l'intestazione `Authorization` ha risposto alla connessione con HTTP 401 o 403, quindi Claude Code segnala la connessione come fallita. Poiché l'helper fornisce l'intestazione `Authorization`, Claude Code [non ricade su OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers) per il server:3249Un server MCP il cui [`headersHelper`](/docs/it/mcp#use-dynamic-headers-for-custom-authentication) fornisce l'header `Authorization` ha risposto alla connessione con HTTP 401 o 403, quindi Claude Code segnala la connessione come non riuscita. Poiché l'helper fornisce l'header `Authorization`, Claude Code [non ripiega su OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers) per il server:
3227 3250
3228```text theme={null}3251```text theme={null}
3229Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3252Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
3230```3253```
3231 3254
3232Claude Code riesegue l'helper ad ogni tentativo di connessione, quindi un nuovo tentativo dopo un rifiuto transitorio, come una gara di rotazione del token, può avere successo con una credenziale nuova.3255Claude Code riesegue l'helper a ogni tentativo di connessione, quindi un nuovo tentativo dopo un rifiuto temporaneo, come una race condition nella rotazione del token, può riuscire con una credenziale nuova.
3233 3256
3234**Cosa fare:**3257**Cosa fare:**
3235 3258
3236* Eseguite il comando `headersHelper` voi stessi nel modo in cui Claude Code lo esegue: dalla [directory in cui Claude Code lo esegue](/docs/it/mcp#where-the-helper-runs), con le [variabili di ambiente che Claude Code imposta per esso](/docs/it/mcp#use-dynamic-headers-for-custom-authentication), e senza le [variabili di credenziale che Claude Code rimuove](/docs/it/mcp#which-variables-a-helper-can-read) per un server da un `.mcp.json` di progetto, un plugin o un file di agente di progetto. Controllate che stampi un valore `Authorization` che l'endpoint del server accetta3259* Esegui tu stesso il comando `headersHelper` nel modo in cui lo esegue Claude Code: dalla [directory in cui Claude Code lo esegue](/docs/it/mcp#where-the-helper-runs), con le [variabili d'ambiente che Claude Code imposta per esso](/docs/it/mcp#use-dynamic-headers-for-custom-authentication), e senza le [variabili di credenziali che Claude Code rimuove](/docs/it/mcp#which-variables-a-helper-can-read) per un server proveniente da un `.mcp.json` di progetto, da un plugin o da un file di agente di progetto. Verifica che stampi un valore `Authorization` accettato dall'endpoint del server
3237* Dopo aver corretto l'helper o la sua fonte di credenziale, selezionate il server in `/mcp` e scegliete **Reconnect**3260* Dopo aver corretto l'helper o la sua fonte di credenziali, seleziona il server in `/mcp` e scegli **Reconnect**
3238 3261
3239Prima della v2.1.248, Claude Code eseguiva la scoperta OAuth per un server il cui helper forniva l'intestazione `Authorization`. Quella scoperta potrebbe fallire con `Incompatible auth server: does not support dynamic client registration` invece di segnalare la credenziale rifiutata.3262Prima della v2.1.248, Claude Code eseguiva il discovery OAuth per un server il cui helper forniva l'header `Authorization`. Quel discovery poteva fallire con `Incompatible auth server: does not support dynamic client registration` invece di segnalare la credenziale rifiutata.
3240 3263
3241<h3 id="mcp-permission-prompt-tool-not-found">3264<h3 id="mcp-permission-prompt-tool-not-found">
3242 Strumento di prompt di permesso MCP non trovato3265 Strumento di richiesta dei permessi MCP non trovato
3243</h3>3266</h3>
3244 3267
3245Lo 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 permesso, perché il suo server non si è mai connesso o 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 dello strumento, quindi non produce alcuna risposta anche se la richiesta è stata fatta. Prima del primo prompt, Claude Code aspetta 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 aspettava che il server finisse di connettersi, quindi un server che si avvia lentamente ma sano produceva questo errore anche.3268Lo strumento che hai 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 sui permessi, o perché il suo server non si è mai connesso o perché nessun server connesso espone uno strumento con quel nome. Claude Code invia comunque il tuo prompt: l'esecuzione [non interattiva](/docs/it/headless) termina con questo errore, e codice di uscita 1, alla prima chiamata a uno strumento, quindi non produce alcuna risposta anche se la richiesta è stata effettuata. Prima del primo prompt, Claude Code attende che quel server si connetta fino al timeout di connessione per server di 30 secondi impostato da [`MCP_TIMEOUT`](/docs/it/env-vars). Prima della v2.1.206, l'avvio non attendeva che il server finisse di connettersi, quindi anche un server sano ma lento ad avviarsi produceva questo errore.
3246 3269
3247```text theme={null}3270```text theme={null}
3248Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3271Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3249```3272```
3250 3273
3251L'elenco dopo `Available MCP tools:` nomina gli strumenti MCP che erano connessi.3274L'elenco dopo `Available MCP tools:` indica gli strumenti MCP che erano connessi.
3252 3275
3253**Cosa fare:**3276**Cosa fare:**
3254 3277
3255* Controllate che il server si avvii e rimanga connesso: eseguite `claude mcp list` nella stessa directory e confermate che il server è elencato come connesso3278* Verifica che il server si avvii e rimanga connesso: esegui `claude mcp list` nella stessa directory e conferma che il server sia elencato come connesso
3256* Confermate che il nome dello strumento corrisponda al nome `mcp__<server>__<tool>` che il server espone3279* Conferma che il nome dello strumento corrisponda al nome `mcp__<server>__<tool>` esposto dal server
3257* Se il server ha bisogno di più di 30 secondi per avviarsi, aumentate [`MCP_TIMEOUT`](/docs/it/env-vars)3280* Se il server ha bisogno di più di 30 secondi per avviarsi, aumenta [`MCP_TIMEOUT`](/docs/it/env-vars)
3258 3281
3259<h3 id="oauth-callback-port-is-already-in-use">3282<h3 id="oauth-callback-port-is-already-in-use">
3260 La porta di callback OAuth è già in uso3283 La porta di callback OAuth è già in uso
3261</h3>3284</h3>
3262 3285
3263Quando vi accedete a un server MCP remoto con OAuth, Claude Code avvia un listener locale per ricevere il callback di accesso. Se la porta di cui quel listener ha bisogno è tenuta da un altro processo, l'accesso fallisce con questo messaggio. Questo accade principalmente con una [porta di callback fissa](/docs/it/mcp#use-a-fixed-oauth-callback-port) impostata attraverso la variabile [`MCP_OAUTH_CALLBACK_PORT`](/docs/it/env-vars) o `--callback-port`, poiché senza una Claude Code sceglie una porta disponibile.3286Quando accedi a un server MCP remoto con OAuth, Claude Code avvia un listener locale per ricevere la callback di accesso. Se la porta di cui ha bisogno quel listener è occupata da un altro processo, l'accesso fallisce con questo messaggio. Questo accade soprattutto con una [porta di callback fissa](/docs/it/mcp#use-a-fixed-oauth-callback-port) impostata tramite la variabile [`MCP_OAUTH_CALLBACK_PORT`](/docs/it/env-vars) o `--callback-port`, poiché senza di essa Claude Code sceglie una porta disponibile.
3264 3287
3265```text theme={null}3288```text theme={null}
3266OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3289OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3267```3290```
3268 3291
3269Su Windows, il comando suggerito è `netstat -ano | findstr :<port>` invece.3292Su Windows, il comando suggerito è invece `netstat -ano | findstr :<port>`.
3270 3293
3271**Cosa fare:**3294**Cosa fare:**
3272 3295
3273* Eseguite il comando dal messaggio per trovare il processo che tiene la porta, e fermatelo o aspettate che finisca3296* Esegui il comando indicato nel messaggio per trovare il processo che occupa la porta, e arrestalo o attendi che termini
3274* Se un altro programma ha bisogno di quella porta in modo permanente, registrate un URI di reindirizzamento diverso con il server e impostate la sua porta con `MCP_OAUTH_CALLBACK_PORT` o `--callback-port`, a seconda di quale utilizzate3297* Se un altro programma ha bisogno di quella porta in modo permanente, registra un URI di reindirizzamento diverso presso il server e imposta la sua porta con `MCP_OAUTH_CALLBACK_PORT` o `--callback-port`, a seconda di quale usi
3275* Quindi avviate di nuovo l'accesso, ad esempio selezionando il server in `/mcp`3298* Quindi avvia di nuovo l'accesso, ad esempio selezionando il server in `/mcp`
3276 3299
3277<h3 id="no-available-ports-for-oauth-redirect">3300<h3 id="no-available-ports-for-oauth-redirect">
3278 Nessuna porta disponibile per il reindirizzamento OAuth3301 Nessuna porta disponibile per il reindirizzamento OAuth
3279</h3>3302</h3>
3280 3303
3281Quando vi accedete a un server MCP remoto con [OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers), Claude Code avvia un listener locale per ricevere il callback di accesso. L'accesso fallisce con questo messaggio quando Claude Code non riesce a legare una porta locale per esso. Qualcosa sulla macchina sta impedendo di ascoltare su `127.0.0.1`, ad esempio software di sicurezza o una politica sandbox che nega i listener locali.3304Quando accedi a un server MCP remoto con [OAuth](/docs/it/mcp#authenticate-with-remote-mcp-servers), Claude Code avvia un listener locale per ricevere la callback di accesso. L'accesso fallisce con questo messaggio quando Claude Code non riesce a effettuare il binding di una porta locale per esso. Qualcosa sulla macchina gli impedisce di mettersi in ascolto su `127.0.0.1`, ad esempio un software di sicurezza o una policy di sandbox che nega i listener locali.
3282 3305
3283```text theme={null}3306```text theme={null}
3284No available ports for OAuth redirect3307No available ports for OAuth redirect
3285```3308```
3286 3309
3287Prima della v2.1.268, Claude Code non ricadeva su una porta assegnata dal sistema operativo, quindi il messaggio appariva anche quando solo le porte auto-scelte non potevano essere legate. Questo può accadere su host Windows dove Hyper-V riserva intervalli di porte che coprono le porte che Claude Code sceglie.3310Prima della v2.1.268, Claude Code non ripiegava su una porta assegnata dal sistema operativo, quindi il messaggio appariva anche quando solo le porte scelte autonomamente non potevano essere associate. Questo può accadere su host Windows in cui Hyper-V riserva intervalli di porte che coprono quelle da cui Claude Code sceglie.
3288 3311
3289**Cosa fare:**3312**Cosa fare:**
3290 3313
3291* Controllate se il software di sicurezza o una politica sandbox blocca i processi dall'ascolto su `127.0.0.1`, e consentite a Claude Code di legare una porta locale3314* Verifica se un software di sicurezza o una policy di sandbox impedisce ai processi di mettersi in ascolto su `127.0.0.1`, e consenti a Claude Code di effettuare il binding di una porta locale
3292* Quindi avviate di nuovo l'accesso, ad esempio selezionando il server in `/mcp`3315* Quindi avvia di nuovo l'accesso, ad esempio selezionando il server in `/mcp`
3293 3316
3294<h3 id="security-review-fails-without-origin-head">3317<h3 id="security-review-fails-without-origin-head">
3295 /security-review fallisce senza origin/HEAD3318 /security-review fallisce senza origin/HEAD
3296</h3>3319</h3>
3297 3320
3298[`/security-review`](/docs/it/commands#all-commands) costruisce il suo contesto di revisione facendo il diff del vostro ramo rispetto a `origin/HEAD`, il ref locale che registra quale ramo è il predefinito sul vostro remote `origin`. Quando quel ref non esiste, i comandi git che raccolgono il diff falliscono e la revisione si ferma prima di iniziare.3321[`/security-review`](/docs/it/commands#all-commands) costruisce il proprio contesto di revisione calcolando il diff del tuo branch rispetto a `origin/HEAD`, il ref locale che registra quale branch è quello predefinito sul tuo remote `origin`. Quando quel ref non esiste, i comandi git che raccolgono il diff falliscono e la revisione si interrompe prima di iniziare.
3299 3322
3300```text theme={null}3323```text theme={null}
3301Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3324Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3304'git <command> [<revision>...] -- [<file>...]'3327'git <command> [<revision>...] -- [<file>...]'
3305```3328```
3306 3329
3307Il messaggio potrebbe citare `git log` o un diverso `git diff` invece. Git crea `origin/HEAD` solo quando il remote pubblicizza un ramo predefinito e il vostro refspec di fetch lo copre, cosa che un `git clone` completo di un remote con commit fa. Il ref manca in queste configurazioni:3330Il messaggio potrebbe citare invece `git log` o un `git diff` diverso. Git crea `origin/HEAD` solo quando il remote dichiara un branch predefinito e il tuo refspec di fetch lo include, cosa che avviene con un `git clone` completo di un remote con commit. Il ref manca in queste configurazioni:
3308 3331
3309* Un checkout single-branch o CI, che recupera un refspec troppo stretto3332* Un checkout a branch singolo o di CI, che esegue il fetch di un refspec troppo ristretto
3310* Un remote il cui server-side HEAD punta a un ramo che nessuno ha spinto3333* Un remote il cui HEAD lato server punta a un branch di cui nessuno ha fatto il push
3311* Un repository senza remote `origin`, o uno da cui non avete mai recuperato3334* Un repository senza remote `origin`, o di cui non hai mai eseguito il fetch
3312 3335
3313Claude Code mostra lo stesso errore per qualsiasi skill che [inietta contesto dinamico](/docs/it/skills#when-an-injected-command-fails), e un comando iniettato fallito interrompe l'invocazione di quella skill. Due stringhe sibling si attivano prima che il comando venga eseguito:3336Claude Code mostra lo stesso errore per qualsiasi skill che [inietta contesto dinamico](/docs/it/skills#when-an-injected-command-fails), e un comando iniettato non riuscito interrompe l'invocazione di quella skill. Due stringhe affini vengono emesse prima ancora che il comando venga eseguito:
3314 3337
3315* `Shell command permission check failed for pattern "..."`: il controllo di permesso del comando non lo ha consentito. [Permission checks on injected commands](/docs/it/skills#permission-checks-on-injected-commands) copre quali risultati interrompono in ogni modalità di permesso e come pre-approvare un comando con `allowed-tools`3338* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi iniettati](/docs/it/skills#permission-checks-on-injected-commands) spiega quali risultati causano l'interruzione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`
3316* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina senza di esso. Installate Git per Windows o cambiate il frontmatter a `shell: powershell`. Vedete [How injected commands run](/docs/it/skills#how-injected-commands-run)3339* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina che ne è priva. Installa Git for Windows oppure modifica il frontmatter in `shell: powershell`. Consulta [Come vengono eseguiti i comandi iniettati](/docs/it/skills#how-injected-commands-run)
3317 3340
3318**Cosa fare:**3341**Cosa fare:**
3319 3342
3320* Create il ref nominando il ramo predefinito del vostro remote: `git remote set-head origin <default-branch>`. Questo funziona ogni volta che il ref di tracciamento locale `origin/<default-branch>` esiste. Se non esiste, come nei cloni single-branch, recuperate prima il ramo: eseguite `git remote set-branches --add origin <branch>`, quindi `git fetch origin`, quindi rieseguite il comando set-head. Rieseguite `/security-review`.3343* Crea il ref indicando il branch predefinito del tuo remote: `git remote set-head origin <default-branch>`. Questo funziona ogni volta che esiste il ref di tracciamento locale `origin/<default-branch>`. Se non esiste, come nei clone a branch singolo, esegui prima il fetch del branch: esegui `git remote set-branches --add origin <branch>`, poi `git fetch origin`, quindi esegui di nuovo il comando set-head. Esegui di nuovo `/security-review`.
3321* Se preferite non nominare il ramo, eseguite `git fetch origin` e quindi `git remote set-head origin --auto`, che chiede al remote quale ramo è il suo predefinito. Fallisce con `error: Cannot determine remote HEAD` quando il remote non pubblicizza alcun ramo predefinito, perché è vuoto o il suo HEAD punta a un ramo che nessuno ha spinto; nominate il ramo esplicitamente invece. Fallisce con `error: Not a valid ref` quando il vostro clone non recupera quel ramo; allargare il refspec come sopra prima.3344* Se preferisci non indicare il branch, esegui `git fetch origin` e poi `git remote set-head origin --auto`, che chiede al remote quale branch è il suo predefinito. Fallisce con `error: Cannot determine remote HEAD` quando il remote non dichiara alcun branch predefinito, perché è vuoto o il suo HEAD punta a un branch di cui nessuno ha fatto il push; in tal caso indica il branch esplicitamente. Fallisce con `error: Not a valid ref` quando il tuo clone non esegue il fetch di quel branch; prima amplia il refspec come descritto sopra.
3322* Se il repository non ha un remote, aggiungete uno con `git remote add origin <url>` e recuperate prima di creare il ref. Se il remote è vuoto, spingete il vostro ramo prima con `git push -u origin HEAD` e nominate quel ramo nel comando set-head; `origin/HEAD` quindi punta al ramo che avete appena spinto, quindi `/security-review` vede un diff vuoto fino a quando il ramo non diverge da esso.3345* Se il repository non ha un remote, aggiungine uno con `git remote add origin <url>` ed esegui il fetch prima di creare il ref. Se il remote è vuoto, esegui prima il push del tuo branch con `git push -u origin HEAD` e indica quel branch nel comando set-head; `origin/HEAD` punterà quindi al branch di cui hai appena fatto il push, quindi `/security-review` vede un diff vuoto finché il branch non diverge da esso.
3323 3346
3324<h3 id="input-must-be-provided-when-using-print">3347<h3 id="input-must-be-provided-when-using-print">
3325 L'input deve essere fornito quando si utilizza `--print`3348 L'input deve essere fornito quando si usa `--print`
3326</h3>3349</h3>
3327 3350
3328`claude` nudo ha bisogno che stdout sia un terminale per avviare l'interfaccia utente interattiva. Quando stdout è reindirizzato, o la console non è un vero terminale, come PowerShell ISE e alcuni riquadri di output IDE, `claude` esegue [in modo non interattivo](/docs/it/headless) invece. Questa è la stessa modalità di `claude -p`, che richiede un prompt, quindi il messaggio nomina `--print` anche se non avete passato il flag. Passare `-p`/`--print` senza prompt e nulla pipato su stdin produce lo stesso errore ovunque.3351Il semplice `claude` richiede che stdout sia un terminale per avviare l'interfaccia interattiva. Quando stdout è reindirizzato, o la console non è un vero terminale, come PowerShell ISE e alcuni pannelli di output degli IDE, `claude` viene invece eseguito in [modalità non interattiva](/docs/it/headless). È la stessa modalità di `claude -p`, che richiede un prompt, quindi il messaggio menziona `--print` anche se non hai passato il flag. Passare `-p`/`--print` senza prompt e senza nulla inviato tramite pipe su stdin produce lo stesso errore ovunque.
3329 3352
3330```text theme={null}3353```text theme={null}
3331Error: Input must be provided either through stdin or as a prompt argument when using --print3354Error: Input must be provided either through stdin or as a prompt argument when using --print
3333 3356
3334**Cosa fare:**3357**Cosa fare:**
3335 3358
3336* Per l'uso interattivo, eseguite `claude` in un vero terminale: Windows Terminal o la console PowerShell piuttosto che ISE, e il terminale integrato del vostro IDE piuttosto che un riquadro di output3359* Per l'uso interattivo, esegui `claude` in un vero terminale: Windows Terminal o la console di PowerShell anziché ISE, e il terminale integrato del tuo IDE anziché un pannello di output
3337* Per l'uso una tantum, passate il prompt: `claude -p "your question"`, oppure pipate con `echo "your question" | claude -p`3360* Per un uso singolo, passa il prompt: `claude -p "your question"`, oppure invialo tramite pipe con `echo "your question" | claude -p`
3338 3361
3339<h3 id="input-contained-only-whitespace">3362<h3 id="input-contained-only-whitespace">
3340 L'input conteneva solo spazi bianchi3363 L'input conteneva solo spazi vuoti
3341</h3>3364</h3>
3342 3365
3343In [modalità non interattiva](/docs/it/headless), Claude Code rifiuta un prompt composto interamente da spazi, tabulazioni o newline invece di inviarlo, perché l'API rifiuta i messaggi senza testo visibile. Quale messaggio vedete dipende da dove è venuto il prompt vuoto:3366In [modalità non interattiva](/docs/it/headless), Claude Code rifiuta un prompt composto interamente da spazi, tabulazioni o a capo invece di inviarlo, perché l'API rifiuta i messaggi privi di testo visibile. Il messaggio che vedi dipende da dove proviene il prompt vuoto:
3344 3367
3345* **Argomento prompt o stdin pipato per `claude -p`**: `claude` esce con `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`3368* **Argomento prompt o stdin tramite pipe per `claude -p`**: `claude` termina con `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
3346* **Messaggio inviato a una sessione `--input-format stream-json` o [Agent SDK](/docs/it/agent-sdk/overview) in esecuzione**: Claude Code termina il turno senza chiamare il modello e la sessione rimane utilizzabile. Il rifiuto arriva come messaggio informativo e come testo del risultato del turno: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3369* **Messaggio inviato a una sessione `--input-format stream-json` o [Agent SDK](/docs/it/agent-sdk/overview) in esecuzione**: Claude Code termina il turno senza chiamare il modello e la sessione rimane utilizzabile. Il rifiuto arriva come messaggio informativo e come testo del risultato del turno: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`
3347 3370
3348Prima della v2.1.229, Claude Code inviava il messaggio solo spazi bianchi all'API, che rifiutava la richiesta con un errore 400.3371Prima della v2.1.229, Claude Code inviava il messaggio composto solo da spazi vuoti all'API, che rifiutava la richiesta con un errore 400.
3349 3372
3350**Cosa fare:**3373**Cosa fare:**
3351 3374
3352* Includete testo visibile nel prompt. Se uno script costruisce il prompt da una variabile o file, controllate che la fonte non sia vuota prima di chiamare Claude Code.3375* Includi testo visibile nel prompt. Se uno script costruisce il prompt da una variabile o da un file, verifica che la fonte non sia vuota prima di chiamare Claude Code.
3353 3376
3354<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3377<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
3355 L'input stream-json ha superato 256M caratteri senza newline3378 L'input stream-json conteneva oltre 256M caratteri senza a capo
3356</h3>3379</h3>
3357 3380
3358Il vostro programma ha inviato più di 268.435.456 caratteri su stdin senza newline a un'esecuzione `claude -p --input-format stream-json`, quindi Claude Code stampa questo errore su stderr ed esce con codice 1 invece di bufferizzare più input. Il messaggio dichiara quel budget come `256M`. Prima della v2.1.257, Claude Code bufferizzava tale input senza limiti, facendo crescere la memoria fino a quando il processo si bloccava o veniva ucciso.3381Il tuo programma ha inviato più di 268.435.456 caratteri su stdin senza un a capo a un'esecuzione `claude -p --input-format stream-json`, quindi Claude Code stampa questo errore su stderr e termina con codice di uscita 1 invece di bufferizzare altro input. Il messaggio indica quel limite come `256M`. Prima della v2.1.257, Claude Code bufferizzava tale input senza limiti, facendo crescere la memoria finché il processo non si arrestava in modo anomalo o veniva terminato.
3359 3382
3360```text theme={null}3383```text theme={null}
3361Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3384Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
3362```3385```
3363 3386
3364L'input così lungo senza newline di solito significa che il produttore non è affatto un produttore stream-json, come un file binario o output di log semplice pipato per errore. Un singolo messaggio oltre il budget fallisce lo stesso controllo.3387Un input così lungo senza a capo di solito significa che il produttore non è affatto un produttore stream-json, ad esempio un file binario o un normale output di log inviato tramite pipe per errore. Un singolo messaggio che supera il limite non supera lo stesso controllo.
3365 3388
3366**Cosa fare:**3389**Cosa fare:**
3367 3390
3368* Controllate cosa è pipato su stdin. Con [`--input-format stream-json`](/docs/it/cli-reference#cli-flags), ogni messaggio deve essere una riga JSON terminata da newline3391* Controlla cosa viene inviato tramite pipe a stdin. Con [`--input-format stream-json`](/docs/it/cli-reference#cli-flags), ogni messaggio deve essere una singola riga JSON terminata da un a capo
3369* Per inviare testo semplice invece, eliminate `--input-format stream-json`; `claude -p` legge un prompt di testo semplice da stdin per impostazione predefinita3392* Per inviare invece testo semplice, rimuovi `--input-format stream-json`; `claude -p` legge per impostazione predefinita un prompt di testo semplice da stdin
3370 3393
3371<h3 id="unknown-command">3394<h3 id="unknown-command">
3372 Comando sconosciuto3395 Comando sconosciuto
3373</h3>3396</h3>
3374 3397
3375In una sessione terminale interattiva, avete inviato un nome `/` che non corrisponde a nessun comando in questa sessione, quindi Claude Code segnala il nome invece di eseguire qualsiasi cosa:3398In una sessione interattiva del terminale, hai inviato un nome con `/` che non corrisponde ad alcun comando in questa sessione, quindi Claude Code riporta il nome invece di eseguire qualcosa:
3376 3399
3377```text theme={null}3400```text theme={null}
3378Unknown command: /hepl. Did you mean /help?3401Unknown command: /hepl. Did you mean /help?
3379```3402```
3380 3403
3381Claude Code suggerisce il nome di comando o alias più vicino che il menu elenca in questa sessione. Quando nulla è vicino, il messaggio termina dopo il nome. La causa è di solito una delle seguenti:3404Claude Code suggerisce il nome di comando o l'alias più vicino tra quelli elencati nel menu in questa sessione. Quando nulla è simile, il messaggio termina dopo il nome. La causa è di solito una delle seguenti:
3382 3405
3383* Un errore di battitura, come `/hepl` per `/help`. [How the command menu matches what you type](/docs/it/commands#how-the-command-menu-matches-what-you-type) copre la scelta di una corrispondenza vicina prima di inviare3406* Un errore di battitura, come `/hepl` al posto di `/help`. [Come il menu dei comandi trova corrispondenze con ciò che digiti](/docs/it/commands#how-the-command-menu-matches-what-you-type) spiega come scegliere una corrispondenza simile prima dell'invio
3384* Un comando che esiste ma non è disponibile in questa sessione perché un requisito non è soddisfatto, come la vostra piattaforma, piano o metodo di autenticazione. Le voci di risoluzione dei problemi per [`/web-setup`](/docs/it/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) e [`/schedule`](/docs/it/routines#schedule-returns-unknown-command) illustrano due casi comuni. Alcuni comandi rispondono con il loro messaggio quando la politica della vostra organizzazione li disabilita, come [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3407* Un comando che esiste ma non è disponibile in questa sessione perché un requisito non è soddisfatto, come la tua piattaforma, il tuo piano o il tuo metodo di autenticazione. Le voci di risoluzione dei problemi per [`/web-setup`](/docs/it/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) e [`/schedule`](/docs/it/routines#schedule-returns-unknown-command) illustrano due casi comuni. Alcuni comandi rispondono con un proprio messaggio quando la policy della tua organizzazione li disabilita, come [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3385* Un comando da un [plugin](/docs/it/plugins/overview) o [server MCP](/docs/it/mcp#use-mcp-prompts-as-commands) che non è installato o connesso in questa sessione3408* Un comando di un [plugin](/docs/it/plugins/overview) o di un [server MCP](/docs/it/mcp#use-mcp-prompts-as-commands) che non è installato o connesso in questa sessione
3386 3409
3387Claude Code risponde a un nome `/` non corrispondente in questo modo solo in una sessione terminale interattiva. In ogni altra sessione, invia il prompt a Claude come messaggio normale invece, con una nota che il comando non è stato eseguito e un elenco di comandi che Claude può eseguire nella sessione. Quelle sessioni includono:3410Claude Code risponde in questo modo a un nome con `/` senza corrispondenza solo in una sessione interattiva del terminale. In tutte le altre sessioni, invia invece il prompt a Claude come un normale messaggio, con una nota che indica che il comando non è stato eseguito e un elenco di comandi che Claude può eseguire nella sessione. Queste sessioni includono:
3388 3411
3389* Esecuzioni `-p`3412* Esecuzioni con `-p`
3390* Applicazioni [Agent SDK](/docs/it/agent-sdk/overview)3413* Applicazioni [Agent SDK](/docs/it/agent-sdk/overview)
3391* La scheda Code dell'[app Desktop](/docs/it/desktop)3414* La scheda Code dell'[app Desktop](/docs/it/desktop)
3392* Il pannello chat dell'[estensione VS Code](/docs/it/vs-code)3415* Il pannello della chat dell'[estensione VS Code](/docs/it/vs-code)
3393* [Sessioni cloud](/docs/it/claude-code-on-the-web) e [routine](/docs/it/routines)3416* [Sessioni cloud](/docs/it/claude-code-on-the-web) e [routine](/docs/it/routines)
3394 3417
3395Per un comando integrato che non può essere eseguito in una di quelle sessioni, Claude Code risponde comunque che il comando non è disponibile invece di inviarlo a Claude. Prima della v2.1.274, solo le sessioni cloud e le routine inviavano un nome non corrispondente a Claude. Prima della v2.1.273, rispondevano anche `Unknown command`.3418Per un comando integrato che non può essere eseguito in una di queste sessioni, Claude Code risponde comunque che il comando non è disponibile invece di inviarlo a Claude. Prima della v2.1.274, solo le sessioni cloud e le routine inviavano a Claude un nome senza corrispondenza. Prima della v2.1.273, anche loro rispondevano `Unknown command`.
3396 3419
3397Claude Code non tratta ogni prompt che inizia con `/` come un comando. Invia il prompt a Claude come messaggio normale quando la prima parola dopo il `/` inizia con punteggiatura, come il `/-` che apre un commento doc Lean, o è un percorso come `/var/log/syslog`.3420Claude Code non tratta ogni prompt che inizia con `/` come un comando. Invia il prompt a Claude come un normale messaggio quando la prima parola dopo `/` inizia con un segno di punteggiatura, come il `/--` che apre un commento di documentazione Lean, oppure è un percorso come `/var/log/syslog`.
3398 3421
3399Prima della v2.1.236, se premevate `Invio` mentre il menu dei comandi elencava una corrispondenza vicina per il nome che avete digitato, Claude Code eseguiva quella corrispondenza, quindi un errore di battitura come `/hepl` eseguiva `/help` invece di produrre questo messaggio.3422Prima della v2.1.236, se premevi `Enter` mentre il menu dei comandi elencava una corrispondenza simile al nome digitato, Claude Code eseguiva quella corrispondenza, quindi un errore di battitura come `/hepl` eseguiva `/help` invece di produrre questo messaggio.
3400 3423
3401**Cosa fare:**3424**Cosa fare:**
3402 3425
3403* Eseguite il nome suggerito, oppure digitate `/` seguito da parte del nome per vedere cosa è disponibile in questa sessione3426* Esegui il nome suggerito, oppure digita `/` seguito da parte del nome per vedere cosa è disponibile in questa sessione
3404* Se Claude Code segnala un comando documentato come sconosciuto, controllate la sua riga nel [riferimento dei comandi](/docs/it/commands) per il requisito che nomina3427* Se Claude Code segnala come sconosciuto un comando documentato, controlla la sua riga nel [riferimento dei comandi](/docs/it/commands) per il requisito che indica
3405 3428
3406<h3 id="diff-is-too-large-for-ultrareview">3429<h3 id="diff-is-too-large-for-ultrareview">
3407 Il diff è troppo grande per ultrareview3430 Il diff è troppo grande per ultrareview
3408</h3>3431</h3>
3409 3432
3410Il diff tra il vostro ramo e il ramo base, incluse le modifiche non committate e staged, supera i limiti di dimensione per un [ultrareview](/docs/it/ultrareview), quindi `/code-review ultra` e il sottocomando `claude ultrareview` rifiutano la revisione prima che la sessione cloud si avvii. Una revisione rifiutata non utilizza un'esecuzione gratuita e non fattura i crediti di utilizzo. Il messaggio nomina i limiti in vigore, la dimensione del vostro diff e i file che contribuiscono il maggior numero di righe modificate. Prima della v2.1.216, il messaggio mostrava solo le statistiche di diff grezze.3433Il diff tra il tuo branch e il branch di base, incluse le modifiche non committate e in staging, supera i limiti di dimensione per una [ultrareview](/docs/it/ultrareview), quindi `/code-review ultra` e il sottocomando `claude ultrareview` rifiutano la revisione prima dell'avvio della sessione cloud. Una revisione rifiutata non consuma un'esecuzione gratuita e non addebita crediti di utilizzo. Il messaggio indica i limiti in vigore, la dimensione del tuo diff e i file che contribuiscono con il maggior numero di righe modificate. Prima della v2.1.216, il messaggio mostrava solo le statistiche grezze del diff.
3411 3434
3412```text theme={null}3435```text theme={null}
3413Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3436Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
3414```3437```
3415 3438
3416La revisione di una pull request applica gli stessi limiti; quella forma del messaggio inizia `PR #<N> is too large for ultrareview` e nomina i conteggi di file e righe della PR.3439La revisione di una pull request applica gli stessi limiti; quella forma del messaggio inizia con `PR #<N> is too large for ultrareview` e indica il numero di file e di righe della PR.
3417 3440
3418**Cosa fare:**3441**Cosa fare:**
3419 3442
3420* Passate un ramo base più vicino al vostro lavoro, come `/code-review ultra develop`, in modo che la revisione copra solo il diff rispetto a quel ramo3443* Passa un branch di base più vicino al tuo lavoro, come `/code-review ultra develop`, in modo che la revisione copra solo il diff rispetto a quel branch
3421* Dividete la modifica in rami più piccoli e revisionate ognuno. I file che il messaggio nomina contribuiscono il maggior numero di righe modificate, quindi iniziate spostando quelli nel loro ramo.3444* Suddividi la modifica in branch più piccoli e rivedi ciascuno di essi. I file indicati dal messaggio contribuiscono con il maggior numero di righe modificate, quindi inizia spostandoli in un branch dedicato.
3422 3445
3423<h3 id="could-not-find-merge-base-with-the-base-branch">3446<h3 id="could-not-find-merge-base-with-the-base-branch">
3424 Non è stato possibile trovare merge-base con il ramo base3447 Impossibile trovare il merge-base con il branch di base
3425</h3>3448</h3>
3426 3449
3427`/code-review ultra` e il sottocomando `claude ultrareview` revisione il diff tra il vostro ramo e un ramo base, che ha bisogno di un commit che i due condividono. Quando `git merge-base` non ne trova nessuno, Claude Code rifiuta la revisione prima che la sessione cloud si avvii. Su un clone che Claude Code può verificare è completo, con almeno un ramo, ricade a [revisione di ogni file tracciato](/docs/it/ultrareview#diff-limits-and-fallbacks) invece di rifiutare. Vedete questo rifiuto quando il ramo base non può essere trovato affatto, quando Claude Code non può verificare che il vostro clone è completo, o nel raro repository dove il diff dell'intero albero non è possibile, come il formato di oggetto SHA-256.3450`/code-review ultra` e il sottocomando `claude ultrareview` rivedono il diff tra il tuo branch e un branch di base, il che richiede un commit condiviso tra i due. Quando `git merge-base` non ne trova nessuno, Claude Code rifiuta la revisione prima dell'avvio della sessione cloud. Su un clone che Claude Code può verificare come completo, con almeno un branch, ripiega sulla [revisione di tutti i file tracciati](/docs/it/ultrareview#diff-limits-and-fallbacks) invece di rifiutare. Vedi questo rifiuto quando il branch di base non può essere trovato affatto, quando Claude Code non può verificare che il tuo clone sia completo, o nel raro repository in cui il diff dell'intero albero non è possibile, come con il formato oggetti SHA-256.
3428 3451
3429```text theme={null}3452```text theme={null}
3430Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3453Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
3431```3454```
3432 3455
3433Il suggerimento dopo la prima frase dipende da cosa Claude Code ha osservato:3456Il suggerimento dopo la prima frase dipende da ciò che Claude Code ha osservato:
3434 3457
3435* **Non avete passato un ramo base**: Claude Code ha confrontato rispetto al ramo predefinito del repository e suggerisce di passare il vostro base esplicitamente, come nell'esempio sopra3458* **Non hai passato un branch di base**: Claude Code ha eseguito il confronto con il branch predefinito del repository e suggerisce di passare esplicitamente la tua base, come nell'esempio precedente
3436* **Avete passato un ramo base che era già nel vostro clone**: il suggerimento legge ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3459* **Hai passato un branch di base che era già nel tuo clone**: il suggerimento riporta ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3437* **Avete passato un ramo base che non era nel vostro clone**: Claude Code lo ha recuperato da origin prima di confrontare. Il suggerimento legge ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando Claude Code non può dire se il vostro clone è superficiale, suggerisce `git fetch --unshallow origin` invece. Prima della v2.1.221, il suggerimento suggeriva `git fetch --unshallow origin` per ogni ramo base recuperato, e su un clone completo quel comando fallisce con `fatal: --unshallow on a complete repository does not make sense`.3460* **Hai passato un branch di base che non era nel tuo clone**: Claude Code ne ha eseguito il fetch da origin prima del confronto. Il suggerimento riporta ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando Claude Code non riesce a stabilire se il tuo clone è shallow, suggerisce invece `git fetch --unshallow origin`. Prima della v2.1.221, il suggerimento proponeva `git fetch --unshallow origin` per ogni branch di base recuperato con fetch, e su un clone completo quel comando fallisce con `fatal: --unshallow on a complete repository does not make sense`.
3438 3461
3439**Cosa fare:**3462**Cosa fare:**
3440 3463
3441* Se un altro ramo è il vostro vero base, passatelo esplicitamente: `/code-review ultra <branch>`3464* Se un altro branch è la tua vera base, passalo esplicitamente: `/code-review ultra <branch>`
3442* Se il vostro clone potrebbe non avere la cronologia completa, eseguite `git fetch --unshallow origin` e rieseguite la revisione3465* Se il tuo clone potrebbe non avere la cronologia completa, esegui `git fetch --unshallow origin` ed esegui di nuovo la revisione
3443 3466
3444<h3 id="your-checkout-has-no-branches">3467<h3 id="your-checkout-has-no-branches">
3445 Il vostro checkout non ha rami3468 Il tuo checkout non ha branch
3446</h3>3469</h3>
3447 3470
3448Un checkout può avere commit ma nessun ramo: se eseguite `git init` seguito da `git fetch <url>` e `git checkout FETCH_HEAD`, ottenete un HEAD staccato senza ref. Claude Code pacchetto il vostro repository come un bundle git per caricarlo per un [ultrareview](/docs/it/ultrareview), e non può pacchetto un repository che non ha rami o altri ref, quindi `/code-review ultra` e il sottocomando `claude ultrareview` rifiutano la revisione prima che la sessione cloud si avvii.3471Un checkout può avere commit ma nessun branch: se esegui `git init` seguito da `git fetch <url>` e `git checkout FETCH_HEAD`, ottieni un HEAD scollegato senza ref. Claude Code impacchetta il tuo repository come bundle git per caricarlo per una [ultrareview](/docs/it/ultrareview), e non può creare il bundle di un repository che non ha branch né altri ref, quindi `/code-review ultra` e il sottocomando `claude ultrareview` rifiutano la revisione prima dell'avvio della sessione cloud.
3449 3472
3450```text theme={null}3473```text theme={null}
3451Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3474Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
3452```3475```
3453 3476
3454Prima della v2.1.221, Claude Code tentava di revisione ogni file tracciato in questo checkout, e il caricamento falliva.3477Prima della v2.1.221, Claude Code tentava di rivedere ogni file tracciato in questo checkout, e il caricamento falliva.
3455 3478
3456**Cosa fare:**3479**Cosa fare:**
3457 3480
3458* Create un ramo al vostro commit corrente con `git checkout -b <name>`, quindi rieseguite la revisione3481* Crea un branch al tuo commit corrente con `git checkout -b <name>`, quindi esegui di nuovo la revisione
3459 3482
3460<h3 id="no-github-account-is-connected-to-your-claude-account">3483<h3 id="no-github-account-is-connected-to-your-claude-account">
3461 Nessun account GitHub è connesso al vostro account Claude3484 Nessun account GitHub è connesso al tuo account Claude
3462</h3>3485</h3>
3463 3486
3464Avete eseguito `/code-review ultra <PR#>` o `claude ultrareview <PR#>`, e prima di creare la sessione cloud Claude Code chiede al server se [l'account GitHub connesso al vostro account Claude](/docs/it/ultrareview#review-a-pull-request) può raggiungere il repository della PR. Nessun account è connesso, o la connessione è scaduta, quindi il clone cloud fallirebbe e Claude Code rifiuta il lancio. Claude Code non spende un'esecuzione gratuita o fattura i crediti di utilizzo per un lancio rifiutato.3487Hai eseguito `/code-review ultra <PR#>` o `claude ultrareview <PR#>`, e prima di creare la sessione cloud Claude Code chiede al server se [l'account GitHub connesso al tuo account Claude](/docs/it/ultrareview#review-a-pull-request) può raggiungere il repository della PR. Nessun account è connesso, oppure la connessione è scaduta, quindi il clone nel cloud fallirebbe e Claude Code rifiuta l'avvio. Claude Code non consuma un'esecuzione gratuita né addebita crediti di utilizzo per un avvio rifiutato.
3465 3488
3466```text theme={null}3489```text theme={null}
3467Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3490Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
3468```3491```
3469 3492
3470Quando [`/web-setup`](/docs/it/web-quickstart#connect-from-your-terminal) non è disponibile nella vostra sessione, il messaggio nomina solo il link claude.ai.3493Quando [`/web-setup`](/docs/it/web-quickstart#connect-from-your-terminal) non è disponibile nella tua sessione, il messaggio indica solo il link di claude.ai.
3471 3494
3472**Cosa fare:**3495**Cosa fare:**
3473 3496
3474* Eseguite `/web-setup` per connettere il vostro login GitHub CLI al vostro account Claude, oppure connettete un account su [claude.ai/connect-github](https://claude.ai/connect-github)3497* Esegui `/web-setup` per connettere il tuo accesso alla GitHub CLI al tuo account Claude, oppure connetti un account su [claude.ai/connect-github](https://claude.ai/connect-github)
3475* Rieseguite la revisione un minuto dopo la connessione3498* Esegui di nuovo la revisione un minuto dopo la connessione
3476 3499
3477Prima della v2.1.248, Claude Code non controllava questo prima del lancio.3500Prima della v2.1.248, Claude Code non eseguiva questo controllo prima dell'avvio.
3478 3501
3479<h3 id="your-connected-github-account-cant-see-the-repository">3502<h3 id="your-connected-github-account-cant-see-the-repository">
3480 Il vostro account GitHub connesso non riesce a vedere il repository3503 Il tuo account GitHub connesso non può vedere il repository
3481</h3>3504</h3>
3482 3505
3483Avete eseguito `/code-review ultra <PR#>` o `claude ultrareview <PR#>`, e [l'account GitHub connesso al vostro account Claude](/docs/it/ultrareview#review-a-pull-request) non riesce a leggere il repository della PR, quindi il clone cloud fallirebbe e Claude Code rifiuta il lancio. Claude Code non spende un'esecuzione gratuita o fattura i crediti di utilizzo per un lancio rifiutato.3506Hai eseguito `/code-review ultra <PR#>` o `claude ultrareview <PR#>`, e [l'account GitHub connesso al tuo account Claude](/docs/it/ultrareview#review-a-pull-request) non può leggere il repository della PR, quindi il clone nel cloud fallirebbe e Claude Code rifiuta l'avvio. Claude Code non consuma un'esecuzione gratuita né addebita crediti di utilizzo per un avvio rifiutato.
3484 3507
3485```text theme={null}3508```text theme={null}
3486Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3509Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
3487```3510```
3488 3511
3489Quando [`/web-setup`](/docs/it/web-quickstart#connect-from-your-terminal) non è disponibile nella vostra sessione, il messaggio nomina solo l'installazione dell'app.3512Quando [`/web-setup`](/docs/it/web-quickstart#connect-from-your-terminal) non è disponibile nella tua sessione, il messaggio indica solo l'installazione dell'app.
3490 3513
3491**Cosa fare:**3514**Cosa fare:**
3492 3515
3493* Se il vostro CLI `gh` locale riesce a leggere il repository, eseguite `/web-setup` per connettere quel login al vostro account Claude3516* Se la tua CLI `gh` locale può leggere il repository, esegui `/web-setup` per connettere quell'accesso al tuo account Claude
3494* Rieseguite la revisione dopo la modifica3517* Esegui di nuovo la revisione dopo la modifica
3495 3518
3496Prima della v2.1.248, Claude Code non controllava questo prima del lancio.3519Prima della v2.1.248, Claude Code non eseguiva questo controllo prima dell'avvio.
3497 3520
3498<h3 id="the-github-app-preflight-failed-transiently">3521<h3 id="the-github-app-preflight-failed-transiently">
3499 Il preflight dell'app GitHub ha fallito transientemente3522 Il controllo preliminare della GitHub App è fallito temporaneamente
3500</h3>3523</h3>
3501 3524
3502Avete avviato una [sessione cloud](/docs/it/claude-code-on-the-web) da un repository locale, e due passaggi hanno fallito insieme. Claude Code non ha potuto costruire o caricare il bundle del vostro repository. Prima del caricamento, ha controllato se il servizio cloud può clonare il repository da GitHub, e piuttosto che una risposta definitiva, quel controllo è terminato in un errore che un nuovo tentativo potrebbe cancellare, come un errore di rete, un timeout o un errore di server temporaneo. Il messaggio completo inizia con cosa ha fermato il bundle, ad esempio `Could not upload repo bundle (<error>)`, e termina con la frase di preflight:3525Hai avviato una [sessione cloud](/docs/it/claude-code-on-the-web) da un repository locale, e due passaggi sono falliti insieme. Claude Code non è riuscito a creare o caricare il bundle del tuo repository. Prima del caricamento, ha verificato se il servizio cloud può clonare il repository da GitHub, e invece di una risposta definitiva, quel controllo si è concluso con un errore che un nuovo tentativo potrebbe risolvere, come un errore di rete, un timeout o un errore temporaneo del server. Il messaggio completo inizia con ciò che ha bloccato il bundle, ad esempio `Could not upload repo bundle (<error>)`, e termina con la frase sul controllo preliminare:
3503 3526
3504```text theme={null}3527```text theme={null}
3505Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3528Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3507 3530
3508**Cosa fare:**3531**Cosa fare:**
3509 3532
3510* Rieseguite il comando dopo un momento. Quando il controllo GitHub passa, Claude Code può avviare la sessione da un clone GitHub, quindi il caricamento fallito non blocca più il lancio3533* Esegui di nuovo il comando dopo un momento. Quando il controllo di GitHub ha esito positivo, Claude Code può avviare la sessione da un clone di GitHub, quindi il caricamento non riuscito non blocca più l'avvio
3511* Se i nuovi tentativi continuano a fallire, l'inizio del messaggio nomina cosa ha fermato il caricamento. Quando quella causa è qualcosa che potete correggere, correggete in modo che la sessione possa avviarsi dal vostro repository locale invece3534* Se i nuovi tentativi continuano a fallire, l'inizio del messaggio indica cosa ha bloccato il caricamento. Quando quella causa è qualcosa che puoi correggere, correggila in modo che la sessione possa invece avviarsi dal tuo repository locale
3512 3535
3513Prima della v2.1.251, Claude Code terminava il messaggio con `Please set up GitHub on https://claude.ai/code` anche quando il controllo GitHub falliva solo transientemente, e il consiglio di configurazione non può cancellare un fallimento transitorio.3536Prima della v2.1.251, Claude Code terminava il messaggio con `Please set up GitHub on https://claude.ai/code` anche quando il controllo di GitHub falliva solo temporaneamente, e un consiglio di configurazione non può risolvere un errore temporaneo.
3514 3537
3515<h3 id="the-repository-upload-cant-follow-a-git-setting">3538<h3 id="the-repository-upload-cant-follow-a-git-setting">
3516 Il caricamento del repository non può seguire un'impostazione git3539 Il caricamento del repository non può seguire un'impostazione git
3517</h3>3540</h3>
3518 3541
3519Avete avviato una [sessione cloud che carica il vostro repository locale](/docs/it/claude-code-on-the-web#send-local-repositories-without-github), o un [ultrareview](/docs/it/ultrareview) di un ramo, e il caricamento non può seguire una delle impostazioni git che decidono quali regole di attributo si applicano ai vostri file. Se il caricamento fosse andato avanti e avesse perso una regola, un file che git trasforma prima di memorizzarlo, come uno che un filtro pulito crittografa, potrebbe raggiungere il cloud come è su disco. Claude Code rifiuta il caricamento invece, e nulla viene caricato:3542Hai avviato una [sessione cloud che carica il tuo repository locale](/docs/it/claude-code-on-the-web#send-local-repositories-without-github), oppure una [ultrareview](/docs/it/ultrareview) di un branch, e il caricamento non può seguire una delle impostazioni git che determinano quali regole di attributi si applicano ai tuoi file. Se il caricamento procedesse e trascurasse una regola, un file che git trasforma prima di memorizzarlo, come uno che un filtro clean cifra, potrebbe arrivare nel cloud così com'è su disco. Claude Code rifiuta invece il caricamento, e nulla viene caricato:
3520 3543
3521```text theme={null}3544```text theme={null}
3522Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.3545Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
3523```3546```
3524 3547
3525Il messaggio nomina l'impostazione e dove è impostata, e termina con la correzione per il caso che avete colpito. Lo stesso rifiuto appare per `core.attributesFile` e `attr.tree`, ognuno con la sua correzione.3548Il messaggio indica l'impostazione e dove è impostata, e termina con la soluzione per il caso in cui ti trovi. Lo stesso rifiuto appare per `core.attributesFile` e `attr.tree`, ciascuno con la propria soluzione.
3526 3549
3527Il messaggio può nominare un file di configurazione che la vostra configurazione git tira in attraverso una direttiva `include` o `includeIf`, anche quando la condizione di quella direttiva non si applica a questo repository.3550Il messaggio può indicare un file di configurazione che la tua configurazione git include tramite una direttiva `include` o `includeIf`, anche quando la condizione di quella direttiva non si applica a questo repository.
3528 3551
3529**Cosa fare:**3552**Cosa fare:**
3530 3553
3531* Applicate la correzione nella frase finale del messaggio3554* Applica la soluzione indicata nell'ultima frase del messaggio
3532 3555
3533<h3 id="github-isnt-connected-to-your-claude-account">3556<h3 id="github-isnt-connected-to-your-claude-account">
3534 GitHub non è connesso al vostro account Claude3557 GitHub non è connesso al tuo account Claude
3535</h3>3558</h3>
3536 3559
3537Avete avviato una [sessione cloud](/docs/it/claude-code-on-the-web) dal vostro repository locale, ad esempio con `/autofix-pr`. Nessun account GitHub è connesso al vostro account Claude, o la connessione è scaduta, quindi Claude Code rifiuta il lancio:3560Hai avviato una [sessione cloud](/docs/it/claude-code-on-the-web) dal tuo repository locale, ad esempio con `/autofix-pr`. Nessun account GitHub è connesso al tuo account Claude, oppure la connessione è scaduta, quindi Claude Code rifiuta l'avvio:
3538 3561
3539```text theme={null}3562```text theme={null}
3540GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3563GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
3541```3564```
3542 3565
3543Quando create una routine con [`/schedule`](/docs/it/routines), lo stesso messaggio appare come una nota di configurazione che nomina il repository; la nota non blocca la creazione della routine.3566Quando crei una routine con [`/schedule`](/docs/it/routines), lo stesso messaggio appare come nota di configurazione che indica il repository; la nota non impedisce la creazione della routine.
3544 3567
3545**Cosa fare:**3568**Cosa fare:**
3546 3569
3547* Eseguite `/web-setup` per connettere il vostro login GitHub CLI al vostro account Claude, oppure connettete un account su [claude.ai/connect-github](https://claude.ai/connect-github). Vedete [GitHub authentication options](/docs/it/claude-code-on-the-web#github-authentication-options) per come i due differiscono.3570* Esegui `/web-setup` per connettere il tuo accesso alla GitHub CLI al tuo account Claude, oppure connetti un account su [claude.ai/connect-github](https://claude.ai/connect-github). Consulta [Opzioni di autenticazione GitHub](/docs/it/claude-code-on-the-web#github-authentication-options) per le differenze tra le due opzioni.
3548* Rieseguite il comando un minuto dopo la connessione3571* Esegui di nuovo il comando un minuto dopo la connessione
3549 3572
3550Prima della v2.1.268, Claude Code segnalava questo come un fallimento temporaneo del controllo dell'app GitHub di Claude e suggeriva di riprovare o installare l'app; nessuno dei due connette un account GitHub.3573Prima della v2.1.268, Claude Code segnalava questa situazione come un errore temporaneo del controllo della Claude GitHub App e suggeriva di riprovare o di installare l'app; nessuna delle due azioni connette un account GitHub.
3551 3574
3552<h3 id="single-sign-on-authorization-needed">3575<h3 id="single-sign-on-authorization-needed">
3553 Autorizzazione single sign-on necessaria3576 Autorizzazione single sign-on necessaria
3554</h3>3577</h3>
3555 3578
3556Avete eseguito [`/install-github-app`](/docs/it/github-actions#quick-setup) e scelto un repository la cui organizzazione applica il single sign-on SAML. Prima della configurazione, Claude Code controlla il vostro accesso al repository con la CLI GitHub, e GitHub ha rifiutato quel controllo perché il vostro token `gh` non è ancora autorizzato per l'organizzazione. La procedura guidata mostra l'avviso con i passaggi per autorizzare:3579Hai eseguito [`/install-github-app`](/docs/it/github-actions#quick-setup) e scelto un repository la cui organizzazione impone il single sign-on SAML. Prima della configurazione, Claude Code verifica il tuo accesso al repository con la GitHub CLI, e GitHub ha rifiutato quel controllo perché il tuo token `gh` non è ancora autorizzato per l'organizzazione. La procedura guidata mostra l'avviso con i passaggi per l'autorizzazione:
3557 3580
3558```text theme={null}3581```text theme={null}
3559Single sign-on authorization needed3582Single sign-on authorization needed
3562 3585
3563**Cosa fare:**3586**Cosa fare:**
3564 3587
3565* Riautorizzate il vostro login GitHub CLI con gli ambiti `repo` e `workflow` eseguendo `gh auth refresh -h github.com -s repo,workflow`, e autorizzate l'organizzazione quando GitHub chiede il single sign-on3588* Autorizza di nuovo il tuo accesso alla GitHub CLI con gli scope `repo` e `workflow` eseguendo `gh auth refresh -h github.com -s repo,workflow`, e autorizza l'organizzazione quando GitHub richiede il single sign-on
3566* Se vi autenticate con un token di accesso personale in `GH_TOKEN`, aprite [github.com/settings/tokens](https://github.com/settings/tokens), selezionate **Configure SSO** sul token, e autorizzate l'organizzazione3589* Se esegui l'autenticazione con un personal access token in `GH_TOKEN`, apri [github.com/settings/tokens](https://github.com/settings/tokens), seleziona **Configure SSO** sul token e autorizza l'organizzazione
3567* Eseguite di nuovo `/install-github-app`3590* Esegui di nuovo `/install-github-app`
3568 3591
3569Prima della v2.1.273, Claude Code mostrava l'avviso `Admin permissions required` per questa condizione invece.3592Prima della v2.1.273, Claude Code mostrava invece l'avviso `Admin permissions required` per questa condizione.
3570 3593
3571<h3 id="failed-to-resume-the-conversation">3594<h3 id="failed-to-resume-the-conversation">
3572 Impossibile riprendere la conversazione3595 Impossibile riprendere la conversazione
3573</h3>3596</h3>
3574 3597
3575Claude Code non ha potuto leggere o elaborare la trascrizione salvata per la sessione che avete selezionato dal [picker `claude --resume`](/docs/it/sessions#use-the-session-picker), quindi termina il processo piuttosto che continuare in uno stato parzialmente caricato. Il messaggio include il comando per riprovare:3598Claude Code non è riuscito a leggere o elaborare la trascrizione salvata per la sessione che hai selezionato dal [selettore di `claude --resume`](/docs/it/sessions#use-the-session-picker), quindi termina il processo invece di continuare in uno stato caricato parzialmente. Il messaggio include il comando per riprovare:
3576 3599
3577```text theme={null}3600```text theme={null}
3578Failed to resume the conversation.3601Failed to resume the conversation.
3579Run claude --resume <session-id> to retry, or claude to start a new session.3602Run claude --resume <session-id> to retry, or claude to start a new session.
3580```3603```
3581 3604
3582Claude Code esce con codice 1 dopo aver mostrato il messaggio. Il picker `/resume` dentro una sessione in esecuzione segnala `Failed to resume conversation` nella conversazione invece, e la vostra sessione corrente continua a funzionare. Prima della v2.1.216, una ripresa fallita dal picker `claude --resume` rimaneva sullo spinner `Resuming conversation…` indefinitamente invece di mostrare questo messaggio.3605Claude Code termina con codice di uscita 1 dopo aver mostrato il messaggio. Il selettore `/resume` all'interno di una sessione in esecuzione riporta invece `Failed to resume conversation` nella conversazione, e la tua sessione corrente continua a essere eseguita. Prima della v2.1.216, una ripresa non riuscita dal selettore di `claude --resume` rimaneva indefinitamente sullo spinner `Resuming conversation…` invece di mostrare questo messaggio.
3583 3606
3584**Cosa fare:**3607**Cosa fare:**
3585 3608
3586* Eseguite `claude --resume <session-id>` con l'ID della sessione dal messaggio per riprovare3609* Esegui `claude --resume <session-id>` con l'ID di sessione indicato nel messaggio per riprovare
3587* Se ogni nuovo tentativo fallisce allo stesso modo, eseguite `claude update` e riprendete di nuovo. Le versioni prima della v2.1.275 falliscono la ripresa quando la trascrizione salvata contiene una voce che non riescono a leggere.3610* Se ogni nuovo tentativo fallisce allo stesso modo, esegui `claude update` e riprendi di nuovo. Le versioni precedenti alla v2.1.275 fanno fallire la ripresa quando la trascrizione salvata contiene una voce che non riescono a leggere.
3588* Se il nuovo tentativo fallisce di nuovo, eseguite `claude` per avviare una nuova sessione3611* Se il nuovo tentativo fallisce di nuovo, esegui `claude` per avviare una nuova sessione
3589 3612
3590<h3 id="no-conversation-found-with-the-session-id">3613<h3 id="no-conversation-found-with-the-session-id">
3591 Nessuna conversazione trovata con l'ID della sessione3614 Nessuna conversazione trovata con l'ID di sessione
3592</h3>3615</h3>
3593 3616
3594Avete passato un ID della sessione a `claude --resume <session-id>` e nessuna trascrizione salvata lo ha abbinato:3617Hai passato un ID di sessione a `claude --resume <session-id>` e nessuna trascrizione salvata corrisponde a esso:
3595 3618
3596```text theme={null}3619```text theme={null}
3597No conversation found with session ID: <session-id>3620No conversation found with session ID: <session-id>
3598```3621```
3599 3622
3600Claude Code esce con codice 1 dopo aver mostrato il messaggio. Claude Code [cerca prima il progetto corrente, quindi ogni altro progetto su questa macchina](/docs/it/sessions#resume-a-session) per l'ID. Prima della v2.1.223, la ricerca si fermava alla directory del progetto corrente e ai suoi git worktrees, quindi riprendete dalla directory in cui la sessione ha lavorato l'ultima volta.3623Claude Code termina con codice di uscita 1 dopo aver mostrato il messaggio. Claude Code [cerca l'ID prima nel progetto corrente, poi in ogni altro progetto su questa macchina](/docs/it/sessions#resume-a-session). Prima della v2.1.223, la ricerca si fermava alla directory del progetto corrente e ai suoi worktree git, quindi riprendi dalla directory in cui la sessione ha lavorato per l'ultima volta.
3601 3624
3602Cause comuni:3625Cause comuni:
3603 3626
3604* **ID digitato male**: per un'esecuzione non interattiva, l'ID è il campo `session_id` dell'output [`--output-format json`](/docs/it/headless#get-structured-output)3627* **ID digitato in modo errato**: per un'esecuzione non interattiva, l'ID è il campo `session_id` dell'[output di `--output-format json`](/docs/it/headless#get-structured-output)
3605* **Trascrizione eliminata**: Claude Code rimuove le trascrizioni dopo il [periodo di conservazione](/docs/it/sessions#where-transcripts-are-stored), 30 giorni per impostazione predefinita, seguendo le [regole di pulizia della conservazione](/docs/it/claude-directory#cleaned-up-automatically)3628* **Trascrizione eliminata**: Claude Code rimuove le trascrizioni dopo il [periodo di conservazione](/docs/it/sessions#where-transcripts-are-stored), 30 giorni per impostazione predefinita, secondo le [regole di pulizia della conservazione](/docs/it/claude-directory#cleaned-up-automatically)
3606* **Macchina diversa**: Claude Code memorizza le trascrizioni localmente, quindi riprendete la sessione sulla macchina dove è stata eseguita3629* **Macchina diversa**: Claude Code memorizza le trascrizioni localmente, quindi riprendi la sessione sulla macchina in cui è stata eseguita
3607* **Copie duplicate**: se avete copiato una directory di progetto sotto `~/.claude/projects` in modo che due trascrizioni portino lo stesso ID, Claude Code segnala questo messaggio piuttosto che riprendere una copia arbitrariamente3630* **Copie duplicate**: se hai copiato una directory di progetto in `~/.claude/projects` in modo che due trascrizioni abbiano lo stesso ID, Claude Code riporta questo messaggio invece di riprendere arbitrariamente una delle copie
3608 3631
3609**Cosa fare:**3632**Cosa fare:**
3610 3633
3611* Per una sessione interattiva, aprite il [picker della sessione](/docs/it/sessions#use-the-session-picker) con `claude --resume` e premete `Ctrl+A` per allargarlo a ogni progetto su questa macchina, quindi selezionate la sessione3634* Per una sessione interattiva, apri il [selettore delle sessioni](/docs/it/sessions#use-the-session-picker) con `claude --resume` e premi `Ctrl+A` per estenderlo a ogni progetto su questa macchina, quindi seleziona la sessione
3612* Le sessioni create con `claude -p` o l'[Agent SDK](/docs/it/agent-sdk/overview) non appaiono nel picker, quindi controllate di nuovo l'ID rispetto al `session_id` che la vostra esecuzione originale ha stampato3635* Le sessioni create con `claude -p` o con l'[Agent SDK](/docs/it/agent-sdk/overview) non appaiono nel selettore, quindi ricontrolla l'ID rispetto al `session_id` stampato dalla tua esecuzione originale
3613 3636
3614<h3 id="windows-reported-an-error-ebadf">3637<h3 id="windows-reported-an-error-ebadf">
3615 Windows ha segnalato un errore (EBADF) quando Claude Code ha letto il file di trascrizione di questa sessione3638 Windows ha segnalato un errore (EBADF) quando Claude Code ha letto il file di trascrizione di questa sessione
3616</h3>3639</h3>
3617 3640
3618Avete ripreso una sessione su Windows, il suo file di [trascrizione](/docs/it/sessions#where-transcripts-are-stored) salvato si è aperto normalmente, e la lettura ha quindi fallito con l'errore di sistema EBADF. L'errore di sistema non dice perché la lettura ha fallito, quindi il messaggio suggerisce cause probabili e cosa provare:3641Hai ripreso una sessione su Windows, il suo [file di trascrizione](/docs/it/sessions#where-transcripts-are-stored) salvato si è aperto normalmente e la lettura è poi fallita con l'errore di sistema EBADF. L'errore di sistema non indica perché la lettura è fallita, quindi il messaggio suggerisce le cause probabili e cosa provare:
3619 3642
3620```text theme={null}3643```text theme={null}
3621Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3644Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3622```3645```
3623 3646
3624Il messaggio segue la riga di fallimento del comando stesso, come `Failed to resume session <session-id>`. Un comando `claude --resume` o [`claude -p`](/docs/it/headless) esce con codice 1 dopo averlo mostrato. Dopo `/resume` dentro una sessione, la vostra sessione corrente continua a funzionare.3647Il messaggio segue la riga di errore del comando stesso, come `Failed to resume session <session-id>`. Un comando `claude --resume` o [`claude -p`](/docs/it/headless) termina con codice 1 dopo averlo mostrato. Dopo `/resume` all'interno di una sessione, la tua sessione corrente continua a funzionare.
3625 3648
3626**Cosa fare:**3649**Cosa fare:**
3627 3650
3628* Escludete la cartella che contiene le vostre trascrizioni di sessione dal software che scansiona o intercetta le letture di file, come strumenti di sicurezza, crittografia o gestione degli endpoint. Le trascrizioni vivono sotto `%USERPROFILE%\.claude\projects` per impostazione predefinita, o sotto la directory che [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars) nomina3651* Escludi la cartella che contiene le trascrizioni delle tue sessioni dai software che analizzano o intercettano le letture dei file, come gli strumenti di sicurezza, crittografia o gestione degli endpoint. Le trascrizioni si trovano in `%USERPROFILE%\.claude\projects` per impostazione predefinita, oppure nella directory indicata da [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars)
3629* Se non potete aggiungere un'esclusione, aggiungete Claude Code alle applicazioni consentite di quel software invece3652* Se non puoi aggiungere un'esclusione, aggiungi invece Claude Code alle applicazioni consentite di quel software
3630* Riprendete la sessione di nuovo3653* Riprendi di nuovo la sessione
3631 3654
3632Prima della v2.1.282, il fallimento veniva senza spiegazione: `claude --resume <session-id>` terminava a `Failed to resume session <session-id>`, e un'esecuzione `-p` stampava solo il testo dell'errore di sistema, come `Failed to resume session: EBADF: bad file descriptor, read`.3655Prima della v2.1.282, l'errore si presentava senza spiegazione: `claude --resume <session-id>` terminava con `Failed to resume session <session-id>` e un'esecuzione con `-p` stampava solo il testo dell'errore di sistema, come `Failed to resume session: EBADF: bad file descriptor, read`.
3633 3656
3634<h3 id="cannot-switch-renderers-in-this-session">3657<h3 id="cannot-switch-renderers-in-this-session">
3635 Impossibile cambiare renderer in questa sessione3658 Impossibile cambiare renderer in questa sessione
3636</h3>3659</h3>
3637 3660
3638Quando cambiate renderer, Claude Code riavvia il suo processo. Avete eseguito [`/tui`](/docs/it/fullscreen#enable-fullscreen-rendering) in una sessione che Claude Code rifiuta di riavviare, quindi non cambia e non salva nulla. Quale messaggio vedete vi dice la causa:3661Quando cambi renderer, Claude Code riavvia il suo processo. Hai eseguito [`/tui`](/docs/it/fullscreen#enable-fullscreen-rendering) in una sessione che Claude Code si rifiuta di riavviare, quindi non effettua il cambio e non salva nulla. Il messaggio che vedi ti indica la causa:
3639 3662
3640* `Cannot switch renderers while work is running in the background`: avete lavoro in background in esecuzione che un riavvio abbandonarebbe, come una shell in background o un subagente. Aspettate che il lavoro finisca o fermatelo con [`/tasks`](/docs/it/commands), quindi eseguite di nuovo `/tui fullscreen` o `/tui default`3663* `Cannot switch renderers while work is running in the background`: hai del lavoro in esecuzione in background che un riavvio abbandonerebbe, come una shell in background o un subagent. Attendi che il lavoro termini oppure interrompilo con [`/tasks`](/docs/it/commands), quindi esegui di nuovo `/tui fullscreen` o `/tui default`
3641* `Cannot switch renderers in this session`: la sessione ha restrizioni che Claude Code non può passare al processo riavviato. Prima della v2.1.234, Claude Code riavviava comunque e la sessione riavviata veniva eseguita senza di esse3664* `Cannot switch renderers in this session`: la sessione ha delle restrizioni che Claude Code non può trasferire al processo riavviato. Prima della v2.1.234, Claude Code effettuava comunque il riavvio e la sessione rilanciata veniva eseguita senza di esse
3642 3665
3643Nel messaggio delle restrizioni, la parte tra parentesi nomina le restrizioni che Claude Code ha trovato:3666Nel messaggio sulle restrizioni, la parte tra parentesi indica le restrizioni trovate da Claude Code:
3644 3667
3645```text theme={null}3668```text theme={null}
3646Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3669Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
3647```3670```
3648 3671
3649Ogni motivo che il messaggio può mostrare tra parentesi:3672Ciascun motivo che il messaggio può mostrare tra parentesi:
3650 3673
3651* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: avete avviato la sessione con un flag che Claude Code non passa di nuovo al processo riavviato. Questi flag includono [`--system-prompt`](/docs/it/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, un allowlist [`--tools`](/docs/it/cli-reference#cli-flags), [`--setting-sources`](/docs/it/cli-reference#cli-flags) e [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags)3674* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: hai avviato la sessione con un flag che Claude Code non ritrasmette al processo riavviato. Questi flag includono [`--system-prompt`](/docs/it/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, un'allowlist [`--tools`](/docs/it/cli-reference#cli-flags), [`--setting-sources`](/docs/it/cli-reference#cli-flags) e [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags)
3652* `permission rules set for this session only`: un [aggiornamento di permesso](/docs/it/hooks#permission-update-entries) da un hook o da un chiamante SDK ha aggiunto regole di negazione o richiesta con la destinazione `session`. Le regole di permesso di sessione con ambito di sessione non attivano il rifiuto. Un riavvio le elimina, e Claude Code chiede di nuovo invece3675* `permission rules set for this session only`: un [aggiornamento dei permessi](/docs/it/hooks#permission-update-entries) proveniente da un hook o da un chiamante SDK ha aggiunto regole deny o ask con destinazione `session`. Le regole allow limitate alla sessione non provocano il rifiuto. Un riavvio le elimina e Claude Code chiede di nuovo
3653* `ask-before-running rules with no command-line form`: un aggiornamento di permesso da un hook o da un chiamante SDK ha aggiunto regole di richiesta insieme alle regole che Claude Code passa di nuovo come `--allowed-tools` e `--disallowed-tools`. Nessun flag esiste per le regole di richiesta3676* `ask-before-running rules with no command-line form`: un aggiornamento dei permessi proveniente da un hook o da un chiamante SDK ha aggiunto regole ask insieme alle regole che Claude Code ritrasmette come `--allowed-tools` e `--disallowed-tools`. Non esiste alcun flag per le regole ask
3654* `permission rules a command line cannot carry intact` e `added directories a command line cannot carry intact`: un aggiornamento di permesso ha aggiunto una regola o un percorso di directory a metà sessione. La riga di comando del processo riavviato non può portare il suo testo come lo stesso valore3677* `permission rules a command line cannot carry intact` e `added directories a command line cannot carry intact`: un aggiornamento dei permessi ha aggiunto una regola o un percorso di directory a sessione in corso. La riga di comando del processo riavviato non può trasportarne il testo come lo stesso valore
3655 3678
3656**Cosa fare:**3679**Cosa fare:**
3657 3680
3658* In una sessione avviata senza quelle restrizioni, eseguite `/tui fullscreen`, o `/tui default` per cambiare di nuovo. Claude Code salva l'impostazione [`tui`](/docs/it/settings-reference#tui) lì3681* In una sessione avviata senza quelle restrizioni, esegui `/tui fullscreen`, oppure `/tui default` per tornare indietro. Claude Code salva lì l'[impostazione `tui`](/docs/it/settings-reference#tui)
3659 3682
3660<h3 id="couldnt-open-claude-desktop">3683<h3 id="couldnt-open-claude-desktop">
3661 Non è stato possibile aprire Claude Desktop3684 Impossibile aprire Claude Desktop
3662</h3>3685</h3>
3663 3686
3664Avete eseguito [`/desktop`](/docs/it/desktop#coming-from-the-cli) o il suo alias `/app` in una sessione, o [`claude --desktop`](/docs/it/cli-reference#cli-flags) nella vostra shell, e il comando di sistema che Claude Code utilizza per aprire Claude Desktop ha fallito. Dopo `/desktop`, la sessione rimane nel terminale; `claude --desktop` stampa il messaggio senza il prefisso `Error:` ed esce con stato 1.3687Hai eseguito [`/desktop`](/docs/it/desktop#coming-from-the-cli) o il suo alias `/app` in una sessione, oppure [`claude --desktop`](/docs/it/cli-reference#cli-flags) nella tua shell, e il comando di sistema che Claude Code usa per aprire Claude Desktop non è riuscito. Dopo `/desktop`, la sessione rimane nel terminale; `claude --desktop` stampa il messaggio senza il prefisso `Error:` e termina con stato 1.
3665 3688
3666Il testo tra parentesi nomina il comando che ha fallito, con il suo stato di uscita e la prima riga del suo output di errore quando lo ha prodotto. Su macOS quel comando è `open`, come in questo esempio; su Windows è `rundll32`:3689Il testo tra parentesi indica il comando che non è riuscito, con il suo stato di uscita e la prima riga del suo output di errore, quando li ha prodotti. Su macOS quel comando è `open`, come in questo esempio; su Windows è `rundll32`:
3667 3690
3668```text theme={null}3691```text theme={null}
3669Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.3692Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.
3671 3694
3672**Cosa fare:**3695**Cosa fare:**
3673 3696
3674* Aprite Claude Desktop voi stessi, quindi eseguite di nuovo `/desktop` o `claude --desktop`3697* Apri tu stesso Claude Desktop, quindi esegui di nuovo `/desktop` o `claude --desktop`
3675* Per leggere l'output di errore completo del comando fallito, attivate la registrazione di debug con `/debug` ed eseguite di nuovo `/desktop`, oppure eseguite `claude --desktop --debug-file <path>`, quindi controllate il log di debug3698* Per leggere l'output di errore completo del comando non riuscito, attiva il log di debug con `/debug` ed esegui di nuovo `/desktop`, oppure esegui `claude --desktop --debug-file <path>`, quindi controlla il log di debug
3676 3699
3677Prima della v2.1.285, il messaggio terminava `Open Claude Desktop and run /desktop again.` Prima della v2.1.275, era `Failed to open Claude Desktop. Please try opening it manually.` e non diceva cosa ha fallito.3700Prima della v2.1.285, il messaggio terminava con `Open Claude Desktop and run /desktop again.` Prima della v2.1.275, era `Failed to open Claude Desktop. Please try opening it manually.` e non indicava cosa non fosse riuscito.
3678 3701
3679<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3702<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
3680 /terminal-setup ha lasciato la vostra mappa di tasti Zed invariata3703 /terminal-setup ha lasciato invariata la tua keymap di Zed
3681</h3>3704</h3>
3682 3705
3683Avete eseguito [`/terminal-setup`](/docs/it/terminal-config#enter-multiline-prompts) in Zed, e Claude Code non ha potuto completare l'aggiornamento al vostro Zed `keymap.json`, quindi ha lasciato il file come era.3706Hai eseguito [`/terminal-setup`](/docs/it/terminal-config#enter-multiline-prompts) in Zed e Claude Code non è riuscito a completare l'aggiornamento del tuo `keymap.json` di Zed, quindi ha lasciato il file com'era.
3684 3707
3685Ogni messaggio nomina il percorso della vostra mappa di tasti e termina con il blocco di scorciatoie da tastiera da aggiungere voi stessi:3708Ogni messaggio indica il percorso della tua keymap e termina con il blocco della scorciatoia da tastiera da aggiungere manualmente:
3686 3709
3687```text theme={null}3710```text theme={null}
3688Couldn't update your Zed keymap, so it was left unchanged.3711Couldn't update your Zed keymap, so it was left unchanged.
3690{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3713{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3691```3714```
3692 3715
3693La prima riga del messaggio nomina la causa:3716La prima riga del messaggio indica la causa:
3694 3717
3695* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code non ha potuto leggere il file, ad esempio a causa di permessi di file3718* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code non è riuscito a leggere il file, ad esempio a causa dei permessi del file
3696* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: il file è stato letto bene ma non viene analizzato come un array di blocchi di scorciatoie da tastiera, anche con commenti `//` e virgole finali consentite3719* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: il file è stato letto correttamente ma non viene interpretato come un array di blocchi di scorciatoie da tastiera, anche consentendo commenti `//` e virgole finali
3697* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code non ha potuto copiare il file in un backup `.bak` accanto ad esso, quindi non ha cambiato nulla3720* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code non è riuscito a copiare il file in un backup `.bak` accanto ad esso, quindi non ha modificato nulla
3698* `Couldn't update your Zed keymap, so it was left unchanged.`: il risultato unito non ha verificato come una mappa di tasti valida che porta la scorciatoia da tastiera, quindi Claude Code lo ha scartato invece di scrivere. Un blocco di scorciatoia da tastiera con una chiave duplicata può causare questo3721* `Couldn't update your Zed keymap, so it was left unchanged.`: il risultato unito non è stato verificato come una keymap valida contenente la scorciatoia, quindi Claude Code lo ha scartato invece di scriverlo. Un blocco di scorciatoie da tastiera con una chiave duplicata può causare questo problema
3699 3722
3700**Cosa fare:**3723**Cosa fare:**
3701 3724
3702* Copiate il blocco dal messaggio nell'array di livello superiore nel vostro `keymap.json` al percorso che il messaggio nomina3725* Copia il blocco dal messaggio nell'array di primo livello del tuo `keymap.json` nel percorso indicato dal messaggio
3703* Per `isn't a readable list of keybindings`, correggete l'errore di sintassi, o rendete il valore di livello superiore del file un array, quindi eseguite di nuovo `/terminal-setup`3726* Per `isn't a readable list of keybindings`, correggi l'errore di sintassi oppure rendi un array il valore di primo livello del file, quindi esegui di nuovo `/terminal-setup`
3704 3727
3705Prima della v2.1.247, `/terminal-setup` non poteva analizzare una mappa di tasti Zed che utilizzava commenti `//` o virgole finali, e sostituiva l'intero file con solo la sua scorciatoia da tastiera mentre segnalava la scorciatoia da tastiera come installata. Per ripristinare una mappa di tasti che una versione precedente ha sostituito, utilizzate il file di backup `.bak` descritto sotto [Enter multiline prompts](/docs/it/terminal-config#enter-multiline-prompts).3728Prima della v2.1.247, `/terminal-setup` non riusciva a interpretare una keymap di Zed che usava commenti `//` o virgole finali e sostituiva l'intero file con la sola propria scorciatoia, segnalando la scorciatoia come installata. Per ripristinare una keymap sostituita da una versione precedente, usa il file di backup `.bak` descritto in [Inserire prompt su più righe](/docs/it/terminal-config#enter-multiline-prompts).
3706 3729
3707<h3 id="skill-usage-reports-are-not-available-on-this-connection">3730<h3 id="skill-usage-reports-are-not-available-on-this-connection">
3708 I rapporti di utilizzo delle skill non sono disponibili su questa connessione3731 I report sull'utilizzo delle skill non sono disponibili su questa connessione
3709</h3>3732</h3>
3710 3733
3711Avete eseguito [`/skill-doctor`](/docs/it/skills#find-unused-skills) su [Remote Control](/docs/it/remote-control), dal vostro telefono o browser. Claude Code non invia il rapporto di utilizzo delle skill su Remote Control e risponde con questo messaggio invece:3734Hai eseguito [`/skill-doctor`](/docs/it/skills#find-unused-skills) tramite [Remote Control](/docs/it/remote-control), dal telefono o dal browser. Claude Code non invia il report sull'utilizzo delle skill tramite Remote Control e risponde invece con questo messaggio:
3712 3735
3713```text theme={null}3736```text theme={null}
3714Skill usage reports are not available on this connection.3737Skill usage reports are not available on this connection.
3716 3739
3717**Cosa fare:**3740**Cosa fare:**
3718 3741
3719* Eseguite `/skill-doctor` nel terminale sulla macchina dove la sessione è in esecuzione, oppure eseguite `claude -p "/skill-doctor"` lì3742* Esegui `/skill-doctor` nel terminale della macchina su cui è in esecuzione la sessione, oppure esegui lì `claude -p "/skill-doctor"`
3720 3743
3721<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3744<h3 id="custom-output-styles-cant-be-selected-over-remote-control">
3722 Gli stili di output personalizzati non possono essere selezionati su Remote Control3745 Gli stili di output personalizzati non possono essere selezionati tramite Remote Control
3723</h3>3746</h3>
3724 3747
3725Avete eseguito [`/output-style`](/docs/it/output-styles#change-your-output-style) dall'app mobile o web tramite [Remote Control](/docs/it/remote-control), o il comando è arrivato in un messaggio inoltrato nella sessione. Poiché tale turno potrebbe non provenire dal proprietario dell'account, Claude Code elenca e seleziona solo [stili integrati](/docs/it/output-styles#built-in-output-styles) su di esso, e aggiunge questo avviso ogni volta che il comando elenca gli stili o non riconosce il nome che avete dato. Un nome di [stile personalizzato](/docs/it/output-styles#create-a-custom-output-style) riceve la stessa risposta di un nome che non esiste:3748Hai eseguito [`/output-style`](/docs/it/output-styles#change-your-output-style) dall'app mobile o dal web tramite [Remote Control](/docs/it/remote-control), oppure il comando è arrivato in un messaggio inoltrato nella sessione. Poiché un turno di questo tipo potrebbe non provenire dal proprietario dell'account, Claude Code elenca e seleziona in esso solo gli [stili integrati](/docs/it/output-styles#built-in-output-styles) e aggiunge questo avviso ogni volta che il comando elenca gli stili o non riconosce il nome che hai fornito. Il nome di uno [stile personalizzato](/docs/it/output-styles#create-a-custom-output-style) riceve la stessa risposta di un nome inesistente:
3726 3749
3727```text theme={null}3750```text theme={null}
3728Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3751Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
3730 3753
3731**Cosa fare:**3754**Cosa fare:**
3732 3755
3733* Scegliete uno stile integrato, ad esempio `/output-style concise`3756* Scegli uno stile integrato, ad esempio `/output-style concise`
3734* Per utilizzare uno stile personalizzato, impostate [`outputStyle`](/docs/it/settings-reference#outputstyle) nel `.claude/settings.local.json` del progetto, oppure eseguite `/output-style <style>` nel terminale della sessione stessa se ne ha uno3757* Per usare uno stile personalizzato, imposta [`outputStyle`](/docs/it/settings-reference#outputstyle) nel file `.claude/settings.local.json` del progetto, oppure esegui `/output-style <style>` nel terminale della sessione stessa, se ne ha uno
3735 3758
3736<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3759<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">
3737 Gli stili di output vengono salvati nelle impostazioni locali che questa sessione non carica3760 Gli stili di output vengono salvati nelle impostazioni locali, che questa sessione non carica
3738</h3>3761</h3>
3739 3762
3740Avete provato a cambiare [stili di output](/docs/it/output-styles) con `/output-style <style>` o `/config outputStyle=<style>` in una sessione le cui fonti di impostazione escludono `local`. Gli esempi sono una sessione [Agent SDK](/docs/it/agent-sdk/typescript) il cui [`settingSources`](/docs/it/agent-sdk/typescript#options) lascia fuori `"local"` e una sessione CLI avviata con un valore [`--setting-sources`](/docs/it/cli-reference#cli-flags) che lascia fuori `local`. Entrambi i comandi salvano lo stile a `.claude/settings.local.json`, un file che tale sessione non legge mai di nuovo, quindi Claude Code rifiuta invece di scrivere un'impostazione che non avrebbe alcun effetto:3763Hai provato a cambiare [stile di output](/docs/it/output-styles) con `/output-style <style>` o `/config outputStyle=<style>` in una sessione le cui fonti di impostazioni escludono `local`. Ne sono esempi una sessione dell'[Agent SDK](/docs/it/agent-sdk/typescript) il cui [`settingSources`](/docs/it/agent-sdk/typescript#options) non include `"local"` e una sessione CLI avviata con un valore di [`--setting-sources`](/docs/it/cli-reference#cli-flags) che non include `local`. Entrambi i comandi salvano lo stile in `.claude/settings.local.json`, un file che una sessione di questo tipo non rilegge mai, quindi Claude Code rifiuta invece di scrivere un'impostazione che non avrebbe alcun effetto:
3741 3764
3742```text theme={null}3765```text theme={null}
3743Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3766Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
3745 3768
3746**Cosa fare:**3769**Cosa fare:**
3747 3770
3748* Aggiungete `local` alle fonti di impostazione della sessione e cambiate di nuovo3771* Aggiungi `local` alle fonti di impostazioni della sessione e cambia di nuovo stile
3749* Impostate la chiave [`outputStyle`](/docs/it/settings-reference#outputstyle) in un file di impostazioni che la sessione carica, come `.claude/settings.json` nel progetto o `~/.claude/settings.json`. Nell'SDK TypeScript, impostate `outputStyle` dentro l'oggetto `settings` inline invece; vedete [Activate an output style](/docs/it/agent-sdk/modifying-system-prompts#activate-an-output-style)3772* Imposta la chiave [`outputStyle`](/docs/it/settings-reference#outputstyle) in un file di impostazioni che la sessione carica, come `.claude/settings.json` nel progetto o `~/.claude/settings.json`. Nell'SDK TypeScript, imposta invece `outputStyle` all'interno dell'oggetto `settings` inline; consulta [Attivare uno stile di output](/docs/it/agent-sdk/modifying-system-prompts#activate-an-output-style)
3750 3773
3751<h2 id="plugin-errors">3774<h2 id="plugin-errors">
3752 Errori dei plugin3775 Errori dei plugin
4482 4505
4483I comandi che aprono una finestra di dialogo interattiva non possono farlo mentre nessun terminale è collegato a una sessione in background. `/install-github-app`, l'elenco delle impostazioni `/mcp` e le azioni di autenticazione nel menu del server MCP rispondono con un messaggio. Per `/install-github-app` e l'elenco delle impostazioni `/mcp`, la sessione appare anche sotto **Needs input** nella [vista agente](/docs/it/agent-view) in modo che tu possa trovarla, collegarti ed eseguire di nuovo il comando. Mentre un terminale è collegato, questi comandi funzionano normalmente.4506I comandi che aprono una finestra di dialogo interattiva non possono farlo mentre nessun terminale è collegato a una sessione in background. `/install-github-app`, l'elenco delle impostazioni `/mcp` e le azioni di autenticazione nel menu del server MCP rispondono con un messaggio. Per `/install-github-app` e l'elenco delle impostazioni `/mcp`, la sessione appare anche sotto **Needs input** nella [vista agente](/docs/it/agent-view) in modo che tu possa trovarla, collegarti ed eseguire di nuovo il comando. Mentre un terminale è collegato, questi comandi funzionano normalmente.
4484 4507
4485Prima della v2.1.216, la sessione non appariva sotto **Needs input** dopo uno di questi rifiuti. Nella v2.1.213 attraverso v2.1.215, i comandi funzionavano ancora mentre un terminale era collegato, e il messaggio di rifiuto ti diceva di collegarti ed eseguire di nuovo il comando. Dalla v2.1.208 attraverso v2.1.212, Claude Code li rifiutava anche mentre un terminale era collegato, con un messaggio come `Can't open MCP settings in a background session`; su quelle versioni, esegui il comando da una sessione `claude` regolare invece, o esegui l'upgrade. Prima della v2.1.208, aprivano la loro finestra di dialogo all'interno della sessione in background. Solo nella v2.1.208, Claude Code ha anche rifiutato il selettore `/model` in una sessione in background, e `/upgrade` ha stampato l'URL di upgrade invece di aprire un browser.4508Prima della v2.1.216, la sessione non appariva sotto **Needs input** dopo il rifiuto di `/install-github-app` o dell'elenco delle impostazioni `/mcp`. Nella v2.1.213 attraverso v2.1.215, i comandi funzionavano ancora mentre un terminale era collegato, e il messaggio di rifiuto ti diceva di collegarti ed eseguire di nuovo il comando. Dalla v2.1.208 attraverso v2.1.212, Claude Code li rifiutava anche mentre un terminale era collegato, con un messaggio come `Can't open MCP settings in a background session`; su quelle versioni, esegui il comando da una sessione `claude` regolare invece, o esegui l'upgrade. Prima della v2.1.208, aprivano la loro finestra di dialogo all'interno della sessione in background. Solo nella v2.1.208, Claude Code ha anche rifiutato il selettore `/model` in una sessione in background, e `/upgrade` ha stampato l'URL di upgrade invece di aprire un browser.
4486 4509
4487La formulazione nomina il comando. L'elenco delle impostazioni `/mcp` riporta:4510La formulazione nomina il comando. L'elenco delle impostazioni `/mcp` riporta:
4488 4511
4499 Scrittura o comando bloccato perché il percorso non può essere risolto in modo sicuro4522 Scrittura o comando bloccato perché il percorso non può essere risolto in modo sicuro
4500</h3>4523</h3>
4501 4524
4502Claude ha indirizzato un file o una directory di lavoro attraverso un'ortografia che la [guardia di isolamento worktree](/docs/it/agent-view#how-file-edits-are-isolated) non può risolvere in un'unica posizione verificabile. La guardia controlla le scritture e le directory di lavoro dei comandi in [qualsiasi sessione isolata in un worktree](/docs/it/worktrees#how-claude-code-enforces-isolation), interattiva o in background, e in [subagent isolati da worktree](/docs/it/worktrees#isolate-subagents-with-worktrees). Risolve i symlink prima di controllare che l'operazione non raggiunga il checkout condiviso, e quando la risoluzione fallisce, blocca l'operazione piuttosto che lasciarla atterrare lì. Il messaggio nomina le forme di percorso che rifiuta e come riprovare:4525Claude ha indirizzato un file o una directory di lavoro attraverso un'ortografia che la [guardia di isolamento worktree](/docs/it/agent-view#how-file-edits-are-isolated) non può risolvere in un'unica posizione verificabile. La guardia controlla le scritture e le directory di lavoro dei comandi in [qualsiasi sessione isolata in un worktree](/docs/it/worktrees#how-claude-code-enforces-isolation), interattiva o in background, e in [subagent isolati da worktree](/docs/it/worktrees#isolate-subagents-with-worktrees). Risolve i collegamenti simbolici prima di controllare che l'operazione non raggiunga il checkout condiviso, e quando la risoluzione fallisce, blocca l'operazione piuttosto che lasciarla atterrare lì. Il messaggio nomina le forme di percorso che rifiuta e come riprovare:
4503 4526
4504```text theme={null}4527```text theme={null}
4505This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.4528This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.
4506```4529```
4507 4530
4508Un comando bloccato riporta la stessa causa per la sua directory di lavoro e termina con `re-run the command from its direct symlink-free path`. Prima della v2.1.217, la guardia confrontava le ortografie dei percorsi senza risolvere i symlink, quindi queste ortografie non erano bloccate e una scrittura instradata attraverso un symlink poteva atterrare nel checkout condiviso.4531Un comando bloccato riporta la stessa causa per la sua directory di lavoro e termina con `re-run the command from its direct symlink-free path`. Prima della v2.1.217, la guardia confrontava le ortografie dei percorsi senza risolvere i collegamenti simbolici, quindi queste ortografie non erano bloccate e una scrittura instradata attraverso un collegamento simbolico poteva atterrare nel checkout condiviso.
4509 4532
4510**Cosa fare:**4533**Cosa fare:**
4511 4534
4512* Di solito nulla: il messaggio completo va a Claude come errore dello strumento, e Claude riprova con il percorso diretto che nomina. Per una modifica di file bloccata, la vista della conversazione mostra solo una breve riga `Error editing file`; il messaggio completo appare nella vista della trascrizione, che apri con `Ctrl+O`. Un comando bloccato lo stampa nel suo output di comando.4535* Di solito nulla: il messaggio completo va a Claude come errore dello strumento, e Claude riprova con il percorso diretto che nomina. Per una modifica di file bloccata, la vista della conversazione mostra solo una breve riga `Error editing file`; il messaggio completo appare nella vista della trascrizione, che apri con `Ctrl+O`. Un comando bloccato lo stampa nel suo output di comando.
4513* Se il blocco si ripete sullo stesso file, il percorso probabilmente passa attraverso un symlink committato il cui target contiene `..`, come `docs/current -> ../README.md`; chiedi a Claude di modificare il file target dal suo percorso reale invece che attraverso il link4536* Se il blocco si ripete sullo stesso file, il percorso probabilmente passa attraverso un collegamento simbolico sottoposto a commit il cui target contiene `..`, come `docs/current -> ../README.md`; chiedi a Claude di modificare il file target dal suo percorso reale invece che attraverso il link
4514 4537
4515<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4538<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
4516 Scrittura o comando bloccato perché il percorso nomina una posizione di rete4539 Scrittura o comando bloccato perché il percorso nomina una posizione di rete
4612 Worktree ha commit che non sono spinti da nessuna parte4635 Worktree ha commit che non sono spinti da nessuna parte
4613</h3>4636</h3>
4614 4637
4615Hai provato a eliminare una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) il cui worktree contiene commit che Claude Code non può confermare siano salvati altrove. Claude Code mantiene il worktree e la riga della sessione piuttosto che distruggere i commit senza vederli. `claude rm` nomina il ramo e i commit non spinti, e dice come procedere:4638Hai provato a eliminare una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) il cui worktree contiene commit che Claude Code non può confermare siano salvati altrove. Claude Code mantiene il worktree e la riga della sessione piuttosto che distruggere i commit senza vederli. `claude rm` nomina il branch e i commit non spinti, e dice come procedere:
4616 4639
4617```text theme={null}4640```text theme={null}
4618kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4641kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
4619 2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.4642 2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
4620 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4643 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4621```4644```
4622 4645
4623Quando Claude Code non può riassumere i commit, la riga di dettaglio legge `The worktree has unpushed commits` invece. Nella [vista agente](/docs/it/agent-view), la riga della sessione mostra `not deleted` con lo stesso motivo.4646Quando Claude Code non può riassumere i commit, la riga di dettaglio legge `The worktree has unpushed commits` invece. Nella [vista agente](/docs/it/agent-view), la riga della sessione mostra `not deleted` con lo stesso motivo.
4624 4647
4625I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del ramo predefinito del tuo remote `origin`, purché quel ramo sia estratto nel tuo checkout principale, la directory del repository stesso piuttosto che un worktree.4648I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del branch predefinito del tuo remote `origin`, purché quel branch sia estratto nel tuo checkout principale, la directory del repository stesso piuttosto che un worktree.
4626 4649
4627**Cosa fare:**4650**Cosa fare:**
4628 4651
4629* Per mantenere i commit, spingi il ramo del worktree, o uniscilo al ramo predefinito estratto nel tuo checkout principale, quindi elimina di nuovo la sessione4652* Per mantenere i commit, esegui il push del branch del worktree, o esegui il merge nel branch predefinito estratto nel tuo checkout principale, quindi elimina di nuovo la sessione
4630* Per scartare i commit, esegui il comando `claude rm <id> --discard-unpushed` che il messaggio ha stampato, o premi `Ctrl+X` due volte sulla riga della sessione nella vista agente di nuovo. Questo rimuove la sessione e il worktree insieme al suo ramo, ai commit non spinti e a qualsiasi modifica non committata. Se il worktree ha guadagnato un commit dal rifiuto, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato4653* Per scartare i commit, esegui il comando `claude rm <id> --discard-unpushed` che il messaggio ha stampato, o premi `Ctrl+X` due volte sulla riga della sessione nella vista agente di nuovo. Questo rimuove la sessione e il worktree insieme al suo branch, ai commit non spinti e a qualsiasi modifica non sottoposta a commit. Se il worktree ha guadagnato un commit dal rifiuto, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato
4631* Quando il messaggio dice che il worktree è anche registrato da un'altra sessione terminata, eliminare di nuovo non lo scarta: spingi i commit, quindi elimina di nuovo la sessione4654* Quando il messaggio dice che il worktree è anche registrato da un'altra sessione terminata, eliminare di nuovo non lo scarta: esegui il push dei commit, quindi elimina di nuovo la sessione
4632 4655
4633Prima della v2.1.268, `claude rm` metteva il riassunto del commit sulla riga `kept` stessa. Quando `claude rm` non poteva riassumere i commit, la riga `kept` leggeva `worktree has commits that are not pushed anywhere` al posto del riassunto.4656Prima della v2.1.268, `claude rm` metteva il riassunto del commit sulla riga `kept` stessa. Quando `claude rm` non poteva riassumere i commit, la riga `kept` leggeva `worktree has commits that are not pushed anywhere` al posto del riassunto.
4634 4657
4635Prima della v2.1.260, il messaggio non nominava il ramo o i commit, e eliminare di nuovo era rifiutato allo stesso modo: eliminare la sessione senza spingere significava rimuovere il worktree tu stesso con `git worktree remove --force <path>`, quindi eseguire di nuovo `claude rm <id>`.4658Prima della v2.1.260, il messaggio non nominava il branch o i commit, e eliminare di nuovo era rifiutato allo stesso modo: eliminare la sessione senza eseguire il push significava rimuovere il worktree tu stesso con `git worktree remove --force <path>`, quindi eseguire di nuovo `claude rm <id>`.
4636 4659
4637Prima della v2.1.248, il ramo predefinito estratto nel tuo checkout principale non contava: un ramo che avevi già unito lì attivava ancora questo rifiuto fino a quando i suoi commit non raggiungevano un remote.4660Prima della v2.1.248, il branch predefinito estratto nel tuo checkout principale non contava: un branch di cui avevi già eseguito il merge lì attivava ancora questo rifiuto fino a quando i suoi commit non raggiungevano un remote.
4638 4661
4639<h3 id="terminal-host-process-died">4662<h3 id="terminal-host-process-died">
4640 Il processo host del terminale è morto4663 Il processo host del terminale è morto
4713 Agente della sessione non più disponibile4736 Agente della sessione non più disponibile
4714</h3>4737</h3>
4715 4738
4716Hai ripreso una sessione che stava eseguendo un [agente personalizzato](/docs/it/sub-agents#invoke-subagents-explicitly), avviato con `--agent` o l'impostazione `agent`, e Claude Code non ha trovato un agente con quel nome. Cerca prima nella directory originale della sessione, quando hai [fiducia in quell'area di lavoro](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi nella directory da cui riprendi. La sessione riprende comunque, ma con gli strumenti predefiniti, quindi le restrizioni dello strumento dell'agente non si applicano più:4739Hai ripreso una sessione che stava eseguendo un [agente personalizzato](/docs/it/sub-agents#invoke-subagents-explicitly), avviato con `--agent` o l'impostazione `agent`, e Claude Code non ha trovato un agente con quel nome. Cerca prima nella directory originale della sessione, quando hai [fiducia in quel workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi nella directory da cui riprendi. La sessione riprende comunque, ma con gli strumenti predefiniti, quindi le restrizioni dello strumento dell'agente non si applicano più:
4717 4740
4718```text theme={null}4741```text theme={null}
4719This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4742This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
4721 4744
4722L'avviso nomina solo le directory che Claude Code ha cercato, e appare nella conversazione ripresa sia che tu svegli una [sessione in background](/docs/it/agent-view), esegua `/resume` o `claude --resume`, o riprenda in [modalità non interattiva](/docs/it/headless), dove va anche a stderr. Le sessioni che usano `--input-format stream-json` non lo mostrano, perché l'Agent SDK fornisce agenti dopo l'avvio.4745L'avviso nomina solo le directory che Claude Code ha cercato, e appare nella conversazione ripresa sia che tu svegli una [sessione in background](/docs/it/agent-view), esegua `/resume` o `claude --resume`, o riprenda in [modalità non interattiva](/docs/it/headless), dove va anche a stderr. Le sessioni che usano `--input-format stream-json` non lo mostrano, perché l'Agent SDK fornisce agenti dopo l'avvio.
4723 4746
4724Claude Code non salva il fallback nella sessione, quindi l'avviso si ripete ad ogni ripresa fino a quando non agisci. L'agente `claude` integrato non attiva l'avviso, poiché il fallback al set di strumenti predefinito non cambia nulla per esso. Prima della v2.1.216, Claude Code continuava silenziosamente come l'agente predefinito, e la ricerca copriva solo la directory da cui riprendevi, quindi un agente con ambito di progetto era perso ad ogni ripresa da un'altra directory.4747Claude Code non salva il fallback nella sessione, quindi l'avviso si ripete ad ogni ripresa fino a quando non agisci. L'agente `claude` integrato non attiva l'avviso, poiché ripiegare sul set di strumenti predefinito non cambia nulla per esso. Prima della v2.1.216, Claude Code continuava silenziosamente come l'agente predefinito, e la ricerca copriva solo la directory da cui riprendevi, quindi un agente con ambito di progetto era perso ad ogni ripresa da un'altra directory.
4725 4748
4726**Cosa fare:**4749**Cosa fare:**
4727 4750
4769 4792
4770* Se il messaggio legge `Couldn't start the session`, aggiorna alla v2.1.212 o successiva. Su versioni precedenti puoi anche eseguire `claude daemon run` in un terminale separato per primo, quindi avviare di nuovo la sessione in background. Quel comando esegue il servizio in background in primo piano del terminale, quindi il servizio dura solo finché quel terminale rimane aperto.4793* Se il messaggio legge `Couldn't start the session`, aggiorna alla v2.1.212 o successiva. Su versioni precedenti puoi anche eseguire `claude daemon run` in un terminale separato per primo, quindi avviare di nuovo la sessione in background. Quel comando esegue il servizio in background in primo piano del terminale, quindi il servizio dura solo finché quel terminale rimane aperto.
4771* Se un npm install stava sostituendo il binario, aspetta che finisca, quindi avvia di nuovo la sessione in background4794* Se un npm install stava sostituendo il binario, aspetta che finisca, quindi avvia di nuovo la sessione in background
4772* Se l'errore appare su v2.1.212 o successiva mentre nessun npm install è in esecuzione, chiedi al tuo amministratore Windows di consentire l'eseguibile Claude Code nella politica di restrizione4795* Se l'errore appare su v2.1.212 o successiva mentre nessun npm install è in esecuzione, verifica con il tuo amministratore Windows se una politica di restrizione blocca l'eseguibile Claude Code
4773* Se il servizio in background si interrompe quando chiudi il terminale, Claude Code l'ha avviato senza PowerShell. Installa PowerShell 7, o chiedi al tuo amministratore di sbloccare PowerShell, in modo che il servizio possa sopravvivere al terminale.4796* Se il servizio in background si interrompe quando chiudi il terminale, Claude Code l'ha avviato senza PowerShell. Installa PowerShell 7, o chiedi al tuo amministratore di sbloccare PowerShell, in modo che il servizio possa sopravvivere al terminale.
4774 4797
4775<h3 id="eacces-when-starting-a-background-session">4798<h3 id="eacces-when-starting-a-background-session">
4782Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'4805Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
4783```4806```
4784 4807
4785Quando avvii una sessione con `/background` o `claude --bg`, lo stesso motivo appare all'interno di `Couldn't reach the background service (...)`. Durante la stessa finestra di reinstallazione l'errore può nominare un altro codice invece, come `ENOENT` o `ENOEXEC`, o `EUNKNOWN` o `EPERM` su Windows; un `EUNKNOWN` che persiste attraverso i tentativi ha una [causa diversa](#eunknown-when-starting-a-background-session).4808Quando avvii una sessione con `/background` o `claude --bg`, lo stesso motivo appare all'interno di `Couldn't reach the background service (...)`. Durante la stessa finestra di reinstallazione l'errore può nominare un altro codice invece, come `ENOENT` o `ENOEXEC`, o `EUNKNOWN` o `EPERM` su Windows; un `EUNKNOWN` che persiste attraverso i nuovi tentativi ha una [causa diversa](#eunknown-when-starting-a-background-session).
4786 4809
4787Su un'installazione npm, Claude Code aspetta che la reinstallazione finisca e riprova da solo: fino a dieci secondi, e fino a due minuti mentre un npm install di Claude Code è visibilmente ancora in esecuzione sulla macchina, che copre un altro processo Claude Code che scarica un aggiornamento. Quando l'installazione dura più di quella attesa, l'errore nomina l'aggiornamento invece del codice di errore nudo:4810Su un'installazione npm, Claude Code aspetta che la reinstallazione finisca e riprova da solo: fino a dieci secondi, e fino a due minuti mentre un npm install di Claude Code è visibilmente ancora in esecuzione sulla macchina, che copre un altro processo Claude Code che scarica un aggiornamento. Quando l'installazione dura più di quella attesa, l'errore nomina l'aggiornamento invece del codice di errore nudo:
4788 4811
4825 La directory di lavoro non esiste più quando si avvia una sessione in background4848 La directory di lavoro non esiste più quando si avvia una sessione in background
4826</h3>4849</h3>
4827 4850
4828La directory in cui hai provato ad avviare una [sessione in background](/docs/it/agent-view) è stata rimossa mentre la sessione era in avvio. Claude Code non avvia la sessione, e il messaggio nomina la directory mancante:4851La directory in cui hai avviato una [sessione in background](/docs/it/agent-view) è stata rimossa mentre la sessione era in avvio. Claude Code non avvia la sessione, e il messaggio nomina la directory mancante:
4829 4852
4830```text theme={null}4853```text theme={null}
4831Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4854Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4840* Ricrea la directory che il messaggio nomina, o invia da una directory che esiste, quindi riprova4863* Ricrea la directory che il messaggio nomina, o invia da una directory che esiste, quindi riprova
4841 4864
4842<h3 id="workspace-not-trusted-when-dispatching-a-background-session">4865<h3 id="workspace-not-trusted-when-dispatching-a-background-session">
4843 Workspace non trusted quando si invia una sessione in background4866 Workspace non attendibile quando si invia una sessione in background
4844</h3>4867</h3>
4845 4868
4846Hai avviato o riavviato una [sessione in background](/docs/it/agent-view) in una directory che non hai [trusted](/docs/it/permissions#project-allow-rules-and-workspace-trust), e la finestra di dialogo di fiducia dell'area di lavoro non poteva apparire per chiedertelo. Claude Code non avvia la sessione:4869Hai avviato o riavviato una [sessione in background](/docs/it/agent-view) in una directory a cui non hai [concesso la fiducia](/docs/it/permissions#project-allow-rules-and-workspace-trust), e la finestra di dialogo di fiducia del workspace non poteva apparire per chiedertelo. Claude Code non avvia la sessione:
4847 4870
4848```text theme={null}4871```text theme={null}
4849Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.4872Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
4856* **`The home directory is trusted one session at a time`**: la directory della sessione è la tua directory home. Claude Code non salva mai la fiducia per la directory home, quindi accettare la finestra di dialogo lì in una sessione precedente non conta.4879* **`The home directory is trusted one session at a time`**: la directory della sessione è la tua directory home. Claude Code non salva mai la fiducia per la directory home, quindi accettare la finestra di dialogo lì in una sessione precedente non conta.
4857* **`<path> could not be resolved on disk`**: Claude Code non poteva trovare la directory della sessione su disco.4880* **`<path> could not be resolved on disk`**: Claude Code non poteva trovare la directory della sessione su disco.
4858 4881
4882Prima della v2.1.286, su Windows, questo messaggio poteva apparire anche in una directory a cui avevi già concesso la fiducia, se il suo record di fiducia era stato salvato con il percorso in maiuscole/minuscole diverse. Aggiorna alla v2.1.286 o successiva.
4883
4859**Cosa fare:**4884**Cosa fare:**
4860 4885
4861* Esegui `claude` nella directory che il messaggio nomina e accetta la finestra di dialogo di fiducia, quindi esegui di nuovo il comando4886* Esegui `claude` nella directory che il messaggio nomina e accetta la finestra di dialogo di fiducia, quindi esegui di nuovo il comando
