Documentation 2026-11-12 23:02 UTC to 2026-11-13 02:00 UTC

349 349 

350### Quando un modello viene disabilitato durante la sessione350### Quando un modello viene disabilitato durante la sessione

351 351 

352Se il tuo account perde l'accesso al modello su cui è in esecuzione la sessione, ad esempio perché un amministratore lo disabilita nel tuo account Amazon Bedrock, Claude Code passa la sessione a un altro modello invece di far fallire ogni richiesta, e mostra `Switched to <fallback> because <model> is not available`. Prova gli stessi modelli del fallback all'avvio: prima le versioni precedenti dello stesso livello e, per una sessione Opus senza alcuna versione Opus disponibile, il modello Sonnet predefinito.352Quando Amazon Bedrock rifiuta il modello della tua sessione perché non disponibile per il tuo account, Claude Code passa la sessione a un altro modello e puoi continuare a lavorare. Vedi un messaggio che inizia con `Switched to <fallback> because <model> is not available`. Questo accade, ad esempio, quando un amministratore disabilita il modello o il modello più recente non è ancora disponibile per il tuo account.

353 353 

354Il passaggio si applica solo a un livello che non hai fissato, la stessa condizione del fallback all'avvio. Una sessione su una versione specifica che hai scelto, o su un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile), mantiene il suo modello e, senza una catena di modelli di fallback, la richiesta invece fallisce. In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code passa solo a un modello che la modalità auto supporta su Amazon Bedrock. Se nemmeno nessuno di questi modelli è disponibile, la richiesta fallisce con [AWS authentication failed](https://code.claude.com/docs/it/errors.md#aws-authentication-failed) e un suggerimento per abilitare il modello.354Se hai configurato una [catena di modelli di fallback](https://code.claude.com/docs/it/model-config.md#fallback-model-chains), Claude Code passa invece al fallback che hai configurato. Senza una catena, la richiesta fallisce in casi come questi:

355 355 

356Una [catena di modelli di fallback](https://code.claude.com/docs/it/model-config.md#fallback-model-chains) che configuri sostituisce il passaggio di livello: su questi rifiuti Claude Code passa invece al fallback che hai configurato. Per fare in modo che le richieste rifiutate falliscano piuttosto che passare a un altro modello, imposta [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/it/env-vars). Una catena di fallback che hai configurato continua comunque a passare su questi rifiuti; rimuovi anche la catena se vuoi che ogni richiesta rifiutata fallisca.356* La tua sessione è su un modello fissato, su una versione specifica che hai scelto o su un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile)

357* Nessuno dei [modelli che Claude Code prova](#startup-model-checks) è disponibile. In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code passa solo a un modello che la modalità auto supporta su Amazon Bedrock.

358 

359Per continuare a lavorare, esegui `/model` nella sessione e premi `s` su un modello che il tuo account può usare: in questo modo il tuo valore predefinito resta invariato. Un `403` viene mostrato come [AWS authentication failed](https://code.claude.com/docs/it/errors.md#aws-authentication-failed).

360 

361Per fare in modo che le richieste rifiutate falliscano invece di passare a un altro modello, imposta [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/it/env-vars). Se hai configurato una catena di modelli di fallback, rimuovi anche quella, perché Claude Code passa comunque a quel fallback.

357 362 

358## Prefissi del profilo di inferenza tra regioni363## Prefissi del profilo di inferenza tra regioni

359 364 

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

74| PostgreSQL 11 o successivo | Supporta il flusso di accesso del dispositivo e i contatori dei rate limit. Funziona anche un servizio PostgreSQL gestito, incluso il tier più piccolo; consulta [quali database sono supportati](https://code.claude.com/docs/it/claude-apps-gateway-deploy.md#postgres). Con i [limiti di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md), contiene anche tabelle durevoli di spesa, audit e identità di cui è opportuno eseguire il backup. Si consiglia TLS tramite `?sslmode=require`. PostgreSQL 11, 12 e 13 richiedono Claude Code v2.1.290 o successivo sul server del gateway. Il progetto PostgreSQL non mantiene più quelle versioni, quindi usane una più recente quando possibile. |74| PostgreSQL 11 o successivo | Supporta il flusso di accesso del dispositivo e i contatori dei rate limit. Funziona anche un servizio PostgreSQL gestito, incluso il tier più piccolo; consulta [quali database sono supportati](https://code.claude.com/docs/it/claude-apps-gateway-deploy.md#postgres). Con i [limiti di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md), contiene anche tabelle durevoli di spesa, audit e identità di cui è opportuno eseguire il backup. Si consiglia TLS tramite `?sslmode=require`. PostgreSQL 11, 12 e 13 richiedono Claude Code v2.1.290 o successivo sul server del gateway. Il progetto PostgreSQL non mantiene più quelle versioni, quindi usane una più recente quando possibile. |

75| Upstream del modello | Credenziali Amazon Bedrock, credenziali Claude Platform on AWS, credenziali Google Cloud, una risorsa Microsoft Foundry o una chiave API Anthropic. Sono supportati più upstream con failover. |75| Upstream del modello | Credenziali Amazon Bedrock, credenziali Claude Platform on AWS, credenziali Google Cloud, una risorsa Microsoft Foundry o una chiave API Anthropic. Sono supportati più upstream con failover. |

76| HTTPS | Il gateway deve essere raggiungibile tramite `https://` dai laptop degli sviluppatori e da qualsiasi browser usato per l'accesso; il gateway serve la pagina di verifica del dispositivo sullo stesso listener. Fornisci un certificato TLS tramite `listen.tls` oppure esegui il gateway dietro un ingress che termina TLS, e in entrambi i casi imposta `listen.public_url` sull'origine esterna. Con `/login`, Claude Code accetta un'origine `http://` semplice solo quando l'host del gateway è di loopback: `localhost`, `127.0.0.1` o `::1`. |76| HTTPS | Il gateway deve essere raggiungibile tramite `https://` dai laptop degli sviluppatori e da qualsiasi browser usato per l'accesso; il gateway serve la pagina di verifica del dispositivo sullo stesso listener. Fornisci un certificato TLS tramite `listen.tls` oppure esegui il gateway dietro un ingress che termina TLS, e in entrambi i casi imposta `listen.public_url` sull'origine esterna. Con `/login`, Claude Code accetta un'origine `http://` semplice solo quando l'host del gateway è di loopback: `localhost`, `127.0.0.1` o `::1`. |

77| Indirizzo di rete privata | Con `/login`, Claude Code richiede che l'hostname o l'indirizzo IP del gateway si risolva solo in indirizzi privati: RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` o loopback. Per un gateway che ospiti tu, qualsiasi indirizzo pubblico al di fuori di un blocco che dichiari viene rifiutato; consulta il [modello delle minacce](https://code.claude.com/docs/it/claude-apps-gateway-deploy.md#threat-model-summary) nella guida al deploy. Se le macchine degli sviluppatori instradano HTTPS attraverso un proxy aziendale, l'accesso richiede anche che l'host del proxy si risolva in indirizzi privati; in caso contrario, aggiungi l'host del gateway a `NO_PROXY` in modo che la CLI si connetta direttamente. Se la tua rete interna è numerata con spazio IPv4 pubblico di proprietà della tua organizzazione, [dichiara quei blocchi](#allow-a-gateway-on-public-address-space-you-own) in modo che `/login` accetti un gateway lì. |77| Indirizzo di rete privata | Con `/login`, Claude Code richiede che l'hostname o l'indirizzo IP del gateway si risolva solo in indirizzi privati: intervalli RFC 1918 e link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` e loopback. Consulta il [modello delle minacce](https://code.claude.com/docs/it/claude-apps-gateway-deploy.md#threat-model-summary). Se la tua rete interna è numerata con spazio IPv4 pubblico di proprietà della tua organizzazione, [dichiara quei blocchi](#allow-a-gateway-on-public-address-space-you-own) in modo che `/login` accetti un gateway lì. |

78| Runtime Linux | Il server del gateway funziona solo con il binario nativo per Linux. macOS funziona per lo sviluppo locale. Windows non è supportato come piattaforma server. |78| Runtime Linux | Il server del gateway funziona solo con il binario nativo per Linux. macOS funziona per lo sviluppo locale. Windows non è supportato come piattaforma server. |

79 79 

80Quando `HTTPS_PROXY` o `HTTP_PROXY` si applica all'host del gateway, l'accesso richiede anche un proxy il cui hostname si risolva in indirizzi privati oppure l'host del gateway in `NO_PROXY` sulle macchine degli sviluppatori. Se quelle macchine impostano anche `no_proxy`, aggiungi l'host del gateway anche lì, altrimenti le richieste ai modelli passano comunque attraverso il proxy.

81 

80### Passaggi82### Passaggi

81 83 

82**1. Registra un client OAuth nel tuo IdP**84**1. Registra un client OAuth nel tuo IdP**

656 656 

657| Configurazione | Come |657| Configurazione | Come |

658| - | - |658| - | - |

659| RBAC | Concedi all'identità del gateway `Azure AI User` o `Cognitive Services User` sulla risorsa Microsoft Foundry |659| RBAC | Concedi all'identità del gateway il ruolo `Foundry User` o `Cognitive Services User` sulla risorsa Microsoft Foundry |

660| Deployment | Microsoft Foundry usa nomi di deployment scelti dall'amministratore, non ID modello canonici. Aggiungi un blocco [`models:`](#models) che mappa ogni ID canonico al nome del tuo deployment. |660| Deployment | Microsoft Foundry usa nomi di deployment scelti dall'amministratore, non ID modello canonici. Aggiungi un blocco [`models:`](#models) che mappa ogni ID canonico al nome del tuo deployment. |

661| AKS (workload identity) | Federa una User-Assigned Managed Identity con l'emittente OIDC del cluster e associala all'account di servizio del gateway. `use_azure_ad: true` la rileva tramite `WorkloadIdentityCredential`. |661| AKS (workload identity) | Federa una User-Assigned Managed Identity con l'emittente OIDC del cluster e associala all'account di servizio del gateway. `use_azure_ad: true` la rileva tramite `WorkloadIdentityCredential`. |

662| ACI / App Service | Abilita l'identità gestita assegnata dal sistema o dall'utente sulla risorsa. `use_azure_ad: true` la rileva. |662| ACI / App Service | Abilita l'identità gestita assegnata dal sistema o dall'utente sulla risorsa. `use_azure_ad: true` la rileva. |

1001 1001 

1002Ogni chiave sotto `upstream_model` deve corrispondere al `name` di un upstream configurato, che per impostazione predefinita è il nome del provider. Una chiave che non corrisponde a nessun upstream fa fallire l'avvio, quindi ometti le righe per i provider che non usi.1002Ogni chiave sotto `upstream_model` deve corrispondere al `name` di un upstream configurato, che per impostazione predefinita è il nome del provider. Una chiave che non corrisponde a nessun upstream fa fallire l'avvio, quindi ometti le righe per i provider che non usi.

1003 1003 

1004Per consentire agli sviluppatori di usare l'alias `fable` con `auto_include_builtin_models: false`, aggiungi una voce `claude-fable-5` a `models`. È l'ID in cui l'[alias `fable`](https://code.claude.com/docs/it/model-config#fable-alias-resolution) si risolve per gli sviluppatori che hanno effettuato l'accesso al gateway. Senza di essa, i loro messaggi falliscono con un errore che inizia con `API Error: 400 model claude-fable-5 is not in the operator's model allowlist`.

1005 

1004### `managed`1006### `managed`

1005 1007 

1006Il blocco `managed` definisce policy di accesso basate sui ruoli, indicizzate per gruppi dell'IdP o dominio email. Le policy vengono valutate in ordine; per impostazione predefinita viene selezionata la prima corrispondenza, su cui poi viene fatto il merge con la base catch-all `match: {}`. Un utente che corrisponde a due policy di ruolo riceve solo la prima, quindi le regole di negazione della seconda policy non si applicano a meno che tu non [applichi ogni policy corrispondente](#apply-every-matching-policy). Le policy vengono servite per utente su `GET /managed/settings` con caching ETag/304.1008Il blocco `managed` definisce policy di accesso basate sui ruoli, indicizzate per gruppi dell'IdP o dominio email. Le policy vengono valutate in ordine; per impostazione predefinita viene selezionata la prima corrispondenza, su cui poi viene fatto il merge con la base catch-all `match: {}`. Un utente che corrisponde a due policy di ruolo riceve solo la prima, quindi le regole di negazione della seconda policy non si applicano a meno che tu non [applichi ogni policy corrispondente](#apply-every-matching-policy). Le policy vengono servite per utente su `GET /managed/settings` con caching ETag/304.

1025Un catch-all `match: {}`, convenzionalmente elencato per ultimo, viene trattato come un livello base. Ogni altra policy eredita dal catch-all qualsiasi chiave che non imposta, quindi le voci per ruolo devono solo elencare ciò che differisce dal valore predefinito dell'organizzazione. Le regole di merge dipendono dal tipo di chiave:1027Un catch-all `match: {}`, convenzionalmente elencato per ultimo, viene trattato come un livello base. Ogni altra policy eredita dal catch-all qualsiasi chiave che non imposta, quindi le voci per ruolo devono solo elencare ciò che differisce dal valore predefinito dell'organizzazione. Le regole di merge dipendono dal tipo di chiave:

1026 1028 

1027* **Allowlist**: `availableModels` e `permissions.allow`. L'elenco di una policy specifica sostituisce completamente quello della base.1029* **Allowlist**: `availableModels` e `permissions.allow`. L'elenco di una policy specifica sostituisce completamente quello della base.

1028* **Deny-list e array di hook**: `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces`, `deniedModels` e ogni array di tipo evento di `hooks`. Questi prendono l'unione della base e della policy, così un deny o un hook di audit a livello di organizzazione non può essere eliminato accidentalmente da un override per ruolo.1030* **Elenchi di negazione e array di hook**: questi prendono l'unione di base e policy:

1031 * `permissions.deny` e `permissions.ask`

1032 * `disabledMcpjsonServers` e `deniedMcpServers`

1033 * `blockedMarketplaces` e `deniedModels`

1034 * Gli array per tipo di evento di `hooks`

1029* **Chiavi di tipo record**: `env`, `modelOverrides` e `skillOverrides`. Per queste si esegue un merge superficiale, quindi un blocco `env` per ruolo sovrascrive le chiavi che imposta ed eredita il resto dalla base.1035* **Chiavi di tipo record**: `env`, `modelOverrides` e `skillOverrides`. Per queste si esegue un merge superficiale, quindi un blocco `env` per ruolo sovrascrive le chiavi che imposta ed eredita il resto dalla base.

1030 1036 

1031`availableModels` viene anche applicato lato server su `/v1/messages`, quindi un modello negato restituisce `400` indipendentemente da quello che il client invia. Un elenco vuoto nega ogni modello. Il controllo copre anche il modello su cui si avvia una sessione prima che lo sviluppatore ne scelga uno, quindi [avvia le sessioni su un modello consentito dalla policy](#start-sessions-on-a-model-the-policy-allows).1037`availableModels` viene anche applicato lato server su `/v1/messages`, quindi un modello negato restituisce `400` indipendentemente da quello che il client invia. Un elenco vuoto nega ogni modello. Il controllo copre anche il modello su cui si avvia una sessione prima che lo sviluppatore ne scelga uno, quindi [avvia le sessioni su un modello consentito dalla policy](#start-sessions-on-a-model-the-policy-allows).

92 92 

93Oltre al binario, l'immagine ha bisogno di:93Oltre al binario, l'immagine ha bisogno di:

94 94 

95* **Un'immagine basata su glibc**: la build glibc ha solo dipendenze dinamiche dalle librerie glibc. Le immagini basate su Musl hanno bisogno della build `linux-x64-musl` o `linux-arm64-musl` più pacchetti aggiuntivi; consulta [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).95* **Un'immagine basata su glibc**: la build glibc ha solo dipendenze dinamiche dalle librerie glibc. Le immagini basate su Musl hanno bisogno della build `linux-x64-musl` o `linux-arm64-musl`, la cui unica dipendenza dinamica è musl.

96* **Una directory di stato scrivibile**: il gateway funziona come qualsiasi utente, ma le immagini minime non hanno home scrivibile. Imposta `CLAUDE_CONFIG_DIR` a un percorso scrivibile come `/tmp/.claude`.96* **Una directory di stato scrivibile**: il gateway funziona come qualsiasi utente, ma le immagini minime non hanno home scrivibile. Imposta `CLAUDE_CONFIG_DIR` a un percorso scrivibile come `/tmp/.claude`.

97* **Il comando del container**: `claude gateway --config /etc/claude/gateway.yaml`, con il file di configurazione montato in sola lettura e i segreti forniti come variabili di ambiente; il gateway ascolta su `listen.port`, predefinito `8080`.97* **Il comando del container**: `claude gateway --config /etc/claude/gateway.yaml`, con il file di configurazione montato in sola lettura e i segreti forniti come variabili di ambiente; il gateway ascolta su `listen.port`, predefinito `8080`.

98 98 

274 274 

275Il thread viene eseguito in [auto mode](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), quindi Claude esegue comandi e modifica file in quella cartella senza chiederti ogni volta. Se auto mode non è disponibile o è disattivato nel Claude Code di quel computer, il thread viene eseguito senza di esso, e qualsiasi prompt di autorizzazione che solleva aspetta la tua risposta nel thread, come [Sblocca un thread in attesa di approvazione](#unblock-a-thread-waiting-on-approval) descrive.275Il thread viene eseguito in [auto mode](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), quindi Claude esegue comandi e modifica file in quella cartella senza chiederti ogni volta. Se auto mode non è disponibile o è disattivato nel Claude Code di quel computer, il thread viene eseguito senza di esso, e qualsiasi prompt di autorizzazione che solleva aspetta la tua risposta nel thread, come [Sblocca un thread in attesa di approvazione](#unblock-a-thread-waiting-on-approval) descrive.

276 276 

277Per eseguire il thread in un'altra modalità, avvia `claude remote-control` con [`--settings`](https://code.claude.com/docs/it/remote-control#start-a-remote-control-session). Quindi [`permissions.defaultMode`](https://code.claude.com/docs/it/permission-modes#start-in-a-different-mode), in quel file o nelle impostazioni di quel computer, può scegliere un'altra modalità.

278 

277Mentre il thread è in esecuzione, un'icona del laptop nel suo header mostra se il tuo computer è connesso. Fai clic su di essa per vedere quale cartella il thread sta usando o per disattivare la connessione. Il thread si mette in pausa mentre quel computer è in sospensione, e si ferma se l'app desktop o `claude remote-control` si chiude.279Mentre il thread è in esecuzione, un'icona del laptop nel suo header mostra se il tuo computer è connesso. Fai clic su di essa per vedere quale cartella il thread sta usando o per disattivare la connessione. Il thread si mette in pausa mentre quel computer è in sospensione, e si ferma se l'app desktop o `claude remote-control` si chiude.

278 280 

279* **Per far ripartire il thread**: consulta [Perso il contatto con la tua cartella](#lost-contact-with-your-folder)281* **Per far ripartire il thread**: consulta [Perso il contatto con la tua cartella](#lost-contact-with-your-folder)

35La tabella seguente elenca tutti i comandi inclusi in Claude Code. La maggior parte sono comandi integrati il cui comportamento è codificato nella CLI. Due tipi di voci sono contrassegnati:35La tabella seguente elenca tutti i comandi inclusi in Claude Code. La maggior parte sono comandi integrati il cui comportamento è codificato nella CLI. Due tipi di voci sono contrassegnati:

36 36 

37* **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills)**: una skill inclusa. Funziona come le skill che scrivi tu: un prompt passato a Claude.37* **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills)**: una skill inclusa. Funziona come le skill che scrivi tu: un prompt passato a Claude.

38 * `/verify` viene eseguita solo quando la invochi.

39* **[Workflow](https://code.claude.com/docs/it/workflows.md#bundled-workflows)**: un [workflow dinamico](https://code.claude.com/docs/it/workflows.md) incluso che distribuisce il lavoro su molti subagent e viene eseguito in background.38* **[Workflow](https://code.claude.com/docs/it/workflows.md#bundled-workflows)**: un [workflow dinamico](https://code.claude.com/docs/it/workflows.md) incluso che distribuisce il lavoro su molti subagent e viene eseguito in background.

40 * `/deep-research` viene eseguito solo quando lo invochi.

41 39 

42Per aggiungere i tuoi comandi, consulta [skill](https://code.claude.com/docs/it/skills.md).40Per aggiungere i tuoi comandi, consulta [skill](https://code.claude.com/docs/it/skills.md).

43 41 

71 71 

72Avvia **Claude** dal tuo launcher di applicazioni, oppure esegui `claude-desktop` da un terminale, e accedi con il tuo account Anthropic.72Avvia **Claude** dal tuo launcher di applicazioni, oppure esegui `claude-desktop` da un terminale, e accedi con il tuo account Anthropic.

73 73 

74L'app Linux accede allo stesso modo di macOS e Windows: con un abbonamento a claude.ai, oppure tramite l'SSO della tua organizzazione. Per l'autenticazione tramite chiave API, utilizza la [CLI](https://code.claude.com/docs/it/quickstart.md). Per utilizzare invece Desktop con Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM, consulta [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Per i server proxy e le autorità di certificazione personalizzate in questi deploy, consulta la [configurazione di rete](https://code.claude.com/docs/it/network-config.md).74L'app Linux accede allo stesso modo di macOS e Windows: con un abbonamento a claude.ai, oppure tramite l'SSO della tua organizzazione. Per utilizzare invece Desktop con una chiave API di Claude, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM, consulta [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Per i server proxy e le autorità di certificazione personalizzate in questi deploy, consulta la [configurazione di rete](https://code.claude.com/docs/it/network-config.md).

75 75 

76### Installa da un file scaricato76### Installa da un file scaricato

77 77 

83 83 

84**8. Scegli la modalità di permesso e il modello**84**8. Scegli la modalità di permesso e il modello**

85 85 

86Nella barra degli strumenti della casella delle istruzioni, seleziona una [modalità di permesso](#permissions-for-scheduled-tasks) e un modello. Se li lasci invariati, le esecuzioni utilizzano le tue impostazioni di Claude Code e il modello predefinito.86Nella barra degli strumenti della casella delle istruzioni, seleziona una [modalità di permesso](#permissions-for-scheduled-tasks) e un modello.

87 

88* **Modalità di permesso**: se la lasci invariata, le esecuzioni utilizzano le tue impostazioni di Claude Code.

89* **Modello**: se il menu del modello indica **Default · Set by admin** e non scegli un altro modello, le esecuzioni utilizzano il modello che la tua organizzazione ha impostato nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md). Un'[esecuzione di recupero](#missed-runs) che si avvia all'apertura dell'app può invece utilizzare il [valore predefinito di runtime per il tuo account](https://code.claude.com/docs/it/model-config.md#default-model-setting).

87 90 

88**9. Crea l'attività**91**9. Crea l'attività**

89 92 

90Fai clic su **Create**. Se non hai ancora considerato attendibile la cartella, Desktop ti chiede di considerarla attendibile a questo punto. Si apre la pagina dei dettagli dell'attività.93Fai clic su **Create**. Se non hai ancora considerato attendibile la cartella, Desktop ti chiede di considerarla attendibile a questo punto. Si apre la pagina dei dettagli dell'attività.

91 94 

95Per vedere a quale modello corrisponde **Default · Set by admin**, fai clic su **Run now** nella pagina dei dettagli per eseguire subito l'attività. Poi [apri la sessione dell'esecuzione](#find-a-runs-session), dove la riga sotto la casella del prompt mostra il nome del modello.

96 

92Nella pagina dei dettagli, fai clic sull'icona a forma di matita per aprire il [modulo **Edit**](#manage-scheduled-tasks). Lì puoi modificare la **Description** che Desktop ha compilato a partire dalle tue istruzioni, selezionare **Worktree** o impostare la pianificazione su **Manual** o **Custom**.97Nella pagina dei dettagli, fai clic sull'icona a forma di matita per aprire il [modulo **Edit**](#manage-scheduled-tasks). Lì puoi modificare la **Description** che Desktop ha compilato a partire dalle tue istruzioni, selezionare **Worktree** o impostare la pianificazione su **Manual** o **Custom**.

93 98 

94Puoi anche creare un'attività descrivendo quello che vuoi in qualsiasi sessione. Ad esempio, "configura una revisione del codice giornaliera che viene eseguita ogni mattina alle 9" crea un'attività ricorrente. Una richiesta come "ricordami alle 15 domani di controllare il deploy" crea un'attività una tantum che si disabilita dopo che si attiva.99Puoi anche creare un'attività descrivendo quello che vuoi in qualsiasi sessione. Ad esempio, "configura una revisione del codice giornaliera che viene eseguita ogni mattina alle 9" crea un'attività ricorrente. Una richiesta come "ricordami alle 15 domani di controllare il deploy" crea un'attività una tantum che si disabilita dopo che si attiva.

181 186 

182Per consentire a un'attività di modificare la propria pianificazione o il proprio prompt con lo strumento MCP `update_scheduled_task`, fai clic su **Run now** e approva la chiamata ogni volta.187Per consentire a un'attività di modificare la propria pianificazione o il proprio prompt con lo strumento MCP `update_scheduled_task`, fai clic su **Run now** e approva la chiamata ogni volta.

183 188 

184Per modificare il prompt di un'attività su disco, apri `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (o sotto [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/it/env-vars) se impostato). Il file utilizza frontmatter YAML per `name` e `description`, con il prompt come corpo. Le modifiche hanno effetto alla prossima esecuzione. La pianificazione, la cartella, il modello e lo stato abilitato non sono in questo file: modificali tramite il modulo Edit o chiedi a Claude.189Per modificare il prompt di un'attività su disco, apri `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (o sotto [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/it/env-vars) se impostato). Il file utilizza frontmatter YAML per `name` e `description`, con il prompt come corpo. Le modifiche hanno effetto alla prossima esecuzione. La pianificazione, la cartella e lo stato abilitato non sono in questo file: modificali tramite il modulo Edit o chiedi a Claude.

185 190 

186## Risorse correlate191## Risorse correlate

187 192 

122| `A request to MCP server "<name>" was sent without your stored credentials` | [Autenticazione](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Autenticazione](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Autenticazione](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Autenticazione](#mcp-server-url-is-missing-or-not-a-valid-url) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [Autenticazione](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [Autenticazione](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [Autenticazione](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Autenticazione](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Autenticazione](#refusing-to-send-credentials-to-non-https-token-endpoint) |

126| `Cloud gateway session expired — run /login to reconnect.` | [Autenticazione](#cloud-gateway-session-expired) |127| `Cloud gateway session expired — run /login to reconnect.` | [Autenticazione](#cloud-gateway-session-expired) |

127| `Cloud gateway <url> no longer accepts this session` | [Autenticazione](#cloud-gateway-session-expired) |128| `Cloud gateway <url> no longer accepts this session` | [Autenticazione](#cloud-gateway-session-expired) |

251| `Ultrareview did not start` | [Errori della riga di comando](#ultrareview-did-not-start) |252| `Ultrareview did not start` | [Errori della riga di comando](#ultrareview-did-not-start) |

252| `Remote Control did not start: "<question>" got no answer` | [Errori della riga di comando](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [Errori della riga di comando](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errori della riga di comando](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Errori della riga di comando](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Errori della riga di comando](#remote-control-did-not-start-because-of-the-settings-file) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Errori della riga di comando](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errori della riga di comando](#sandbox-is-not-supported-by-claude-remote-control) |257| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Errori della riga di comando](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [Errori della riga di comando](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [Errori della riga di comando](#claude-import-is-not-yet-available-in-this-build) |

256| `Could not read Claude Code config` | [Errori della riga di comando](#could-not-read-claude-code-config) |259| `Could not read Claude Code config` | [Errori della riga di comando](#could-not-read-claude-code-config) |

825Le chiamate successive nella stessa risposta di Claude possono essere negate con questo motivo:828Le chiamate successive nella stessa risposta di Claude possono essere negate con questo motivo:

826 829 

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833 

831Claude può quindi inviare di nuovo ogni chiamata negata in modo che il server la revisioni. Se si apre una richiesta di permesso, rispondi. Non devi fare nient'altro, a meno che Claude non dica nella sua risposta che la modalità auto non è riuscita a controllare la chiamata. In quel caso, interrompi la modifica o approva tu stesso la chiamata, e chiedi a Claude di riprovare la chiamata:834Claude può quindi inviare di nuovo ogni chiamata negata in modo che il server la revisioni. Se si apre una richiesta di permesso, rispondi. Non devi fare nient'altro, a meno che Claude non dica nella sua risposta che la modalità auto non è riuscita a controllare la chiamata. In quel caso, interrompi la modifica o approva tu stesso la chiamata, e chiedi a Claude di riprovare la chiamata:

1822 1825 

1823Prima della v2.1.232, Claude Code usava il runtime v2 solo in un rilascio graduale oppure quando impostavi `MCP_SDK_GENERATION=v2`.1826Prima della v2.1.232, Claude Code usava il runtime v2 solo in un rilascio graduale oppure quando impostavi `MCP_SDK_GENERATION=v2`.

1824 1827 

1828### Stopped an OAuth request

1829 

1830Questo messaggio significa che Claude Code ha interrotto una [richiesta OAuth per un server MCP](https://code.claude.com/docs/it/mcp.md#authenticate-with-remote-mcp-servers) perché un endpoint OAuth l'ha reindirizzata. In entrambe le forme del messaggio, il primo indirizzo è quello che ha inviato il reindirizzamento:

1831 

1832```text theme={null}

1833Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1834Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1835```

1836 

1837**Cosa fare:**

1838 

1839* Chiedi a chi gestisce il primo indirizzo, ad esempio l'operatore del server MCP, di rimuovere o correggere il reindirizzamento. Poi riprova da `/mcp`.

1840 

1825### Refusing to send credentials to non-https token endpoint1841### Refusing to send credentials to non-https token endpoint

1826 1842 

1827Sul [runtime v2](https://code.claude.com/docs/it/mcp.md#mcp-client-runtimes), Claude Code invia una richiesta di token [MCP OAuth](https://code.claude.com/docs/it/mcp.md#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 dei due casi, quindi Claude Code si è fermato prima di inviare la richiesta. Ciò 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.1843Sul [runtime v2](https://code.claude.com/docs/it/mcp.md#mcp-client-runtimes), Claude Code invia una richiesta di token [MCP OAuth](https://code.claude.com/docs/it/mcp.md#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 dei due casi, quindi Claude Code si è fermato prima di inviare la richiesta. Ciò 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.

2207 2223 

2208### Host not allowed in a cloud session2224### Host not allowed in a cloud session

2209 2225 

2210Una richiesta HTTP in uscita da una sessione cloud o da un'attività pianificata cloud è stata bloccata dalla politica di rete dell'ambiente.2226In una sessione cloud o in un'attività pianificata cloud, un `403` o un errore DNS come `ENOTFOUND` può significare che l'host richiesto non è nell'[allowlist dell'ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md#access-levels). Per confermarlo, confronta l'host con quell'elenco. Un `403` con questa intestazione conferma il blocco, ma non tutti i `403` delle richieste bloccate la includono:

2211 2227 

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403

2565 2581 

2566Claude Code normalmente ridimensiona automaticamente le immagini di grandi dimensioni. Questi errori significano che l'immagine non poteva essere decodificata o ridimensionata per rientrare nei limiti dell'API.2582Claude Code normalmente ridimensiona automaticamente le immagini di grandi dimensioni. Questi errori significano che l'immagine non poteva essere decodificata o ridimensionata per rientrare nei limiti dell'API.

2567 2583 

2584L'errore che vedi può indicare un limite in pixel diverso, ad esempio `2576x2576px` dove questi esempi riportano `2000x2000px`.

2585 

2568**Cosa fare:**2586**Cosa fare:**

2569 2587 

2570* Se il messaggio ti chiede di convertire l'immagine, convertila in PNG, JPEG, GIF o WebP e allegala di nuovo. Claude Code può verificare le dimensioni per questi formati dall'intestazione del file, senza decodificare l'immagine.2588* Se il messaggio ti chiede di convertire l'immagine, convertila in PNG, JPEG, GIF o WebP e allegala di nuovo. Claude Code può verificare le dimensioni per questi formati dall'intestazione del file, senza decodificare l'immagine.

3499* **`Error: Workspace not trusted. <folder> is your home directory`**: poiché la fiducia per la tua directory home non viene mai salvata, eseguire prima `claude` lì non può aiutare. Esegui invece `claude ultrareview` da una directory di progetto, dopo aver eseguito `claude` lì una volta per accettare la finestra di dialogo di fiducia, oppure aggiungi `--trust-workspace`.3517* **`Error: Workspace not trusted. <folder> is your home directory`**: poiché la fiducia per la tua directory home non viene mai salvata, eseguire prima `claude` lì non può aiutare. Esegui invece `claude ultrareview` da una directory di progetto, dopo aver eseguito `claude` lì una volta per accettare la finestra di dialogo di fiducia, oppure aggiungi `--trust-workspace`.

3500* **`No answer in time.` seguito da `Error: Workspace not trusted`**: la domanda `Trust <folder>? [y/N]` è rimasta senza risposta per 5 minuti. Esegui di nuovo `claude ultrareview` e rispondi.3518* **`No answer in time.` seguito da `Error: Workspace not trusted`**: la domanda `Trust <folder>? [y/N]` è rimasta senza risposta per 5 minuti. Esegui di nuovo `claude ultrareview` e rispondi.

3501* **`Ultrareview did not start: <folder> is not trusted`**: hai rifiutato alla domanda `Trust <folder>? [y/N]`, ad esempio rispondendo `n` o premendo Enter. Per avviare la revisione, esegui di nuovo `claude ultrareview` e rispondi `y`.3519* **`Ultrareview did not start: <folder> is not trusted`**: hai rifiutato alla domanda `Trust <folder>? [y/N]`, ad esempio rispondendo `n` o premendo Enter. Per avviare la revisione, esegui di nuovo `claude ultrareview` e rispondi `y`.

3502* **``Ultrareview did not start: `--trust-workspace` takes no value``**: dopo `--trust-workspace` segue qualcosa che non è un flag, come un numero di PR o `false`. Se non ti fidi della cartella, ometti il flag. Per considerarla attendibile per questa esecuzione, metti il numero di PR o il branch di base prima del flag: `claude ultrareview 1234 --trust-workspace`.3520* **``Ultrareview did not start: `--trust-workspace` takes no value``**: dopo `--trust-workspace` segue qualcosa che non è un flag, come un numero di PR o `false`. Se non ti fidi della cartella, ometti il flag. Per considerarla attendibile per questa esecuzione, metti il numero di PR o il branch base prima del flag: `claude ultrareview 1234 --trust-workspace`.

3503 3521 

3504Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.3522Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.

3505 3523 

3522Hai avviato [Remote Control](https://code.claude.com/docs/it/remote-control.md) 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, nominando il flag:3540Hai avviato [Remote Control](https://code.claude.com/docs/it/remote-control.md) 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, nominando il flag:

3523 3541 

3524```text theme={null}3542```text theme={null}

3525Error: `--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`).3543Error: `--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`). Pass settings with `claude remote-control --settings <file>`.

3526```3544```

3527 3545 

3528Claude Code non rifiuta i flag globali che si possono scartare senza conseguenze, come `--verbose`, `--model`, o un `--session-id` o `--plugin-dir` inserito da un wrapper: li ignora e Remote Control si avvia.3546Claude Code non rifiuta i flag globali che si possono scartare senza conseguenze, come `--verbose`, `--model`, o un `--session-id` o `--plugin-dir` inserito da un wrapper: li ignora e Remote Control si avvia.

3536 3554 

3537Prima della v2.1.248, `claude remote-control` non accettava i propri flag quando veniva prima un flag globale, e il comando falliva con un errore `unknown option`.3555Prima della v2.1.248, `claude remote-control` non accettava i propri flag quando veniva prima un flag globale, e il comando falliva con un errore `unknown option`.

3538 3556 

3557### Remote Control non è stato avviato a causa del file `--settings`

3558 

3559Il file che hai passato a [`claude remote-control --settings`](https://code.claude.com/docs/it/remote-control#start-a-remote-control-session) presenta un problema:

3560 

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564 

3565**Cosa fare:**

3566 

3567* Correggi il problema indicato dal messaggio, quindi esegui di nuovo il tuo comando `claude remote-control`

3568 

3569### The settings file has changed since Remote Control started

3570 

3571Questo messaggio nel terminale in cui è in esecuzione `claude remote-control` indica che le sessioni non verranno avviate dal file che hai passato a [`--settings`](https://code.claude.com/docs/it/remote-control#start-a-remote-control-session) nel suo stato attuale:

3572 

3573```text theme={null}

3574Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3575```

3576 

3577**Cosa fare:**

3578 

3579* Per usare il file nel suo stato attuale, arresta `claude remote-control` ed esegui di nuovo lo stesso comando. Per ripristinare le sessioni che stava servendo, consulta [Riprendere le sessioni dopo aver arrestato il server](https://code.claude.com/docs/it/remote-control.md#resume-sessions-after-stopping-the-server).

3580* Per mantenere le impostazioni con cui è stato avviato Remote Control, ripristina il contenuto del file com'era, quindi esegui di nuovo il comando se `claude remote-control` è terminato

3581 

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583 

3541Questo errore indica che il comando che avvia il tuo server [Remote Control](https://code.claude.com/docs/it/remote-control.md) passa `--sandbox` o `--no-sandbox` dopo `remote-control`, e `claude remote-control` non accetta nessuno dei due flag. Il server esce con codice 1 invece di avviarsi:3584Questo errore indica che il comando che avvia il tuo server [Remote Control](https://code.claude.com/docs/it/remote-control.md) passa `--sandbox` o `--no-sandbox` dopo `remote-control`, e `claude remote-control` non accetta nessuno dei due flag. Il server esce con codice 1 invece di avviarsi:

3806 3849 

3807Stringhe analoghe compaiono prima ancora che il comando venga eseguito:3850Stringhe analoghe compaiono prima ancora che il comando venga eseguito:

3808 3851 

3809* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi iniettati](https://code.claude.com/docs/it/skills.md#permission-checks-on-injected-commands) spiega quali risultati interrompono l'invocazione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`3852* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi inseriti](https://code.claude.com/docs/it/skills.md#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`

3810* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina che non ce l'ha. Installa Git for Windows o modifica il frontmatter in `shell: powershell`. Consulta [Come vengono eseguiti i comandi iniettati](https://code.claude.com/docs/it/skills.md#how-injected-commands-run)3853* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: il frontmatter della skill richiede bash su una macchina che non lo ha. Installa Git for Windows o modifica il frontmatter in `shell: powershell`. Consulta [Come vengono eseguiti i comandi inseriti](https://code.claude.com/docs/it/skills.md#how-injected-commands-run)

3811 3854 

3812**Cosa fare:**3855**Cosa fare:**

3813 3856 

63* **Telemetria del client**: Claude Code disabilita la sua analittica client legata ad Anthropic quando una sessione accede a un Claude apps gateway. Per mantenere disattivata anche l'analittica di avvio pre-accesso, fornisci [`DISABLE_TELEMETRY`](https://code.claude.com/docs/it/managed-settings#turn-telemetry-off-for-your-organization) nelle [impostazioni gestite lato client](https://code.claude.com/docs/it/claude-apps-gateway-config.md#client-side-managed-settings) su ogni dispositivo.63* **Telemetria del client**: Claude Code disabilita la sua analittica client legata ad Anthropic quando una sessione accede a un Claude apps gateway. Per mantenere disattivata anche l'analittica di avvio pre-accesso, fornisci [`DISABLE_TELEMETRY`](https://code.claude.com/docs/it/managed-settings#turn-telemetry-off-for-your-organization) nelle [impostazioni gestite lato client](https://code.claude.com/docs/it/claude-apps-gateway-config.md#client-side-managed-settings) su ogni dispositivo.

64* **Telemetria del client su altri gateway**: se Claude Code invia il flusso di telemetria client opzionale dipende dal tuo provider, e la [tabella dei valori predefiniti di telemetria](https://code.claude.com/docs/it/data-usage.md#default-behaviors-by-api-provider) copre ogni caso.64* **Telemetria del client su altri gateway**: se Claude Code invia il flusso di telemetria client opzionale dipende dal tuo provider, e la [tabella dei valori predefiniti di telemetria](https://code.claude.com/docs/it/data-usage.md#default-behaviors-by-api-provider) copre ogni caso.

65* **Destinazioni di telemetria**: dove Claude Code invia la telemetria di una sessione gateway dipende da come la sessione ha effettuato l'accesso, e [What's enforced on developers](https://code.claude.com/docs/it/claude-apps-gateway#whats-enforced-on-developers) dice dove vanno le esportazioni di ogni tipo di sessione.65* **Destinazioni di telemetria**: dove Claude Code invia la telemetria di una sessione gateway dipende da come la sessione ha effettuato l'accesso, e [What's enforced on developers](https://code.claude.com/docs/it/claude-apps-gateway#whats-enforced-on-developers) dice dove vanno le esportazioni di ogni tipo di sessione.

66* **Proxy HTTP aziendali**: un `HTTPS_PROXY` si posiziona tra Claude Code e ogni server con cui comunica, incluso il gateway. Se la tua rete ne richiede uno, [configura il proxy](https://code.claude.com/docs/it/network-config.md) in aggiunta al gateway. Per un Claude apps gateway che ospiti, [l'accesso verifica che l'host proxy sia anche su una rete privata](https://code.claude.com/docs/it/claude-apps-gateway#prerequisites); se non lo è, aggiungi l'host gateway a `NO_PROXY` in modo che la CLI si connetta ad esso direttamente.66* **Proxy HTTP aziendali**: Claude Code invia le sue richieste, incluse quelle al gateway, tramite il proxy in `HTTPS_PROXY`. Se la tua rete richiede un proxy, [configuralo](https://code.claude.com/docs/it/network-config.md). Se il proxy si applica a un Claude apps gateway che ospiti, [l'accesso](https://code.claude.com/docs/it/claude-apps-gateway#prerequisites) richiede che il nome host del proxy si risolva in indirizzi privati, oppure che l'host del gateway sia in `NO_PROXY`.

67 67 

68## Passaggi successivi68## Passaggi successivi

69 69 

84> Crea un'applicazione Microsoft Entra con una credenziale federata per il tuo repository, seguendo [la guida di Microsoft per l'autenticazione da GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect):84> Crea un'applicazione Microsoft Entra con una credenziale federata per il tuo repository, seguendo [la guida di Microsoft per l'autenticazione da GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect):

85>85>

86> * Registra un'applicazione Microsoft Entra e aggiungi una credenziale di identità federata che si fida dei token che GitHub emette al tuo repository. Un'identità gestita assegnata dall'utente funziona al posto di un'applicazione. Entrambe hanno l'ID client che annoti di seguito86> * Registra un'applicazione Microsoft Entra e aggiungi una credenziale di identità federata che si fida dei token che GitHub emette al tuo repository. Un'identità gestita assegnata dall'utente funziona al posto di un'applicazione. Entrambe hanno l'ID client che annoti di seguito

87> * Assegna all'applicazione il ruolo `Azure AI User` sulla tua risorsa Foundry. Vedi [configurazione RBAC di Azure](https://code.claude.com/docs/it/microsoft-foundry.md#azure-rbac-configuration) per un ruolo personalizzato più ristretto87> * Assegna all'applicazione il ruolo `Foundry User` sulla tua risorsa Foundry. Vedi [configurazione RBAC di Azure](https://code.claude.com/docs/it/microsoft-foundry.md#azure-rbac-configuration) per l'altro ruolo predefinito e per i ruoli personalizzati

88>88>

89> Annota l'ID client dell'applicazione, il tuo ID tenant e il tuo ID sottoscrizione. Li aggiungerai come segreti nel passaggio successivo.89> Annota l'ID client dell'applicazione, il tuo ID tenant e il tuo ID sottoscrizione. Li aggiungerai come segreti nel passaggio successivo.

90 90 

228 228 

229### Quando un modello è disabilitato durante la sessione229### Quando un modello è disabilitato durante la sessione

230 230 

231Se il tuo progetto perde l'accesso al modello su cui è in esecuzione la tua sessione, ad esempio perché un amministratore lo disabilita in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), Claude Code passa la sessione a un altro modello invece di fallire in ogni richiesta, e mostra `Switched to <fallback> because <model> is not available`. Prova gli stessi modelli del fallback all'avvio: versioni precedenti dello stesso livello per primo e, per una sessione Opus senza versione Opus disponibile, il modello Sonnet predefinito.231Quando Agent Platform rifiuta il modello della tua sessione perché non disponibile nel tuo progetto o nella tua regione, Claude Code passa la sessione a un altro modello e puoi continuare a lavorare. Vedi un messaggio che inizia con `Switched to <fallback> because <model> is not available`. Questo accade, ad esempio, quando un amministratore disabilita il modello in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) o quando il modello non è servito nella tua regione.

232 232 

233Lo switch si applica solo a un livello che non hai fissato, la stessa condizione del fallback all'avvio. Una sessione su una versione specifica che hai scelto mantiene il suo modello e, senza una catena di modelli di fallback, la richiesta fallisce invece. In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code passa solo a un modello che la modalità auto supporta su Agent Platform. Se nessuno di questi modelli è disponibile, la richiesta fallisce.233Se hai configurato una [catena di modelli di fallback](https://code.claude.com/docs/it/model-config.md#fallback-model-chains), Claude Code passa invece al fallback che hai configurato. Senza una catena, la richiesta fallisce in casi come questi:

234 234 

235Una [catena di modelli di fallback](https://code.claude.com/docs/it/model-config.md#fallback-model-chains) che configuri sostituisce lo switch di livello: su questi rifiuti Claude Code passa al tuo fallback configurato invece. Per fare in modo che le richieste rifiutate falliscano piuttosto che passare, imposta [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/it/env-vars). Una catena di fallback che hai configurato continua comunque a passare su questi rifiuti; rimuovi anche la catena se vuoi che ogni richiesta rifiutata fallisca.235* La tua sessione è su un modello fissato o su una versione specifica che hai scelto

236* Nessuno dei [modelli che Claude Code prova](#startup-model-checks) è disponibile. In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code passa solo a un modello che la modalità auto supporta su Agent Platform.

237 

238Per continuare a lavorare, esegui `/model` nella sessione e premi `s` su un modello disponibile nel tuo progetto e nella tua regione; in questo modo il tuo valore predefinito resta invariato.

239 

240Per fare in modo che le richieste rifiutate falliscano invece di passare a un altro modello, imposta [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/it/env-vars). Se hai configurato una catena di modelli di fallback, rimuovi anche quella, perché Claude Code passa comunque a quel fallback.

236 241 

237## Configurazione IAM242## Configurazione IAM

238 243 

3000 3000 

3001Viene eseguito quando un file di configurazione cambia durante una sessione. Usalo per verificare le modifiche alle impostazioni, applicare policy di sicurezza o bloccare modifiche non autorizzate ai file di configurazione.3001Viene eseguito quando un file di configurazione cambia durante una sessione. Usalo per verificare le modifiche alle impostazioni, applicare policy di sicurezza o bloccare modifiche non autorizzate ai file di configurazione.

3002 3002 

3003Claude Code esegue gli hook ConfigChange quando cambia un file di impostazioni, un file di policy gestita o un file di skill. Per la policy gestita, li esegue solo quando cambia `managed-settings.json` o un file in `managed-settings.d/`. Applica le [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md) e le modifiche alle preferenze gestite di macOS o alle policy del registro di Windows senza eseguirli. Su WSL con [`wslInheritsWindowsSettings`](https://code.claude.com/docs/it/settings-reference#wslinheritswindowssettings), applica anche un file di impostazioni gestite lato Windows modificato durante il proprio polling delle policy, senza eseguirli.3003Claude Code esegue gli hook ConfigChange quando cambia un file di impostazioni, un file di policy gestita o un file di skill. Per le policy gestite, li esegue solo quando cambia `managed-settings.json` o un file in `managed-settings.d/`.

3004 3004 

3005Il matcher filtra in base all'origine della configurazione:3005Il matcher filtra in base all'origine della configurazione:

3006 3006 

3012| `policy_settings` | Cambia `managed-settings.json` o un file in `managed-settings.d/` |3012| `policy_settings` | Cambia `managed-settings.json` o un file in `managed-settings.d/` |

3013| `skills` | Cambia un file di skill in `.claude/skills/` |3013| `skills` | Cambia un file di skill in `.claude/skills/` |

3014 3014 

3015Questo esempio registra tutte le modifiche alla configurazione per la verifica della sicurezza:3015Modifiche come queste hanno effetto senza eseguire gli hook:

3016 

3017* Regole e impostazioni che salvi con **Yes, and don't ask again**, `/permissions` o `/model`, nella sessione da cui le hai salvate. Se un'altra sessione aperta carica lo stesso file, gli hook vengono eseguiti lì.

3018* Aggiornamenti alle [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md), alle preferenze gestite di macOS o ai criteri del registro di Windows

3019* Su WSL con [`wslInheritsWindowsSettings`](https://code.claude.com/docs/it/settings-reference#wslinheritswindowssettings), un file di impostazioni gestite lato Windows modificato, che Claude Code rileva durante il suo polling dei criteri

3020 

3021Questo esempio registra le modifiche alla configurazione per il controllo di sicurezza:

3016 3022 

3017```json theme={null}3023```json theme={null}

3018{3024{

3335 "hooks": [3341 "hooks": [

3336 {3342 {

3337 "type": "command",3343 "type": "command",

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3344 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3339 }3345 }

3340 ]3346 ]

3341 }3347 }

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [

221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }

336 336 

337Tracciate quando i file di impostazioni o skills cambiano durante una sessione. L'evento `ConfigChange` si attiva quando un processo esterno o un editor modifica un file di configurazione, in modo da poter registrare le modifiche per la conformità o bloccare le modifiche non autorizzate.337Tracciate quando i file di impostazioni o skills cambiano durante una sessione. L'evento `ConfigChange` si attiva quando un processo esterno o un editor modifica un file di configurazione, in modo da poter registrare le modifiche per la conformità o bloccare le modifiche non autorizzate.

338 338 

339Questo esempio aggiunge ogni modifica a un registro di controllo. Aggiungete questo a `~/.claude/settings.json`:339Questo esempio aggiunge ogni evento a un log di audit. Aggiungi questo a `~/.claude/settings.json`:

340 340 

341```json theme={null}341```json theme={null}

342{342{

32| `Ctrl+Z` | Sospendi Claude Code | Solo Unix. Sospende il processo alla tua shell; esegui `fg` per riprendere |32| `Ctrl+Z` | Sospendi Claude Code | Solo Unix. Sospende il processo alla tua shell; esegui `fg` per riprendere |

33| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu. In una finestra di dialogo con schede, i tasti cambiano le schede mentre la riga delle schede ha il focus. Vedi [Azioni delle schede](https://code.claude.com/docs/it/keybindings.md#tabs-actions) per come si muove il focus |33| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu. In una finestra di dialogo con schede, i tasti cambiano le schede mentre la riga delle schede ha il focus. Vedi [Azioni delle schede](https://code.claude.com/docs/it/keybindings.md#tabs-actions) per come si muove il focus |

34| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |34| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |

35| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |35| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Up` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |

36| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Mentre un elemento del footer è selezionato, come una riga nel [pannello subagent](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) sotto il prompt, `Esc` [lo deseleziona](https://code.claude.com/docs/it/keybindings.md#footer-actions) invece di interrompere. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Mentre un elemento del footer è selezionato, come una riga nel [pannello subagent](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) sotto il prompt, `Esc` [lo deseleziona](https://code.claude.com/docs/it/keybindings.md#footer-actions) invece di interrompere. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |

37| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](https://code.claude.com/docs/it/checkpointing.md) per ripristinare o riassumere il codice e la conversazione da un punto precedente |37| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Up` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](https://code.claude.com/docs/it/checkpointing.md) per ripristinare o riassumere il codice e la conversazione da un punto precedente |

38| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |38| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |

39| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione |39| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits` e `plan`, poi `bypassPermissions` e `auto` dove disponibili. Vedi [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Su una richiesta di permesso per un file, lo stesso tasto chiude un [campo di commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando la richiesta offre quell'opzione. Alla richiesta di approvazione del piano, approva il piano |

40| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |40| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |

41| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il ragionamento esteso | Abilita o disabilita la modalità di ragionamento esteso. Non ha effetto su Opus 5.5, Sonnet 5.5, Haiku 5.5 o i modelli Fable, che utilizzano sempre il ragionamento esteso. Funziona su macOS senza configurare Option come Meta |41| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il ragionamento esteso | Abilita o disabilita la modalità di ragionamento esteso. Non ha effetto su Opus 5.5, Sonnet 5.5, Haiku 5.5 o i modelli Fable, che utilizzano sempre il ragionamento esteso. Funziona su macOS senza configurare Option come Meta |

42| `Option+O` (macOS) o `Alt+O` (Windows/Linux) | Attiva/disattiva la modalità veloce | Abilita o disabilita la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |42| `Option+O` (macOS) o `Alt+O` (Windows/Linux) | Attiva/disattiva la modalità veloce | Abilita o disabilita la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |

81| :- | :- | :- |81| :- | :- | :- |

82| Escape rapido | `\` + `Enter` | Funziona in tutti i terminali |82| Escape rapido | `\` + `Enter` | Funziona in tutti i terminali |

83| Tasto Option | `Option+Enter` | Dopo aver abilitato [Option come Meta](https://code.claude.com/docs/it/terminal-config.md#enable-option-key-shortcuts-on-macos) su macOS |83| Tasto Option | `Option+Enter` | Dopo aver abilitato [Option come Meta](https://code.claude.com/docs/it/terminal-config.md#enable-option-key-shortcuts-on-macos) su macOS |

84| Shift+Enter | `Shift+Enter` | Nativo in iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal. Per altri terminali, vedi [Inserisci prompt multilinea](https://code.claude.com/docs/it/terminal-config.md#enter-multiline-prompts) |84| Shift+Enter | `Shift+Enter` | Nativo in iTerm2, WezTerm, Ghostty, Kitty, Warp, Windows Terminal. Per altri terminali, vedi [Inserisci prompt multilinea](https://code.claude.com/docs/it/terminal-config.md#enter-multiline-prompts) |

85| Sequenza di controllo | `Ctrl+J` | Funziona in qualsiasi terminale senza configurazione |85| Sequenza di controllo | `Ctrl+J` | Funziona in qualsiasi terminale senza configurazione |

86| Modalità incolla | Incolla direttamente | Per blocchi di codice, log |86| Modalità incolla | Incolla direttamente | Per blocchi di codice, log |

87 87 

137 137 

138Abilita la modifica in stile vim tramite `/config` → Editor mode.138Abilita la modifica in stile vim tramite `/config` → Editor mode.

139 139 

140Claude Code mantiene la modalità vim e la posizione del cursore quando attivi il [visualizzatore di trascrizioni](#transcript-viewer) con `Ctrl+O` o apri e chiudi un pannello come `/config`. Se lasci il prompt in modalità NORMAL, rimane in modalità NORMAL quando ritorni, con il cursore dove l'hai lasciato.

141 

142### Cambio di modalità140### Cambio di modalità

143 141 

144| Comando | Azione | Dalla modalità |142| Comando | Azione | Dalla modalità |

302 * Premi `Ctrl+C` per annullare e ripristinare l'input originale300 * Premi `Ctrl+C` per annullare e ripristinare l'input originale

303 * Premi `Backspace` con la ricerca vuota per annullare301 * Premi `Backspace` con la ricerca vuota per annullare

304 302 

305Accettare una corrispondenza o annullare la ricerca ha effetto immediato, anche mentre Claude Code sta ancora caricando la cronologia.

306 

307Per trovare un prompt precedente quando tutto ciò che ricordi è qualcosa di lungo che ci hai incollato, come un log di errore, premi `Ctrl+R` e digita una parola del testo incollato. Richiede Claude Code v2.1.314 o successivo.303Per trovare un prompt precedente quando tutto ciò che ricordi è qualcosa di lungo che ci hai incollato, come un log di errore, premi `Ctrl+R` e digita una parola del testo incollato. Richiede Claude Code v2.1.314 o successivo.

308 304 

309## Comandi Bash in background305## Comandi Bash in background

600 596 

601### Cosa sottolinea Claude Code597### Cosa sottolinea Claude Code

602 598 

603Poco dopo che smetti di digitare, Claude Code sottolinea le parole che il dizionario non conosce. Lascia sola la parola che stai ancora digitando finché non la superi, e non cambia mai il tuo testo. Salta anche il testo che sembra codice:599Poco dopo che smetti di digitare, Claude Code sottolinea le parole che il dizionario non conosce. Lascia stare la parola che stai ancora digitando finché non la superi. Salta anche il testo che sembra codice:

604 600 

605* Comandi come `/help`, menzioni `@`, URL, percorsi di file e flag come `--verbose`601* Comandi come `/help`, menzioni `@`, URL, percorsi di file e flag come `--verbose`

606* Parole con cifre, trattini bassi, o una lettera maiuscola dopo la prima, e testo tra backtick602* Parole con cifre, trattini bassi, o una lettera maiuscola dopo la prima, e testo tra backtick

581 581 

582Claude Code associa questi accordi predefiniti sul prefisso `ctrl+x`, per contesto:582Claude Code associa questi accordi predefiniti sul prefisso `ctrl+x`, per contesto:

583 583 

584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s` e `ctrl+x tab`584* `Chat`: `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s`, `ctrl+x tab`, `ctrl+x ctrl+=`, `ctrl+x ctrl+-`, `ctrl+x ctrl+_`, `ctrl+x =` e `ctrl+x -`

585* `Task`: `ctrl+x ctrl+b`585* `Task`: `ctrl+x ctrl+b`

586* `DiffPanel`: `ctrl+x b`586* `DiffPanel`: `ctrl+x b`

587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` e `ctrl+x x`587* `Pane`: `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` e `ctrl+x x`

631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

156 156 

157### Conflitti con un accesso esistente157### Conflitti con un accesso esistente

158 158 

159Una variabile di credenziale del gateway ha la precedenza su un accesso claude.ai salvato o una chiave Console. Con `ANTHROPIC_AUTH_TOKEN`, la variabile ha la precedenza immediatamente. Con `ANTHROPIC_API_KEY`, ti viene chiesto una volta in modalità interattiva di approvare la chiave prima che prenda il controllo.159Le tue richieste usano una variabile di credenziale del gateway anziché un accesso claude.ai salvato. Con `ANTHROPIC_AUTH_TOKEN`, la variabile ha la precedenza immediatamente. Con `ANTHROPIC_API_KEY`, ti viene chiesto una volta in modalità interattiva di approvare la chiave prima che prenda il controllo.

160 160 

161Esegui `/status` per confermare quale fonte di credenziale è attiva. Se l'avvio mostra un avviso di conflitto di autenticazione che nomina due fonti, vedi la prima riga della [tabella di risoluzione dei problemi](#troubleshoot-gateway-errors) per quale eliminare. Per cancellare un accesso salvato in modo che rimanga solo la credenziale del gateway, esegui `/logout`.161Esegui `/status` per confermare quale fonte di credenziale è attiva. Se l'avvio mostra un avviso di conflitto di autenticazione che nomina due fonti, vedi la prima riga della [tabella di risoluzione dei problemi](#troubleshoot-gateway-errors) per quale eliminare. Per cancellare un accesso salvato in modo che rimanga solo la credenziale del gateway, esegui `/logout`.

162 162 

506 506 

507| Errore | Causa | Correzione |507| Errore | Causa | Correzione |

508| :- | :- | :- |508| :- | :- | :- |

509| Un avviso di avvio che nomina due fonti di credenziali e termina con `auth may not work as expected`. Le versioni precedenti mostrano invece `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` | Una credenziale del gateway e un accesso salvato sono entrambi attivi; la variabile viene utilizzata per le richieste, ma l'accesso obsoleto può causare un comportamento di autenticazione inaspettato | Annulla l'impostazione della variabile per utilizzare l'accesso salvato, oppure esegui `/logout` per utilizzare la credenziale del gateway |509| Un avviso di avvio che nomina due fonti di credenziali e termina con `auth may not work as expected`. Le versioni precedenti mostrano invece `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set`. | Una credenziale del gateway e un accesso salvato sono entrambi attivi | Annulla l'impostazione della variabile per utilizzare l'accesso salvato, oppure esegui `/logout` per utilizzare la credenziale del gateway |

510| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, oppure si trova in un'intestazione che il gateway non legge | Conferma che la variabile corrisponda al tuo tipo di credenziale nella [tabella delle credenziali](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |510| Errori `401` che nominano un token non valido o non riconosciuto | La credenziale non è una che il gateway ha emesso, oppure si trova in un'intestazione che il gateway non legge | Conferma che la variabile corrisponda al tuo tipo di credenziale nella [tabella delle credenziali](#set-the-credential-variable), e rigenera la chiave al gateway se è stata revocata |

511| `Your apiKeyHelper script is failing`, oppure `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](https://code.claude.com/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché non riesce, e autentica di nuovo con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento degli errori](https://code.claude.com/docs/it/errors.md#your-apikeyhelper-script-is-failing) |511| `Your apiKeyHelper script is failing`, oppure `apiKeyHelper failed:` su stderr in modalità non interattiva | Il comando nell'impostazione [`apiKeyHelper`](https://code.claude.com/docs/it/settings-reference#apikeyhelper) non ha prodotto una chiave utilizzabile, quindi le richieste portano una chiave segnaposto | Esegui il comando direttamente per vedere perché non riesce, e autentica di nuovo con il tuo provider di credenziali se segnala una sessione scaduta; vedi [il riferimento degli errori](https://code.claude.com/docs/it/errors.md#your-apikeyhelper-script-is-failing) |

512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quando nulla risponde all'indirizzo, oppure `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quando il nome host non si risolve, spesso dopo una pausa silenziosa mentre Claude Code [ritenta con backoff](https://code.claude.com/docs/it/errors.md#automatic-retries). Il codice tra parentesi varia; [Unable to connect to API](https://code.claude.com/docs/it/errors.md#unable-to-connect-to-api) copre i codici e la formulazione precedente | Nulla ha risposto all'URL di base: l'indirizzo è sbagliato, oppure una VPN o un firewall blocca il percorso verso il gateway | Esegui il [test curl sopra](#verify-the-connection), che non riesce immediatamente con la stessa causa, e conferma l'URL e il percorso di rete con il tuo team del gateway |512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quando nulla risponde all'indirizzo, oppure `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quando il nome host non si risolve, spesso dopo una pausa silenziosa mentre Claude Code [ritenta con backoff](https://code.claude.com/docs/it/errors.md#automatic-retries). Il codice tra parentesi varia; [Unable to connect to API](https://code.claude.com/docs/it/errors.md#unable-to-connect-to-api) copre i codici e la formulazione precedente | Nulla ha risposto all'URL di base: l'indirizzo è sbagliato, oppure una VPN o un firewall blocca il percorso verso il gateway | Esegui il [test curl sopra](#verify-the-connection), che non riesce immediatamente con la stessa causa, e conferma l'URL e il percorso di rete con il tuo team del gateway |

520| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo della disponibilità della [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata fa fallire il controllo | Aggiungi `api.anthropic.com` all'allowlist se l'uscita è bloccata, oppure imposta una variabile di skip. Vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |520| `/fast` segnala `Fast mode unavailable due to network connectivity issues` mentre le richieste di inferenza funzionano | Il controllo della disponibilità della [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) va direttamente a `api.anthropic.com` e non segue `ANTHROPIC_BASE_URL`, quindi l'uscita diretta bloccata fa fallire il controllo | Aggiungi `api.anthropic.com` all'allowlist se l'uscita è bloccata, oppure imposta una variabile di skip. Vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

521| `/fast` segnala `Fast mode is currently unavailable` in una sessione che si autentica con una chiave emessa dal gateway in `ANTHROPIC_API_KEY` | Mentre `ANTHROPIC_BASE_URL` punta al tuo gateway e la chiave non è nel formato di una chiave API Anthropic, Claude Code non invia il controllo della disponibilità della [modalità veloce](https://code.claude.com/docs/it/fast-mode.md). Senza un precedente controllo riuscito memorizzato nella cache, tratta la modalità veloce come non disponibile | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |521| `/fast` segnala `Fast mode is currently unavailable` in una sessione che si autentica con una chiave emessa dal gateway in `ANTHROPIC_API_KEY` | Mentre `ANTHROPIC_BASE_URL` punta al tuo gateway e la chiave non è nel formato di una chiave API Anthropic, Claude Code non invia il controllo della disponibilità della [modalità veloce](https://code.claude.com/docs/it/fast-mode.md). Senza un precedente controllo riuscito memorizzato nella cache, tratta la modalità veloce come non disponibile | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

522| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo della disponibilità richiede un accesso a claude.ai o una chiave API; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |522| `/fast` segnala `Fast mode has been disabled by your organization` in una sessione autenticata con `ANTHROPIC_AUTH_TOKEN`, anche se l'organizzazione ha la modalità veloce abilitata | Il controllo della disponibilità richiede un accesso a claude.ai o una chiave API; con solo un token bearer, Claude Code tratta la modalità veloce come disabilitata senza inviare il controllo | Imposta `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1`; vedi [usa la modalità veloce dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

523| `/feedback` salva un file locale in una sessione che usa `ANTHROPIC_BASE_URL` | Dietro un gateway, `ANTHROPIC_AUTH_TOKEN` e una chiave che non è nel formato di una chiave API Anthropic non sono credenziali Anthropic. Senza una credenziale Anthropic, Claude Code scrive il report in un archivio locale sotto `~/.claude/feedback-bundles/` invece di inviarlo | Invia il file al tuo referente dell'account Anthropic oppure allegalo a una richiesta di supporto. Vedi [servizi di telemetria](https://code.claude.com/docs/it/data-usage.md#telemetry-services) |

523| Claude Code ti chiede di accedere anche se il [test curl](#verify-the-connection) ha successo | La CLI non ha una credenziale propria: un URL di base raggiungibile non è uno, e in una sessione interattiva un blocco `env` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto si applica solo dopo la procedura guidata di primo avvio e il [prompt di fiducia](https://code.claude.com/docs/it/permissions.md#what-runs-before-you-trust-a-folder) | Imposta `ANTHROPIC_AUTH_TOKEN` da qualche parte che Claude Code legge prima della configurazione di primo avvio: un'esportazione shell, il blocco `env` in `~/.claude/settings.json`, o impostazioni gestite |524| Claude Code ti chiede di accedere anche se il [test curl](#verify-the-connection) ha successo | La CLI non ha una credenziale propria: un URL di base raggiungibile non è uno, e in una sessione interattiva un blocco `env` nel `.claude/settings.json` o `.claude/settings.local.json` di un progetto si applica solo dopo la procedura guidata di primo avvio e il [prompt di fiducia](https://code.claude.com/docs/it/permissions.md#what-runs-before-you-trust-a-folder) | Imposta `ANTHROPIC_AUTH_TOKEN` da qualche parte che Claude Code legge prima della configurazione di primo avvio: un'esportazione shell, il blocco `env` in `~/.claude/settings.json`, o impostazioni gestite |

524| `ANTHROPIC_API_KEY` è impostato ma ignorato, senza prompt | La chiave ha bisogno di un'approvazione una tantum nelle sessioni interattive, e una chiave precedentemente rifiutata viene ignorata senza chiedere di nuovo | Abilitala sotto `/config` con l'opzione `Use custom API key` |525| `ANTHROPIC_API_KEY` è impostato ma ignorato, senza prompt | La chiave ha bisogno di un'approvazione una tantum nelle sessioni interattive, e una chiave precedentemente rifiutata viene ignorata senza chiedere di nuovo | Abilitala sotto `/config` con l'opzione `Use custom API key` |

525| `This machine's managed settings require a first-party login`, oppure [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quando le impostazioni gestite impostano `forceLoginMethod` a `"gateway"` o impostano anche `forceLoginGatewayUrl` | Le impostazioni gestite includono `forceLoginMethod` o `forceLoginOrgUUID`, che non possono coesistere con `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper` | Il tuo amministratore deve rimuovere `forceLoginMethod`, `forceLoginOrgUUID`, e `forceLoginGatewayUrl` dalle impostazioni gestite per utilizzare le credenziali del gateway, oppure rimuovere la credenziale del gateway e utilizzare l'accesso che le impostazioni gestite richiedono. I due non possono essere combinati |526| `This machine's managed settings require a first-party login`, oppure [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quando le impostazioni gestite impostano `forceLoginMethod` a `"gateway"` o impostano anche `forceLoginGatewayUrl` | Le impostazioni gestite includono `forceLoginMethod` o `forceLoginOrgUUID`, che non possono coesistere con `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, o `apiKeyHelper` | Il tuo amministratore deve rimuovere `forceLoginMethod`, `forceLoginOrgUUID`, e `forceLoginGatewayUrl` dalle impostazioni gestite per utilizzare le credenziali del gateway, oppure rimuovere la credenziale del gateway e utilizzare l'accesso che le impostazioni gestite richiedono. I due non possono essere combinati |

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144 

145**Checkpoint**: il prompt restituisce una risposta e la richiesta appare nel log del gateway come un `POST` al percorso `/v1/messages` con stato `200`. Claude Code aggiunge una stringa di query come `?beta=true`, quindi abbinate il percorso, non l'URL completo. Due messaggi di errore puntano in direzioni diverse:145**Checkpoint**: il prompt restituisce una risposta e la richiesta appare nel log del gateway come un `POST` al percorso `/v1/messages` con stato `200`. Claude Code aggiunge una stringa di query come `?beta=true`, quindi confronta il percorso, non l'URL completo. Controlla il messaggio di errore:

146 146 

147* `Not logged in`: controllate il log del gateway per distinguere le due cause. Se è vuoto, nessuna credenziale ha raggiunto la sessione e nessuna richiesta ha lasciato la macchina; rieseguite le esportazioni nella shell da cui state testando. Se mostra una richiesta rifiutata con `x-api-key` nel corpo `401`, il gateway si aspetta chiavi in quell'intestazione invece; passate a `ANTHROPIC_API_KEY`147* `Not logged in`: controlla il log del gateway. Se è vuoto, nessuna credenziale ha raggiunto la sessione e nessuna richiesta ha lasciato la macchina; riesegui le esportazioni nella shell da cui stai testando. Se mostra un `401` dal gateway che nomina `x-api-key`, il gateway si aspetta invece le chiavi in quell'intestazione; passa a `ANTHROPIC_API_KEY`. Se mostra un `401` da `api.anthropic.com` o dall'endpoint del tuo provider, correggi la credenziale del provider che il gateway detiene

148* `Failed to authenticate. API Error: 401` significa che una credenziale è stata inviata e rifiutata, e il log del gateway dice dove: un `401` che nomina `api.anthropic.com` o l'endpoint del vostro provider significa che il gateway ha raggiunto l'upstream ma la sua credenziale del provider è stata rifiutata, quindi la chiave dello sviluppatore ha funzionato e la credenziale del provider che il gateway detiene è sbagliata o un segnaposto148* `Failed to authenticate. API Error: 401` significa che una credenziale è stata inviata e rifiutata, e il log del gateway dice dove: un `401` che nomina `api.anthropic.com` o l'endpoint del vostro provider significa che il gateway ha raggiunto l'upstream ma la sua credenziale del provider è stata rifiutata, quindi la chiave dello sviluppatore ha funzionato e la credenziale del provider che il gateway detiene è sbagliata o un segnaposto

149 149 

150Un URL di base sbagliato o irraggiungibile produce un sintomo diverso: Claude Code [ritenta la connessione con backoff](https://code.claude.com/docs/it/errors.md#automatic-retries) e può stare senza output per diversi minuti prima di segnalare un errore. Se il comando sembra bloccarsi, controllate il log del gateway invece di aspettare; nessuna richiesta in arrivo significa che `ANTHROPIC_BASE_URL` non punta al gateway.150Un URL di base sbagliato o irraggiungibile produce un sintomo diverso: Claude Code [ritenta la connessione con backoff](https://code.claude.com/docs/it/errors.md#automatic-retries) e può stare senza output per diversi minuti prima di segnalare un errore. Se il comando sembra bloccarsi, controllate il log del gateway invece di aspettare; nessuna richiesta in arrivo significa che `ANTHROPIC_BASE_URL` non punta al gateway.

247 247 

248Dovreste vedere le righe `data:` arrivare in modo incrementale. L'intera risposta che arriva in una volta dopo una pausa significa che il gateway sta memorizzando nel buffer, il che blocca Claude Code; un `404` significa che il nome del modello non è instradato. Ripetete per nome di modello.248Dovreste vedere le righe `data:` arrivare in modo incrementale. L'intera risposta che arriva in una volta dopo una pausa significa che il gateway sta memorizzando nel buffer, il che blocca Claude Code; un `404` significa che il nome del modello non è instradato. Ripetete per nome di modello.

249 249 

250Quindi avviate `claude` e inviate un messaggio. Ogni sintomo in questo passaggio ha una causa:250Quindi avvia `claude`, invia un messaggio e confronta ciò che vedi:

251 251 

252* Un prompt di accesso significa un divario di credenziale. Eseguite `/status` e aprite la scheda **Status**: quando la riga `Setting sources` non include impostazioni gestite, la distribuzione non ha raggiunto la macchina; quando lo fa, la credenziale dello sviluppatore non è stata consegnata, quindi impostate `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper`252* Una schermata di accesso, o `Not logged in` senza nulla di nuovo nel log del gateway, indica una credenziale mancante. Esegui `/status` e apri la scheda **Status**: quando la riga `Setting sources` non include le impostazioni gestite, la distribuzione non ha raggiunto la macchina; quando le include, la credenziale dello sviluppatore non è stata consegnata, quindi imposta `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper`

253* Gli errori `Failed to authenticate` significano che il gateway sta rifiutando le richieste; il suo log dice quale credenziale ha fallito. Un rifiuto che il gateway registra stesso nomina la chiave dello sviluppatore, mentre un `401` da `api.anthropic.com` o dall'endpoint del vostro provider significa che la credenziale del provider che il gateway detiene è stata rifiutata253* `Please run /login · API Error: 401`, `Not logged in` o `Invalid API key` con un `401` nel log del gateway: verifica chi ha generato il `401`. Correggi la chiave dello sviluppatore o la sua intestazione se l'ha generato il gateway, oppure la credenziale del provider che il gateway detiene se proviene da `api.anthropic.com` o dall'endpoint del tuo provider

254* Una richiesta di approvazione una tantum per la chiave è prevista al primo utilizzo quando il gateway si aspetta le chiavi nell'intestazione `x-api-key`, impostata come `ANTHROPIC_API_KEY`254* Una richiesta di approvazione una tantum per la chiave è prevista al primo utilizzo quando il gateway si aspetta le chiavi nell'intestazione `x-api-key`, impostata come `ANTHROPIC_API_KEY`

255 255 

256Se la vostra organizzazione usa [fast mode](https://code.claude.com/docs/it/fast-mode.md), eseguite `/fast` qui anche: il controllo di disponibilità chiama `api.anthropic.com` direttamente piuttosto che seguire l'URL di base del gateway, quindi una sessione instradata dal gateway può segnalare fast mode come non disponibile o disabilitato anche se l'inferenza funziona. [Usare fast mode dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) mappa ogni messaggio alla variabile che lo ripristina, distribuita con [il resto della configurazione](#distribute-the-configuration).256Se la vostra organizzazione usa [fast mode](https://code.claude.com/docs/it/fast-mode.md), eseguite `/fast` qui anche: il controllo di disponibilità chiama `api.anthropic.com` direttamente piuttosto che seguire l'URL di base del gateway, quindi una sessione instradata dal gateway può segnalare fast mode come non disponibile o disabilitato anche se l'inferenza funziona. [Usare fast mode dietro proxy e gateway LLM](https://code.claude.com/docs/it/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) mappa ogni messaggio alla variabile che lo ripristina, distribuita con [il resto della configurazione](#distribute-the-configuration).

147 147 

148## Configurazione RBAC di Azure148## Configurazione RBAC di Azure

149 149 

150I ruoli predefiniti `Azure AI User` e `Cognitive Services User` includono tutte le autorizzazioni necessarie per invocare i modelli Claude.150Se ti autentichi con Microsoft Entra ID o con un bearer token da esso emesso, assegna alla tua identità il ruolo `Foundry User` o `Cognitive Services User` sulla tua risorsa Foundry. Potresti ancora vedere `Foundry User` con il suo nome precedente, `Azure AI User`.

151 151 

152Per autorizzazioni più restrittive, crea un ruolo personalizzato con quanto segue:152Se questi ruoli non soddisfano le tue esigenze, consulta la [documentazione RBAC di Microsoft Foundry](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry) per i ruoli personalizzati.

153 

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

165 

166Per i dettagli, vedi [Documentazione RBAC di Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).

167 153 

168## Finestra di contesto da 1M token154## Finestra di contesto da 1M token

169 155 

903 903 

904### Correggere la finestra per un gateway o un ID modello personalizzato904### Correggere la finestra per un gateway o un ID modello personalizzato

905 905 

906Uno qualsiasi di questi avvisi di avvio significa che Claude Code non riconosce l'ID modello della tua sessione, quindi non può determinare la finestra di contesto del modello e assume 200K token:906Uno qualsiasi di questi avvisi significa che Claude Code non riconosce l'ID modello della tua sessione, quindi non può determinare la finestra di contesto del modello e assume 200K token:

907 907 

908```text theme={null}908```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

431> * **Nessuno spazio consentito**: i valori non possono contenere spazi. Ad esempio, `user.organizationName=My Company` non è valido431> * **Nessuno spazio consentito**: i valori non possono contenere spazi. Ad esempio, `user.organizationName=My Company` non è valido

432> * **Formato**: deve essere composta da coppie key=value separate da virgole: `key1=value1,key2=value2`432> * **Formato**: deve essere composta da coppie key=value separate da virgole: `key1=value1,key2=value2`

433> * **Caratteri consentiti**: solo caratteri US-ASCII esclusi i caratteri di controllo, gli spazi bianchi, le virgolette doppie, le virgole, i punti e virgola e le barre rovesciate433> * **Caratteri consentiti**: solo caratteri US-ASCII esclusi i caratteri di controllo, gli spazi bianchi, le virgolette doppie, le virgole, i punti e virgola e le barre rovesciate

434> * **Caratteri speciali**: i caratteri al di fuori dell'intervallo consentito devono essere codificati con percent-encoding434> * **Caratteri speciali**: i caratteri al di fuori dell'intervallo consentito devono essere codificati con percent-encoding, e un `=` all'interno di un valore deve essere scritto come `%3D`

435>435>

436> Per un valore che richiederebbe uno spazio, usa invece underscore o camelCase. Gli esempi seguenti impostano `org.name` con ciascuna forma:436> Per un valore che richiederebbe uno spazio, usa invece underscore o camelCase. Gli esempi seguenti impostano `org.name` con ciascuna forma:

437>437>

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306 

307Premi di nuovo `Shift+Tab` per uscire dal plan mode senza approvare un piano.307Quando non è aperta alcuna richiesta di approvazione, premi di nuovo `Shift+Tab` per uscire dal plan mode. Nella richiesta di approvazione, premi prima `Esc`, perché lì premere `Shift+Tab` approva il piano.

308 308 

309### Rivedi e approva un piano309### Rivedi e approva un piano

310 310 

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

196 196 

197### Verificare un risultato con `expect`197### Verificare un risultato con `expect`

198 198 

199Il kit dispone di queste asserzioni, e quella che scegli va dopo il valore che stai verificando, come in `expect(answer.text).toBe('ok')`:199`expect` ha un proprio insieme di asserzioni, come `toEqual` e `toHaveLength`, che vanno dopo il valore che stai verificando, come in `expect(answer.text).toBe('ok')`. Per l'elenco completo, cerca `type Matchers` in `claude-code/index.d.ts` nei [tipi per la tua build](https://code.claude.com/docs/it/plugins/mods/create.md#get-the-types-for-your-build). Anteponi `.not` all'asserzione per verificare il contrario. Per verificare con cosa si conclude una promise, metti `.resolves` o `.rejects` subito dopo `expect(...)` e usa `await` sulla riga, come in `await expect(promise).rejects.toThrow()`.

200 

201* **Uguaglianza**: `toBe` per lo stesso valore o oggetto, `toEqual` per la struttura, `toStrictEqual` per la struttura più i campi `undefined` e il prototipo, e `toMatchObject` per i campi che indichi

202* **Testo**: `toMatch`, che accetta un'espressione regolare o una sottostringa, `toStartWith` e `toEndWith`

203* **Numeri**: `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Contenuto**: `toContain` per una sottostringa o un membro, `toContainEqual` per un membro confrontato per struttura, `toHaveLength` e `toHaveProperty`

205* **Presenza e tipo**: `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Eccezioni**: `toThrow`, per una funzione che `expect` chiama, o per una promise che verifichi con `.rejects`

207 

208Anteponi `.not` a un'asserzione per verificare il contrario, e `.resolves` o `.rejects` per verificare con cosa si conclude una promise.

209 200 

210Quando un `expect` fallisce all'interno di uno stub o di un hook che hai passato a `on` come funzione semplice anziché come generatore asincrono, il test fallisce. Il motore salta quell'hook, e l'output dell'errore lo indica per nome, ad esempio `in the test's store.set hook`.201Quando un `expect` fallisce all'interno di uno stub o di un hook che hai passato a `on` come funzione semplice anziché come generatore asincrono, il test fallisce. Il motore salta quell'hook, e l'output dell'errore lo indica per nome, ad esempio `in the test's store.set hook`.

211 202 

67> | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |67> | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |

68> | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa `--no-create-session-in-dir` per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |68> | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa `--no-create-session-in-dir` per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |

69> | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](https://code.claude.com/docs/it/permission-modes.md) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide. |69> | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](https://code.claude.com/docs/it/permission-modes.md) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide. |

70> | `--settings <file>` | Applica un file di impostazioni JSON alle sessioni del server, con la stessa [precedenza](https://code.claude.com/docs/it/settings.md#settings-precedence) di `claude --settings`. Indica un percorso di file, non una stringa JSON. Richiede Claude Code v2.1.321 o successivo. |

70> | `--chrome` / `--no-chrome` | Attiva o disattiva l'[integrazione Chrome](https://code.claude.com/docs/it/chrome.md) nelle sessioni che il server crea, in modo che Claude possa utilizzare Chrome sulla tua macchina mentre lavori da un altro dispositivo. Senza nessuno dei due flag, la sessione che il server pre-crea e qualsiasi sessione che avvii tu stesso da claude.ai/code o dall'app Claude iniziano con Chrome disattivato, anche se hai [abilitato Chrome per impostazione predefinita](https://code.claude.com/docs/it/chrome.md#enable-chrome-by-default). Una sessione che il server avvia per uno dei tuoi thread di [progetto](https://code.claude.com/docs/it/claude-projects.md) segue invece quella impostazione, tranne in modalità `bypassPermissions`. Richiede Claude Code v2.1.273 o successivo. |71> | `--chrome` / `--no-chrome` | Attiva o disattiva l'[integrazione Chrome](https://code.claude.com/docs/it/chrome.md) nelle sessioni che il server crea, in modo che Claude possa utilizzare Chrome sulla tua macchina mentre lavori da un altro dispositivo. Senza nessuno dei due flag, la sessione che il server pre-crea e qualsiasi sessione che avvii tu stesso da claude.ai/code o dall'app Claude iniziano con Chrome disattivato, anche se hai [abilitato Chrome per impostazione predefinita](https://code.claude.com/docs/it/chrome.md#enable-chrome-by-default). Una sessione che il server avvia per uno dei tuoi thread di [progetto](https://code.claude.com/docs/it/claude-projects.md) segue invece quella impostazione, tranne in modalità `bypassPermissions`. Richiede Claude Code v2.1.273 o successivo. |

71> | `-d`, `--debug[=<filter>]` | Attiva la registrazione del debug per il server, facoltativamente filtrata per categoria. Passare un filtro solo nella forma `=`, come `--debug=api,hooks`. Richiede Claude Code v2.1.282 o successivo. |72> | `-d`, `--debug[=<filter>]` | Attiva la registrazione del debug per il server, facoltativamente filtrata per categoria. Passare un filtro solo nella forma `=`, come `--debug=api,hooks`. Richiede Claude Code v2.1.282 o successivo. |

72> | `--debug-file <path>` | Scrive i log di debug nel file specificato. |73> | `--debug-file <path>` | Scrive i log di debug nel file specificato. |

73> | `--verbose` | Mostra log dettagliati di connessione e sessione. |74> | `--verbose` | Mostra log dettagliati di connessione e sessione. |

74> | `--sandbox`, `--no-sandbox` | Rimossi in v2.1.300. Se passi uno dei due flag, il server [esce con un errore](https://code.claude.com/docs/it/errors.md#sandbox-is-not-supported-by-claude-remote-control) invece di avviarsi. |75> | `--sandbox`, `--no-sandbox` | Rimossi in v2.1.300. Se passi uno dei due flag, il server [esce con un errore](https://code.claude.com/docs/it/errors.md#sandbox-is-not-supported-by-claude-remote-control) invece di avviarsi. |

75>76>

76> Se si passa un flag `claude` globale prima di `remote-control`, o uno script wrapper ne aggiunge uno, Claude Code non trasporta il flag alle sessioni che il server crea. Claude Code consente il flag solo quando è noto che eliminarlo non cambia ciò che quelle sessioni possono fare, come `--verbose` o `--model`. Per qualsiasi altro flag, come `--settings`, Claude Code [rifiuta di avviarsi](https://code.claude.com/docs/it/errors.md#not-carried-over-to-the-sessions-remote-control-starts) e nomina il flag da rimuovere.77> Se passi un flag `claude` globale prima di `remote-control`, o uno script wrapper ne aggiunge uno, Claude Code non trasferisce il flag alle sessioni che il server crea. Il server si avvia comunque con alcuni flag, come `--verbose` o `--model`. Con qualsiasi altro flag, il server [non si avvia](https://code.claude.com/docs/it/errors.md#not-carried-over-to-the-sessions-remote-control-starts). Per passare un file di impostazioni, metti `--settings` dopo `remote-control`.

77>78>

78> Per eseguire il sandbox delle sessioni che il server avvia, attivare il [sandboxing](https://code.claude.com/docs/it/sandboxing.md) in un file di impostazioni.79> Per eseguire il sandbox delle sessioni che il server avvia, attivare il [sandboxing](https://code.claude.com/docs/it/sandboxing.md) in un file di impostazioni.

79>80>

431 431 

432Ogni attività pianificata utilizza un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md) che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione. L'attività eredita la policy di rete dell'ambiente a ogni esecuzione.432Ogni attività pianificata utilizza un [ambiente cloud](https://code.claude.com/docs/it/cloud-environments.md) che controlla l'accesso alla rete, le variabili d'ambiente e gli script di configurazione. L'attività eredita la policy di rete dell'ambiente a ogni esecuzione.

433 433 

434L'ambiente **Default** utilizza l'accesso **Limited** con **Allow package managers** selezionato, quindi le sue esecuzioni raggiungono l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains). Una richiesta verso un host bloccato non riesce con `403` e `x-deny-reason: host_not_allowed`. Il traffico dei connettori MCP viene instradato attraverso i server di Anthropic, quindi i connettori che aggiungi all'attività funzionano senza aggiungere i loro host in **Allowed domains**. Rimuovi i connettori che non ti servono in [Connettori](#connectors).434L'ambiente **Default** utilizza l'accesso **Limited** con **Allow package managers** selezionato, quindi le sue esecuzioni raggiungono l'[allowlist predefinita](https://code.claude.com/docs/it/cloud-environments.md#default-allowed-domains). Una richiesta verso un host bloccato non riesce con [un errore come `403` o `ENOTFOUND`](https://code.claude.com/docs/it/errors#host-not-allowed-in-a-cloud-session). Il traffico dei connettori MCP viene instradato attraverso i server di Anthropic, quindi i connettori che aggiungi all'attività funzionano senza aggiungere i loro host in **Allowed domains**. Rimuovi i connettori che non ti servono in [Connettori](#connectors).

435 435 

436Per consentire domini aggiuntivi su uno dei tuoi ambienti, segui questi passaggi. Un [ambiente condiviso dall'organizzazione](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre qui in sola lettura, quindi è un Owner a modificarne l'accesso alla rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings).436Per consentire domini aggiuntivi su uno dei tuoi ambienti, segui questi passaggi. Un [ambiente condiviso dall'organizzazione](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) si apre qui in sola lettura, quindi è un Owner a modificarne l'accesso alla rete dalla pagina **Cloud environments** nelle [impostazioni di amministrazione](https://claude.ai/admin-settings).

437 437 

276 276 

277Questi percorsi vengono applicati a livello di sistema operativo, quindi tutti i comandi eseguiti all'interno della sandbox, inclusi i loro processi figli, li rispettano. Questo è l'approccio consigliato quando uno strumento ha bisogno dell'accesso in scrittura a una posizione specifica, anziché escludere completamente lo strumento dalla sandbox con `excludedCommands`.277Questi percorsi vengono applicati a livello di sistema operativo, quindi tutti i comandi eseguiti all'interno della sandbox, inclusi i loro processi figli, li rispettano. Questo è l'approccio consigliato quando uno strumento ha bisogno dell'accesso in scrittura a una posizione specifica, anziché escludere completamente lo strumento dalla sandbox con `excludedCommands`.

278 278 

279Su Linux e WSL2, una voce per un percorso che non esiste ancora non ha alcun effetto, quindi crea prima il percorso.

280 

279Quando definisci lo stesso array del filesystem in più [ambiti di impostazioni](https://code.claude.com/docs/it/settings.md#settings-precedence), Claude Code ne esegue il merge, combinando i percorsi anziché sostituire l'array di un ambito con quello di un altro. Claude Code esclude una voce dal merge quando è coperta da un blocco descritto in [Impedire agli sviluppatori di ampliare la policy](#keep-developers-from-widening-the-policy).281Quando definisci lo stesso array del filesystem in più [ambiti di impostazioni](https://code.claude.com/docs/it/settings.md#settings-precedence), Claude Code ne esegue il merge, combinando i percorsi anziché sostituire l'array di un ambito con quello di un altro. Claude Code esclude una voce dal merge quando è coperta da un blocco descritto in [Impedire agli sviluppatori di ampliare la policy](#keep-developers-from-widening-the-policy).

280 282 

281Se escludi un'origine con [`--setting-sources`](https://code.claude.com/docs/it/cli-reference) nella CLI o con [`settingSources`](https://code.claude.com/docs/it/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) nell'Agent SDK, Claude Code ignora le sue voci `sandbox.filesystem`, le sue regole di permesso `Edit` e le sue regole di negazione `Read` durante la creazione della configurazione della sandbox. Richiede Claude Code v2.1.246 o successivo.283Se escludi un'origine con [`--setting-sources`](https://code.claude.com/docs/it/cli-reference) nella CLI o con [`settingSources`](https://code.claude.com/docs/it/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) nell'Agent SDK, Claude Code ignora le sue voci `sandbox.filesystem`, le sue regole di permesso `Edit` e le sue regole di negazione `Read` durante la creazione della configurazione della sandbox. Richiede Claude Code v2.1.246 o successivo.

376 378 

377Poiché disattivare l'isolamento del filesystem amplia ciò che i comandi in sandbox possono fare, Claude Code rispetta `filesystem.disabled` solo da queste origini di impostazioni:379Poiché disattivare l'isolamento del filesystem amplia ciò che i comandi in sandbox possono fare, Claude Code rispetta `filesystem.disabled` solo da queste origini di impostazioni:

378 380 

379* Le impostazioni utente, le impostazioni gestite e il flag CLI `--settings` possono impostarlo. Le impostazioni di progetto in `.claude/settings.json` e `.claude/settings.local.json` non possono, quindi un progetto scaricato non può disattivare l'isolamento del filesystem.381* Le impostazioni utente, le impostazioni gestite e il flag CLI `--settings` possono impostarlo. Le impostazioni di progetto in `.claude/settings.json` e `.claude/settings.local.json` non possono impostarlo.

380* Quando le impostazioni gestite configurano `sandbox.filesystem` in qualsiasi modo, o elencano una qualsiasi voce `sandbox.credentials.files` con `"mode": "deny"`, solo le impostazioni gestite possono impostare la chiave. Questo impedisce agli sviluppatori di disattivare l'isolamento del filesystem in una distribuzione di questo tipo; per disattivarlo per tutti, imposta `"disabled": true` nelle impostazioni gestite.382* Quando le impostazioni gestite configurano `sandbox.filesystem` in qualsiasi modo, o elencano una qualsiasi voce `sandbox.credentials.files` con `"mode": "deny"`, solo le impostazioni gestite possono impostare la chiave. Per disattivare l'isolamento del filesystem per tutti, imposta `"disabled": true` nelle impostazioni gestite.

381* Quando [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/it/env-vars) è impostata, Claude Code ignora `filesystem.disabled` da ogni origine, incluse le impostazioni gestite, e mantiene attivo l'isolamento del filesystem.383* Quando [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/it/env-vars) è impostata, Claude Code ignora `filesystem.disabled` da ogni origine, incluse le impostazioni gestite.

382 384 

383Una voce `mask` [valida](https://code.claude.com/docs/it/settings-reference.md#invalid-credential-entries-in-managed-settings) non blocca la chiave, anche quando Claude Code [ripiega su `deny`](#mask-credential-files) per essa all'avvio. Elenca un percorso che non può essere mascherato, come una directory di credenziali, come voce `deny` esplicita nelle impostazioni gestite, che blocca la chiave.385Una voce `mask` [valida](https://code.claude.com/docs/it/settings-reference.md#invalid-credential-entries-in-managed-settings) non blocca la chiave, anche quando Claude Code [ripiega su `deny`](#mask-credential-files) per essa all'avvio. Elenca un percorso che non può essere mascherato, come una directory di credenziali, come voce `deny` esplicita nelle impostazioni gestite, che blocca la chiave.

384 386 

177 177 

178Claude Code osserva i vostri file di impostazioni e li ricarica quando cambiano, quindi applica la maggior parte degli edits alla sessione in esecuzione senza un riavvio, inclusi gli edits a `permissions`, `hooks` e helper di credenziali come `apiKeyHelper`. Claude Code anche carica un file di impostazioni che create a metà sessione se la sua cartella esisteva quando la sessione è iniziata. Per la cartella `.claude/` del progetto, carica il file anche quando create la cartella nella stessa sessione.178Claude Code osserva i vostri file di impostazioni e li ricarica quando cambiano, quindi applica la maggior parte degli edits alla sessione in esecuzione senza un riavvio, inclusi gli edits a `permissions`, `hooks` e helper di credenziali come `apiKeyHelper`. Claude Code anche carica un file di impostazioni che create a metà sessione se la sua cartella esisteva quando la sessione è iniziata. Per la cartella `.claude/` del progetto, carica il file anche quando create la cartella nella stessa sessione.

179 179 

180Il ricaricamento copre le impostazioni utente, progetto, locale e gestite, e Claude Code esegue l'[hook `ConfigChange`](https://code.claude.com/docs/it/hooks#configchange) per ogni modifica di file di impostazioni che rileva, non per le impostazioni gestite che arrivano da MDM o dalla console claude.ai. Le impostazioni gestite che arrivano attraverso MDM o dalla console claude.ai raggiungono una sessione in esecuzione secondo una pianificazione piuttosto che al salvataggio; la [tabella di consegna](https://code.claude.com/docs/it/managed-settings.md#choose-a-delivery-mechanism) la fornisce per fonte.180Il ricaricamento copre le impostazioni utente, di progetto, locali e gestite. Claude Code esegue l'[hook `ConfigChange`](https://code.claude.com/docs/it/hooks#configchange) per le modifiche dirette ai file di impostazioni, non per le impostazioni gestite che arrivano da MDM o dalla console claude.ai. Le impostazioni gestite che arrivano attraverso MDM o dalla console claude.ai raggiungono una sessione in esecuzione secondo una pianificazione anziché al salvataggio; la [tabella di consegna](https://code.claude.com/docs/it/managed-settings.md#choose-a-delivery-mechanism) la indica per ciascuna fonte.

181 181 

182Claude Code legge alcune chiavi solo una volta, all'avvio della sessione, quindi un edit a una di esse non raggiunge la sessione in esecuzione. Le chiavi lato amministratore che attendono anche un riavvio, come `requiredMinimumVersion`, sono elencate sotto [dove e quando si applica una politica](https://code.claude.com/docs/it/managed-settings.md#where-and-when-a-policy-applies). Quelle che è più probabile che modifichiate a metà sessione:182Claude Code legge alcune chiavi solo una volta, all'avvio della sessione, quindi un edit a una di esse non raggiunge la sessione in esecuzione. Le chiavi lato amministratore che attendono anche un riavvio, come `requiredMinimumVersion`, sono elencate sotto [dove e quando si applica una politica](https://code.claude.com/docs/it/managed-settings.md#where-and-when-a-policy-applies). Quelle che è più probabile che modifichiate a metà sessione:

183 183 

1533}1533}

1534```1534```

1535 1535 

1536Su Linux e WSL2, una voce per un percorso che non esiste ancora non ha effetto, quindi crea prima il percorso.

1537 

1536Claude Code esegue il merge delle voci `allowWrite` e dei percorsi dalle tue regole di permesso allow `Edit(...)` negli ambiti di impostazioni che la sessione carica, escludendo quelli dalle impostazioni del repository mentre [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) è attivo. Anche i [blocchi del repository](https://code.claude.com/docs/it/sandboxing.md#repository-settings-under-an-admin-required-sandbox) possono escludere le voci di un repository. Una voce `allowWrite` non può sollevare un [percorso protetto](https://code.claude.com/docs/it/sandboxing.md#protected-paths).1538Claude Code esegue il merge delle voci `allowWrite` e dei percorsi dalle tue regole di permesso allow `Edit(...)` negli ambiti di impostazioni che la sessione carica, escludendo quelli dalle impostazioni del repository mentre [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) è attivo. Anche i [blocchi del repository](https://code.claude.com/docs/it/sandboxing.md#repository-settings-under-an-admin-required-sandbox) possono escludere le voci di un repository. Una voce `allowWrite` non può sollevare un [percorso protetto](https://code.claude.com/docs/it/sandboxing.md#protected-paths).

1537 1539 

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

40>40>

41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**

42>42>

43> ```bash theme={null}43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell:**49> **Windows PowerShell:**

50>50>

51> ```powershell theme={null}51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD:**55> **Windows CMD:**

56>56>

57> ```batch theme={null}57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

75> ```bash theme={null}75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null}87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

141 141 

142### Alpine Linux e distribuzioni basate su musl142### Alpine Linux e distribuzioni basate su musl

143 143 

144L'installazione di Claude Code su Alpine e altre distribuzioni basate su musl/uClibc richiede `bash` e `curl` per il comando di installazione, e `libgcc`, `libstdc++` e `ripgrep` al runtime. Alpine non include `bash` o `curl` per impostazione predefinita, quindi il comando di installazione documentato non riesce con un errore `not found` finché non li installate. Installate questi pacchetti utilizzando il gestore di pacchetti della vostra distribuzione, quindi impostate `USE_BUILTIN_RIPGREP=0`.144Su Alpine e altre distribuzioni basate su musl, il [comando di installazione](#install-claude-code) richiede `bash` e `curl`, e Claude Code stesso richiede `bash` o `zsh`. Alpine non include `bash` o `curl` per impostazione predefinita, quindi il comando di installazione documentato non riesce con un errore `not found` finché non li installi.

145 145 

146Questo esempio installa i pacchetti richiesti su Alpine:146Questo esempio installa i pacchetti richiesti su Alpine:

147 147 

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

151 

152Su Alpine, `ripgrep` si trova nel repository community. Se `apk` segnala che il pacchetto è mancante, aggiungete il repository community a `/etc/apk/repositories`, utilizzando la vostra versione di Alpine:

153 

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

157 

158Eseguite `apk update` per aggiornare l'indice dei pacchetti e riprovate il comando `apk add`.

159 

160Quindi impostate `USE_BUILTIN_RIPGREP` a `0` nel vostro file [`settings.json`](https://code.claude.com/docs/it/settings-reference#all-settings):

161 

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151 

170## Verificare l'installazione152## Verificare l'installazione

443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> Per passare al canale `latest`, rimuovete la riga del repository `stable` e aggiungete il repository `latest`:431> Per passare al canale `latest`, rimuovete la riga del repository `stable` e aggiungete il repository `latest`:

26 26 

27| Terminale | Shift+Enter per andare a capo |27| Terminale | Shift+Enter per andare a capo |

28| :- | :- |28| :- | :- |

29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Funziona senza configurazione |29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Windows Terminal | Funziona senza configurazione |

30| Altri terminali che supportano il protocollo da tastiera kitty, come foot e Alacritty 0.16 o successivo | Funziona senza configurazione. Richiede Claude Code v2.1.269 o successivo |30| Altri terminali che supportano il protocollo da tastiera kitty, come foot e Alacritty 0.16 o successivo | Funziona senza configurazione. Richiede Claude Code v2.1.269 o successivo |

31| VS Code, Cursor, Devin Desktop, Alacritty precedente alla 0.16, Zed | Esegui `/terminal-setup` una volta |31| VS Code, Cursor, Devin Desktop, Alacritty precedente alla 0.16, Zed | Esegui `/terminal-setup` una volta |

32| gnome-terminal, IDE JetBrains come PyCharm e Android Studio | Non disponibile; usa Ctrl+J oppure `\` e poi Enter |32| gnome-terminal, IDE JetBrains come PyCharm e Android Studio | Non disponibile; usa Ctrl+J oppure `\` e poi Enter |

127 127 

128Claude utilizza `AskUserQuestion` per farti domande a scelta multipla quando ha bisogno di una decisione o di un chiarimento. Rispondi selezionando un'opzione, oppure digita il tuo testo tramite la riga `Other` o il campo delle note.128Claude utilizza `AskUserQuestion` per farti domande a scelta multipla quando ha bisogno di una decisione o di un chiarimento. Rispondi selezionando un'opzione, oppure digita il tuo testo tramite la riga `Other` o il campo delle note.

129 129 

130Quando rispondi digitando il tuo testo, Claude Code trasmette la risposta con una formulazione neutra in modo che Claude segua ciò che hai scritto, inclusa una richiesta di attendere o di spiegare prima.

131 

132### Timeout di continuazione automatica delle domande130### Timeout di continuazione automatica delle domande

133 131 

134Le domande rimangono aperte finché non rispondi. Se desideri che una domanda che lasci senza risposta si chiuda alla fine e permetta a Claude di continuare senza di te, imposta l'impostazione [`askUserQuestionTimeout`](https://code.claude.com/docs/it/settings-reference#askuserquestiontimeout) su `60s`, `5m` o `10m`, nel tuo `settings.json` utente oppure dalla riga **Question auto-continue timeout** in `/config`.132Le domande rimangono aperte finché non rispondi. Se desideri che una domanda che lasci senza risposta si chiuda alla fine e permetta a Claude di continuare senza di te, imposta l'impostazione [`askUserQuestionTimeout`](https://code.claude.com/docs/it/settings-reference#askuserquestiontimeout) su `60s`, `5m` o `10m`, nel tuo `settings.json` utente oppure dalla riga **Question auto-continue timeout** in `/config`.

525 523 

526## Comportamento dello strumento Read524## Comportamento dello strumento Read

527 525 

528Lo strumento Read accetta un percorso di file e restituisce i contenuti con numeri di riga. Claude è istruito a passare sempre percorsi assoluti.526Lo strumento Read accetta un percorso di file e restituisce i contenuti con numeri di riga.

529 527 

530La lettura di un file vuoto restituisce un avviso che il file esiste ma i suoi contenuti sono vuoti, e un `offset` oltre l'ultima riga restituisce un avviso che fornisce il conteggio delle righe del file.528La lettura di un file vuoto restituisce un avviso che il file esiste ma i suoi contenuti sono vuoti, e un `offset` oltre l'ultima riga restituisce un avviso che fornisce il conteggio delle righe del file.

531 529 

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390 

391Su Linux, controlla le librerie condivise mancanti. Se `ldd` mostra librerie mancanti, potrebbe essere necessario installare pacchetti di sistema. Su Alpine Linux e altre distribuzioni basate su musl, vedi [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).391Su Linux, controlla le librerie condivise mancanti. Se `ldd` mostra librerie mancanti, potrebbe essere necessario installare pacchetti di sistema. Su Alpine Linux e altre distribuzioni basate su musl, vedi [Mancata corrispondenza del binario Linux musl o glibc](#linux-musl-or-glibc-binary-mismatch).

392 392 

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"

906 906 

907### Mancata corrispondenza del binario musl o glibc su Linux907### Mancata corrispondenza del binario musl o glibc su Linux

908 908 

909Se vedi errori relativi a librerie condivise mancanti come `libstdc++.so.6` o `libgcc_s.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante di binario sbagliata per il tuo sistema.909Se vedi errori relativi a librerie condivise mancanti come `ld-linux-x86-64.so.2` o `ld-linux-aarch64.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante di binario sbagliata per il tuo sistema.

910 910 

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914 

915Questo può accadere su sistemi basati su glibc che hanno installati pacchetti di cross-compilazione musl, inducendo il programma di installazione a rilevare erroneamente il sistema come musl.

916 

917**Soluzioni:**915**Soluzioni:**

918 916 

9191. **Verifica quale libc utilizza il tuo sistema**:9171. **Verifica quale libc utilizza il tuo sistema**:

924 922 

9252. **Se sei su glibc ma hai ottenuto il binario musl**, rimuovi l'installazione e reinstalla. Puoi anche scaricare manualmente il binario corretto utilizzando il manifest in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Apri una [issue su GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.9232. **Se sei su glibc ma hai ottenuto il binario musl**, rimuovi l'installazione e reinstalla. Puoi anche scaricare manualmente il binario corretto utilizzando il manifest in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Apri una [issue su GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.

926 924 

9273. **Se sei effettivamente su musl**, come Alpine Linux, installa i pacchetti richiesti:9253. **Se sei su musl ma hai ottenuto il binario glibc**, [rimuovi l'installazione](https://code.claude.com/docs/it/setup.md#uninstall-claude-code). Su Alpine Linux, installa prima i pacchetti indicati in [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions). Quindi esegui il [comando di installazione](https://code.claude.com/docs/it/setup.md#install-claude-code), che installa il binario musl.

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 Su Alpine, `ripgrep` si trova nel repository community. Se `apk` segnala che il pacchetto manca, consulta [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).

932 926 

933### `Illegal instruction`927### `Illegal instruction`

934 928 

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

155> `ripgrep` è nel repository community di Alpine. Se `apk` segnala che il pacchetto è mancante, vedi [Alpine Linux setup](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).155> `ripgrep` è nel repository community di Alpine.

156 156 

157> [tab] Arch157> [tab] Arch

158>158>

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | Distribuisce ricerche web su una domanda attraverso diverse angolazioni, recupera e verifica incrociando le fonti che trova, vota su ogni affermazione e restituisce un report con citazioni, filtrando le affermazioni che non hanno superato la verifica incrociata. Richiede che lo [strumento WebSearch](https://code.claude.com/docs/it/tools-reference.md#websearch-tool-behavior) sia disponibile |76| `/deep-research <question>` | Distribuisce ricerche web su una domanda attraverso diverse angolazioni, recupera e verifica incrociando le fonti che trova, vota su ogni affermazione e restituisce un report con citazioni, filtrando le affermazioni che non hanno superato la verifica incrociata. Richiede che lo [strumento WebSearch](https://code.claude.com/docs/it/tools-reference.md#websearch-tool-behavior) sia disponibile |

77 77 

78`/deep-research` viene eseguito solo quando lo invochi.

79 

80I [workflow che salvi](#save-the-workflow-for-reuse) tu stesso diventano comandi allo stesso modo e compaiono nel completamento automatico di `/` accanto a quelli inclusi.78I [workflow che salvi](#save-the-workflow-for-reuse) tu stesso diventano comandi allo stesso modo e compaiono nel completamento automatico di `/` accanto a quelli inclusi.

81 79 

82### Segui l'esecuzione80### Segui l'esecuzione