Documentation 2026-11-02 23:57 UTC to 2026-11-03 23:58 UTC

79* Distribuisci `wslInheritsWindowsSettings: true` attraverso il registro HKLM o il file `C:\Program Files\ClaudeCode` in modo che le sessioni WSL ereditino la stessa policy delle sessioni host.79* Distribuisci `wslInheritsWindowsSettings: true` attraverso il registro HKLM o il file `C:\Program Files\ClaudeCode` in modo che le sessioni WSL ereditino la stessa policy delle sessioni host.

80* Verifica eseguendo `/status` all'interno di una sessione WSL e leggendo la riga `Setting sources`. Per interpretare ciò che elenca, vedi [Leggi la fonte in /status](https://code.claude.com/docs/it/managed-settings.md#read-the-source-in-/status).80* Verifica eseguendo `/status` all'interno di una sessione WSL e leggendo la riga `Setting sources`. Per interpretare ciò che elenca, vedi [Leggi la fonte in /status](https://code.claude.com/docs/it/managed-settings.md#read-the-source-in-/status).

81 81 

82Se una sessione WSL si avvia su un dispositivo con l'elenco [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) di Claude Desktop, una voce `~` indica la directory home all'interno della distribuzione.

83 

82I processi all'interno della VM utility WSL 2 non sono visibili ai sensori di rilevamento endpoint lato Windows. Per osservare l'attività dei processi e dei file all'interno della distribuzione, controlla la guida WSL del tuo fornitore di rilevamento endpoint per un sensore Linux che puoi eseguire all'interno della distribuzione e le esclusioni di cui ha bisogno. La [telemetria di esecuzione dello strumento OpenTelemetry](https://code.claude.com/docs/it/monitoring-usage.md) di Claude Code viene emessa in modo identico per le sessioni WSL e native.84I processi all'interno della VM utility WSL 2 non sono visibili ai sensori di rilevamento endpoint lato Windows. Per osservare l'attività dei processi e dei file all'interno della distribuzione, controlla la guida WSL del tuo fornitore di rilevamento endpoint per un sensore Linux che puoi eseguire all'interno della distribuzione e le esclusioni di cui ha bisogno. La [telemetria di esecuzione dello strumento OpenTelemetry](https://code.claude.com/docs/it/monitoring-usage.md) di Claude Code viene emessa in modo identico per le sessioni WSL e native.

83 85 

84## Decidi cosa applicare86## Decidi cosa applicare

127 129 

128### Account GitHub connessi130### Account GitHub connessi

129 131 

130Sui piani Team ed Enterprise, la sezione GitHub di [**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) elenca le organizzazioni GitHub e gli account personali collegati alla tua organizzazione Claude tramite la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security condividono l'elenco. Per aprire la pagina è necessario un ruolo di amministratore nella tua organizzazione Claude.132Sui piani Team ed Enterprise, la sezione GitHub di [**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) elenca le organizzazioni GitHub e gli account personali collegati alla tua organizzazione Claude tramite la [Claude GitHub App](https://github.com/apps/claude). Claude Code, [Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github) e Claude Security condividono l'elenco. Per aprire la pagina è necessario un [ruolo Owner](https://code.claude.com/docs/it/server-managed-settings.md#access-control) nella tua organizzazione Claude. Il ruolo Admin non può aprirla.

131 133 

132Un amministratore o un membro può collegare un account:134È possibile collegare un account dalla pagina Git providers oppure connettendo GitHub a Claude:

133 135 

134* **Connessione dell'amministratore**: un amministratore fa clic su **Connect** in quella sezione, oppure su **Add organization** una volta che un account è connesso, e installa la Claude GitHub App su un'organizzazione GitHub. Collegare un'organizzazione in questo modo richiede una persona che sia sia proprietario dell'organizzazione GitHub sia amministratore della tua organizzazione Claude.136* **Connessione dell'Owner**: un Owner fa clic su **Connect** in quella sezione, oppure su **Add organization** una volta che un account è connesso, e installa la Claude GitHub App su un'organizzazione GitHub. Collegare un'organizzazione in questo modo richiede un Owner della tua organizzazione Claude che sia anche proprietario dell'organizzazione GitHub.

135* **Connessione del membro**: quando un membro connette il proprio account GitHub a Claude, ad esempio durante la [configurazione delle sessioni cloud](https://code.claude.com/docs/it/web-quickstart.md#connect-github), Claude collega gli account GitHub di proprietà di quel membro su cui la Claude GitHub App è già installata. Questi possono includere il suo account personale e le organizzazioni GitHub di cui è proprietario.137* **Connessione del membro**: quando un membro connette il proprio account GitHub a Claude, ad esempio durante la [configurazione delle sessioni cloud](https://code.claude.com/docs/it/web-quickstart.md#connect-github), Claude collega gli account GitHub di proprietà di quel membro su cui la Claude GitHub App è già installata. Questi possono includere il suo account personale e le organizzazioni GitHub di cui è proprietario.

136 138 

137Una riga contrassegnata come **Not linked** proviene dal tuo accesso a GitHub. Si tratta di un account che puoi vedere su GitHub su cui è installata la Claude GitHub App.139Una riga contrassegnata come **Not linked** proviene dal tuo accesso a GitHub. Si tratta di un account che puoi vedere su GitHub su cui è installata la Claude GitHub App.

222>222>

223> `effort` scambia latenza e costo dei token per profondità di ragionamento all'interno di ogni risposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) è una funzione separata che produce blocchi di `thinking` nell'output, e il campo `display` su `ThinkingConfig` per [Python](https://code.claude.com/docs/it/agent-sdk/python.md#thinkingconfig) o [TypeScript](https://code.claude.com/docs/it/agent-sdk/typescript.md#thinkingconfig) controlla se ricevete il loro testo. Sono indipendenti: potete impostare `effort: "low"` con extended thinking abilitato, o `effort: "max"` senza di esso.223> `effort` scambia latenza e costo dei token per profondità di ragionamento all'interno di ogni risposta. [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) è una funzione separata che produce blocchi di `thinking` nell'output, e il campo `display` su `ThinkingConfig` per [Python](https://code.claude.com/docs/it/agent-sdk/python.md#thinkingconfig) o [TypeScript](https://code.claude.com/docs/it/agent-sdk/typescript.md#thinkingconfig) controlla se ricevete il loro testo. Sono indipendenti: potete impostare `effort: "low"` con extended thinking abilitato, o `effort: "max"` senza di esso.

224 224 

225Utilizzate uno sforzo inferiore per gli agenti che eseguono attività semplici e ben definite (come elencare file o eseguire un singolo grep) per ridurre il costo e la latenza. Impostare `effort` nelle opzioni di livello superiore `query()` per l'intera sessione, o per subagente con il campo `effort` su [`AgentDefinition`](https://code.claude.com/docs/it/agent-sdk/subagents#agentdefinition-configuration) per sovrascrivere il livello di sessione.225Usa uno sforzo inferiore per gli agenti che eseguono attività semplici e ben definite, come elencare file o eseguire un singolo grep, per ridurre il costo e la latenza. Imposta `effort` nelle opzioni di livello superiore `query()` per la [sessione](https://code.claude.com/docs/it/sub-agents.md#choose-an-effort-level), o per singolo subagent con il campo `effort` su [`AgentDefinition`](https://code.claude.com/docs/it/agent-sdk/subagents#agentdefinition-configuration) per sovrascrivere il livello della sessione.

226 226 

227### Modalità di autorizzazione227### Modalità di autorizzazione

228 228 

224| `matcher` | `string` | `undefined` | Modello abbinato al campo di filtro dell'evento, seguendo le [regole per i matcher nei file di impostazioni](https://code.claude.com/docs/it/hooks.md#matcher-patterns). Per gli hook degli strumenti, quel campo è il nome dello strumento. Gli strumenti incorporati includono `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e altri. Consulta [Tipi di input degli strumenti](https://code.claude.com/docs/it/agent-sdk/typescript.md#tool-input-types) per l'elenco completo. Gli strumenti MCP utilizzano il modello `mcp__<server>__<action>`, dove `<server>` è la chiave che utilizzi nella configurazione `mcpServers`, scritta come descrive la [convenzione di denominazione degli strumenti](https://code.claude.com/docs/it/agent-sdk/mcp.md#tool-naming-convention). |224| `matcher` | `string` | `undefined` | Modello abbinato al campo di filtro dell'evento, seguendo le [regole per i matcher nei file di impostazioni](https://code.claude.com/docs/it/hooks.md#matcher-patterns). Per gli hook degli strumenti, quel campo è il nome dello strumento. Gli strumenti incorporati includono `Bash`, `Read`, `Write`, `Edit`, `Glob`, `Grep`, `WebFetch`, `Agent` e altri. Consulta [Tipi di input degli strumenti](https://code.claude.com/docs/it/agent-sdk/typescript.md#tool-input-types) per l'elenco completo. Gli strumenti MCP utilizzano il modello `mcp__<server>__<action>`, dove `<server>` è la chiave che utilizzi nella configurazione `mcpServers`, scritta come descrive la [convenzione di denominazione degli strumenti](https://code.claude.com/docs/it/agent-sdk/mcp.md#tool-naming-convention). |

225| `hooks` | `HookCallback[]` | - | Obbligatorio. Array di funzioni di callback da eseguire quando il modello corrisponde |225| `hooks` | `HookCallback[]` | - | Obbligatorio. Array di funzioni di callback da eseguire quando il modello corrisponde |

226| `timeout` | `number` | `undefined` | Timeout in secondi. Quando omesso, Claude Code applica il [timeout predefinito dell'evento](#hook-timeout). I tuoi callback SDK seguono i valori predefiniti dell'hook `command` |226| `timeout` | `number` | `undefined` | Timeout in secondi. Quando omesso, Claude Code applica il [timeout predefinito dell'evento](#hook-timeout). I tuoi callback SDK seguono i valori predefiniti dell'hook `command` |

227| `onFailure` | `"continue" \| "block"` | `undefined` | Cosa fa un callback non riuscito. Imposta `"block"` per [bloccare l'azione quando un callback non riesce](#block-the-action-when-a-callback-fails). In Python, utilizza `on_failure` |

227 228 

228Utilizza il modello `matcher` per indirizzare strumenti specifici quando possibile. Un matcher con `'Bash'` viene eseguito solo per i comandi Bash, mentre omettere il modello esegue i tuoi callback per ogni occorrenza dell'evento.229Utilizza il modello `matcher` per indirizzare strumenti specifici quando possibile. Un matcher con `'Bash'` viene eseguito solo per i comandi Bash, mentre omettere il modello esegue i tuoi callback per ogni occorrenza dell'evento.

229 230 

283>284>

284> Gli output asincroni non possono bloccare, modificare o iniettare contesto nell'operazione poiché l'agente ha già proseguito. Utilizzali solo per effetti collaterali come logging, metriche o notifiche.285> Gli output asincroni non possono bloccare, modificare o iniettare contesto nell'operazione poiché l'agente ha già proseguito. Utilizzali solo per effetti collaterali come logging, metriche o notifiche.

285 286 

287### Bloccare l'azione quando un callback non riesce

288 

289Nella maggior parte degli eventi, se un callback genera un'eccezione o restituisce un output che non supera la validazione, l'azione procede e la tua app riceve un avviso [`SDKInformationalMessage`](https://code.claude.com/docs/it/agent-sdk/typescript#sdkinformationalmessage) il cui `tag` è `hook_callback_failed`. Un controllo `PreToolUse` che si arresta in modo anomalo lascia quindi che la chiamata allo strumento raggiunga il normale flusso dei permessi. Anche un callback che non restituisce nulla, come un percorso senza `return`, conta come non riuscito. In Python, leggi `tag` da `SystemMessage.data`.

290 

291Per bloccare invece l'azione, imposta `onFailure: "block"` in TypeScript o `on_failure="block"` in Python sul matcher. Richiede TypeScript Agent SDK v0.3.317 o successivo, oppure Python Agent SDK v0.2.177 o successivo. Questo esempio blocca una chiamata Bash quando `check_policy` in Python o `checkPolicy` in TypeScript non riesce:

292 

293```python Python theme={null}

294options = ClaudeAgentOptions(

295 hooks={

296 "PreToolUse": [

297 HookMatcher(matcher="Bash", hooks=[check_policy], on_failure="block")

298 ]

299 }

300)

301```

302 

303```typescript TypeScript theme={null}

304import type { Options } from "@anthropic-ai/claude-agent-sdk";

305 

306const options: Options = {

307 hooks: {

308 PreToolUse: [{ matcher: "Bash", hooks: [checkPolicy], onFailure: "block" }]

309 }

310};

311```

312 

313Per testarlo, fai in modo che il callback generi un errore e chiedi a Claude di eseguire un comando Bash. Il risultato dello strumento include `failed; blocking because onFailure is "block"`, e Claude non vede il testo del tuo errore.

314 

315Restituisci `{}` quando il callback non ha un'opinione. Con `"block"` impostato, un percorso senza `return` blocca l'azione. Un callback che intercetta il proprio errore e restituisce `{}` non è considerato non riuscito, quindi lascia che l'errore si propaghi da un controllo.

316 

317#### Eventi che si comportano diversamente

318 

319Questi eventi non sempre bloccano con `"block"` impostato:

320 

321* **`Stop`, `SubagentStop`, `TaskCompleted` e `TeammateIdle`**: questi eventi ignorano l'opzione, quindi l'azione procede.

322* **`PermissionRequest`**: il blocco conta solo se arriva prima che il tuo callback `canUseTool` risponda.

323* **`PostToolUse`**: lo strumento è già stato eseguito, quindi Claude riceve l'errore come feedback.

324 

325Un callback che supera il proprio timeout segue [Timeout dell'hook](#hook-timeout). Con `"block"` impostato, un timeout blocca anche `PreCompact`, `Elicitation` e `WorktreeCreate`.

326 

327#### Errori di avvio per `onFailure`

328 

329Con `"block"` impostato, la query non riesce all'avvio e non invia alcun prompt quando non può rispettare l'opzione:

330 

331* **Claude Code non supporta l'opzione**: l'errore include `does not honor`. Aggiorna Claude Code o rimuovi l'opzione.

332* **La sessione era già in esecuzione e non ha registrato i tuoi hook**: l'errore include `did not register your hooks`. Avvia una nuova sessione.

333 

286## Esempi334## Esempi

287 335 

288Diversi esempi in questa sezione mostrano solo la funzione di callback. Per eseguirne uno, registrate il callback sotto l'evento corrispondente nel campo `hooks` delle vostre opzioni, come mostrato in [Configurare gli hooks](#configure-hooks).336Diversi esempi in questa sezione mostrano solo la funzione di callback. Per eseguirne uno, registrate il callback sotto l'evento corrispondente nel campo `hooks` delle vostre opzioni, come mostrato in [Configurare gli hooks](#configure-hooks).

779* `Stop` e `SubagentStop`: il callback scaduto conta come se non avesse restituito alcuna decisione. L'agente o il subagent si ferma come se quel callback lo avesse consentito, e una decisione dei tuoi altri hook sull'evento si applica comunque. Prima di Claude Code v2.1.273, un callback `Stop` o `SubagentStop` scaduto contava come un'esecuzione di hook non riuscita, e Claude Code scartava le decisioni dei tuoi altri hook sull'evento.827* `Stop` e `SubagentStop`: il callback scaduto conta come se non avesse restituito alcuna decisione. L'agente o il subagent si ferma come se quel callback lo avesse consentito, e una decisione dei tuoi altri hook sull'evento si applica comunque. Prima di Claude Code v2.1.273, un callback `Stop` o `SubagentStop` scaduto contava come un'esecuzione di hook non riuscita, e Claude Code scartava le decisioni dei tuoi altri hook sull'evento.

780* `SessionStart`: il callback scaduto conta come se non avesse restituito alcun output, e la sessione continua con l'output dei tuoi altri hook `SessionStart`.828* `SessionStart`: il callback scaduto conta come se non avesse restituito alcun output, e la sessione continua con l'output dei tuoi altri hook `SessionStart`.

781* `PreModelSwitch`: Claude Code blocca il cambio di modello. Un hook che non risponde non ha approvato il cambio.829* `PreModelSwitch`: Claude Code blocca il cambio di modello. Un hook che non risponde non ha approvato il cambio.

782* Altri eventi, come `Notification`, `PreCompact` e `PostModelSwitch`: Claude Code registra l'errore nei log e continua.830* Altri eventi, come `Notification`, `PreCompact` e `PostModelSwitch`: Claude Code registra l'errore nei log e continua. Con [`onFailure: "block"`](#block-the-action-when-a-callback-fails), un timeout su `PreCompact`, `Elicitation` o `WorktreeCreate` blocca l'azione.

783 831 

784La prima volta che un callback `Stop` o `SessionStart` scade nella sessione principale, Claude Code aggiunge anche un [`SDKInformationalMessage`](https://code.claude.com/docs/it/agent-sdk/typescript#sdkinformationalmessage) al flusso dei messaggi indicando che l'app che guida la sessione non ha risposto. I timeout successivi non ripetono quel messaggio finché la tua app rimane non responsiva.832La prima volta che un callback `Stop` o `SessionStart` scade nella sessione principale, Claude Code aggiunge anche un [`SDKInformationalMessage`](https://code.claude.com/docs/it/agent-sdk/typescript#sdkinformationalmessage) al flusso dei messaggi indicando che l'app che guida la sessione non ha risposto. I timeout successivi non ripetono quel messaggio finché la tua app rimane non responsiva.

785 833 

2161 None # Timeout in seconds. When omitted, the per-event default applies:2161 None # Timeout in seconds. When omitted, the per-event default applies:

2162 # 600 for most events, 30 for UserPromptSubmit2162 # 600 for most events, 30 for UserPromptSubmit

2163 )2163 )

2164 on_failure: Literal["continue", "block"] | None = (

2165 None # "block" blocks the action when a callback fails

2166 )

2164```2167```

2165 2168 

2169Per capire cosa copre `on_failure`, vedi [Bloccare l'azione quando un callback fallisce](https://code.claude.com/docs/it/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2170 

2166### `HookInput`2171### `HookInput`

2167 2172 

2168Tipo di unione di tutti i tipi di input hook. Il tipo effettivo dipende dal campo `hook_event_name`.2173Tipo di unione di tutti i tipi di input hook. Il tipo effettivo dipende dal campo `hook_event_name`.

2183 level: "info" | "notice" | "suggestion" | "warning";2183 level: "info" | "notice" | "suggestion" | "warning";

2184 tool_use_id?: string;2184 tool_use_id?: string;

2185 prevent_continuation?: boolean;2185 prevent_continuation?: boolean;

2186 tag?: string;

2186 uuid: UUID;2187 uuid: UUID;

2187 session_id: string;2188 session_id: string;

2188};2189};

2558 matcher?: string;2559 matcher?: string;

2559 hooks: HookCallback[];2560 hooks: HookCallback[];

2560 timeout?: number; // Timeout in secondi per tutti gli hook in questo matcher2561 timeout?: number; // Timeout in secondi per tutti gli hook in questo matcher

2562 onFailure?: "continue" | "block"; // "block" blocca l'azione quando un callback fallisce

2561}2563}

2562```2564```

2563 2565 

2566Per decidere cosa copre `onFailure`, vedi [Bloccare l'azione quando un callback fallisce](https://code.claude.com/docs/it/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

2567 

2564### `HookInput`2568### `HookInput`

2565 2569 

2566Tipo di unione di tutti i tipi di input hook.2570Tipo di unione di tutti i tipi di input hook.

158* **Alias di famiglia come `opus`**: sull'API Anthropic e su Claude Platform on AWS, Claude Code esegue il compagno di squadra sulla versione più recente di quella famiglia consentita dall'allowlist. Sui provider con ID di modello specifici del provider, dove la [sostituzione non opera](https://code.claude.com/docs/it/model-config.md#restrict-model-selection), un alias bloccato usa il fallback come qualsiasi altro valore bloccato, secondo il punto successivo158* **Alias di famiglia come `opus`**: sull'API Anthropic e su Claude Platform on AWS, Claude Code esegue il compagno di squadra sulla versione più recente di quella famiglia consentita dall'allowlist. Sui provider con ID di modello specifici del provider, dove la [sostituzione non opera](https://code.claude.com/docs/it/model-config.md#restrict-model-selection), un alias bloccato usa il fallback come qualsiasi altro valore bloccato, secondo il punto successivo

159* **Qualsiasi altro valore bloccato, incluso un alias di famiglia sui provider dove la sostituzione non opera, o uno la cui famiglia non ha alcuna versione consentita**: Claude Code esegue invece il compagno di squadra sul modello del lead. Se imposti `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code prova prima quel modello, secondo queste stesse regole159* **Qualsiasi altro valore bloccato, incluso un alias di famiglia sui provider dove la sostituzione non opera, o uno la cui famiglia non ha alcuna versione consentita**: Claude Code esegue invece il compagno di squadra sul modello del lead. Se imposti `CLAUDE_CODE_SUBAGENT_MODEL`, Claude Code prova prima quel modello, secondo queste stesse regole

160 160 

161Per impostazione predefinita, i compagni di squadra ereditano il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) del lead. Nella modalità a riquadri divisi questo si applica dalla v2.1.186; le versioni precedenti non passavano il livello di sforzo della sessione del lead ai compagni di squadra nei riquadri divisi.161Per impostazione predefinita, un compagno di squadra sul modello del lead eredita il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) del lead. Nella modalità a riquadri divisi questo si applica dalla v2.1.186; le versioni precedenti non passavano il livello di sforzo della sessione del lead ai compagni di squadra nei riquadri divisi. Per un compagno di squadra su un altro modello, consulta [Livello di sforzo di subagent e compagni di squadra](https://code.claude.com/docs/it/model-config.md#effort-level-of-subagents-and-teammates).

162 162 

163### Far pianificare i compagni di squadra prima dell'implementazione163### Far pianificare i compagni di squadra prima dell'implementazione

164 164 

165Per attività complesse o rischiose, puoi far pianificare i compagni di squadra prima dell'implementazione. Un compagno di squadra che Claude genera mentre il lead è in [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) lavora in plan mode di sola lettura finché il suo piano non è pronto. Porta prima il lead in plan mode, poi chiedi il compagno di squadra:165Per attività complesse o rischiose, puoi far pianificare i compagni di squadra prima dell'implementazione. Un compagno di squadra che Claude genera mentre il lead è in [plan mode](https://code.claude.com/docs/it/permission-modes.md#analyze-before-you-edit-with-plan-mode) lavora anch'esso in plan mode finché il suo piano non è pronto. Porta prima il lead in plan mode, poi chiedi il compagno di squadra:

166 166 

167```text wrap theme={null}167```text wrap theme={null}

168Spawn an architect teammate to refactor the authentication module.168Spawn an architect teammate to refactor the authentication module.

169```169```

170 170 

171Quando quel compagno di squadra termina la pianificazione, invia una richiesta di approvazione del piano al lead. Se non hai cambiato la modalità di permesso di quel compagno di squadra da quando è stato generato, Claude Code approva il piano non appena arriva la richiesta, senza che il lead lo esamini. Le modifiche e i comandi del compagno di squadra passano comunque attraverso le richieste di permesso descritte in [Permessi](#permissions). Una volta approvato, il compagno di squadra esce dal plan mode e inizia l'implementazione.171Quando quel compagno di squadra termina la pianificazione, invia una richiesta di approvazione del piano al lead. Se non hai cambiato la modalità di permesso di quel compagno di squadra da quando è stato generato, Claude Code approva il piano non appena arriva la richiesta, senza che il lead lo esamini. Una volta approvato, il compagno di squadra esce dal plan mode e inizia l'implementazione. Claude Code gli passa la [modalità di permesso](#permissions) corrente del lead, oppure Manual se questa è il plan mode.

172 172 

173Se metti in plan mode un compagno di squadra in-process in esecuzione premendo [`Shift+Tab`](https://code.claude.com/docs/it/permission-modes#switch-permission-modes) mentre visualizzi la sua sessione, è il lead a esaminare il piano di quell'esecuzione invece che Claude Code ad approvarlo. Non ti viene chiesto di approvarlo; il lead lo approva o lo rimanda indietro per una revisione.173Se metti in plan mode un compagno di squadra in-process in esecuzione premendo [`Shift+Tab`](https://code.claude.com/docs/it/permission-modes#switch-permission-modes) mentre visualizzi la sua sessione, è il lead a esaminare il piano di quell'esecuzione invece che Claude Code ad approvarlo. Non ti viene chiesto di approvarlo; il lead lo approva o lo rimanda indietro per una revisione.

174 174 

288 288 

289### Permessi289### Permessi

290 290 

291I compagni di squadra partono con la modalità di permesso del lead, ad eccezione della [modalità `dontAsk`](https://code.claude.com/docs/it/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), che non ereditano. Se il lead viene eseguito con `--dangerously-skip-permissions`, lo sono anche tutti i compagni di squadra. Dopo la creazione, puoi modificare la modalità di permesso di un singolo compagno di squadra, ma non puoi impostare modalità di permesso specifiche per ciascun compagno di squadra al momento della creazione.291Per cambiare ciclicamente la modalità di permesso di un compagno di squadra in esecuzione, premi [`Shift+Tab`](https://code.claude.com/docs/it/permission-modes#switch-permission-modes), anche se un compagno di squadra in-process può invece essere eseguito nella modalità del lead. Per un compagno di squadra a pannelli divisi, premilo nel suo pannello. Per un compagno di squadra [in-process](#choose-a-display-mode), premilo mentre [visualizzi la sua sessione](#talk-to-teammates-directly): il compagno di squadra controlla la propria modalità quando inizia il turno successivo.

292 

293> [!NOTE]

294>

295> Un compagno di squadra in-process che non è in [plan mode](#have-teammates-plan-before-implementing) viene eseguito nella modalità del lead mentre il lead è in modalità [`acceptEdits`](https://code.claude.com/docs/it/permission-modes#auto-approve-file-edits-with-acceptedits-mode), [`auto`](https://code.claude.com/docs/it/permission-modes#eliminate-prompts-with-auto-mode) o [`bypassPermissions`](https://code.claude.com/docs/it/permission-modes#skip-all-checks-with-bypasspermissions-mode). Passare il compagno di squadra a Manual non cambia questo comportamento, anche se la sua barra di stato mostra Manual.

296>

297> Per fare in modo che chieda conferma prima di modificare, premi Enter sulla riga `main` nel pannello degli agenti e passa anche il lead alla modalità Manual. A quel punto anche il lead chiede conferma, così come qualsiasi altro compagno di squadra in modalità Manual.

298 

299Non puoi impostare modalità di permesso specifiche per ciascun compagno di squadra al momento della creazione. Un nuovo compagno di squadra parte con la modalità del lead, inclusa la modalità `bypassPermissions`, che viene attivata da `--dangerously-skip-permissions`. Se il lead è in [modalità `dontAsk`](https://code.claude.com/docs/it/permission-modes#allow-only-pre-approved-tools-with-dontask-mode), il compagno di squadra parte invece in [modalità Manual](https://code.claude.com/docs/it/permission-modes.md#available-modes).

292 300 

293Un compagno di squadra [in-process](#choose-a-display-mode) viene eseguito con le regole allow e deny attive del lead, quindi [`--disallowedTools`](https://code.claude.com/docs/it/cli-reference#cli-flags), `--tools` e `--allowedTools` si applicano tutti a esso. Per un compagno di squadra a pannelli divisi, verifica ciascun flag:301Un compagno di squadra [in-process](#choose-a-display-mode) viene eseguito con le regole allow e deny attive del lead, quindi [`--disallowedTools`](https://code.claude.com/docs/it/cli-reference#cli-flags), `--tools` e `--allowedTools` si applicano tutti a esso. Per un compagno di squadra a pannelli divisi, verifica ciascun flag:

294 302 

488* **Nessun team annidato**: i compagni di team non possono generare i loro propri compagni di team. Solo il lead può gestire il team.496* **Nessun team annidato**: i compagni di team non possono generare i loro propri compagni di team. Solo il lead può gestire il team.

489* **Nessun subagent in background da compagni di team in-process**: i subagent di un compagno di team in-process vengono eseguiti in primo piano, perché il lavoro in background di un compagno di team non può sopravvivere al processo del lead. Claude Code restituisce un errore quando un compagno di team genera un subagent la cui definizione imposta `background: true`. Anche una richiesta `run_in_background: true` di un compagno di team fallisce, con un errore o eseguendosi silenziosamente in primo piano. I subagent lanciati dalla conversazione principale seguono il [default in background](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background).497* **Nessun subagent in background da compagni di team in-process**: i subagent di un compagno di team in-process vengono eseguiti in primo piano, perché il lavoro in background di un compagno di team non può sopravvivere al processo del lead. Claude Code restituisce un errore quando un compagno di team genera un subagent la cui definizione imposta `background: true`. Anche una richiesta `run_in_background: true` di un compagno di team fallisce, con un errore o eseguendosi silenziosamente in primo piano. I subagent lanciati dalla conversazione principale seguono il [default in background](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background).

490* **Il lead è fisso**: la sessione principale è il lead per tutta la sua durata. Non potete promuovere un compagno di team a lead o trasferire la leadership.498* **Il lead è fisso**: la sessione principale è il lead per tutta la sua durata. Non potete promuovere un compagno di team a lead o trasferire la leadership.

491* **Permessi impostati al momento della generazione**: i compagni di team iniziano con la modalità di permesso descritta in [Permessi](#permissions). Potete cambiare la modalità di permesso di un singolo compagno di team dopo la generazione, ma non potete impostare modalità di permesso per compagno di team al momento della generazione.499* **Nessuna modalità di permesso per singolo compagno di team al momento della generazione**: i compagni di team iniziano con la modalità di permesso descritta in [Permessi](#permissions).

492* **Split panes richiedono tmux o iTerm2**: la modalità in-process predefinita funziona in qualsiasi terminale. La modalità split-pane non è supportata nel terminale integrato di VS Code, Windows Terminal o Ghostty.500* **Split panes richiedono tmux o iTerm2**: la modalità in-process predefinita funziona in qualsiasi terminale. La modalità split-pane non è supportata nel terminale integrato di VS Code, Windows Terminal o Ghostty.

493 501 

494## Prossimi passi502## Prossimi passi

442 442 

443Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per dare prima un'istruzione in più. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.443Esegui `/background` o il suo alias `/bg` per spostare la conversazione corrente in una sessione in background. Passa un prompt come `/bg run the test suite and fix any failures` per dare prima un'istruzione in più. Se Claude sta rispondendo quando esegui `/bg`, la risposta continua nella sessione in background.

444 444 

445L'uscita da una sessione che ha ancora lavoro in background in esecuzione, come subagent, comandi shell in background, workflow o [monitor](https://code.claude.com/docs/it/tools-reference.md#monitor-tool), mostra una finestra di dialogo `Background work is running` invece di uscire immediatamente. Scegli `Move to background and exit` per inviare la sessione in background nello stesso modo in cui lo fa `/background` e tornare alla tua shell. L'opzione non viene mostrata quando la vista agente è [disattivata](#turn-off-agent-view).445Se esci da una sessione mentre sono in esecuzione alcuni tipi di lavoro in background, come subagent o workflow, una finestra di dialogo `Background work is running` avvisa che il lavoro si interrompe. Scegli `Move to background and exit` per inviare la sessione in background nello stesso modo in cui lo fa `/background` e tornare alla tua shell. L'opzione non viene mostrata quando la vista agente è [disattivata](#turn-off-agent-view).

446 446 

447Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come `my-session (2)`, e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala nella vista agente e premi `Ctrl+R`.447Se una sessione in background nell'elenco ha già il nome della conversazione, Claude Code numera il nome della nuova riga, come `my-session (2)`, e lascia il nome della riga esistente invariato. Per rinominare la nuova riga, selezionala nella vista agente e premi `Ctrl+R`.

448 448 

315* Un pin nel blocco `env` delle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md)315* Un pin nel blocco `env` delle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md)

316* Un pin che punta a un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile), poiché è gestito dall'amministratore316* Un pin che punta a un [ARN del profilo di inferenza dell'applicazione](#map-each-model-version-to-an-inference-profile), poiché è gestito dall'amministratore

317 317 

318Se la richiesta di aggiornamento compare ancora per un pin nelle impostazioni gestite, aggiorna Claude Code alla v2.1.314 o a una versione successiva. Prima della v2.1.314, il pin gestito restava in vigore dopo che avevi accettato, quindi la richiesta ricompariva all'avvio successivo.

319 

318Se non hai fissato un modello e il valore predefinito corrente non è disponibile nel tuo account, Claude Code esegue il fallback per la sessione corrente e mostra un avviso. Prova prima le versioni precedenti del modello predefinito e, quando il valore predefinito è un modello Opus e nessuna versione Opus è disponibile, esegue il fallback al modello Sonnet predefinito. Il fallback non viene mantenuto. Abilita il modello più recente nel tuo account Amazon Bedrock o [fissa una versione](#4-pin-model-versions) per rendere permanente la scelta.320Se non hai fissato un modello e il valore predefinito corrente non è disponibile nel tuo account, Claude Code esegue il fallback per la sessione corrente e mostra un avviso. Prova prima le versioni precedenti del modello predefinito e, quando il valore predefinito è un modello Opus e nessuna versione Opus è disponibile, esegue il fallback al modello Sonnet predefinito. Il fallback non viene mantenuto. Abilita il modello più recente nel tuo account Amazon Bedrock o [fissa una versione](#4-pin-model-versions) per rendere permanente la scelta.

319 321 

322### Avviare una sessione su un modello specifico

323 

320Quando avvii la sessione su una versione specifica di Sonnet oppure Opus, ad esempio con `--model`, `ANTHROPIC_MODEL`, o l'[impostazione `model`](https://code.claude.com/docs/it/settings-reference#model), quella versione agisce come valore predefinito fissato della sessione per l'alias `sonnet` oppure `opus` corrispondente. Claude Code salta il controllo di disponibilità per il valore predefinito integrato che il tuo modello sostituisce e si avvia sul modello che hai configurato, senza alcun avviso di fallback.324Quando avvii la sessione su una versione specifica di Sonnet oppure Opus, ad esempio con `--model`, `ANTHROPIC_MODEL`, o l'[impostazione `model`](https://code.claude.com/docs/it/settings-reference#model), quella versione agisce come valore predefinito fissato della sessione per l'alias `sonnet` oppure `opus` corrispondente. Claude Code salta il controllo di disponibilità per il valore predefinito integrato che il tuo modello sostituisce e si avvia sul modello che hai configurato, senza alcun avviso di fallback.

321 325 

322Questi non agiscono come pin quando avvii una sessione su di essi:326Questi non agiscono come pin quando avvii una sessione su di essi:

324* Un alias del modello come `opus`328* Un alias del modello come `opus`

325* Un ID del modello che Claude Code non riconosce, come un ARN del profilo di inferenza dell'applicazione329* Un ID del modello che Claude Code non riconosce, come un ARN del profilo di inferenza dell'applicazione

326 330 

327Quando questi controlli trovano un modello che il tuo account non può richiamare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo l'avvio salta il modello ricordato senza chiedere di nuovo ad Amazon Bedrock. Claude Code controlla di nuovo all'avvio un rifiuto ricordato di un modello predefinito corrente una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che l'amministratore riabilita ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/it/env-vars).331### Rifiuti dei modelli ricordati

332 

333Quando i controlli del modello all'avvio trovano un modello che il tuo account non può richiamare, Claude Code può ricordare il rifiuto su questa macchina per un massimo di un giorno. Una volta passati dieci minuti dall'ultimo controllo, Claude Code controlla di nuovo all'avvio un rifiuto ricordato di un modello predefinito corrente. Un valore predefinito che l'amministratore riabilita quindi ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/it/env-vars).

328 334 

329### Quando la tua organizzazione applica un'allowlist dei modelli335### Quando la tua organizzazione applica un'allowlist dei modelli

330 336 

457 463 

458## AWS Guardrails464## AWS Guardrails

459 465 

460[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) ti consente di implementare il filtro dei contenuti per Claude Code. Crea un Guardrail nella [console di Amazon Bedrock](https://console.aws.amazon.com/bedrock/), pubblica una versione, quindi aggiungi le intestazioni Guardrail al tuo [file di impostazioni](https://code.claude.com/docs/it/settings.md). Abilita l'inferenza tra regioni sul tuo Guardrail se stai utilizzando profili di inferenza tra regioni.466[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) ti consente di implementare il filtro dei contenuti per Claude Code. Crea un Guardrail nella [console di Amazon Bedrock](https://console.aws.amazon.com/bedrock/) e pubblica una versione. Abilita l'inferenza tra regioni sul tuo Guardrail se stai utilizzando profili di inferenza tra regioni.

461 467 

462Configurazione di esempio:468Per applicare il Guardrail tramite un [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway), segui [Applicare un guardrail di Amazon Bedrock](https://code.claude.com/docs/it/claude-apps-gateway-config.md#apply-an-amazon-bedrock-guardrail). Senza un gateway delle app Claude, aggiungi le intestazioni Guardrail al tuo [file di impostazioni](https://code.claude.com/docs/it/settings.md).

469 

470Configurazione di esempio del file di impostazioni:

463 471 

464```json theme={null}472```json theme={null}

465{473{

469}477}

470```478```

471 479 

472Se la tua organizzazione fornisce le intestazioni del guardrail attraverso una politica di [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway), contano come [impostazioni che richiedono approvazione](https://code.claude.com/docs/it/server-managed-settings.md#environment-variables-and-the-approval-dialog).

473 

474Quando il guardrail blocca una risposta a metà, il testo trasmesso fino a quel momento rimane e la risposta termina con il messaggio configurato sul guardrail per le risposte bloccate.480Quando il guardrail blocca una risposta a metà, il testo trasmesso fino a quel momento rimane e la risposta termina con il messaggio configurato sul guardrail per le risposte bloccate.

475 481 

476## Utilizza l'endpoint Mantle482## Utilizza l'endpoint Mantle

2512. Variabile di ambiente `ANTHROPIC_AUTH_TOKEN`. Inviata come header `Authorization: Bearer`. Utilizzatela quando si instrada attraverso un [gateway LLM o proxy](https://code.claude.com/docs/it/llm-gateway) che si autentica con bearer token anziché chiavi API Anthropic.2512. Variabile di ambiente `ANTHROPIC_AUTH_TOKEN`. Inviata come header `Authorization: Bearer`. Utilizzatela quando si instrada attraverso un [gateway LLM o proxy](https://code.claude.com/docs/it/llm-gateway) che si autentica con bearer token anziché chiavi API Anthropic.

2523. Variabile di ambiente `ANTHROPIC_API_KEY`. Inviata come header `X-Api-Key`. Utilizzatela per l'accesso diretto all'API Anthropic con una chiave dalla [Claude Console](https://platform.claude.com). In modalità interattiva, vi viene chiesto una volta di approvare o rifiutare la chiave, e la Vostra scelta viene ricordata. Per cambiarla in seguito, utilizzate l'interruttore "Use custom API key" in `/config`. L'interruttore appare solo mentre `ANTHROPIC_API_KEY` è impostato nel Vostro ambiente. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente.2523. Variabile di ambiente `ANTHROPIC_API_KEY`. Inviata come header `X-Api-Key`. Utilizzatela per l'accesso diretto all'API Anthropic con una chiave dalla [Claude Console](https://platform.claude.com). In modalità interattiva, vi viene chiesto una volta di approvare o rifiutare la chiave, e la Vostra scelta viene ricordata. Per cambiarla in seguito, utilizzate l'interruttore "Use custom API key" in `/config`. L'interruttore appare solo mentre `ANTHROPIC_API_KEY` è impostato nel Vostro ambiente. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente.

2534. Output dello script [`apiKeyHelper`](https://code.claude.com/docs/it/settings-reference#apikeyhelper). Utilizzatelo per credenziali dinamiche o rotanti, come token di breve durata recuperati da un vault.2534. Output dello script [`apiKeyHelper`](https://code.claude.com/docs/it/settings-reference#apikeyhelper). Utilizzatelo per credenziali dinamiche o rotanti, come token di breve durata recuperati da un vault.

2545. Variabile di ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth di lunga durata generato da [`claude setup-token`](#generate-a-long-lived-token). Utilizzatelo per pipeline CI e script dove l'accesso tramite browser non è disponibile. Se eseguite `/login` mentre la variabile è impostata, Claude Code passa la sessione corrente al nuovo accesso, ma legge di nuovo la variabile in ogni nuova sessione fino a quando non la rimuovete dal Vostro profilo shell o dal blocco `env` di un [file di impostazioni](https://code.claude.com/docs/it/settings.md).2545. Variabile d'ambiente `CLAUDE_CODE_OAUTH_TOKEN`. Un token OAuth di lunga durata generato da [`claude setup-token`](#generate-a-long-lived-token). Usalo per pipeline CI e script in cui l'accesso tramite browser non è disponibile. Se esegui `/login` mentre la variabile è impostata, Claude Code passa la sessione corrente al nuovo accesso. Per mantenere quell'accesso nelle nuove sessioni, rimuovi la variabile dal tuo profilo shell e dai [file di impostazioni che possono impostarla](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env), come le tue impostazioni utente.

2556. Credenziali del profilo Anthropic e di federazione, le credenziali che la CLI `ant` e Workload Identity Federation utilizzano. Un profilo che `ant auth login` ha scritto si classifica qui solo quando lo nominate in `ANTHROPIC_PROFILE`; altrimenti si classifica al di sotto di `/login`. Consultate [Profili Anthropic e credenziali di federazione](#anthropic-profiles-and-federation-credentials).2556. Credenziali del profilo Anthropic e di federazione, le credenziali che la CLI `ant` e Workload Identity Federation utilizzano. Un profilo che `ant auth login` ha scritto si classifica qui solo quando lo nominate in `ANTHROPIC_PROFILE`; altrimenti si classifica al di sotto di `/login`. Consultate [Profili Anthropic e credenziali di federazione](#anthropic-profiles-and-federation-credentials).

2567. Credenziali OAuth dell'abbonamento da `/login`. Questo è il valore predefinito per gli utenti Claude Pro, Max, Ultra, Team ed Enterprise.2567. Credenziali OAuth dell'abbonamento da `/login`. Questo è il valore predefinito per gli utenti Claude Pro, Max, Ultra, Team ed Enterprise.

257 257 

603>603>

604> Un'esecuzione `claude -p --worktree` va ripulita da te, dato che termina senza chiedere. Rimuovi questi worktree con `git worktree remove <path>` e, se git si rifiuta perché il worktree è bloccato, esegui prima `git worktree unlock <path>`.604> Un'esecuzione `claude -p --worktree` va ripulita da te, dato che termina senza chiedere. Rimuovi questi worktree con `git worktree remove <path>` e, se git si rifiuta perché il worktree è bloccato, esegui prima `git worktree unlock <path>`.

605 605 

606Per una grande modifica meccanica su molti file, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/it/commands) divide il lavoro in 5-30 unità e ti mostra il piano. Poi esegue ogni unità nel proprio worktree e apre una PR per ciascuna. Dalla tua shell, [`claude agents`](https://code.claude.com/docs/it/agent-view) (ancora in anteprima di ricerca) ti offre un'unica schermata per tutto ciò che è in esecuzione in background sulla tua macchina.606Per una grande modifica meccanica su molti file, [`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/it/commands) divide il lavoro in 5-30 unità e ti mostra il piano. Una volta approvato, ogni unità ottiene il proprio worktree e apre una PR o riporta cosa è successo. Dalla tua shell, [`claude agents`](https://code.claude.com/docs/it/agent-view) (ancora in anteprima di ricerca) ti offre un'unica schermata per tutto ciò che è in esecuzione in background sulla tua macchina.

607 607 

608Una seconda sessione è anche il revisore indipendente più semplice che puoi avere. Una sessione scrive il rate limiter, un'altra esamina `@src/middleware/rateLimiter.ts` senza averne osservato la scrittura, e tu incolli i risultati nella prima. Stessa idea di `/code-review`, con te a fare da messaggero.608Una seconda sessione è anche il revisore indipendente più semplice che puoi avere. Una sessione scrive il rate limiter, un'altra esamina `@src/middleware/rateLimiter.ts` senza averne osservato la scrittura, e tu incolli i risultati nella prima. Stessa idea di `/code-review`, con te a fare da messaggero.

609 609 

85| `--desktop` | Apri l'[app Claude Desktop](https://code.claude.com/docs/it/desktop.md) nella directory corrente e esci senza avviare una sessione nel terminale. Aggiungi `--continue`, o `--resume` con un ID di sessione, per [aprire quella sessione in Desktop](https://code.claude.com/docs/it/desktop.md#coming-from-the-cli) invece. `--resume` qui accetta solo un ID di sessione, non un nome o un percorso di trascrizione. Non accetta prompt e nessun altro flag tranne `--verbose` e i flag `--debug`, poiché l'app avvia la sessione stessa. Disponibile su macOS e Windows x64 quando sei connesso con un abbonamento Claude. Richiede Claude Code v2.1.285 o successivo | `claude --desktop` |85| `--desktop` | Apri l'[app Claude Desktop](https://code.claude.com/docs/it/desktop.md) nella directory corrente e esci senza avviare una sessione nel terminale. Aggiungi `--continue`, o `--resume` con un ID di sessione, per [aprire quella sessione in Desktop](https://code.claude.com/docs/it/desktop.md#coming-from-the-cli) invece. `--resume` qui accetta solo un ID di sessione, non un nome o un percorso di trascrizione. Non accetta prompt e nessun altro flag tranne `--verbose` e i flag `--debug`, poiché l'app avvia la sessione stessa. Disponibile su macOS e Windows x64 quando sei connesso con un abbonamento Claude. Richiede Claude Code v2.1.285 o successivo | `claude --desktop` |

86| `--disable-slash-commands` | Disabilita tutte le skills e i comandi per questa sessione | `claude --disable-slash-commands` |86| `--disable-slash-commands` | Disabilita tutte le skills e i comandi per questa sessione | `claude --disable-slash-commands` |

87| `--disallowedTools`, `--disallowed-tools` | Regole di negazione. Un nome di strumento nudo rimuove gli strumenti corrispondenti dal contesto di Claude: `"Edit"` rimuove Edit, `"*"` rimuove ogni strumento, e `"mcp__*"` rimuove ogni strumento MCP. Una regola con ambito come `Bash(rm *)` lascia lo strumento disponibile e nega solo le chiamate che corrispondono [come scritto](https://code.claude.com/docs/it/permissions.md#bash-rule-limits). Una regola che nomina [`EndConversation`](https://code.claude.com/docs/it/tools-reference#endconversation-tool-behavior) non può rimuoverla mentre rimane qualsiasi altro strumento | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |87| `--disallowedTools`, `--disallowed-tools` | Regole di negazione. Un nome di strumento nudo rimuove gli strumenti corrispondenti dal contesto di Claude: `"Edit"` rimuove Edit, `"*"` rimuove ogni strumento, e `"mcp__*"` rimuove ogni strumento MCP. Una regola con ambito come `Bash(rm *)` lascia lo strumento disponibile e nega solo le chiamate che corrispondono [come scritto](https://code.claude.com/docs/it/permissions.md#bash-rule-limits). Una regola che nomina [`EndConversation`](https://code.claude.com/docs/it/tools-reference#endconversation-tool-behavior) non può rimuoverla mentre rimane qualsiasi altro strumento | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

88| `--effort` | Imposta il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`, o `ultracode`. I livelli disponibili dipendono dal modello. `ultracode` richiede uno sforzo `xhigh` con [ultracode](https://code.claude.com/docs/it/workflows.md#let-claude-decide-with-ultracode) attivato, e richiede Claude Code v2.1.203 o successivo. Sostituisce le impostazioni [`modelSettings`](https://code.claude.com/docs/it/settings-reference#modelsettings) e [`effortLevel`](https://code.claude.com/docs/it/settings-reference#effortlevel) per questa sessione e non persiste | `claude --effort high` |88| `--effort` | Imposta il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`, o `ultracode`. I livelli disponibili dipendono dal modello. `ultracode` richiede uno sforzo `xhigh` con [ultracode](https://code.claude.com/docs/it/workflows.md#let-claude-decide-with-ultracode) attivato, e richiede Claude Code v2.1.203 o successivo. Sul modello della conversazione principale, sovrascrive le impostazioni [`modelSettings`](https://code.claude.com/docs/it/settings-reference#modelsettings) e [`effortLevel`](https://code.claude.com/docs/it/settings-reference#effortlevel) per questa sessione e non persiste | `claude --effort high` |

89| `--enable-auto-mode` | Rimosso in v2.1.111. La modalità auto è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in essa | `claude --permission-mode auto` |89| `--enable-auto-mode` | Rimosso in v2.1.111. La modalità auto è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in essa | `claude --permission-mode auto` |

90| `--environment <environment-id>` | Crea una nuova sessione cloud che viene eseguita sull'[ambiente auto-ospitato](https://code.claude.com/docs/it/self-hosted-environments) con l'ID fornito. Gli ID ambiente iniziano con `ccpool_`. Vedi il [comportamento di dispatch di `--environment`](https://code.claude.com/docs/it/self-hosted-environments-testing#environment-dispatch-behavior) per il comportamento di dispatch e le combinazioni di flag che rifiuta. Richiede Claude Code v2.1.224 o successivo | `claude -p "Fix the login bug" --environment ccpool_abc123` |90| `--environment <environment-id>` | Crea una nuova sessione cloud che viene eseguita sull'[ambiente auto-ospitato](https://code.claude.com/docs/it/self-hosted-environments) con l'ID fornito. Gli ID ambiente iniziano con `ccpool_`. Vedi il [comportamento di dispatch di `--environment`](https://code.claude.com/docs/it/self-hosted-environments-testing#environment-dispatch-behavior) per il comportamento di dispatch e le combinazioni di flag che rifiuta. Richiede Claude Code v2.1.224 o successivo | `claude -p "Fix the login bug" --environment ccpool_abc123` |

91| `--exclude-dynamic-system-prompt-sections` | Sposta il contesto per utente, come la posizione della memoria automatica, fuori dal prompt di sistema e nel primo messaggio dell'utente. Migliora il riutilizzo della cache dei prompt tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script, multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |91| `--exclude-dynamic-system-prompt-sections` | Sposta il contesto per utente, come la posizione della memoria automatica, fuori dal prompt di sistema e nel primo messaggio dell'utente. Migliora il riutilizzo della cache dei prompt tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script, multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

33 33 

34**2. Continua a lavorare**34**2. Continua a lavorare**

35 35 

36La revisione viene eseguita come [subagent](https://code.claude.com/docs/it/sub-agents.md) in background con la propria finestra di contesto, quindi non riempie la tua conversazione. I risultati arrivano nella tua conversazione quando la revisione è completata.36In una sessione nel terminale, la revisione viene eseguita come [subagent](https://code.claude.com/docs/it/sub-agents.md) in background con la propria finestra di contesto, quindi non riempie la tua conversazione. I risultati arrivano nella tua conversazione quando la revisione è completata.

37 37 

38**3. Agisci sui risultati**38**3. Agisci sui risultati**

39 39 

59| `/autocompact [auto\|<tokens>]` | Imposta la finestra di compattazione automatica: quanto si riempie la finestra di contesto prima che Claude Code esegua la compattazione automaticamente. Passa una dimensione come `500k`, oppure `auto` per tornare alla finestra ottimizzata per il tuo modello. Claude Code salva il valore nelle impostazioni utente e lo applica alla sessione corrente. Consulta [Impostare la finestra di compattazione automatica](https://code.claude.com/docs/it/model-config.md#set-the-auto-compact-window) per i valori accettati e ciò che lo sovrascrive. Senza argomento, apre una finestra di dialogo che mostra la finestra corrente. Richiede Claude Code v2.1.221 o successiva |59| `/autocompact [auto\|<tokens>]` | Imposta la finestra di compattazione automatica: quanto si riempie la finestra di contesto prima che Claude Code esegua la compattazione automaticamente. Passa una dimensione come `500k`, oppure `auto` per tornare alla finestra ottimizzata per il tuo modello. Claude Code salva il valore nelle impostazioni utente e lo applica alla sessione corrente. Consulta [Impostare la finestra di compattazione automatica](https://code.claude.com/docs/it/model-config.md#set-the-auto-compact-window) per i valori accettati e ciò che lo sovrascrive. Senza argomento, apre una finestra di dialogo che mostra la finestra corrente. Richiede Claude Code v2.1.221 o successiva |

60| `/autofix-pr [prompt]` | Avvia una [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md#auto-fix-pull-requests) che monitora la PR del branch corrente ed esegue il push delle correzioni quando la CI fallisce o i revisori lasciano commenti. Rileva la PR aperta dal branch di cui hai eseguito il checkout con `gh pr view`; per monitorare una PR diversa, esegui prima il checkout del suo branch. Per impostazione predefinita, alla sessione cloud viene indicato di correggere ogni errore della CI e ogni commento di revisione; passa un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso alle [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) |60| `/autofix-pr [prompt]` | Avvia una [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md#auto-fix-pull-requests) che monitora la PR del branch corrente ed esegue il push delle correzioni quando la CI fallisce o i revisori lasciano commenti. Rileva la PR aperta dal branch di cui hai eseguito il checkout con `gh pr view`; per monitorare una PR diversa, esegui prima il checkout del suo branch. Per impostazione predefinita, alla sessione cloud viene indicato di correggere ogni errore della CI e ogni commento di revisione; passa un prompt per darle istruzioni diverse, ad esempio `/autofix-pr only fix lint and type errors`. Richiede la CLI `gh` e l'accesso alle [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) |

61| `/background [prompt]` | Scollega la sessione corrente per eseguirla come [agente in background](https://code.claude.com/docs/it/agent-view.md) e liberare questo terminale. Passa un prompt per inviare un'ultima istruzione prima di scollegarla. Monitora la sessione con `claude agents`. Per copiare la conversazione in una nuova sessione in background mentre questa continua a essere eseguita, usa `/fork`. Alias: `/bg` |61| `/background [prompt]` | Scollega la sessione corrente per eseguirla come [agente in background](https://code.claude.com/docs/it/agent-view.md) e liberare questo terminale. Passa un prompt per inviare un'ultima istruzione prima di scollegarla. Monitora la sessione con `claude agents`. Per copiare la conversazione in una nuova sessione in background mentre questa continua a essere eseguita, usa `/fork`. Alias: `/bg` |

62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Orchestra modifiche su larga scala in un codebase in parallelo. Analizza il codebase, scompone il lavoro in 5-30 unità indipendenti e presenta un piano. Una volta approvato, avvia un [subagent in background](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) per ogni unità in un [worktree](https://code.claude.com/docs/it/worktrees.md) isolato. Ogni subagent implementa la propria unità, esegue i test e pubblica la propria modifica. Richiede un repository git o un [hook `WorktreeCreate`](https://code.claude.com/docs/it/worktrees#non-git-version-control) che crei i worktree. Al di fuori di un repository git, `/batch` richiede Claude Code v2.1.281 o successiva. Esempio: `/batch migrate src/ from JavaScript to TypeScript` |62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Orchestra modifiche su larga scala in un codebase in parallelo. Analizza il codebase, scompone il lavoro in 5-30 unità indipendenti e presenta un piano. Una volta approvato, avvia un [subagent in background](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) per ogni unità in un [worktree](https://code.claude.com/docs/it/worktrees.md) isolato. Ogni subagent implementa la propria unità, esegue i test e apre una PR oppure riferisce cosa è successo. Richiede un repository git o un [hook `WorktreeCreate`](https://code.claude.com/docs/it/worktrees#non-git-version-control) che crei i worktree. Al di fuori di un repository git, `/batch` richiede Claude Code v2.1.281 o successiva. Esempio: `/batch migrate src/ from JavaScript to TypeScript` |

63| `/branch [name]` | Crea un branch della conversazione corrente a questo punto, così puoi provare una direzione diversa senza perdere la conversazione così com'è. Ti sposta nel branch e conserva l'originale, a cui puoi tornare con `/resume`. Per eseguire una copia come [sessione in background](https://code.claude.com/docs/it/agent-view.md) separata invece di spostarti al suo interno, usa `/fork`; per affidare un'attività secondaria a un [subagent](https://code.claude.com/docs/it/sub-agents.md) che riferisce in questa conversazione, usa `/subtask` |63| `/branch [name]` | Crea un branch della conversazione corrente a questo punto, così puoi provare una direzione diversa senza perdere la conversazione così com'è. Ti sposta nel branch e conserva l'originale, a cui puoi tornare con `/resume`. Per eseguire una copia come [sessione in background](https://code.claude.com/docs/it/agent-view.md) separata invece di spostarti al suo interno, usa `/fork`; per affidare un'attività secondaria a un [subagent](https://code.claude.com/docs/it/sub-agents.md) che riferisce in questa conversazione, usa `/subtask` |

64| `/btw [question]` | Pone una [domanda a margine](https://code.claude.com/docs/it/interactive-mode.md#side-questions-with-%2Fbtw) sulla sessione corrente senza aggiungerla alla conversazione. Se esegui `/btw` senza una domanda, Claude Code mostra la tua domanda a margine più recente così puoi sfogliare le risposte precedenti; se non ne hai ancora fatta una, Claude Code stampa una riga di utilizzo |64| `/btw [question]` | Pone una [domanda a margine](https://code.claude.com/docs/it/interactive-mode.md#side-questions-with-%2Fbtw) sulla sessione corrente senza aggiungerla alla conversazione. Se esegui `/btw` senza una domanda, Claude Code mostra la tua domanda a margine più recente così puoi sfogliare le risposte precedenti; se non ne hai ancora fatta una, Claude Code stampa una riga di utilizzo |

65| `/bug [report]` | Segnala un bug o condivide la tua conversazione. Scegli quanta cronologia della sessione includere e confermi in una schermata di consenso prima che venga inviato qualsiasi contenuto. Quando hai effettuato l'accesso ad Anthropic su una connessione first-party, la segnalazione va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive la segnalazione in un [archivio locale in `~/.claude/feedback-bundles/`](https://code.claude.com/docs/it/data-usage#telemetry-services) che inoltri tu stesso. Nell'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successiva. Quando lo esegui mentre Claude sta rispondendo, Claude Code apre immediatamente la finestra di dialogo. Prima della v2.1.232, Claude Code metteva il comando in coda fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |65| `/bug [report]` | Segnala un bug o condivide la tua conversazione. Scegli quanta cronologia della sessione includere e confermi in una schermata di consenso prima che venga inviato qualsiasi contenuto. Quando hai effettuato l'accesso ad Anthropic su una connessione first-party, la segnalazione va ad Anthropic; su un provider di terze parti, o senza credenziali Anthropic, Claude Code scrive la segnalazione in un [archivio locale in `~/.claude/feedback-bundles/`](https://code.claude.com/docs/it/data-usage#telemetry-services) che inoltri tu stesso. Nell'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md#use-the-prompt-box), `/bug` apre invece la finestra di dialogo di feedback dell'estensione; richiede Claude Code v2.1.229 o successiva. Quando lo esegui mentre Claude sta rispondendo, Claude Code apre immediatamente la finestra di dialogo. Prima della v2.1.232, Claude Code metteva il comando in coda fino al termine del turno. Alias: `/share`. Prima della v2.1.212, `/bug` e `/share` erano alias di `/feedback` |

335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta su `1` per scrivere l'output del terminale tramite un secondo descrittore di file non bloccante, così che un terminale che smette di leggere, come un riquadro tmux in control mode messo in pausa o una connessione SSH bloccata, non possa bloccare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successiva |335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta su `1` per scrivere l'output del terminale tramite un secondo descrittore di file non bloccante, così che un terminale che smette di leggere, come un riquadro tmux in control mode messo in pausa o una connessione SSH bloccata, non possa bloccare Claude Code a metà sessione. Si applica su macOS, Linux e WSL quando stdout è un terminale. Richiede Claude Code v2.1.261 o successiva |

336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code invia di nuovo una [richiesta non in streaming](https://code.claude.com/docs/it/errors.md#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Con `0`, la richiesta non riesce al primo timeout. Consulta [Regolare il comportamento dei nuovi tentativi](https://code.claude.com/docs/it/errors.md#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code invia di nuovo una [richiesta non in streaming](https://code.claude.com/docs/it/errors.md#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Con `0`, la richiesta non riesce al primo timeout. Consulta [Regolare il comportamento dei nuovi tentativi](https://code.claude.com/docs/it/errors.md#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |

337| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per abilitare il [rendering a schermo intero](https://code.claude.com/docs/it/fullscreen.md), un'anteprima di ricerca che riduce lo sfarfallio e mantiene stabile l'uso della memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](https://code.claude.com/docs/it/settings-reference#tui); puoi anche passare a questa modalità con `/tui fullscreen` |337| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per abilitare il [rendering a schermo intero](https://code.claude.com/docs/it/fullscreen.md), un'anteprima di ricerca che riduce lo sfarfallio e mantiene stabile l'uso della memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](https://code.claude.com/docs/it/settings-reference#tui); puoi anche passare a questa modalità con `/tui fullscreen` |

338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione Claude.ai. Quando è impostata, `claude auth login` scambia direttamente questo token invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati |338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione claude.ai. Quando è impostata, `claude auth login` scambia direttamente questo token anziché aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati. Ignorata nelle [impostazioni di progetto e locali](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env) |

339| `CLAUDE_CODE_OAUTH_SCOPES` | Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando è impostata `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |339| `CLAUDE_CODE_OAUTH_SCOPES` | Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostata. Ignorata nelle [impostazioni di progetto e locali](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env) |

340| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione claude.ai. Alternativa a `/login` per l'SDK e gli ambienti automatizzati. Ha la precedenza sulle credenziali memorizzate nel portachiavi. Generane uno con [`claude setup-token`](https://code.claude.com/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](https://code.claude.com/docs/it/authentication#authentication-precedence), Claude Code usa il token che hai impostato per l'intera sessione. Per sostituire un token scaduto, generane uno nuovo e riavvia |340| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione claude.ai. Alternativa a `/login` per l'SDK e gli ambienti automatizzati. Ignorata nelle [impostazioni di progetto e locali](https://code.claude.com/docs/it/settings-reference.md#variables-claude-code-ignores-in-env). Ha la precedenza sulle credenziali memorizzate nel portachiavi. Generane uno con [`claude setup-token`](https://code.claude.com/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](https://code.claude.com/docs/it/authentication#authentication-precedence), Claude Code usa il token impostato per l'intera sessione. Per sostituire un token scaduto, generane uno nuovo e riavvia |

341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimossa nella v2.1.160 e ora non ha alcun effetto. In precedenza fissava la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) su Claude Opus 4.6 invece del valore predefinito corrente. Opus 4.6 non supporta più la modalità veloce |341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Rimossa nella v2.1.160 e ora non ha alcun effetto. In precedenza fissava la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) su Claude Opus 4.6 invece del valore predefinito corrente. Opus 4.6 non supporta più la modalità veloce |

342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che contengono contenuti (risposte del modello, contenuti degli strumenti, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, ovvero 60 KB). Aumentala solo se il tuo backend di telemetria accetta valori di attributo superiori a 64 KB, oppure riducila per diminuire il volume della telemetria. Richiede Claude Code v2.1.214 o successiva. Consulta [Monitoraggio](https://code.claude.com/docs/it/monitoring-usage.md) |342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | Lunghezza massima degli attributi OpenTelemetry che contengono contenuti (risposte del modello, contenuti degli strumenti, prompt di sistema, corpi API grezzi), marcatore di troncamento incluso, in unità di codice UTF-16 (predefinito: 61440, ovvero 60 KB). Aumentala solo se il tuo backend di telemetria accetta valori di attributo superiori a 64 KB, oppure riducila per diminuire il volume della telemetria. Richiede Claude Code v2.1.214 o successiva. Consulta [Monitoraggio](https://code.claude.com/docs/it/monitoring-usage.md) |

343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Imposta su `1` per scrivere su stderr gli errori diagnostici dell'exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato male, ad esempio per una collisione di porta di Prometheus, altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successiva. Consulta [Monitoraggio](https://code.claude.com/docs/it/monitoring-usage.md) |343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Imposta su `1` per scrivere su stderr gli errori diagnostici dell'exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato male, ad esempio per una collisione di porta di Prometheus, altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successiva. Consulta [Monitoraggio](https://code.claude.com/docs/it/monitoring-usage.md) |

66| `This organization has been disabled` | [Autenticazione](#this-organization-has-been-disabled) |66| `This organization has been disabled` | [Autenticazione](#this-organization-has-been-disabled) |

67| `Your organization has disabled API key authentication` | [Autenticazione](#your-organization-has-disabled-api-key-authentication) |67| `Your organization has disabled API key authentication` | [Autenticazione](#your-organization-has-disabled-api-key-authentication) |

68| `Your organization has disabled Claude subscription access` | [Autenticazione](#your-organization-has-disabled-claude-subscription-access) |68| `Your organization has disabled Claude subscription access` | [Autenticazione](#your-organization-has-disabled-claude-subscription-access) |

69| `Routines are disabled by your organization's policy` | [Autenticazione](#routines-are-disabled-by-your-organizations-policy) |69| `Scheduled tasks are off for your organization` | [Autenticazione](#routines-are-disabled-by-your-organizations-policy) |

70| `Routines are off for your organization` | [Autenticazione](#routines-are-disabled-by-your-organizations-policy) |

70| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticazione](#remote-control-requires-the-anthropic-api) |71| `Remote Control is only available when using Claude via api.anthropic.com` | [Autenticazione](#remote-control-requires-the-anthropic-api) |

71| `OAuth token refresh failed — run /login to re-authenticate` | [Autenticazione](#remote-control-couldnt-refresh-your-login) |72| `OAuth token refresh failed — run /login to re-authenticate` | [Autenticazione](#remote-control-couldnt-refresh-your-login) |

72| `JWT refresh failed: no OAuth token — run /login` | [Autenticazione](#remote-control-couldnt-refresh-your-login) |73| `JWT refresh failed: no OAuth token — run /login` | [Autenticazione](#remote-control-couldnt-refresh-your-login) |

755Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.756Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

756```757```

757 758 

759Alcuni rifiuti non vengono conteggiati nei dieci, incluso [un rifiuto dovuto alla modifica di un hook o di un mod](#hook-changed-input-after-review).

760 

758Il messaggio di interruzione appare in un punto diverso a seconda del tipo di sessione:761Il messaggio di interruzione appare in un punto diverso a seconda del tipo di sessione:

759 762 

760* In una sessione interattiva, il messaggio appare come avviso nella trascrizione e il turno termina763* In una sessione interattiva, il messaggio appare come avviso nella trascrizione e il turno termina

774 777 

775Prima della v2.1.302, su una connessione diretta ad Anthropic API, Claude Code non compattava una conversazione diventata troppo lunga per il controllo del server.778Prima della v2.1.302, su una connessione diretta ad Anthropic API, Claude Code non compattava una conversazione diventata troppo lunga per il controllo del server.

776 779 

780#### `a hook changed this call's input after auto mode reviewed it`

781 

782Questo rifiuto significa che un hook o un mod [ha modificato l'input della chiamata](https://code.claude.com/docs/it/hooks.md#pretooluse-updatedinput-in-auto-mode) dopo che il server l'ha revisionata, quindi la revisione non copre ciò che verrebbe eseguito. Non si tratta di un giudizio sulla pericolosità dell'azione.

783 

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

785 

786```text theme={null}

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

788```

789 

790Claude 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:

791 

792* **Interrompi la modifica**: disattiva l'[hook](https://code.claude.com/docs/it/hooks.md#disable-or-remove-hooks) o il [mod](https://code.claude.com/docs/it/plugins/mods/overview.md#turn-mods-on-or-off) che ha modificato la chiamata o una chiamata precedente nella stessa risposta di Claude, oppure chiedi al tuo amministratore di disattivarlo. Per cercare un hook, esegui [`/hooks`](https://code.claude.com/docs/it/hooks#the-%2Fhooks-menu) al prompt di Claude Code. In una sessione del terminale, esegui `/plugin` per vedere i mod attivi.

793* **Approva tu stesso la chiamata**: [passa alla modalità Manual](https://code.claude.com/docs/it/permission-modes.md#switch-permission-modes)

794 

777### Was not reviewed and did not run795### Was not reviewed and did not run

778 796 

779Un rifiuto `was not reviewed and did not run` significa che la conversazione è troppo lunga perché il classificatore della [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) possa controllare l'azione, quindi l'azione non è stata eseguita. Claude Code restituisce questo messaggio a Claude:797Un rifiuto `was not reviewed and did not run` significa che la conversazione è troppo lunga perché il classificatore della [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) possa controllare l'azione, quindi l'azione non è stata eseguita. Claude Code restituisce questo messaggio a Claude:

1188* Autenticati con una chiave API della Console invece che con il tuo abbonamento. Consulta [Autenticazione con Claude Console](https://code.claude.com/docs/it/authentication.md#claude-console-authentication) per la configurazione.1206* Autenticati con una chiave API della Console invece che con il tuo abbonamento. Consulta [Autenticazione con Claude Console](https://code.claude.com/docs/it/authentication.md#claude-console-authentication) per la configurazione.

1189* Se sei l'amministratore e non vedi un'opzione per abilitare l'accesso, contatta l'[assistenza Anthropic](https://support.claude.com)1207* Se sei l'amministratore e non vedi un'opzione per abilitare l'accesso, contatta l'[assistenza Anthropic](https://support.claude.com)

1190 1208 

1191### Routines are disabled by your organization's policy1209### Scheduled tasks are off for your organization

1192 1210 

1193Un Owner della tua organizzazione Team o Enterprise ha disattivato a livello di organizzazione le [attività pianificate nel cloud](https://code.claude.com/docs/it/routines.md), in precedenza chiamate routine. L'errore appare quando provi a crearne o eseguirne una, ad esempio su [claude.ai/code/routines](https://claude.ai/code/routines). In Claude Code v2.1.227 o successiva, la stessa impostazione [nasconde anche `/schedule`](https://code.claude.com/docs/it/routines#troubleshooting) nella CLI.1211Le [attività pianificate cloud](https://code.claude.com/docs/it/routines.md) sono disattivate per la tua organizzazione, quindi non puoi crearle né eseguirle. Il messaggio di claude.ai le chiama attività pianificate o routine, ed è seguito da una frase che riguarda il tuo amministratore:

1194 1212 

1195```text theme={null}1213```text theme={null}

1196Routines are disabled by your organization's policy.1214Scheduled tasks are off for your organization. …

1215Routines are off for your organization. …

1197```1216```

1198 1217 

1199Si tratta di un'impostazione lato server, quindi non può essere sovrascritta da impostazioni locali, variabili d'ambiente o flag della CLI.1218Non puoi attivarle con impostazioni locali, variabili d'ambiente o flag della CLI.

1200 1219 

1201**Cosa fare:**1220**Cosa fare:**

1202 1221 

1203* Chiedi a un Owner della tua organizzazione di attivare l'interruttore **Scheduled tasks (Was Routines)** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)1222* Chiedi al tuo Owner Team o Enterprise se può attivare l'interruttore denominato **Scheduled tasks (Was Routines)** o **Routines** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities)

1204 1223 

1205### Remote Control richiede l'API Anthropic1224### Remote Control richiede l'API Anthropic

1206 1225 

197* **Se accetti**: Claude Code scrive il nuovo ID modello nel tuo [file di impostazioni utente](https://code.claude.com/docs/it/settings.md) e si riavvia197* **Se accetti**: Claude Code scrive il nuovo ID modello nel tuo [file di impostazioni utente](https://code.claude.com/docs/it/settings.md) e si riavvia

198* **Se rifiuti**: Claude Code ricorda la tua scelta fino al prossimo cambio di versione predefinita198* **Se rifiuti**: Claude Code ricorda la tua scelta fino al prossimo cambio di versione predefinita

199 199 

200Per un fissaggio nel blocco `env` delle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md), Claude Code non esegue alcun controllo e non mostra alcuna richiesta di conferma.200Per un fissaggio nel blocco `env` delle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md), Claude Code non esegue alcun controllo e non mostra alcuna richiesta di conferma. Se la richiesta di aggiornamento compare ancora per questo fissaggio, aggiorna Claude Code alla v2.1.314 o successiva. Prima della v2.1.314, il fissaggio gestito restava in vigore dopo che avevi accettato, quindi la richiesta ricompariva all'avvio successivo.

201 201 

202Se non hai fissato un modello e il valore predefinito corrente non è disponibile nel tuo progetto, Claude Code ritorna alla versione precedente per la sessione corrente e mostra un avviso. Prova le versioni precedenti del modello predefinito per primo e, quando il valore predefinito è un modello Opus e nessuna versione Opus è disponibile, ritorna al modello Sonnet predefinito. Il ritorno non è persistente. Abilita il modello più recente in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) o [fissa una versione](#5-pin-model-versions) per rendere la scelta permanente.202Se non hai fissato un modello e il valore predefinito corrente non è disponibile nel tuo progetto, Claude Code ritorna alla versione precedente per la sessione corrente e mostra un avviso. Prova le versioni precedenti del modello predefinito per primo e, quando il valore predefinito è un modello Opus e nessuna versione Opus è disponibile, ritorna al modello Sonnet predefinito. Il ritorno non è persistente. Abilita il modello più recente in [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) o [fissa una versione](#5-pin-model-versions) per rendere la scelta permanente.

203 203 

204### Avviare una sessione su un modello specifico

205 

204Quando avvii la sessione su una versione specifica di Sonnet oppure Opus, ad esempio con `--model`, `ANTHROPIC_MODEL`, o l'[impostazione `model`](https://code.claude.com/docs/it/settings-reference#model), quella versione agisce come valore predefinito fissato della sessione per l'alias `sonnet` oppure `opus` corrispondente. Claude Code salta il controllo di disponibilità per il valore predefinito integrato che il tuo modello sostituisce e si avvia sul modello che hai configurato, senza alcun avviso di fallback.206Quando avvii la sessione su una versione specifica di Sonnet oppure Opus, ad esempio con `--model`, `ANTHROPIC_MODEL`, o l'[impostazione `model`](https://code.claude.com/docs/it/settings-reference#model), quella versione agisce come valore predefinito fissato della sessione per l'alias `sonnet` oppure `opus` corrispondente. Claude Code salta il controllo di disponibilità per il valore predefinito integrato che il tuo modello sostituisce e si avvia sul modello che hai configurato, senza alcun avviso di fallback.

205 207 

206Gli alias dei modelli come `opus` non agiscono come fissaggi, e nemmeno un ID modello che Claude Code non riconosce.208Quando avvii una sessione su un alias di modello come `opus` o su un ID modello che Claude Code non riconosce, quel valore non agisce come fissaggio.

209 

210### Rifiuti dei modelli ricordati

207 211 

208Quando questi controlli trovano un modello che il tuo progetto non può invocare, Claude Code ricorda il rifiuto su questa macchina per un massimo di un giorno, e durante quel tempo i lanci saltano il modello ricordato senza chiedere di nuovo ad Agent Platform. Claude Code controlla un rifiuto ricordato di un modello predefinito corrente di nuovo al lancio una volta che sono passati dieci minuti dall'ultimo controllo, quindi un valore predefinito che il tuo amministratore riabilita ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/it/env-vars).212Quando i controlli del modello all'avvio trovano un modello che il tuo progetto non può invocare, Claude Code può ricordare il rifiuto su questa macchina per un massimo di un giorno. Una volta trascorsi dieci minuti dall'ultimo controllo, Claude Code controlla di nuovo al lancio un rifiuto ricordato di un modello predefinito corrente. Un valore predefinito che il tuo amministratore riabilita quindi ritorna. Per disattivare la memoria, imposta [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/it/env-vars).

209 213 

210### Quando la tua organizzazione applica un'allowlist dei modelli214### Quando la tua organizzazione applica un'allowlist dei modelli

211 215 

901 901 

902#### Bloccare l'azione quando un hook fallisce902#### Bloccare l'azione quando un hook fallisce

903 903 

904Sulla maggior parte degli eventi, quando un hook fallisce o va in timeout, Claude Code esegue comunque l'azione. Un hook di policy con un percorso sbagliato o uno script che si arresta in modo anomalo lascia quindi passare tutto. Per bloccare invece l'azione, imposta `"onFailure": "block"` su un hook `command` o `http`. Richiede Claude Code v2.1.295 o successivo.904Sulla maggior parte degli eventi, quando un hook fallisce o va in timeout, Claude Code esegue comunque l'azione. Un hook di policy con un percorso sbagliato o uno script che si arresta in modo anomalo lascia quindi passare tutto. Per bloccare invece l'azione, imposta `"onFailure": "block"` su un hook `command` o `http`. Richiede Claude Code v2.1.295 o successivo. Per gli hook di callback dell'Agent SDK, consulta [Bloccare l'azione quando un callback fallisce](https://code.claude.com/docs/it/agent-sdk/hooks.md#block-the-action-when-a-callback-fails).

905 905 

906> [!NOTE]906> [!NOTE]

907>907>

1960| :- | :- |1960| :- | :- |

1961| `permissionDecision` | `"allow"` salta la richiesta di permesso, tranne che per le [azioni che nessuna modalità approva automaticamente](https://code.claude.com/docs/it/permission-modes.md#actions-no-mode-auto-approves) e le [letture da percorsi di rete](https://code.claude.com/docs/it/permissions.md#network-paths). Non salta nemmeno l'approvazione per le chiamate agli [strumenti che un'app dell'Agent SDK contrassegna come `always_ask`](https://code.claude.com/docs/it/agent-sdk/custom-tools#require-approval-for-specific-tools), a meno che la [modalità di permesso non approvi la chiamata](https://code.claude.com/docs/it/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` ed `ExitPlanMode` richiedono [`updatedInput` abbinato a `"allow"`](#allow-with-updatedinput). Per il plan mode, consulta [Approvazioni degli hook nel plan mode](https://code.claude.com/docs/it/permissions.md#hook-approvals-in-plan-mode). `"deny"` impedisce la chiamata allo strumento. `"ask"` chiede all'utente di confermare. `"defer"` termina il turno in modo che lo strumento possa essere ripreso in seguito e richiede la [modalità non interattiva](#defer-a-tool-call-for-later) con il flag `-p`. Le [regole di negazione e di richiesta di conferma](https://code.claude.com/docs/it/permissions.md#manage-permissions) vengono comunque valutate indipendentemente da ciò che l'hook restituisce |1961| `permissionDecision` | `"allow"` salta la richiesta di permesso, tranne che per le [azioni che nessuna modalità approva automaticamente](https://code.claude.com/docs/it/permission-modes.md#actions-no-mode-auto-approves) e le [letture da percorsi di rete](https://code.claude.com/docs/it/permissions.md#network-paths). Non salta nemmeno l'approvazione per le chiamate agli [strumenti che un'app dell'Agent SDK contrassegna come `always_ask`](https://code.claude.com/docs/it/agent-sdk/custom-tools#require-approval-for-specific-tools), a meno che la [modalità di permesso non approvi la chiamata](https://code.claude.com/docs/it/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call). `AskUserQuestion` ed `ExitPlanMode` richiedono [`updatedInput` abbinato a `"allow"`](#allow-with-updatedinput). Per il plan mode, consulta [Approvazioni degli hook nel plan mode](https://code.claude.com/docs/it/permissions.md#hook-approvals-in-plan-mode). `"deny"` impedisce la chiamata allo strumento. `"ask"` chiede all'utente di confermare. `"defer"` termina il turno in modo che lo strumento possa essere ripreso in seguito e richiede la [modalità non interattiva](#defer-a-tool-call-for-later) con il flag `-p`. Le [regole di negazione e di richiesta di conferma](https://code.claude.com/docs/it/permissions.md#manage-permissions) vengono comunque valutate indipendentemente da ciò che l'hook restituisce |

1962| `permissionDecisionReason` | Per `"ask"`, mostrato all'utente nella richiesta di permesso. Quando Claude Code [nega la chiamata](https://code.claude.com/docs/it/headless.md#turn-off-permission-prompts-in-unattended-runs) in un'esecuzione `-p` in cui nessuno può rispondere a quella richiesta, Claude legge invece il motivo nel risultato dello strumento. Per `"deny"`, mostrato a Claude. Per `"allow"` e `"defer"`, scritto solo nel [log di debug](#debug-hooks) |1962| `permissionDecisionReason` | Per `"ask"`, mostrato all'utente nella richiesta di permesso. Quando Claude Code [nega la chiamata](https://code.claude.com/docs/it/headless.md#turn-off-permission-prompts-in-unattended-runs) in un'esecuzione `-p` in cui nessuno può rispondere a quella richiesta, Claude legge invece il motivo nel risultato dello strumento. Per `"deny"`, mostrato a Claude. Per `"allow"` e `"defer"`, scritto solo nel [log di debug](#debug-hooks) |

1963| `updatedInput` | Modifica i parametri di input dello strumento prima dell'esecuzione. Sostituisce l'intero oggetto di input, quindi includi i campi non modificati insieme a quelli modificati. Claude Code valuta le regole di permesso e l'[idoneità al passaggio automatico in background](https://code.claude.com/docs/it/tools-reference.md#foreground-commands-that-move-to-the-background) di un comando Bash sull'input restituito dal tuo hook, non sull'input inviato da Claude. Combinalo con `"allow"` per approvare automaticamente, oppure con `"ask"` per mostrare all'utente l'input modificato. Per `"defer"`, ignorato |1963| `updatedInput` | Modifica i parametri di input dello strumento prima dell'esecuzione. Sostituisce l'intero oggetto di input, quindi includi i campi invariati insieme a quelli modificati. Claude Code valuta le regole di permesso e l'[idoneità al passaggio automatico in background](https://code.claude.com/docs/it/tools-reference.md#foreground-commands-that-move-to-the-background) di un comando Bash in base all'input restituito dal tuo hook, non all'input inviato da Claude. Combinalo con `"allow"` per approvare automaticamente, oppure con `"ask"` per mostrare all'utente l'input modificato. Per `"defer"`, viene ignorato. Senza `permissionDecision`, [la modalità auto può negare la chiamata modificata](#pretooluse-updatedinput-in-auto-mode) |

1964| `additionalContext` | Stringa aggiunta al contesto di Claude insieme al risultato dello strumento. Ignorata quando `permissionDecision` è `"defer"`. Consulta [Aggiungere contesto per Claude](#add-context-for-claude) |1964| `additionalContext` | Stringa aggiunta al contesto di Claude insieme al risultato dello strumento. Ignorata quando `permissionDecision` è `"defer"`. Consulta [Aggiungere contesto per Claude](#add-context-for-claude) |

1965 1965 

1966Quando più hook PreToolUse restituiscono decisioni diverse, l'ordine di precedenza è `deny` > `defer` > `ask` > `allow`.1966Quando più hook PreToolUse restituiscono decisioni diverse, l'ordine di precedenza è `deny` > `defer` > `ask` > `allow`.

1987>1987>

1988> In precedenza PreToolUse usava i campi di primo livello `decision` e `reason`, ma questi sono deprecati per questo evento. Usa invece `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. I valori deprecati `"approve"` e `"block"` corrispondono rispettivamente a `"allow"` e `"deny"`. Altri eventi come PostToolUse e Stop continuano a usare `decision` e `reason` di primo livello come formato attuale.1988> In precedenza PreToolUse usava i campi di primo livello `decision` e `reason`, ma questi sono deprecati per questo evento. Usa invece `hookSpecificOutput.permissionDecision` e `hookSpecificOutput.permissionDecisionReason`. I valori deprecati `"approve"` e `"block"` corrispondono rispettivamente a `"allow"` e `"deny"`. Altri eventi come PostToolUse e Stop continuano a usare `decision` e `reason` di primo livello come formato attuale.

1989 1989 

1990#### `updatedInput` di PreToolUse in modalità auto

1991 

1992Quando il tuo hook restituisce `updatedInput` senza `permissionDecision` in [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), Claude Code può negare la chiamata modificata. [Il server ha esaminato](https://code.claude.com/docs/it/permission-modes.md#server-side-classifier-review) l'input scritto da Claude, non l'input restituito dal tuo hook. Nelle sessioni interattive del terminale e nelle sessioni VS Code con una connessione diretta all'API di Anthropic, la negazione include questo testo:

1993 

1994```text theme={null}

1995a hook changed this call's input after auto mode reviewed it

1996```

1997 

1998Dopo una negazione con questo testo, Claude può emettere di nuovo la chiamata modificata in modo che il server la esamini. Se Claude ripete esattamente l'input modificato nella sua risposta successiva, il tuo hook viene comunque eseguito:

1999 

2000* Può negare la chiamata o inviarla alla richiesta di permesso

2001* Qualsiasi `updatedInput` che restituisce viene scartato, quindi ciò che viene eseguito è ciò che il server ha esaminato

2002 

2003Non è necessario modificare il tuo hook per questa negazione, a meno che [Claude non ti dica nella sua risposta che la modalità auto non ha potuto verificare la chiamata](https://code.claude.com/docs/it/errors.md#hook-changed-input-after-review).

2004 

2005Nelle sessioni che mostrano questo testo, un [hook `command`](#command-hook-fields) nelle impostazioni o nel file degli hook di un plugin può modificare le chiamate Bash, PowerShell, Monitor, Edit, Write e NotebookEdit senza questa negazione. La negazione può comunque comparire, ad esempio quando un hook qualsiasi ha modificato una chiamata precedente nella stessa risposta di Claude o quando un comando Bash chiede di essere eseguito fuori dalla sandbox.

2006 

1990#### Decisioni `ask` di PreToolUse in modalità auto2007#### Decisioni `ask` di PreToolUse in modalità auto

1991 2008 

1992In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), l'`"ask"` di un hook PreToolUse normalmente invia la chiamata allo strumento alla richiesta di permesso, e il [classificatore](https://code.claude.com/docs/it/permission-modes.md#how-the-classifier-evaluates-actions) non la decide. Alcune chiamate seguono un percorso diverso:2009In [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), l'`"ask"` di un hook PreToolUse normalmente invia la chiamata allo strumento alla richiesta di permesso, e il [classificatore](https://code.claude.com/docs/it/permission-modes.md#how-the-classifier-evaluates-actions) non la decide. Alcune chiamate seguono un percorso diverso:

287 287 

288### Ricerca inversa con Ctrl+R288### Ricerca inversa con Ctrl+R

289 289 

290Premi `Ctrl+R` per cercare in modo interattivo nella cronologia dei comandi. Nel [rendering a schermo intero](https://code.claude.com/docs/it/fullscreen.md), `Ctrl+R` apre invece una finestra di dialogo di ricerca: digita per filtrare, premi `Up` e `Down` per spostarti tra le corrispondenze e premi `Ctrl+S` per far scorrere l'ambito tra questa sessione, questo progetto e tutti i progetti. Premi `Enter` o `Tab` per inserire una corrispondenza nell'input del prompt, oppure `Esc` per annullare. I passaggi seguenti descrivono la ricerca inline del renderer classico:290Premi `Ctrl+R` per cercare in modo interattivo nella cronologia dei comandi. Nel [rendering a schermo intero](https://code.claude.com/docs/it/fullscreen.md), `Ctrl+R` apre invece una finestra di dialogo di ricerca. Digita per filtrare nella finestra di dialogo e premi `Up` e `Down` per spostarti nell'elenco delle corrispondenze, con un riquadro di anteprima che mostra l'inizio della corrispondenza evidenziata.

291 

292Nella finestra di dialogo, premi `Ctrl+S` per far scorrere l'ambito tra questa sessione, questo progetto e tutti i progetti. Premi `Enter` o `Tab` per inserire una corrispondenza nell'input del prompt, oppure `Esc` per annullare. I passaggi seguenti descrivono la ricerca inline del renderer classico:

291 293 

2921. **Avvia la ricerca**: premi `Ctrl+R` per attivare la ricerca inversa nella cronologia2941. **Avvia la ricerca**: premi `Ctrl+R` per attivare la ricerca inversa nella cronologia

2932. **Digita la query**: inserisci il testo da cercare nei comandi precedenti. Il termine di ricerca viene evidenziato nei risultati corrispondenti2952. **Digita la query**: inserisci il testo da cercare nei comandi precedenti. La corrispondenza corrente compare nell'input del prompt.

2943. **Naviga tra le corrispondenze**: premi di nuovo `Ctrl+R` per scorrere le corrispondenze più vecchie2963. **Naviga tra le corrispondenze**: premi di nuovo `Ctrl+R` per scorrere le corrispondenze più vecchie

2954. **Ambito della ricerca**: la ricerca inline cerca sempre i prompt di tutti i progetti2974. **Ambito della ricerca**: la ricerca inline cerca sempre i prompt di tutti i progetti

2965. **Accetta la corrispondenza**:2985. **Accetta la corrispondenza**:

300 * Premi `Ctrl+C` per annullare e ripristinare l'input originale302 * Premi `Ctrl+C` per annullare e ripristinare l'input originale

301 * Premi `Backspace` con la ricerca vuota per annullare303 * Premi `Backspace` con la ricerca vuota per annullare

302 304 

303La ricerca inline analizza l'intera cronologia dei prompt, dal più recente, con i duplicati ridotti all'occorrenza più recente. La finestra di dialogo a schermo intero cerca nell'intera cronologia dei prompt nell'ambito selezionato, dal più recente, con i duplicati ridotti all'occorrenza più recente: i prompt più recenti compaiono immediatamente e le corrispondenze dei prompt più vecchi si aggiungono man mano che Claude Code carica il resto. I prompt corrispondenti vengono visualizzati con il termine di ricerca evidenziato, così puoi trovare e riutilizzare gli input precedenti.

304 

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

306 306 

307## Comandi Bash in background307## Comandi Bash in background

39 39 

40Installa il [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) dal Marketplace di JetBrains e riavvia il tuo IDE.40Installa il [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) dal Marketplace di JetBrains e riavvia il tuo IDE.

41 41 

42> [!NOTE]

43>

44> Il Marketplace di JetBrains è un software di terze parti che Anthropic non approva, non gestisce e non verifica. Anthropic sottopone il plugin Claude Code per la pubblicazione sul Marketplace di JetBrains.

45 

42Se `claude` è installato in un percorso che il tuo IDE non riesce a trovare, imposta il percorso completo nell'impostazione [Claude command](#general-settings) del plugin.46Se `claude` è installato in un percorso che il tuo IDE non riesce a trovare, imposta il percorso completo nell'impostazione [Claude command](#general-settings) del plugin.

43 47 

44Claude Code funziona con qualsiasi abbonamento Claude a pagamento (Pro, Max, Ultra, Team o Enterprise) o un account Claude Console, e non è richiesta alcuna chiave API. Ti verrà chiesto di [accedere](https://code.claude.com/docs/it/authentication.md#log-in-to-claude-code) la prima volta che esegui `claude`.48Claude Code funziona con qualsiasi abbonamento Claude a pagamento (Pro, Max, Ultra, Team o Enterprise) o un account Claude Console, e non è richiesta alcuna chiave API. Ti verrà chiesto di [accedere](https://code.claude.com/docs/it/authentication.md#log-in-to-claude-code) la prima volta che esegui `claude`.

278 278 

279Sulla v2.1.305 o successiva, Claude Code invia di nuovo una richiesta senza [campi `defer_loading` e blocchi `tool_reference`](https://code.claude.com/docs/it/mcp#tool-search-through-a-gateway) dopo un `400` o `422` che nomina la ricerca degli strumenti o la cui causa non riconosce. Dopo un nuovo tentativo riuscito, anche le richieste successive in quella conversazione li omettono.279Sulla v2.1.305 o successiva, Claude Code invia di nuovo una richiesta senza [campi `defer_loading` e blocchi `tool_reference`](https://code.claude.com/docs/it/mcp#tool-search-through-a-gateway) dopo un `400` o `422` che nomina la ricerca degli strumenti o la cui causa non riconosce. Dopo un nuovo tentativo riuscito, anche le richieste successive in quella conversazione li omettono.

280 280 

281Le richieste dello sviluppatore continuano a funzionare senza alcuna modifica al gateway, con i loro strumenti MCP caricati subito. Quando Claude Code prova di nuovo la ricerca degli strumenti, il gateway vede un'altra richiesta rifiutata seguita dal relativo nuovo tentativo. Per la ricerca degli strumenti in sé, Claude Code si aspetta che il gateway inoltri i campi `defer_loading` e i blocchi `tool_reference` con il loro valore `anthropic-beta`.281Le richieste dello sviluppatore continuano a funzionare senza alcuna modifica sul gateway, con i loro strumenti MCP caricati in anticipo. Quando Claude Code riprova la ricerca degli strumenti, il gateway può vedere un'altra richiesta rifiutata seguita dal suo nuovo tentativo. Per la ricerca degli strumenti in sé, Claude Code si aspetta che il gateway inoltri i campi `defer_loading` e i blocchi `tool_reference` con il relativo valore `anthropic-beta`.

282 282 

283### Disabilitare le capacità pre-release283### Disabilitare le capacità pre-release

284 284 

171* I percorsi binari sandbox `sandbox.bwrapPath` e `sandbox.socatPath`171* I percorsi binari sandbox `sandbox.bwrapPath` e `sandbox.socatPath`

172* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](https://code.claude.com/docs/it/settings-reference#sandbox-ripgrep)172* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](https://code.claude.com/docs/it/settings-reference#sandbox-ripgrep)

173* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`173* `sandbox.filesystem.disabled` e `sandbox.network.strictAllowlist`

174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiplugins), dove un `false` da qualsiasi fonte di amministrazione disattiva il comportamento. Un `false` nelle impostazioni utente o locali dello sviluppatore lo disattiva anche; ogni chiave può solo negare174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiplugins), dove un `false` da qualsiasi fonte di amministrazione disattiva il comportamento. Ogni chiave può solo negare:

175 * Un `false` nelle impostazioni utente o locali dello sviluppatore lo disattiva anche

176 * Per `useAutoModeDuringPlan`, un `false` in un file utente o locale che lo sviluppatore esclude con un'opzione come [`--setting-sources`](https://code.claude.com/docs/it/cli-reference#cli-flags) non conta. Ignorare un file escluso richiede Claude Code v2.1.314 o successivo

175* [`enableArtifact`](https://code.claude.com/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte di amministrazione disattiva lo [strumento Artifact](https://code.claude.com/docs/it/artifacts.md). Un `false` nelle impostazioni utente, progetto o locali dello sviluppatore lo disattiva anche, e nessuna fonte lo riattiva; vedi [quali valori di livello inferiore contano ancora](https://code.claude.com/docs/it/settings.md#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo177* [`enableArtifact`](https://code.claude.com/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte di amministrazione disattiva lo [strumento Artifact](https://code.claude.com/docs/it/artifacts.md). Un `false` nelle impostazioni utente, progetto o locali dello sviluppatore lo disattiva anche, e nessuna fonte lo riattiva; vedi [quali valori di livello inferiore contano ancora](https://code.claude.com/docs/it/settings.md#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo

176* [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel), dove il limite più basso in qualsiasi fonte di amministrazione si applica. Se uno sviluppatore imposta un limite più basso nelle proprie impostazioni o con `--settings`, Claude Code applica quello; nessuna fonte può aumentare il limite. Richiede Claude Code v2.1.267 o successivo178* [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel), dove il limite più basso in qualsiasi fonte di amministrazione si applica. Se uno sviluppatore imposta un limite più basso nelle proprie impostazioni o con `--settings`, Claude Code applica quello; nessuna fonte può aumentare il limite. Richiede Claude Code v2.1.267 o successivo

177* Un opt-out del trailer di commit in `attribution`, o nel deprecato `includeCoAuthoredBy`, da qualsiasi livello179* Un opt-out del trailer di commit in `attribution`, o nel deprecato `includeCoAuthoredBy`, da qualsiasi livello

6134. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](https://code.claude.com/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](https://code.claude.com/docs/it/settings-reference#modelsettings)6134. Le tue impostazioni: il livello che hai salvato per il modello o una chiave [`effortLevel`](https://code.claude.com/docs/it/settings-reference#effortlevel), con la precedenza tra loro e tra i file di impostazioni indicata in [`modelSettings`](https://code.claude.com/docs/it/settings-reference#modelsettings)

6145. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne Opus 5.5, Sonnet 5.5 e Haiku 5.5, il cui predefinito è `medium`, e Opus 4.7, il cui predefinito è `xhigh`. Se la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello.6145. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne Opus 5.5, Sonnet 5.5 e Haiku 5.5, il cui predefinito è `medium`, e Opus 4.7, il cui predefinito è `xhigh`. Se la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello.

615 615 

616Dopo un fallback automatico del modello, consulta [Livello di sforzo dopo un fallback](#effort-level-after-a-fallback) per il livello che si applica.616Dopo un fallback automatico del modello, consulta [Livello di sforzo dopo un fallback](#effort-level-after-a-fallback) per il livello che si applica. Per subagent e membri del team, consulta [Livello di sforzo di subagent e membri del team](#effort-level-of-subagents-and-teammates).

617 617 

618Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di primo livello nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` scriveva prima che Claude Code salvasse i livelli per modello: continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti, mentre Opus 5.5 e i modelli rilasciati dopo di esso iniziano al loro predefinito finché non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di primo livello nelle impostazioni di progetto, locali o gestite, o uno passato con `--settings`, si applica a ogni modello.618Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di primo livello nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` scriveva prima che Claude Code salvasse i livelli per modello: continua ad applicarsi dove si applicava prima, su Opus 5, Fable 5.1 e modelli precedenti, mentre Opus 5.5 e i modelli rilasciati dopo di esso iniziano al loro predefinito finché non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di primo livello nelle impostazioni di progetto, locali o gestite, o uno passato con `--settings`, si applica a ogni modello.

619 619 

700 700 

701Un [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) o un [limite di sforzo dell'organizzazione](#organization-effort-limits) limita comunque il livello a cui viene eseguito la skill o il subagent. Se imposti `effortLevel` nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md), Claude Code lo applica al passo delle impostazioni dell'[ordine di risoluzione dello sforzo](#adjust-effort-level), e gli utenti possono comunque modificare il livello con `/effort` o `--effort`. Per mantenere gli utenti a un livello o al di sotto di esso, imposta [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel).701Un [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) o un [limite di sforzo dell'organizzazione](#organization-effort-limits) limita comunque il livello a cui viene eseguito la skill o il subagent. Se imposti `effortLevel` nelle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md), Claude Code lo applica al passo delle impostazioni dell'[ordine di risoluzione dello sforzo](#adjust-effort-level), e gli utenti possono comunque modificare il livello con `/effort` o `--effort`. Per mantenere gli utenti a un livello o al di sotto di esso, imposta [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel).

702 702 

703#### Livello di sforzo di subagent e membri del team

704 

705Sul modello della conversazione principale, un [subagent](https://code.claude.com/docs/it/sub-agents.md#choose-an-effort-level) o un [membro del team](https://code.claude.com/docs/it/agent-teams.md#specify-teammates-and-models) senza un proprio `effort` viene eseguito al livello che scegli nella sessione o imposti con `--effort`. Su un altro modello, quel livello non si applica. Per scegliere il livello di un subagent, imposta `effort` nella sua definizione.

706 

703#### Verifica il livello di sforzo impostato707#### Verifica il livello di sforzo impostato

704 708 

705Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Un livello nell'intestazione della sessione, ad esempio "with low effort", deriva dalla tua impostazione dello sforzo, anche se Claude [sta ancora lavorando al livello precedente](#when-a-new-effort-level-starts). All'avvio e quando lo modifichi, il piè di pagina mostra anche brevemente il livello impostato per la tua sessione.709Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Un livello nell'intestazione della sessione, ad esempio "with low effort", deriva dalla tua impostazione dello sforzo, anche se Claude [sta ancora lavorando al livello precedente](#when-a-new-effort-level-starts). All'avvio e quando lo modifichi, il piè di pagina mostra anche brevemente il livello impostato per la tua sessione.

330 330 

331Nelle sessioni CLI interattive, il tracing beta dettagliato richiede anche che la tua organizzazione sia inserita nella lista di autorizzazione per la funzionalità. L'Agent SDK e le sessioni non interattive `-p` non richiedono l'inserimento nella lista di autorizzazione.331Nelle sessioni CLI interattive, il tracing beta dettagliato richiede anche che la tua organizzazione sia inserita nella lista di autorizzazione per la funzionalità. L'Agent SDK e le sessioni non interattive `-p` non richiedono l'inserimento nella lista di autorizzazione.

332 332 

333> [!WARNING]

334>

335> Imposta `ENABLE_BETA_TRACING_DETAILED` solo per il debug, non in produzione. Il tracing beta dettagliato ha un volume di esportazione elevato, e i suoi [attributi di contenuto](#new-context-gates) non fanno parte dello schema stabile degli span.

336 

333| Attributo | Descrizione | Controllato da |337| Attributo | Descrizione | Controllato da |

334| - | - | - |338| - | - | - |

335| `hook_event` | Tipo di evento dell'hook, come `PreToolUse` | |339| `hook_event` | Tipo di evento dell'hook, come `PreToolUse` | |

131 131 

132Claude Code annota ogni chiave ignorata nel log di debug della sessione.132Claude Code annota ogni chiave ignorata nel log di debug della sessione.

133 133 

134Nelle sessioni di [Claude Desktop](https://code.claude.com/docs/it/desktop.md) in cui l'app gestisce la connessione del provider, ad esempio la scheda Code su un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md) e le sessioni Cowork, Claude Code legge queste variabili e le variabili proxy `HTTP_PROXY`, `HTTPS_PROXY` e `NO_PROXY` solo dalle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) e da `~/.claude/settings.json`: le ignora nei file di impostazioni del repository, quindi un repository estratto non può reindirizzare il percorso TLS o proxy di una sessione le cui credenziali provengono dall'app. In una sessione della scheda Code locale, SSH o WSL acceduta tramite claude.ai, l'app non gestisce la connessione, e Claude Code legge queste variabili da ogni ambito di impostazioni, come qualsiasi sessione di terminale; le [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) seguono le regole della sessione cloud sopra ovunque le si avvii. Prima della v2.1.217, Claude Code ignorava queste variabili in ogni file di impostazioni quando l'app gestiva la connessione.134Nelle sessioni di [Claude Desktop](https://code.claude.com/docs/it/desktop.md) in cui l'app gestisce la connessione del provider, ad esempio la scheda Code su un [provider di terze parti](https://code.claude.com/docs/it/third-party-integrations.md) e le sessioni Cowork, Claude Code legge queste variabili, eccetto `CLAUDE_CODE_OAUTH_SCOPES`, e le variabili proxy `HTTP_PROXY`, `HTTPS_PROXY` e `NO_PROXY` solo dalle [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) e da `~/.claude/settings.json`. Le ignora nei file di impostazioni propri di un repository, quindi un repository estratto non può reindirizzare il percorso TLS o proxy di una sessione le cui credenziali provengono dall'app. Prima della v2.1.217, Claude Code ignorava queste variabili in ogni file di impostazioni quando l'app gestiva la connessione.

135 

136In una sessione della scheda Code locale, SSH o WSL in cui hai effettuato l'accesso tramite claude.ai, puoi impostare queste variabili e le variabili proxy in qualsiasi file di impostazioni, eccetto `CLAUDE_CODE_OAUTH_SCOPES`. Desktop imposta autonomamente `CLAUDE_CODE_OAUTH_SCOPES` nelle sessioni della scheda Code e nelle sessioni Cowork, quindi non puoi impostarla.

137 

138Quando l'ambiente di avvio della sessione imposta già una variabile, Claude Code [ignora il valore del file di impostazioni](https://code.claude.com/docs/it/settings-reference.md#how-env-values-interact-with-your-shell) e indica il nome della variabile nel [log di debug](https://code.claude.com/docs/it/debug-your-config.md). Per usare un tuo valore di proxy o di certificato in una sessione locale, [aggiungilo a un ambiente locale salvato](https://code.claude.com/docs/it/desktop.md#set-environment-variables-for-local-sessions). Le [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) seguono le regole delle sessioni cloud descritte sopra ovunque tu le avvii.

135 139 

136## Verificare la configurazione140## Verificare la configurazione

137 141 

383* **Il server non esamina la sessione**: una risposta si completa senza risultati di revisione, o il server risponde che non esamina questa sessione. Le cause più comuni sono un gateway LLM o proxy che elimina la richiesta di revisione o i risultati, e una piattaforma, regione o credenziale che non dispone ancora di controlli lato server. Claude Code ripiega sulle proprie richieste del classificatore. Una volta che questo fallback vale per il resto della sessione, mostra un [avviso sugli addebiti delle richieste del classificatore](https://code.claude.com/docs/it/auto-mode-classifier-billing.md) sugli account in cui queste richieste vengono fatturate.383* **Il server non esamina la sessione**: una risposta si completa senza risultati di revisione, o il server risponde che non esamina questa sessione. Le cause più comuni sono un gateway LLM o proxy che elimina la richiesta di revisione o i risultati, e una piattaforma, regione o credenziale che non dispone ancora di controlli lato server. Claude Code ripiega sulle proprie richieste del classificatore. Una volta che questo fallback vale per il resto della sessione, mostra un [avviso sugli addebiti delle richieste del classificatore](https://code.claude.com/docs/it/auto-mode-classifier-billing.md) sugli account in cui queste richieste vengono fatturate.

384* **Il server non dà un verdetto per un'azione**: Claude Code nega l'azione piuttosto che eseguirla senza revisione. Su qualsiasi connessione, questo accade quando la risposta termina prima che arrivino i risultati della revisione o quando i risultati arrivano in una forma che Claude Code non può leggere. Un gateway LLM o proxy che tronca le risposte o riscrive i risultati può causare entrambi i casi. Su una connessione diretta all'API Anthropic, accade anche quando il controllo del server non riesce per l'azione, ad esempio per timeout. [Il server non ha restituito un verdetto di sicurezza](https://code.claude.com/docs/it/errors.md#the-server-returned-no-safety-verdict) copre il messaggio di negazione, cosa succede quando le negazioni si ripetono, e cosa fare.384* **Il server non dà un verdetto per un'azione**: Claude Code nega l'azione piuttosto che eseguirla senza revisione. Su qualsiasi connessione, questo accade quando la risposta termina prima che arrivino i risultati della revisione o quando i risultati arrivano in una forma che Claude Code non può leggere. Un gateway LLM o proxy che tronca le risposte o riscrive i risultati può causare entrambi i casi. Su una connessione diretta all'API Anthropic, accade anche quando il controllo del server non riesce per l'azione, ad esempio per timeout. [Il server non ha restituito un verdetto di sicurezza](https://code.claude.com/docs/it/errors.md#the-server-returned-no-safety-verdict) copre il messaggio di negazione, cosa succede quando le negazioni si ripetono, e cosa fare.

385 385 

386 Se un [hook](https://code.claude.com/docs/it/hooks.md#pretooluse-updatedinput-in-auto-mode) o un [mod](https://code.claude.com/docs/it/plugins/mods/overview.md) modifica l'input di un'azione dopo la revisione del server, Claude Code può negare l'azione senza verdetto. Nelle sessioni di terminale interattivo e VS Code su una connessione diretta all'API Anthropic, il testo della negazione include `a hook changed this call's input after auto mode reviewed it`. [La relativa voce di errore](https://code.claude.com/docs/it/errors.md#hook-changed-input-after-review) spiega cosa fare.

387 

386Per evitare di chiedere al server e usare sempre le richieste del classificatore di Claude Code, imposta [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/it/env-vars). Su una connessione diretta all'API Anthropic, la variabile richiede Claude Code v2.1.281 o successivo. Impostarla su `1` in quel caso attiva la revisione del server in una sessione che non ce l'ha ancora, a meno che tu non abbia impostato anche `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se imposti `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e lasci `CLAUDE_CODE_AUTO_MODE_SERVER` non impostata, anche Claude Code smette di chiedere al server, tranne nei casi descritti in [Disabilita le funzionalità pre-rilascio](https://code.claude.com/docs/it/llm-gateway-protocol.md#disable-pre-release-capabilities).388Per evitare di chiedere al server e usare sempre le richieste del classificatore di Claude Code, imposta [`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/it/env-vars). Su una connessione diretta all'API Anthropic, la variabile richiede Claude Code v2.1.281 o successivo. Impostarla su `1` in quel caso attiva la revisione del server in una sessione che non ce l'ha ancora, a meno che tu non abbia impostato anche `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`. Se imposti `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` e lasci `CLAUDE_CODE_AUTO_MODE_SERVER` non impostata, anche Claude Code smette di chiedere al server, tranne nei casi descritti in [Disabilita le funzionalità pre-rilascio](https://code.claude.com/docs/it/llm-gateway-protocol.md#disable-pre-release-capabilities).

387 389 

388### Modello classificatore predefinito390### Modello classificatore predefinito

557* **Un'azione bloccata**: Claude Code mostra una notifica ed elenca l'azione in `/permissions` nella scheda **Recently blocked**, dove puoi [approvare l'azione in modo che Claude possa riprovare](https://code.claude.com/docs/it/auto-mode-config.md#review-denials).559* **Un'azione bloccata**: Claude Code mostra una notifica ed elenca l'azione in `/permissions` nella scheda **Recently blocked**, dove puoi [approvare l'azione in modo che Claude possa riprovare](https://code.claude.com/docs/it/auto-mode-config.md#review-denials).

558* **Blocchi ripetuti**: se il classificatore blocca un'azione 3 volte di seguito o 20 volte in totale, la modalità auto si mette in pausa e Claude Code riprende a chiedere conferma. Approvare l'azione richiesta riattiva la modalità auto. Vedi [Soglie di blocco ripetuto](#repeated-block-thresholds) per come vengono contati i blocchi.560* **Blocchi ripetuti**: se il classificatore blocca un'azione 3 volte di seguito o 20 volte in totale, la modalità auto si mette in pausa e Claude Code riprende a chiedere conferma. Approvare l'azione richiesta riattiva la modalità auto. Vedi [Soglie di blocco ripetuto](#repeated-block-thresholds) per come vengono contati i blocchi.

559* **Nessun verdetto dal classificatore**: quando un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore stesso, o la risposta del classificatore non può essere analizzata, Claude Code blocca l'azione senza la notifica o la voce **Recently blocked**. Vedi [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/it/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) per il messaggio mostrato in ciascun caso e cosa fare.561* **Nessun verdetto dal classificatore**: quando un controllo di sicurezza separato dalla modalità auto rifiuta la richiesta del classificatore stesso, o la risposta del classificatore non può essere analizzata, Claude Code blocca l'azione senza la notifica o la voce **Recently blocked**. Vedi [Auto mode cannot determine the safety of an action](https://code.claude.com/docs/it/errors.md#auto-mode-cannot-determine-the-safety-of-an-action) per il messaggio mostrato in ciascun caso e cosa fare.

560* **Nessun verdetto dal server**: con la [revisione del classificatore lato server](#server-side-classifier-review), Claude Code nega un'azione per cui il server non dà un verdetto, e interrompe il turno dopo dieci risposte di seguito senza verdetto. Vedi [Il server non ha restituito un verdetto di sicurezza](https://code.claude.com/docs/it/errors.md#the-server-returned-no-safety-verdict).562* **Nessun verdetto dal server**: con la [revisione del classificatore lato server](#server-side-classifier-review), Claude Code nega un'azione per cui il server non dà un verdetto, e può interrompere il turno dopo dieci risposte di seguito senza verdetto. Vedi [Il server non ha restituito un verdetto di sicurezza](https://code.claude.com/docs/it/errors.md#the-server-returned-no-safety-verdict).

561* **Un cambio di modalità durante un controllo**: se cambi modalità di permesso mentre un controllo del classificatore è in sospeso, Claude Code scarta un verdetto che la nuova modalità non avrebbe richiesto. Ti viene invece chiesta un'approvazione, oppure l'azione viene negata automaticamente in [modalità `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).563* **Un cambio di modalità durante un controllo**: se cambi modalità di permesso mentre un controllo del classificatore è in sospeso, Claude Code scarta un verdetto che la nuova modalità non avrebbe richiesto. Ti viene invece chiesta un'approvazione, oppure l'azione viene negata automaticamente in [modalità `dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode).

562 564 

563#### Soglie di blocco ripetuto565#### Soglie di blocco ripetuto

199 199 

200Il messaggio dice a Claude di effettuare la chiamata ancora una volta così come è stata registrata. Se anche quella viene negata, l'hook modifica l'input ogni volta, quindi disattiva il mod o l'hook, oppure esci dalla modalità auto e approva tu stesso la chiamata.200Il messaggio dice a Claude di effettuare la chiamata ancora una volta così come è stata registrata. Se anche quella viene negata, l'hook modifica l'input ogni volta, quindi disattiva il mod o l'hook, oppure esci dalla modalità auto e approva tu stesso la chiamata.

201 201 

202> [!NOTE]

203>

204> In [alcune sessioni interattive del terminale e sessioni di VS Code](https://code.claude.com/docs/it/hooks.md#pretooluse-updatedinput-in-auto-mode), la stessa negazione riporta il motivo `a hook changed this call's input after auto mode reviewed it`. In quel caso la chiamata ripetuta include la prima modifica del mod, e un hook `tool.call` viene comunque eseguito su di essa, ma un'ulteriore modifica viene scartata. Non devi modificare il tuo mod a meno che Claude non ti dica nella sua risposta che [la modalità auto non è riuscita a verificare la chiamata](https://code.claude.com/docs/it/errors.md#hook-changed-input-after-review).

205 

202### Un messaggio sulle regole di negazione nelle tue impostazioni206### Un messaggio sulle regole di negazione nelle tue impostazioni

203 207 

204`tried to lift a deny rule in your settings` e `the deny rules in your settings could not be checked for this call, so it is refused` provengono entrambi dalla protezione integrata.208`tried to lift a deny rule in your settings` e `the deny rules in your settings could not be checked for this call, so it is refused` provengono entrambi dalla protezione integrata.

31>31>

32> Altre due funzionalità pianificano il lavoro sulla tua macchina anziché nel cloud: le [attività pianificate di Desktop](https://code.claude.com/docs/it/desktop-scheduled-tasks.md) e [`/loop`](https://code.claude.com/docs/it/scheduled-tasks). Per scegliere tra tutte e tre, consulta [Confrontare le opzioni di pianificazione](https://code.claude.com/docs/it/scheduled-tasks.md#compare-scheduling-options).32> Altre due funzionalità pianificano il lavoro sulla tua macchina anziché nel cloud: le [attività pianificate di Desktop](https://code.claude.com/docs/it/desktop-scheduled-tasks.md) e [`/loop`](https://code.claude.com/docs/it/scheduled-tasks). Per scegliere tra tutte e tre, consulta [Confrontare le opzioni di pianificazione](https://code.claude.com/docs/it/scheduled-tasks.md#compare-scheduling-options).

33 33 

34Gli Owner di Team ed Enterprise possono disattivare le attività pianificate per tutti i membri con l'interruttore **Scheduled tasks (Was Routines)** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Quando l'interruttore è disattivato, le attività pianificate esistenti smettono di essere eseguite e i membri non possono crearne di nuove.34Gli Owner di Team ed Enterprise possono disattivare le attività pianificate per tutti i membri con l'interruttore **Scheduled tasks (Was Routines)** o **Routines** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Quando l'interruttore è disattivato, le attività pianificate esistenti smettono di essere eseguite e i membri non possono crearne di nuove.

35 35 

36Se la tua organizzazione Enterprise gestisce il tuo accesso con [ruoli personalizzati](https://support.claude.com/en/articles/13930452), ti serve anche un ruolo che includa il permesso per le attività pianificate. Un Owner può aggiungerlo nella sezione **Remote sessions** di un ruolo in [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).36Se la tua organizzazione Enterprise gestisce il tuo accesso con [ruoli personalizzati](https://support.claude.com/en/articles/13930452), ti serve anche un ruolo che includa il permesso per le attività pianificate. Un Owner può aggiungerlo nella sezione **Remote sessions** di un ruolo in [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

37 37 

485* **Indirizzo web**: `claude.ai/code/routines`485* **Indirizzo web**: `claude.ai/code/routines`

486* **CLI**: l'alias `/routines` per `/schedule`, la descrizione del comando e le risposte di Claude mentre configura un'attività486* **CLI**: l'alias `/routines` per `/schedule`, la descrizione del comando e le risposte di Claude mentre configura un'attività

487* **API**: il percorso dell'endpoint `/fire`, la sua intestazione beta, il `type` della risposta, il tag `<routine-fire-payload>` e la pagina di riferimento [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)487* **API**: il percorso dell'endpoint `/fire`, la sua intestazione beta, il `type` della risposta, il tag `<routine-fire-payload>` e la pagina di riferimento [Trigger a routine through the API](https://platform.claude.com/docs/en/api/claude-code/routines-fire)

488* **Impostazioni dell'organizzazione**: l'interruttore **Scheduled tasks (Was Routines)**488* **Impostazioni dell'organizzazione**: l'interruttore **Scheduled tasks (Was Routines)** o **Routines**

489 489 

490## Risoluzione dei problemi490## Risoluzione dei problemi

491 491 

504 504 

505Se la causa è l'accesso alla CLI o il fatto che ti trovi all'interno di una sessione cloud, puoi comunque creare e gestire le attività pianificate su [claude.ai/code/routines](https://claude.ai/code/routines). Lì ti serve un account Pro, Max, Ultra, Team o Enterprise. Se le attività pianificate o le sessioni cloud sono disattivate per la tua organizzazione o mancano dai tuoi ruoli, non puoi crearle nemmeno sul web.505Se la causa è l'accesso alla CLI o il fatto che ti trovi all'interno di una sessione cloud, puoi comunque creare e gestire le attività pianificate su [claude.ai/code/routines](https://claude.ai/code/routines). Lì ti serve un account Pro, Max, Ultra, Team o Enterprise. Se le attività pianificate o le sessioni cloud sono disattivate per la tua organizzazione o mancano dai tuoi ruoli, non puoi crearle nemmeno sul web.

506 506 

507### "Routines are disabled by your organization's policy"507### Le attività pianificate sono disattivate per la tua organizzazione

508 508 

509Probabilmente un Owner della tua organizzazione Team o Enterprise ha disattivato l'interruttore **Scheduled tasks (Was Routines)** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities). Su Claude Code v2.1.227 o successivo, lo stesso interruttore nasconde anche `/schedule` nella CLI. Si tratta di un'impostazione dell'organizzazione lato server, quindi non può essere sovrascritta dalla tua configurazione locale. Chiedi a un Owner di riattivare le attività pianificate per la tua organizzazione.509Le attività pianificate nel cloud sono disattivate per la tua organizzazione e non puoi modificarlo dalla tua configurazione locale. Chiedi all'Owner della tua organizzazione Team o Enterprise se può attivare l'interruttore **Scheduled tasks (Was Routines)** o **Routines** in [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities).

510 510 

511### Avvisi "The last run"511### Avvisi "The last run"

512 512 

1074* **Escalation dei permessi del filesystem**: i permessi di scrittura del filesystem eccessivamente ampi possono abilitare attacchi di escalation dei privilegi. Consentire scritture a directory contenenti eseguibili in `$PATH`, directory di configurazione di sistema o file di configurazione della shell dell'utente come `.bashrc` o `.zshrc` può portare all'esecuzione di codice in diversi contesti di sicurezza quando altri utenti o processi di sistema accedono a questi file.1074* **Escalation dei permessi del filesystem**: i permessi di scrittura del filesystem eccessivamente ampi possono abilitare attacchi di escalation dei privilegi. Consentire scritture a directory contenenti eseguibili in `$PATH`, directory di configurazione di sistema o file di configurazione della shell dell'utente come `.bashrc` o `.zshrc` può portare all'esecuzione di codice in diversi contesti di sicurezza quando altri utenti o processi di sistema accedono a questi file.

1075* **Forza della sandbox Linux**: l'implementazione Linux fornisce un forte isolamento del filesystem e della rete ma include una modalità `enableWeakerNestedSandbox` che le consente di funzionare all'interno di ambienti Docker senza namespace privilegiati. Questa opzione indebolisce considerevolmente la sicurezza e dovrebbe essere utilizzata solo quando l'isolamento aggiuntivo è altrimenti applicato.1075* **Forza della sandbox Linux**: l'implementazione Linux fornisce un forte isolamento del filesystem e della rete ma include una modalità `enableWeakerNestedSandbox` che le consente di funzionare all'interno di ambienti Docker senza namespace privilegiati. Questa opzione indebolisce considerevolmente la sicurezza e dovrebbe essere utilizzata solo quando l'isolamento aggiuntivo è altrimenti applicato.

1076* **Apple Events su macOS**: la sandbox macOS blocca gli Apple Events per impostazione predefinita. L'impostazione `allowAppleEvents` rimuove questa restrizione in modo che strumenti come `open` e `osascript` funzionino, ma rimuove l'isolamento dell'esecuzione del codice: i comandi sandboxati possono avviare altre applicazioni senza sandbox senza alcun prompt dell'utente, e possono inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso per l'automazione macOS per app (TCC). È onorato solo dalle impostazioni utente, gestite o CLI. Le impostazioni del progetto non possono abilitarlo.1076* **Apple Events su macOS**: la sandbox macOS blocca gli Apple Events per impostazione predefinita. L'impostazione `allowAppleEvents` rimuove questa restrizione in modo che strumenti come `open` e `osascript` funzionino, ma rimuove l'isolamento dell'esecuzione del codice: i comandi sandboxati possono avviare altre applicazioni senza sandbox senza alcun prompt dell'utente, e possono inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso per l'automazione macOS per app (TCC). È onorato solo dalle impostazioni utente, gestite o CLI. Le impostazioni del progetto non possono abilitarlo.

1077* **Servizi Mach e XPC su macOS**: i comandi sandboxati possono raggiungere, al di fuori della sandbox, ciascun servizio che elenchi in [`network.allowMachLookup`](https://code.claude.com/docs/it/settings-reference#sandbox-network-allowmachlookup), e la sandbox non limita ciò che quei servizi fanno per quei comandi.

1077* **User namespace su Linux e WSL2**: per impostazione predefinita, i comandi sandboxati non possono creare user namespace. Se imposti [`allowNestedUserNamespaces`](https://code.claude.com/docs/it/settings-reference#sandbox-allownestedusernamespaces) su `true`, disattivi un confine di sicurezza: il codice di un comando sandboxato può finire per essere eseguito al di fuori della sandbox. Prima di attivare questa impostazione, leggi l'avviso in [Chromium o Podman rootless non funziona all'interno della sandbox su Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).1078* **User namespace su Linux e WSL2**: per impostazione predefinita, i comandi sandboxati non possono creare user namespace. Se imposti [`allowNestedUserNamespaces`](https://code.claude.com/docs/it/settings-reference#sandbox-allownestedusernamespaces) su `true`, disattivi un confine di sicurezza: il codice di un comando sandboxato può finire per essere eseguito al di fuori della sandbox. Prima di attivare questa impostazione, leggi l'avviso in [Chromium o Podman rootless non funziona all'interno della sandbox su Linux](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux).

1078 1079 

1079### Ambito1080### Ambito

16 16 

17## Script wrapper17## Script wrapper

18 18 

19Usa uno script wrapper quando ogni sessione ha bisogno di una configurazione che il runner non può fare da solo: provisioning di credenziali di breve durata limitate al creatore della sessione, esportazione di segreti specifici dell'ambiente, preparazione di toolchain di linguaggio o applicazione di limiti di risorse attorno al processo figlio. Il runner avvia il tuo wrapper al posto del binario Claude Code, una volta per sessione. Termina il wrapper con `exec` in `$CLAUDE_RUNNER_CLAUDE_BIN`, il binario del runner stesso, in modo che i segnali e i codici di uscita si propaghino correttamente.19Usa uno script wrapper quando ogni sessione ha bisogno di una configurazione che il runner non può fare da solo:

20 

21* Provisioning di credenziali di breve durata limitate al creatore della sessione

22* Esportazione di segreti specifici dell'ambiente

23* Preparazione di toolchain di linguaggio

24* Applicazione di limiti di risorse attorno al processo figlio

25 

26Il runner avvia il tuo wrapper al posto del binario Claude Code ogni volta che avvia una sessione, anche quando una sessione viene ripresa o rimessa in coda. Termina il wrapper con `exec` in `$CLAUDE_RUNNER_CLAUDE_BIN`, il binario del runner stesso, in modo che i segnali e i codici di uscita si propaghino correttamente.

20 27 

21Punta `--exec-path`, o `SELF_HOSTED_RUNNER_EXEC_PATH`, al wrapper quando avvii il runner, sostituendo `<writable-dir>` come descritto nella [guida rapida](https://code.claude.com/docs/it/self-hosted-environments-quickstart.md#set-up-manually):28Punta `--exec-path`, o `SELF_HOSTED_RUNNER_EXEC_PATH`, al wrapper quando avvii il runner, sostituendo `<writable-dir>` come descritto nella [guida rapida](https://code.claude.com/docs/it/self-hosted-environments-quickstart.md#set-up-manually):

22 29 

139 146 

140### checkout147### checkout

141 148 

142Viene eseguito una volta per repository, al posto del clone e del fetch integrati del runner. Usa l'hook per clonare da un mirror read-through che raggiungi tramite HTTPS o SSH, popolare un albero di lavoro da un archivio o applicare l'autenticazione git per sessione. Il runner imposta queste variabili, e può impostare altre variabili `CLAUDE_RUNNER_` che la tabella non elenca:149Viene eseguito per ogni repository ogni volta che il runner avvia una sessione, anche quando la sessione riprende o viene rimessa in coda, al posto del clone e del fetch integrati del runner. Usa l'hook per clonare da un mirror read-through che raggiungi tramite HTTPS o SSH, popolare un albero di lavoro da un archivio o applicare l'autenticazione git per sessione.

150 

151Il runner imposta queste variabili, e può impostare altre variabili `CLAUDE_RUNNER_` che la tabella non elenca:

143 152 

144| Variabile | Descrizione |153| Variabile | Descrizione |

145| :- | :- |154| :- | :- |

179 188 

180### post-session189### post-session

181 190 

182Viene eseguito una volta per sessione, dopo che il figlio Claude Code è uscito e prima che il runner smantelli l'area di lavoro. Questo hook è la tua unica possibilità di salvare il lavoro non committato: a `--capacity` superiore a uno, il runner elimina i worktree per sessione subito dopo il ritorno dell'hook, e a `--capacity 1` il [clone canonico](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) riutilizzato viene hard-reset quando la sessione successiva inizia, quindi i cambiamenti tracciati non committati non sopravvivono su nessuno dei due percorsi. Gli usi tipici sono il push di un ramo snapshot di cambiamenti non committati, l'archiviazione di log o l'emissione di un evento di fine sessione ai propri sistemi.191Viene eseguito dopo che il figlio Claude Code è uscito e prima che il runner smantelli il workspace. Questo hook è la tua unica possibilità di salvare il lavoro non committato, perché i cambiamenti tracciati non committati non sopravvivono su nessuno dei due percorsi:

192 

193* **A `--capacity` superiore a uno**: il runner elimina i worktree per sessione subito dopo il ritorno dell'hook

194* **A `--capacity 1`**: il [clone canonico](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout) riutilizzato viene hard-reset quando la sessione successiva inizia

195 

196Gli usi tipici sono il push di un branch snapshot di cambiamenti non committati, l'archiviazione di log o l'emissione di un evento di fine sessione ai tuoi sistemi.

183 197 

184L'hook si attiva ad ogni fine sessione dove un processo figlio è stato generato, qualunque sia la causa; i valori `CLAUDE_RUNNER_EXIT_REASON` di seguito enumerano i casi. Non può attivarsi quando il runner termina bruscamente, come una preemption VM o una perdita di potenza; se hai bisogno di garanzie contro la terminazione brusca, fai uno snapshot periodicamente dall'interno della sessione con un hook Claude Code `PostToolUse` invece. Il runner imposta:198L'hook si attiva ad ogni fine sessione dove un processo figlio è stato generato, qualunque sia la causa; i valori `CLAUDE_RUNNER_EXIT_REASON` di seguito enumerano i casi. Non può attivarsi quando il runner termina bruscamente, come una preemption VM o una perdita di potenza; se hai bisogno di garanzie contro la terminazione brusca, fai uno snapshot periodicamente dall'interno della sessione con un hook Claude Code `PostToolUse` invece. Il runner imposta:

185 199 

275 289 

276### command290### command

277 291 

278Viene eseguito una volta per sessione dopo il checkout, al posto dello spawn del figlio integrato. L'hook riceve lo stesso ambiente di uno [script wrapper](#wrapper-scripts) e dovrebbe fare `exec` in `"$CLAUDE_RUNNER_CLAUDE_BIN"` allo stesso modo. Utilizzare l'hook `command` per mantenere tutta la personalizzazione in una directory di hook; utilizzare `--exec-path` quando il wrapper vive altrove. Se `--exec-path` è anche impostato, il flag ha la precedenza e l'hook `command` viene ignorato.292Viene eseguito dopo il checkout ogni volta che una sessione si avvia o riprende, al posto dello spawn del figlio integrato. L'hook riceve lo stesso ambiente di uno [script wrapper](#wrapper-scripts) e dovrebbe fare `exec` in `"$CLAUDE_RUNNER_CLAUDE_BIN"` allo stesso modo. Usa l'hook `command` per mantenere tutta la personalizzazione in una directory di hook; usa `--exec-path` quando il wrapper si trova altrove. Se è impostato anche `--exec-path`, il flag ha la precedenza e l'hook `command` viene ignorato.

279 293 

280Sempre fare `exec` del binario del runner stesso piuttosto che di un `claude` risolto da PATH; altrimenti si sconfigge il [pinning della versione](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#pin-the-version).294Sempre fare `exec` del binario del runner stesso piuttosto che di un `claude` risolto da PATH; altrimenti si sconfigge il [pinning della versione](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#pin-the-version).

281 295 

523 537 

524* **Endpoint dei metadati**: se neghi del tutto alle sessioni l'accesso all'[endpoint dei metadati cloud](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#harden-your-deployment), nemmeno le credenziali fornite da esso, come un instance profile, raggiungono Claude Code. Un'identità web basata su file, come IAM Roles for Service Accounts (IRSA) su Amazon EKS o un file di credenziali di Workload Identity Federation, non dipende da esso.538* **Endpoint dei metadati**: se neghi del tutto alle sessioni l'accesso all'[endpoint dei metadati cloud](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#harden-your-deployment), nemmeno le credenziali fornite da esso, come un instance profile, raggiungono Claude Code. Un'identità web basata su file, come IAM Roles for Service Accounts (IRSA) su Amazon EKS o un file di credenziali di Workload Identity Federation, non dipende da esso.

525* **Rinnovo**: una sessione può durare più a lungo di una credenziale, quindi usa un metodo che si rinnova da solo, come un'identità web basata su file539* **Rinnovo**: una sessione può durare più a lungo di una credenziale, quindi usa un metodo che si rinnova da solo, come un'identità web basata su file

526* **Script wrapper**: il runner avvia il tuo [script wrapper](#provision-credentials-scoped-to-the-session-creator) una volta per sessione, quindi le credenziali che esporta non vengono rinnovate. Claude Code legge le credenziali AWS dal proprio ambiente, quindi se il tuo wrapper esporta già credenziali AWS per altri scopi, Claude Code può usarle per firmare le richieste al modello.540* **Script wrapper**: i valori delle credenziali esportati dal tuo [script wrapper](#provision-credentials-scoped-to-the-session-creator) non vengono rinnovati mentre Claude Code è in esecuzione, quindi per una sessione lunga usa un metodo che si rinnova da solo. Claude Code legge le credenziali AWS dal proprio ambiente, quindi se il tuo wrapper esporta già credenziali AWS per altri scopi, Claude Code può usarle per firmare le richieste al modello.

527 541 

528**3. Imposta le variabili di un solo provider nell'ambiente del runner**542**3. Imposta le variabili di un solo provider nell'ambiente del runner**

529 543 

827 827 

828### Alcune sessioni non contano come inattive828### Alcune sessioni non contano come inattive

829 829 

830Una sessione che tiene un compito di background che non finisce mai non conta come inattiva, quindi `--release-idle-session-min` non rilascerà lo slot di quella sessione. Una sessione che sta aspettando un'approvazione richiesta dall'interno di una chiamata di strumento in esecuzione non conta neanche come inattiva. Imposta sempre `--kill-session-after-min` insieme ad essa come un hard backstop in modo che nessuna sessione possa tenere uno slot indefinitamente.830Una sessione che tiene un'attività in background che continua a essere eseguita non conta come inattiva, quindi `--release-idle-session-min` non rilascerà lo slot di quella sessione. Una sessione che sta aspettando un'approvazione richiesta dall'interno di una chiamata a uno strumento in esecuzione non conta neanche come inattiva. Imposta `--kill-session-after-min` insieme ad essa come un hard backstop.

831 831 

832`--kill-session-after-min` è un backstop per le sessioni runaway. Su un runner su v2.1.260 o successivo, una sessione che raggiunge il limite non viene terminata immediatamente. Il runner le dà una finestra di grazia, 15 minuti per impostazione predefinita, che puoi cambiare con [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/it/self-hosted-environments-reference#environment-variable-only-settings):832`--kill-session-after-min` è un backstop per le sessioni runaway. Su un runner su v2.1.260 o successivo, una sessione che raggiunge il limite non viene terminata immediatamente. Il runner le dà una finestra di grazia, 15 minuti per impostazione predefinita, che puoi cambiare con [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/it/self-hosted-environments-reference#environment-variable-only-settings):

833 833 

153}153}

154```154```

155 155 

156Usa `last_poll_age_ms` come segnale di vivacità nei probe personalizzati; un valore che cresce senza limiti indica che il ciclo di polling è bloccato. Sia `last_poll_at` che `last_poll_age_ms` sono `null` fino al completamento del primo polling.156Imposta avvisi su `last_poll_age_ms`, ma non usarlo in un probe di liveness; mantieni quel probe sul codice di stato HTTP. Il valore è il tempo trascorso dall'ultimo polling riuscito, quindi cresce anche quando il runner non riesce a raggiungere Anthropic. Sia `last_poll_at` che `last_poll_age_ms` sono `null` fino al completamento del primo polling. Per intercettare i polling che falliscono fin dall'inizio, imposta avvisi anche su `claude_code_self_hosted_runner_poll_errors_total`, elencata in [Metriche Prometheus](#prometheus-metrics).

157 157 

158Il `/healthz` dell'orchestrator, sulla sua porta di salute, restituisce sempre `200`. Il corpo porta un campo `connected` che segnala se il polling più recente ha avuto successo, più i conteggi della coda di spawn per stato in `queue_counts`. Per capire perché `connected` è `false`, leggi il campo di primo livello `last_error`, che ogni polling riuscito reimposta a `null`. Basa readiness e alerting su `connected` piuttosto che sul codice di stato.158Il `/healthz` dell'orchestrator, sulla sua porta di salute, restituisce sempre `200`. Il corpo porta un campo `connected` che segnala se il polling più recente ha avuto successo, più i conteggi della coda di spawn per stato in `queue_counts`. Per capire perché `connected` è `false`, leggi il campo di primo livello `last_error`, che ogni polling riuscito reimposta a `null`. Basa readiness e alerting su `connected` piuttosto che sul codice di stato.

159 159 

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/it/settings-reference#automode-classifyallshell) | `true` da `~/.claude/settings.json` o `--settings` | Rispettato anche quando una fonte gestita imposta `false` |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/it/settings-reference#automode-classifyallshell) | `true` da `~/.claude/settings.json` o `--settings` | Rispettato anche quando una fonte gestita imposta `false` |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/it/settings-reference#remotecontrolatstartup) | `false` da `.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando una fonte gestita imposta `true`; un `true` di progetto o locale viene ignorato |314| [`remoteControlAtStartup`](https://code.claude.com/docs/it/settings-reference#remotecontrolatstartup) | `false` da `.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando una fonte gestita imposta `true`; un `true` di progetto o locale viene ignorato |

315| [`crossSessionInbound`](https://code.claude.com/docs/it/settings-reference#crosssessioninbound) | Un valore più restrittivo da `.claude/settings.json` o `.claude/settings.local.json`, sulla scala `accept` \< `hold` \< `refuse` | Rispettato rispetto ai valori gestiti, di `--settings` e utente; un valore di progetto o locale che non sia più restrittivo viene ignorato |315| [`crossSessionInbound`](https://code.claude.com/docs/it/settings-reference#crosssessioninbound) | Un valore più restrittivo da `.claude/settings.json` o `.claude/settings.local.json`, sulla scala `accept` \< `hold` \< `refuse` | Rispettato rispetto ai valori gestiti, di `--settings` e utente; un valore di progetto o locale che non sia più restrittivo viene ignorato |

316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/it/settings-reference#useautomodeduringplan) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/it/settings-reference#useautomodeduringplan) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato. Consulta [la voce della chiave](https://code.claude.com/docs/it/settings-reference.md#useautomodeduringplan) per il caso di un file che ometti all'avvio |

317| [`syncClaudeAiSkills`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiskills) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |317| [`syncClaudeAiSkills`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiskills) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |

318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiplugins) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/it/settings-reference#syncclaudeaiplugins) | `false` da qualsiasi fonte gestita, `--settings`, `~/.claude/settings.json` o `.claude/settings.local.json` | Rispettato anche quando la fonte gestita prevalente imposta `true`; un `false` in `.claude/settings.json` viene ignorato |

319| [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) | Un limite più basso da qualsiasi ambito, incluso `--settings` | Rispettato anche quando le impostazioni gestite applicate da Claude Code impostano un limite più alto; si applica il limite più basso. Richiede Claude Code v2.1.267 o successiva |319| [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) | Un limite più basso da qualsiasi ambito, incluso `--settings` | Rispettato anche quando le impostazioni gestite applicate da Claude Code impostano un limite più alto; si applica il limite più basso. Richiede Claude Code v2.1.267 o successiva |

925Scegli se Claude Code utilizza il classificatore della modalità auto per esaminare i comandi shell in plan mode. Con il valore predefinito `true`, il classificatore esamina ogni comando durante la pianificazione quando la modalità auto è disponibile e non vedi alcuna richiesta di conferma, eccetto per le [rimozioni di percorsi critici](https://code.claude.com/docs/it/permission-modes.md#critical-paths). Imposta `false` per ottenere una richiesta di permesso per ogni comando al di fuori dell'insieme integrato di sola lettura. Appare in `/config` come **Use auto mode during plan**.925Scegli se Claude Code utilizza il classificatore della modalità auto per esaminare i comandi shell in plan mode. Con il valore predefinito `true`, il classificatore esamina ogni comando durante la pianificazione quando la modalità auto è disponibile e non vedi alcuna richiesta di conferma, eccetto per le [rimozioni di percorsi critici](https://code.claude.com/docs/it/permission-modes.md#critical-paths). Imposta `false` per ottenere una richiesta di permesso per ogni comando al di fuori dell'insieme integrato di sola lettura. Appare in `/config` come **Use auto mode during plan**.

926 926 

927* **Ambito**: [`User, local, or managed`](#scopes). Un repository non può disattivarla per te.927* **Ambito**: [`User, local, or managed`](#scopes). Un repository non può disattivarla per te.

928 * Un `false` in uno qualsiasi di questi file o in `--settings` la disattiva, a meno che tu non escluda quel file utente o locale con un'opzione come [`--setting-sources`](https://code.claude.com/docs/it/cli-reference#cli-flags). Ignorare un file escluso richiede Claude Code v2.1.314 o successivo

928* **Tipo**: Booleano929* **Tipo**: Booleano

929 * `true`: equivale a non impostato; quando la modalità auto è disponibile, il classificatore esamina ogni comando shell durante la pianificazione invece di chiederti conferma, eccetto le [rimozioni di percorsi critici](https://code.claude.com/docs/it/permission-modes.md#critical-paths). Un `false` in uno qualsiasi di questi file la disattiva comunque930 * `true`: equivale a non impostato; quando la modalità auto è disponibile, il classificatore esamina i comandi shell durante la pianificazione

930 * `false`: ricevi una richiesta di permesso per ogni comando al di fuori dell'insieme integrato di sola lettura931 * `false`: ricevi una richiesta di permesso per ogni comando al di fuori dell'insieme integrato di sola lettura

931* **Predefinito**: `true`932* **Predefinito**: `true`

932 933 

2073 2074 

2074### `sandbox.network.allowMachLookup`2075### `sandbox.network.allowMachLookup`

2075 2076 

2076Elenca i nomi di servizio XPC e Mach aggiuntivi che la sandbox macOS può cercare. Gli strumenti che comunicano tramite XPC, come il Simulatore iOS o Playwright, hanno bisogno che i loro servizi siano elencati qui.2077Elenca nomi aggiuntivi di servizi XPC e Mach che la sandbox macOS può cercare. Gli strumenti che comunicano tramite XPC, come l'iOS Simulator o Playwright, richiedono che i loro servizi siano elencati qui. I comandi nella sandbox possono raggiungere, fuori dalla sandbox, ogni servizio che elenchi, e la sandbox [non limita ciò che quei servizi fanno per quei comandi](https://code.claude.com/docs/it/sandboxing.md#security-limitations).

2077 2078 

2078* **Scope**: [`Any file`](#scopes), con [limiti sulle impostazioni di progetto e locali](https://code.claude.com/docs/it/sandboxing.md#repository-settings-under-an-admin-required-sandbox)2079* **Scope**: [`Any file`](#scopes), con [limiti sulle impostazioni di progetto e locali](https://code.claude.com/docs/it/sandboxing.md#repository-settings-under-an-admin-required-sandbox)

2079* **Type**: array di stringhe, ognuna un nome di servizio; un singolo `*` finale corrisponde a un prefisso, e `"*"` da solo corrisponde a ogni servizio2080* **Type**: array di stringhe, ognuna un nome di servizio; un singolo `*` finale corrisponde a un prefisso, e `"*"` da solo corrisponde a ogni servizio

2422 2423 

2423 L'esclusione di questo gruppo nelle impostazioni di progetto e locali richiede Claude Code v2.1.282 o successiva.2424 L'esclusione di questo gruppo nelle impostazioni di progetto e locali richiede Claude Code v2.1.282 o successiva.

2424 * Variabili che cambiano il modo in cui Claude Code si avvia o si sincronizza, come `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` e `CLAUDE_CODE_PLUGIN_SEED_DIR`.2425 * Variabili che cambiano il modo in cui Claude Code si avvia o si sincronizza, come `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR` e `CLAUDE_CODE_PLUGIN_SEED_DIR`.

2426 * Variabili che impostano il tuo accesso a claude.ai, come [`CLAUDE_CODE_OAUTH_TOKEN`, `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` e `CLAUDE_CODE_OAUTH_SCOPES`](https://code.claude.com/docs/it/env-vars#variables).

2425 * La variabile della [modalità screen reader](https://code.claude.com/docs/it/accessibility.md) `CLAUDE_AX_SCREEN_READER` e le altre variabili i cui nomi iniziano con `CLAUDE_AX_`, come [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/it/env-vars#variables).2427 * La variabile della [modalità screen reader](https://code.claude.com/docs/it/accessibility.md) `CLAUDE_AX_SCREEN_READER` e le altre variabili i cui nomi iniziano con `CLAUDE_AX_`, come [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/it/env-vars#variables).

2426 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars#variables), che imposta il timer di una finestra di dialogo senza risposta.2428 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/it/env-vars#variables), che imposta il timer di una finestra di dialogo senza risposta.

2427 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/it/env-vars#variables), che disattiva l'elaborazione degli allegati.2429 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/it/env-vars#variables), che disattiva l'elaborazione degli allegati.

40>40>

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

42>42>

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}43> ```bash 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}51> ```powershell 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57> ```batch 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}75> ```bash 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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}87> ```powershell theme={null}

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

89> ```89> ```

90>90>

416 416 

417Quando chiedi a Claude di eseguire un subagent non fork a uno specifico livello di sforzo, Claude può anche passare un parametro `effort` per quella invocazione. Il parametro sovrascrive il campo `effort` e resta in vigore quando il subagent viene [ripreso](#resume-subagents). La variabile d'ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/it/env-vars#variables) ha la precedenza su entrambi. Il parametro della singola invocazione richiede Claude Code v2.1.292 o successivo.417Quando chiedi a Claude di eseguire un subagent non fork a uno specifico livello di sforzo, Claude può anche passare un parametro `effort` per quella invocazione. Il parametro sovrascrive il campo `effort` e resta in vigore quando il subagent viene [ripreso](#resume-subagents). La variabile d'ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/it/env-vars#variables) ha la precedenza su entrambi. Il parametro della singola invocazione richiede Claude Code v2.1.292 o successivo.

418 418 

419#### Quando un subagent non ha un campo o un parametro `effort`

420 

421Sul modello della conversazione principale, il subagent viene eseguito al livello che scegli nella sessione, ad esempio con `/effort`, o che imposti con `--effort`. Su un altro modello, [quel livello non si applica](https://code.claude.com/docs/it/model-config.md#effort-level-of-subagents-and-teammates). Per sceglierne il livello, imposta il campo `effort`.

422 

419### Controlli le capacità del subagent423### Controlli le capacità del subagent

420 424 

421Può controllare cosa possono fare i subagent attraverso l'accesso agli strumenti, le modalità di autorizzazione e le regole condizionali.425Può controllare cosa possono fare i subagent attraverso l'accesso agli strumenti, le modalità di autorizzazione e le regole condizionali.

69 69 

70Con questa connessione, una sessione può clonare qualsiasi repository pubblico, ma può lavorare in un repository privato solo quando l'App Claude GitHub è installata su di esso. [Installa l'App](https://github.com/apps/claude/installations/new) su ogni account GitHub o organizzazione i cui repository privati desideri utilizzare. Su un'organizzazione GitHub, un proprietario dell'organizzazione potrebbe aver bisogno di approvare l'installazione. L'installazione dell'App abilita anche [Auto-fix](https://code.claude.com/docs/it/claude-code-on-the-web.md#auto-fix-pull-requests), che consente a Claude di rispondere ai fallimenti CI e ai commenti di revisione sulle pull request in quei repository.70Con questa connessione, una sessione può clonare qualsiasi repository pubblico, ma può lavorare in un repository privato solo quando l'App Claude GitHub è installata su di esso. [Installa l'App](https://github.com/apps/claude/installations/new) su ogni account GitHub o organizzazione i cui repository privati desideri utilizzare. Su un'organizzazione GitHub, un proprietario dell'organizzazione potrebbe aver bisogno di approvare l'installazione. L'installazione dell'App abilita anche [Auto-fix](https://code.claude.com/docs/it/claude-code-on-the-web.md#auto-fix-pull-requests), che consente a Claude di rispondere ai fallimenti CI e ai commenti di revisione sulle pull request in quei repository.

71 71 

72Quando ti connetti, Claude collega anche gli account GitHub di tua proprietà alla tua organizzazione Claude, se hanno l'App Claude GitHub installata. Nei piani Team ed Enterprise, gli amministratori vedono questi account nell'[elenco degli account GitHub connessi](https://code.claude.com/docs/it/admin-setup.md#connected-github-accounts).72Quando ti connetti, Claude collega anche gli account GitHub di tua proprietà alla tua organizzazione Claude, se hanno l'App Claude GitHub installata. Nei piani Team ed Enterprise, gli Owner della tua organizzazione Claude vedono questi account nell'[elenco degli account GitHub connessi](https://code.claude.com/docs/it/admin-setup.md#connected-github-accounts).

73 73 

74Se l'onboarding ti chiede di installare l'App a questo punto e preferisci farlo in seguito, fai clic su **Skip**.74Se l'onboarding ti chiede di installare l'App a questo punto e preferisci farlo in seguito, fai clic su **Skip**.

75 75