SpyBara
Go Premium

Documentation 2026-10-07 23:59 UTC to 2026-10-08 20:59 UTC

71 files changed +1,618 −1,174. View all changes and history on the product overview
2026
Thu 8 21:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

126 126 

127Uno stile di output è un file markdown con [frontmatter](/docs/it/output-styles#frontmatter) per i metadati, seguito dal contenuto del prompt. Salvatelo in `~/.claude/output-styles/` per uno stile a livello di utente disponibile in ogni progetto, o `.claude/output-styles/` nel vostro repository per uno stile a livello di progetto che potete committare e condividere con il vostro team.127Uno stile di output è un file markdown con [frontmatter](/docs/it/output-styles#frontmatter) per i metadati, seguito dal contenuto del prompt. Salvatelo in `~/.claude/output-styles/` per uno stile a livello di utente disponibile in ogni progetto, o `.claude/output-styles/` nel vostro repository per uno stile a livello di progetto che potete committare e condividere con il vostro team.

128 128 

129Uno stile di output personalizzato lascia fuori le istruzioni di ingegneria del software del preset `claude_code` e usa le vostre. Per mantenerle e stratificare le vostre istruzioni sopra, impostate `keep-coding-instructions: true` nel frontmatter. Queste istruzioni sono solo nel system prompt completo di Claude Code, quindi l'impostazione non ha effetto in una sessione sul system prompt più breve, che attivate o disattivate con [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/it/env-vars#variables). Mantenetele quando il vostro agente sta ancora facendo lavoro di ingegneria del software. Omettete quando state sostituendo completamente il ruolo.129Uno stile di output personalizzato esclude le istruzioni di ingegneria del software del preset `claude_code` e usa le tue. Per mantenerle e aggiungere le tue istruzioni sopra di esse, imposta `keep-coding-instructions: true` nel frontmatter. Queste istruzioni sono presenti solo nel prompt di sistema completo di Claude Code, quindi l'impostazione non ha effetto in una sessione con il prompt di sistema più breve; imposta [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/it/env-vars#variables) su `0` per selezionare il prompt completo su qualsiasi modello. Mantienile quando il tuo agente svolge ancora lavoro di ingegneria del software. Escludile quando sostituisci completamente il ruolo.

130 130 

131L'esempio seguente definisce una persona di revisione del codice che mantiene le istruzioni di codifica, poiché la revisione del codice beneficia ancora della guida sulla sicurezza e la qualità del codice di Claude Code. Salvatelo come `~/.claude/output-styles/code-reviewer.md` per renderlo disponibile in tutti i progetti:131L'esempio seguente definisce una persona di revisione del codice che mantiene le istruzioni di codifica, poiché la revisione del codice beneficia ancora della guida sulla sicurezza e la qualità del codice di Claude Code. Salvatelo come `~/.claude/output-styles/code-reviewer.md` per renderlo disponibile in tutti i progetti:

132 132 


547| **Gestione** | Nel filesystem | CLI + file | Nel codice | Nel codice |547| **Gestione** | Nel filesystem | CLI + file | Nel codice | Nel codice |

548| **Strumenti predefiniti** | Preservati | Preservati | Preservati | Persi (a meno che non inclusi) |548| **Strumenti predefiniti** | Preservati | Preservati | Preservati | Persi (a meno che non inclusi) |

549| **Sicurezza integrata** | Mantenuta | Mantenuta | Mantenuta | Deve essere aggiunta |549| **Sicurezza integrata** | Mantenuta | Mantenuta | Mantenuta | Deve essere aggiunta |

550| **Livello di personalizzazione** | Solo aggiunte | Sostituisci o estendi predefinito | Solo aggiunte | Controllo completo |550| **Livello di personalizzazione** | Solo aggiunte | Aggiunte; possono omettere le istruzioni di programmazione | Solo aggiunte | Controllo completo |

551| **Controllo versione** | Con progetto | Sì | Con codice | Con codice |551| **Controllo versione** | Con progetto | Sì | Con codice | Con codice |

552| **Ambito** | Specifico del progetto | Utente o progetto | Sessione di codice | Sessione di codice |552| **Ambito** | Specifico del progetto | Utente o progetto | Sessione di codice | Sessione di codice |

553 553 

Details

2786 "prompt": str, # Il compito che l'agente deve eseguire2786 "prompt": str, # Il compito che l'agente deve eseguire

2787 "subagent_type": str | None, # Il tipo di agente specializzato da utilizzare2787 "subagent_type": str | None, # Il tipo di agente specializzato da utilizzare

2788 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # Override del modello per questo agente2788 "model": "sonnet" | "opus" | "haiku" | "fable" | None, # Override del modello per questo agente

2789 "effort": "low" | "medium" | "high" | "xhigh" | "max" | None, # Sforzo di ragionamento per questo agente

2789 "run_in_background": bool | None, # Gli agenti vengono eseguiti in background per impostazione predefinita; impostare su False per eseguire in modo sincrono2790 "run_in_background": bool | None, # Gli agenti vengono eseguiti in background per impostazione predefinita; impostare su False per eseguire in modo sincrono

2790 "name": str | None, # Nome per l'agente generato2791 "name": str | None, # Nome per l'agente generato

2791 "team_name": str | None, # Deprecato; ignorato2792 "team_name": str | None, # Deprecato; ignorato

Details

1756* `ttft_stream_ms`: tempo in millisecondi fino al primo evento di flusso `message_start`, quando si apre il flusso di risposta. Inferiore a `ttft_ms`; la differenza tra i due è il tempo impiegato per lo streaming del primo messaggio. Presente solo sul ramo di successo.1756* `ttft_stream_ms`: tempo in millisecondi fino al primo evento di flusso `message_start`, quando si apre il flusso di risposta. Inferiore a `ttft_ms`; la differenza tra i due è il tempo impiegato per lo streaming del primo messaggio. Presente solo sul ramo di successo.

1757* `user_message_uuid`: l'`uuid` del messaggio che hai inviato a cui questo turno ha risposto. Consulta [`user_message_uuid`](#user_message_uuid) per sapere quali risultati lo contengono.1757* `user_message_uuid`: l'`uuid` del messaggio che hai inviato a cui questo turno ha risposto. Consulta [`user_message_uuid`](#user_message_uuid) per sapere quali risultati lo contengono.

1758* `user_message_uuids`: gli `uuid` di ogni messaggio che hai inviato a cui Claude Code ha risposto in questo turno. Consulta [`user_message_uuids`](#user_message_uuids).1758* `user_message_uuids`: gli `uuid` di ogni messaggio che hai inviato a cui Claude Code ha risposto in questo turno. Consulta [`user_message_uuids`](#user_message_uuids).

1759* `resume_reason`: il motivo per cui Claude Code ha rieseguito questo turno dopo che un riavvio lo ha interrotto. Presente su entrambi i rami, e solo su tale riesecuzione. Consulta [`resume_reason`](#resume_reason).1759* `resume_reason`: perché Claude Code ha rieseguito questo turno dopo che un riavvio lo ha interrotto. Presente in entrambi i rami. Consulta [`resume_reason`](#resume_reason).

1760* `local_command`: il nome del comando che il turno ha inviato, sul risultato di successo di un turno che un comando ha completato senza entrare nel ciclo dell'agente, come `/compact`. Il nome viene ridotto a lettere minuscole e trattini bassi, quindi `/reload-plugins` riporta `reload_plugins`. Un comando fornito da un server MCP, e il `/mcp` integrato, riportano `mcp`. Un comando che hai definito tu riporta `custom`. Gli argomenti non sono mai inclusi. Assente su ogni turno che è entrato nel ciclo dell'agente e sugli invii che non hanno eseguito alcun comando. Richiede Agent SDK v0.3.268 o successivo.1760* `local_command`: il nome del comando che il turno ha inviato, sul risultato di successo di un turno che un comando ha completato senza entrare nel ciclo dell'agente, come `/compact`. Il nome viene ridotto a lettere minuscole e trattini bassi, quindi `/reload-plugins` riporta `reload_plugins`. Un comando fornito da un server MCP, e il `/mcp` integrato, riportano `mcp`. Un comando che hai definito tu riporta `custom`. Gli argomenti non sono mai inclusi. Assente su ogni turno che è entrato nel ciclo dell'agente e sugli invii che non hanno eseguito alcun comando. Richiede Agent SDK v0.3.268 o successivo.

1761* `request_sent_wall_ms`: millisecondi epoch in cui Claude Code ha inviato la richiesta API, per le join con i timestamp lato server. Presente solo insieme a [`user_message_uuid`](#user_message_uuid), su un risultato di successo con `is_error` false il cui turno ha inviato una richiesta API.1761* `request_sent_wall_ms`: millisecondi epoch in cui Claude Code ha inviato la richiesta API, per le join con i timestamp lato server. Presente solo insieme a [`user_message_uuid`](#user_message_uuid), su un risultato di successo con `is_error` false il cui turno ha inviato una richiesta API.

1762* `first_content_frame_ms`: tempo in millisecondi fino al primo evento di flusso `content_block_start` o `content_block_delta`, contando i blocchi di ragionamento come contenuto. Presente solo sul ramo di successo, quando `is_error` è false. Richiede Agent SDK v0.3.260 o successivo.1762* `first_content_frame_ms`: tempo in millisecondi fino al primo evento di flusso `content_block_start` o `content_block_delta`, contando i blocchi di ragionamento come contenuto. Presente solo sul ramo di successo, quando `is_error` è false. Richiede Agent SDK v0.3.260 o successivo.


1845* **Il risultato della riesecuzione**: sia sul ramo di successo sia su quello di errore, indipendentemente dal fatto che il risultato contenga `user_message_uuid`.1845* **Il risultato della riesecuzione**: sia sul ramo di successo sia su quello di errore, indipendentemente dal fatto che il risultato contenga `user_message_uuid`.

1846* **I frame di risposta della riesecuzione**: quelli che contengono [`user_message_uuid`](#user_message_uuid).1846* **I frame di risposta della riesecuzione**: quelli che contengono [`user_message_uuid`](#user_message_uuid).

1847 1847 

1848Il valore è un breve token in minuscolo che indica il motivo della riesecuzione del turno, come `interrupted_turn`. Il campo è assente su ogni altro turno.1848Il valore è un breve token in minuscolo che indica perché il turno è stato rieseguito, come `interrupted_turn`.

1849 1849 

1850<h4 id="queued_turn_count">1850<h4 id="queued_turn_count">

1851 `queued_turn_count`1851 `queued_turn_count`


1887 | "worktree_resume_refused"1887 | "worktree_resume_refused"

1888 | "worktree_unverified"1888 | "worktree_unverified"

1889 | "cli_version_too_old"1889 | "cli_version_too_old"

1890 | "bypass_root";1890 | "bypass_root"

1891 | "org_config_required_unavailable"

1892 | "org_config_refused";

1891```1893```

1892 1894 

1893Ogni valore indica un rifiuto:1895Ogni valore indica un rifiuto:


1911| `worktree_unverified` | Non è stato possibile verificare il worktree della sessione in questo momento, e un nuovo tentativo potrebbe riuscire |1913| `worktree_unverified` | Non è stato possibile verificare il worktree della sessione in questo momento, e un nuovo tentativo potrebbe riuscire |

1912| `cli_version_too_old` | Questa versione di Claude Code è inferiore al minimo richiesto da Anthropic |1914| `cli_version_too_old` | Questa versione di Claude Code è inferiore al minimo richiesto da Anthropic |

1913| `bypass_root` | È stata richiesta la modalità di permesso bypass durante l'esecuzione come root |1915| `bypass_root` | È stata richiesta la modalità di permesso bypass durante l'esecuzione come root |

1916| `org_config_required_unavailable` | La sessione ha bisogno dei criteri e delle impostazioni gestite dell'organizzazione prima di potersi avviare, e non è stato possibile caricarli, ad esempio a causa di un errore di rete o di un errore del server di Anthropic. Richiede Agent SDK v0.3.293 o successivo |

1917| `org_config_refused` | Anthropic ha rifiutato di fornire i criteri e le impostazioni gestite dell'organizzazione per questo accesso, ad esempio perché l'accesso è scaduto o è stato revocato, o perché l'organizzazione non consente Claude Code per questo account. Richiede Agent SDK v0.3.293 o successivo |

1914 1918 

1915<h3 id="sdksystemmessage">1919<h3 id="sdksystemmessage">

1916 `SDKSystemMessage`1920 `SDKSystemMessage`


3183**Nome del tool:** `Agent`. Il nome precedente `Task` è ancora accettato come alias, e l'array `tools` nel messaggio di inizializzazione [`SDKSystemMessage`](#sdksystemmessage) attualmente elenca questo tool come `Task` per compatibilità all'indietro.3187**Nome del tool:** `Agent`. Il nome precedente `Task` è ancora accettato come alias, e l'array `tools` nel messaggio di inizializzazione [`SDKSystemMessage`](#sdksystemmessage) attualmente elenca questo tool come `Task` per compatibilità all'indietro.

3184 3188 

3185<Note>3189<Note>

3186 Il campo `mode` è deprecato e ignorato su Claude Code v2.1.212 o successivo. Un subagente viene eseguito in modalità di permesso della sessione padre o della sua definizione [`permissionMode`](#agentdefinition), e le [regole di ereditarietà del subagente](/docs/it/agent-sdk/permissions#available-modes) decidono quale.3190 Il campo `mode` è deprecato e ignorato su Claude Code v2.1.212 o successivo. Un subagent viene eseguito nella modalità di permesso della sessione padre o nel [`permissionMode`](#agentdefinition) della sua definizione, e le [regole di ereditarietà del subagent](/docs/it/agent-sdk/permissions#available-modes) decidono quale.

3187</Note>3191</Note>

3188 3192 

3189```typescript theme={null}3193```typescript theme={null}


3195 run_in_background?: boolean;3199 run_in_background?: boolean;

3196 name?: string;3200 name?: string;

3197 team_name?: string; // Deprecato; ignorato3201 team_name?: string; // Deprecato; ignorato

3198 mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan"; // Deprecato; ignorato. Le regole di ereditarietà del subagente decidono la modalità di permesso di un subagente3202 mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan"; // Deprecato; ignorato. Le regole di ereditarietà del subagent decidono la modalità di permesso di un subagent

3199 isolation?: "worktree" | "remote";3203 isolation?: "worktree" | "remote";

3200};3204};

3201```3205```


3240};3244};

3241```3245```

3242 3246 

3243Esegue comandi Bash con timeout opzionale ed esecuzione in background. La directory di lavoro persiste tra i comandi, inclusi i comandi eseguiti in turni successivi di una sessione multi-turno; lo stato della shell come le variabili di ambiente esportate non persiste. Per i limiti su quali cambiamenti di directory si mantengono, vedi [Cosa persiste tra i comandi](/docs/it/tools-reference#what-persists-between-commands). Per ciò che imposta il limite di foreground, vedi [Timeout e limiti di output](/docs/it/tools-reference#timeout-and-output-limits). Per il limite di tempo in background, vedi [Limite di tempo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands).3247Esegue comandi Bash con timeout opzionale ed esecuzione in background. La directory di lavoro persiste tra i comandi, inclusi i comandi eseguiti in turni successivi di una sessione multi-turno; lo stato della shell come le variabili d'ambiente esportate non persiste. Per i limiti su quali cambiamenti di directory si mantengono, vedi [Cosa persiste tra i comandi](/docs/it/tools-reference#what-persists-between-commands). Per ciò che imposta il limite di foreground, vedi [Timeout e limiti di output](/docs/it/tools-reference#timeout-and-output-limits). Per il limite di tempo in background, vedi [Limite di tempo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands).

3244 3248 

3245<h3 id="monitor">3249<h3 id="monitor">

3246 Monitor3250 Monitor


3260};3264};

3261```3265```

3262 3266 

3263Esegue una fonte di background e consegna ogni evento a Claude in modo che possa reagire senza polling: `command` esegue uno script e emette un evento per riga stdout, e `ws` apre un WebSocket e emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`. La fonte `ws` richiede Claude Code v2.1.195 o successivo.3267Esegue una fonte in background e consegna ogni evento a Claude in modo che possa reagire senza polling: `command` esegue uno script e emette un evento per riga stdout, e `ws` apre un WebSocket e emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`. La fonte `ws` richiede Claude Code v2.1.195 o successivo.

3264 3268 

3265`timeout_ms` è la scadenza del watch in millisecondi. Predefinito a 300000 e accetta valori fino a 3600000. La scadenza effettiva è al massimo 1800000, che è 30 minuti, quindi un valore accettato più grande viene accorciato a quello. Alla scadenza il watch termina e Claude riceve un avviso in modo che possa avviare un nuovo watch se ne ha ancora bisogno.3269`timeout_ms` è la scadenza del watch in millisecondi. Predefinito a 300000 e accetta valori fino a 3600000. La scadenza effettiva è al massimo 1800000, che è 30 minuti, quindi un valore accettato più grande viene accorciato a quello. Alla scadenza il watch termina e Claude riceve un avviso in modo che possa avviare un nuovo watch se ne ha ancora bisogno.

3266 3270 


3272 TaskOutput3276 TaskOutput

3273</h3>3277</h3>

3274 3278 

3275Rimosso in Claude Code v2.1.277, insieme al suo tipo `TaskOutputInput`. In precedenza recuperava l'output da un'attività di background in esecuzione o completata; Claude legge il file di output di un'attività di background con `Read` invece.3279Rimosso in Claude Code v2.1.277, insieme al suo tipo `TaskOutputInput`. In precedenza recuperava l'output da un'attività in background in esecuzione o completata; Claude legge il file di output di un'attività in background con `Read` invece.

3276 3280 

3277Una voce `disallowedTools` o una regola di negazione che ancora nomina `TaskOutput` viene ignorata senza un avviso.3281Una voce `disallowedTools` o una regola di negazione che ancora nomina `TaskOutput` viene ignorata senza un avviso.

3278 3282 


3383};3387};

3384```3388```

3385 3389 

3386Interrompe un'attività di background o shell in esecuzione per ID. A partire da v2.1.198, `task_id` accetta anche un compagno di squadra agent-team o un agente di background denominato per ID agente o nome.3390Interrompe un'attività in background o una shell in esecuzione per ID. A partire da v2.1.198, `task_id` accetta anche un membro di un team di agenti o un agente in background denominato per ID agente o nome.

3387 3391 

3388<h3 id="notebookedit">3392<h3 id="notebookedit">

3389 NotebookEdit3393 NotebookEdit


3452};3456};

3453```3457```

3454 3458 

3455Esegue un [workflow dinamico](/docs/it/workflows): uno script che orchestra molti subagenti in background e restituisce un risultato consolidato. Il tool `Workflow` è disponibile in Agent SDK v0.3.149 e versioni successive. Almeno uno tra `script`, `name` o `scriptPath` è obbligatorio.3459Esegue un [workflow dinamico](/docs/it/workflows): uno script che orchestra molti subagent in background e restituisce un risultato consolidato. Il tool `Workflow` è disponibile in Agent SDK v0.3.149 e versioni successive. Almeno uno tra `script`, `name` o `scriptPath` è obbligatorio.

3456 3460 

3457| Campo | Tipo | Descrizione |3461| Campo | Tipo | Descrizione |

3458| - | - | - |3462| - | - | - |


3580};3584};

3581```3585```

3582 3586 

3583Esce dalla modalità di pianificazione. Il campo `allowedPrompts` è deprecato e ignorato; Claude Code lo accetta comunque in modo che i chiamanti e i transcript esistenti siano validi. Prima di v2.1.205, richiedeva permessi Bash basati su prompt per implementare il piano.3587Esce dal plan mode. Il campo `allowedPrompts` è deprecato e ignorato; Claude Code lo accetta comunque in modo che i chiamanti e le trascrizioni esistenti siano validi. Prima di v2.1.205, richiedeva permessi Bash basati su prompt per implementare il piano.

3584 3588 

3585<h3 id="listmcpresources">3589<h3 id="listmcpresources">

3586 ListMcpResources3590 ListMcpResources


3624};3628};

3625```3629```

3626 3630 

3627Crea e entra in un worktree git temporaneo per il lavoro isolato. Passa `path` per passare a un worktree esistente invece di crearne uno nuovo. Su primo ingresso il target deve essere un worktree registrato del repository corrente o, in uno spazio di lavoro multi-repo, di un repository annidato al suo interno; da una sessione worktree deve essere sotto `.claude/worktrees/` del repository della sessione. `name` e `path` si escludono a vicenda.3631Crea e entra in un worktree git temporaneo per il lavoro isolato. Passa `path` per passare a un worktree esistente invece di crearne uno nuovo. Al primo ingresso il target deve essere un worktree registrato del repository corrente o, in un workspace multi-repo, di un repository annidato al suo interno; da una sessione worktree deve essere sotto `.claude/worktrees/` del repository della sessione. `name` e `path` si escludono a vicenda.

3628 3632 

3629<h3 id="exitworktree">3633<h3 id="exitworktree">

3630 ExitWorktree3634 ExitWorktree


3639};3643};

3640```3644```

3641 3645 

3642Esce dal worktree git corrente e ritorna alla directory di lavoro originale. L'azione `keep` lascia il worktree e il ramo su disco, mentre `remove` elimina entrambi. `discard_changes` deve essere `true` quando si rimuove un worktree che ha file non committati o commit non uniti.3646Esce dal worktree git corrente e ritorna alla directory di lavoro originale. L'azione `keep` lascia il worktree e il branch su disco, mentre `remove` elimina entrambi. `discard_changes` deve essere `true` quando si rimuove un worktree che ha file non committati o commit senza merge.

3643 3647 

3644<h3 id="enterplanmode">3648<h3 id="enterplanmode">

3645 EnterPlanMode3649 EnterPlanMode


3651type EnterPlanModeInput = {};3655type EnterPlanModeInput = {};

3652```3656```

3653 3657 

3654Entra in modalità di pianificazione, dove Claude ricerca e presenta un piano prima di apportare modifiche.3658Entra nel plan mode, dove Claude ricerca e presenta un piano prima di apportare modifiche.

3655 3659 

3656<h3 id="croncreate">3660<h3 id="croncreate">

3657 CronCreate3661 CronCreate


3668};3672};

3669```3673```

3670 3674 

3671Pianifica un prompt da eseguire su una pianificazione cron a 5 campi nell'ora locale. Imposta `recurring` a `false` per attivare una volta al prossimo match. I job sono scoped alla sessione per impostazione predefinita, e riprendere con `--resume` o `--continue` ripristina i job che non sono scaduti. Vedi [Attività pianificate](/docs/it/scheduled-tasks).3675Pianifica un prompt da eseguire su una pianificazione cron a 5 campi nell'ora locale. Imposta `recurring` a `false` per attivare una volta al prossimo match. I job sono limitati alla sessione per impostazione predefinita, e riprendere con `--resume` o `--continue` ripristina i job che non sono scaduti. Vedi [Attività pianificate](/docs/it/scheduled-tasks).

3672 3676 

3673Impostare `durable` a `true` richiede la persistenza a `.claude/scheduled_tasks.json` in modo che il job sopravviva ai riavvii. La pianificazione duratura non è disponibile in ogni sessione: quando non lo è, Claude Code accetta `durable: true` ma crea il job solo per la sessione. Leggi il campo `durable` dell'output per vedere se il job è persistito.3677Impostare `durable` a `true` richiede la persistenza a `.claude/scheduled_tasks.json` in modo che il job sopravviva ai riavvii. La pianificazione duratura non è disponibile in ogni sessione: quando non lo è, Claude Code accetta `durable: true` ma crea il job solo per la sessione. Leggi il campo `durable` dell'output per vedere se il job è persistito.

3674 3678 


3742};3746};

3743```3747```

3744 3748 

3745Gestisce [Routine](/docs/it/routines), le esecuzioni Claude Code pianificate e attivate ospitate nel cloud. Questo tool supporta il comando `/schedule`. `trigger_id` è obbligatorio per le azioni `get`, `update`, `run` e `list_runs`. `body` è obbligatorio per `create`, `update` e `create_webhook_trigger`, e facoltativo per `run`.3749Gestisce le [routine](/docs/it/routines), le esecuzioni Claude Code pianificate e attivate ospitate nel cloud. Questo tool supporta il comando `/schedule`. `trigger_id` è obbligatorio per le azioni `get`, `update`, `run` e `list_runs`. `body` è obbligatorio per `create`, `update` e `create_webhook_trigger`, e facoltativo per `run`.

3746 3750 

3747`create_webhook_trigger` allega una fonte di evento a una routine esistente, come un [evento GitHub](/docs/it/routines#add-a-github-trigger) che lo attiva. Il `body` nomina la fonte, gli eventi e la routine da attivare. Richiede Claude Code v2.1.225 o successivo.3751`create_webhook_trigger` allega una fonte di evento a una routine esistente, come un [evento GitHub](/docs/it/routines#add-a-github-trigger) che la attiva. Il `body` nomina la fonte, gli eventi e la routine da attivare. Richiede Claude Code v2.1.225 o successivo.

3748 3752 

3749`list_runs` elenca le esecuzioni recenti di una routine, e `get_run_log` legge il log di un'esecuzione. `session_id` nomina l'esecuzione da leggere, da un risultato `list_runs`, e `cursor` pagina attraverso i risultati di entrambe le azioni. Entrambe le azioni richiedono Claude Code v2.1.227 o successivo.3753`list_runs` elenca le esecuzioni recenti di una routine, e `get_run_log` legge il log di un'esecuzione. `session_id` nomina l'esecuzione da leggere, da un risultato `list_runs`, e `cursor` pagina attraverso i risultati di entrambe le azioni. Entrambe le azioni richiedono Claude Code v2.1.227 o successivo.

3750 3754 

3751Questo tool è disponibile solo quando la sessione è autenticata con un account claude.ai su un piano con Routine abilitate, ed è assente quando la politica della tua organizzazione disabilita [Claude Code sul web](/docs/it/claude-code-on-the-web). Su Claude Code v2.1.227 o successivo, il tool è anche assente quando un Proprietario ha [disattivato le routine per l'organizzazione](/docs/it/routines#routines-are-disabled-by-your-organizations-policy). Prima di v2.1.227, una sessione con solo il toggle delle routine disattivato mostrava comunque il tool, e il server negava le sue chiamate.3755Questo tool è disponibile solo quando la sessione è autenticata con un account claude.ai su un piano con le routine abilitate, ed è assente quando la politica della tua organizzazione disabilita le [sessioni cloud](/docs/it/claude-code-on-the-web). Su Claude Code v2.1.227 o successivo, il tool è anche assente quando un Proprietario ha [disattivato le routine per l'organizzazione](/docs/it/routines#routines-are-disabled-by-your-organizations-policy). Prima di v2.1.227, una sessione con solo il toggle delle routine disattivato mostrava comunque il tool, e il server negava le sue chiamate.

3752 3756 

3753<h3 id="pushnotification">3757<h3 id="pushnotification">

3754 PushNotification3758 PushNotification


3837* `title`: nomina la pagina pubblicata nella scheda del browser e nella galleria quando il file HTML non ha un tag `<title>`.3841* `title`: nomina la pagina pubblicata nella scheda del browser e nella galleria quando il file HTML non ha un tag `<title>`.

3838* `url`: indirizza un artifact esistente da aggiornare sul posto invece di crearne uno nuovo.3842* `url`: indirizza un artifact esistente da aggiornare sul posto invece di crearne uno nuovo.

3839 3843 

3840`force` è un'ultima risorsa di sovrascrittura che scarta una versione più recente che un'altra sessione ha pubblicato. In caso di conflitto, la pubblicazione non riuscita restituisce il contenuto più recente; Claude unisce le sue modifiche a quel contenuto, o rilegge l'artifact, e pubblica di nuovo. Passa `force` solo quando l'utente chiede esplicitamente di scartare quella versione.3844`force` è un'ultima risorsa di sovrascrittura che scarta una versione più recente che un'altra sessione ha pubblicato. In caso di conflitto, la pubblicazione non riuscita restituisce il contenuto più recente; Claude esegue il merge delle sue modifiche su quel contenuto, o rilegge l'artifact, e pubblica di nuovo. Passa `force` solo quando l'utente chiede esplicitamente di scartare quella versione.

3841 3845 

3842Passa `"list"` per enumerare gli artifact pubblicati dell'utente; solo `limit` e `scope` possono accompagnarlo. `scope` predefinito a `"mine"`, che elenca gli artifact che l'utente possiede; `"shared"` elenca gli artifact che altre persone hanno condiviso con l'utente, e `"all"` elenca entrambi.3846Passa `"list"` per enumerare gli artifact pubblicati dell'utente; solo `limit` e `scope` possono accompagnarlo. `scope` predefinito a `"mine"`, che elenca gli artifact che l'utente possiede; `"shared"` elenca gli artifact che altre persone hanno condiviso con l'utente, e `"all"` elenca entrambi.

3843 3847 

3848`limit` imposta il numero massimo di artifact che un elenco restituisce, da 1 a 200. Un `limit` superiore a 50 richiede Agent SDK v0.3.292 o successivo. Senza `limit`, un elenco restituisce fino a 25 artifact.

3849 

3844* `capabilities`: le capacità di runtime che la pagina pubblicata utilizza, codificate per nome di capacità, come i [connettori che la pagina può chiamare](/docs/it/artifacts#pull-live-data-with-mcp-connectors). Il servizio di artifact convalida la dichiarazione e rifiuta una pubblicazione che nomina una capacità che l'account non può utilizzare o ne fornisce una con una configurazione non valida. Passa `{}` per cancellare una dichiarazione memorizzata, e ometti il campo su una ridistribuzione per mantenerla. Richiede Agent SDK v0.3.235 o successivo.3850* `capabilities`: le capacità di runtime che la pagina pubblicata utilizza, codificate per nome di capacità, come i [connettori che la pagina può chiamare](/docs/it/artifacts#pull-live-data-with-mcp-connectors). Il servizio di artifact convalida la dichiarazione e rifiuta una pubblicazione che nomina una capacità che l'account non può utilizzare o ne fornisce una con una configurazione non valida. Passa `{}` per cancellare una dichiarazione memorizzata, e ometti il campo su una ridistribuzione per mantenerla. Richiede Agent SDK v0.3.235 o successivo.

3845* `contract`: la versione di runtime su cui viene eseguita la pagina pubblicata. Omettilo per mantenere la versione corrente dell'artifact, passa `"latest"` per aggiornare, o passa una versione specifica per fissare o eseguire il rollback. Richiede Agent SDK v0.3.235 o successivo.3851* `contract`: la versione di runtime su cui viene eseguita la pagina pubblicata. Omettilo per mantenere la versione corrente dell'artifact, passa `"latest"` per aggiornare, o passa una versione specifica per fissare o eseguire il rollback. Richiede Agent SDK v0.3.235 o successivo.

3846 3852 


3873 3879 

3874* `project_info`: restituisce i metadati del progetto e l'elenco dei documenti.3880* `project_info`: restituisce i metadati del progetto e l'elenco dei documenti.

3875* `project_read`: legge un documento per `path`.3881* `project_read`: legge un documento per `path`.

3876* `project_search`: interroga la base di conoscenza del progetto con `query`. `n` limita i risultati e predefinito a 5.3882* `project_search`: interroga la base di conoscenza del progetto con `query`. `n` limita i risultati e il valore predefinito è `5`.

3877* `project_write`: crea o sostituisce un documento in `path` da esattamente uno tra `content`, che contiene testo inline, o `local_path`, che nomina un file all'interno della directory di lavoro. `present_to_user: true` contrassegna il documento scritto come il deliverable che l'utente deve vedere.3883* `project_write`: crea o sostituisce un documento in `path` da esattamente uno tra `content`, che contiene testo inline, o `local_path`, che nomina un file all'interno della directory di lavoro. `present_to_user: true` contrassegna il documento scritto come il deliverable che l'utente deve vedere.

3878* `project_delete`: elimina un documento per `path`.3884* `project_delete`: elimina un documento per `path`.

3879 3885 


3933Gli argomenti dei tool MCP sono un oggetto aperto: ogni server definisce i suoi propri parametri, quindi il tipo non pone vincoli sui nomi dei campi o sui valori. Consulta lo schema dei tool del server per i campi che uno strumento specifico accetta.3939Gli argomenti dei tool MCP sono un oggetto aperto: ogni server definisce i suoi propri parametri, quindi il tipo non pone vincoli sui nomi dei campi o sui valori. Consulta lo schema dei tool del server per i campi che uno strumento specifico accetta.

3934 3940 

3935<h2 id="tool-output-types">3941<h2 id="tool-output-types">

3936 Tipi di output dei tool3942 Tipi di output degli strumenti

3937</h2>3943</h2>

3938 3944 

3939Documentazione degli schemi di output per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e rappresentano i dati di risposta effettivi restituiti da ogni tool.3945Documentazione degli schemi di output per tutti gli strumenti Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e rappresentano i dati di risposta effettivi restituiti da ogni strumento.

3940 3946 

3941<h3 id="tooloutputschemas">3947<h3 id="tooloutputschemas">

3942 `ToolOutputSchemas`3948 `ToolOutputSchemas`

3943</h3>3949</h3>

3944 3950 

3945Unione di tipi di output dei tool esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools`; i membri includono:3951Unione di tipi di output degli strumenti esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools`; i membri includono:

3946 3952 

3947```typescript theme={null}3953```typescript theme={null}

3948type ToolOutputSchemas =3954type ToolOutputSchemas =


3990 Agent3996 Agent

3991</h3>3997</h3>

3992 3998 

3993**Nome del tool:** `Agent`. Il nome precedente `Task` è ancora accettato come alias, e l'array `tools` nel messaggio di inizializzazione [`SDKSystemMessage`](#sdksystemmessage) attualmente elenca questo tool come `Task` per compatibilità con le versioni precedenti.3999**Nome dello strumento:** `Agent`. Il nome precedente `Task` è ancora accettato come alias, e l'array `tools` nel messaggio di inizializzazione [`SDKSystemMessage`](#sdksystemmessage) attualmente elenca questo strumento come `Task` per compatibilità con le versioni precedenti.

3994 4000 

3995```typescript theme={null}4001```typescript theme={null}

3996type AgentOutput =4002type AgentOutput =


4061 };4067 };

4062```4068```

4063 4069 

4064Restituisce il risultato dal subagente. Discriminato sul campo `status`: `"completed"` per le attività finite, `"async_launched"` per le attività di background, e `"remote_launched"` per le attività che Claude Code ha inviato a una sessione cloud remota, dove `sessionUrl` si collega a quella sessione e `taskId` l'identifica.4070Restituisce il risultato dal subagent. Discriminato sul campo `status`: `"completed"` per le attività finite, `"async_launched"` per le attività in background, e `"remote_launched"` per le attività che Claude Code ha inviato a una sessione cloud, dove `sessionUrl` si collega a quella sessione e `taskId` la identifica.

4065 4071 

4066Sulla variante `completed`, `resolvedModel` nomina il modello su cui il subagente ha iniziato, che può differire dal `model` input richiesto quando [`availableModels`](/docs/it/model-config#restrict-model-selection) o un altro override si applica. Questo campo richiede Claude Code v2.1.174 o successivo. Su `async_launched`, nomina il modello in uso quando l'attività è passata allo sfondo.4072Sulla variante `completed`, `resolvedModel` nomina il modello su cui il subagent ha iniziato, che può differire dal `model` input richiesto quando [`availableModels`](/docs/it/model-config#restrict-model-selection) o un altro override si applica. Questo campo richiede Claude Code v2.1.174 o successivo. Su `async_launched`, nomina il modello in uso quando l'attività è passata in background.

4067 4073 

4068`modelsUsed` elenca i modelli utilizzati dal subagente, in ordine. Il campo è presente solo quando si è verificato uno scambio a metà esecuzione, e un modello appare di nuovo quando l'esecuzione è tornata a esso. Su `async_launched`, l'elenco copre i modelli utilizzati prima di passare allo sfondo. Sia `modelsUsed` che il comportamento di passaggio allo sfondo di `resolvedModel` richiedono Claude Code v2.1.212 o successivo.4074`modelsUsed` elenca i modelli utilizzati dal subagent, in ordine. Il campo è presente solo quando si è verificato uno scambio a metà esecuzione, e un modello appare di nuovo quando l'esecuzione è tornata a esso. Su `async_launched`, l'elenco copre i modelli utilizzati prima del passaggio in background. Sia `modelsUsed` che il comportamento di passaggio in background di `resolvedModel` richiedono Claude Code v2.1.212 o successivo.

4069 4075 

4070Se Claude Code [ha mantenuto il worktree isolato del subagente](/docs/it/worktrees#isolate-subagents-with-worktrees), `worktreePath` sul risultato `completed` è dove trovarlo. `worktreeBranch` è il suo ramo, presente quando Claude Code ha creato il worktree con git.4076Se Claude Code [ha mantenuto il worktree isolato del subagent](/docs/it/worktrees#isolate-subagents-with-worktrees), `worktreePath` sul risultato `completed` è dove trovarlo. `worktreeBranch` è il suo branch, presente quando Claude Code ha creato il worktree con git.

4071 4077 

4072Claude Code riempie `usage` e `totalTokens` dalla richiesta API finale del subagent, non dall'intera esecuzione, quindi `usage.service_tier` è la stringa del livello di servizio che l'API ha segnalato su quella richiesta. Quando presente, `usage.output_tokens_details.thinking_tokens` è il numero di token di output di quella richiesta che erano token di ragionamento. Il campo `output_tokens_details` richiede TypeScript SDK v0.3.228 o successivo, che include Claude Code v2.1.228. Il campo `fallback_credit` richiede TypeScript SDK v0.3.285 o successivo, che include Claude Code v2.1.285.4078Claude Code riempie `usage` e `totalTokens` dalla richiesta API finale del subagent, non dall'intera esecuzione, quindi `usage.service_tier` è la stringa del livello di servizio che l'API ha segnalato su quella richiesta. Quando presente, `usage.output_tokens_details.thinking_tokens` è il numero di token di output di quella richiesta che erano token di ragionamento. Il campo `output_tokens_details` richiede TypeScript SDK v0.3.228 o successivo, che include Claude Code v2.1.228. Il campo `fallback_credit` richiede TypeScript SDK v0.3.285 o successivo, che include Claude Code v2.1.285.

4073 4079 


4079 AskUserQuestion4085 AskUserQuestion

4080</h3>4086</h3>

4081 4087 

4082**Nome del tool:** `AskUserQuestion`4088**Nome dello strumento:** `AskUserQuestion`

4083 4089 

4084```typescript theme={null}4090```typescript theme={null}

4085type AskUserQuestionOutput = {4091type AskUserQuestionOutput = {


4096};4102};

4097```4103```

4098 4104 

4099Restituisce le domande poste e le risposte dell'utente. `response` viene impostato quando l'utente ha digitato una risposta in forma libera invece di rispondere alle domande strutturate; quando presente, Claude riceve "L'utente ha risposto: …" invece dell'elenco di risposte per domanda.4105Restituisce le domande poste e le risposte dell'utente. `response` viene impostato quando l'utente ha digitato una risposta in forma libera invece di rispondere alle domande strutturate; quando presente, Claude riceve "The user responded: …" invece dell'elenco di risposte per domanda.

4100 4106 

4101<h3 id="bash-2">4107<h3 id="bash-2">

4102 Bash4108 Bash

4103</h3>4109</h3>

4104 4110 

4105**Nome del tool:** `Bash`4111**Nome dello strumento:** `Bash`

4106 4112 

4107```typescript theme={null}4113```typescript theme={null}

4108type BashOutput = {4114type BashOutput = {


4143| - | - |4149| - | - |

4144| `stdout` | Lo stdout e stderr del comando, uniti in un unico flusso intercalato |4150| `stdout` | Lo stdout e stderr del comando, uniti in un unico flusso intercalato |

4145| `stderr` | Avvisi che lo strumento stesso aggiunge, come un ripristino della directory di lavoro della shell, non lo stderr del comando |4151| `stderr` | Avvisi che lo strumento stesso aggiunge, come un ripristino della directory di lavoro della shell, non lo stderr del comando |

4146| `backgroundTaskId` | Presente per i comandi di background |4152| `backgroundTaskId` | Presente per i comandi in background |

4147 4153 

4148`timedOutAfterMs` è il timeout in millisecondi, impostato quando il comando ha raggiunto il suo timeout e si è spostato allo sfondo piuttosto che iniziare lì esplicitamente. `backgroundCwdHint` viene impostato quando il comando in background conteneva un builtin di cambio directory come `cd`, `pushd`, `popd` o `chdir`, e nota che la directory di lavoro della sessione non è cambiata. Entrambi i campi richiedono Claude Code v2.1.210 o successivo.4154`timedOutAfterMs` è il timeout in millisecondi, impostato quando il comando ha raggiunto il suo timeout ed è passato in background piuttosto che essere avviato lì esplicitamente. `backgroundCwdHint` viene impostato quando il comando in background conteneva un builtin di cambio directory come `cd`, `pushd`, `popd` o `chdir`, e nota che la directory di lavoro della sessione non è cambiata. Entrambi i campi richiedono Claude Code v2.1.210 o successivo.

4149 4155 

4150Quando un subagente in esecuzione in primo piano possiede un comando in background, il comando [termina quando quel subagente completa la sua esecuzione](/docs/it/tools-reference#when-a-background-command-stops). Claude Code imposta `backgroundEndsWithFinalResponse` su `true` su tali comandi, e omette il campo quando il comando sopravvive al turno, come i comandi avviati dalla conversazione principale o dai subagenti di background. Il campo richiede Claude Code v2.1.227 o successivo.4156Quando un subagent in esecuzione in primo piano possiede un comando in background, il comando [termina quando quel subagent completa la sua esecuzione](/docs/it/tools-reference#when-a-background-command-stops). Claude Code imposta `backgroundEndsWithFinalResponse` su `true` su tali comandi, e omette il campo quando il comando sopravvive al turno, come i comandi avviati dalla conversazione principale o dai subagent in background. Il campo richiede Claude Code v2.1.227 o successivo.

4151 4157 

4152Claude Code imposta `gitOperation.commit.branch` al ramo denominato nella riga di riepilogo del commit di git, e lo omette per un commit effettuato su un HEAD staccato. Il campo richiede Agent SDK v0.3.227 o successivo. Claude Code segnala un comando `gh pr reopen` come l'azione PR `reopened`, che richiede Agent SDK v0.3.234 o successivo.4158Claude Code imposta `gitOperation.commit.branch` al branch indicato nella riga di riepilogo del commit di git, e lo omette per un commit effettuato su un HEAD staccato. Il campo richiede Agent SDK v0.3.227 o successivo. Claude Code segnala un comando `gh pr reopen` come l'azione PR `reopened`, che richiede Agent SDK v0.3.234 o successivo.

4153 4159 

4154<h3 id="monitor-2">4160<h3 id="monitor-2">

4155 Monitor4161 Monitor

4156</h3>4162</h3>

4157 4163 

4158**Nome del tool:** `Monitor`4164**Nome dello strumento:** `Monitor`

4159 4165 

4160```typescript theme={null}4166```typescript theme={null}

4161type MonitorOutput = {4167type MonitorOutput = {


4165};4171};

4166```4172```

4167 4173 

4168Restituisce l'ID dell'attività di background per il monitor in esecuzione. Usa questo ID con `TaskStop` per annullare il watch in anticipo.4174Restituisce l'ID dell'attività in background per il monitor in esecuzione. Usa questo ID con `TaskStop` per annullare il watch in anticipo.

4169 4175 

4170<h3 id="edit-2">4176<h3 id="edit-2">

4171 Edit4177 Edit

4172</h3>4178</h3>

4173 4179 

4174**Nome del tool:** `Edit`4180**Nome dello strumento:** `Edit`

4175 4181 

4176```typescript theme={null}4182```typescript theme={null}

4177type FileEditOutput = {4183type FileEditOutput = {


4206 Read4212 Read

4207</h3>4213</h3>

4208 4214 

4209**Nome del tool:** `Read`4215**Nome dello strumento:** `Read`

4210 4216 

4211```typescript theme={null}4217```typescript theme={null}

4212type FileReadOutput =4218type FileReadOutput =


4218 numLines: number;4224 numLines: number;

4219 startLine: number;4225 startLine: number;

4220 totalLines: number;4226 totalLines: number;

4221 /** True quando una lettura di file intero è stata impaginata automaticamente perché ha superato il limite di token (il contenuto è una prima pagina parziale). */4227 /** True when a whole-file read was auto-paginated because it exceeded the token cap (the content is a partial first page). */

4222 truncatedByTokenCap?: boolean;4228 truncatedByTokenCap?: boolean;

4223 };4229 };

4224 }4230 }


4259 count: number;4265 count: number;

4260 outputDir: string;4266 outputDir: string;

4261 };4267 };

4262 /** Numero di pagina del documento della prima pagina estratta; etichetta le immagini della pagina nel contenuto tool_result. */4268 /** Document page number of the first extracted page; labels the page images in the tool_result content. */

4263 firstPage?: number;4269 firstPage?: number;

4264 /** Solo in-process: i byte dell'immagine della pagina vengono consegnati come blocchi di immagine nel contenuto tool_result e non vengono conservati nel tool_use_result emesso, quindi questa chiave è assente lì. */4270 /** In-process only: the page-image bytes are delivered as image blocks in the tool_result content and aren't retained on the emitted tool_use_result, so this key is absent there. */

4265 pages?: {4271 pages?: {

4266 base64: string;4272 base64: string;

4267 mediaType: "image/jpeg" | "image/png" | "image/gif" | "image/webp";4273 mediaType: "image/jpeg" | "image/png" | "image/gif" | "image/webp";


4273 file: {4279 file: {

4274 filePath: string;4280 filePath: string;

4275 };4281 };

4276 /** Impostato quando la dedup ha corrisposto a una voce seminata all'avvio (CLAUDE.md / memoria nidificata) piuttosto che a un precedente risultato tool_result di Read. */4282 /** Set when the dedup matched a startup-seeded entry (CLAUDE.md / nested memory) rather than a prior Read tool_result. */

4277 source?: "seeded";4283 source?: "seeded";

4278 };4284 };

4279```4285```


4284 Write4290 Write

4285</h3>4291</h3>

4286 4292 

4287**Nome del tool:** `Write`4293**Nome dello strumento:** `Write`

4288 4294 

4289```typescript theme={null}4295```typescript theme={null}

4290type FileWriteOutput = {4296type FileWriteOutput = {


4316 4322 

4317* Per un file appena creato, `originalFile` è null e `structuredPatch` è vuoto4323* Per un file appena creato, `originalFile` è null e `structuredPatch` è vuoto

4318* Su una sovrascrittura, `originalFile` contiene il contenuto precedente, tranne quando quel contenuto è più grande di circa 10 MB: Claude Code quindi salta il diff e restituisce `originalFile` null e `structuredPatch` vuoto4324* Su una sovrascrittura, `originalFile` contiene il contenuto precedente, tranne quando quel contenuto è più grande di circa 10 MB: Claude Code quindi salta il diff e restituisce `originalFile` null e `structuredPatch` vuoto

4319* `structuredPatch` è anche vuoto quando la scrittura non ha cambiato nulla o il diff è scaduto4325* `structuredPatch` è anche vuoto quando la scrittura non ha cambiato nulla o il diff è andato in timeout

4320 4326 

4321<h3 id="glob-2">4327<h3 id="glob-2">

4322 Glob4328 Glob

4323</h3>4329</h3>

4324 4330 

4325**Nome del tool:** `Glob`4331**Nome dello strumento:** `Glob`

4326 4332 

4327```typescript theme={null}4333```typescript theme={null}

4328type GlobOutput = {4334type GlobOutput = {


4343 Grep4349 Grep

4344</h3>4350</h3>

4345 4351 

4346**Nome del tool:** `Grep`4352**Nome dello strumento:** `Grep`

4347 4353 

4348```typescript theme={null}4354```typescript theme={null}

4349type GrepOutput = {4355type GrepOutput = {


4368 TaskStop4374 TaskStop

4369</h3>4375</h3>

4370 4376 

4371**Nome del tool:** `TaskStop`4377**Nome dello strumento:** `TaskStop`

4372 4378 

4373```typescript theme={null}4379```typescript theme={null}

4374type TaskStopOutput = {4380type TaskStopOutput = {


4379};4385};

4380```4386```

4381 4387 

4382Restituisce la conferma dopo l'interruzione dell'attività di background.4388Restituisce la conferma dopo l'interruzione dell'attività in background.

4383 4389 

4384<h3 id="notebookedit-2">4390<h3 id="notebookedit-2">

4385 NotebookEdit4391 NotebookEdit

4386</h3>4392</h3>

4387 4393 

4388**Nome del tool:** `NotebookEdit`4394**Nome dello strumento:** `NotebookEdit`

4389 4395 

4390```typescript theme={null}4396```typescript theme={null}

4391type NotebookEditOutput = {4397type NotebookEditOutput = {


4408 WebFetch4414 WebFetch

4409</h3>4415</h3>

4410 4416 

4411**Nome del tool:** `WebFetch`4417**Nome dello strumento:** `WebFetch`

4412 4418 

4413```typescript theme={null}4419```typescript theme={null}

4414type WebFetchOutput = {4420type WebFetchOutput = {


4428 4434 

4429Restituisce il contenuto recuperato con lo stato HTTP e i metadati.4435Restituisce il contenuto recuperato con lo stato HTTP e i metadati.

4430 4436 

4431`artifactRead` è il record proprio di Claude Code di una lettura di artifact, presente solo quando Claude ha recuperato un artifact che la sessione può pubblicare. Claude Code lo legge di nuovo quando una sessione riprende in modo che una successiva pubblicazione si basi sulla versione giusta; il tuo codice non ha bisogno di agire su di esso. `slug` nomina l'artifact, `ver` è la versione che la lettura ha messo in record ed è assente quando non ne ha registrata nessuna, e `seeded: false` contrassegna una lettura il cui codice sorgente completo non ha raggiunto Claude. Il campo `seeded` richiede Agent SDK v0.3.239 o successivo.4437`artifactRead` è il record proprio di Claude Code di una lettura di artefatto, presente solo quando Claude ha recuperato un artefatto su cui la sessione può pubblicare. Claude Code lo legge di nuovo quando una sessione riprende in modo che una successiva pubblicazione si basi sulla versione giusta; il tuo codice non ha bisogno di agire su di esso. `slug` nomina l'artefatto, `ver` è la versione che la lettura ha messo a registro ed è assente quando non ne ha registrata nessuna, e `seeded: false` contrassegna una lettura il cui codice sorgente completo non ha raggiunto Claude. Il campo `seeded` richiede Agent SDK v0.3.239 o successivo.

4432 4438 

4433<h3 id="websearch-2">4439<h3 id="websearch-2">

4434 WebSearch4440 WebSearch

4435</h3>4441</h3>

4436 4442 

4437**Nome del tool:** `WebSearch`4443**Nome dello strumento:** `WebSearch`

4438 4444 

4439```typescript theme={null}4445```typescript theme={null}

4440type WebSearchOutput = {4446type WebSearchOutput = {


4457 Workflow4463 Workflow

4458</h3>4464</h3>

4459 4465 

4460**Nome del tool:** `Workflow`4466**Nome dello strumento:** `Workflow`

4461 4467 

4462```typescript theme={null}4468```typescript theme={null}

4463type WorkflowOutput = {4469type WorkflowOutput = {


4469 summary?: string;4475 summary?: string;

4470 transcriptDir?: string;4476 transcriptDir?: string;

4471 scriptPath?: string;4477 scriptPath?: string;

4472 sessionUrl?: string; // impostato quando il workflow è stato avviato come sessione remota4478 sessionUrl?: string; // impostato quando il workflow è stato avviato come sessione cloud

4473 warning?: string;4479 warning?: string;

4474 error?: string;4480 error?: string;

4475};4481};

4476```4482```

4477 4483 

4478Restituisce immediatamente dopo che il tool accetta l'invocazione. Il risultato finale arriva successivamente come completamento di un'attività. Controlla `error` prima di trattare l'esecuzione come avviata: uno script che non supera il controllo della sintassi restituisce `status: "async_launched"` con `error` impostato e non viene mai eseguito.4484Restituisce immediatamente dopo che lo strumento accetta l'invocazione. Il risultato finale arriva successivamente come completamento di un'attività. Controlla `error` prima di trattare l'esecuzione come avviata: uno script che non supera il controllo della sintassi restituisce `status: "async_launched"` con `error` impostato e non viene mai eseguito.

4479 4485 

4480| Campo | Tipo | Descrizione |4486| Campo | Tipo | Descrizione |

4481| - | - | - |4487| - | - | - |

4482| `status` | `"async_launched" \| "remote_launched"` | Il tool ha accettato l'invocazione. `"async_launched"` per le esecuzioni in-process, `"remote_launched"` per le esecuzioni inviate a una sessione remota invece di essere eseguite in-process |4488| `status` | `"async_launched" \| "remote_launched"` | Lo strumento ha accettato l'invocazione. `"async_launched"` per le esecuzioni in-process, `"remote_launched"` per le esecuzioni inviate a una sessione cloud invece di essere eseguite in-process |

4483| `taskId` | `string` | Identificatore dell'attività di background per l'esecuzione |4489| `taskId` | `string` | Identificatore dell'attività in background per l'esecuzione |

4484| `taskType` | `"local_workflow" \| "remote_agent"` | Tipo di attività dell'attività di background registrata, corrispondente al ramo `status` |4490| `taskType` | `"local_workflow" \| "remote_agent"` | Tipo di attività dell'attività in background registrata, corrispondente al ramo `status` |

4485| `workflowName` | `string` | Il `meta.name` dallo script del workflow |4491| `workflowName` | `string` | Il `meta.name` dallo script del workflow |

4486| `runId` | `string` | Identificatore dell'esecuzione del workflow da passare come `resumeFromRunId` in una successiva invocazione. Assente per le esecuzioni `remote_launched`, dove l'URL della sessione cloud è l'handle di ripresa |4492| `runId` | `string` | Identificatore dell'esecuzione del workflow da passare come `resumeFromRunId` in una successiva invocazione. Assente per le esecuzioni `remote_launched`, dove l'URL della sessione cloud è l'handle di ripresa |

4487| `summary` | `string` | Descrizione in una riga di ciò che fa il workflow |4493| `summary` | `string` | Descrizione in una riga di ciò che fa il workflow |

4488| `transcriptDir` | `string` | Directory dove i transcript dei subagenti vengono scritti durante l'esecuzione |4494| `transcriptDir` | `string` | Directory dove le trascrizioni dei subagent vengono scritte durante l'esecuzione |

4489| `scriptPath` | `string` | Percorso dello script del workflow persistente per questa esecuzione. Modificalo e passalo come `scriptPath` per rieseguire senza inviare nuovamente lo script |4495| `scriptPath` | `string` | Percorso dello script del workflow persistente per questa esecuzione. Modificalo e passalo come `scriptPath` per rieseguire senza inviare nuovamente lo script |

4490| `sessionUrl` | `string` | URL della sessione cloud, impostato quando `status` è `"remote_launched"` |4496| `sessionUrl` | `string` | URL della sessione cloud, impostato quando `status` è `"remote_launched"` |

4491| `warning` | `string` | Avviso non bloccante, come lo stato git locale che diverge dal ramo spinto che una sessione cloud clonerà |4497| `warning` | `string` | Avviso non bloccante, come lo stato git locale che diverge dal branch inviato con push che una sessione cloud clonerà |

4492| `error` | `string` | Impostato quando lo script non supera il controllo della sintassi. Quando presente, l'esecuzione non è stata avviata nonostante lo stato di avvio |4498| `error` | `string` | Impostato quando lo script non supera il controllo della sintassi. Quando presente, l'esecuzione non è stata avviata nonostante lo stato di avvio |

4493 4499 

4494<h3 id="todowrite-2">4500<h3 id="todowrite-2">

4495 TodoWrite4501 TodoWrite

4496</h3>4502</h3>

4497 4503 

4498**Nome del tool:** `TodoWrite`4504**Nome dello strumento:** `TodoWrite`

4499 4505 

4500```typescript theme={null}4506```typescript theme={null}

4501type TodoWriteOutput = {4507type TodoWriteOutput = {


4534 TaskCreate4540 TaskCreate

4535</h3>4541</h3>

4536 4542 

4537**Nome del tool:** `TaskCreate`4543**Nome dello strumento:** `TaskCreate`

4538 4544 

4539```typescript theme={null}4545```typescript theme={null}

4540type TaskCreateOutput = {4546type TaskCreateOutput = {


4551 TaskUpdate4557 TaskUpdate

4552</h3>4558</h3>

4553 4559 

4554**Nome del tool:** `TaskUpdate`4560**Nome dello strumento:** `TaskUpdate`

4555 4561 

4556```typescript theme={null}4562```typescript theme={null}

4557type TaskUpdateOutput = {4563type TaskUpdateOutput = {


4572 TaskGet4578 TaskGet

4573</h3>4579</h3>

4574 4580 

4575**Nome del tool:** `TaskGet`4581**Nome dello strumento:** `TaskGet`

4576 4582 

4577```typescript theme={null}4583```typescript theme={null}

4578type TaskGetOutput = {4584type TaskGetOutput = {


4593 TaskList4599 TaskList

4594</h3>4600</h3>

4595 4601 

4596**Nome del tool:** `TaskList`4602**Nome dello strumento:** `TaskList`

4597 4603 

4598```typescript theme={null}4604```typescript theme={null}

4599type TaskListOutput = {4605type TaskListOutput = {


4613 ExitPlanMode4619 ExitPlanMode

4614</h3>4620</h3>

4615 4621 

4616**Nome del tool:** `ExitPlanMode`4622**Nome dello strumento:** `ExitPlanMode`

4617 4623 

4618```typescript theme={null}4624```typescript theme={null}

4619type ExitPlanModeOutput = {4625type ExitPlanModeOutput = {


4627};4633};

4628```4634```

4629 4635 

4630Restituisce lo stato del piano dopo l'uscita dalla modalità di pianificazione.4636Restituisce lo stato del piano dopo l'uscita dal plan mode.

4631 4637 

4632<h3 id="listmcpresources-2">4638<h3 id="listmcpresources-2">

4633 ListMcpResources4639 ListMcpResources

4634</h3>4640</h3>

4635 4641 

4636**Nome del tool:** `ListMcpResourcesTool`4642**Nome dello strumento:** `ListMcpResourcesTool`

4637 4643 

4638```typescript theme={null}4644```typescript theme={null}

4639type ListMcpResourcesOutput = Array<{4645type ListMcpResourcesOutput = Array<{


4651 ReadMcpResource4657 ReadMcpResource

4652</h3>4658</h3>

4653 4659 

4654**Nome del tool:** `ReadMcpResourceTool`4660**Nome dello strumento:** `ReadMcpResourceTool`

4655 4661 

4656```typescript theme={null}4662```typescript theme={null}

4657type ReadMcpResourceOutput = {4663type ReadMcpResourceOutput = {


4671 EnterWorktree4677 EnterWorktree

4672</h3>4678</h3>

4673 4679 

4674**Nome del tool:** `EnterWorktree`4680**Nome dello strumento:** `EnterWorktree`

4675 4681 

4676```typescript theme={null}4682```typescript theme={null}

4677type EnterWorktreeOutput = {4683type EnterWorktreeOutput = {


4687 ExitWorktree4693 ExitWorktree

4688</h3>4694</h3>

4689 4695 

4690**Nome del tool:** `ExitWorktree`4696**Nome dello strumento:** `ExitWorktree`

4691 4697 

4692```typescript theme={null}4698```typescript theme={null}

4693type ExitWorktreeOutput = {4699type ExitWorktreeOutput = {


4708 EnterPlanMode4714 EnterPlanMode

4709</h3>4715</h3>

4710 4716 

4711**Nome del tool:** `EnterPlanMode`4717**Nome dello strumento:** `EnterPlanMode`

4712 4718 

4713```typescript theme={null}4719```typescript theme={null}

4714type EnterPlanModeOutput = {4720type EnterPlanModeOutput = {


4716};4722};

4717```4723```

4718 4724 

4719Restituisce una conferma che la modalità di pianificazione è stata attivata.4725Restituisce una conferma che il plan mode è stato attivato.

4720 4726 

4721<h3 id="croncreate-2">4727<h3 id="croncreate-2">

4722 CronCreate4728 CronCreate

4723</h3>4729</h3>

4724 4730 

4725**Nome del tool:** `CronCreate`4731**Nome dello strumento:** `CronCreate`

4726 4732 

4727```typescript theme={null}4733```typescript theme={null}

4728type CronCreateOutput = {4734type CronCreateOutput = {


4739 CronDelete4745 CronDelete

4740</h3>4746</h3>

4741 4747 

4742**Nome del tool:** `CronDelete`4748**Nome dello strumento:** `CronDelete`

4743 4749 

4744```typescript theme={null}4750```typescript theme={null}

4745type CronDeleteOutput = {4751type CronDeleteOutput = {


4753 CronList4759 CronList

4754</h3>4760</h3>

4755 4761 

4756**Nome del tool:** `CronList`4762**Nome dello strumento:** `CronList`

4757 4763 

4758```typescript theme={null}4764```typescript theme={null}

4759type CronListOutput = {4765type CronListOutput = {


4774 ScheduleWakeup4780 ScheduleWakeup

4775</h3>4781</h3>

4776 4782 

4777**Nome del tool:** `ScheduleWakeup`4783**Nome dello strumento:** `ScheduleWakeup`

4778 4784 

4779```typescript theme={null}4785```typescript theme={null}

4780type ScheduleWakeupOutput = {4786type ScheduleWakeupOutput = {


4792 RemoteTrigger4798 RemoteTrigger

4793</h3>4799</h3>

4794 4800 

4795**Nome del tool:** `RemoteTrigger`4801**Nome dello strumento:** `RemoteTrigger`

4796 4802 

4797```typescript theme={null}4803```typescript theme={null}

4798type RemoteTriggerOutput = {4804type RemoteTriggerOutput = {


4808 PushNotification4814 PushNotification

4809</h3>4815</h3>

4810 4816 

4811**Nome del tool:** `PushNotification`4817**Nome dello strumento:** `PushNotification`

4812 4818 

4813```typescript theme={null}4819```typescript theme={null}

4814type PushNotificationOutput = {4820type PushNotificationOutput = {


4826 ReportFindings4832 ReportFindings

4827</h3>4833</h3>

4828 4834 

4829**Nome del tool:** `ReportFindings`4835**Nome dello strumento:** `ReportFindings`

4830 4836 

4831```typescript theme={null}4837```typescript theme={null}

4832type ReportFindingsOutput = {4838type ReportFindingsOutput = {


4851 Artifact4857 Artifact

4852</h3>4858</h3>

4853 4859 

4854**Nome del tool:** `Artifact`4860**Nome dello strumento:** `Artifact`

4855 4861 

4856```typescript theme={null}4862```typescript theme={null}

4857type ArtifactOutput =4863type ArtifactOutput =


4878 rel?: "mine" | "shared";4884 rel?: "mine" | "shared";

4879 }>;4885 }>;

4880 truncated?: boolean;4886 truncated?: boolean;

4887 total?: number;

4888 total_at_least?: true;

4881 scope?: "shared" | "all";4889 scope?: "shared" | "all";

4882 };4890 };

4883```4891```

4884 4892 

4885Restituisce l'`url` della pagina pubblicata e il `path` locale che è stato pubblicato per l'azione di pubblicazione, con `updated` impostato su true quando la pubblicazione ha ridistribuito un artifact esistente, e `warnings` che contiene eventuali avvisi al momento della pubblicazione. L'azione di elenco restituisce invece le righe `artifacts`, con `truncated` impostato quando esistono più artifact del limite richiesto. Negli elenchi il cui ambito non è `"mine"`, ogni riga contiene `rel` che contrassegna se l'utente possiede l'artifact o se è stato condiviso con loro, e l'`scope` dell'output registra quale ambito non predefinito ha prodotto l'elenco; entrambi sono assenti negli elenchi predefiniti.4893Restituisce l'`url` della pagina pubblicata e il `path` locale che è stato pubblicato per l'azione di pubblicazione, con `updated` impostato su true quando la pubblicazione ha ridistribuito un artefatto esistente, e `warnings` che contiene eventuali avvisi al momento della pubblicazione. L'azione di elenco restituisce invece le righe `artifacts`, con `truncated` impostato quando esistono più artefatti del limite richiesto. Negli elenchi il cui ambito non è `"mine"`, ogni riga contiene `rel` che contrassegna se l'utente possiede l'artefatto o se è stato condiviso con lui, e lo `scope` dell'output registra quale ambito non predefinito ha prodotto l'elenco; entrambi sono assenti negli elenchi predefiniti.

4894 

4895Un risultato di elenco riporta anche `total`, il numero di artefatti che corrispondono all'ambito elencato, inclusi quelli oltre `limit`. Quando `total_at_least` è impostato, quel numero è un limite inferiore e potrebbero esistere altri artefatti. Entrambi i campi richiedono Agent SDK v0.3.292 o successivo.

4886 4896 

4887<h3 id="projects-2">4897<h3 id="projects-2">

4888 Projects4898 Projects

4889</h3>4899</h3>

4890 4900 

4891**Nome del tool:** `Projects`4901**Nome dello strumento:** `Projects`

4892 4902 

4893```typescript theme={null}4903```typescript theme={null}

4894type ProjectsOutput =4904type ProjectsOutput =


4946 };4956 };

4947```4957```

4948 4958 

4949Discriminato sul campo `method`, rispecchiando l'input. `project_read` restituisce piccoli documenti di testo inline in `content` e scrive documenti più grandi in un percorso `local_file` invece; `project_search` restituisce `hits` RAG con `rag: true` quando l'indice del progetto è disponibile e ricade su un elenco di percorsi `docs` altrimenti.4959Discriminato sul campo `method`, rispecchiando l'input. `project_read` restituisce piccoli documenti di testo inline in `content` e scrive invece documenti più grandi in un percorso `local_file`; `project_search` restituisce `hits` RAG con `rag: true` quando l'indice del progetto è disponibile e altrimenti ricade su un elenco di percorsi `docs`.

4950 4960 

4951<h3 id="readmcpresourcedir-2">4961<h3 id="readmcpresourcedir-2">

4952 ReadMcpResourceDir4962 ReadMcpResourceDir

4953</h3>4963</h3>

4954 4964 

4955**Nome del tool:** `ReadMcpResourceDirTool`4965**Nome dello strumento:** `ReadMcpResourceDirTool`

4956 4966 

4957```typescript theme={null}4967```typescript theme={null}

4958type ReadMcpResourceDirOutput = {4968type ReadMcpResourceDirOutput = {


4965};4975};

4966```4976```

4967 4977 

4968Restituisce i figli diretti della risorsa directory. Le sottodirectory appaiono con mimeType `"inode/directory"`; `error` contiene un messaggio leggibile quando il server non poteva elencare la directory.4978Restituisce i figli diretti della risorsa directory. Le sottodirectory appaiono con mimeType `"inode/directory"`; `error` contiene un messaggio leggibile quando il server non è riuscito a elencare la directory.

4969 4979 

4970<h3 id="refreshmcptools-2">4980<h3 id="refreshmcptools-2">

4971 RefreshMcpTools4981 RefreshMcpTools

4972</h3>4982</h3>

4973 4983 

4974**Nome del tool:** `RefreshMcpTools`4984**Nome dello strumento:** `RefreshMcpTools`

4975 4985 

4976```typescript theme={null}4986```typescript theme={null}

4977type RefreshMcpToolsOutput = Array<{4987type RefreshMcpToolsOutput = Array<{


4984}>;4994}>;

4985```4995```

4986 4996 

4987Restituisce una voce per server: `refreshed` significa che l'elenco degli strumenti ri-interrogato è stato applicato, `error` significa che la ri-interrogazione non è riuscita e il set di strumenti precedente è stato mantenuto, e `not_connected` significa che il server non ha una connessione live per interrogare.4997Restituisce una voce per server: `refreshed` significa che l'elenco degli strumenti ri-interrogato è stato applicato, `error` significa che la ri-interrogazione non è riuscita e il set di strumenti precedente è stato mantenuto, e `not_connected` significa che il server non ha una connessione attiva da interrogare.

4988 4998 

4989<h3 id="showonboardingrolepicker-2">4999<h3 id="showonboardingrolepicker-2">

4990 ShowOnboardingRolePicker5000 ShowOnboardingRolePicker

4991</h3>5001</h3>

4992 5002 

4993**Nome del tool:** `ShowOnboardingRolePicker`5003**Nome dello strumento:** `ShowOnboardingRolePicker`

4994 5004 

4995```typescript theme={null}5005```typescript theme={null}

4996type ShowOnboardingRolePickerOutput = {5006type ShowOnboardingRolePickerOutput = {


5005 McpOutput5015 McpOutput

5006</h3>5016</h3>

5007 5017 

5008**Nome del tool:** nomi di tool MCP dinamici della forma `mcp__<server>__<tool>`5018**Nome dello strumento:** nomi di strumenti MCP dinamici della forma `mcp__<server>__<tool>`

5009 5019 

5010```typescript theme={null}5020```typescript theme={null}

5011type McpOutput =5021type McpOutput =

agent-teams.md +2 −0

Details

1593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando è impostato su qualsiasi cosa diversa da `inherit`.1593. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando è impostato su qualsiasi cosa diversa da `inherit`.

1604. Il modello attuale del lead.1604. Il modello attuale del lead.

161 161 

162Se un [mod](/docs/it/plugins/mods/overview) installato imposta un modello nel suo hook [`agent.spawn`](/docs/it/plugins/mods/reference#subagents), Claude Code utilizza quel modello al posto della prima fonte.

163 

162Se impostate [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/it/sub-agents#run-every-subagent-on-one-model), le prime due fonti non si applicano. Claude Code sceglie il modello di ogni compagno di team da `CLAUDE_CODE_SUBAGENT_MODEL` quando è impostato su qualsiasi cosa diversa da `inherit`, e dal modello attuale del lead altrimenti. Richiede Claude Code versione 2.1.257 o successiva.164Se impostate [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`](/docs/it/sub-agents#run-every-subagent-on-one-model), le prime due fonti non si applicano. Claude Code sceglie il modello di ogni compagno di team da `CLAUDE_CODE_SUBAGENT_MODEL` quando è impostato su qualsiasi cosa diversa da `inherit`, e dal modello attuale del lead altrimenti. Richiede Claude Code versione 2.1.257 o successiva.

163 165 

164Prima della versione 2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` veniva per primo in questo ordine.166Prima della versione 2.1.251, `CLAUDE_CODE_SUBAGENT_MODEL` veniva per primo in questo ordine.

agent-view.md +12 −7

Details

226 226 

227Digita una risposta nel pannello peek e premi `Enter` per inviarla a quella sessione. Anteponi `!` a una risposta per inviare invece un comando Bash. Cosa succede alla risposta dipende dalla sessione e da cosa invii:227Digita una risposta nel pannello peek e premi `Enter` per inviarla a quella sessione. Anteponi `!` a una risposta per inviare invece un comando Bash. Cosa succede alla risposta dipende dalla sessione e da cosa invii:

228 228 

229* Una sessione che sta lavorando: la risposta entra nella [coda dei messaggi](/docs/it/interactive-mode#queue-messages-while-claude-works) della sessione invece di interrompere la risposta in corso, e ha effetto [quando lo ha l'input in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued). Un [comando](/docs/it/commands) attende la fine del turno, anche uno che viene eseguito non appena lo digiti nel prompt della sessione stessa229* Una sessione che sta lavorando: `/model`, `/effort`, `/rename` e `/usage` vengono eseguiti subito. Le altre risposte entrano nella [coda dei messaggi](/docs/it/interactive-mode#queue-messages-while-claude-works) della sessione invece di interrompere la risposta in corso, e hanno effetto [quando lo ha l'input in coda](/docs/it/interactive-mode#when-claude-code-sends-what-you-queued). Gli altri [comandi](/docs/it/commands) attendono la fine del turno, anche quelli che vengono eseguiti non appena li digiti nel prompt della sessione stessa

230* Una risposta che è esattamente `/stop`: ferma subito la sessione invece di esserle consegnata, sia che la sessione stia lavorando sia che ti stia aspettando230* Una risposta che è esattamente `/stop`: ferma subito la sessione invece di esserle consegnata, sia che la sessione stia lavorando sia che ti stia aspettando

231* Un [job di shell](#run-a-shell-command): la risposta, `/stop` incluso, va al terminale del comando come input digitato231* Un [job di shell](#run-a-shell-command): la risposta, `/stop` incluso, va al terminale del comando come input digitato

232 232 


238 238 

239Quando un hook [`PermissionRequest`](/docs/it/hooks#permissionrequest) o [`PreToolUse`](/docs/it/hooks#pretooluse) restituisce un output che Claude Code non riesce a convalidare per la chiamata di cui la sessione chiede conferma, la riga mostra l'evento dell'hook e `hook output invalid:` con l'errore di convalida prima del testo della richiesta in sospeso. Per un hook che fallisce in un altro modo, la riga indica che l'hook non è riuscito. La sessione continua ad attendere la stessa richiesta.239Quando un hook [`PermissionRequest`](/docs/it/hooks#permissionrequest) o [`PreToolUse`](/docs/it/hooks#pretooluse) restituisce un output che Claude Code non riesce a convalidare per la chiamata di cui la sessione chiede conferma, la riga mostra l'evento dell'hook e `hook output invalid:` con l'errore di convalida prima del testo della richiesta in sospeso. Per un hook che fallisce in un altro modo, la riga indica che l'hook non è riuscito. La sessione continua ad attendere la stessa richiesta.

240 240 

241Una risposta che non può essere consegnata, perché il servizio in background non è raggiungibile o l'invio non riesce, viene salvata e inviata alla sessione come suo prossimo prompt quando il suo processo si riavvia, e il messaggio di errore indica che la risposta è stata salvata. Una risposta con il prefisso `!` non viene salvata, perché il testo salvato raggiungerebbe la sessione come un semplice prompt anziché essere eseguito come comando Bash.241Quando una risposta non può essere consegnata, il messaggio di errore indica se è stata salvata. Una risposta con il prefisso `!` o `/` non viene mai salvata. Claude Code invia una risposta salvata come prossimo prompt della sessione la prossima volta che riavvii la sessione; invia di nuovo qualsiasi altra risposta.

242 242 

243Con la [dettatura vocale](/docs/it/voice-dictation) attivata in [modalità hold](/docs/it/voice-dictation#hold-to-record), tieni premuto il tasto push-to-talk mentre il campo di risposta ha il focus per dettare una risposta invece di digitarla. Lo stesso funziona nel campo di dispatch in fondo ad agent view.243Con la [dettatura vocale](/docs/it/voice-dictation) attivata in [modalità hold](/docs/it/voice-dictation#hold-to-record), tieni premuto il tasto push-to-talk mentre il campo di risposta ha il focus per dettare una risposta invece di digitarla. Lo stesso funziona nel campo di dispatch in fondo ad agent view.

244 244 


288 288 

289Anche la riga da cui hai premuto `←` mantiene un nome in grassetto e non attenuato dopo che sposti la selezione con i tasti freccia o il mouse, così puoi capire da quale sessione provieni.289Anche la riga da cui hai premuto `←` mantiene un nome in grassetto e non attenuato dopo che sposti la selezione con i tasti freccia o il mouse, così puoi capire da quale sessione provieni.

290 290 

291Se uno strumento è in esecuzione quando premi `←`, Claude Code attende fino a circa dieci secondi che termini prima di mettere la sessione in background, e Claude continua la risposta nella sessione in background. Premi di nuovo `←` per metterla subito in background invece di attendere. Quando il lavoro in corso non può essere trasferito alla sessione in background, Claude Code mostra prima la finestra di dialogo `Background this session?`, come con [`/background`](#from-inside-a-session).291Se uno strumento è in esecuzione quando premi `←`, Claude Code attende che termini prima di mettere la sessione in background, e Claude continua la risposta nella sessione in background. Premi di nuovo `←` per metterla subito in background invece di attendere. Quando il lavoro in corso non può essere trasferito alla sessione in background, Claude Code mostra prima la finestra di dialogo `Background this session?`, come con [`/background`](#from-inside-a-session).

292 292 

293Il limite di dieci secondi non si applica mentre i [subagent in primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background) che Claude ha avviato nella conversazione sono ancora in esecuzione. Claude Code continua ad attendere affinché il loro lavoro venga trasferito, e mostra l'avviso `Still backgrounding after the current tool` durante l'attesa. Premi di nuovo `←` per mettere la sessione in background senza attendere, il che riavvia quei subagent dall'inizio. Claude Code non attende i subagent eseguiti da un [workflow dinamico](/docs/it/workflows). Quando un workflow ha subagent in esecuzione, Claude Code mostra invece la finestra di dialogo `Background this session?`.293Dopo circa dieci secondi, Claude Code mette la sessione in background senza attendere oltre, tranne in casi come questi:

294 294 

295Claude Code non mette la sessione in background mentre hai testo non inviato nel campo del prompt, perché il testo rimane nella casella di input del terminale e non verrebbe spostato nella sessione in background. Se digiti nel campo mentre Claude Code attende di mettere la sessione in background, annulla il cambio con `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`295* **I subagent in primo piano sono ancora in esecuzione**: Claude Code continua ad attendere affinché il lavoro dei [subagent in primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background) avviati da Claude venga trasferito, e mostra `Still backgrounding after the current tool`. Premi di nuovo `←` per mettere la sessione in background senza attendere, il che riavvia quei subagent dall'inizio.

296* **Una richiesta di permesso o una domanda attende la tua risposta**: mentre una richiesta di permesso o una domanda posta da Claude è in attesa, Claude Code continua ad attendere e mostra `Still backgrounding after the current tool — a question is waiting for your answer.`

297* **Digiti nel campo del prompt**: Claude Code annulla il cambio, perché il testo non inviato rimane nella casella di input del terminale e non verrebbe spostato nella sessione in background. Mostra `Backgrounding cancelled — you have unsent text in the input. Send it or clear it, then press ← again.`

298* **Un messaggio in coda non può essere spostato**: i messaggi che hai [messo in coda mentre Claude stava lavorando](/docs/it/interactive-mode#queue-messages-while-claude-works) si spostano nella sessione in background insieme alla conversazione. Quando uno di essi non può farlo, la sessione rimane in primo piano e Claude Code mostra un avviso come `Cannot open agents — 1 queued message can't move to the background. Press ← again once Claude has read it.`

296 299 

297Premere `←` crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi `→` vi ritorna comunque.300Premere `←` crea la riga della sessione anche quando la conversazione non ha ancora messaggi, quindi `→` vi ritorna comunque.

298 301 


876 879 

877Ogni sessione è il suo proprio processo Claude Code sotto il supervisor, e ciò che accade a quel processo dipende dallo stato della sessione:880Ogni sessione è il suo proprio processo Claude Code sotto il supervisor, e ciò che accade a quel processo dipende dallo stato della sessione:

878 881 

879* **In esecuzione, in pausa su una richiesta di permesso o un'altra finestra di dialogo, o collegato**: il processo continua a funzionare. Un subagent, workflow o monitor in esecuzione conta come in esecuzione.882* **In esecuzione, in pausa su una richiesta di permesso o un'altra finestra di dialogo, o collegato**: il processo continua a funzionare. Un subagent, workflow o monitor in esecuzione conta come in esecuzione, così come un'[attività pianificata con ambito di sessione](/docs/it/scheduled-tasks) in sospeso, ad esempio un risveglio di `/loop`.

880* **Terminato o in attesa del tuo prossimo messaggio, e scollegato per circa un'ora**: il supervisor ferma il processo per liberare risorse. Una sessione che ha terminato il suo turno chiedendoti una domanda conta come in attesa del tuo prossimo messaggio. La conversazione rimane su disco, e la prossima volta che ti colleghi o rispondi, la sessione riprende da dove l'ha lasciata. Fissa una sessione con `Ctrl+T` per mantenere il suo processo in esecuzione.883* **Terminato o in attesa del tuo prossimo messaggio, e scollegato per circa un'ora**: il supervisor ferma il processo per liberare risorse. Una sessione che ha terminato il suo turno chiedendoti una domanda conta come in attesa del tuo prossimo messaggio. La conversazione rimane su disco, e la prossima volta che ti colleghi o rispondi, la sessione riprende da dove l'ha lasciata. Fissa una sessione con `Ctrl+T` per mantenere il suo processo in esecuzione.

881* **Uscito inaspettatamente mentre il supervisor è in esecuzione**: il supervisor riavvia il processo. Terminare una sessione che hai messo in background tu stesso con `←` o `/background`, ad esempio con `kill`, la contrassegna come fermata invece di riavviarla. Per le sessioni che sono terminate con un arresto, vedi [Le sessioni vengono visualizzate come non riuscite o fermate dopo l'arresto](#sessions-show-as-failed-after-shutdown).884* **Uscito inaspettatamente mentre il supervisor è in esecuzione**: il supervisor riavvia il processo. Terminare una sessione che hai messo in background tu stesso con `←` o `/background`, ad esempio con `kill`, la contrassegna come fermata invece di riavviarla. Per le sessioni che sono terminate con un arresto, vedi [Le sessioni vengono visualizzate come non riuscite o fermate dopo l'arresto](#sessions-show-as-failed-after-shutdown).

882* **Dopo un aggiornamento automatico**: il supervisor riavvia se stesso sulla nuova versione e sposta le sessioni inattive in background. Le sessioni che sono in esecuzione, in attesa di te, o collegate non vengono interrotte.885* **Dopo un aggiornamento automatico**: il supervisor riavvia se stesso sulla nuova versione e sposta le sessioni inattive in background. Le sessioni che sono in esecuzione, in attesa di te, o collegate non vengono interrotte.


970* Un terminale dove hai ripreso la conversazione, ad esempio con `claude --resume` o `/resume`: la riga mostra `Open in a terminal` con un suggerimento per continuarla lì, e aprire la riga mostra `Can't open — this session is running in another terminal`. Continua in quel terminale, o esci da esso e apri di nuovo la riga.973* Un terminale dove hai ripreso la conversazione, ad esempio con `claude --resume` o `/resume`: la riga mostra `Open in a terminal` con un suggerimento per continuarla lì, e aprire la riga mostra `Can't open — this session is running in another terminal`. Continua in quel terminale, o esci da esso e apri di nuovo la riga.

971* Un altro processo Claude Code non interattivo, ad esempio un processo di sessione in background per la stessa conversazione che non è ancora uscito: aprire la riga mostra `This conversation is already open in another running Claude session`. Usa quel processo, o aspetta che esca e apri di nuovo la riga.974* Un altro processo Claude Code non interattivo, ad esempio un processo di sessione in background per la stessa conversazione che non è ancora uscito: aprire la riga mostra `This conversation is already open in another running Claude session`. Usa quel processo, o aspetta che esca e apri di nuovo la riga.

972 975 

973Claude Code salva una risposta che hai digitato con il tentativo rifiutato e la invia la prossima volta che la sessione si avvia.976Claude Code salva una risposta che hai digitato con il tentativo rifiutato, tranne una preceduta da `!` o `/`, e la invia la prossima volta che la sessione si avvia.

974 977 

975<h3 id="opening-a-session-says-it-has-no-saved-transcript">978<h3 id="opening-a-session-says-it-has-no-saved-transcript">

976 L'apertura di una sessione dice che non ha trascrizione salvata979 L'apertura di una sessione dice che non ha trascrizione salvata


1093| Versione | Cambiamento |1096| Versione | Cambiamento |

1094| - | - |1097| - | - |

1095| v2.1.290 | [`claude attach` e `claude logs`](#manage-sessions-from-the-shell) possono accettare parte del nome di una sessione in esecuzione al posto dell'ID. |1098| v2.1.290 | [`claude attach` e `claude logs`](#manage-sessions-from-the-shell) possono accettare parte del nome di una sessione in esecuzione al posto dell'ID. |

1099| v2.1.290 | `/model`, `/effort`, `/rename` e `/usage` inviati come [risposta dal pannello peek](#peek-and-reply) a una sessione al lavoro vengono eseguiti subito. |

1100| v2.1.290 | Una [risposta dal pannello peek](#peek-and-reply) che non può essere consegnata non viene più salvata per il riavvio successivo quando inizia con `/`, o quando risponde a una domanda con scelte predefinite mentre il processo della sessione è in esecuzione. |

1096| v2.1.288 | `Ctrl+F` trova le sessioni per nome, e `Alt+↑` / `Alt+↓` saltano tra le intestazioni dei gruppi. Entrambe, e `Ctrl+R`, possono essere [riassegnate](/docs/it/keybindings#agents-actions). |1101| v2.1.288 | `Ctrl+F` trova le sessioni per nome, e `Alt+↑` / `Alt+↓` saltano tra le intestazioni dei gruppi. Entrambe, e `Ctrl+R`, possono essere [riassegnate](/docs/it/keybindings#agents-actions). |

1097| v2.1.287 | Il [filtro `n:<text>`](#filter-sessions) trova le sessioni per nome o per primo prompt. Mentre un qualsiasi filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e la prima corrispondenza viene selezionata, quindi `Enter` la apre. |1102| v2.1.287 | Il [filtro `n:<text>`](#filter-sessions) trova le sessioni per nome o per primo prompt. Mentre un qualsiasi filtro è attivo, i gruppi che hai compresso si espandono per mostrare le loro corrispondenze e la prima corrispondenza viene selezionata, quindi `Enter` la apre. |

1098| v2.1.287 | Un comando inviato come [risposta dal pannello peek](#peek-and-reply) viene eseguito al termine del turno corrente della sessione, inclusi i comandi che vengono eseguiti non appena li digiti nel prompt della sessione stessa. Una risposta che è esattamente `/stop` arresta immediatamente la sessione. |1103| v2.1.287 | Un comando inviato come [risposta dal pannello peek](#peek-and-reply) viene eseguito al termine del turno corrente della sessione, inclusi i comandi che vengono eseguiti non appena li digiti nel prompt della sessione stessa. Una risposta che è esattamente `/stop` arresta immediatamente la sessione. |

amazon-bedrock.md +49 −12

Details

136 2. Configurare le credenziali AWS136 2. Configurare le credenziali AWS

137</h3>137</h3>

138 138 

139Claude Code utilizza la catena di credenziali predefinita dell'SDK AWS. Configurare le credenziali utilizzando uno di questi metodi:139Claude Code utilizza la catena di credenziali predefinita dell'SDK AWS. Se la macchina fornisce già credenziali a quella catena, come un profilo di istanza Amazon EC2 o le credenziali di attività Amazon ECS, passa direttamente al [passaggio 3](#3-configure-claude-code).

140 140 

141**Opzione A: Configurazione AWS CLI**141AWS [sconsiglia di utilizzare le chiavi di accesso di un utente IAM](https://docs.aws.amazon.com/cli/latest/userguide/cli-authentication-user.html) quando sviluppi software dedicato o lavori con dati reali. Configura le credenziali con uno di questi metodi:

142 

143* [`aws configure`](#use-aws-configure): salva la chiave di accesso di un utente IAM in un profilo nella directory `~/.aws`

144* [Variabili d'ambiente della chiave di accesso](#export-an-access-key): imposta una chiave di accesso, o credenziali temporanee con un token di sessione, solo nella shell corrente

145* [Profilo SSO](#use-an-sso-profile): accedi tramite IAM Identity Center nel browser e ottieni credenziali temporanee. Usa questo metodo se accedi al tuo account AWS tramite IAM Identity Center.

146* [Credenziali della console di gestione AWS](#use-aws-management-console-credentials): accedi tramite il browser con le credenziali della console di gestione AWS e ottieni credenziali temporanee. AWS [consiglia questo metodo](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) se accedi al tuo account AWS come utente root, come utente IAM o tramite federazione con IAM.

147* [Chiave API di Amazon Bedrock](#use-an-amazon-bedrock-api-key): esegui l'autenticazione con un bearer token che funziona solo per Amazon Bedrock, invece delle credenziali AWS

148 

149<h4 id="use-aws-configure">

150 Usa `aws configure`

151</h4>

152 

153Esegui `aws configure` e inserisci l'ID della chiave di accesso, la chiave di accesso segreta e la regione predefinita quando richiesto:

142 154 

143```bash theme={null}155```bash theme={null}

144aws configure156aws configure

145```157```

146 158 

147**Opzione B: Variabili di ambiente (chiave di accesso)**159La AWS CLI salva la chiave nel profilo `default` in `~/.aws/credentials`, da dove la catena di credenziali la legge.

160 

161<h4 id="export-an-access-key">

162 Esporta una chiave di accesso

163</h4>

164 

165Esporta la chiave di accesso come variabili d'ambiente. `AWS_SESSION_TOKEN` è richiesto solo con credenziali temporanee, quindi ometti quella riga se la chiave di accesso appartiene a un utente IAM:

148 166 

149```bash theme={null}167```bash theme={null}

150export AWS_ACCESS_KEY_ID=your-access-key-id168export AWS_ACCESS_KEY_ID=your-access-key-id


152export AWS_SESSION_TOKEN=your-session-token170export AWS_SESSION_TOKEN=your-session-token

153```171```

154 172 

155**Opzione C: Variabili di ambiente (profilo SSO)**173<h4 id="use-an-sso-profile">

174 Usa un profilo SSO

175</h4>

156 176 

157Sostituire `your-profile-name` con il nome del profilo AWS prima di eseguire questi comandi.177Crea un profilo con `aws configure sso` se non ne hai uno. Poi accedi a IAM Identity Center e imposta `AWS_PROFILE` in modo che la catena di credenziali utilizzi quel profilo. Sostituisci `your-profile-name` con il nome del tuo profilo AWS prima di eseguire questi comandi.

158 178 

159```bash theme={null}179```bash theme={null}

160aws sso login --profile=your-profile-name180aws sso login --profile=your-profile-name


164 184 

165Claude Code richiede credenziali di ruolo dalla regione IAM Identity Center denominata da `sso_region` del profilo, che non deve corrispondere alla regione in cui si esegue Amazon Bedrock. Nella versione 2.1.207, la regione di Amazon Bedrock ha sovrascritto `sso_region`, quindi un profilo la cui istanza di IAM Identity Center si trova in una regione diversa non è riuscito ad autenticarsi con un errore `Session token not found or invalid`.185Claude Code richiede credenziali di ruolo dalla regione IAM Identity Center denominata da `sso_region` del profilo, che non deve corrispondere alla regione in cui si esegue Amazon Bedrock. Nella versione 2.1.207, la regione di Amazon Bedrock ha sovrascritto `sso_region`, quindi un profilo la cui istanza di IAM Identity Center si trova in una regione diversa non è riuscito ad autenticarsi con un errore `Session token not found or invalid`.

166 186 

167**Opzione D: Credenziali della console di gestione AWS**187<h4 id="use-aws-management-console-credentials">

188 Usa le credenziali della console di gestione AWS

189</h4>

190 

191Il comando `aws login` richiede la AWS CLI 2.32.0 o successiva. Per la policy IAM di cui la tua identità ha bisogno, consulta le [istruzioni di AWS per `aws login`](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html).

192 

193Esegui il comando per accedere tramite il browser con le credenziali della console di gestione AWS:

168 194 

169```bash theme={null}195```bash theme={null}

170aws login196aws login

171```197```

172 198 

173[Ulteriori informazioni](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html) su `aws login`.199La sessione è valida per un massimo di 12 ore, dopodiché devi eseguire di nuovo `aws login`.

200 

201<h4 id="use-an-amazon-bedrock-api-key">

202 Usa una chiave API di Amazon Bedrock

203</h4>

204 

205Una chiave API di Amazon Bedrock è un bearer token che autentica le tue richieste al posto delle credenziali AWS. AWS rilascia [due tipi di chiave](https://docs.aws.amazon.com/bedrock/latest/userguide/api-keys.html):

174 206 

175**Opzione E: Chiavi API di Amazon Bedrock**207* **Chiavi a breve termine**: durano fino a 12 ore. AWS le preferisce alle chiavi a lungo termine per gli ambienti di produzione.

208* **Chiavi a lungo termine**: durano fino a una data di scadenza da te impostata. AWS le consiglia solo per l'esplorazione.

209 

210Esporta la chiave come `AWS_BEARER_TOKEN_BEDROCK`:

176 211 

177```bash theme={null}212```bash theme={null}

178export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key213export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

179```214```

180 215 

181Le chiavi API di Amazon Bedrock forniscono un metodo di autenticazione più semplice senza la necessità di credenziali AWS complete. [Ulteriori informazioni sulle chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).216Quando `AWS_BEARER_TOKEN_BEDROCK` è impostata, Claude Code esegue l'autenticazione con la chiave e non risolve la catena di credenziali, anche se sono presenti altre credenziali AWS. [Ulteriori informazioni sulle chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/).

182 217 

183<h4 id="credential-caching-and-resolution-timeout">218<h4 id="credential-caching-and-resolution-timeout">

184 Caching delle credenziali e timeout di risoluzione219 Caching delle credenziali e timeout di risoluzione


186 221 

187Claude Code risolve la catena del provider di credenziali predefinito AWS una volta e mantiene le credenziali risolte in memoria. Le riutilizza fino a cinque minuti prima della scadenza, o per un'ora quando non hanno scadenza, quindi un profilo supportato da SSO richiede credenziali da IAM Identity Center circa una volta per durata della credenziale. Un errore di credenziale dall'API cancella la cache e il nuovo tentativo risolve credenziali aggiornate. Richiede Claude Code v2.1.207 o successiva.222Claude Code risolve la catena del provider di credenziali predefinito AWS una volta e mantiene le credenziali risolte in memoria. Le riutilizza fino a cinque minuti prima della scadenza, o per un'ora quando non hanno scadenza, quindi un profilo supportato da SSO richiede credenziali da IAM Identity Center circa una volta per durata della credenziale. Un errore di credenziale dall'API cancella la cache e il nuovo tentativo risolve credenziali aggiornate. Richiede Claude Code v2.1.207 o successiva.

188 223 

189La cache copre tutte le opzioni di credenziale sopra elencate tranne una chiave API di Amazon Bedrock, che non utilizza la catena del provider. Per risolvere la catena su ogni richiesta invece, impostare [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/it/env-vars).224La cache copre tutti i metodi di credenziale elencati all'inizio di questo passaggio tranne la chiave API di Amazon Bedrock, che non utilizza la catena del provider. Per risolvere invece la catena a ogni richiesta, imposta [`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/it/env-vars).

190 225 

191La risoluzione che popola la cache va in timeout dopo 60 secondi. Se un passaggio della catena si blocca, ad esempio un helper `credential_process` che attende un input che non può ricevere, la richiesta non riesce con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out). Se la tua catena esegue un accesso interattivo che richiede legittimamente più tempo, come SSO basato su browser con MFA tramite un wrapper come `aws-vault`, aumenta il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars). Con `CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1` impostato, ogni richiesta API risolve la catena senza questo limite.226La risoluzione che popola la cache va in timeout dopo 60 secondi. Se un passaggio della catena si blocca, ad esempio un helper `credential_process` che attende un input che non può ricevere, la richiesta non riesce con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out). Se la tua catena esegue un accesso interattivo che richiede legittimamente più tempo, come SSO basato su browser con MFA tramite un wrapper come `aws-vault`, aumenta il limite in millisecondi con [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/it/env-vars). Con `CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1` impostato, ogni richiesta API risolve la catena senza questo limite.

192 227 


509 Finestra di contesto da 1M token544 Finestra di contesto da 1M token

510</h2>545</h2>

511 546 

512Claude Sonnet 5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano la [finestra di contesto da 1M token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) su Amazon Bedrock. Sonnet 5 funziona sempre con la finestra da 1M sia sull'API Invoke che sull'[endpoint Mantle](#use-the-mantle-endpoint), senza alcuna variante `[1m]` da selezionare. Per gli altri modelli sull'API Invoke, Claude Code abilita automaticamente la finestra di contesto estesa quando selezioni una variante di modello da 1M.547I modelli Fable, Sonnet 5 e versioni successive, e Opus 4.7 e versioni successive funzionano con la [finestra di contesto da 1M token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per impostazione predefinita su Amazon Bedrock, sia sull'API Invoke che sull'[endpoint Mantle](#use-the-mantle-endpoint), senza bisogno del suffisso `[1m]`. L'ARN di un profilo di inferenza dell'applicazione ottiene la finestra da 1M quando una voce di [`modelOverrides`](#map-each-model-version-to-an-inference-profile) vi associa il relativo modello. Per mantenere invece una finestra da 200K, imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/model-config#turn-off-1m-context).

548 

549Opus 4.6 e Sonnet 4.6 sull'API Invoke raggiungono la finestra da 1M quando selezioni la relativa variante `[1m]`. La [procedura guidata di configurazione](#sign-in-with-bedrock) offre un'opzione di contesto da 1M quando fissa i modelli. Per abilitarla invece per un modello fissato manualmente, aggiungi `[1m]` all'ID del modello. Vedi [Fissa i modelli per distribuzioni di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments) per i dettagli, incluso come utilizzare la finestra da 1M senza modificare il pin.

513 550 

514La [procedura guidata di configurazione](#sign-in-with-bedrock) offre un'opzione di contesto da 1M quando fissa i modelli. Per abilitarla per un modello fissato manualmente, aggiungi `[1m]` all'ID del modello. Vedi [Fissa i modelli per distribuzioni di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments) per i dettagli, incluso come utilizzare la finestra da 1M senza modificare il pin.551Prima della v2.1.287, i modelli Fable e Opus 4.7 e versioni successive funzionavano con una finestra da 200K per impostazione predefinita sull'API Invoke e vi raggiungevano la finestra da 1M tramite un suffisso `[1m]`.

515 552 

516<h2 id="service-tiers">553<h2 id="service-tiers">

517 Livelli di servizio554 Livelli di servizio

artifacts.md +1 −1

Details

391| Authentication | La sessione è supportata da un account claude.ai: accedi con `/login` nell'app CLI o desktop. Le sessioni Claude Tag sono autenticate attraverso l'identità dell'agente, quindi non è necessario alcun passaggio. Le sessioni che utilizzano una chiave API, [gateway token](/docs/it/llm-gateway) o credenziale del provider cloud non possono pubblicare. |391| Authentication | La sessione è supportata da un account claude.ai: accedi con `/login` nell'app CLI o desktop. Le sessioni Claude Tag sono autenticate attraverso l'identità dell'agente, quindi non è necessario alcun passaggio. Le sessioni che utilizzano una chiave API, [gateway token](/docs/it/llm-gateway) o credenziale del provider cloud non possono pubblicare. |

392| Model provider | Anthropic API. Non disponibile su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) o [Microsoft Foundry](/docs/it/microsoft-foundry). |392| Model provider | Anthropic API. Non disponibile su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) o [Microsoft Foundry](/docs/it/microsoft-foundry). |

393| Organization policy | Le chiavi di crittografia gestite dal cliente (CMEK), HIPAA e [Zero Data Retention](/docs/it/zero-data-retention) non sono abilitate per l'organizzazione. |393| Organization policy | Le chiavi di crittografia gestite dal cliente (CMEK), HIPAA e [Zero Data Retention](/docs/it/zero-data-retention) non sono abilitate per l'organizzazione. |

394| Surface | Claude Code CLI o l'app desktop Claude versione 1.13576.0 o successiva. Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) possono anche pubblicare artifact quando sia Claude Tag che gli artifact sono abilitati per l'organizzazione. Disabilitato per impostazione predefinita in contesti [Agent SDK](/docs/it/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars) è impostato. |394| Superficie | Claude Code CLI o l'app desktop Claude versione 1.13576.0 o successiva. Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) possono anche pubblicare artefatti quando sia Claude Tag che gli artefatti sono abilitati per l'organizzazione. Disabilitato per impostazione predefinita nell'[Agent SDK](/docs/it/agent-sdk/overview), nella GitHub Action e nei contesti dei server MCP, quando esegui Claude Code con [`-p`](/docs/it/headless) dal tuo terminale o dai tuoi script, e quando è impostato [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars). |

395 395 

396Se gli artifact sono consentiti per la tua organizzazione dipende dalla politica della tua organizzazione, che Claude Code carica da `api.anthropic.com`. Quando Claude Code non riesce a caricare la politica, gli artifact non sono disponibili. Quando ne chiedi uno, Claude spiega il motivo.396Se gli artifact sono consentiti per la tua organizzazione dipende dalla politica della tua organizzazione, che Claude Code carica da `api.anthropic.com`. Quando Claude Code non riesce a caricare la politica, gli artifact non sono disponibili. Quando ne chiedi uno, Claude spiega il motivo.

397 397 

Details

142* **Da cosa vi disconnette**: Claude Code vi disconnette da qualsiasi accesso claude.ai memorizzato sulla macchina142* **Da cosa vi disconnette**: Claude Code vi disconnette da qualsiasi accesso claude.ai memorizzato sulla macchina

143* **Come annullarlo**: eseguite `/logout`, che rimuove e revoca la credenziale che questo accesso ha scritto143* **Come annullarlo**: eseguite `/logout`, che rimuove e revoca la credenziale che questo accesso ha scritto

144 144 

145Se la vostra organizzazione utilizza [server-managed settings](/docs/it/server-managed-settings), si applicano a questo accesso su Claude Code v2.1.257 o successivo.

146 

147Tutto il resto sui profili si applica a questo accesso, incluso dove si classifica rispetto alle vostre altre credenziali, la riga `Profile` che ottenete in `/status`, e le funzionalità che necessitano di un accesso claude.ai. Vedete [Anthropic profiles and federation credentials](#anthropic-profiles-and-federation-credentials).145Tutto il resto sui profili si applica a questo accesso, incluso dove si classifica rispetto alle vostre altre credenziali, la riga `Profile` che ottenete in `/status`, e le funzionalità che necessitano di un accesso claude.ai. Vedete [Anthropic profiles and federation credentials](#anthropic-profiles-and-federation-credentials).

148 146 

149<h3 id="cloud-provider-authentication">147<h3 id="cloud-provider-authentication">

Details

260</Steps>260</Steps>

261 261 

262<h2 id="connect-developers">262<h2 id="connect-developers">

263 Connetti gli sviluppatori263 Connettere gli sviluppatori

264</h2>264</h2>

265 265 

266Gli sviluppatori si connettono dai loro laptop con un singolo accesso al browser utilizzando il loro account di lavoro aziendale. Non hanno bisogno di un account claude.ai, di una chiave API o di un abbonamento, perché le richieste al modello passano attraverso il gateway utilizzando le credenziali upstream dell'organizzazione. La connessione è guidata dalle [impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) che distribuisci tramite MDM, quindi non c'è alcuna configurazione manuale dal lato dello sviluppatore; questa sezione copre ciò che l'amministratore configura.266Gli sviluppatori si connettono dai propri laptop con un unico accesso tramite browser, usando il proprio account aziendale. Non hanno bisogno di un account claude.ai, di una chiave API o di un abbonamento, perché le richieste al modello passano attraverso il gateway usando la credenziale upstream dell'organizzazione. La connessione è guidata dalle [impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) che distribuisci tramite MDM, quindi non c'è alcuna configurazione manuale da parte dello sviluppatore; questa sezione descrive ciò che configura l'amministratore.

267 267 

268La CLI acquisisce l'impronta digitale del certificato TLS foglia del gateway al primo collegamento e la fissa per hostname. La verifica di nuovo durante l'accesso, durante gli aggiornamenti di sessione silenziosi e durante i recuperi di impostazioni gestite, mentre le richieste di inferenza utilizzano la convalida TLS standard senza l'impronta. Le richieste instradate attraverso un proxy HTTPS saltano il controllo dell'impronta, quindi aggiungi l'host del gateway a `NO_PROXY` per mantenerle dirette.268La CLI calcola l'impronta del certificato TLS foglia del gateway alla prima connessione e la fissa (pinning) per hostname. Verifica di nuovo questa impronta fissata durante l'accesso, nei rinnovi silenziosi della sessione e nel recupero delle impostazioni gestite, mentre le richieste di inferenza usano la validazione TLS standard senza il pinning. Le richieste instradate attraverso un proxy HTTPS saltano la verifica del pinning, quindi aggiungi l'host del gateway a `NO_PROXY` per mantenerle dirette.

269 269 

270Pubblica l'impronta digitale SHA-256 prevista insieme all'URL del gateway in modo che gli sviluppatori abbiano qualcosa da confrontare. Il prompt `/login` mostra i primi 16 caratteri dell'impronta come esadecimale minuscolo senza due punti. Per stampare l'impronta completa in quella forma dal file del certificato, esegui:270Pubblica l'impronta SHA-256 attesa insieme all'URL del gateway, così gli sviluppatori hanno qualcosa con cui confrontarla. Il prompt di `/login` mostra i primi 16 caratteri dell'impronta in esadecimale minuscolo senza due punti. Per stampare l'impronta completa in quel formato a partire dal file del certificato, esegui:

271 271 

272```bash theme={null}272```bash theme={null}

273openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'273openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'

274```274```

275 275 

276Quando il certificato ruota, ogni sviluppatore vede di nuovo il prompt di fiducia, quindi tratta le rotazioni come un evento pianificato e ripubblica l'impronta. Se la politica del gateway include [impostazioni che richiedono approvazione](/docs/it/server-managed-settings#security-approval-dialogs), lo sviluppatore vede anche di nuovo il dialogo di approvazione dopo aver accettato il nuovo certificato, perché Claude Code associa la [memoria di approvazione](/docs/it/server-managed-settings#approval-memory) al certificato fissato.276Quando il certificato viene ruotato, ogni sviluppatore vede di nuovo la richiesta di attendibilità, quindi tratta le rotazioni come un evento pianificato e ripubblica l'impronta. Se la policy del tuo gateway include [impostazioni che richiedono approvazione](/docs/it/server-managed-settings#security-approval-dialogs), lo sviluppatore vede di nuovo anche quella finestra di approvazione dopo aver accettato il nuovo certificato, perché Claude Code associa la [memoria delle approvazioni](/docs/it/server-managed-settings#approval-memory) al certificato fissato.

277 277 

278Un gateway può restituire il campo facoltativo `email` nella sua risposta di token per denominare l'account utilizzato da un accesso. Quando lo fa, lo sviluppatore conferma l'account prima che Claude Code salvi la credenziale. Dopo un accesso confermato, `/status` mostra l'account.278Un gateway può restituire il campo facoltativo `email` nella sua risposta token per indicare l'account usato per un accesso. Quando lo fa, lo sviluppatore conferma l'account prima che Claude Code salvi la credenziale. Dopo un accesso confermato, `/status` mostra l'account.

279 279 

280La conferma richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore; un client al di sotto di quella versione ignora il campo. Il server gateway nel binario `claude` non restituisce il campo, quindi i suoi accessi si completano senza la conferma.280La conferma richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore; un client di versione inferiore ignora il campo. Il server gateway incluso nel binario `claude` non restituisce il campo, quindi i suoi accessi si completano senza la conferma.

281 281 

282Una volta che lo sviluppatore accede, il [selettore di modelli](/docs/it/model-config) mostra i modelli nella loro allowlist `availableModels`. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria viene instradata al tuo raccoglitore.282Una volta che lo sviluppatore ha effettuato l'accesso, il [selettore dei modelli](/docs/it/model-config) mostra i modelli presenti nella sua allowlist `availableModels`. Le impostazioni gestite si applicano all'avvio e si aggiornano ogni ora, e la telemetria viene instradata al tuo collector.

283 283 

284Le sessioni si aggiornano silenziosamente prima della scadenza di `ttl_hours`. Quando un aggiornamento non riesce dopo il deprovisioning dell'IdP, Claude Code chiede allo sviluppatore di accedere di nuovo.284Le sessioni si rinnovano silenziosamente prima della scadenza di `ttl_hours`. Quando un rinnovo fallisce dopo il deprovisioning nell'IdP, Claude Code chiede allo sviluppatore di accedere di nuovo.

285 285 

286<h3 id="set-the-gateway-url">286<h3 id="set-the-gateway-url">

287 Imposta l'URL del gateway287 Impostare l'URL del gateway

288</h3>288</h3>

289 289 

290Tre chiavi vanno nel file [impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) per OS che distribuisci tramite MDM o direttamente su disco. `forceLoginMethod` e `forceLoginGatewayUrl` aprono `/login` direttamente sulla schermata **Cloud gateway** con l'URL compilato, e `parentSettingsBehavior: "merge"` consente a Claude Desktop di fornire l'allowlist di uscita del gateway alle sessioni di Claude Code che avvia, come spiegato in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions):290Tre chiavi vanno nel [file delle impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) specifico per ogni sistema operativo che distribuisci tramite MDM o direttamente su disco. `forceLoginMethod` e `forceLoginGatewayUrl` aprono `/login` direttamente sulla schermata **Cloud gateway** con l'URL già compilato, e `parentSettingsBehavior: "merge"` permette a Claude Desktop di fornire l'allowlist di uscita del gateway alle sessioni di Claude Code che avvia, come spiegato in [Fornire la policy alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions):

291 291 

292```json theme={null}292```json theme={null}

293{293{


297}297}

298```298```

299 299 

300Lo sviluppatore preme Invio per connettersi. Il [prompt di impronta TLS al primo collegamento](#connect-developers) appare ancora. Una volta che il file è su una macchina, uno sviluppatore che non ha completato l'accesso al gateway vede uno dei messaggi descritti in [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Gli sviluppatori che selezionano un provider cloud tramite una variabile d'ambiente come `CLAUDE_CODE_USE_BEDROCK` non hanno bisogno dell'accesso al gateway.300Lo sviluppatore preme Invio per connettersi. Il [prompt dell'impronta TLS alla prima connessione](#connect-developers) appare comunque. Una volta che il file è presente su una macchina, uno sviluppatore che non ha completato l'accesso al gateway vede uno dei messaggi descritti in [Administrator policy requires a Cloud gateway sign-in](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in). Gli sviluppatori che selezionano un provider cloud tramite una variabile d'ambiente come `CLAUDE_CODE_USE_BEDROCK` non hanno bisogno dell'accesso al gateway.

301 301 

302Uno sviluppatore non può configurarlo manualmente. Il selettore di accesso non ha opzione gateway, e `forceLoginGatewayUrl` viene ignorato nei file di impostazioni dello sviluppatore. `forceLoginMethod` da solo, senza un URL, lascia lo sviluppatore con un messaggio "Contatta il tuo amministratore IT". Le chiavi di accesso appartengono al file che distribuisci alle macchine, non al blocco `managed.policies[].cli` del gateway, che raggiunge solo i client già connessi.302Uno sviluppatore non può configurarlo manualmente. Il selettore di accesso non ha un'opzione gateway, e `forceLoginGatewayUrl` viene ignorato nei file di impostazioni dello sviluppatore. `forceLoginMethod` da solo, senza un URL, lascia lo sviluppatore su un messaggio "Contact your IT administrator". Le chiavi di accesso vanno nel file che distribuisci alle macchine, non nel blocco `managed.policies[].cli` del gateway, che raggiunge solo i client già connessi.

303 303 

304<h3 id="allow-a-gateway-on-public-address-space-you-own">304<h3 id="allow-a-gateway-on-public-address-space-you-own">

305 Consenti un gateway su spazio di indirizzi pubblici che possiedi305 Consentire un gateway su uno spazio di indirizzi pubblico di tua proprietà

306</h3>306</h3>

307 307 

308Alcune organizzazioni numerano la loro rete interna da un blocco IPv4 pubblico che possiedono, come lo spazio di indirizzi proprio di un operatore o un `/8` legacy, quindi il loro gateway non può avere un indirizzo privato. Elenca questi blocchi nell'impostazione gestita `gatewayInternalNetworks`. `/login` quindi accetta un gateway all'interno di un blocco elencato quando la macchina dello sviluppatore si connette ad esso da un indirizzo all'interno dello stesso blocco. Ciò richiede Claude Code v2.1.268 o successivo sulla macchina dello sviluppatore; le versioni precedenti ignorano la chiave e applicano la regola dell'indirizzo privato.308Alcune organizzazioni numerano la propria rete interna a partire da un blocco IPv4 pubblico di loro proprietà, come lo spazio di indirizzi di un operatore o un `/8` legacy, quindi il loro gateway non ha un indirizzo privato. Elenca questi blocchi nell'impostazione gestita `gatewayInternalNetworks`. `/login` accetterà quindi un gateway all'interno di un blocco elencato quando la macchina dello sviluppatore vi si connette da un indirizzo interno allo stesso blocco. Ciò richiede Claude Code v2.1.268 o successivo sulla macchina dello sviluppatore; le versioni precedenti ignorano la chiave e applicano la regola degli indirizzi privati.

309 309 

310<Warning>310<Warning>

311 `gatewayInternalNetworks` è per le reti interne che si trovano ad essere numerate da spazio di indirizzi pubblici. Non rende sicuro esporre un gateway a Internet: un gateway affidabile può inviare impostazioni che eseguono comandi sulle macchine degli sviluppatori.311 `gatewayInternalNetworks` è pensato per reti interne che risultano numerate a partire da uno spazio di indirizzi pubblico. Non rende sicuro esporre un gateway a Internet: un gateway attendibile può distribuire impostazioni che eseguono comandi sulle macchine degli sviluppatori.

312 312 

313 Mantieni il gateway irraggiungibile dall'esterno della tua rete con le regole del firewall o del load balancer. Imposta il [`access_control.allow_cidrs`](/docs/it/claude-apps-gateway-config#http-tuning) del gateway agli stessi blocchi che dichiari qui, in modo che il gateway stesso rifiuti i client da qualsiasi altro luogo. Dietro un load balancer o ingress, imposta anche `listen.trusted_proxies` su quel front end, perché il gateway altrimenti confronta `allow_cidrs` con l'indirizzo del front end stesso piuttosto che con quello dello sviluppatore.313 Mantieni il gateway irraggiungibile dall'esterno della tua rete con le regole del firewall o del load balancer. Imposta [`access_control.allow_cidrs`](/docs/it/claude-apps-gateway-config#http-tuning) del gateway sugli stessi blocchi che dichiari qui, in modo che il gateway stesso rifiuti i client provenienti da qualsiasi altro luogo. Dietro un load balancer o un ingress, imposta anche `listen.trusted_proxies` su quel front end, perché altrimenti il gateway confronta `allow_cidrs` con l'indirizzo del front end invece che con quello dello sviluppatore.

314</Warning>314</Warning>

315 315 

316Aggiungi la chiave alla stessa fonte di impostazioni gestite delle chiavi di accesso: il file di impostazioni gestite, il profilo MDM o la politica del registro. Claude Code la ignora nelle impostazioni utente, di progetto e gestite dal server.316Aggiungi la chiave alla stessa sorgente di impostazioni gestite delle chiavi di accesso: il file delle impostazioni gestite, il profilo MDM o la policy del registro di sistema. Claude Code la ignora nelle impostazioni utente, di progetto e gestite dal server.

317 317 

318Questo esempio dichiara un blocco. Sostituisci `203.0.113.0/24` con il tuo blocco. È un intervallo di documentazione e Claude Code rifiuta quelli.318Questo esempio dichiara un solo blocco. Sostituisci `203.0.113.0/24` con il tuo blocco. È un intervallo di documentazione, e Claude Code li rifiuta.

319 319 

320```json theme={null}320```json theme={null}

321{321{


325 325 

326Claude Code convalida l'elenco in `/login` prima di contattare qualsiasi gateway:326Claude Code convalida l'elenco in `/login` prima di contattare qualsiasi gateway:

327 327 

328* Ogni voce è un blocco IPv4 scritto come il suo primo indirizzo e un prefisso da `/8` a `/32`.328* Ogni voce è un blocco IPv4 scritto come primo indirizzo e un prefisso da `/8` a `/32`.

329* L'elenco contiene al massimo quattro blocchi e nessuno si sovrappone.329* L'elenco contiene al massimo quattro blocchi, e nessuno si sovrappone a un altro.

330* Nessun blocco si sovrappone allo spazio di indirizzi privati: `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `127.0.0.0/8`, `169.254.0.0/16` e `100.64.0.0/10`. `/login` accetta già un gateway lì senza questa chiave.330* Nessun blocco si sovrappone allo spazio di indirizzi privato: `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `127.0.0.0/8`, `169.254.0.0/16` e `100.64.0.0/10`. `/login` accetta già un gateway lì senza questa chiave.

331* Nessun blocco si sovrappone allo spazio che non è mai la rete di un'organizzazione: `198.18.0.0/15` e `192.0.0.0/24`, che i client VPN e NAT64 mantengono come indirizzi locali; gli intervalli di documentazione `192.0.2.0/24`, `198.51.100.0/24` e `203.0.113.0/24`; e gli intervalli riservati `0.0.0.0/8`, `192.88.99.0/24` e multicast `224.0.0.0/4`. Puoi dichiarare blocchi all'interno di `240.0.0.0/4`, che alcune reti di grandi dimensioni utilizzano come spazio unicast interno.331* Nessun blocco si sovrappone a uno spazio che non è mai la rete di un'organizzazione: `198.18.0.0/15` e `192.0.0.0/24`, che i client VPN e NAT64 usano come indirizzi locali; gli intervalli di documentazione `192.0.2.0/24`, `198.51.100.0/24` e `203.0.113.0/24`; e gli intervalli riservati `0.0.0.0/8`, `192.88.99.0/24` e multicast `224.0.0.0/4`. Puoi dichiarare blocchi all'interno di `240.0.0.0/4`, che alcune grandi reti usano come spazio unicast interno.

332 332 

333I blocchi da `managed-settings.json` e i suoi file drop-in `managed-settings.d/` si combinano in un elenco, e questi limiti si applicano all'elenco combinato. Per restringere un blocco, sostituisci la sua voce piuttosto che aggiungerne una seconda, sovrapposta in un drop-in; `/login` rifiuta la sovrapposizione.333I blocchi di `managed-settings.json` e dei suoi file drop-in `managed-settings.d/` si combinano in un unico elenco, e questi limiti si applicano all'elenco combinato. Per restringere un blocco, sostituisci la sua voce invece di aggiungerne una seconda sovrapposta in un drop-in; `/login` rifiuta la sovrapposizione.

334 334 

335Se una voce viola una regola, o il valore non è un elenco di stringhe, Claude Code rifiuta ogni nuovo accesso al gateway su quella macchina e nomina il problema nel messaggio. Anche l'accesso a un gateway su un indirizzo privato non riesce, e gli accessi esistenti continuano a funzionare. Prova il valore su una macchina prima di distribuirlo. Claude Code elenca anche un valore di tipo errato tra le [impostazioni gestite non valide che segnala](/docs/it/managed-settings#keys-that-fail-closed).335Se una voce viola una regola, o il valore non è un elenco di stringhe, Claude Code rifiuta ogni nuovo accesso al gateway su quella macchina e indica il problema nel messaggio. Anche l'accesso a un gateway su un indirizzo privato fallisce, mentre gli accessi esistenti continuano a funzionare. Prova il valore su una macchina prima di distribuirlo. Claude Code elenca anche un valore di tipo errato tra le [impostazioni gestite non valide che segnala](/docs/it/managed-settings#keys-that-fail-closed).

336 336 

337Con un elenco valido, `/login` applica tre controlli a un gateway il cui indirizzo è all'interno di un blocco elencato:337Con un elenco valido, `/login` applica tre verifiche a un gateway il cui indirizzo si trova all'interno di un blocco elencato:

338 338 

339* Ogni indirizzo a cui il nome host del gateway si risolve è all'interno di quel blocco. Claude Code rifiuta un nome che ha anche record al di fuori di esso, indirizzi privati e IPv6 inclusi.339* Ogni indirizzo in cui si risolve l'hostname del gateway si trova all'interno di quel singolo blocco. Claude Code rifiuta un nome che ha anche record al di fuori di esso, inclusi indirizzi privati e IPv6.

340* La macchina dello sviluppatore si connette dall'interno dello stesso blocco. Claude Code rifiuta una macchina dietro NAT, all'interno di un contenitore o WSL2, o su una VPN il cui pool di indirizzi si trova al di fuori del blocco, e nomina l'indirizzo da cui la macchina si è connessa.340* La macchina dello sviluppatore si connette dall'interno dello stesso blocco. Claude Code rifiuta una macchina dietro NAT, all'interno di un container o di WSL2, o su una VPN il cui pool di indirizzi si trova al di fuori del blocco, e indica l'indirizzo da cui la macchina si è connessa.

341* La connessione è diretta. Se `HTTPS_PROXY` si applica all'host del gateway, `/login` rifiuta e nomina la voce `NO_PROXY` da aggiungere.341* La connessione è diretta. Se `HTTPS_PROXY` si applica all'host del gateway, `/login` rifiuta e indica la voce `NO_PROXY` da aggiungere.

342 342 

343Quando tutti e tre passano, il [prompt di fiducia](#connect-developers) aggiunge una riga che nomina l'indirizzo della macchina, l'indirizzo del gateway e il blocco dichiarato che contiene entrambi.343Quando tutte e tre le verifiche hanno esito positivo, la [richiesta di attendibilità](#connect-developers) aggiunge una riga che indica l'indirizzo della macchina, l'indirizzo del gateway e il blocco dichiarato che li contiene entrambi.

344 344 

345La chiave non cambia nulla per altri gateway: l'accesso a uno su un indirizzo privato funziona come prima, e l'accesso a uno su un indirizzo pubblico al di fuori di ogni blocco elencato viene rifiutato come prima.345La chiave non cambia nulla per gli altri gateway: l'accesso a un gateway su un indirizzo privato funziona come prima, e l'accesso a uno su un indirizzo pubblico al di fuori di ogni blocco elencato viene rifiutato come prima.

346 346 

347Un blocco dichiarato restringe chi può accedere ma non prova dove si trova una macchina, quindi dichiara solo lo spazio di indirizzi che la tua organizzazione controlla. Un blocco condiviso con altri tenant, come un intervallo pubblico di un provider cloud, consente a chiunque al suo interno di superare lo stesso controllo.347Un blocco dichiarato restringe chi può accedere ma non dimostra dove si trova una macchina, quindi dichiara solo spazio di indirizzi controllato dalla tua organizzazione. Un blocco condiviso con altri tenant, come l'intervallo pubblico di un provider cloud, permette a chiunque al suo interno di superare la stessa verifica.

348 348 

349<h3 id="deliver-policy-to-claude-desktop-sessions">349<h3 id="deliver-policy-to-claude-desktop-sessions">

350 Fornisci la politica alle sessioni di Claude Desktop350 Fornire la policy alle sessioni di Claude Desktop

351</h3>351</h3>

352 352 

353Claude Desktop esegue le sue schede Cowork e Code, più la scheda Chat quando la abiliti, su sessioni di Claude Code incorporate e invia le loro richieste di modello attraverso il gateway. Passa la politica a ciascuna di quelle sessioni, costruita dalla configurazione che il gateway gli serve a `/user/bootstrap`: l'allowlist dei modelli, gli strumenti disabilitati e l'allowlist di uscita derivata dal blocco `cli` della politica corrispondente, più l'[overlay `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay).353Claude Desktop esegue le sue schede Cowork e Code, più la scheda Chat quando la abiliti, su sessioni di Claude Code incorporate e invia le loro richieste al modello attraverso il gateway. Passa una policy a ciascuna di queste sessioni, costruita a partire dalla configurazione che il gateway gli fornisce su `/user/bootstrap`: l'allowlist dei modelli, gli strumenti disabilitati e l'allowlist di uscita derivati dal blocco `cli` della policy corrispondente, più l'[overlay `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay).

354 354 

355Altre chiavi `cli`, come gli hook, `env` e le regole di permesso con ambito come `Bash(npm *)`, raggiungono solo i client che accedono tramite `/login`. Claude Desktop legge l'URL del gateway dalla sua propria configurazione gestita e accede con il suo proprio flusso, separato dalle chiavi `forceLoginMethod` e `forceLoginGatewayUrl` in [Imposta l'URL del gateway](#set-the-gateway-url).355Le altre chiavi `cli`, come gli hook, `env` e le regole di permesso con ambito come `Bash(npm *)`, raggiungono solo i client che accedono tramite `/login`. Claude Desktop legge l'URL del gateway dalla propria configurazione gestita ed effettua l'accesso con il proprio flusso, separato dalle chiavi `forceLoginMethod` e `forceLoginGatewayUrl` di [Impostare l'URL del gateway](#set-the-gateway-url).

356 356 

357Le impostazioni passate da un processo di avvio sono impostazioni padre. Claude Code ignora le impostazioni padre su qualsiasi macchina che ha una fonte gestita distribuita dall'amministratore, a meno che la [fonte che fornisce la politica](/docs/it/managed-settings#which-managed-source-claude-code-uses) non imposti `parentSettingsBehavior: "merge"`.357Le impostazioni passate da un processo di avvio sono impostazioni parent. Claude Code ignora le impostazioni parent su qualsiasi macchina che abbia una sorgente gestita distribuita da un amministratore, a meno che la [sorgente che fornisce la policy](/docs/it/managed-settings#which-managed-source-claude-code-uses) non imposti `parentSettingsBehavior: "merge"`.

358 358 

359<h4 id="which-machines-need-the-opt-in">359<h4 id="which-machines-need-the-opt-in">

360 Quali macchine hanno bisogno dell'opt-in360 Quali macchine richiedono l'opt-in

361</h4>361</h4>

362 362 

363Le macchine che eseguono solo Claude Desktop ne hanno bisogno. Claude Desktop applica direttamente la lista dei modelli e la lista degli strumenti disabilitati alle sessioni incorporate, ma l'allowlist di uscita le raggiunge solo come impostazioni padre, sotto forma di regole di dominio `WebFetch` e regole di rete della sandbox. Senza l'opt-in, quelle sessioni vengono eseguite senza la restrizione dell'uscita, e nulla ti avverte. Il gateway rifiuta comunque le richieste di inferenza per i modelli che la politica non concede.363Le macchine che eseguono solo Claude Desktop lo richiedono. Claude Desktop applica autonomamente l'elenco dei modelli e l'elenco degli strumenti disabilitati alle sessioni incorporate, ma l'allowlist di uscita le raggiunge solo come impostazioni parent, sotto forma di regole di dominio `WebFetch` e regole di rete della sandbox. Senza l'opt-in, queste sessioni vengono eseguite senza la restrizione di uscita, e nulla ti avvisa. Il gateway rifiuta comunque le richieste di inferenza per i modelli che la policy non concede.

364 364 

365Anche un'allowlist dei marketplace dei plugin raggiunge le sessioni incorporate solo come impostazioni padre. Quando disattivi i marketplace dei plugin aggiunti dall'utente nella configurazione gestita di Claude Desktop, Claude Desktop 2.16120.0 o successivo nasconde i marketplace che la tua organizzazione non ha fornito e rifiuta le installazioni da essi. Per impedire alle sessioni incorporate di caricare i plugin già installati da quei marketplace, invia loro una lista `strictKnownMarketplaces` come impostazioni padre. Senza l'opt-in, Claude Code ignora quella lista e quei plugin continuano a caricarsi.365Anche un'allowlist dei marketplace di plugin raggiunge le sessioni incorporate solo come impostazioni parent. Quando disattivi i marketplace di plugin aggiunti dall'utente nella configurazione gestita di Claude Desktop, Claude Desktop 2.16120.0 o successivo nasconde i marketplace che la tua organizzazione non ha predisposto e rifiuta le installazioni da essi. Per impedire alle sessioni incorporate di caricare plugin già installati da quei marketplace, invia loro un elenco `strictKnownMarketplaces` come impostazioni parent. Senza l'opt-in, Claude Code ignora quell'elenco, e quei plugin continuano a essere caricati.

366 366 

367Le macchine in cui gli sviluppatori accedono tramite `/login` non ne hanno bisogno; ogni sessione di Claude Code recupera la sua politica dal gateway.367Le macchine in cui gli sviluppatori accedono tramite `/login` non lo richiedono; ogni sessione di Claude Code recupera la propria policy dal gateway.

368 368 

369Le flotte il cui [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce impostazioni gestite non possono usarlo: Claude Code non esegue mai il merge delle impostazioni padre su quelle flotte, perché legge le impostazioni gestite solo dall'output dell'helper.369I parchi macchine il cui [`policyHelper`](/docs/it/settings-reference#policyhelper) fornisce le impostazioni gestite non possono usarlo: Claude Code non esegue mai il merge delle impostazioni parent su quei parchi macchine, perché legge le impostazioni gestite esclusivamente dall'output dell'helper.

370 370 

371<h4 id="set-the-opt-in">371<h4 id="set-the-opt-in">

372 Imposta l'opt-in372 Impostare l'opt-in

373</h4>373</h4>

374 374 

375Distribuisci lo snippet di impostazioni gestite da [Imposta l'URL del gateway](#set-the-gateway-url), replicalo su qualsiasi fonte lato client che ha la precedenza sul file, quindi verifica.375Distribuisci lo snippet delle impostazioni gestite di [Impostare l'URL del gateway](#set-the-gateway-url), replicalo in qualsiasi sorgente lato client che abbia priorità superiore al file, quindi verifica.

376 376 

377<Steps>377<Steps>

378 <Step title="Distribuisci l'opt-in nel file di impostazioni gestite">378 <Step title="Distribuisci l'opt-in nel file delle impostazioni gestite">

379 Lo [snippet sopra](#set-the-gateway-url) include già `parentSettingsBehavior: "merge"`, quindi il file che distribuisci alle macchine lo contiene.379 Lo [snippet precedente](#set-the-gateway-url) include già `parentSettingsBehavior: "merge"`, quindi il file che distribuisci alle macchine lo contiene.

380 </Step>380 </Step>

381 381 

382 <Step title="Replica lo snippet su qualsiasi fonte che ha la precedenza sul file">382 <Step title="Replica lo snippet in qualsiasi sorgente con priorità superiore al file">

383 Claude Code legge `parentSettingsBehavior` solo dalla [fonte selezionata](/docs/it/managed-settings#which-managed-source-claude-code-uses). Aggiungere qualsiasi chiave di politica a una fonte può rendere quella fonte quella selezionata, quindi in una fonte lato client, replica l'intero snippet piuttosto che solo `parentSettingsBehavior`. [Le impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) copre le flotte che forniscono la politica tramite Group Policy o profili di configurazione. Un plist di preferenze gestite su macOS o una politica HKLM su Windows ha la precedenza sul file `managed-settings.json`, e le impostazioni gestite remote del gateway hanno la precedenza su entrambi, quindi sulle macchine che accedono al gateway, imposta anche `parentSettingsBehavior` nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della politica del gateway.383 Claude Code legge `parentSettingsBehavior` solo dalla [sorgente selezionata](/docs/it/managed-settings#which-managed-source-claude-code-uses). Aggiungere qualsiasi chiave di policy a una sorgente può renderla quella selezionata, quindi in una sorgente lato client replica l'intero snippet invece della sola `parentSettingsBehavior`. [Impostazioni gestite lato client](/docs/it/claude-apps-gateway-config#client-side-managed-settings) tratta i parchi macchine che forniscono la policy tramite Criteri di gruppo o profili di configurazione. Un plist di preferenze gestite su macOS o una policy HKLM su Windows ha priorità superiore al file `managed-settings.json`, e le impostazioni gestite remote del gateway hanno priorità superiore a entrambi, quindi sulle macchine che accedono al gateway imposta `parentSettingsBehavior` anche nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della policy del gateway.

384 </Step>384 </Step>

385 385 

386 <Step title="Controlla quale fonte è selezionata">386 <Step title="Verifica quale sorgente è selezionata">

387 Su una macchina che esegue solo Claude Desktop, chiama il [`resolveSettings()`](/docs/it/agent-sdk/typescript#resolvesettings) dell'Agent SDK e leggi `policyOrigin` sulla voce `managed` nel suo elenco `sources`. Il valore nomina la fonte lato client selezionata, `plist`, `hklm` o `file`, che è la fonte che deve contenere lo snippet. Le sessioni incorporate di Claude Desktop non recuperano la politica del gateway, quindi il blocco `cli` del gateway non conta mai come la fonte selezionata per loro.387 Su una macchina che esegue solo Claude Desktop, chiama [`resolveSettings()`](/docs/it/agent-sdk/typescript#resolvesettings) dell'Agent SDK e leggi `policyOrigin` nella voce `managed` del suo elenco `sources`. Il valore indica la sorgente lato client selezionata, `plist`, `hklm` o `file`, che è la sorgente che deve contenere lo snippet. Le sessioni incorporate di Claude Desktop non recuperano la policy del gateway, quindi il blocco `cli` del gateway non conta mai come sorgente selezionata per esse.

388 </Step>388 </Step>

389</Steps>389</Steps>

390 390 

391<h3 id="restrict-parent-settings">391<h3 id="restrict-parent-settings">

392 Limita le impostazioni padre392 Limitare le impostazioni parent

393</h3>393</h3>

394 394 

395Una volta che distribuisci `parentSettingsBehavior: "merge"`, qualsiasi processo host che avvia Claude Code può fornire impostazioni padre, non solo Claude Desktop ma anche un'applicazione Agent SDK o un'estensione IDE.395Una volta distribuito `parentSettingsBehavior: "merge"`, qualsiasi processo host che avvia Claude Code può fornire impostazioni parent, non solo Claude Desktop ma anche un'applicazione Agent SDK o un'estensione IDE.

396 396 

397Claude Code filtra le impostazioni padre rispetto a un'allowlist di chiavi restrittive, ma alcune chiavi consentite possono concedere accesso piuttosto che limitarlo. A meno che tu non imposti i blocchi `allowManaged*Only`, le regole di permesso allow e le allowlist della sandbox fornite dall'host si applicano comunque. Le regole deny e ask della tua politica rimangono in vigore in ogni caso; [vengono valutate prima di qualsiasi regola allow](/docs/it/permissions#manage-permissions).397Claude Code filtra le impostazioni parent in base a un'allowlist di chiavi restrittive, ma alcune chiavi consentite possono concedere accesso invece di limitarlo. A meno che tu non imposti i blocchi `allowManaged*Only`, le regole di consenso dei permessi e le allowlist della sandbox fornite dall'host si applicano comunque. Le regole di negazione e di richiesta della tua policy restano in vigore in ogni caso; [vengono valutate prima di qualsiasi regola di consenso](/docs/it/permissions#manage-permissions).

398 398 

399Claude Code inoltra le voci [`sandbox.credentials`](/docs/it/settings-reference#sandbox-credentials) fornite dal padre in forma ridotta:399Claude Code inoltra le voci [`sandbox.credentials`](/docs/it/settings-reference#sandbox-credentials) fornite dal parent in forma ridotta:

400 400 

401* **Voci `deny`**: inoltrate con solo il loro `path` o `name` e la modalità.401* **Voci `deny`**: inoltrate solo con il loro `path` o `name` e la modalità.

402* **Voci di file con [`mode: mask`](/docs/it/sandboxing#mask-credential-files)**: inoltrate solo come sentinel, come una maschera di file intero il cui `injectHosts` è l'elenco vuoto, quindi il proxy non sostituisce mai il valore reale per una voce fornita dal padre su nessuna piattaforma. Vengono eliminati anche tutti i campi di mascheramento strutturato, quindi un modello di estrazione fornito dal padre non può sostituire una maschera più rigorosa che un'altra fonte imposta per lo stesso percorso.402* **Voci di file con [`mode: mask`](/docs/it/sandboxing#mask-credential-files)**: inoltrate solo come sentinella, come maschera dell'intero file il cui `injectHosts` è l'elenco vuoto, quindi il proxy non sostituisce mai il valore reale per una voce fornita dal parent su nessuna piattaforma. Vengono eliminati anche tutti i campi di mascheramento strutturato, quindi un pattern di estrazione fornito dal parent non può soppiantare una maschera più rigorosa impostata da un'altra sorgente per lo stesso percorso.

403* **Voci `envVars` con `mode: mask`**: non inoltrate. `deny` è l'unica restrizione che il canale padre può esprimere attraverso le voci `envVars`.403* **Voci `envVars` con `mode: mask`**: non inoltrate. `deny` è l'unica restrizione che il canale parent può esprimere tramite le voci `envVars`.

404* **[`awsPairs` e `sigv4`](/docs/it/sandboxing#re-sign-aws-requests)**: inoltrate solo come restrizione. Da `sigv4`, vengono mantenuti solo i valori `deny`, e un padre che definisce un blocco `sigv4` in qualsiasi forma fissa tutti e tre i moduli di richiesta, `streaming`, `presigned` e `sigv4a`, a `deny`. Una coppia `awsPairs` non viene mai inoltrata in una forma che possa ri-firmare; una coppia che nomina una delle variabili AWS convenzionali viene sostituita da una voce inerte che mantiene soppresso l'accoppiamento automatico di `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN`.404* **[`awsPairs` e `sigv4`](/docs/it/sandboxing#re-sign-aws-requests)**: inoltrati solo come restrizione. Di `sigv4` vengono mantenuti solo i valori `deny`, e un parent che definisce un blocco `sigv4` in qualsiasi forma imposta tutte e tre le forme di richiesta, `streaming`, `presigned` e `sigv4a`, su `deny`. Una coppia `awsPairs` non viene mai inoltrata in una forma che possa rifirmare; una coppia che indica una delle variabili AWS convenzionali viene sostituita da una voce inerte che mantiene soppresso l'abbinamento automatico di `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` e `AWS_SESSION_TOKEN`.

405 405 

406<h4 id="deploy-the-locks">406<h4 id="deploy-the-locks">

407 Distribuisci i blocchi407 Distribuire i blocchi

408</h4>408</h4>

409 409 

410Per mantenere le impostazioni padre il più vicino possibile a solo restrizione quanto il filtro consente, aggiungi tutti e cinque i blocchi `allowManaged*Only`, e le allowlist che governano, alle stesse fonti dell'opt-in di merge:410Per mantenere le impostazioni parent il più vicino possibile a una forma puramente restrittiva, per quanto il filtro lo consenta, aggiungi tutti e cinque i blocchi `allowManaged*Only`, e le allowlist che governano, alle stesse sorgenti dell'opt-in al merge:

411 411 

412```json theme={null}412```json theme={null}

413{413{


432}432}

433```433```

434 434 

435Una politica del sistema operativo, come una politica del registro HKLM o un plist di preferenze gestite, ha la precedenza su questo file, quindi fornisci l'intero snippet attraverso di essa invece del file. Le impostazioni gestite remote del gateway hanno la precedenza sulle fonti della politica del sistema operativo e del file ma raggiungono solo i client connessi. Replica i blocchi, le allowlist e l'opt-in di merge nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della politica e mantieni questo file distribuito, perché le macchine che non si connettono mai, incluse quelle che eseguono solo Claude Desktop, ottengono la loro politica solo dal file.435Una policy del sistema operativo, come una policy del registro HKLM o un plist di preferenze gestite, ha priorità superiore a questo file, quindi fornisci l'intero snippet tramite essa invece che tramite il file. Le impostazioni gestite remote del gateway hanno priorità superiore alle sorgenti della policy del sistema operativo e del file, ma raggiungono solo i client connessi. Replica i blocchi, le allowlist e l'opt-in al merge nel [blocco `cli`](/docs/it/claude-apps-gateway-config#managed) della policy e mantieni distribuito questo file, perché le macchine che non si connettono mai, incluse quelle che eseguono solo Claude Desktop, ricevono la propria policy esclusivamente dal file.

436 436 

437<h4 id="lock-behavior-across-sources">437<h4 id="lock-behavior-across-sources">

438 Comportamento dei blocchi tra le fonti438 Comportamento dei blocchi tra le sorgenti

439</h4>439</h4>

440 440 

441Impostare un blocco non limita gli altri; ogni chiave è documentata nel [riferimento delle impostazioni](/docs/it/settings-reference#all-settings).441Impostare un blocco non limita gli altri; ogni chiave è documentata nel [riferimento delle impostazioni](/docs/it/settings-reference#all-settings).

442 442 

443Da una fonte di amministrazione al di sotto di quella vincente, i due blocchi della sandbox si applicano comunque, e `allowManagedPermissionRulesOnly` blocca comunque le regole allow fornite dal padre e `additionalDirectories`. Su Claude Code v2.1.273 o successivo, anche il blocco dei server MCP si applica da una fonte al di sotto di quella vincente, e mentre è attivo, la lista `allowedMcpServers` gestita proviene dalla fonte di amministrazione con la priorità più alta che ne imposta una.443Da una sorgente di amministrazione al di sotto di quella vincente, i due blocchi della sandbox si applicano comunque, e `allowManagedPermissionRulesOnly` blocca comunque le regole di consenso e le `additionalDirectories` fornite dal parent. Su Claude Code v2.1.273 o successivo, anche il blocco dei server MCP si applica da una sorgente al di sotto di quella vincente, e mentre è attivo, l'elenco gestito `allowedMcpServers` proviene dalla sorgente di amministrazione con priorità più alta che ne imposta uno.

444 444 

445Il blocco degli hook e l'effetto di `allowManagedPermissionRulesOnly` sulle regole dello sviluppatore richiedono la fonte vincente per impostazione predefinita; con l'opt-in di merge `managedSourcesBehavior` descritto in [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code applica il valore più rigoroso che qualsiasi fonte imposta per ogni blocco. Sulle flotte [`policyHelper`](/docs/it/settings-reference#policyhelper), Claude Code legge i blocchi solo dall'output dell'helper.445Il blocco degli hook e l'effetto di `allowManagedPermissionRulesOnly` sulle regole dello sviluppatore richiedono per impostazione predefinita la sorgente vincente; con l'opt-in al merge `managedSourcesBehavior` descritto in [come Claude Code combina le sorgenti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources), Claude Code applica per ogni blocco il valore più rigoroso impostato da qualsiasi sorgente. Sui parchi macchine con [`policyHelper`](/docs/it/settings-reference#policyhelper), Claude Code legge i blocchi esclusivamente dall'output dell'helper.

446 446 

447Ogni blocco fa sì che Claude Code ignori le voci dello sviluppatore per quell'impostazione, quindi includi le allowlist della tua organizzazione accanto ai blocchi:447Ogni blocco fa sì che Claude Code ignori le voci dello sviluppatore per quell'impostazione, quindi includi le allowlist della tua organizzazione accanto ai blocchi:

448 448 

449* **Domini di rete**: il blocco con una lista di domini gestiti vuota blocca tutto il traffico in uscita dalla sandbox.449* **Domini di rete**: bloccare con un elenco di domini gestiti vuoto blocca tutto il traffico in uscita dalla sandbox.

450* **Server MCP**: il blocco senza `allowedMcpServers` in nessuna fonte di amministrazione o nelle impostazioni fornite dal padre carica ogni server che `deniedMcpServers` non blocca.450* **Server MCP**: bloccare senza `allowedMcpServers` in nessuna sorgente di amministrazione né nelle impostazioni fornite dal parent carica ogni server che `deniedMcpServers` non blocca.

451* **Percorsi di lettura**: le voci `allowRead` ri-consentono solo i percorsi all'interno delle regioni `denyRead`, quindi abbinale a un `denyRead` gestito.451* **Percorsi di lettura**: le voci `allowRead` riconsentono solo percorsi all'interno delle aree `denyRead`, quindi abbinale a un `denyRead` gestito.

452 452 

453<h4 id="settings-the-locks-don’t-cover">453<h4 id="settings-the-locks-don’t-cover">

454 Impostazioni che i blocchi non coprono454 Impostazioni non coperte dai blocchi

455</h4>455</h4>

456 456 

457Queste impostazioni fornite dal padre passano il filtro anche con tutti e cinque i blocchi impostati:457Queste impostazioni fornite dal parent superano il filtro anche con tutti e cinque i blocchi impostati:

458 458 

459* **`forceLoginOrgUUID`**: Claude Code rispetta un valore fornito dal padre quando la fonte di amministrazione con la priorità più alta non imposta un UUID org. L'accesso al gateway non controlla questa chiave. Un UUID org nella fonte di amministrazione con la priorità più alta blocca il valore del padre ed è quello che Claude Code applica.459* **`forceLoginOrgUUID`**: Claude Code rispetta un valore fornito dal parent quando la sorgente di amministrazione con priorità più alta non imposta un UUID di organizzazione. L'accesso al gateway non verifica questa chiave. Un UUID di organizzazione nella sorgente di amministrazione con priorità più alta blocca il valore del parent ed è quello che Claude Code applica.

460* **`allowedMcpServers`**: Claude Code rispetta un'allowlist fornita dal padre quando nessuna lista di amministrazione è in vigore. `allowManagedMcpServersOnly` non la blocca, perché il blocco applica qualsiasi lista prevalga come valore gestito, inclusa una fornita dal padre quando nessuna fonte di amministrazione fornisce una lista. Una lista nella fonte di amministrazione con la priorità più alta blocca quella del padre ed è la lista che Claude Code applica, quindi imposta `allowedMcpServers` lì, accanto al blocco. Prima della v2.1.223, un valore per una delle due chiavi in qualsiasi fonte di amministrazione bloccava quello del padre.460* **`allowedMcpServers`**: Claude Code rispetta un'allowlist fornita dal parent quando non è in vigore alcun elenco di amministrazione. `allowManagedMcpServersOnly` non la blocca, perché il blocco applica come valore gestito qualunque elenco prevalga, incluso uno fornito dal parent quando nessuna sorgente di amministrazione fornisce un elenco. Un elenco nella sorgente di amministrazione con priorità più alta blocca quello del parent ed è l'elenco che Claude Code applica, quindi imposta `allowedMcpServers` lì, accanto al blocco. Prima della v2.1.223, un valore per una delle due chiavi in qualsiasi sorgente di amministrazione bloccava quello del parent.

461* **`availableModels`**: Claude Code rispetta una lista di modelli fornita dal padre quando la fonte gestita vincente non ne imposta una. Se la tua flotta limita i modelli, imposta `availableModels` nella fonte vincente.461* **`availableModels`**: Claude Code rispetta un elenco di modelli fornito dal parent quando la sorgente gestita vincente non ne imposta uno. Se il tuo parco macchine limita i modelli, imposta `availableModels` nella sorgente vincente.

462* **`allowedProviders`**: Claude Code rispetta un'allowlist di provider API fornita dal padre quando la fonte gestita vincente non ne imposta una. Se la tua flotta limita i provider API che gli sviluppatori possono usare, imposta `allowedProviders` nella fonte vincente. Richiede Claude Code v2.1.285 o successivo.462* **`allowedProviders`**: Claude Code rispetta un'allowlist dei provider API fornita dal parent quando la sorgente gestita vincente non ne imposta una. Se il tuo parco macchine limita i provider API che gli sviluppatori possono usare, imposta `allowedProviders` nella sorgente vincente. Richiede Claude Code v2.1.285 o successivo.

463* **`strictKnownMarketplaces`**: Claude Code rispetta un'allowlist dei marketplace dei plugin fornita dal padre quando la fonte gestita vincente non ne imposta una. Claude Desktop 2.16120.0 o successivo ne invia una quando la sua configurazione gestita disattiva i marketplace dei plugin aggiunti dall'utente. Se la tua flotta limita i marketplace, imposta `strictKnownMarketplaces` nella fonte vincente. Richiede Claude Code v2.1.282 o successivo.463* **`strictKnownMarketplaces`**: Claude Code rispetta un'allowlist dei marketplace di plugin fornita dal parent quando la sorgente gestita vincente non ne imposta una. Claude Desktop 2.16120.0 o successivo ne invia una quando la sua configurazione gestita disattiva i marketplace di plugin aggiunti dall'utente. Se il tuo parco macchine limita i marketplace, imposta `strictKnownMarketplaces` nella sorgente vincente. Richiede Claude Code v2.1.282 o successivo.

464* **`blockedMarketplaces`**: una lista di blocco dei marketplace fornita dal padre passa e si aggiunge a qualsiasi lista di blocco che una fonte gestita imposta, poiché una lista di blocco può solo limitare ulteriormente. Richiede Claude Code v2.1.282 o successivo.464* **`blockedMarketplaces`**: una blocklist dei marketplace fornita dal parent supera il filtro e si aggiunge a qualsiasi blocklist impostata da una sorgente gestita, poiché una blocklist può solo restringere ulteriormente. Richiede Claude Code v2.1.282 o successivo.

465* **`strictPluginOnlyCustomization`**: questa chiave passa il filtro indipendentemente da qualsiasi blocco, e fa sì che Claude Code ignori la personalizzazione dello sviluppatore, inclusi gli hook protettivi. Nessun blocco la blocca.465* **`strictPluginOnlyCustomization`**: questa chiave supera il filtro indipendentemente da qualsiasi blocco, e fa sì che Claude Code ignori le personalizzazioni dello sviluppatore, inclusi gli hook di protezione. Nessun blocco la blocca.

466 466 

467Con l'impostazione predefinita first-wins, un valore di amministrazione blocca quello del padre solo quando si trova nella fonte di amministrazione con la priorità più alta, tranne per `allowedMcpServers` mentre il [blocco dei server MCP](#lock-behavior-across-sources) è attivo. Con l'opt-in di merge `managedSourcesBehavior`, [come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) indica invece quale valore di fonte si applica.467Con l'impostazione predefinita first-wins, un valore di amministrazione blocca quello del parent solo quando si trova nella sorgente di amministrazione con priorità più alta, tranne che per `allowedMcpServers` mentre il [blocco dei server MCP](#lock-behavior-across-sources) è attivo. Con l'opt-in al merge `managedSourcesBehavior`, [come Claude Code combina le sorgenti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) indica invece quale valore di sorgente si applica.

468 468 

469<h3 id="connect-claude-desktop">469<h3 id="connect-claude-desktop">

470 Connetti Claude Desktop470 Connettere Claude Desktop

471</h3>471</h3>

472 472 

473[Claude Desktop](/docs/it/desktop) si connette allo stesso gateway attraverso una chiave MDM diversa: imposta `bootstrapUrl` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop a `<listen.public_url>/user/bootstrap`, e abilita l'opt-in della politica dell'utente con una chiave `desktop`. [L'overlay di Claude Desktop](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) copre entrambe le metà. Richiede Claude Code v2.1.203 o successivo sul server gateway.473[Claude Desktop](/docs/it/desktop) si connette allo stesso gateway tramite una chiave MDM diversa: imposta `bootstrapUrl` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop su `<listen.public_url>/user/bootstrap`, e abilita la policy dell'utente con una chiave `desktop`. [Overlay di Claude Desktop](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) tratta entrambe le parti. Richiede Claude Code v2.1.203 o successivo sul server gateway.

474 474 

475Claude Desktop fa accedere lo sviluppatore tramite il provider di identità del gateway con lo stesso passaggio SSO nel browser, quindi recupera la sua configurazione dal gateway invece che da Anthropic. L'accesso ai modelli e la politica seguono le stesse regole per gruppo della CLI. Uno sviluppatore che utilizza sia la CLI che Claude Desktop accede a ciascuno separatamente; la sessione del gateway non è condivisa tra loro.475Claude Desktop fa accedere lo sviluppatore tramite l'identity provider del gateway con lo stesso passaggio SSO nel browser, poi recupera la propria configurazione dal gateway invece che da Anthropic. L'accesso ai modelli e la policy seguono le stesse regole per gruppo della CLI. Uno sviluppatore che usa sia la CLI sia Claude Desktop accede a ciascuno separatamente; la sessione del gateway non è condivisa tra i due.

476 476 

477Una volta connesso, Claude Desktop invia richieste di modello da ogni scheda abilitata attraverso il gateway. Mostra le schede Cowork e Code per impostazione predefinita. Per attivare anche la scheda Chat, imposta `chatTabEnabled` a `true` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop, o nel [blocco `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) della politica su un gateway che esegue Claude Code v2.1.227 o successivo.477Una volta connesso, Claude Desktop invia le richieste al modello da ogni scheda abilitata attraverso il gateway. Mostra per impostazione predefinita le schede Cowork e Code. Per attivare anche la scheda Chat, imposta `chatTabEnabled` su `true` nella [configurazione gestita](https://claude.com/docs/third-party/claude-desktop/configuration) di Claude Desktop, oppure nel [blocco `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) della policy su un gateway che esegue Claude Code v2.1.227 o successivo.

478 478 

479<h3 id="ci-pipelines-and-remote-machines">479<h3 id="ci-pipelines-and-remote-machines">

480 Pipeline CI e macchine remote480 Pipeline CI e macchine remote

481</h3>481</h3>

482 482 

483Non esiste un flusso di token di servizio per le pipeline non presidiate. L'accesso al gateway esegue sempre il flusso del dispositivo nel browser, quindi un job CI senza uno sviluppatore che approvi l'accesso non può autenticarsi; configura questi job direttamente con il tuo provider.483Non esiste un flusso con token di servizio per le pipeline non presidiate. L'accesso al gateway esegue sempre il device flow nel browser, quindi un job CI senza uno sviluppatore che approvi l'accesso non può autenticarsi; configura questi job direttamente con il tuo provider.

484 484 

485Una volta che uno sviluppatore ha effettuato l'accesso, ogni sessione di Claude Code su quella macchina utilizza la sessione del gateway, incluse le esecuzioni non interattive `claude -p` e le sessioni avviate dall'Agent SDK. Claude Code applica la [politica del gateway](/docs/it/claude-apps-gateway-config#managed) a ciascuna di esse.485Una volta che uno sviluppatore ha effettuato l'accesso, ogni sessione di Claude Code su quella macchina usa la sessione del gateway, incluse le esecuzioni non interattive di `claude -p` e le sessioni avviate dall'Agent SDK. Claude Code applica la [policy del gateway](/docs/it/claude-apps-gateway-config#managed) a ciascuna di esse.

486 486 

487Il flusso del dispositivo separa la CLI che esegue il polling dal browser che approva, quindi una macchina di sviluppo remota senza display funziona comunque: lo sviluppatore esegue `/login` via SSH sulla macchina remota e apre il link di verifica nel browser sul suo laptop.487Il device flow separa la CLI che esegue il polling dal browser che approva, quindi funziona anche una macchina di sviluppo remota senza display: lo sviluppatore esegue `/login` via SSH sulla macchina remota e apre il link di verifica nel browser del proprio laptop.

488 488 

489<h3 id="whats-enforced-on-developers">489<h3 id="whats-enforced-on-developers">

490 Cosa viene applicato agli sviluppatori490 Cosa viene imposto agli sviluppatori

491</h3>491</h3>

492 492 

493Queste garanzie si applicano a ogni sessione connessa tramite `/login`. Le sessioni incorporate che Claude Desktop avvia ottengono la loro politica come descritto in [Fornisci la politica alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e il punto sulla telemetria indica dove vanno le loro esportazioni.493Queste garanzie si applicano a ogni sessione con accesso effettuato tramite `/login`. Le sessioni incorporate avviate da Claude Desktop ricevono la propria policy come descritto in [Fornire la policy alle sessioni di Claude Desktop](#deliver-policy-to-claude-desktop-sessions), e il punto sulla telemetria indica dove vanno le loro esportazioni.

494 494 

495* **Accesso ai modelli**: le richieste per i modelli che la politica non concede restituiscono 400, e il selettore `/model` viene filtrato all'allowlist `availableModels` della politica. Questo include il modello con cui una sessione si avvia prima che lo sviluppatore ne scelga uno; consulta [Avvia le sessioni su un modello consentito dalla politica](/docs/it/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows).495* **Accesso ai modelli**: le richieste per modelli che la policy non concede restituiscono 400, e il selettore `/model` è filtrato in base all'allowlist `availableModels` della policy. Questo include il modello con cui una sessione si avvia prima che lo sviluppatore ne scelga uno; consulta [Avviare le sessioni su un modello consentito dalla policy](/docs/it/claude-apps-gateway-config#start-sessions-on-a-model-the-policy-allows).

496* **Destinazione della telemetria**: nelle sessioni connesse tramite `/login`, la CLI invia le sue esportazioni OTLP/HTTP al gateway piuttosto che a un `OTEL_EXPORTER_OTLP_ENDPOINT` impostato localmente, a meno che una politica non [indichi il tuo raccoglitore come endpoint](/docs/it/claude-apps-gateway-config#export-directly-to-your-collector). Il gateway inoltra le esportazioni che riceve alle destinazioni in [`telemetry.forward_to`](/docs/it/claude-apps-gateway-config#telemetry).496* **Destinazione della telemetria**: nelle sessioni con accesso effettuato tramite `/login`, la CLI invia le proprie esportazioni OTLP/HTTP al gateway invece che a un `OTEL_EXPORTER_OTLP_ENDPOINT` impostato localmente, a meno che una policy [non indichi il tuo collector come endpoint](/docs/it/claude-apps-gateway-config#export-directly-to-your-collector). Il gateway inoltra le esportazioni che riceve alle destinazioni in [`telemetry.forward_to`](/docs/it/claude-apps-gateway-config#telemetry).

497 * Nelle sessioni incorporate che [Claude Desktop avvia](#connect-claude-desktop), la CLI invia le sue esportazioni al `OTEL_EXPORTER_OTLP_ENDPOINT` configurato. La CLI allega il token di sessione del gateway a quelle esportazioni solo quando quell'endpoint punta al gateway stesso.497 * Nelle sessioni incorporate [avviate da Claude Desktop](#connect-claude-desktop), la CLI invia le proprie esportazioni all'`OTEL_EXPORTER_OTLP_ENDPOINT` configurato. La CLI allega il token di sessione del gateway a queste esportazioni solo quando quell'endpoint punta al gateway stesso.

498 * Senza una destinazione configurata per un segnale, il gateway lo accetta e lo scarta.498 * Se per un segnale non è configurata alcuna destinazione, il gateway lo accetta e lo scarta.

499 * Se raccogli già la telemetria di Claude Code direttamente, aggiungi il tuo raccoglitore come destinazione `forward_to`, o indicalo in una politica per saltare l'inoltro.499 * Se raccogli già la telemetria di Claude Code direttamente, aggiungi il tuo collector come destinazione `forward_to`, oppure indicalo in una policy per saltare l'inoltro.

500* **Credenziali**: il token del gateway è l'unica credenziale della sessione. I [profili Anthropic](/docs/it/authentication#anthropic-profiles-and-federation-credentials) e qualsiasi accesso precedente a claude.ai vengono ignorati mentre sei connesso, quindi gli sviluppatori non hanno bisogno di disconnettersi prima da claude.ai. Per una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` configurata, o una chiave API salvata da un accesso precedente a Claude Console, consulta [La politica dell'amministratore richiede un accesso al gateway Cloud](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in).500* **Credenziali**: il token del gateway è l'unica credenziale della sessione. I [profili Anthropic](/docs/it/authentication#anthropic-profiles-and-federation-credentials) e qualsiasi precedente accesso a claude.ai vengono ignorati mentre si è connessi, quindi gli sviluppatori non devono prima uscire da claude.ai. Per una credenziale `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` o `apiKeyHelper` configurata, o una chiave API salvata da un precedente accesso a Claude Console, consulta [Il criterio dell'amministratore richiede un accesso tramite Cloud gateway](/docs/it/errors#administrator-policy-requires-a-cloud-gateway-sign-in).

501* **Impostazioni gestite**: le chiavi bloccate non possono essere sovrascritte localmente. La CLI applica la politica all'avvio e applica le modifiche a ogni polling orario, a parte le [modifiche che si applicano solo al prossimo avvio](/docs/it/server-managed-settings#fetch-and-caching-behavior).501* **Impostazioni gestite**: le chiavi bloccate non possono essere sovrascritte localmente. La CLI applica la policy all'avvio e applica le modifiche a ogni polling orario, a parte le [modifiche che si applicano solo al successivo avvio](/docs/it/server-managed-settings#fetch-and-caching-behavior).

502* **Avvio con il gateway irraggiungibile**: le sessioni connesse escono all'avvio con un errore dopo circa 10 secondi piuttosto che avviarsi senza le loro impostazioni.502* **Avvio con il gateway irraggiungibile**: le sessioni con accesso effettuato terminano all'avvio con un errore dopo circa 10 secondi invece di avviarsi senza le proprie impostazioni.

503* **Avvio dopo che il gateway termina la sessione**: consulta [Applica l'avvio fail-closed](/docs/it/server-managed-settings#enforce-fail-closed-startup) per gli avvii che si aprono disconnessi dal gateway e quelli che escono quando il gateway risponde con un `401`.503* **Avvio dopo che il gateway ha terminato la sessione**: consulta [Imporre l'avvio fail-closed](/docs/it/server-managed-settings#enforce-fail-closed-startup) per gli avvii che si aprono senza accesso al gateway e quelli che terminano quando il gateway risponde con un `401`.

504* **Deprovisioning**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il prossimo aggiornamento non riesce.504* **Deprovisioning**: una sessione il cui utente è disabilitato nell'IdP scade entro `ttl_hours` quando il rinnovo successivo fallisce.

505* **Disconnessione**: `/logout` elimina la credenziale del gateway dalla macchina dello sviluppatore.505* **Disconnessione**: `/logout` elimina la credenziale del gateway dalla macchina dello sviluppatore.

506 * Quando il documento di discovery del gateway pubblicizza un `revocation_endpoint` sullo stesso schema, host e porta dell'URL del gateway, `/logout` invia anche i token archiviati a quell'endpoint in modo che il gateway possa terminare la sessione dal suo lato. La richiesta è best effort, quindi la disconnessione si completa sulla macchina dello sviluppatore indipendentemente dal fatto che l'endpoint risponda. La revoca richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore.506 * Quando il documento di discovery del gateway dichiara un `revocation_endpoint` con lo stesso schema, host e porta dell'URL del gateway, `/logout` invia anche i token memorizzati a quell'endpoint, in modo che il gateway possa terminare la sessione dal proprio lato. La richiesta è best effort, quindi la disconnessione si completa sulla macchina dello sviluppatore indipendentemente dal fatto che l'endpoint risponda. La revoca richiede Claude Code v2.1.275 o successivo sulla macchina dello sviluppatore.

507 * Il server gateway nel binario `claude` non ne pubblicizza nessuno, quindi una disconnessione da esso termina la sessione solo sulla macchina dello sviluppatore. Per forzare la chiusura delle sessioni lato server, consulta [Rotazione del segreto JWT](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation).507 * Il server gateway incluso nel binario `claude` non ne dichiara alcuno, quindi una disconnessione da esso termina la sessione solo sulla macchina dello sviluppatore. Per forzare la chiusura delle sessioni lato server, consulta [Rotazione del segreto JWT](/docs/it/claude-apps-gateway-deploy#jwt-secret-rotation).

508 508 

509<h3 id="what-the-organization-can-see">509<h3 id="what-the-organization-can-see">

510 Cosa può vedere l'organizzazione510 Cosa può vedere l'organizzazione

511</h3>511</h3>

512 512 

513La telemetria di utilizzo porta al raccoglitore dell'organizzazione l'identità dello sviluppatore, i conteggi dei token, il modello e la latenza. Il gateway non registra né archivia il contenuto dei prompt o dei completamenti. Se venga raccolta una telemetria più ricca come log e tracce, che può includere comandi e percorsi di file, è una [scelta per destinazione](/docs/it/claude-apps-gateway-config#telemetry) dell'organizzazione.513La telemetria di utilizzo trasmette al collector dell'organizzazione l'identità dello sviluppatore, il numero di token, il modello e la latenza. Il gateway non registra né memorizza il contenuto dei prompt o delle risposte generate. Se venga raccolta una telemetria più ricca come log e trace, che può includere comandi e percorsi di file, è una [scelta per destinazione](/docs/it/claude-apps-gateway-config#telemetry) dell'organizzazione.

514 514 

515<h2 id="availability-and-limitations">515<h2 id="availability-and-limitations">

516 Disponibilità e limitazioni516 Disponibilità e limitazioni


523| Funzionalità | Stato | Note |523| Funzionalità | Stato | Note |

524| - | - | - |524| - | - | - |

525| Inoltro di inferenza (Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, Microsoft Foundry, Anthropic) | Disponibile | Con traduzione del modello per upstream e failover. L'upstream Amazon Bedrock utilizza l'endpoint `bedrock-runtime` e la catena di credenziali predefinita AWS. L'[upstream Amazon Bedrock Mantle](/docs/it/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) richiede Claude Code v2.1.283 o successivo sul server gateway, e l'[upstream Claude Platform su AWS](/docs/it/claude-apps-gateway-config#claude-platform-on-aws) richiede v2.1.198 o successivo. |525| Inoltro di inferenza (Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, Microsoft Foundry, Anthropic) | Disponibile | Con traduzione del modello per upstream e failover. L'upstream Amazon Bedrock utilizza l'endpoint `bedrock-runtime` e la catena di credenziali predefinita AWS. L'[upstream Amazon Bedrock Mantle](/docs/it/claude-apps-gateway-config#amazon-bedrock-mantle-endpoint) richiede Claude Code v2.1.283 o successivo sul server gateway, e l'[upstream Claude Platform su AWS](/docs/it/claude-apps-gateway-config#claude-platform-on-aws) richiede v2.1.198 o successivo. |

526| Finestra di contesto da 1M token | Disponibile | I modelli Fable, Sonnet 5 e successivi, e Opus 4.7 e successivi funzionano con la finestra da 1M per impostazione predefinita; vedi [Contesto esteso](/docs/it/model-config#extended-context). L'impostazione predefinita da 1M per i modelli Fable e Opus richiede Claude Code v2.1.287 o successivo sulla macchina dello sviluppatore |

526| Accesso ai modelli e impostazioni gestite per gruppo IdP | Disponibile | L'accesso ai modelli viene applicato lato server; le impostazioni gestite vengono consegnate per gruppo IdP e applicate dal CLI al [livello di impostazioni gestite](/docs/it/settings#settings-precedence) |527| Accesso ai modelli e impostazioni gestite per gruppo IdP | Disponibile | L'accesso ai modelli viene applicato lato server; le impostazioni gestite vengono consegnate per gruppo IdP e applicate dal CLI al [livello di impostazioni gestite](/docs/it/settings#settings-precedence) |

527| Claude Desktop | Disponibile con consenso esplicito | Il gateway fornisce la configurazione di Claude Desktop su `/user/bootstrap` una volta che una politica [acconsente con una chiave `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay), e Claude Desktop invia richieste di modello dalle sue schede Cowork e Code, e dalla scheda Chat quando la abiliti, attraverso il gateway. Per attivare la scheda Chat, vedi [Connetti Claude Desktop](#connect-claude-desktop). Richiede Claude Code v2.1.203 o successivo sul server gateway. |528| Claude Desktop | Disponibile con consenso esplicito | Il gateway fornisce la configurazione di Claude Desktop su `/user/bootstrap` una volta che una politica [acconsente con una chiave `desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay), e Claude Desktop invia richieste di modello dalle sue schede Cowork e Code, e dalla scheda Chat quando la abiliti, attraverso il gateway. Per attivare la scheda Chat, vedi [Connetti Claude Desktop](#connect-claude-desktop). Richiede Claude Code v2.1.203 o successivo sul server gateway. |

528| Fan-out di telemetria (OTLP/HTTP) | Disponibile | Identità-timbrato per esportazione; entrambe le codifiche protobuf e JSON |529| Fan-out di telemetria (OTLP/HTTP) | Disponibile | Identità-timbrato per esportazione; entrambe le codifiche protobuf e JSON |

Details

6 6 

7> Registrare il gateway con il vostro IdP, costruire il container, distribuire su Kubernetes o Cloud Run, e gestirlo: controlli di integrità, rotazione dei segreti, aggiornamenti e sicurezza.7> Registrare il gateway con il vostro IdP, costruire il container, distribuire su Kubernetes o Cloud Run, e gestirlo: controlli di integrità, rotazione dei segreti, aggiornamenti e sicurezza.

8 8 

9<Info>

10 **Pianifica prima la rete del tuo gateway.** All'accesso, Claude Code rifiuta un gateway delle app Claude il cui nome host si risolve in un indirizzo IP pubblico, anche se non è raggiungibile da internet.

11 

12 Un gateway delle app Claude può inviare impostazioni alle macchine degli utenti, inclusi hook che eseguono comandi della shell. Il controllo aiuta a evitare che gli utenti accedano accidentalmente a un gateway dannoso su internet pubblico. Tieni anche il tuo gateway fuori da internet.

13 

14 Scegli l'indirizzo del gateway prima di scegliere dove eseguirlo. Di solito si tratta di un indirizzo privato che gli utenti raggiungono sulla tua rete interna o tramite una VPN. Se la tua rete interna usa intervalli IPv4 pubblici, puoi indicare un intervallo che contenga sia il gateway sia le macchine dei tuoi utenti. Claude Code interpreta questa corrispondenza come un segnale che il gateway si trova sulla tua rete interna. Consulta [Scegliere un indirizzo per il gateway](#choose-an-address-for-the-gateway). Se nessuna delle due opzioni è adatta alla tua rete, contatta il tuo team di riferimento Anthropic.

15</Info>

16 

9Questa pagina copre il lato operativo dell'esecuzione del [gateway delle app Claude](/docs/it/claude-apps-gateway): registrazione di un client OAuth nel vostro provider di identità (IdP), distribuzione del gateway come container, e gestione quotidiana. Per ogni opzione nel file `gateway.yaml` che il gateway legge all'avvio, consultare il [Riferimento di configurazione](/docs/it/claude-apps-gateway-config).17Questa pagina copre il lato operativo dell'esecuzione del [gateway delle app Claude](/docs/it/claude-apps-gateway): registrazione di un client OAuth nel vostro provider di identità (IdP), distribuzione del gateway come container, e gestione quotidiana. Per ogni opzione nel file `gateway.yaml` che il gateway legge all'avvio, consultare il [Riferimento di configurazione](/docs/it/claude-apps-gateway-config).

10 18 

11Una distribuzione in produzione segue quattro passaggi in ordine, e le sezioni sottostanti li corrispondono. I primi due sono dove fate scelte; i secondi due sono materiale di riferimento da consultare una volta che è in esecuzione.19Una distribuzione in produzione segue quattro passaggi in ordine, e le sezioni sottostanti li corrispondono. I primi due sono dove fate scelte; i secondi due sono materiale di riferimento da consultare una volta che è in esecuzione.


17 25 

18Se un accesso o un avvio fallisce lungo il percorso, andare direttamente a [Troubleshooting](#troubleshooting), che è indicizzato in base all'errore che vedete.26Se un accesso o un avvio fallisce lungo il percorso, andare direttamente a [Troubleshooting](#troubleshooting), che è indicizzato in base all'errore che vedete.

19 27 

20<Note>

21 **Distribuire sulla vostra rete privata.** Claude Code si connette solo a un gateway il cui indirizzo è privato. Questo è un meccanismo di sicurezza, perché un gateway affidabile può inviare impostazioni che eseguono comandi sulle macchine degli sviluppatori. Mettere il gateway dietro un load balancer interno o una VPN e dargli un nome host che si risolve solo in indirizzi IP privati. Se la vostra rete interna è numerata da spazio IPv4 pubblico che la vostra organizzazione possiede, consultare [Consentire un gateway su spazio di indirizzi pubblici che possedete](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own).

22</Note>

23 

24<h2 id="identity-provider-setup">28<h2 id="identity-provider-setup">

25 Configurazione del provider di identità29 Configurazione del provider di identità

26</h2>30</h2>


51 Distribuzione55 Distribuzione

52</h2>56</h2>

53 57 

54Il gateway è un singolo binario Linux senza stato che si coordina attraverso Postgres, quindi distribuiscilo come distribuisci qualsiasi altro servizio senza stato nel tuo ambiente. Mantienilo all'interno della tua rete, dove i tuoi sviluppatori e il tuo IdP possono raggiungerlo su HTTPS, e trattalo come qualsiasi servizio che contiene una credenziale di produzione.58Il gateway è un singolo binario Linux senza stato che si coordina attraverso Postgres, quindi distribuiscilo come distribuisci qualsiasi altro servizio senza stato nel tuo ambiente. Mantienilo all'interno della tua rete, dove i tuoi sviluppatori possono raggiungerlo su HTTPS e da dove esso può raggiungere il tuo IdP, e trattalo come qualsiasi servizio che contiene una credenziale di produzione.

55 59 

56Alcune decisioni modellano la distribuzione oltre a dove viene eseguito:60Alcune decisioni modellano la distribuzione oltre a dove viene eseguito:

57 61 


71 75 

72Un valore predefinito come i 60 secondi dell'ALB è sufficiente per mantenere aperto un flusso silenzioso. L'[esempio elaborato di AWS](/docs/it/claude-apps-gateway-on-aws#troubleshooting) lo aumenta a un'ora comunque, e la sua riga di troubleshooting copre i gateway più vecchi di v2.1.229, che non hanno inviato nulla durante i periodi silenziosi sugli upstream che ora ricevono ping.76Un valore predefinito come i 60 secondi dell'ALB è sufficiente per mantenere aperto un flusso silenzioso. L'[esempio elaborato di AWS](/docs/it/claude-apps-gateway-on-aws#troubleshooting) lo aumenta a un'ora comunque, e la sua riga di troubleshooting copre i gateway più vecchi di v2.1.229, che non hanno inviato nulla durante i periodi silenziosi sugli upstream che ora ricevono ping.

73 77 

78<h3 id="choose-an-address-for-the-gateway">

79 Scegli un indirizzo per il gateway

80</h3>

81 

82Claude Code accetta l'indirizzo di un gateway in uno di due modi:

83 

84* **Indirizzo privato**: metti il gateway dietro un load balancer interno o una VPN, con un nome host che si risolve solo in indirizzi privati, come RFC 1918 o CGNAT `100.64.0.0/10`. Le macchine degli utenti possono avere qualsiasi indirizzo. Il [prerequisito della rete privata](/docs/it/claude-apps-gateway#prerequisites) elenca gli intervalli accettati.

85* **Blocco dichiarato**: se la tua rete interna utilizza spazio IPv4 pubblico di proprietà della tua organizzazione, elenca il blocco nell'impostazione gestita `gatewayInternalNetworks`. Il gateway e la macchina dell'utente devono trovarsi entrambi in quel blocco. Consulta [Consentire un gateway su spazio di indirizzi pubblico di tua proprietà](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own).

86 

87Se nessun singolo blocco li contiene entrambi, assegna invece al gateway un indirizzo privato.

88 

74<h3 id="container-image">89<h3 id="container-image">

75 Immagine del container90 Immagine del container

76</h3>91</h3>


375 Risoluzione dei problemi390 Risoluzione dei problemi

376</h2>391</h2>

377 392 

378Per domande e feedback, utilizza il [supporto Claude Code](https://support.claude.com/en/collections/14445694-claude-code), oppure apri un problema nel [repository GitHub di Claude Code](https://github.com/anthropics/claude-code/issues). Quando segnali un problema, includi:393Per domande e feedback, utilizza il [supporto Claude Code](https://support.claude.com/en/collections/14445694-claude-code), oppure apri un problema nel [repository GitHub di Claude Code](https://github.com/anthropics/claude-code/issues). Puoi anche contattare il team del tuo account Anthropic. Quando segnali un problema, includi:

379 394 

380* **Gateway issue**: lo stderr del gateway per la finestra rilevante, il tuo `gateway.yaml` con i segreti oscurati, la versione del gateway, mostrata nella pagina di destinazione in `/` e nell'intestazione della risposta `x-cc-gateway-version` in `/managed/settings`, e cosa è cambiato di recente395* **Gateway issue**: lo stderr del gateway per la finestra rilevante, il tuo `gateway.yaml` con i segreti oscurati, la versione del gateway, mostrata nella pagina di destinazione in `/` e nell'intestazione della risposta `x-cc-gateway-version` in `/managed/settings`, e cosa è cambiato di recente

381* **Login issue**: lo sviluppatore esegue `claude --debug-file ./claude-debug.txt`, riproduce il problema e invia quel file più il log di audit del gateway per la stessa finestra396* **Login issue**: lo sviluppatore esegue `claude --debug-file ./claude-debug.txt`, riproduce il problema e invia quel file più il log di audit del gateway per la stessa finestra


394| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oppure `Request failed with status code 429` nelle versioni precedenti. La pagina `/device` potrebbe mostrare `Too many attempts` agli sviluppatori che non hanno mai provato prima | È stato raggiunto il rate limit di accesso per IP. O `listen.trusted_proxies` non copre il bilanciatore di carico, quindi ogni sviluppatore condivide il suo indirizzo, oppure molti sviluppatori condividono un indirizzo di uscita NAT o VPN. Gli eventi di audit con `result: rate_limited` mostrano lo stesso uno o pochi valori `client_ip`. | Imposta prima `listen.trusted_proxies` agli intervalli di origine del bilanciatore di carico, quindi aumenta `rate_limits` se gli sviluppatori condividono ancora indirizzi. Vedi [Large rollouts](#large-rollouts). |409| CLI `/login`: `The gateway is limiting sign-in attempts right now`, oppure `Request failed with status code 429` nelle versioni precedenti. La pagina `/device` potrebbe mostrare `Too many attempts` agli sviluppatori che non hanno mai provato prima | È stato raggiunto il rate limit di accesso per IP. O `listen.trusted_proxies` non copre il bilanciatore di carico, quindi ogni sviluppatore condivide il suo indirizzo, oppure molti sviluppatori condividono un indirizzo di uscita NAT o VPN. Gli eventi di audit con `result: rate_limited` mostrano lo stesso uno o pochi valori `client_ip`. | Imposta prima `listen.trusted_proxies` agli intervalli di origine del bilanciatore di carico, quindi aumenta `rate_limits` se gli sviluppatori condividono ancora indirizzi. Vedi [Large rollouts](#large-rollouts). |

395| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Il nome host del gateway si risolve in almeno un indirizzo IP pubblico. Claude Code controlla ogni indirizzo risolto e richiede che tutti siano privati. Una causa comune è un nome dual-stack in cui una famiglia si risolve in un indirizzo pubblico, inclusi i bilanciatori di carico dual-stack interni di AWS, che restituiscono indirizzi AAAA in intervallo pubblico. | Fai in modo che il nome del gateway si risolva solo in indirizzi privati sulle macchine degli sviluppatori. Per un nome dual-stack, elimina il record in intervallo pubblico o servi un nome DNS solo interno separato. Vedi il [prerequisito di rete privata](/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |410| CLI `/login`: `Gateway hosts must be on your organization's private network; <host> resolves to the public (or unrecognized) address <ip>` | Il nome host del gateway si risolve in almeno un indirizzo IP pubblico. Claude Code controlla ogni indirizzo risolto e richiede che tutti siano privati. Una causa comune è un nome dual-stack in cui una famiglia si risolve in un indirizzo pubblico, inclusi i bilanciatori di carico dual-stack interni di AWS, che restituiscono indirizzi AAAA in intervallo pubblico. | Fai in modo che il nome del gateway si risolva solo in indirizzi privati sulle macchine degli sviluppatori. Per un nome dual-stack, elimina il record in intervallo pubblico o servi un nome DNS solo interno separato. Vedi il [prerequisito di rete privata](/docs/it/claude-apps-gateway#prerequisites). Se l'indirizzo è spazio pubblico che la tua organizzazione possiede e utilizza internamente, [dichiara quel blocco](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) invece. |

396| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica all'host del gateway e il nome host del proxy si risolve in un indirizzo pubblico. Un proxy il cui host si risolve solo in indirizzi privati è consentito e non attiva questo errore | Aggiungi l'host del gateway a `NO_PROXY` sulla macchina dello sviluppatore in modo che la connessione sia diretta, oppure utilizza un proxy il cui nome host si risolve in indirizzi privati. Il messaggio nomina la voce esatta `NO_PROXY` da aggiungere |411| CLI `/login`: `Gateway login would go through proxy <proxy>, which is not on a private network` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica all'host del gateway e il nome host del proxy si risolve in un indirizzo pubblico. Un proxy il cui host si risolve solo in indirizzi privati è consentito e non attiva questo errore | Aggiungi l'host del gateway a `NO_PROXY` sulla macchina dello sviluppatore in modo che la connessione sia diretta, oppure utilizza un proxy il cui nome host si risolve in indirizzi privati. Il messaggio nomina la voce esatta `NO_PROXY` da aggiungere |

397| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Il gateway è su un blocco dichiarato in [`gatewayInternalNetworks`](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e la macchina dello sviluppatore l'ha raggiunto da un indirizzo al di fuori di quel blocco: un pool di indirizzi VPN, un segmento NAT di container o WSL2, oppure una rete che non è la tua | Chiedi allo sviluppatore di eseguire `/login` dal sistema operativo host sulla tua rete. Se l'indirizzo mostrato è anche lo spazio pubblico della tua organizzazione, sostituisci la voce del gateway con un blocco che copra entrambi, fino a `/8`; una seconda voce sovrapposta è rifiutata |412| CLI `/login`: `Claude Code only signs in to <host> from inside its declared network <block> (managed settings), and this machine is connecting from <ip>, outside it` | Il gateway è su un blocco dichiarato in [`gatewayInternalNetworks`](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e la macchina dello sviluppatore l'ha raggiunto da un indirizzo al di fuori di quel blocco: un pool di indirizzi VPN, un segmento NAT di container o WSL2, oppure una rete che non è la tua | Chiedi allo sviluppatore di eseguire `/login` dal sistema operativo host sulla tua rete. Se l'indirizzo mostrato è anche lo spazio pubblico della tua organizzazione, sostituisci la voce del gateway con un blocco che copra entrambi, fino a `/8`; una seconda voce sovrapposta è rifiutata. Se nessun blocco copre entrambi, vedi [Scegliere un indirizzo per il gateway](#choose-an-address-for-the-gateway) |

398| CLI `/login`: `Every address for gateway host <host> must be inside its declared network <block>, and it also resolves to <ip>` | Il nome del gateway si risolve in un indirizzo al di fuori del blocco dichiarato in [`gatewayInternalNetworks`](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own): un secondo sito, oppure un record IPv6 su un nome dual-stack. Sotto un blocco dichiarato ogni record deve essere all'interno di quel blocco IPv4, indirizzi privati e IPv6 inclusi | Pubblica solo record all'interno del blocco per il nome del gateway sulle macchine degli sviluppatori, oppure servi un nome solo interno separato |413| CLI `/login`: `Every address for gateway host <host> must be inside its declared network <block>, and it also resolves to <ip>` | Il nome del gateway si risolve in un indirizzo al di fuori del blocco dichiarato in [`gatewayInternalNetworks`](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own): un secondo sito, oppure un record IPv6 su un nome dual-stack. Sotto un blocco dichiarato ogni record deve essere all'interno di quel blocco IPv4, indirizzi privati e IPv6 inclusi | Pubblica solo record all'interno del blocco per il nome del gateway sulle macchine degli sviluppatori, oppure servi un nome solo interno separato |

399| CLI `/login`: `<host> is on the declared network <block>, which Claude Code checks over a direct connection, not through an HTTP proxy` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica a un gateway su un blocco dichiarato | Sulla macchina dello sviluppatore, aggiungi la voce `NO_PROXY` che il messaggio nomina |414| CLI `/login`: `<host> is on the declared network <block>, which Claude Code checks over a direct connection, not through an HTTP proxy` | Un `HTTPS_PROXY` o `HTTP_PROXY` si applica a un gateway su un blocco dichiarato | Sulla macchina dello sviluppatore, aggiungi la voce `NO_PROXY` che il messaggio nomina |

400| CLI `/login`: un messaggio che inizia con `gatewayInternalNetworks in managed settings` | Il valore viola una delle [regole di convalida](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e il messaggio nomina quale. Fino a quando non lo correggi, Claude Code rifiuta ogni nuovo `/login` del gateway sulla macchina, gateway su indirizzi privati inclusi; gli accessi esistenti continuano a funzionare | Nella fonte delle impostazioni gestite che distribuisci, correggi la voce che il messaggio nomina, quindi esegui di nuovo `/login` |415| CLI `/login`: un messaggio che inizia con `gatewayInternalNetworks in managed settings` | Il valore viola una delle [regole di convalida](/docs/it/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own), e il messaggio nomina quale. Fino a quando non lo correggi, Claude Code rifiuta ogni nuovo `/login` del gateway sulla macchina, gateway su indirizzi privati inclusi; gli accessi esistenti continuano a funzionare | Nella fonte delle impostazioni gestite che distribuisci, correggi la voce che il messaggio nomina, quindi esegui di nuovo `/login` |

Details

10 Le sessioni cloud sono disponibili sui piani Pro, Max e Team, e per gli utenti Enterprise con posti premium o posti Chat + Claude Code.10 Le sessioni cloud sono disponibili sui piani Pro, Max e Team, e per gli utenti Enterprise con posti premium o posti Chat + Claude Code.

11</Note>11</Note>

12 12 

13Una sessione cloud è una sessione Claude Code che viene eseguita su infrastruttura cloud invece che sulla tua macchina. Per impostazione predefinita viene eseguita su infrastruttura gestita da Anthropic, oppure sull'[ambiente self-hosted](/docs/it/self-hosted-environments) della tua organizzazione quando instradato lì. La sessione continua a essere eseguita dopo che chiudi il tuo laptop, e puoi controllarla o dirigerla da qualsiasi dispositivo.13Una sessione cloud è una sessione Claude Code che viene eseguita su infrastruttura cloud invece che sulla tua macchina. Per impostazione predefinita viene eseguita su infrastruttura gestita da Anthropic, oppure sull'[ambiente self-hosted](/docs/it/self-hosted-environments) della tua organizzazione quando instradato lì. La sessione continua a essere eseguita dopo che chiudi il tuo laptop, e puoi controllarla o dirigerla da qualsiasi dispositivo. Viene conteggiata nei limiti di utilizzo del tuo piano insieme al resto del tuo utilizzo di Claude e Claude Code, e non c'è alcun addebito separato per la VM cloud.

14 14 

15Per consentire alle sessioni cloud di clonare il tuo codice da GitHub e fare push dei branch, connetti GitHub con uno dei [metodi di connessione GitHub](#github-authentication-options). Se il tuo repository si trova su GitLab, Bitbucket o un altro host, consulta [Restrizioni della piattaforma](#limitations) per sapere cosa funziona.15Per consentire alle sessioni cloud di clonare il tuo codice da GitHub e fare push dei branch, connetti GitHub con uno dei [metodi di connessione GitHub](#github-authentication-options). Se il tuo repository si trova su GitLab, Bitbucket o un altro host, consulta [Restrizioni della piattaforma](#limitations) per sapere cosa funziona.

16 16 


306| `/context` | Sì | Mostra cosa è attualmente nella finestra di contesto |306| `/context` | Sì | Mostra cosa è attualmente nella finestra di contesto |

307| `/clear` | No | Avviare una nuova sessione dalla barra laterale |307| `/clear` | No | Avviare una nuova sessione dalla barra laterale |

308 308 

309La compattazione automatica viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità. Le sessioni cloud impostano [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/env-vars) da sole, quindi la compattazione si attiva a metà della [finestra di auto-compattazione](/docs/it/model-config#set-the-auto-compact-window) piuttosto che quando la finestra si riempie. Questo valore sostituisce uno che si aggiunge nelle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables), quindi aggiungere la variabile lì non cambia quando si attiva la compattazione.309La compattazione automatica viene eseguita automaticamente quando la finestra di contesto si avvicina alla capacità. Le sessioni cloud impostano [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/env-vars) da sole, quindi la compattazione si attiva a un certo punto della [finestra di auto-compattazione](/docs/it/model-config#set-the-auto-compact-window) piuttosto che quando la finestra si riempie. Questo valore sostituisce uno che si aggiunge nelle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables), quindi aggiungere la variabile lì non cambia quando si attiva la compattazione.

310 310 

311Per modificare la finestra di auto-compattazione, impostare [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) nelle variabili di ambiente, oppure eseguire [`/autocompact`](/docs/it/commands#all-commands) con un conteggio di token in una sessione in cui la variabile non è impostata.311Per modificare la finestra di auto-compattazione, impostare [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) nelle variabili di ambiente, oppure eseguire [`/autocompact`](/docs/it/commands#all-commands) con un conteggio di token in una sessione in cui la variabile non è impostata.

312 312 


416* **Macchine virtuali isolate**: ogni sessione viene eseguita in una VM isolata gestita da Anthropic. Le sessioni che la tua organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sulla tua infrastruttura, dove l'isolamento è responsabilità della tua distribuzione416* **Macchine virtuali isolate**: ogni sessione viene eseguita in una VM isolata gestita da Anthropic. Le sessioni che la tua organizzazione instrada a un [ambiente self-hosted](/docs/it/self-hosted-environments) vengono eseguite sulla tua infrastruttura, dove l'isolamento è responsabilità della tua distribuzione

417* <span id="default-allowed-domains" />**Controlli di accesso alla rete**: negli ambienti ospitati da Anthropic, l'accesso alla rete è limitato per impostazione predefinita e può essere disabilitato. Vedi [Accesso alla rete](/docs/it/cloud-environments#network-access) per i livelli di accesso, i [domini consentiti per impostazione predefinita](/docs/it/cloud-environments#default-allowed-domains) e il traffico che non passa attraverso l'allowlist. In un ambiente self-hosted, limiti l'uscita della sessione al tuo confine di rete. Quando viene eseguito con l'accesso alla rete disabilitato, Claude Code può comunque comunicare con l'API Anthropic, che potrebbe consentire ai dati di uscire dalla VM.417* <span id="default-allowed-domains" />**Controlli di accesso alla rete**: negli ambienti ospitati da Anthropic, l'accesso alla rete è limitato per impostazione predefinita e può essere disabilitato. Vedi [Accesso alla rete](/docs/it/cloud-environments#network-access) per i livelli di accesso, i [domini consentiti per impostazione predefinita](/docs/it/cloud-environments#default-allowed-domains) e il traffico che non passa attraverso l'allowlist. In un ambiente self-hosted, limiti l'uscita della sessione al tuo confine di rete. Quando viene eseguito con l'accesso alla rete disabilitato, Claude Code può comunque comunicare con l'API Anthropic, che potrebbe consentire ai dati di uscire dalla VM.

418* **Protezione delle credenziali**: negli ambienti ospitati da Anthropic, le credenziali git e le chiavi di firma rimangono al di fuori della sandbox e un proxy autentica per conto della sessione con credenziali con ambito. In un ambiente self-hosted, la tua distribuzione fornisce credenziali git; vedi [Configura git](/docs/it/self-hosted-environments-deploy#configure-git)418* **Protezione delle credenziali**: negli ambienti ospitati da Anthropic, le credenziali git e le chiavi di firma rimangono al di fuori della sandbox e un proxy autentica per conto della sessione con credenziali con ambito. In un ambiente self-hosted, la tua distribuzione fornisce credenziali git; vedi [Configura git](/docs/it/self-hosted-environments-deploy#configure-git)

419* **Segreti di rete**: negli ambienti ospitati da Anthropic nei piani Pro e Max, le chiavi che [aggiungi a un ambiente cloud](/docs/it/cloud-environments#add-api-credentials) rimangono al di fuori della sandbox allo stesso modo, allegate alle richieste corrispondenti dopo che lasciano la sessione. Un ambiente self-hosted non ha segreti di rete e i piani Team ed Enterprise non li hanno ancora419* **Segreti di rete**: negli ambienti ospitati da Anthropic nei piani Pro e Max, le chiavi che [aggiungi a un ambiente cloud](/docs/it/cloud-environments#add-network-secrets) rimangono al di fuori della sandbox allo stesso modo, allegate alle richieste corrispondenti dopo che lasciano la sessione. Un ambiente self-hosted non ha segreti di rete e i piani Team ed Enterprise non li hanno ancora

420* **Analisi sicura**: il codice viene analizzato e modificato all'interno dell'ambiente isolato della sessione prima di creare PR420* **Analisi sicura**: il codice viene analizzato e modificato all'interno dell'ambiente isolato della sessione prima di creare PR

421 421 

422<h2 id="troubleshooting">422<h2 id="troubleshooting">


491 491 

492Prima di fare affidamento sulle sessioni cloud per un flusso di lavoro, tieni conto di questi vincoli:492Prima di fare affidamento sulle sessioni cloud per un flusso di lavoro, tieni conto di questi vincoli:

493 493 

494* **Limiti di velocità**: le sessioni cloud condividono i limiti di velocità con tutti gli altri utilizzi di Claude e Claude Code all'interno del tuo account. L'esecuzione di più attività in parallelo consuma più limiti di velocità proporzionalmente. Non esiste alcun addebito di calcolo separato per la VM cloud.494* **Rate limit**: le sessioni cloud condividono i rate limit con tutti gli altri utilizzi di Claude e Claude Code all'interno del tuo account. L'esecuzione di più attività in parallelo consuma proporzionalmente più rate limit.

495* **Limiti di tempo**: i comandi che Claude esegue e gli hook SessionStart hanno timeout predefiniti che puoi modificare, e uno script di configurazione viene memorizzato nella cache solo quando termina in circa cinque minuti. Vedi [Limiti di tempo](/docs/it/cloud-environments#time-limits)495* **Limiti di tempo**: i comandi che Claude esegue e gli hook SessionStart hanno timeout predefiniti che puoi modificare, e uno script di configurazione viene memorizzato nella cache solo quando termina in circa cinque minuti. Vedi [Limiti di tempo](/docs/it/cloud-environments#time-limits)

496* **Autenticazione del repository**: puoi estrarre una sessione cloud nel tuo terminale solo quando sei autenticato allo stesso account496* **Autenticazione del repository**: puoi estrarre una sessione cloud nel tuo terminale solo quando sei autenticato allo stesso account

497* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/github-enterprise-server) sono supportate per i piani Team ed Enterprise. Puoi inviare un repository GitLab, Bitbucket o altro non-GitHub a una sessione cloud come [bundle locale](#send-local-repositories-without-github) impostando `CCR_FORCE_BUNDLE=1`, ma la sessione non può eseguire il push dei risultati di nuovo a quel remoto497* **Restrizioni della piattaforma**: il clonaggio del repository e la creazione di pull request richiedono GitHub. Le istanze self-hosted di [GitHub Enterprise Server](/docs/it/github-enterprise-server) sono supportate per i piani Team ed Enterprise. Puoi inviare un repository GitLab, Bitbucket o altro non-GitHub a una sessione cloud come [bundle locale](#send-local-repositories-without-github) impostando `CCR_FORCE_BUNDLE=1`, ma la sessione non può eseguire il push dei risultati di nuovo a quel remoto

Details

215 1. Configurare le credenziali AWS215 1. Configurare le credenziali AWS

216</h3>216</h3>

217 217 

218Claude Code supporta due metodi di autenticazione per Claude Platform on AWS. Scegliere il metodo che si adatta al modo in cui il team gestisce l'accesso.218Claude Code supporta due metodi di autenticazione per Claude Platform on AWS. Scegli il metodo che si adatta al modo in cui il tuo team gestisce l'accesso:

219 219 

220**Opzione A: Credenziali AWS con SigV4**220* [Credenziali AWS con SigV4](#use-aws-credentials-with-sigv4): autenticati come principal IAM, con le credenziali provenienti dalla catena di credenziali AWS standard

221* [Chiave API del workspace](#use-a-workspace-api-key): autenticati con una chiave di lunga durata che generi nella console AWS

222 

223<h4 id="use-aws-credentials-with-sigv4">

224 Usa le credenziali AWS con SigV4

225</h4>

221 226 

222Claude Code firma le richieste con SigV4 utilizzando la catena di credenziali AWS standard: variabili di ambiente, credenziali condivise in `~/.aws/credentials`, ruoli IAM, sessioni AWS SSO e qualsiasi altra fonte supportata dall'SDK AWS.227Claude Code firma le richieste con SigV4 utilizzando la catena di credenziali AWS standard: variabili di ambiente, credenziali condivise in `~/.aws/credentials`, ruoli IAM, sessioni AWS SSO e qualsiasi altra fonte supportata dall'SDK AWS.

223 228 


242 247 

243Con `awsAuthRefresh` configurato, eseguire `/login`, selezionare **3rd-party platform**, quindi selezionare **Claude Platform on AWS · refresh credentials** in **Using 3rd-party platforms**. Claude Code esegue il comando configurato e rilegge le credenziali AWS senza un riavvio.248Con `awsAuthRefresh` configurato, eseguire `/login`, selezionare **3rd-party platform**, quindi selezionare **Claude Platform on AWS · refresh credentials** in **Using 3rd-party platforms**. Claude Code esegue il comando configurato e rilegge le credenziali AWS senza un riavvio.

244 249 

245**Opzione B: Chiave API dell'area di lavoro**250<h4 id="use-a-workspace-api-key">

251 Usa una chiave API del workspace

252</h4>

246 253 

247Una chiave API dell'area di lavoro è un segreto di lunga durata, utile quando non si desidera gestire credenziali AWS federate. Generarne una nella console AWS in **Claude Platform on AWS → API keys** e impostarla come `ANTHROPIC_AWS_API_KEY`:254Una chiave API dell'area di lavoro è un segreto di lunga durata, utile quando non si desidera gestire credenziali AWS federate. Generarne una nella console AWS in **Claude Platform on AWS → API keys** e impostarla come `ANTHROPIC_AWS_API_KEY`:

248 255 

claude-projects.md +18 −18

Details

322| :- | :- | :- |322| :- | :- | :- |

323| Memoria del progetto | Note che Claude mantiene sul progetto, come requisiti, decisioni e insidie, archiviate come file. Ogni thread cloud legge il file di indice `MEMORY.md` quando inizia e apre gli altri file quando ne ha bisogno | Chiedi a Claude nella conversazione del progetto o in qualsiasi thread cloud di ricordare un requisito, una decisione o un'insidia, oppure di dimenticarla. Leggi, modifica ed elimina i file in **Project settings > Memory** |323| Memoria del progetto | Note che Claude mantiene sul progetto, come requisiti, decisioni e insidie, archiviate come file. Ogni thread cloud legge il file di indice `MEMORY.md` quando inizia e apre gli altri file quando ne ha bisogno | Chiedi a Claude nella conversazione del progetto o in qualsiasi thread cloud di ricordare un requisito, una decisione o un'insidia, oppure di dimenticarla. Leggi, modifica ed elimina i file in **Project settings > Memory** |

324| Istruzioni del progetto | Testo inviato a ogni nuovo thread e a Claude nella conversazione del progetto, fino a 16.000 caratteri. [Write project instructions](#write-project-instructions) copre cosa inserirvi | **Project settings > Memory > Project instructions**, oppure chiedi a Claude di modificare le istruzioni |324| Istruzioni del progetto | Testo inviato a ogni nuovo thread e a Claude nella conversazione del progetto, fino a 16.000 caratteri. [Write project instructions](#write-project-instructions) copre cosa inserirvi | **Project settings > Memory > Project instructions**, oppure chiedi a Claude di modificare le istruzioni |

325| Repository, file e ambiente | I repository che ogni thread cloud clona, le cartelle e i file che può leggere in `/mnt/project-files`, e l'ambiente cloud in cui vengono eseguiti i thread | Repository e ambiente in **Project settings > Environment**, oppure chiedi a Claude nella conversazione di aggiungere un repository al progetto. [File e cartelle](#add-files-and-folders) da **Add** nella scheda **Library** in **Overview** |325| Repository, file e ambiente | I repository che ogni thread cloud clona, le cartelle e i file che può leggere in `/mnt/project-files`, e l'ambiente cloud in cui viene eseguito | Repository e ambiente in **Project settings > Environment**, oppure chiedi a Claude nella conversazione di aggiungere un repository al progetto. [File e cartelle](#add-files-and-folders) da **Add** nella scheda **Library** in **Overview** |

326 326 

327**Project settings > Memory** elenca questi file in **Auto memory**, perché Claude li scrive da solo mentre lavora nel progetto. Sono separati dall'[auto memory](/docs/it/memory) che Claude Code mantiene sulla tua macchina, anche se entrambi utilizzano un indice `MEMORY.md`. La memoria del progetto è anche separata dai file `CLAUDE.md` nei repository del progetto. Ogni thread cloud legge comunque quei file `CLAUDE.md` dal suo clone quando inizia, quindi inserisci le istruzioni su un repository nel suo `CLAUDE.md` e le note sul progetto nella memoria del progetto.327**Project settings > Memory** elenca questi file in **Auto memory**, perché Claude li scrive da solo mentre lavora nel progetto. Sono separati dalla [memoria automatica](/docs/it/memory) che Claude Code mantiene sulla tua macchina, anche se entrambe utilizzano un indice `MEMORY.md`. La memoria del progetto è anche separata dai file `CLAUDE.md` nei repository del progetto. Ogni thread cloud legge comunque quei file `CLAUDE.md` dal suo clone quando inizia, quindi inserisci le istruzioni su un repository nel suo `CLAUDE.md` e le note sul progetto nella memoria del progetto.

328 328 

329<h3 id="write-project-instructions">329<h3 id="write-project-instructions">

330 Scrivi le istruzioni del progetto330 Scrivi le istruzioni del progetto


349- Non eseguire merge, force-push o modificare la configurazione CI senza chiedermi nel thread.349- Non eseguire merge, force-push o modificare la configurazione CI senza chiedermi nel thread.

350```350```

351 351 

352Le regole su un repository, come i suoi comandi di build, appartengono al `CLAUDE.md` di quel repository, che ogni thread cloud legge quando il repository fa parte del progetto. Una volta che il lavoro è in corso, quando correggi un thread, chiedi anche a Claude di ricordare la correzione: va nella [memoria del progetto](#give-a-project-standing-context) e i thread successivi iniziano con essa.352Le regole su un repository, come i suoi comandi di build, appartengono al `CLAUDE.md` di quel repository, che ogni thread cloud legge quando il repository fa parte del progetto. Una volta che il lavoro è in corso, quando correggi un thread, chiedi anche a Claude di ricordare la correzione: va nella [memoria del progetto](#give-a-project-standing-context) e i thread cloud successivi iniziano con essa.

353 353 

354<h3 id="decide-which-repositories-to-add">354<h3 id="decide-which-repositories-to-add">

355 Decidi quali repository aggiungere355 Decidi quali repository aggiungere

356</h3>356</h3>

357 357 

358I repository che aggiungi a un progetto vengono forniti con tutto ciò che contengono, il loro codice, `CLAUDE.md` e skills, in ogni thread cloud. I repository che non aggiungi sono comunque raggiungibili: un thread cloud può aggiungerne uno a se stesso quando il suo compito lo richiede. La maggior parte dei progetti utilizza entrambi:358I repository che aggiungi a un progetto vengono forniti con tutto ciò che contengono, il loro codice, `CLAUDE.md` e skill, in ogni thread cloud. I repository che non aggiungi sono comunque raggiungibili: un thread cloud può aggiungerne uno a se stesso quando il suo compito lo richiede. La maggior parte dei progetti utilizza entrambi:

359 359 

360* **Aggiungilo al progetto**, nella finestra di dialogo **New project**, in **Project settings > Environment**, oppure chiedendo a Claude nella conversazione di aggiungerlo al progetto. Ogni thread da quel momento in poi lo clona e inizia con il suo `CLAUDE.md` e le sue skills caricati, indipendentemente dal fatto che il compito lo tocchi o meno. Passare da un repository a diversi cambia anche ciò che i thread prendono dal `.claude/settings.json` di ogni repository; vedi [What threads pick up from your repositories](#what-threads-pick-up-from-your-repositories).360* **Aggiungilo al progetto**, nella finestra di dialogo **New project**, in **Project settings > Environment**, oppure chiedendo a Claude nella conversazione di aggiungerlo al progetto. Ogni thread cloud da quel momento in poi lo clona e inizia con il suo `CLAUDE.md` e le sue skill caricati, indipendentemente dal fatto che il compito lo tocchi o meno. Passare da un repository a diversi cambia anche ciò che i thread prendono dal `.claude/settings.json` di ogni repository; vedi [What threads pick up from your repositories](#what-threads-pick-up-from-your-repositories).

361* **Lascialo fuori e lascia che i thread lo aggiungano quando necessario.** Un thread cloud il cui compito richiede un repository che il progetto non ha può aggiungerlo a se stesso, e una nota nel thread dice che è stato aggiunto solo a questo thread. Il clone avviene a metà del compito, quindi il `CLAUDE.md` e le skills di quel repository non erano presenti quando il thread è iniziato. Il thread successivo inizia di nuovo senza di esso. Un repository che un thread aggiunge a se stesso ha bisogno degli stessi [prerequisiti](#check-the-prerequisites) di un repository del progetto: l'app GitHub di Claude installata su di esso e accesso push dal tuo account GitHub.361* **Lascialo fuori e lascia che i thread lo aggiungano quando necessario.** Un thread cloud il cui compito richiede un repository che il progetto non ha può aggiungerlo a se stesso, e una nota nel thread dice che è stato aggiunto solo a questo thread. Il clone avviene a metà del compito, quindi il `CLAUDE.md` e le skill di quel repository non erano presenti quando il thread è iniziato. Il thread successivo inizia senza di esso. Un repository aggiunto in questo modo ha bisogno degli stessi [prerequisiti](#check-the-prerequisites) di un repository del progetto: l'app GitHub di Claude installata su di esso e accesso push dal tuo account GitHub.

362 362 

363Un progetto non ha bisogno di un repository affatto. I suoi thread cloud possono comunque fare ricerche, scrivere documenti, scrivere ed eseguire codice nella loro sandbox, e consegnare file alla scheda **Library**. Un thread cloud lì può anche aggiungere un repository a se stesso quando un compito lo richiede.363Un progetto non ha bisogno di un repository affatto. I suoi thread cloud possono comunque fare ricerche, scrivere documenti e scrivere ed eseguire codice nella propria sandbox, e consegnano file alla scheda **Library**. Ognuno dei suoi thread cloud può comunque aggiungere un repository a se stesso quando un compito lo richiede.

364 364 

365Una volta che il progetto ha repository, Claude può aggiungere solo repository da un proprietario GitHub che il progetto già utilizza, sia che aggiunga uno al progetto sia che un thread ne aggiunga uno a se stesso. Per portare un repository da un proprietario diverso, aggiungilo tu stesso al progetto in **Project settings > Environment**.365Una volta che il progetto ha repository, Claude può aggiungere solo repository da un proprietario GitHub che il progetto già utilizza, sia che ne aggiunga uno al progetto sia che un thread ne aggiunga uno a se stesso. Per portare un repository da un proprietario diverso, aggiungilo tu stesso al progetto in **Project settings > Environment**.

366 366 

367Per un progetto che si estende su molti repository, come una funzionalità con codice server, web, mobile e desktop, aggiungi uno o due repository che quasi ogni compito tocca e nomina gli altri nelle [istruzioni del progetto](#write-project-instructions) in modo che Claude sappia dove vive il resto del codice. I thread iniziano quindi in piccolo e tirano in gli altri repository solo per i compiti che ne hanno bisogno.367Per un progetto che si estende su molti repository, come una funzionalità con codice server, web, mobile e desktop, aggiungi uno o due repository che quasi ogni compito tocca e nomina gli altri nelle [istruzioni del progetto](#write-project-instructions) in modo che Claude sappia dove si trova il resto del codice. I thread cloud iniziano quindi con poco e includono gli altri repository solo per i compiti che ne hanno bisogno.

368 368 

369<h3 id="add-files-and-folders">369<h3 id="add-files-and-folders">

370 Aggiungi file e cartelle370 Aggiungi file e cartelle


381 Cosa i thread prendono dai tuoi repository381 Cosa i thread prendono dai tuoi repository

382</h3>382</h3>

383 383 

384Ogni thread cloud clona ogni repository nel progetto e carica `CLAUDE.md` e skills da tutti loro. Le regole di permesso, gli hook e `env` provengono solo dal `.claude/settings.json` nella directory in cui il thread inizia: all'interno del repository quando il progetto ne ha uno, e sopra i cloni quando ne ha diversi, dove il file di nessun repository viene letto per loro.384Ogni thread cloud clona ogni repository nel progetto e carica `CLAUDE.md` e skill da tutti loro. Le regole di permesso, gli hook e `env` provengono solo dal `.claude/settings.json` nella directory in cui il thread inizia: all'interno del repository quando il progetto ne ha uno, e sopra i cloni quando ne ha diversi, dove il file di nessun repository viene letto per loro.

385 385 

386| In ogni repository | Un repository | Diversi repository |386| In ogni repository | Un repository | Diversi repository |

387| :- | :- | :- |387| :- | :- | :- |

388| `CLAUDE.md` | Caricato quando il thread inizia | Caricato da ogni repository quando il thread inizia |388| `CLAUDE.md` | Caricato quando il thread inizia | Caricato da ogni repository quando il thread inizia |

389| Skills, agenti e comandi in `.claude/` | Caricati | Caricati da ogni repository |389| Skill, agenti e comandi in `.claude/` | Caricati | Caricati da ogni repository |

390| Plugin abilitati in `.claude/settings.json` | Non caricati. Aggiungi il plugin in **Project settings > Plugins** | Non caricati. Aggiungi il plugin in **Project settings > Plugins** |390| Plugin abilitati in `.claude/settings.json` | Non caricati. Aggiungi invece il plugin in **Project settings > Plugins** | Non caricati. Aggiungi invece il plugin in **Project settings > Plugins** |

391| Regole di permesso, hook e `env` definiti in `.claude/settings.json` | Si applicano al thread, tranne le chiavi `env` che [nessuna sessione cloud onora](/docs/it/cloud-environments#what-carries-over-from-your-setup) | Non si applicano |391| Regole di permesso, hook e `env` definiti in `.claude/settings.json` | Si applicano al thread, tranne le chiavi `env` che [nessuna sessione cloud onora](/docs/it/cloud-environments#what-carries-over-from-your-setup) | Non si applicano |

392 392 

393In un progetto con diversi repository, ogni clone è collegato al thread come una [directory aggiuntiva](/docs/it/memory#load-from-additional-directories) con il caricamento di `CLAUDE.md` attivato, motivo per cui il `CLAUDE.md` e le skills di ogni repository si caricano all'avvio anche se il thread inizia sopra di loro. In un tale progetto, inserisci le regole permanenti nelle istruzioni del progetto e fornisci ai thread le variabili di ambiente attraverso l'[ambiente cloud](#choose-an-environment-for-threads).393In un progetto con diversi repository, ogni clone è collegato al thread come una [directory aggiuntiva](/docs/it/memory#load-from-additional-directories) con il caricamento di `CLAUDE.md` attivato, motivo per cui il `CLAUDE.md` e le skill di ogni repository si caricano all'avvio anche se il thread inizia sopra di loro. In un tale progetto, inserisci le regole permanenti nelle istruzioni del progetto e fornisci ai thread le variabili d'ambiente attraverso l'[ambiente cloud](#choose-an-environment-for-threads).

394 394 

395<h3 id="choose-an-environment-for-threads">395<h3 id="choose-an-environment-for-threads">

396 Scegli un ambiente per i thread396 Scegli un ambiente per i thread


398 398 

399Ogni nuovo thread cloud inizia nell'[ambiente cloud](/docs/it/cloud-environments) del progetto. L'ambiente imposta quali domini i thread possono raggiungere, quali variabili d'ambiente hanno, quali secret di rete vengono aggiunti alle loro richieste, e cosa lo script di setup installa prima che Claude inizi. I thread cloud utilizzano un ambiente predefinito ospitato da Anthropic fino a quando non ne scegli uno in **Project settings > Environment**.399Ogni nuovo thread cloud inizia nell'[ambiente cloud](/docs/it/cloud-environments) del progetto. L'ambiente imposta quali domini i thread possono raggiungere, quali variabili d'ambiente hanno, quali secret di rete vengono aggiunti alle loro richieste, e cosa lo script di setup installa prima che Claude inizi. I thread cloud utilizzano un ambiente predefinito ospitato da Anthropic fino a quando non ne scegli uno in **Project settings > Environment**.

400 400 

401Se i thread cloud hanno bisogno di raggiungere un'API interna o un registro di pacchetti privato, o hanno bisogno di un token che la tua macchina normalmente contiene, cambia l'ambiente piuttosto che il progetto: vedi [Network access](/docs/it/cloud-environments#network-access), [Add network secrets](/docs/it/cloud-environments#add-api-credentials), e [Setup scripts](/docs/it/cloud-environments#setup-scripts).401Se i thread cloud hanno bisogno di raggiungere un'API interna o un registro di pacchetti privato, o hanno bisogno di un token che la tua macchina normalmente contiene, cambia l'ambiente piuttosto che il progetto: vedi [Network access](/docs/it/cloud-environments#network-access), [Add network secrets](/docs/it/cloud-environments#add-network-secrets), e [Setup scripts](/docs/it/cloud-environments#setup-scripts).

402 402 

403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">403<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

404 Ottieni skills, plugin, connettori e strumenti nei thread404 Ottieni skill, plugin, connettori e strumenti nei thread

405</h3>405</h3>

406 406 

407I thread cloud non hanno le skills, i server MCP, i plugin e gli strumenti installati solo sulla tua macchina. Un thread che Claude esegue sulla tua macchina attraverso [Remote Control](/docs/it/remote-control) utilizza ciò che è installato lì. Per rendere ciascuno di questi disponibile ai thread cloud:407I thread cloud non hanno le skill, i server MCP, i plugin e gli strumenti installati solo sulla tua macchina. Un thread che Claude esegue sulla tua macchina attraverso [Remote Control](/docs/it/remote-control) utilizza ciò che è installato lì. Per rendere ciascuno di questi disponibile ai thread cloud:

408 408 

409* Skills, subagenti e comandi: eseguine il commit in un repository che hai aggiunto al progetto, ad esempio una skill in `.claude/skills/<skill-name>/SKILL.md`. Ogni thread cloud clona ogni repository nel progetto e carica `.claude/skills/`, `.claude/agents/` e `.claude/commands/` da ciascuno di loro, quindi una skill sottoposta a commit in un repository è disponibile in ogni nuovo thread cloud. I thread cloud caricano anche le skills che abiliti per il tuo account claude.ai.409* Skill, subagent e comandi: eseguine il commit in un repository che hai aggiunto al progetto, ad esempio una skill in `.claude/skills/<skill-name>/SKILL.md`. Ogni thread cloud clona ogni repository nel progetto e carica `.claude/skills/`, `.claude/agents/` e `.claude/commands/` da ciascuno di loro, quindi una skill sottoposta a commit in un repository è disponibile in ogni thread cloud. I thread cloud caricano anche le skill che abiliti per il tuo account claude.ai.

410* Plugin: aggiungili in **Project settings > Plugins**; si caricano in ogni nuovo thread cloud. I plugin che un repository dichiara nel suo `.claude/settings.json` [non si caricano nei thread cloud](/docs/it/cloud-environments#what-carries-over-from-your-setup).410* Plugin: aggiungili in **Project settings > Plugins**; si caricano in ogni nuovo thread cloud. I plugin che un repository dichiara nel suo `.claude/settings.json` [non si caricano nei thread cloud](/docs/it/cloud-environments#what-carries-over-from-your-setup).

411* Server MCP: i thread cloud ottengono i loro strumenti MCP dai connettori sul tuo account claude.ai, che sono server MCP che colleghi una volta in [claude.ai/customize/connectors](https://claude.ai/customize/connectors) o attraverso il link **Manage connectors** in **Project settings > Environment**. Ogni thread cloud può utilizzarli tutti senza alcuna configurazione per progetto. La conversazione del progetto stessa non ha connettori, quindi invia il lavoro che ne richiede uno come compito per un thread cloud. In un progetto con un repository, i thread cloud caricano anche i server MCP dal [`.mcp.json`](/docs/it/cloud-environments#what-carries-over-from-your-setup) di quel repository. [How connectors reach Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) elenca le regole per le sessioni cloud e le impostazioni che disattivano i connettori.411* Server MCP: i thread cloud ottengono i loro strumenti MCP dai connettori sul tuo account claude.ai, che sono server MCP che colleghi una volta in [claude.ai/customize/connectors](https://claude.ai/customize/connectors) o attraverso il link **Manage connectors** in **Project settings > Environment**. Ogni thread cloud può utilizzarli tutti senza alcuna configurazione per progetto. La conversazione del progetto stessa non ha connettori, quindi invia il lavoro che ne richiede uno come compito per un thread cloud. In un progetto con un repository, i thread cloud caricano anche i server MCP dal [`.mcp.json`](/docs/it/cloud-environments#what-carries-over-from-your-setup) di quel repository. [How connectors reach Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) elenca le regole per le sessioni cloud e le impostazioni che disattivano i connettori.

412* Strumenti da riga di comando e pacchetti: installali nello [script di setup](/docs/it/cloud-environments#setup-scripts) dell'ambiente.412* Strumenti da riga di comando e pacchetti: installali nello [script di setup](/docs/it/cloud-environments#setup-scripts) dell'ambiente.

413 413 

414Per vedere quali connettori ha un thread cloud in esecuzione in claude.ai/code, apri il thread e seleziona **Connectors** dal menu **+** accanto alla sua casella di messaggio. Disattivare un connettore lì lo rimuove da quel thread e lo salva come impostazione predefinita del tuo account, quindi i nuovi thread cloud e le chat claude.ai iniziano senza di esso fino a quando non lo riattivi. Un thread cloud raccoglie un connettore che aggiungi o riconnetti dopo il prossimo messaggio che gli invii.414Per vedere quali connettori ha un thread cloud in esecuzione in claude.ai/code, apri il thread e seleziona **Connectors** dal menu **+** accanto alla sua casella di messaggio. Disattivare un connettore lì lo rimuove da quel thread e lo salva come impostazione predefinita del tuo account, quindi i nuovi thread e le chat claude.ai iniziano senza di esso fino a quando non lo riattivi. Un thread cloud raccoglie un connettore che aggiungi o riconnetti dopo il prossimo messaggio che gli invii.

415 415 

416<h2 id="project-settings-reference">416<h2 id="project-settings-reference">

417 Riferimento delle impostazioni del project417 Riferimento delle impostazioni del project

Details

10 Gli ambienti cloud si applicano alle [sessioni cloud](/docs/it/claude-code-on-the-web), che sono disponibili sui piani Pro, Max e Team, e per gli utenti Enterprise con [posti premium o posti Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).10 Gli ambienti cloud si applicano alle [sessioni cloud](/docs/it/claude-code-on-the-web), che sono disponibili sui piani Pro, Max e Team, e per gli utenti Enterprise con [posti premium o posti Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan).

11</Note>11</Note>

12 12 

13Ogni [sessione cloud](/docs/it/claude-code-on-the-web) viene eseguita in un ambiente cloud. È possibile configurare un ambiente per consentire o negare l'[accesso di rete](#access-levels), [impostare variabili d'ambiente](#set-environment-variables) per la sessione, sui piani Pro e Max memorizzare [segreti di rete](#add-api-credentials) che le sessioni utilizzano senza vederli, ed eseguire uno [script di configurazione](#setup-scripts) prima che Claude inizi a lavorare.13Ogni [sessione cloud](/docs/it/claude-code-on-the-web) viene eseguita in un ambiente cloud. Puoi configurare un ambiente per consentire o negare l'[accesso di rete](#access-levels), [impostare variabili d'ambiente](#set-environment-variables) per la sessione, sui piani Pro e Max memorizzare [segreti di rete](#add-network-secrets) che le sessioni utilizzano senza vederli, ed eseguire uno [script di configurazione](#setup-scripts) prima che Claude inizi a lavorare.

14 14 

15Gli stessi ambienti si applicano ovunque avviate una sessione cloud: l'[app Desktop](/docs/it/desktop), l'[app mobile Claude](/docs/it/mobile), il vostro browser su [claude.ai/code](https://claude.ai/code), il terminale con [`claude --cloud`](/docs/it/claude-code-on-the-web#from-terminal-to-cloud), [routine](/docs/it/routines) e [Claude Tag](https://claude.com/docs/claude-tag/overview). Ognuna di queste superfici può anche instradare a un [ambiente self-hosted](/docs/it/self-hosted-environments). [Disponibilità e limitazioni](/docs/it/self-hosted-environments#availability-and-limitations) copre cosa Claude non può ancora utilizzare quando una sessione Claude Tag viene eseguita in uno.15Gli stessi ambienti si applicano ovunque avviate una sessione cloud: l'[app Desktop](/docs/it/desktop), l'[app mobile Claude](/docs/it/mobile), il vostro browser su [claude.ai/code](https://claude.ai/code), il terminale con [`claude --cloud`](/docs/it/claude-code-on-the-web#from-terminal-to-cloud), [routine](/docs/it/routines) e [Claude Tag](https://claude.com/docs/claude-tag/overview). Ognuna di queste superfici può anche instradare a un [ambiente self-hosted](/docs/it/self-hosted-environments). [Disponibilità e limitazioni](/docs/it/self-hosted-environments#availability-and-limitations) copre cosa Claude non può ancora utilizzare quando una sessione Claude Tag viene eseguita in uno.

16 16 


58 <Step title="Aggiungere o modificare un ambiente">58 <Step title="Aggiungere o modificare un ambiente">

59 Selezionate **Cloud** per elencare i vostri ambienti. Quindi selezionate **Add cloud environment**, oppure passate il mouse su un ambiente esistente e selezionate l'icona delle impostazioni che appare a destra.59 Selezionate **Cloud** per elencare i vostri ambienti. Quindi selezionate **Add cloud environment**, oppure passate il mouse su un ambiente esistente e selezionate l'icona delle impostazioni che appare a destra.

60 60 

61 La finestra di dialogo include il nome, il livello di accesso di rete, le variabili d'ambiente e lo script di configurazione. Quando modifichi un ambiente cloud esistente su un piano Pro o Max, la finestra di dialogo include anche i [segreti di rete](#add-api-credentials).61 La finestra di dialogo include il nome, il livello di accesso di rete, le variabili d'ambiente e lo script di configurazione. Quando modifichi un ambiente cloud esistente su un piano Pro o Max, la finestra di dialogo include anche i [segreti di rete](#add-network-secrets).

62 62 

63 <Frame>63 <Frame>

64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="La finestra di dialogo New cloud environment. Un campo Name con il testo segnaposto Default, un selettore Network access impostato su Trusted con link alla politica di rete e ai livelli di accesso, una casella Environment variables che mostra il testo segnaposto in formato .env con una nota che i valori sono visibili a chiunque utilizzi l'ambiente, una casella Setup script descritta come uno script Bash che viene eseguito quando inizia una nuova sessione prima che Claude Code si avvii, e pulsanti Cancel e Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="La finestra di dialogo New cloud environment. Un campo Name con il testo segnaposto Default, un selettore Network access impostato su Trusted con link alla politica di rete e ai livelli di accesso, una casella Environment variables che mostra il testo segnaposto in formato .env con una nota che i valori sono visibili a chiunque utilizzi l'ambiente, una casella Setup script descritta come uno script Bash che viene eseguito quando inizia una nuova sessione prima che Claude Code si avvii, e pulsanti Cancel e Create environment." width="874" height="1372" data-path="images/cloud-environment-dialog.png" />


91 91 

92Una sessione cloud imposta anche alcune variabili da sola quando si avvia. Per [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/claude-code-on-the-web#manage-context), il valore che la sessione imposta sostituisce uno che aggiungete qui, quindi aggiungere quella chiave qui non ha effetto.92Una sessione cloud imposta anche alcune variabili da sola quando si avvia. Per [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/it/claude-code-on-the-web#manage-context), il valore che la sessione imposta sostituisce uno che aggiungete qui, quindi aggiungere quella chiave qui non ha effetto.

93 93 

94Chiunque utilizzi l'ambiente può leggere i valori. Sui piani Pro e Max, utilizza invece un [segreto di rete](#add-api-credentials) per una chiave che il proxy dell'agente può allegare a una richiesta. Le [richieste che non ricevono mai un segreto](#requests-that-never-get-the-credential) sono elencate lì.94Chiunque utilizzi l'ambiente può leggere i valori. Sui piani Pro e Max, utilizza invece un [segreto di rete](#add-network-secrets) per una chiave che il proxy dell'agente può allegare a una richiesta. Le [richieste che non ricevono mai un segreto](#requests-that-never-get-the-credential) sono elencate lì.

95 95 

96<h3 id="add-api-credentials">96<span id="add-api-credentials" />

97 

98<h3 id="add-network-secrets">

97 Aggiungere segreti di rete99 Aggiungere segreti di rete

98</h3>100</h3>

99 101 


197 199 

198Gli Owner scelgono l'[ambiente predefinito](#the-default-environment) dell'organizzazione separatamente, su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).200Gli Owner scelgono l'[ambiente predefinito](#the-default-environment) dell'organizzazione separatamente, su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code).

199 201 

200Le sessioni di ogni membro in un ambiente condiviso leggono le sue variabili, quindi non includervi segreti. I [segreti di rete](#add-api-credentials), che danno alle sessioni una chiave che non possono leggere, non sono ancora disponibili sui piani Team o Enterprise.202Le sessioni di ogni membro in un ambiente condiviso leggono le sue variabili, quindi non includervi segreti. I [segreti di rete](#add-network-secrets), che danno alle sessioni una chiave che non possono leggere, non sono ancora disponibili sui piani Team o Enterprise.

201 203 

202<h3 id="set-the-environment-a-claude-tag-channel-uses">204<h3 id="set-the-environment-a-claude-tag-channel-uses">

203 Impostare l'ambiente che un canale Claude Tag utilizza205 Impostare l'ambiente che un canale Claude Tag utilizza


239 241 

240* GitHub, attraverso il suo [proxy separato](#github-proxy)242* GitHub, attraverso il suo [proxy separato](#github-proxy)

241* I [connettori MCP](#network-access) che abilitate, il cui traffico viaggia attraverso i server di Anthropic243* I [connettori MCP](#network-access) che abilitate, il cui traffico viaggia attraverso i server di Anthropic

242* Gli host che hai elencato nei [segreti di rete](#add-api-credentials) dell'ambiente, tranne gli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential)244* Gli host che hai elencato nei [segreti di rete](#add-network-secrets) dell'ambiente, tranne gli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential)

243* L'API Anthropic, per le richieste di Claude Code stesso, anche a **None**, come notato sotto [Sicurezza e isolamento](/docs/it/claude-code-on-the-web#security-and-isolation)245* L'API Anthropic, per le richieste di Claude Code stesso, anche a **None**, come notato sotto [Sicurezza e isolamento](/docs/it/claude-code-on-the-web#security-and-isolation)

244 246 

245<h3 id="allow-specific-domains">247<h3 id="allow-specific-domains">


254registry.example.com256registry.example.com

255```257```

256 258 

257Le sessioni in questo ambiente possono ora raggiungere `api.example.com`, qualsiasi sottodominio di `internal.example.com` e `registry.example.com`, e nessun altro dominio attraverso la rete della sessione. Il [traffico GitHub](#github-proxy), il [traffico dei connettori MCP](#network-access) e le richieste agli host dei [segreti di rete](#add-api-credentials) dell'ambiente, diversi dagli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential), non passano attraverso questa allowlist. Un `*.` iniziale corrisponde a ogni sottodominio. Per mantenere anche i [domini Trusted](#default-allowed-domains), seleziona **Also include default list of common package managers**; lascialo deselezionato per consentire solo ciò che elenchi.259Le sessioni in questo ambiente possono ora raggiungere `api.example.com`, qualsiasi sottodominio di `internal.example.com` e `registry.example.com`, e nessun altro dominio attraverso la rete della sessione. Il [traffico GitHub](#github-proxy), il [traffico dei connettori MCP](#network-access) e le richieste agli host dei [segreti di rete](#add-network-secrets) dell'ambiente, diversi dagli [host che non ricevono mai il segreto](#requests-that-never-get-the-credential), non passano attraverso questa allowlist. Un `*.` iniziale corrisponde a ogni sottodominio. Per mantenere anche i [domini Trusted](#default-allowed-domains), seleziona **Also include default list of common package managers**; lascialo deselezionato per consentire solo ciò che elenchi.

258 260 

259Se la vostra organizzazione utilizza gli [artifact](/docs/it/artifacts#availability), non avete bisogno di `*.frame.claudeusercontent.com` nell'elenco affinché le sessioni li leggano. Quando l'elenco lascia fuori quell'host, Claude Code legge il contenuto dell'artifact attraverso la connessione della sessione ad Anthropic invece. Mantenete l'host in un elenco di consentiti in due situazioni:261Se la vostra organizzazione utilizza gli [artifact](/docs/it/artifacts#availability), non avete bisogno di `*.frame.claudeusercontent.com` nell'elenco affinché le sessioni li leggano. Quando l'elenco lascia fuori quell'host, Claude Code legge il contenuto dell'artifact attraverso la connessione della sessione ad Anthropic invece. Mantenete l'host in un elenco di consentiti in due situazioni:

260 262 


316| Plugin abilitati solo nelle tue impostazioni utente | No | `enabledPlugins` con ambito utente si trova in `~/.claude/settings.json` sulla tua macchina |318| Plugin abilitati solo nelle tue impostazioni utente | No | `enabledPlugins` con ambito utente si trova in `~/.claude/settings.json` sulla tua macchina |

317| Server MCP che hai aggiunto con `claude mcp add` nell'ambito locale predefinito o nell'ambito utente | No | Questi scrivono in `~/.claude.json` sulla tua macchina, non nel repository. Aggiungi il server con `claude mcp add --scope project`, che scrive il file [`.mcp.json`](/docs/it/mcp#project-scope) del repository, e fai il commit di quel file. Una sessione con un solo repository lo carica |319| Server MCP che hai aggiunto con `claude mcp add` nell'ambito locale predefinito o nell'ambito utente | No | Questi scrivono in `~/.claude.json` sulla tua macchina, non nel repository. Aggiungi il server con `claude mcp add --scope project`, che scrive il file [`.mcp.json`](/docs/it/mcp#project-scope) del repository, e fai il commit di quel file. Una sessione con un solo repository lo carica |

318| Variabili di trasporto nel blocco `env` di `.claude/settings.json` del tuo repository, come `NODE_EXTRA_CA_CERTS` e le [variabili del certificato client mTLS](/docs/it/network-config#mtls-authentication) | No | L'ambiente di hosting gestisce la connessione API della sessione, quindi Claude Code ignora queste chiavi e annota ogni chiave ignorata nel log di debug della sessione |320| Variabili di trasporto nel blocco `env` di `.claude/settings.json` del tuo repository, come `NODE_EXTRA_CA_CERTS` e le [variabili del certificato client mTLS](/docs/it/network-config#mtls-authentication) | No | L'ambiente di hosting gestisce la connessione API della sessione, quindi Claude Code ignora queste chiavi e annota ogni chiave ignorata nel log di debug della sessione |

319| Chiavi API e token per i servizi che Claude chiama | Sui piani Pro e Max, come [segreti di rete](#add-api-credentials) | Aggiungi la chiave una volta sull'ambiente e il proxy dell'agente la allega alle richieste per gli host che elenchi. Una chiave che il proxy dell'agente [non può allegare](#requests-that-never-get-the-credential), o qualsiasi chiave su un piano Team o Enterprise, rimane in una variabile d'ambiente |321| Chiavi API e token per i servizi che Claude chiama | Sui piani Pro e Max, come [segreti di rete](#add-network-secrets) | Aggiungi la chiave una volta sull'ambiente e il proxy dell'agente la allega alle richieste per gli host che elenchi. Una chiave che il proxy dell'agente [non può allegare](#requests-that-never-get-the-credential), o qualsiasi chiave su un piano Team o Enterprise, rimane in una variabile d'ambiente |

320| Autenticazione interattiva come AWS SSO | No | Non supportata. SSO richiede un login basato su browser che non può essere eseguito in una sessione cloud |322| Autenticazione interattiva come AWS SSO | No | Non supportata. SSO richiede un login basato su browser che non può essere eseguito in una sessione cloud |

321 323 

322Per rendere disponibile la tua configurazione nelle sessioni cloud, fanne il commit nel repository.324Per rendere disponibile la tua configurazione nelle sessioni cloud, fanne il commit nel repository.

323 325 

324Chiunque utilizzi l'ambiente può leggerne le variabili d'ambiente e lo script di configurazione. La nota della finestra di dialogo sotto **Environment variables** lo indica e sconsiglia di inserirvi segreti. Sui piani Pro e Max, memorizza invece una chiave che il proxy dell'agente può allegare come [segreto di rete](#add-api-credentials).326Chiunque utilizzi l'ambiente può leggerne le variabili d'ambiente e lo script di configurazione. La nota della finestra di dialogo sotto **Environment variables** lo indica e sconsiglia di inserirvi segreti. Sui piani Pro e Max, memorizza invece una chiave che il proxy dell'agente può allegare come [segreto di rete](#add-network-secrets).

325 327 

326<h4 id="add-personal-preferences-without-committing-to-the-repo">328<h4 id="add-personal-preferences-without-committing-to-the-repo">

327 Aggiungere preferenze personali senza fare il commit nel repository329 Aggiungere preferenze personali senza fare il commit nel repository

commands.md +1 −1

Details

87| `/design-sync [hint]` | **[Skill](/docs/it/skills#bundled-skills).** Converte il design system React del tuo repository e lo carica su [Claude Design](https://claude.ai/design), così i design che produce usano i tuoi componenti reali. Facoltativamente, assegna un nome al design system, ad esempio `/design-sync Acme DS`. Una prima sincronizzazione verifica ogni componente e può richiedere alcune ore su un repository di grandi dimensioni. Disponibile sull'API Anthropic. Richiede claude.ai, che la CLI non contatta su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform on AWS, né tramite un [gateway Claude apps](/docs/it/claude-apps-gateway#availability-and-limitations), quindi in questi casi il comando non è disponibile |87| `/design-sync [hint]` | **[Skill](/docs/it/skills#bundled-skills).** Converte il design system React del tuo repository e lo carica su [Claude Design](https://claude.ai/design), così i design che produce usano i tuoi componenti reali. Facoltativamente, assegna un nome al design system, ad esempio `/design-sync Acme DS`. Una prima sincronizzazione verifica ogni componente e può richiedere alcune ore su un repository di grandi dimensioni. Disponibile sull'API Anthropic. Richiede claude.ai, che la CLI non contatta su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform on AWS, né tramite un [gateway Claude apps](/docs/it/claude-apps-gateway#availability-and-limitations), quindi in questi casi il comando non è disponibile |

88| `/desktop` | Continua la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |88| `/desktop` | Continua la sessione corrente nell'app Claude Code Desktop. Richiede macOS o Windows x64 e un abbonamento Claude. Alias: `/app` |

89| `/diff` | Esamina le modifiche nel tuo albero di lavoro, incluse le modifiche apportate finora da Claude. Consulta [Esaminare le modifiche con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |89| `/diff` | Esamina le modifiche nel tuo albero di lavoro, incluse le modifiche apportate finora da Claude. Consulta [Esaminare le modifiche con /diff](/docs/it/interactive-mode#review-changes-with-%2Fdiff) |

90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/it/skills#bundled-skills).** Esegue un controllo della configurazione che diagnostica i problemi e può risolverli. Verifica lo stato dell'installazione, incluse installazioni duplicate o residue, problemi di `PATH` e file di impostazioni non analizzabili. Individua skill, server MCP e plugin inutilizzati rispetto al loro costo in contesto, segnala gli [hook](/docs/it/hooks) lenti e verifica la presenza di una versione più recente sul tuo [canale di rilascio](/docs/it/setup#configure-release-channel). Elimina i duplicati tra i file `CLAUDE.md` locali e quelli sotto versionamento, riduce i file [`CLAUDE.md`](/docs/it/memory#my-claude-md-is-too-large) sotto versionamento eliminando i contenuti che Claude potrebbe ricavare dal codebase e migra le indicazioni sempre caricate rimanenti in [skill](/docs/it/skills) e file `CLAUDE.md` annidati che vengono caricati su richiesta. Offre inoltre di rendere la [modalità auto](/docs/it/permissions#permission-modes) la tua impostazione predefinita e di [pre-approvare](/docs/it/permissions) i comandi di sola lettura negati di frequente. Riporta prima i risultati e chiede conferma prima di modificare qualsiasi cosa. Dal terminale, `claude doctor` stampa una diagnostica di sola lettura dell'installazione senza avviare una sessione. Alias: `/checkup`. Esegui `/doctor prompt-audit` per far [verificare a Claude i tuoi file `CLAUDE.md`, le skill e altre configurazioni](/docs/it/memory#audit-your-instruction-files) alla ricerca di istruzioni obsolete o in conflitto invece di eseguire il controllo. Il sottocomando `prompt-audit` richiede Claude Code v2.1.283 o successiva. Il controllo di riduzione di `CLAUDE.md` richiede Claude Code v2.1.206 o successiva. Prima della v2.1.205, `/doctor` apriva una schermata di diagnostica di sola lettura e premendo `f` si inviava il report a Claude |90| `/doctor [prompt-audit [path]]` | **[Skill](/docs/it/skills#bundled-skills).** Esegue un controllo della configurazione che diagnostica problemi di installazione, impostazioni, estensioni e `CLAUDE.md` e propone correzioni che Claude applica dopo la tua conferma. Per sapere cosa copre il controllo, o per verificare invece le tue istruzioni con `prompt-audit`, consulta [Controllare la configurazione con `/doctor`](/docs/it/skills#check-your-setup-with-/doctor). Il sottocomando `prompt-audit` richiede Claude Code v2.1.283 o successiva. Alias: `/checkup` |

91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Imposta il [livello di sforzo](/docs/it/model-config#adjust-effort-level): da `low` a `xhigh`, `max` oppure `auto`; `status` lo stampa. `ultracode` o `ultracode on` attiva [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) per la sessione al livello corrente, e `ultracode off` lo disattiva; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) lo rende persistente. `max` vale solo per la sessione. Gli argomenti `on` e `off` e il mantenimento del livello corrente richiedono Claude Code v2.1.284 o successiva. Prima della v2.1.284, `/effort ultracode` impostava la sessione su `xhigh` e `/effort ultracode off` falliva con `Invalid argument`. Eseguilo mentre Claude sta rispondendo e, una volta confermato l'[avviso sulla cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla richiesta successiva in quel turno. Prima della v2.1.242, Claude Code decideva in base a un feature flag recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo metteva sempre in coda in una sessione che non [recupera i feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona con `-p` |91| `/effort [level\|auto\|status\|ultracode [on\|off]]` | Imposta il [livello di sforzo](/docs/it/model-config#adjust-effort-level): da `low` a `xhigh`, `max` oppure `auto`; `status` lo stampa. `ultracode` o `ultracode on` attiva [ultracode](/docs/it/workflows#let-claude-decide-with-ultracode) per la sessione al livello corrente, e `ultracode off` lo disattiva; la chiave [`ultracode`](/docs/it/settings-reference#ultracode) lo rende persistente. `max` vale solo per la sessione. Gli argomenti `on` e `off` e il mantenimento del livello corrente richiedono Claude Code v2.1.284 o successiva. Prima della v2.1.284, `/effort ultracode` impostava la sessione su `xhigh` e `/effort ultracode off` falliva con `Invalid argument`. Eseguilo mentre Claude sta rispondendo e, una volta confermato l'[avviso sulla cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla richiesta successiva in quel turno. Prima della v2.1.242, Claude Code decideva in base a un feature flag recuperato da Anthropic se eseguire il comando a metà turno o metterlo in coda fino al termine del turno, e lo metteva sempre in coda in una sessione che non [recupera i feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching), come su un [provider di terze parti](/docs/it/third-party-integrations). Funziona con `-p` |

92| `/exit` | Esce dalla CLI. In una [sessione in background](/docs/it/agent-view#attach-to-a-session) collegata, la scollega e la sessione continua a essere eseguita. Alias: `/quit` |92| `/exit` | Esce dalla CLI. In una [sessione in background](/docs/it/agent-view#attach-to-a-session) collegata, la scollega e la sessione continua a essere eseguita. Alias: `/quit` |

93| `/export [filename]` | Esporta la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiarla negli appunti o salvarla in un file |93| `/export [filename]` | Esporta la conversazione corrente come testo semplice. Con un nome file, scrive direttamente in quel file. Senza, apre una finestra di dialogo per copiarla negli appunti o salvarla in un file |

Details

391 Explain the logic in @src/utils/auth.js391 Explain the logic in @src/utils/auth.js

392 ```392 ```

393 393 

394 Questo include il contenuto completo del file nella conversazione.394 Questo include il contenuto del file nella conversazione quando rientra nel limite di token dello [strumento Read](/docs/it/tools-reference#read-tool-behavior), 25.000 token per impostazione predefinita. Un file di testo più grande di 256KB non viene incluso.

395 </Step>395 </Step>

396 396 

397 <Step title="Fare riferimento a una directory">397 <Step title="Fare riferimento a una directory">


446 Chiedere a Claude delle sue capacità446 Chiedere a Claude delle sue capacità

447</h3>447</h3>

448 448 

449Claude ha accesso integrato alla sua documentazione e può rispondere a domande sulle sue stesse funzionalità e limitazioni.449Claude può rispondere a domande sulle sue stesse funzionalità e limitazioni. Cerca le risposte nella documentazione attuale di Claude Code, quindi non sono limitate alla versione che stai eseguendo.

450 450 

451<h4 id="example-questions">451<h4 id="example-questions">

452 Domande di esempio452 Domande di esempio


483<Tip>483<Tip>

484 Suggerimenti:484 Suggerimenti:

485 485 

486 * Claude ha sempre accesso alla documentazione più recente di Claude Code, indipendentemente dalla versione che stai utilizzando

487 * Fai domande specifiche per ottenere risposte dettagliate486 * Fai domande specifiche per ottenere risposte dettagliate

488 * Claude può spiegare funzionalità complesse come integrazione MCP, configurazioni aziendali e flussi di lavoro avanzati487 * Claude può spiegare funzionalità complesse come integrazione MCP, configurazioni aziendali e flussi di lavoro avanzati

489</Tip>488</Tip>

Details

1634 1634 

1635Se hai bisogno di una finestra più grande piuttosto che di una conversazione più piccola, i modelli Fable, Sonnet 5 e versioni successive, Haiku 5.5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi [Extended context](/docs/it/model-config#extended-context) per la disponibilità per piano e come selezionare una variante di modello `[1m]`. La compattazione funziona allo stesso modo al limite più grande.1635Se hai bisogno di una finestra più grande piuttosto che di una conversazione più piccola, i modelli Fable, Sonnet 5 e versioni successive, Haiku 5.5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano una finestra di contesto di 1 milione di token. Vedi [Extended context](/docs/it/model-config#extended-context) per la disponibilità per piano e come selezionare una variante di modello `[1m]`. La compattazione funziona allo stesso modo al limite più grande.

1636 1636 

1637Sonnet 5.5 e Sonnet 5 funzionano con la finestra di contesto 1M e non hanno alcuna variante `[1m]` da selezionare. Vedi [Sonnet 5.5 and Sonnet 5 context window](/docs/it/model-config#sonnet-5-5-and-sonnet-5-context-window) per le loro soglie di auto-compattazione, e [the context window behind a gateway](/docs/it/model-config#context-window-behind-a-gateway) per come Claude Code dimensiona la finestra quando imposti `ANTHROPIC_BASE_URL` su un [LLM gateway](/docs/it/llm-gateway).

1638 

1639Il punto in cui viene eseguita la compattazione automatica dipende dal tuo modello e dalla configurazione. Vedi [Default auto-compact thresholds](/docs/it/model-config#default-auto-compact-thresholds) per i confini per modello, e [Correct the window for a gateway or custom model ID](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) se Claude Code assume la finestra sbagliata per il tuo ID modello, come un alias [LLM gateway](/docs/it/llm-gateway).1637Il punto in cui viene eseguita la compattazione automatica dipende dal tuo modello e dalla configurazione. Vedi [Default auto-compact thresholds](/docs/it/model-config#default-auto-compact-thresholds) per i confini per modello, e [Correct the window for a gateway or custom model ID](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) se Claude Code assume la finestra sbagliata per il tuo ID modello, come un alias [LLM gateway](/docs/it/llm-gateway).

1640 1638 

1641<h2 id="check-your-own-session">1639<h2 id="check-your-own-session">

Details

128* **Raggiungere `exec` entro circa tre secondi ogni volta che il launcher viene eseguito.** Un dispatch in background a freddo esegue il launcher due volte in serie prima del primo byte di output, quindi fate il lavoro lento come uno scambio di single sign-on pigrizia o da una cache.128* **Raggiungere `exec` entro circa tre secondi ogni volta che il launcher viene eseguito.** Un dispatch in background a freddo esegue il launcher due volte in serie prima del primo byte di output, quindi fate il lavoro lento come uno scambio di single sign-on pigrizia o da una cache.

129* **Tollerare di essere invocato da dentro se stesso.** Claude Code applica il launcher a ogni auto-spawn annidato, quindi un launcher che acquisisce una risorsa esclusiva deve rilevare che la detiene già.129* **Tollerare di essere invocato da dentro se stesso.** Claude Code applica il launcher a ogni auto-spawn annidato, quindi un launcher che acquisisce una risorsa esclusiva deve rilevare che la detiene già.

130* **Non scrivere nel terminale prima che Claude Code si avvii.** Qualsiasi cosa stampata prima dell'`exec` viene segnalata come causa del crash se la sessione muore prima dell'inizializzazione.130* **Non scrivere nel terminale prima che Claude Code si avvii.** Qualsiasi cosa stampata prima dell'`exec` viene segnalata come causa del crash se la sessione muore prima dell'inizializzazione.

131* **Non dipendere da come sono scritti gli argomenti.** Il valore di un flag può arrivare come argomento a sé stante, `--flag value`, oppure unito al flag, `--flag=value`. La forma usata da un flag può cambiare tra una versione e l'altra.

131 132 

132<h3 id="format-of-the-launcher-value">133<h3 id="format-of-the-launcher-value">

133 Formato del valore del launcher134 Formato del valore del launcher

Details

85 Prova con una configurazione pulita85 Prova con una configurazione pulita

86</h2>86</h2>

87 87 

88Inizia con [`claude --safe-mode`](/docs/it/cli-reference#cli-flags), che avvia una sessione con tutte le personalizzazioni disabilitate, inclusi `CLAUDE.md`, skills, plugins, hooks, server MCP e comandi e agenti personalizzati. L'autenticazione, la selezione del modello, gli strumenti integrati e le autorizzazioni funzionano normalmente. Se il problema scompare in modalità sicura, una di quelle superfici è la causa; usa i controlli mirati sopra per trovare quale. La modalità sicura applica comunque gli hooks gestiti e la policy delle impostazioni dalla vostra organizzazione. I plugin gestiti, gli skills, `CLAUDE.md` e i server MCP sono disattivati.88Inizia con [`claude --safe-mode`](/docs/it/cli-reference#cli-flags), che avvia una sessione con le tue personalizzazioni disabilitate, tra cui:

89 

90* `CLAUDE.md`

91* Skill, plugin e hook

92* Server MCP

93* Comandi e agenti personalizzati

94* Stili di output personalizzati

95* Scorciatoie da tastiera personalizzate

96 

97L'autenticazione, la selezione del modello, gli strumenti integrati e i permessi funzionano normalmente. Se il problema scompare in modalità sicura, hai circoscritto la causa a uno degli elementi che hai disattivato. Per trovarlo, usa il controllo relativo a quell'elemento, come [Vedi cosa è stato caricato nel contesto](#see-what-loaded-into-context), [Controlla i server MCP](#check-mcp-servers) o [Controlla gli hook](#check-hooks).

98 

99La modalità sicura applica comunque gli hook gestiti e la policy delle impostazioni della tua organizzazione. I plugin gestiti, le skill, `CLAUDE.md` e i server MCP sono disattivati.

89 100 

90Se il problema persiste in modalità sicura, o le tue impostazioni stesse sono sospette, confronta con una sessione che non carica nulla dalla tua configurazione usuale. Punta [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars) a una directory vuota per bypassare tutto sotto `~/.claude`, e avvia da una directory che non ha una cartella `.claude`, `.mcp.json` o `CLAUDE.md` in modo che la configurazione del progetto sia anche saltata.101Se il problema persiste in modalità sicura, o le tue impostazioni stesse sono sospette, confronta con una sessione che non carica nulla dalla tua configurazione usuale. Punta [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars) a una directory vuota per bypassare tutto sotto `~/.claude`, e avvia da una directory che non ha una cartella `.claude`, `.mcp.json` o `CLAUDE.md` in modo che la configurazione del progetto sia anche saltata.

91 102 

desktop.md +96 −48

Details

63 Usa la casella del prompt63 Usa la casella del prompt

64</h3>64</h3>

65 65 

66Digita quello che vuoi che Claude faccia e premi **Invio** per inviare. Claude legge i file del tuo progetto, apporta modifiche ed esegue comandi in base alla tua [modalità di autorizzazione](#choose-a-permission-mode). Puoi interrompere Claude in qualsiasi momento: fai clic sul pulsante di arresto per interrompere immediatamente, oppure digita una correzione e premi **Invio** per inviarla senza interrompere l'azione in corso. Claude legge la correzione non appena l'azione corrente si completa e si adatta prima del suo passo successivo.66Digita quello che vuoi che Claude faccia e premi **Invio** per inviare. Claude legge i file del tuo progetto, apporta modifiche ed esegue comandi in base alla tua [modalità di permesso](#choose-a-permission-mode). Puoi interrompere Claude in qualsiasi momento: fai clic sul pulsante di arresto per interrompere immediatamente, oppure digita una correzione e premi **Invio** per inviarla senza interrompere l'azione in corso. Claude legge la correzione non appena l'azione corrente si completa e si adatta prima del suo passo successivo.

67 67 

68Il pulsante **+** accanto alla casella del prompt ti dà accesso agli allegati di file, [skills](#use-skills), [connettori](#connect-external-tools) e [plugin](#install-plugins).68Il pulsante **+** accanto alla casella del prompt ti dà accesso agli allegati di file, [skill](#use-skills), [connettori](#connect-external-tools) e [plugin](#install-plugins).

69 

70<h3 id="accept-a-suggested-prompt">

71 Accetta un prompt suggerito

72</h3>

73 

74Dopo che Claude risponde, la scheda Code può mostrare un prompt successivo suggerito come testo grigio nella casella del prompt vuota. Claude Code [genera ogni suggerimento](/docs/it/interactive-mode#prompt-suggestions) dalla tua conversazione con una breve richiesta in background che viene conteggiata nei limiti di utilizzo del tuo piano o nei costi dell'API.

75 

76* **Usa il suggerimento**: premi **Tab** o **Freccia destra** per inserirlo nella casella del prompt, modificalo se vuoi, poi premi **Invio** per inviarlo. Premere **Invio** prima di accettare il suggerimento non lo invia.

77* **Scrivi il tuo prompt**: inizia a digitare. Il suggerimento viene mostrato solo mentre la casella del prompt è vuota e non ha file allegati.

78 

79Vai su **Impostazioni > Claude Code** e disattiva **Prompt suggestions** sotto **Sessions** per interrompere i suggerimenti in ogni sessione a partire dalla prossima volta che viene avviata o ripresa.

69 80 

70<h3 id="add-files-and-context-to-prompts">81<h3 id="add-files-and-context-to-prompts">

71 Aggiungi file e contesto ai prompt82 Aggiungi file e contesto ai prompt


77* **Allega file**: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.88* **Allega file**: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.

78 89 

79<h3 id="choose-a-permission-mode">90<h3 id="choose-a-permission-mode">

80 Scegli una modalità di autorizzazione91 Scegli una modalità di permesso

81</h3>92</h3>

82 93 

83Le modalità di autorizzazione controllano quanta autonomia ha Claude durante una sessione: se chiede prima di modificare file, eseguire comandi o entrambi. Puoi cambiare modalità in qualsiasi momento usando il selettore di modalità accanto al pulsante di invio. Per approvare ogni modifica tu stesso, passa a Manual.94Le modalità di permesso controllano quanta autonomia ha Claude durante una sessione: se chiede prima di modificare file, eseguire comandi o entrambi. Puoi cambiare modalità di permesso in qualsiasi momento usando il selettore di modalità accanto al pulsante di invio. Per approvare ogni modifica tu stesso, passa a Manual.

84 95 

85Per impostare una modalità predefinita per le nuove sessioni locali, aggiungi `permissions.defaultMode` al tuo [file di impostazioni](/docs/it/settings#where-settings-live). L'app desktop legge gli stessi file di impostazioni della CLI. Una modalità che scegli nel selettore viene ricordata per cartella e ha la precedenza su `defaultMode` per quella cartella, tranne Plan, che si applica solo alla sessione corrente.96Per impostare una modalità predefinita per le nuove sessioni locali, aggiungi `permissions.defaultMode` al tuo [file di impostazioni](/docs/it/settings#where-settings-live). L'app desktop legge gli stessi file di impostazioni della CLI. Una modalità che scegli nel selettore viene ricordata per cartella e ha la precedenza su `defaultMode` per quella cartella, tranne Plan, che si applica solo alla sessione corrente.

86 97 

87| Modalità | Chiave di impostazione | Comportamento |98| Modalità | Chiave di impostazione | Comportamento |

88| - | - | - |99| - | - | - |

89| **Manual** | `default` | Claude chiede prima di modificare file o eseguire comandi. Vedi un diff e puoi accettare o rifiutare ogni modifica. |100| **Manual** | `default` | Claude chiede prima di modificare file o eseguire comandi. Vedi un diff e puoi accettare o rifiutare ogni modifica. |

90| **Accept edits** | `acceptEdits` | Claude accetta automaticamente le modifiche ai file e i comandi comuni del filesystem come `mkdir`, `touch` e `mv`, ma chiede comunque prima di eseguire altri comandi di terminale. Usa questo quando ti fidi delle modifiche ai file e vuoi un'iterazione più veloce. |101| **Accept edits** | `acceptEdits` | Claude accetta automaticamente le modifiche ai file e i comandi comuni del filesystem come `mkdir`, `touch` e `mv`, ma chiede comunque prima di eseguire altri comandi di terminale. Usa questa modalità quando ti fidi delle modifiche ai file e vuoi un'iterazione più veloce. |

91| **Plan** | `plan` | Claude legge i file ed esegue comandi per esplorare, quindi propone un piano senza modificare il tuo codice sorgente. Buono per compiti complessi dove vuoi rivedere l'approccio prima. |102| **Plan** | `plan` | Claude legge i file ed esegue comandi per esplorare, quindi propone un piano senza modificare il tuo codice sorgente. Buono per compiti complessi dove vuoi rivedere l'approccio prima. |

92| **Auto** | `auto` | Claude esegue senza prompt di routine; prima che azioni come comandi shell e richieste di rete vengano eseguite, un classificatore in background verifica che si allineino con la tua richiesta. Appare quando [auto mode è disponibile](#auto-mode-availability); non c'è un interruttore Impostazioni separato per esso. |103| **Auto** | `auto` | Claude esegue senza richieste di permesso abituali; prima che azioni come comandi shell e richieste di rete vengano eseguite, un classificatore in background verifica che si allineino con la tua richiesta. Appare quando [la modalità auto è disponibile](#auto-mode-availability); non c'è un interruttore Impostazioni separato per essa. |

93| **Bypass permissions** | `bypassPermissions` | Claude viene eseguito senza prompt di autorizzazione, tranne per le [azioni che nessuna modalità auto-approva](/docs/it/permission-modes#actions-no-mode-auto-approves), classificatori di sicurezza quando Claude [agisce su siti esterni](#browse-external-sites), o azioni desktop dove Claude chiede sempre prima, come [archiviare una sessione](#work-across-sessions). Equivalente a `--dangerously-skip-permissions` nella CLI. Su piani Pro e Max, abilitalo in Impostazioni → Claude Code sotto "Allow bypass permissions mode"; su piani Team e Enterprise non c'è un interruttore Impostazioni, e la politica organizzativa lo controlla invece. Usa solo in container sandbox o VM. |104| **Bypass permissions** | `bypassPermissions` | Claude viene eseguito senza richieste di permesso, tranne per le [azioni che nessuna modalità auto-approva](/docs/it/permission-modes#actions-no-mode-auto-approves), classificatori di sicurezza quando Claude [agisce su siti esterni](#browse-external-sites), o azioni desktop dove Claude chiede sempre prima, come [archiviare una sessione](#work-across-sessions). Equivalente a `--dangerously-skip-permissions` nella CLI. Su piani Pro e Max, abilitalo in Impostazioni → Claude Code sotto "Allow bypass permissions mode"; su piani Team e Enterprise non c'è un interruttore Impostazioni, e la politica organizzativa lo controlla invece. Usala solo in container sandbox o VM. |

94 105 

95Le versioni precedenti della scheda Code etichettavano queste modalità Ask permissions, Auto accept edits e Plan mode.106Le versioni precedenti della scheda Code etichettavano queste modalità Ask permissions, Auto accept edits e Plan mode.

96 107 

97La modalità di autorizzazione `dontAsk` è disponibile solo nella [CLI](/docs/it/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).108La modalità di permesso `dontAsk` è disponibile solo nella [CLI](/docs/it/permission-modes#allow-only-pre-approved-tools-with-dontask-mode).

98 109 

99<Tip title="Best practice">110<Tip title="Best practice">

100 Inizia compiti complessi in Plan in modo che Claude mappi un approccio prima di apportare modifiche. Una volta approvato il piano, passa a Accept edits o Manual per eseguirlo. Vedi [esplora prima, poi pianifica, poi codifica](/docs/it/best-practices#explore-first-then-plan-then-code) per ulteriori informazioni su questo flusso di lavoro.111 Inizia compiti complessi in Plan in modo che Claude mappi un approccio prima di apportare modifiche. Una volta approvato il piano, passa a Accept edits o Manual per eseguirlo. Vedi [esplora prima, poi pianifica, poi codifica](/docs/it/best-practices#explore-first-then-plan-then-code) per ulteriori informazioni su questo workflow.

101</Tip>112</Tip>

102 113 

103Le sessioni cloud supportano Accept edits, Plan e Auto. Accept edits corrisponde alla modalità `default`: le sessioni cloud pre-approvano le modifiche ai file, quindi il selettore mostra Accept edits invece di Manual. Bypass permissions non è disponibile nelle sessioni cloud, incluse le sessioni in un [ambiente self-hosted](/docs/it/self-hosted-environments).114Le sessioni cloud supportano Accept edits, Plan e Auto. Accept edits corrisponde alla modalità `default`: le sessioni cloud pre-approvano le modifiche ai file, quindi il selettore mostra Accept edits invece di Manual. Bypass permissions non è disponibile nelle sessioni cloud, incluse le sessioni in un [ambiente self-hosted](/docs/it/self-hosted-environments).

104 115 

105Gli amministratori aziendali possono limitare quali modalità di autorizzazione sono disponibili. Vedi [configurazione aziendale](#enterprise-configuration) per i dettagli.116Gli amministratori aziendali possono limitare quali modalità di permesso sono disponibili. Vedi [configurazione aziendale](#enterprise-configuration) per i dettagli.

106 117 

107<h4 id="auto-mode-availability">118<h4 id="auto-mode-availability">

108 Disponibilità della modalità auto119 Disponibilità della modalità auto


141 152 

142Claude può leggere e interagire con pagine esterne usando gli stessi strumenti che usa per [verificare la tua app](#preview-your-app), con due controlli di sicurezza aggiuntivi:153Claude può leggere e interagire con pagine esterne usando gli stessi strumenti che usa per [verificare la tua app](#preview-your-app), con due controlli di sicurezza aggiuntivi:

143 154 

144* I classificatori di sicurezza esaminano le azioni di scrittura di Claude su pagine esterne, come fare clic e digitare, in ogni modalità di autorizzazione. Questi sono gli stessi classificatori che [auto mode](#choose-a-permission-mode) usa, e quando contrassegnano un'azione, ricevi un prompt di autorizzazione indipendentemente dalla modalità.155* I classificatori di sicurezza esaminano le azioni di scrittura di Claude su pagine esterne, come fare clic e digitare, in ogni modalità di permesso. Questi sono gli stessi classificatori che usa la [modalità auto](#choose-a-permission-mode), e quando segnalano un'azione, ricevi una richiesta di permesso indipendentemente dalla modalità.

145* Nelle modalità di autorizzazione diverse da Auto e Bypass permissions, un controllo della lista di autorizzazione del dominio si applica anche prima che Claude navighi verso un nuovo sito.156* Nelle modalità di permesso diverse da Auto e Bypass permissions, un controllo dell'allowlist dei domini si applica anche prima che Claude navighi verso un nuovo sito.

146 157 

147<h4 id="approve-claude’s-actions-on-a-site">158<h4 id="approve-claude’s-actions-on-a-site">

148 Approva le azioni di Claude su un sito159 Approva le azioni di Claude su un sito

149</h4>160</h4>

150 161 

151La prima volta che Claude agisce su un sito esterno, appare una scheda di autorizzazione e Claude attende la tua scelta: **Allow once**, **Always allow** o **Deny**. **Allow once** approva l'azione senza salvare nulla. **Always allow** salva l'approvazione per quel sito sul tuo dispositivo, e puoi revocarla in Impostazioni. Ogni sito ha bisogno della sua propria approvazione, inclusi i sottodomini. I tuoi server di sviluppo locali e i file del progetto non hanno bisogno di approvazione, quindi [auto-verify](#auto-verify-changes) continua a funzionare senza prompt.162La prima volta che Claude agisce su un sito esterno, appare una scheda di permesso e Claude attende la tua scelta: **Allow once**, **Always allow** o **Deny**. **Allow once** approva l'azione senza salvare nulla. **Always allow** salva l'approvazione per quel sito sul tuo dispositivo, e puoi revocarla in Impostazioni. Ogni sito ha bisogno della sua propria approvazione, inclusi i sottodomini. I tuoi server di sviluppo locali e i file del progetto non hanno bisogno di approvazione, quindi [auto-verify](#auto-verify-changes) continua a funzionare senza richieste di permesso.

152 163 

153Anche su un sito approvato, Claude non acquisterà articoli, creerà account o aggirerà CAPTCHA senza il tuo input. La navigazione nel riquadro Browser utilizza lo stesso modello di sicurezza dell'[estensione Claude in Chrome](/docs/it/chrome). Vedi [Utilizzo di Claude in Chrome in sicurezza](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) per come Claude gestisce siti sensibili e azioni rischiose.164Anche su un sito approvato, Claude non acquisterà articoli, creerà account o aggirerà CAPTCHA senza il tuo input. La navigazione nel riquadro Browser utilizza lo stesso modello di sicurezza dell'[estensione Claude in Chrome](/docs/it/chrome). Vedi [Utilizzo di Claude in Chrome in sicurezza](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely) per come Claude gestisce siti sensibili e azioni rischiose.

154 165 


162 Limita la navigazione esterna per la tua organizzazione173 Limita la navigazione esterna per la tua organizzazione

163</h4>174</h4>

164 175 

165Il Browser segue gli stessi [controlli della lista di autorizzazione e blocco del sito](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) dell'estensione Claude in Chrome. Se la tua organizzazione ha già configurato quelle liste per l'estensione, il Browser le rispetta automaticamente. Gli amministratori possono anche disattivare gli strumenti di Claude su pagine esterne con l'impostazione gestita [`browserExternalPageTools`](#managed-settings). Con gli strumenti disabilitati, gli utenti possono ancora navigare verso siti esterni; gli strumenti di Claude non possono leggerli o agire su di essi.176Il Browser segue gli stessi [controlli di allowlist e blocklist dei siti](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls) dell'estensione Claude in Chrome. Se la tua organizzazione ha già configurato quelle liste per l'estensione, il Browser le rispetta automaticamente. Gli amministratori possono anche disattivare gli strumenti di Claude su pagine esterne con l'impostazione gestita [`browserExternalPageTools`](#managed-settings). Con gli strumenti disabilitati, gli utenti possono ancora navigare verso siti esterni; gli strumenti di Claude non possono leggerli o agire su di essi.

166 177 

167Per disattivare completamente la navigazione esterna, imposta l'impostazione gestita [`disableBrowserExternalNavigation`](#managed-settings) su `true`. Questo blocca tutta la navigazione esterna nel Browser, inclusi i siti nella lista di autorizzazione della tua organizzazione; i server dev localhost e le anteprime di file continuano a funzionare. Usa `browserExternalPageTools` per consentire agli utenti di continuare a sfogliare siti esterni senza gli strumenti di Claude, e `disableBrowserExternalNavigation` per bloccare i siti esterni sia per gli utenti che per Claude.178Per disattivare completamente la navigazione esterna, imposta l'impostazione gestita [`disableBrowserExternalNavigation`](#managed-settings) su `true`. Questo blocca tutta la navigazione esterna nel Browser, inclusi i siti nell'allowlist della tua organizzazione; i server dev localhost e le anteprime di file continuano a funzionare. Usa `browserExternalPageTools` per consentire agli utenti di continuare a sfogliare siti esterni senza gli strumenti di Claude, e `disableBrowserExternalNavigation` per bloccare i siti esterni sia per gli utenti che per Claude.

168 179 

169<h3 id="review-changes-with-diff-view">180<h3 id="review-changes-with-diff-view">

170 Rivedi le modifiche con la visualizzazione diff181 Rivedi le modifiche con la visualizzazione diff


206Per attivarli, fai clic su **CI** nella barra di stato. Per archiviare la sessione automaticamente una volta che la PR viene sottoposta a merge o chiusa, attiva [auto-archive](#work-in-parallel-with-sessions) in **Impostazioni > Claude Code**.217Per attivarli, fai clic su **CI** nella barra di stato. Per archiviare la sessione automaticamente una volta che la PR viene sottoposta a merge o chiusa, attiva [auto-archive](#work-in-parallel-with-sessions) in **Impostazioni > Claude Code**.

207 218 

208<Note>219<Note>

209 Il monitoraggio dei PR richiede che [GitHub CLI (`gh`)](https://cli.github.com/) sia installato e autenticato sulla tua macchina. Se `gh` non è installato, Desktop ti chiede di installarlo la prima volta che tenti di creare un PR.220 Il monitoraggio delle PR richiede che [GitHub CLI (`gh`)](https://cli.github.com/) sia installato e autenticato sulla tua macchina. Se `gh` non è installato, Desktop ti chiede di installarlo la prima volta che tenti di creare una PR.

210</Note>221</Note>

211 222 

212<h2 id="arrange-your-workspace">223<h2 id="arrange-your-workspace">

213 Organizza l'area di lavoro224 Organizza il workspace

214</h2>225</h2>

215 226 

216La scheda Code è costruita attorno a pannelli che puoi organizzare in qualsiasi layout: chat, diff, browser, terminale, file, plan, tasks e subagent, insieme al [Simulatore iOS](/docs/it/desktop-ios-simulator) su macOS. Trascina un pannello dal suo header per riposizionarlo, o trascina un bordo del pannello per ridimensionarlo. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il pannello focalizzato. Fai clic su **Terminal**, **Changes** o **Browser** nella barra del titolo della sessione per aprire il pannello del terminale, del diff o Browser. Il menu **⋮** accanto a essi apre altri pannelli, come **Files**, e contiene quei pulsanti quando la finestra è troppo stretta per mostrarli.227La scheda Code è costruita attorno a pannelli che puoi organizzare in qualsiasi layout: chat, diff, browser, terminale, file, plan, tasks e subagent, insieme al [Simulatore iOS](/docs/it/desktop-ios-simulator) su macOS. Trascina un pannello dal suo header per riposizionarlo, o trascina un bordo del pannello per ridimensionarlo. Premi **Cmd+\\** su macOS o **Ctrl+\\** su Windows per chiudere il pannello focalizzato. Fai clic su **Terminal**, **Changes** o **Browser** nella barra del titolo della sessione per aprire il pannello del terminale, del diff o Browser. Il menu **⋮** accanto a essi apre altri pannelli, come **Files**, e contiene quei pulsanti quando la finestra è troppo stretta per mostrarli.


254 265 

255| Modalità | Cosa mostra |266| Modalità | Cosa mostra |

256| - | - |267| - | - |

257| **Normal** | Chiamate di strumenti compresse in riepiloghi, con risposte di testo completo |268| **Normal** | Chiamate agli strumenti compresse in riepiloghi, con risposte di testo completo |

258| **Thinking** | Chiamate di strumenti compresse in riepiloghi, più il thinking di Claude |269| **Thinking** | Chiamate agli strumenti compresse in riepiloghi, più il ragionamento di Claude |

259| **Verbose** | Ogni chiamata di strumento, lettura di file e passaggio intermedio che Claude compie, più il thinking di Claude |270| **Verbose** | Ogni chiamata a uno strumento, lettura di file e passaggio intermedio che Claude compie, più il ragionamento di Claude |

260 271 

261Usa Thinking per seguire il ragionamento di Claude con le chiamate di strumenti ancora compresse. Usa Verbose quando esegui il debug del motivo per cui Claude ha intrapreso una particolare azione. Le versioni di Claude Desktop precedenti a 1.46388.1 elencano anche una modalità Summary, e una sessione ancora impostata su Summary si apre in Normal una volta aggiornato.272Usa Thinking per seguire il ragionamento di Claude con le chiamate agli strumenti ancora compresse. Usa Verbose quando esegui il debug del motivo per cui Claude ha intrapreso una particolare azione. Le versioni di Claude Desktop precedenti a 1.46388.1 elencano anche una modalità Summary, e una sessione ancora impostata su Summary si apre in Normal una volta aggiornato.

262 273 

263<h3 id="keyboard-shortcuts">274<h3 id="keyboard-shortcuts">

264 Scorciatoie da tastiera275 Scorciatoie da tastiera


274| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Sessione successiva o precedente |285| `Ctrl` `Tab` / `Ctrl` `Shift` `Tab` | Sessione successiva o precedente |

275| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Sessione successiva o precedente |286| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | Sessione successiva o precedente |

276| `Esc` | Arresta la risposta di Claude |287| `Esc` | Arresta la risposta di Claude |

288| `Tab` / `Right arrow` | [Accetta il prompt suggerito](#accept-a-suggested-prompt) in una casella del prompt vuota |

277| `Cmd` `Shift` `D` | Attiva/disattiva pannello diff |289| `Cmd` `Shift` `D` | Attiva/disattiva pannello diff |

278| `Cmd` `Shift` `B` | Attiva/disattiva pannello Browser |290| `Cmd` `Shift` `B` | Attiva/disattiva pannello Browser |

279| `Cmd` `Shift` `S` | Seleziona un elemento nel Browser |291| `Cmd` `Shift` `S` | Seleziona un elemento nel Browser |


281| `Cmd` `\` | Chiudi pannello focalizzato |293| `Cmd` `\` | Chiudi pannello focalizzato |

282| `Cmd` `;` | Apri chat laterale |294| `Cmd` `;` | Apri chat laterale |

283| `Ctrl` `O` | Scorrere le modalità di visualizzazione |295| `Ctrl` `O` | Scorrere le modalità di visualizzazione |

284| `Cmd` `Shift` `M` | Apri menu modalità di autorizzazione |296| `Cmd` `Shift` `M` | Apri menu modalità di permesso |

285| `Cmd` `Shift` `I` | Apri menu modello |297| `Cmd` `Shift` `I` | Apri menu modello |

286| `Cmd` `Shift` `E` | Apri menu sforzo |298| `Cmd` `Shift` `E` | Apri menu sforzo |

287| `1`–`9` | Seleziona elemento in un menu aperto |299| `1`–`9` | Seleziona elemento in un menu aperto |

288 300 

289Queste scorciatoie si applicano solo alla scheda Code. Le scorciatoie della [modalità interattiva](/docs/it/interactive-mode#keyboard-shortcuts) basata su terminale, come `Shift+Tab` per scorrere le modalità, non si applicano in Desktop.301Queste scorciatoie si applicano alla scheda Code. In Desktop, `Shift+Tab` non scorre le modalità di permesso come avviene nella [modalità interattiva](/docs/it/interactive-mode#keyboard-shortcuts) del terminale.

290 302 

291<h3 id="check-usage">303<h3 id="check-usage">

292 Controlla l'utilizzo304 Controlla l'utilizzo


458* Seleziona **Cloud** per continuare la sessione come [sessione cloud](/docs/it/claude-code-on-the-web), con la tua conversazione trasferita sotto forma di riepilogo. Prima di confermare, la finestra di dialogo indica se vengono spostati anche i tuoi file e se questa sessione viene archiviata una volta che quella cloud è pronta. Non puoi spostare in questo modo una sessione eseguita tramite [SSH](#ssh-sessions) o in [WSL](/docs/it/desktop-wsl).470* Seleziona **Cloud** per continuare la sessione come [sessione cloud](/docs/it/claude-code-on-the-web), con la tua conversazione trasferita sotto forma di riepilogo. Prima di confermare, la finestra di dialogo indica se vengono spostati anche i tuoi file e se questa sessione viene archiviata una volta che quella cloud è pronta. Non puoi spostare in questo modo una sessione eseguita tramite [SSH](#ssh-sessions) o in [WSL](/docs/it/desktop-wsl).

459* Seleziona un editor installato o il tuo file manager per aprire lì la cartella della sessione su disco.471* Seleziona un editor installato o il tuo file manager per aprire lì la cartella della sessione su disco.

460 472 

473<h3 id="control-which-sessions-appear-on-your-other-devices">

474 Controlla quali sessioni appaiono sugli altri tuoi dispositivi

475</h3>

476 

477Una sessione locale compare sugli altri tuoi dispositivi una volta che [Remote Control](/docs/it/remote-control) la connette. Una sessione connessa appare nell'elenco delle sessioni su [claude.ai/code](https://claude.ai/code) e nelle app Claude sui dispositivi su cui hai effettuato l'accesso con il tuo account claude.ai.

478 

479Una sessione locale si connette quando attivi Remote Control per essa, oppure quando si connette automaticamente all'avvio:

480 

481* **Lo attivi per quella sessione**: con l'interruttore **Remote Control** della sessione, oppure digitando `/remote-control` nella sua casella del prompt.

482* **Si connette all'avvio**: le nuove sessioni si connettono automaticamente mentre **Connect new sessions to Remote Control** è attivo in **Settings > Claude Code**. Se non hai mai modificato quell'impostazione, Desktop segue [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) nelle tue impostazioni utente o nelle impostazioni gestite, quindi il valore predefinito della tua organizzazione.

483 

484Per vedere se una sessione è connessa, guarda l'icona del laptop prima del titolo della sessione nella barra degli strumenti. L'icona è evidenziata mentre la sessione è connessa o in fase di connessione. Fai clic su di essa per aprire l'interruttore **Remote Control** della sessione.

485 

486Per tenere le sessioni lontane dagli altri tuoi dispositivi, disattiva Remote Control al livello che ti serve:

487 

488* **Una sessione**: disattiva il suo interruttore **Remote Control**. In una sessione che si è connessa all'avvio, digitando `/remote-control` Remote Control resta attivo e viene mostrato `Remote Control is already on. This session connected automatically when it started.` Fai clic su **Turn off** in quella riga per disconnetterla.

489* **Nuove sessioni Desktop su questo computer**: disattiva **Connect new sessions to Remote Control** in **Settings > Claude Code**. Se risulta già disattivato, attivalo e poi disattivalo in modo che Desktop salvi la tua scelta. Una volta salvata, ha la precedenza su `remoteControlAtStartup` e sui valori predefiniti.

490* **Qualsiasi sessione su questo computer, inclusa la CLI**: imposta [`disableRemoteControl`](/docs/it/settings-reference#disableremotecontrol) su `true` in `~/.claude/settings.json` per impedire alle sessioni di connettersi. Una sessione che era già connessa quando hai salvato il file resta connessa finché non disattivi Remote Control per essa.

491 

492Per nascondere una sessione che appare già sugli altri tuoi dispositivi, archiviala in Desktop. Desktop archivia anche la copia Remote Control della sessione, così esce dall'elenco predefinito delle sessioni su quei dispositivi. Per visualizzarla o eliminarla lì, vedi [Archivia le sessioni](/docs/it/claude-code-on-the-web#archive-sessions).

493 

461<h3 id="sessions-from-dispatch">494<h3 id="sessions-from-dispatch">

462 Sessioni da Dispatch495 Sessioni da Dispatch

463</h3>496</h3>


836 Pre-configure SSH connections for your team869 Pre-configure SSH connections for your team

837</h4>870</h4>

838 871 

839Gli amministratori possono distribuire connessioni SSH ai membri del team aggiungendo `sshConfigs` a un file di [impostazioni gestite](/docs/it/managed-settings). Le connessioni definite in questo modo appaiono nel menu a discesa dell'ambiente di ogni utente automaticamente e vengono mostrate come gestite, quindi gli utenti possono selezionarle ma non possono modificarle o eliminarle nell'app.872Gli amministratori possono distribuire connessioni SSH ai membri del team impostando `sshConfigs` nelle [impostazioni gestite](/docs/it/managed-settings). Le connessioni definite in questo modo appaiono nel menu a discesa dell'ambiente di ogni utente automaticamente e vengono mostrate come gestite, quindi gli utenti possono selezionarle ma non possono modificarle o eliminarle nell'app.

840 873 

841L'esempio seguente pre-configura una singola connessione:874L'esempio seguente pre-configura una singola connessione:

842 875 


860 Restrict which SSH hosts users can connect to893 Restrict which SSH hosts users can connect to

861</h4>894</h4>

862 895 

863Gli amministratori possono limitare le sessioni SSH di Desktop a un insieme approvato di host aggiungendo `sshHostAllowlist` a un file di [impostazioni gestite](/docs/it/managed-settings). Quando impostato, gli utenti possono connettersi solo a host il cui nome host risolto corrisponde a uno dei modelli. Impostalo su un array vuoto per disabilitare completamente le sessioni SSH.896Gli amministratori possono limitare le sessioni SSH di Desktop a un insieme approvato di host impostando `sshHostAllowlist` nelle [impostazioni gestite](/docs/it/managed-settings). Quando impostato, gli utenti possono connettersi solo a host il cui nome host risolto corrisponde a uno dei modelli. Impostalo su un array vuoto per disabilitare le sessioni SSH. La [voce di riferimento di `sshHostAllowlist`](/docs/it/settings-reference#sshhostallowlist) spiega come un array vuoto si combina con gli elenchi presenti in altre fonti gestite.

864 897 

865L'esempio seguente consente connessioni a qualsiasi host sotto `devboxes.example.com` e a un singolo host bastion denominato:898L'esempio seguente consente connessioni a qualsiasi host sotto `devboxes.example.com` e a un singolo host bastion denominato:

866 899 


870}903}

871```904```

872 905 

906<Warning>

907 Se la tua organizzazione distribuisce [impostazioni gestite dal server](/docs/it/server-managed-settings), imposta `sshHostAllowlist` lì. Per impostazione predefinita, Desktop legge la chiave solo dalla [fonte gestita con priorità più alta che distribuisce una chiave di policy](/docs/it/managed-settings#how-claude-code-combines-managed-sources). Se quella fonte lascia la chiave non impostata, Desktop ignora un elenco presente in una policy MDM o in un file di impostazioni gestite con priorità inferiore e tratta la chiave come [non impostata](/docs/it/settings-reference#sshhostallowlist). Desktop non mostra alcun avviso.

908 

909 Mantieni inoltre lo stesso elenco sulla macchina di ogni utente, nella policy MDM o nel file di impostazioni gestite con priorità più alta su quella macchina. Desktop recupera le impostazioni gestite dal server all'avvio e non conserva alcuna copia nella cache, quindi finché un recupero non riesce si applica l'elenco della macchina.

910</Warning>

911 

873I modelli sono case-insensitive. `*` corrisponde a qualsiasi host, e `*.example.com` corrisponde a `example.com` e a qualsiasi sottodominio. Tutto il resto è una corrispondenza esatta. Il controllo viene eseguito sul nome host dopo la risoluzione di `~/.ssh/config` tramite `ssh -G`, quindi gli alias `Host` e le voci `ProxyCommand`/`ProxyJump` sono consentiti purché il `HostName` risolto corrisponda.912I modelli sono case-insensitive. `*` corrisponde a qualsiasi host, e `*.example.com` corrisponde a `example.com` e a qualsiasi sottodominio. Tutto il resto è una corrispondenza esatta. Il controllo viene eseguito sul nome host dopo la risoluzione di `~/.ssh/config` tramite `ssh -G`, quindi gli alias `Host` e le voci `ProxyCommand`/`ProxyJump` sono consentiti purché il `HostName` risolto corrisponda.

874 913 

875`sshHostAllowlist` viene letto solo dalle impostazioni gestite; i valori nelle impostazioni utente o progetto vengono ignorati. Solo l'app Claude Desktop onora questa impostazione; la CLI Claude Code e le estensioni IDE non la leggono, e non limita i comandi `ssh` eseguiti tramite lo strumento Bash. Governa a quali host l'app Desktop si connette, non l'uscita di rete, quindi abbinalo ai controlli di rete della tua organizzazione o zero-trust se hai bisogno di un confine rigido.914`sshHostAllowlist` viene letto solo dalle impostazioni gestite; i valori nelle impostazioni utente o progetto vengono ignorati. Solo l'app Claude Desktop onora questa impostazione; la CLI Claude Code e le estensioni IDE non la leggono, e non limita i comandi `ssh` eseguiti tramite lo strumento Bash. Governa a quali host l'app Desktop si connette, non l'uscita di rete, quindi abbinalo ai controlli di rete della tua organizzazione o zero-trust se hai bisogno di un confine rigido.


913| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](/docs/it/desktop-ios-simulator#turn-off-simulator-access). Il riquadro rimane utilizzabile per i tocchi dell'utente; solo l'accesso di Claude viene rimosso. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |952| `disableMobileSimulatorTools` | imposta su `true` per bloccare gli strumenti di Claude per il controllo e l'acquisizione dei dispositivi nel [riquadro iOS Simulator](/docs/it/desktop-ios-simulator#turn-off-simulator-access). Il riquadro rimane utilizzabile per i tocchi dell'utente; solo l'accesso di Claude viene rimosso. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |

914| `disableBrowserExternalNavigation` | imposta su `true` per disattivare completamente la navigazione esterna nel [riquadro Browser](#browse-external-sites). Né gli utenti né Claude possono navigare verso siti esterni, e le anteprime del server localhost dev non sono interessate. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |953| `disableBrowserExternalNavigation` | imposta su `true` per disattivare completamente la navigazione esterna nel [riquadro Browser](#browse-external-sites). Né gli utenti né Claude possono navigare verso siti esterni, e le anteprime del server localhost dev non sono interessate. Il valore deve essere il booleano JSON `true`; la stringa `"true"` viene ignorata. |

915| `sshConfigs` | pre-configura le [connessioni SSH](#pre-configure-ssh-connections-for-your-team) che appaiono nel menu a discesa dell'ambiente. Gli utenti non possono modificare o eliminare le connessioni gestite. |954| `sshConfigs` | pre-configura le [connessioni SSH](#pre-configure-ssh-connections-for-your-team) che appaiono nel menu a discesa dell'ambiente. Gli utenti non possono modificare o eliminare le connessioni gestite. |

916| `sshHostAllowlist` | limita le [sessioni SSH](#restrict-which-ssh-hosts-users-can-connect-to) agli host il cui nome host risolto corrisponde a uno di questi modelli. Un array vuoto disabilita le sessioni SSH. Letto solo dalle impostazioni gestite. |955| `sshHostAllowlist` | limita le [sessioni SSH](#restrict-which-ssh-hosts-users-can-connect-to) agli host il cui nome host risolto corrisponde a uno di questi modelli. Letto solo dalle impostazioni gestite. |

917| `disableDesktopLocalSessions` | imposta su `true` per disattivare le [sessioni Code che vengono eseguite sul dispositivo](#local-sessions-on-managed-devices), lasciando disponibili le sessioni SSH verso altri host e le sessioni cloud. Il valore deve essere il booleano JSON `true`. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.37937.0 o successivo. |956| `disableDesktopLocalSessions` | imposta su `true` per disattivare le [sessioni Code che vengono eseguite sul dispositivo](#local-sessions-on-managed-devices), lasciando disponibili le sessioni SSH verso altri host e le sessioni cloud. Il valore deve essere il booleano JSON `true`. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.37937.0 o successivo. |

918| `disableSshSavedPasswords` | imposta su `true` per impedire a Desktop di offrire di ricordare le password SSH e di usare o mostrare quelle salvate in precedenza. Attivarla non le elimina. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.49585.0 o successivo. |957| `disableSshSavedPasswords` | imposta su `true` per impedire a Desktop di offrire di ricordare le password SSH e di usare o mostrare quelle salvate in precedenza. Attivarla non le elimina. Letto solo dalle impostazioni gestite. Richiede Claude Desktop v1.49585.0 o successivo. |

919| `managedMcpServers` | invia le configurazioni del server MCP a tutti gli utenti. Disponibile solo nelle distribuzioni Desktop di terze parti (3P). In ogni voce, imposta un trasporto di `"http"`, `"sse"` o `"stdio"`, i dettagli della connessione e facoltativamente una mappa `toolPolicy` per limitare quali strumenti di quel server gli utenti possono invocare. Forniscilo tramite il file di impostazioni gestite, MDM o il blocco [`desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) di una politica gateway delle app Claude, poiché le distribuzioni di terze parti non ricevono le impostazioni della console di amministrazione. Per fornirlo tramite il gateway, hai bisogno di Claude Code v2.1.232 o successivo sul server gateway. Questa è la chiave dell'app desktop stessa; Claude Code legge un'[impostazione gestita con lo stesso nome](/docs/it/managed-mcp#provide-servers-through-managed-settings) propria, con una forma di voce diversa. |958| `managedMcpServers` | invia le configurazioni del server MCP a tutti gli utenti. Disponibile solo nelle distribuzioni Desktop di terze parti (3P). In ogni voce, imposta un trasporto di `"http"`, `"sse"` o `"stdio"`, i dettagli della connessione e facoltativamente una mappa `toolPolicy` per limitare quali strumenti di quel server gli utenti possono invocare. Forniscilo tramite il file di impostazioni gestite, MDM o il blocco [`desktop`](/docs/it/claude-apps-gateway-config#claude-desktop-overlay) di una politica gateway delle app Claude, poiché le distribuzioni di terze parti non ricevono le impostazioni della console di amministrazione. Per fornirlo tramite il gateway, hai bisogno di Claude Code v2.1.232 o successivo sul server gateway. Questa è la chiave dell'app desktop stessa; Claude Code legge un'[impostazione gestita con lo stesso nome](/docs/it/managed-mcp#provide-servers-through-managed-settings) propria, con una forma di voce diversa. |

920 959 

921Quali impostazioni gestite raggiungono una sessione Desktop dipende da dove quella sessione viene eseguita. Le restrizioni del modello come [`availableModels`](/docs/it/model-config#restrict-model-selection) vengono applicate nelle sessioni Claude Code di Desktop nello stesso modo che nel CLI del terminale; vedi [copertura della superficie](/docs/it/model-config#surface-coverage).960Quali impostazioni gestite raggiungono una sessione Desktop dipende da dove quella sessione viene eseguita. Le restrizioni del modello come [`availableModels`](/docs/it/model-config#restrict-model-selection) vengono applicate nelle sessioni Claude Code di Desktop nello stesso modo che nel CLI del terminale; vedi [copertura della superficie](/docs/it/model-config#surface-coverage).

922 961 

923* **Sessioni locali su questa macchina**: un file di impostazioni gestite distribuito su disco si applica. Le impostazioni gestite inviate in remoto tramite la console di amministrazione raggiungono anche queste sessioni sull'API di Anthropic quando la sessione si autentica con un [accesso o una chiave idonei](/docs/it/server-managed-settings#platform-availability), seguendo la stessa [precedenza delle impostazioni](/docs/it/settings#settings-precedence) del CLI del terminale.962* **Sessioni locali su questa macchina**: un file di impostazioni gestite distribuito su disco si applica. Le impostazioni gestite inviate in remoto tramite la console di amministrazione raggiungono anche queste sessioni sull'API di Anthropic quando la sessione si autentica con un [accesso idoneo](/docs/it/server-managed-settings#platform-availability), seguendo la stessa [precedenza delle impostazioni](/docs/it/settings#settings-precedence) del CLI del terminale.

924* **[Sessioni cloud](#cloud-sessions)**: ricevono [impostazioni gestite dal server](/docs/it/server-managed-settings); i file distribuiti su dispositivo non le raggiungono, perché vengono eseguite su VM gestite da Anthropic. Le sessioni instradate a un [ambiente self-hosted](/docs/it/self-hosted-environments) leggono anche il file di impostazioni gestite nell'immagine del runner. [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quando quel file si applica.963* **[Sessioni cloud](#cloud-sessions)**: ricevono [impostazioni gestite dal server](/docs/it/server-managed-settings); i file distribuiti su dispositivo non le raggiungono, perché vengono eseguite su VM gestite da Anthropic. Le sessioni instradate a un [ambiente self-hosted](/docs/it/self-hosted-environments) leggono anche il file di impostazioni gestite nell'immagine del runner. [Come Claude Code combina le fonti gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) dice quando quel file si applica.

925* **[Sessioni SSH](#ssh-sessions)**: la sessione legge il file di impostazioni gestite dall'host remoto. Desktop stesso legge `sshConfigs`, `sshHostAllowlist`, `disableSshSavedPasswords` e `disableDesktopLocalSessions` dalle impostazioni gestite della macchina locale.964* **[Sessioni SSH](#ssh-sessions)**: la sessione legge il file di impostazioni gestite dall'host remoto. Desktop stesso legge `sshConfigs`, `sshHostAllowlist`, `disableSshSavedPasswords` e `disableDesktopLocalSessions` sulla macchina locale. Se fornisci più di una fonte gestita, le legge da [una sola per impostazione predefinita](/docs/it/managed-settings#how-claude-code-combines-managed-sources).

926* **Sessioni [Cowork](https://claude.com/docs/cowork/overview)**: in una sessione Cowork su questa macchina, Claude Code non recupera mai le impostazioni della console di amministrazione, anche quando l'utente accede con un account Team o Enterprise, e legge la politica distribuita sulla macchina a meno che la tua configurazione di Claude Desktop non imposti `requireCoworkFullVmSandbox`. Le sessioni Cowork remote non ricevono nessuna delle due. Vedi [dove e quando una politica si applica](/docs/it/managed-settings#where-and-when-a-policy-applies) per sapere quali file di dispositivo raggiungono Cowork, e [regole di permesso MCP](/docs/it/permissions#mcp) per come le regole `Bash` e `WebFetch` si applicano agli strumenti di Cowork.965* **Sessioni [Cowork](https://claude.com/docs/cowork/overview)**: in una sessione Cowork su questa macchina, Claude Code non recupera mai le impostazioni della console di amministrazione, anche quando l'utente accede con un account Team o Enterprise, e legge la politica distribuita sulla macchina a meno che la tua configurazione di Claude Desktop non imposti `requireCoworkFullVmSandbox`. Le sessioni Cowork remote non ricevono nessuna delle due. Vedi [dove e quando una politica si applica](/docs/it/managed-settings#where-and-when-a-policy-applies) per sapere quali file di dispositivo raggiungono Cowork, e [regole di permesso MCP](/docs/it/permissions#mcp) per come le regole `Bash` e `WebFetch` si applicano agli strumenti di Cowork.

927 966 

928Nelle sessioni locali e SSH, l'app desktop fornisce i connettori claude.ai connessi di ogni utente a Claude Code direttamente. Nessuna impostazione MCP o `managed-mcp.json` raggiunge quei connettori, indipendentemente dalla fonte di impostazioni o dalla posizione del file che usi. Per bloccare gli strumenti di un connettore in queste sessioni, usa i [controlli degli strumenti del connettore](/docs/it/mcp#organization-controls-on-connector-tools) della tua organizzazione. [Come i connettori raggiungono Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) mostra quali impostazioni governano i connettori in ogni tipo di sessione.967Nelle sessioni locali e SSH, l'app desktop fornisce i connettori claude.ai connessi di ogni utente a Claude Code direttamente. Nessuna impostazione MCP o `managed-mcp.json` raggiunge quei connettori, indipendentemente dalla fonte di impostazioni o dalla posizione del file che usi. Per bloccare gli strumenti di un connettore in queste sessioni, usa i [controlli degli strumenti del connettore](/docs/it/mcp#organization-controls-on-connector-tools) della tua organizzazione. [Come i connettori raggiungono Claude Code](/docs/it/mcp#how-connectors-reach-claude-code) mostra quali impostazioni governano i connettori in ogni tipo di sessione.


975assets-proxy.anthropic.com1014assets-proxy.anthropic.com

976claude.ai1015claude.ai

977a.claude.ai1016a.claude.ai

978a-cdn.claude.ai

979assets.claude.ai1017assets.claude.ai

980downloads.claude.ai1018downloads.claude.ai

981*.livepreview.claude.ai1019*.livepreview.claude.ai


1023 Provieni dalla CLI?1061 Provieni dalla CLI?

1024</h2>1062</h2>

1025 1063 

1026Se usi già la CLI di Claude Code, Desktop esegue lo stesso motore sottostante con un'interfaccia grafica. Puoi eseguire entrambi contemporaneamente sulla stessa macchina, anche sullo stesso progetto. Ognuno mantiene una storia di sessione separata, e puoi portare una sessione CLI in Desktop. Condividono configurazione e memoria del progetto tramite file CLAUDE.md.1064Se usi già la CLI di Claude Code, Desktop esegue lo stesso motore sottostante con un'interfaccia grafica. Puoi eseguire entrambi contemporaneamente sulla stessa macchina, anche sullo stesso progetto. Ognuno mantiene il proprio elenco di sessioni, e puoi portare una sessione CLI in Desktop. Condividono configurazione e memoria del progetto tramite file CLAUDE.md.

1027 1065 

1028Per spostare una sessione CLI in Desktop, esegui `/desktop` nel terminale. Claude salva la tua sessione e l'apre nell'app desktop, quindi esce dalla CLI. Questo comando è disponibile su macOS e Windows x64 quando sei connesso con un abbonamento Claude. Non è disponibile con autenticazione tramite chiave API o su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.1066Per spostare una sessione CLI in Desktop, esegui `/desktop` nel terminale. Claude salva la tua sessione e l'apre nell'app desktop, quindi esce dalla CLI. Questo comando è disponibile su macOS e Windows x64 quando sei connesso con un abbonamento Claude. Non è disponibile con autenticazione tramite chiave API o su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.

1029 1067 


1033claude --desktop --resume <session-id>1071claude --desktop --resume <session-id>

1034```1072```

1035 1073 

1036Claude Code stampa `Opening session <session-id> in Claude Desktop`, la sessione si apre nell'app e il comando esce. Un nome di sessione non funziona al posto dell'ID. Claude Code non sposta una sessione che è aperta in un altro terminale o ancora in esecuzione in background. Se Claude Desktop non è installato, il comando stampa un link di download e esce.1074Claude Code stampa `Opening session <session-id> in Claude Desktop`, la sessione si apre nell'app e il comando esce. Un nome di sessione non funziona al posto dell'ID. Claude Code non sposta una sessione che è aperta in un altro terminale o ancora in esecuzione in background. Se Claude Desktop non è installato, il comando stampa un link di download ed esce.

1037 1075 

1038Puoi anche riprendere una sessione CLI da Desktop con `/resume`. Il comando è disponibile nelle sessioni locali, non in SSH, WSL o sessioni cloud.1076Puoi anche riprendere una sessione CLI da Desktop con `/resume`. Il comando è disponibile nelle sessioni locali, non in SSH, WSL o sessioni cloud.

1039 1077 

1040Per continuare una sessione di terminale in Desktop:1078Per continuare una sessione di terminale in Desktop:

1041 1079 

10421. Chiudi la sessione nel terminale.10801. Chiudi la sessione nel terminale.

10432. Nella casella del prompt di Desktop, digita `/resume`. Desktop elenca le sessioni che hai avviato dalla CLI su questo computer. Cerca per titolo, cartella o ramo, e visualizza in anteprima dove ognuna si è fermata.10812. Nella casella del prompt di Desktop, digita `/resume`. Desktop elenca le sessioni che hai avviato dalla CLI su questo computer. Cerca per titolo, cartella o branch, e visualizza in anteprima dove ognuna si è fermata.

10443. Seleziona la sessione. Continua nell'app con la sua conversazione completa e il contesto.10823. Seleziona la sessione. Continua nell'app con la sua conversazione completa e il contesto.

1045 1083 

1046Desktop continua la stessa sessione piuttosto che una copia, quindi `claude --resume` nel terminale la trova ancora dopo.1084Desktop continua la stessa sessione piuttosto che una copia, quindi `claude --resume` nel terminale la trova ancora dopo.

1047 1085 

1048<Tip>1086<Tip>

1049 Quando usare Desktop vs CLI: usa Desktop quando vuoi gestire sessioni parallele in una finestra, organizzare pannelli uno accanto all'altro, o rivedere le modifiche visivamente. Usa la CLI quando hai bisogno di scripting, automazione, o preferisci un flusso di lavoro di terminale.1087 Quando usare Desktop vs CLI: usa Desktop quando vuoi gestire sessioni parallele in una finestra, organizzare pannelli uno accanto all'altro, o rivedere le modifiche visivamente. Usa la CLI quando hai bisogno di scripting, automazione, o preferisci un workflow da terminale.

1050</Tip>1088</Tip>

1051 1089 

1052<h3 id="cli-flag-equivalents">1090<h3 id="cli-flag-equivalents">


1062| `--permission-mode` | Selettore di modalità accanto al pulsante di invio |1100| `--permission-mode` | Selettore di modalità accanto al pulsante di invio |

1063| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |1101| `--dangerously-skip-permissions` | Modalità Bypass permissions. Su piani Pro e Max, abilitala in Impostazioni → Claude Code → "Allow bypass permissions mode"; su piani Team ed Enterprise, la politica organizzativa la controlla |

1064| `--add-dir` | Aggiungi più repo con il pulsante **+** nelle sessioni cloud |1102| `--add-dir` | Aggiungi più repo con il pulsante **+** nelle sessioni cloud |

1065| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di autorizzazione nei [file di impostazioni](/docs/it/settings) si applicano ancora. |1103| `--allowedTools`, `--disallowedTools` | Nessun equivalente per sessione. Le regole di permesso nei [file di impostazioni](/docs/it/settings) si applicano ancora. |

1066| `--verbose` | [Modalità di visualizzazione Verbose](#switch-view-modes) |1104| `--verbose` | [Modalità di visualizzazione Verbose](#switch-view-modes) |

1067| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |1105| `--print`, `--output-format` | Non disponibile. Desktop è solo interattivo. |

1068| `ANTHROPIC_MODEL` env var | Menu a discesa del modello accanto al pulsante di invio |1106| `ANTHROPIC_MODEL` env var | Menu a discesa del modello accanto al pulsante di invio |


1075Desktop e CLI leggono gli stessi file di configurazione, quindi la tua configurazione viene trasferita:1113Desktop e CLI leggono gli stessi file di configurazione, quindi la tua configurazione viene trasferita:

1076 1114 

1077* I file **[CLAUDE.md](/docs/it/memory)** e `CLAUDE.local.md` nel tuo progetto vengono utilizzati da entrambi1115* I file **[CLAUDE.md](/docs/it/memory)** e `CLAUDE.local.md` nel tuo progetto vengono utilizzati da entrambi

1078* I **[MCP servers](/docs/it/mcp)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi1116* I **[server MCP](/docs/it/mcp)** configurati in `~/.claude.json` o `.mcp.json` funzionano in entrambi

1079* **[Hooks](/docs/it/hooks)** e **[skills](/docs/it/skills)** definiti nelle impostazioni si applicano a entrambi1117* Gli **[hook](/docs/it/hooks)** e le **[skill](/docs/it/skills)** definiti nelle impostazioni si applicano a entrambi

1080* **[Impostazioni](/docs/it/settings)** in `~/.claude.json` e `~/.claude/settings.json` sono condivise. Le regole di autorizzazione, gli strumenti consentiti e altre impostazioni in `settings.json` si applicano alle sessioni Desktop.1118* Le **[impostazioni](/docs/it/settings)** in `~/.claude.json` e `~/.claude/settings.json` sono condivise. Le regole di permesso, gli strumenti consentiti e altre impostazioni in `settings.json` si applicano alle sessioni Desktop.

1081* **Modelli**: gli stessi [modelli](/docs/it/model-config#available-models) sono disponibili in entrambi. In Desktop, seleziona il modello dal menu a discesa accanto al pulsante di invio. Puoi cambiare il modello durante una sessione dal stesso menu a discesa.1119* **Modelli**: gli stessi [modelli](/docs/it/model-config#available-models) sono disponibili in entrambi. In Desktop, seleziona il modello dal menu a discesa accanto al pulsante di invio. Puoi cambiare il modello durante una sessione dallo stesso menu a discesa.

1082 1120 

1083<h4 id="mcp-servers-from-the-claude-desktop-chat-app">1121<h4 id="mcp-servers-from-the-claude-desktop-chat-app">

1084 MCP servers dall'app desktop chat Claude1122 Server MCP dall'app desktop chat Claude

1085</h4>1123</h4>

1086 1124 

1087L'app Desktop carica i MCP servers da `claude_desktop_config.json` nelle sessioni della scheda Code, insieme ai server da `~/.claude.json` e `.mcp.json`. Un server definito in `claude_desktop_config.json` è disponibile sia nella superficie desktop chat che nella scheda Code.1125L'app Desktop carica i server MCP da `claude_desktop_config.json` nelle sessioni locali della scheda Code, insieme ai server da `~/.claude.json` e `.mcp.json`. Un server definito in `claude_desktop_config.json` è disponibile sia nella superficie desktop chat sia nelle sessioni locali della scheda Code.

1088 1126 

1089Se definisci lo stesso nome di server in `claude_desktop_config.json` e in `~/.claude.json` o `.mcp.json`, la scheda Code nelle sessioni locali si connette una volta e utilizza la definizione di `claude_desktop_config.json`.1127Se definisci lo stesso nome di server in `claude_desktop_config.json` e in `~/.claude.json` o `.mcp.json`, la scheda Code nelle sessioni locali si connette una volta e utilizza la definizione di `claude_desktop_config.json`.

1090 1128 

1091L'app inoltre ri-consegna i server stdio da `~/.claude.json` alla CLI incorporata nelle sessioni locali. Quando il livello superiore di `~/.claude.json` (ambito utente) e `.mcp.json` definiscono lo stesso nome di server stdio, la scheda Code utilizza la definizione di `~/.claude.json`, divergendo dalla [gerarchia di ambito](/docs/it/mcp#scope-hierarchy-and-precedence) della CLI.1129L'app inoltre ri-consegna i server stdio da `~/.claude.json` alla CLI incorporata nelle sessioni locali. Quando il livello superiore di `~/.claude.json` (ambito utente) e `.mcp.json` definiscono lo stesso nome di server stdio, la scheda Code utilizza la definizione di `~/.claude.json`, divergendo dalla [gerarchia di ambito](/docs/it/mcp#scope-hierarchy-and-precedence) della CLI.

1092 1130 

1093<Note>1131<Note>

1094 La CLI standalone non legge `claude_desktop_config.json`. Su macOS e WSL, esegui `claude mcp add-from-claude-desktop` per copiare questi server in `~/.claude.json`. Vedi [Importa MCP servers da Claude Desktop](/docs/it/mcp#import-mcp-servers-from-claude-desktop) per il flusso di importazione e le opzioni di ambito.1132 La CLI standalone non legge `claude_desktop_config.json`. Su macOS e WSL, esegui `claude mcp add-from-claude-desktop` per copiare questi server in `~/.claude.json`. Vedi [Importa server MCP da Claude Desktop](/docs/it/mcp#import-mcp-servers-from-claude-desktop) per il flusso di importazione e le opzioni di ambito.

1095</Note>1133</Note>

1096 1134 

1097<h3 id="feature-comparison">1135<h3 id="feature-comparison">


1102 1140 

1103| Funzionalità | CLI | Desktop |1141| Funzionalità | CLI | Desktop |

1104| - | - | - |1142| - | - | - |

1105| Modalità di autorizzazione | Tutte le modalità inclusa `dontAsk` | Manuale, Accetta modifiche, Plan e Auto. Bypass permissions appare nel selettore di modalità una volta abilitato: tramite l'interruttore Impostazioni su piani Pro e Max, o tramite la politica organizzativa su piani Team ed Enterprise |1143| Modalità di permesso | Tutte le modalità inclusa `dontAsk` | Manuale, Accetta modifiche, Plan e Auto. Bypass permissions appare nel selettore di modalità una volta abilitato: tramite l'interruttore Impostazioni su piani Pro e Max, o tramite la politica organizzativa su piani Team ed Enterprise |

1106| [Provider di terze parti](/docs/it/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API di Anthropic per impostazione predefinita. Per il routing tramite gateway, vedi [connetti l'app desktop a un gateway](/docs/it/llm-gateway-connect#desktop-app). Per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, vedi [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |1144| [Provider di terze parti](/docs/it/third-party-integrations) | Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry | API di Anthropic per impostazione predefinita. Per il routing tramite gateway, vedi [connetti l'app desktop a un gateway](/docs/it/llm-gateway-connect#desktop-app). Per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, vedi [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). |

1107| [MCP servers](/docs/it/mcp) | Configura nei file di impostazioni | UI Connectors per sessioni locali e SSH, o file di impostazioni |1145| [Server MCP](/docs/it/mcp) | Configura nei file di impostazioni | UI Connectors per sessioni locali e SSH, o file di impostazioni |

1108| [Plugins](/docs/it/plugins/overview) | Comando `/plugin` | UI gestore plugin |1146| [Plugin](/docs/it/plugins/overview) | Comando `/plugin` | UI gestore plugin |

1109| @mention file | Basato su testo | Con autocomplete; sessioni locali e SSH solo |1147| @mention file | Basato su testo | Con autocomplete; solo sessioni locali e SSH |

1110| Allegati di file | Non disponibile | Immagini, PDF |1148| Allegati di file | Non disponibile | Immagini, PDF |

1111| Isolamento della sessione | Flag [`--worktree`](/docs/it/cli-reference) | Opzione **worktree** quando si avvia una sessione |1149| Isolamento della sessione | Flag [`--worktree`](/docs/it/cli-reference) | Opzione **worktree** quando si avvia una sessione |

1112| Sessioni multiple | Terminali separati | Schede della barra laterale |1150| Sessioni multiple | Terminali separati | Schede della barra laterale |


1124 1162 

1125* **Provider di terze parti**: Desktop si connette all'API di Anthropic per impostazione predefinita. Per instradare Desktop attraverso un gateway, o per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, segui i link nella [riga Provider di terze parti](#feature-comparison).1163* **Provider di terze parti**: Desktop si connette all'API di Anthropic per impostazione predefinita. Per instradare Desktop attraverso un gateway, o per eseguire la scheda Code su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o un gateway LLM self-hosted, segui i link nella [riga Provider di terze parti](#feature-comparison).

1126* **Linux (beta)**: Computer Use non è ancora disponibile nell'app desktop Linux. Vedi [Claude Desktop su Linux](/docs/it/desktop-linux).1164* **Linux (beta)**: Computer Use non è ancora disponibile nell'app desktop Linux. Vedi [Claude Desktop su Linux](/docs/it/desktop-linux).

1127* **Suggerimenti di codice inline**: Desktop non fornisce suggerimenti in stile autocomplete. Funziona tramite prompt conversazionali e modifiche di codice esplicite.1165* **Suggerimenti di codice inline**: Desktop non fornisce suggerimenti in stile autocomplete. Funziona tramite prompt conversazionali e modifiche di codice esplicite, e può [suggerirti il prossimo prompt](#accept-a-suggested-prompt) dopo che Claude ha risposto.

1128* **Team di agent**: team coordinati, dove Claude come team lead assegna compiti ai compagni di squadra da un elenco di compiti condiviso, sono disponibili nella [CLI](/docs/it/agent-teams), non in Desktop. Per il lavoro multi-agent all'interno di una sessione, usa i [flussi di lavoro dinamici](/docs/it/workflows), che vengono eseguiti in Desktop; Claude può anche [messaggiare e gestire le tue altre sessioni](#work-across-sessions) direttamente.1166* **Team di agenti**: team coordinati, dove Claude come team lead assegna compiti ai compagni di squadra da un elenco di compiti condiviso, sono disponibili nella [CLI](/docs/it/agent-teams), non in Desktop. Per il lavoro multi-agente all'interno di una sessione, usa i [workflow dinamici](/docs/it/workflows), che vengono eseguiti in Desktop; Claude può anche [inviare messaggi alle tue altre sessioni e gestirle](#work-across-sessions) direttamente.

1129* **Comandi terminal-dialog**: i comandi integrati che aprono un pannello interattivo nel terminale si comportano diversamente nella scheda Code. Modifica direttamente i [file di impostazioni](/docs/it/settings) per gestire le regole di autorizzazione e la configurazione, oppure esegui i comandi dalla CLI standalone.1167* **Comandi terminal-dialog**: i comandi integrati che aprono un pannello interattivo nel terminale si comportano diversamente nella scheda Code. Modifica direttamente i [file di impostazioni](/docs/it/settings) per gestire le regole di permesso e la configurazione, oppure esegui i comandi dalla CLI standalone.

1130 * I comandi senza forma di argomento, come `/permissions`, rispondono con `isn't available in this environment`.1168 * I comandi senza forma di argomento, come `/permissions`, rispondono con `isn't available in this environment`.

1131 * `/config` apre Impostazioni → Claude Code. Il testo dopo il comando viene ignorato, quindi `/config theme=dark` non imposta il tema.1169 * `/config` apre Impostazioni → Claude Code. Il testo dopo il comando viene ignorato, quindi `/config theme=dark` non imposta il tema.

1132 1170 


1147 1185 

1148Fai clic sul numero di versione per copiarlo negli appunti.1186Fai clic sul numero di versione per copiarlo negli appunti.

1149 1187 

1188<h4 id="claude-code-version-in-the-code-tab">

1189 Versione di Claude Code nella scheda Code

1190</h4>

1191 

1192Per vedere quale versione di Claude Code esegue una sessione, digita `/status` in una sessione locale nella scheda **Code** e leggi la riga **Claude Code**, che mostra una versione come `2.1.286`.

1193 

1194Per ottenere una versione più recente per le sessioni locali, apri **Claude → Check for Updates** su macOS o **Help → Check for Updates** su Windows, quindi avvia una nuova sessione.

1195 

1196In una sessione locale, la scheda **Code** esegue una propria copia di Claude Code, che ha un proprio numero di versione. L'app desktop scarica e aggiorna quella copia, quindi può differire dal comando `claude` nel tuo terminale, e aggiornarne una non aggiorna l'altra.

1197 

1150<h3 id="403-or-authentication-errors-in-the-code-tab">1198<h3 id="403-or-authentication-errors-in-the-code-tab">

1151 403 or authentication errors in the Code tab1199 403 or authentication errors in the Code tab

1152</h3>1200</h3>

env-vars.md +284 −282

Details

126 Variabili126 Variabili

127</h2>127</h2>

128 128 

129Le variabili numeriche come timeout, budget di token e numero di nuovi tentativi accettano la notazione scientifica e le grafie con separatore di cifre oltre alle cifre semplici, tranne dove la riga di una variabile indica che accetta solo cifre semplici. Ad esempio, Claude Code legge `2e3` come 2000 e `64_000` come 64000. Prima della v2.1.211, queste grafie potevano impostare silenziosamente un valore molto più piccolo, ad esempio `1e6` impostava un timeout a 1.129Le variabili numeriche come timeout, budget di token e numero di nuovi tentativi accettano la notazione scientifica e la scrittura con separatori di cifre oltre alle semplici cifre, tranne dove la riga di una variabile indica che accetta solo cifre semplici. Ad esempio, Claude Code legge `2e3` come 2000 e `64_000` come 64000. Prima della v2.1.211, queste scritture potevano impostare silenziosamente un valore molto più piccolo, ad esempio `1e6` impostava un timeout a 1.

130 130 

131<Note>131<Note>

132 Per le variabili che attivano o disattivano un comportamento, imposta `1`, `true`, `yes` o `on` per attivarlo e `0`, `false`, `no` o `off` per disattivarlo, con qualsiasi combinazione di maiuscole e minuscole.132 Per le variabili che attivano o disattivano un comportamento, imposta `1`, `true`, `yes` o `on` per attivarlo e `0`, `false`, `no` o `off` per disattivarlo, con qualsiasi combinazione di maiuscole e minuscole.

133 133 

134 Alcune variabili verificano solo se le hai impostate, quindi qualsiasi valore non vuoto, incluso `0`, attiva il comportamento, e lo disattivi rimuovendo la variabile o impostandola su un valore vuoto. Queste variabili funzionano in questo modo:134 Alcune variabili verificano solo se le hai impostate o meno, quindi qualsiasi valore non vuoto, incluso `0`, attiva il comportamento, e per disattivarlo devi rimuovere la variabile o impostarla su un valore vuoto. Queste variabili funzionano in questo modo:

135 135 

136 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`136 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

137 * `DISABLE_TELEMETRY`137 * `DISABLE_TELEMETRY`


140 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`140 * `FALLBACK_FOR_ALL_PRIMARY_MODELS`

141 * `IS_DEMO`141 * `IS_DEMO`

142 142 

143 Un'altra variabile ha una regola propria: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. Anche la riga di ciascuna variabile indica la propria regola.143 Un'altra variabile ha una regola propria: `FORCE_HYPERLINK` legge un numero, quindi solo `0` la disattiva. Anche la riga di ciascuna variabile indica la sua regola.

144</Note>144</Note>

145 145 

146| Variabile | Scopo |146| Variabile | Scopo |

147| :- | :- |147| :- | :- |

148| `ANTHROPIC_API_KEY` | Chiave API inviata come header `X-Api-Key`. Quando è impostata, questa chiave viene usata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se hai effettuato l'accesso. In modalità non interattiva (`-p`), la chiave viene sempre usata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sovrascriva il tuo abbonamento. Per usare invece il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY` |148| `ANTHROPIC_API_KEY` | Chiave API inviata come header `X-Api-Key`. Quando è impostata, questa chiave viene usata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se hai effettuato l'accesso. In modalità non interattiva (`-p`), la chiave viene sempre usata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sostituisca il tuo abbonamento. Per usare invece il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY` |

149| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'header `Authorization` (al valore che imposti qui verrà anteposto `Bearer `) |149| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'header `Authorization` (al valore impostato qui verrà anteposto `Bearer `) |

150| `ANTHROPIC_AWS_API_KEY` | Chiave API del workspace per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), generata nella AWS Console. Viene inviata come `x-api-key` e ha la precedenza su AWS SigV4 |150| `ANTHROPIC_AWS_API_KEY` | Chiave API del workspace per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), generata nella AWS Console. Inviata come `x-api-key` e ha la precedenza su AWS SigV4 |

151| `ANTHROPIC_AWS_BASE_URL` | Sovrascrive l'URL dell'endpoint di [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Usala per regioni personalizzate o quando instradi il traffico tramite un [gateway LLM](/docs/it/llm-gateway). Il valore predefinito è `https://aws-external-anthropic.{region}.api.aws`. Claude Code determina la regione con la [stessa precedenza usata su Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |151| `ANTHROPIC_AWS_BASE_URL` | Sovrascrive l'URL dell'endpoint di [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Usala per regioni personalizzate o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Il valore predefinito è `https://aws-external-anthropic.{region}.api.aws`. Claude Code determina la regione con la [stessa precedenza di Amazon Bedrock](/docs/it/amazon-bedrock#3-configure-claude-code) |

152| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatoria per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Viene inviata in ogni richiesta come header `anthropic-workspace-id` |152| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatoria per [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Inviata in ogni richiesta come header `anthropic-workspace-id` |

153| `ANTHROPIC_BASE_URL` | Sovrascrive l'endpoint API per instradare le richieste tramite un proxy o un gateway. Quando è impostata su un host non di prima parte, [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitato per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference`. Dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questa variabile punta a un host diverso da `api.anthropic.com`, come avviene su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |153| `ANTHROPIC_BASE_URL` | Sovrascrive l'endpoint API per instradare le richieste attraverso un proxy o un gateway. Quando è impostata su un host non first-party, [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search) è disabilitato per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference`. A partire dalla v2.1.196, [Remote Control](/docs/it/remote-control#requirements) è disabilitato quando questa variabile punta a un host diverso da `api.anthropic.com`, in linea con il suo comportamento su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry |

154| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrive l'URL dell'endpoint Amazon Bedrock. Usala per endpoint Amazon Bedrock personalizzati o quando instradi il traffico tramite un [gateway LLM](/docs/it/llm-gateway). Consulta [Amazon Bedrock](/docs/it/amazon-bedrock) |154| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrive l'URL dell'endpoint di Amazon Bedrock. Usala per endpoint Amazon Bedrock personalizzati o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Vedi [Amazon Bedrock](/docs/it/amazon-bedrock) |

155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrive l'URL dell'endpoint Amazon Bedrock Mantle. Consulta [Endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) |155| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrive l'URL dell'endpoint di Amazon Bedrock Mantle. Vedi [Endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) |

156| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefisso del profilo di inferenza cross-region (`us`, `eu`, `apac`, `jp`, `au` o `global`) che Claude Code prova per primo invece di quello derivato dalla regione AWS. Ignorata nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successiva. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#cross-region-inference-profile-prefixes) |156| `ANTHROPIC_BEDROCK_REGION_PREFIX` | Prefisso del profilo di inferenza cross-region (`us`, `eu`, `apac`, `jp`, `au` o `global`) che Claude Code prova per primo invece di quello derivato dalla regione AWS. Ignorata nelle regioni AWS GovCloud. Richiede Claude Code v2.1.224 o successiva. Vedi [Amazon Bedrock](/docs/it/amazon-bedrock#cross-region-inference-profile-prefixes) |

157| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Livello di servizio](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) di Amazon Bedrock (`default`, `flex` o `priority`). Viene inviato come header `X-Amzn-Bedrock-Service-Tier`. Consulta [Amazon Bedrock](/docs/it/amazon-bedrock#service-tiers) |157| `ANTHROPIC_BEDROCK_SERVICE_TIER` | [Livello di servizio](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) di Amazon Bedrock (`default`, `flex` o `priority`). Inviato come header `X-Amzn-Bedrock-Service-Tier`. Vedi [Amazon Bedrock](/docs/it/amazon-bedrock#service-tiers) |

158| `ANTHROPIC_BETAS` | Elenco separato da virgole di valori aggiuntivi dell'header `anthropic-beta` da includere nelle richieste API. Claude Code invia già gli header beta di cui ha bisogno; usala per aderire a una [beta dell'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) prima che Claude Code aggiunga il supporto nativo. A differenza del [flag `--betas`](/docs/it/cli-reference#cli-flags), che richiede l'autenticazione tramite chiave API, questa variabile funziona con tutti i metodi di autenticazione, incluso l'abbonamento Claude.ai |158| `ANTHROPIC_BETAS` | Elenco separato da virgole di valori aggiuntivi dell'header `anthropic-beta` da includere nelle richieste API. Claude Code invia già gli header beta di cui ha bisogno; usala per aderire a una [beta dell'API Anthropic](https://platform.claude.com/docs/en/api/beta-headers) prima che Claude Code aggiunga il supporto nativo. A differenza del [flag `--betas`](/docs/it/cli-reference#cli-flags), che richiede l'autenticazione con chiave API, questa variabile funziona con tutti i metodi di autenticazione, incluso l'abbonamento Claude.ai |

159| `ANTHROPIC_CUSTOM_HEADERS` | Header personalizzati da aggiungere alle richieste (formato `Name: Value`, separati da un a capo per più header). Se un nome o un valore contiene un carattere che un header HTTP non può trasportare, come una virgoletta curva o uno spazio a larghezza zero, la richiesta fallisce con un errore che identifica la coppia in base alla posizione. Richiede Claude Code v2.1.227 o successiva. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca il set esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un header di credenziali, organizzazione o tenant, instradamento o comportamento dell'API, come `Authorization` o `Host`, conta come [impostazione che richiede approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando viene fornito dalle impostazioni gestite dal server. Dalle impostazioni di progetto o locali, un valore di questo tipo segue le [regole su quando si applicano i valori `env`](/docs/it/settings-reference#when-claude-code-applies-env-values) |159| `ANTHROPIC_CUSTOM_HEADERS` | Header personalizzati da aggiungere alle richieste (formato `Name: Value`, separati da un a capo per più header). Se un nome o un valore contiene un carattere che un header HTTP non può trasportare, come una virgoletta curva o uno spazio a larghezza zero, la richiesta fallisce con un errore che identifica la coppia in base alla posizione. Richiede Claude Code v2.1.227 o successiva. [Invalid request header value](/docs/it/errors#invalid-request-header-value) elenca il set esatto di caratteri e dove viene eseguito il controllo. Un valore che imposta un header di credenziali, organizzazione o tenant, instradamento o comportamento dell'API, come `Authorization` o `Host`, conta come [impostazione che richiede approvazione](/docs/it/server-managed-settings#environment-variables-and-the-approval-dialog) quando viene fornito dalle impostazioni gestite dal server. Dalle impostazioni di progetto o locali, un valore di questo tipo segue le [regole su quando si applicano i valori `env`](/docs/it/settings-reference#when-claude-code-applies-env-values) |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Usala per rendere selezionabile un modello non standard o specifico di un gateway senza sostituire gli alias integrati. Consulta [Configurazione del modello](/docs/it/model-config#add-a-custom-model-option) |160| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ID del modello da aggiungere come voce personalizzata nel selettore `/model`. Usala per rendere selezionabile un modello non standard o specifico del gateway senza sostituire gli alias integrati. Vedi [Configurazione del modello](/docs/it/model-config#add-a-custom-model-option) |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione visualizzata per la voce del modello personalizzato nel selettore `/model`. Il valore predefinito è `Custom model (<model-id>)` quando non è impostata |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | Descrizione visualizzata per la voce del modello personalizzato nel selettore `/model`. Se non è impostata, il valore predefinito è `Custom model (<model-id>)` |

162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome visualizzato per la voce del modello personalizzato nel selettore `/model`. Quando non è impostata, la voce mostra il nome del modello se Claude Code [riconosce l'ID](/docs/it/model-config#customize-pinned-model-display-and-capabilities), altrimenti l'ID del modello |162| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | Nome visualizzato per la voce del modello personalizzato nel selettore `/model`. Se non è impostata, la voce mostra il nome del modello se Claude Code [riconosce l'ID](/docs/it/model-config#customize-pinned-model-display-and-capabilities), altrimenti l'ID del modello |

163| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello personalizzato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |163| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello personalizzato, ad esempio `effort,thinking`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID del modello a cui si risolve l'alias `fable`, e ID che Claude Code riconosce come modello Fable per il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui provider di terze parti. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |164| `ANTHROPIC_DEFAULT_FABLE_MODEL` | ID del modello a cui si risolve l'alias `fable`, e l'ID che Claude Code riconosce come modello Fable per il [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui provider di terze parti. Vedi [Configurazione del modello](/docs/it/model-config#environment-variables) |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Fable fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Fable fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Fable model`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome visualizzato per il modello Fable fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |166| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | Nome visualizzato per il modello Fable fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

167| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Fable fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |167| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Fable fissato, ad esempio `effort,thinking`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID del modello a cui si risolve l'alias `haiku`, usato anche per le [funzionalità in background](/docs/it/costs#background-token-usage). Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | ID del modello a cui si risolve l'alias `haiku`, usato anche per le [funzionalità in background](/docs/it/costs#background-token-usage). Vedi [Configurazione del modello](/docs/it/model-config#environment-variables) |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Haiku fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Haiku fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Haiku model`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome visualizzato per il modello Haiku fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |170| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | Nome visualizzato per il modello Haiku fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

171| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Haiku fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |171| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Haiku fissato, ad esempio `effort,thinking`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

172| `ANTHROPIC_DEFAULT_MODEL` | Modello con cui le nuove sessioni iniziano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva. Consulta [Impostare un modello predefinito per le nuove sessioni](/docs/it/model-config#set-a-default-model-for-new-sessions) |172| `ANTHROPIC_DEFAULT_MODEL` | Modello con cui iniziano per impostazione predefinita le nuove sessioni. Richiede Claude Code v2.1.236 o successiva. Vedi [Impostare un modello predefinito per le nuove sessioni](/docs/it/model-config#set-a-default-model-for-new-sessions) |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID del modello a cui si risolve l'alias `opus`, e che `opusplan` usa mentre il Plan Mode è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |173| `ANTHROPIC_DEFAULT_OPUS_MODEL` | ID del modello a cui si risolve l'alias `opus`, e che `opusplan` usa quando il Plan Mode è attivo. Vedi [Configurazione del modello](/docs/it/model-config#environment-variables) |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome visualizzato per il modello Opus fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |175| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome visualizzato per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

176| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Opus fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |176| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Opus fissato, ad esempio `effort,thinking`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID del modello a cui si risolve l'alias `sonnet`, e che `opusplan` usa quando il Plan Mode non è attivo. Consulta [Configurazione del modello](/docs/it/model-config#environment-variables) |177| `ANTHROPIC_DEFAULT_SONNET_MODEL` | ID del modello a cui si risolve l'alias `sonnet`, e che `opusplan` usa quando il Plan Mode non è attivo. Vedi [Configurazione del modello](/docs/it/model-config#environment-variables) |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Sonnet fissato nel selettore `/model`. Quando non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Sonnet fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Sonnet model`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome visualizzato per il modello Sonnet fissato nel selettore `/model`. Quando non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |179| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | Nome visualizzato per il modello Sonnet fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

180| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Sonnet fissato, ad esempio `effort,thinking`. Consulta [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |180| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle [funzionalità](/docs/it/model-config#customize-pinned-model-display-and-capabilities) supportate dal modello Sonnet fissato, ad esempio `effort,thinking`. Vedi [Configurazione del modello](/docs/it/model-config#customize-pinned-model-display-and-capabilities) |

181| `ANTHROPIC_FEDERATION_RULE_ID` | ID della regola di federazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando la imposti insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno priorità rispetto alle credenziali di `/login`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |181| `ANTHROPIC_FEDERATION_RULE_ID` | ID della regola di federazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Quando la imposti insieme a `ANTHROPIC_ORGANIZATION_ID`, Claude Code seleziona le credenziali di federazione, che hanno priorità più alta rispetto alla credenziale di `/login`. Vedi [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

182| `ANTHROPIC_FOUNDRY_API_KEY` | Chiave API per l'autenticazione Microsoft Foundry (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |182| `ANTHROPIC_FOUNDRY_API_KEY` | Chiave API per l'autenticazione con Microsoft Foundry (vedi [Microsoft Foundry](/docs/it/microsoft-foundry)) |

183| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Bearer token per l'autenticazione Microsoft Foundry, come un token di accesso Microsoft Entra. Claude Code lo invia come header `Authorization: Bearer`. Ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita di Azure. Consulta [Microsoft Foundry](/docs/it/microsoft-foundry). Richiede Claude Code v2.1.203 o successiva |183| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Token bearer per l'autenticazione con Microsoft Foundry, come un token di accesso Microsoft Entra. Claude Code lo invia come header `Authorization: Bearer`. Ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita di Azure. Vedi [Microsoft Foundry](/docs/it/microsoft-foundry). Richiede Claude Code v2.1.203 o successiva |

184| `ANTHROPIC_FOUNDRY_BASE_URL` | URL di base completo della risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |184| `ANTHROPIC_FOUNDRY_BASE_URL` | URL di base completo per la risorsa Microsoft Foundry (ad esempio, `https://my-resource.services.ai.azure.com/anthropic`). Alternativa a `ANTHROPIC_FOUNDRY_RESOURCE` (vedi [Microsoft Foundry](/docs/it/microsoft-foundry)) |

185| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Claude Code [rifiuta un URL o un nome host](/docs/it/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obbligatoria se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostata (consulta [Microsoft Foundry](/docs/it/microsoft-foundry)) |185| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Microsoft Foundry (ad esempio, `my-resource`). Claude Code [rifiuta un URL o un nome host](/docs/it/errors#anthropic-foundry-resource-must-be-a-foundry-resource-name). Obbligatoria se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostata (vedi [Microsoft Foundry](/docs/it/microsoft-foundry)) |

186| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da usare (consulta [Configurazione del modello](/docs/it/model-config#environment-variables)) |186| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da usare (vedi [Configurazione del modello](/docs/it/model-config#environment-variables)) |

187| `ANTHROPIC_ORGANIZATION_ID` | ID dell'organizzazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |187| `ANTHROPIC_ORGANIZATION_ID` | ID dell'organizzazione per [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala insieme a `ANTHROPIC_FEDERATION_RULE_ID`. Vedi [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

188| `ANTHROPIC_PROFILE` | Nome del profilo Anthropic con cui autenticarsi, come uno creato da [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) o [accedendo a un account Console senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Consulta [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |188| `ANTHROPIC_PROFILE` | Nome del profilo Anthropic con cui autenticarsi, come uno creato da [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) o [accedendo a un account Console senza chiave API](/docs/it/authentication#sign-in-without-an-api-key). Vedi [precedenza dell'autenticazione](/docs/it/authentication#authentication-precedence) |

189| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATA] Nome del [modello di classe Haiku per le attività in background](/docs/it/costs) |189| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATA] Nome del [modello di classe Haiku per le attività in background](/docs/it/costs) |

190| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrive la regione AWS per il modello di classe Haiku quando usi Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, ha effetto solo quando è impostata anche `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la deprecata `ANTHROPIC_SMALL_FAST_MODEL`, poiché altrimenti Amazon Bedrock esegue le attività in background sul [modello Sonnet predefinito o sul modello principale](/docs/it/amazon-bedrock#4-pin-model-versions) nella regione della sessione |190| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrive la regione AWS per il modello di classe Haiku quando usi Amazon Bedrock o Amazon Bedrock Mantle. Su Amazon Bedrock, ha effetto solo quando è impostata anche `ANTHROPIC_DEFAULT_HAIKU_MODEL` o la deprecata `ANTHROPIC_SMALL_FAST_MODEL`, poiché altrimenti Amazon Bedrock esegue le attività in background sul [modello Sonnet predefinito o sul modello principale](/docs/it/amazon-bedrock#4-pin-model-versions) nella regione della sessione |

191| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrive l'URL dell'endpoint di Google Cloud's Agent Platform. Usala per endpoint personalizzati di Google Cloud's Agent Platform o quando instradi il traffico tramite un [gateway LLM](/docs/it/llm-gateway). Consulta [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |191| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrive l'URL dell'endpoint di Google Cloud's Agent Platform. Usala per endpoint personalizzati di Google Cloud's Agent Platform o quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway). Vedi [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |

192| `ANTHROPIC_VERTEX_PROJECT_ID` | ID del progetto GCP a cui sono indirizzate le richieste di Google Cloud's Agent Platform. Consulta [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials) |192| `ANTHROPIC_VERTEX_PROJECT_ID` | ID del progetto GCP a cui sono indirizzate le richieste a Google Cloud's Agent Platform. Vedi [Configurare le credenziali GCP](/docs/it/google-vertex-ai#3-configure-gcp-credentials) |

193| `ANTHROPIC_WORKSPACE_ID` | ID del workspace per la [workload identity federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala quando la tua regola di federazione ha come ambito più di un workspace, in modo che lo scambio di token sappia quale workspace usare come destinazione |193| `ANTHROPIC_WORKSPACE_ID` | ID del workspace per la [federazione delle identità dei workload](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostala quando la tua regola di federazione ha come ambito più di un workspace, in modo che lo scambio di token sappia quale workspace usare come destinazione |

194| `API_FORCE_IDLE_TIMEOUT` | Sovrascrive il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Imposta `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale fa pause più lunghe di 5 minuti tra un blocco e l'altro, oppure `1` per mantenerlo attivo per ogni provider. Quando non è impostata, il timeout è attivo sui provider diversi dall'API Anthropic diretta, da [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e da Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostata. I [watchdog dello stream](/docs/it/network-config#streaming-idle-watchdogs) funzionano indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando imposti `0` qui |194| `API_FORCE_IDLE_TIMEOUT` | Sovrascrive il timeout di inattività del corpo di 5 minuti che interrompe una risposta del modello in streaming quando non arrivano byte. Imposta `0` per disattivare il timeout, ad esempio quando un [gateway](/docs/it/llm-gateway) lento o un modello locale si ferma per più di 5 minuti tra un chunk e l'altro, oppure `1` per mantenerlo attivo per ogni provider. Se non è impostata, il timeout è attivo sui provider diversi dall'API Anthropic diretta, da [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e da Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostata. I [watchdog dello stream](/docs/it/network-config#streaming-idle-watchdogs) vengono eseguiti indipendentemente da esso e interrompono una lunga pausa silenziosa anche quando imposti `0` qui |

195| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, ovvero 10 minuti; massimo: 2147483647). Aumentalo quando le richieste vanno in timeout su reti lente o quando instradi il traffico tramite un proxy. I valori superiori al massimo causano l'overflow del timer sottostante e fanno fallire immediatamente le richieste |195| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, ovvero 10 minuti; massimo: 2147483647). Aumentalo quando le richieste vanno in timeout su reti lente o quando instradi il traffico attraverso un proxy. I valori superiori al massimo causano l'overflow del timer sottostante e fanno fallire immediatamente le richieste |

196| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API di Amazon Bedrock per l'autenticazione (consulta [Chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |196| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API di Amazon Bedrock per l'autenticazione (vedi [Chiavi API di Amazon Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

197| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per un comando dello strumento Bash o PowerShell in primo piano, in millisecondi (predefinito: 120000, ovvero 2 minuti). Un valore predefinito superiore a 30 minuti diventa anche il [limite di tempo predefinito per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |197| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 120000, ovvero 2 minuti). Un valore superiore al [limite di tempo predefinito per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) sostituisce tale valore predefinito nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |

198| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri dell'output bash che Claude Code rilegge nel risultato di un comando (predefinito: 30000; massimo: 150000). Se imposti l'impostazione [`bashOutputMaxChars`](/docs/it/settings-reference#bashoutputmaxchars), Claude Code ignora questa variabile. Consulta [Limiti di output](/docs/it/tools-reference#output-limits) |198| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri dell'output di bash che Claude Code rilegge nel risultato di un comando (predefinito: 30000; massimo: 150000). Se imposti l'impostazione [`bashOutputMaxChars`](/docs/it/settings-reference#bashoutputmaxchars), Claude Code ignora questa variabile. Vedi [Limiti di output](/docs/it/tools-reference#output-limits) |

199| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per un comando dello strumento Bash o PowerShell in primo piano, in millisecondi (predefinito: 600000, ovvero 10 minuti). Il limite effettivo è il maggiore tra questo valore e `BASH_DEFAULT_TIMEOUT_MS`. Un limite effettivo superiore a 2 ore diventa anche il [limite di tempo massimo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |199| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per un comando in primo piano dello strumento Bash o PowerShell, in millisecondi (predefinito: 600000, ovvero 10 minuti). Il limite effettivo è il maggiore tra questo e `BASH_DEFAULT_TIMEOUT_MS`. Un limite effettivo superiore a 2 ore diventa anche il [limite di tempo massimo per i comandi in background](/docs/it/tools-reference#time-limit-for-background-commands) nelle sessioni non presidiate. Il limite di tempo in background richiede Claude Code v2.1.285 o successiva |

200| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP per il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, log e tracce vengono inviati lì invece che agli exporter configurati. Impostala nella shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |200| `BETA_TRACING_ENDPOINT` | Endpoint OTLP/HTTP per il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta): con `ENABLE_BETA_TRACING_DETAILED=1`, log e trace vengono inviati lì invece che agli exporter configurati. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

201| `CCR_FORCE_BUNDLE` | Imposta su `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a creare un bundle del tuo repository locale e caricarlo invece di clonarlo dal suo remote |201| `CCR_FORCE_BUNDLE` | Imposta su `1` per forzare [`claude --cloud`](/docs/it/claude-code-on-the-web#send-local-repositories-without-github) a creare un bundle del tuo repository locale e caricarlo invece di clonarlo dal suo remote |

202| `CLAUDECODE` | Impostata su `1` nei sottoprocessi avviati da Claude Code (strumenti Bash e PowerShell, sessioni tmux, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline), sottoprocessi dei [server MCP](/docs/it/mcp) stdio). Anche le estensioni IDE la impostano nei loro terminali integrati. Usala per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso avviato da Claude Code. Per verificare se il processo corrente è stato avviato direttamente da una chiamata a uno strumento o da un hook, anziché all'interno di un server MCP stdio avviato da Claude Code, usa invece `CLAUDE_CODE_CHILD_SESSION` |202| `CLAUDECODE` | Impostata su `1` nei sottoprocessi avviati da Claude Code (strumenti Bash e PowerShell, sessioni tmux, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline), sottoprocessi dei [server MCP](/docs/it/mcp) stdio). Anche le estensioni IDE la impostano nei loro terminali integrati. Usala per rilevare quando uno script è in esecuzione all'interno di un sottoprocesso avviato da Claude Code. Per verificare se il processo corrente è stato avviato direttamente da una chiamata a uno strumento o da un hook, anziché all'interno di un server MCP stdio avviato da Claude Code, usa invece `CLAUDE_CODE_CHILD_SESSION` |

203| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima della continuazione automatica compare il conto alla rovescia sullo schermo in una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout di continuazione automatica. Non ha effetto a meno che la continuazione automatica non sia attiva; consulta l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successiva |203| `CLAUDE_AFK_COUNTDOWN_MS` | Quanti millisecondi prima della continuazione automatica compare il conto alla rovescia sullo schermo in una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta. Predefinito `20000` (20 secondi), limitato al timeout della continuazione automatica. Non ha effetto a meno che la continuazione automatica non sia attiva; vedi l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout) e `CLAUDE_AFK_TIMEOUT_MS`. Richiede Claude Code v2.1.198 o successiva |

204| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta prosegua automaticamente senza di te. La continuazione automatica è disattivata per impostazione predefinita; attivala con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando è impostata, ha la precedenza su quell'impostazione e attiva la continuazione automatica anche quando l'impostazione non è definita o è `never`. Impostare `0` non disattiva il timeout; chiude immediatamente la finestra di dialogo. Nelle v2.1.198 e v2.1.199, la continuazione automatica era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successiva |204| `CLAUDE_AFK_TIMEOUT_MS` | Quanti millisecondi di inattività prima che una finestra di dialogo [`AskUserQuestion`](/docs/it/tools-reference) senza risposta prosegua automaticamente senza di te. La continuazione automatica è disattivata per impostazione predefinita; attivala con l'impostazione [`askUserQuestionTimeout`](/docs/it/settings-reference#askuserquestiontimeout). Questa variabile è un override per demo e test automatizzati: quando è impostata, ha la precedenza su tale impostazione e attiva la continuazione automatica anche quando l'impostazione non è definita o è `never`. Impostare `0` non disattiva il timeout; chiude immediatamente la finestra di dialogo. Nelle v2.1.198 e v2.1.199, la continuazione automatica era attiva per impostazione predefinita con un timeout di `60000` (60 secondi). Richiede Claude Code v2.1.198 o successiva |

205| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta su `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti dell'SDK che vogliono partire da zero. Rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata allo strumento Agent omette `subagent_type`. Una chiamata di questo tipo fallisce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |205| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta su `1` per disabilitare tutti i tipi di [subagent](/docs/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti dell'SDK che vogliono partire da zero. Questo rimuove anche `general-purpose`, il subagent che Claude Code esegue quando una chiamata allo strumento Agent omette `subagent_type`. Una chiamata di questo tipo fallisce quindi con [`subagent_type is required`](/docs/it/errors#subagent-type-is-required) |

206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta su `1` per omettere il prefisso `mcp__<server>__` dai nomi degli strumenti dei server MCP creati tramite SDK. Gli strumenti usano i loro nomi originali. Solo per l'uso con l'SDK |206| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta su `1` per omettere il prefisso `mcp__<server>__` dai nomi degli strumenti dei server MCP creati tramite SDK. Gli strumenti usano i loro nomi originali. Solo per l'uso dell'SDK |

207| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumenti `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog dello stream è attivo, il valore predefinito aumenta di conseguenza, come descritto in [Gestire risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Il timer si azzera a ogni evento di avanzamento dello streaming; se non arriva alcun avanzamento entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al processo padre |207| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent. Predefinito `600000` (10 minuti); se aumenti `CLAUDE_STREAM_IDLE_TIMEOUT_MS` mentre il watchdog dello stream è attivo, il valore predefinito aumenta di conseguenza, come descritto in [Gestire le risposte API lente o bloccate](/docs/it/agent-sdk/typescript#handle-slow-or-stalled-api-responses). Il timer si azzera a ogni evento di avanzamento dello streaming; se non arriva alcun avanzamento entro la finestra, Claude Code interrompe il subagent e segnala lo stallo al genitore |

208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica alla quale si attiva la compattazione automatica. Usa valori più bassi come `50` per compattare prima; la variabile non può alzare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo nelle sessioni che [compattano prima del limite di contesto del modello](/docs/it/model-config#context-window-and-auto-compaction). Si applica sia alle conversazioni principali sia ai subagent |208| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica alla quale si attiva la compattazione automatica. Usa valori più bassi come `50` per compattare prima; la variabile non può alzare la soglia, quindi i valori superiori alla percentuale predefinita vengono ignorati. Si applica solo nelle sessioni che [compattano prima del limite di contesto del modello](/docs/it/model-config#context-window-and-auto-compaction). Si applica sia alle conversazioni principali sia ai subagent |

209| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta su `1` per forzare l'attivazione dello spostamento automatico in background delle attività degli agenti a lunga esecuzione. Quando è attivo, i subagent vengono spostati in background dopo circa due minuti di esecuzione. Attiva anche lo [spostamento automatico in background delle chiamate lunghe agli strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successiva |209| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta su `1` per forzare l'abilitazione dello spostamento automatico in background delle attività degli agenti di lunga durata. Quando è abilitata, i subagent vengono spostati in background dopo circa due minuti di esecuzione. Abilita anche lo [spostamento automatico in background delle chiamate lunghe agli strumenti MCP](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) in modalità non interattiva su Claude Code v2.1.212 o successiva |

210| `CLAUDE_AX_PREPARK_MS` | In [modalità screen reader](/docs/it/accessibility), quanti millisecondi Claude Code attende prima di scrivere una riga nuova o modificata. Predefinito `0`, quindi Claude Code non attende. Prima della v2.1.287, il valore predefinito era `50`. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successiva |210| `CLAUDE_AX_PREPARK_MS` | In [modalità screen reader](/docs/it/accessibility), quanti millisecondi Claude Code attende prima di scrivere una riga nuova o modificata. Predefinito `0`, quindi Claude Code non attende. Prima della v2.1.287, il valore predefinito era `50`. Claude Code limita l'attesa a `5000`. Richiede Claude Code v2.1.233 o successiva |

211| `CLAUDE_AX_SCREEN_READER` | Imposta su `1` per generare un output adatto agli screen reader: testo semplice senza bordi decorativi né animazioni. Imposta su `0` per forzare la disattivazione della modalità screen reader anche quando [`axScreenReader`](/docs/it/settings-reference#axscreenreader) è `true`. Il flag [`--ax-screen-reader`](/docs/it/cli-reference#cli-flags) ha la precedenza. Richiede Claude Code v2.1.181 o successiva |211| `CLAUDE_AX_SCREEN_READER` | Imposta su `1` per visualizzare un output adatto agli screen reader: testo semplice senza bordi decorativi né animazioni. Imposta su `0` per forzare la disattivazione della modalità screen reader anche quando [`axScreenReader`](/docs/it/settings-reference#axscreenreader) è `true`. Il flag [`--ax-screen-reader`](/docs/it/cli-reference#cli-flags) ha la precedenza. Richiede Claude Code v2.1.181 o successiva |

212| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità screen reader](/docs/it/accessibility), per quanti millisecondi Claude Code trattiene il primo rendering dell'interfaccia dopo la riga di conferma dell'avvio, in modo che lo screen reader possa pronunciare la riga per intero prima che un nuovo output la interrompa. Predefinito `3000`. Imposta `0` per eseguire il rendering immediatamente. Claude Code limita l'attesa a `600000` (10 minuti). Il primo tasto che premi termina anticipatamente l'attesa. Richiede Claude Code v2.1.217 o successiva |212| `CLAUDE_AX_STARTUP_QUIET_MS` | In [modalità screen reader](/docs/it/accessibility), per quanti millisecondi Claude Code trattiene il primo rendering dell'interfaccia dopo la riga di conferma dell'avvio, in modo che lo screen reader possa leggere la riga per intero prima che un nuovo output la interrompa. Predefinito `3000`. Imposta `0` per eseguire il rendering immediatamente. Claude Code limita l'attesa a `600000` (10 minuti). La prima pressione di un tasto termina l'attesa in anticipo. Richiede Claude Code v2.1.217 o successiva |

213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Torna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |213| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Torna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |

214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi per il watchdog di inattività dello streaming a livello di byte; quando è impostata, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia invariato il watchdog a livello di evento. Claude Code limita questa variabile a un valore compreso tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successiva |214| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi per il watchdog di inattività dello streaming a livello di byte; quando è impostata, ha la precedenza su `CLAUDE_STREAM_IDLE_TIMEOUT_MS` per quel watchdog e lascia invariato il watchdog a livello di eventi. Claude Code limita questa variabile a un valore compreso tra 10 secondi e 30 minuti. Richiede Claude Code v2.1.210 o successiva |

215| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso di un file che uno strumento esterno, come un listener del blocco schermo, crea quando sblocchi lo schermo ed elimina quando lo blocchi. Finché il file esiste, Claude Code salta le [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), così smetti di ricevere notifiche push mentre usi attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per ogni evento che attiva una notifica push anziché interrogarlo periodicamente. Richiede Claude Code v2.1.181 o successiva |215| `CLAUDE_CLIENT_PRESENCE_FILE` | Percorso di un file che uno strumento esterno, come un listener del blocco schermo, crea quando sblocchi lo schermo ed elimina quando lo blocchi. Finché il file esiste, Claude Code salta le [notifiche push mobili di Remote Control](/docs/it/remote-control#mobile-push-notifications), così smetti di ricevere notifiche push mentre usi attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per ogni evento che attiva una notifica push anziché interrogarlo periodicamente. Richiede Claude Code v2.1.181 o successiva |

216| `CLAUDE_CODE_ACCESSIBILITY` | Imposta su `1` per mantenere visibile il cursore nativo del terminale e disabilitare l'indicatore del cursore a testo invertito. Consente agli ingranditori dello schermo come Zoom di macOS di seguire la posizione del cursore |216| `CLAUDE_CODE_ACCESSIBILITY` | Imposta su `1` per mantenere visibile il cursore nativo del terminale e disabilitare l'indicatore del cursore a testo invertito. Consente alle lenti di ingrandimento dello schermo come Zoom di macOS di seguire la posizione del cursore |

217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |217| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |

218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta su `1` per ridisegnare l'intero schermo a ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) invece di inviare aggiornamenti incrementali. Usala se la modalità a schermo intero mostra frammenti di testo obsoleti o fuori posto. Claude Code la attiva automaticamente per le sessioni in background e per la [vista agenti](/docs/it/agent-view) su Windows |218| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta su `1` per ridisegnare l'intero schermo a ogni frame nel [rendering a schermo intero](/docs/it/fullscreen) invece di inviare aggiornamenti incrementali. Usala se la modalità a schermo intero mostra frammenti di testo obsoleti o fuori posto. Claude Code la abilita automaticamente per le sessioni in background e per la [vista agenti](/docs/it/agent-view) su Windows |

219| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta su `1` per inviare il parametro [effort](/docs/it/model-config#adjust-effort-level) con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come compatibile con effort. Usala quando instradi il traffico tramite un [gateway LLM](/docs/it/llm-gateway) o un provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort a livello di API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, restano comunque esclusi, così le richieste non falliscono |219| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta su `1` per inviare il parametro [effort](/docs/it/model-config#adjust-effort-level) con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come compatibile con effort. Usala quando instradi il traffico attraverso un [gateway LLM](/docs/it/llm-gateway) o un provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort a livello di API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, restano comunque esclusi, così le richieste non falliscono |

220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi con cui le credenziali devono essere aggiornate (quando usi [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper)) |220| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi con cui aggiornare le credenziali (quando usi [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper)) |

221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Imposta su `0` per impedire a Claude Code di aprire automaticamente il browser quando viene pubblicato un nuovo [artefatto](/docs/it/artifacts#create-an-artifact) |221| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Imposta su `0` per impedire a Claude Code di aprire automaticamente il browser quando viene pubblicato un nuovo [artefatto](/docs/it/artifacts#create-an-artifact) |

222| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Imposta su `0` per impedire a Claude di leggere e rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact). Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha [disattivato gli artefatti](/docs/it/artifacts#availability). Richiede Claude Code v2.1.221 o successiva |222| `CLAUDE_CODE_ARTIFACT_COMMENTS` | Imposta su `0` per impedire a Claude di leggere e rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact). Non ha effetto quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` ha [disattivato gli artefatti](/docs/it/artifacts#availability). Richiede Claude Code v2.1.221 o successiva |

223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Imposta su `0` per impedire a Claude di [rispondere autonomamente ai commenti che gli vengono inviati](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successiva |223| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Imposta su `0` per impedire a Claude di [rispondere autonomamente ai commenti che gli vengono inviati](/docs/it/artifacts#let-claude-reply-to-comments-on-its-own). Richiede Claude Code v2.1.228 o successiva |

224| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta su `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che contiene la versione del client e un'impronta del prompt, dall'inizio del prompt di sistema. La cache su una connessione diretta all'API Anthropic non è influenzata in nessun caso. In alcune configurazioni con connessione diretta, Claude Code mantiene il blocco nelle richieste al classificatore della [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando imposti `0`. In [Blocco di attribuzione del prompt di sistema](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), verifica quali connessioni e credenziali sono coperte. Prima della v2.1.181 il blocco includeva un token per richiesta sugli URL di base personalizzati e sulle connessioni Microsoft Foundry, quindi su quelle versioni impostala su `0` quando il tuo gateway LLM memorizza nella cache in base al corpo della richiesta o inoltra le richieste a un provider di terze parti, oppure quando ti connetti direttamente a Microsoft Foundry |224| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta su `0` per omettere il [blocco di attribuzione](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), che contiene la versione del client e un'impronta del prompt, dall'inizio del prompt di sistema. La cache su una connessione diretta all'API Anthropic non è influenzata in nessun caso. In alcune configurazioni con connessione diretta, Claude Code mantiene il blocco nelle richieste al classificatore della [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) anche quando imposti `0`. In [Blocco di attribuzione del prompt di sistema](/docs/it/llm-gateway-protocol#system-prompt-attribution-block), verifica quali connessioni e credenziali sono interessate. Prima della v2.1.181 il blocco includeva un token per richiesta sugli URL di base personalizzati e sulle connessioni Microsoft Foundry, quindi in quelle versioni impostala su `0` quando il tuo gateway LLM memorizza nella cache in base al corpo della richiesta o inoltra le richieste a un provider di terze parti, oppure quando ti connetti direttamente a Microsoft Foundry |

225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Rimossa nella v2.1.283. Usa invece `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |225| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | Rimossa nella v2.1.283. Usa invece `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` |

226| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta solo un intero semplice come `500000`: un valore come `500k` viene letto come `500` e portato al minimo di 100K. La finestra effettiva è inoltre limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, sul flag `--autocompact` e sull'impostazione `autoCompactWindow`. Il campo `used_percentage` della riga di stato viene sempre misurato rispetto all'intera finestra di contesto del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |226| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) in token, da `100000` a `1000000`. Accetta solo un intero semplice come `500000`: un valore come `500k` viene letto come `500` e portato al minimo di 100K. La finestra effettiva è inoltre limitata alla finestra di contesto del modello. Ha la precedenza sul comando `/autocompact`, sul flag `--autocompact` e sull'impostazione `autoCompactWindow`. Il valore `used_percentage` della riga di stato viene sempre misurato rispetto all'intera finestra di contesto del modello, quindi una volta impostata questa variabile, quella percentuale non indica più quando verrà eseguita la compattazione |

227| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrive la [connessione automatica all'IDE](/docs/it/vs-code). Per impostazione predefinita, Claude Code si connette automaticamente quando viene avviato nel terminale integrato di un IDE supportato. Imposta su `false` per impedirlo. Imposta su `true` per forzare un tentativo di connessione quando il rilevamento automatico non riesce, ad esempio quando tmux nasconde il terminale padre. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |227| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrive la [connessione IDE](/docs/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando viene avviato all'interno del terminale integrato di un IDE supportato. Imposta su `false` per impedirlo. Imposta su `true` per forzare un tentativo di connessione quando il rilevamento automatico fallisce, ad esempio quando tmux nasconde il terminale padre. Ha la precedenza sull'impostazione di configurazione globale [`autoConnectIde`](/docs/it/settings-reference#autoconnectide) |

228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controlla se Claude Code chiede al server di [esaminare le azioni della modalità auto](/docs/it/permission-modes#server-side-classifier-review). Imposta su `0` per usare invece le richieste al classificatore di Claude Code stesso. Su una connessione diretta all'API Anthropic, richiede la v2.1.281 o successiva. La sezione collegata elenca quali sessioni interpellano il server quando la variabile non è impostata, e da quale versione. Richiede Claude Code v2.1.271 o successiva |228| `CLAUDE_CODE_AUTO_MODE_SERVER` | Controlla se Claude Code chiede al server di [esaminare le azioni della modalità auto](/docs/it/permission-modes#server-side-classifier-review). Imposta su `0` per usare invece le richieste al classificatore di Claude Code stesso. Su una connessione diretta all'API Anthropic, richiede la v2.1.281 o successiva. La sezione collegata elenca quali sessioni chiedono al server quando la variabile non è impostata, e da quale versione. Richiede Claude Code v2.1.271 o successiva |

229| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code attende affinché la catena predefinita di provider di credenziali AWS produca le credenziali prima che la richiesta fallisca con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out) (predefinito: `60000`). Aumentalo quando un passaggio della tua catena richiede legittimamente più tempo, ad esempio un accesso SSO basato su browser con MFA tramite un wrapper come `aws-vault`. Si applica su Amazon Bedrock, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e sull'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Consulta [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |229| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Tempo in millisecondi che Claude Code attende affinché la catena predefinita dei provider di credenziali AWS produca le credenziali prima che la richiesta fallisca con [`AWS default-chain credential resolve timed out`](/docs/it/errors#aws-default-chain-credential-resolve-timed-out) (predefinito: `60000`). Aumentalo quando un passaggio della tua catena richiede legittimamente più tempo, come un accesso SSO basato su browser con MFA tramite un wrapper come `aws-vault`. Si applica su Amazon Bedrock, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e sull'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint). Vedi [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |

230| `CLAUDE_CODE_BASH_EDIT_DIFF` | Imposta su `0` per disattivare il [diff dei file modificati durante l'esecuzione di un comando Bash](/docs/it/hooks#bash), oppure su `1` per registrarlo in ogni modalità di permesso. Ha la precedenza sull'impostazione [`bashEditDiffEnabled`](/docs/it/settings-reference#basheditdiffenabled). Richiede Claude Code v2.1.269 o successiva |230| `CLAUDE_CODE_BASH_EDIT_DIFF` | Imposta su `0` per disattivare il [diff dei file modificati durante l'esecuzione di un comando Bash](/docs/it/hooks#bash), oppure su `1` per registrarlo in ogni modalità di permesso. Ha la precedenza sull'impostazione [`bashEditDiffEnabled`](/docs/it/settings-reference#basheditdiffenabled). Richiede Claude Code v2.1.269 o successiva |

231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Imposta su `0` per fare in modo che una sessione non interattiva segnali uno stato inattivo al proprio host alla fine di ogni turno, anche mentre il lavoro in background è ancora in esecuzione. Per impostazione predefinita, la sessione continua a segnalare uno stato di esecuzione oltre la fine del turno mentre il lavoro in background, come un agente in background o un'esecuzione di un [workflow](/docs/it/workflows), è ancora attivo. Questo impedisce a un host che monitora lo stato, come un elenco di sessioni remote, di annunciare che Claude è in attesa del tuo input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato di esecuzione. Il comportamento predefinito dello stato di esecuzione e la disattivazione con `0` richiedono Claude Code v2.1.269 o successiva; nelle versioni precedenti, imposta `1` per mantenere lo stato di esecuzione |231| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | Imposta su `0` per fare in modo che una sessione non interattiva segnali al suo host uno stato inattivo alla fine di ogni turno, anche mentre il lavoro in background è ancora in esecuzione. Per impostazione predefinita, la sessione continua a segnalare uno stato in esecuzione oltre la fine del turno mentre il lavoro in background, come un agente in background o un'esecuzione di un [workflow](/docs/it/workflows), è ancora attivo. Questo impedisce a un host che monitora lo stato, come un elenco di sessioni remote, di annunciare che Claude è in attesa del tuo input a metà lavoro. I comandi shell in background, come un server di sviluppo, non mantengono lo stato in esecuzione. Il comportamento predefinito dello stato in esecuzione e la disattivazione con `0` richiedono Claude Code v2.1.269 o successiva; nelle versioni precedenti, imposta `1` per mantenere lo stato in esecuzione |

232| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostata automaticamente nei sottoprocessi dello strumento Bash e dei [comandi hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimossa al termine della connessione. Il valore è l'ID della sessione nel formato `session_`, lo stesso identificatore che compare nell'URL `claude.ai/code` della sessione, così uno script può rimandare alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successiva. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggi invece `CLAUDE_CODE_REMOTE_SESSION_ID` |232| `CLAUDE_CODE_BRIDGE_SESSION_ID` | Impostata automaticamente nei sottoprocessi dello strumento Bash e dei [comandi hook](/docs/it/hooks) mentre la sessione ha una connessione [Remote Control](/docs/it/remote-control) attiva, e rimossa quando la connessione termina. Il valore è l'ID della sessione nel formato `session_`, lo stesso identificatore che compare nell'URL `claude.ai/code` della sessione, così uno script può rimandare alla sessione che lo ha eseguito. Richiede Claude Code v2.1.199 o successiva. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), leggi invece `CLAUDE_CODE_REMOTE_SESSION_ID` |

233| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Imposta su `0` per fare in modo che Claude Code legga il byte `0x08`, scritto anche `^H`, come Backspace semplice, oppure su `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il comportamento predefinito della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come Backspace semplice su macOS e Linux. Imposta `0` in un terminale Windows in cui [Backspace elimina un'intera parola](/docs/it/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |233| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Imposta su `0` per fare in modo che Claude Code legga il byte `0x08`, scritto anche `^H`, come semplice Backspace, oppure su `1` per leggerlo come Ctrl+Backspace. Entrambi i valori sostituiscono il comportamento predefinito della piattaforma. Per impostazione predefinita, Claude Code lo legge come Ctrl+Backspace su Windows, tranne quando `TERM_PROGRAM` è `mintty` o `TERM` è `cygwin`, e come semplice Backspace su macOS e Linux. Imposta `0` in un terminale Windows in cui [Backspace elimina un'intera parola](/docs/it/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) |

234| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole delle origini dei certificati CA per le connessioni TLS. `bundled` è il set di CA di Mozilla fornito con Claude Code. `system` è l'archivio attendibile del sistema operativo, letto solo sui runtime con `tls.getCACertificates`: il binario nativo, oppure Node 22.15 o successivo per le installazioni npm. Consulta [Archivio dei certificati CA](/docs/it/network-config#ca-certificate-store). Il valore predefinito è `bundled,system` |234| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole di origini dei certificati CA per le connessioni TLS. `bundled` è il set di CA di Mozilla fornito con Claude Code. `system` è l'archivio attendibile del sistema operativo, letto solo sui runtime con `tls.getCACertificates`: il binario nativo, oppure Node 22.15 o successivo per le installazioni npm. Vedi [Archivio dei certificati CA](/docs/it/network-config#ca-certificate-store). Il valore predefinito è `bundled,system` |

235| `CLAUDE_CODE_CHILD_SESSION` | Impostata su `1` nei sottoprocessi che Claude Code avvia tramite gli strumenti Bash, PowerShell e Monitor, i comandi degli [hook](/docs/it/hooks) e i comandi della [riga di stato](/docs/it/statusline). Non è impostata per i sottoprocessi dei [server MCP](/docs/it/mcp) stdio, che sono di lunga durata e sopravvivono alla sessione che li ha avviati. A differenza di `CLAUDECODE`, viene impostata solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione annidata da un `claude` di primo livello avviato in un terminale integrato nell'IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene esclusa automaticamente da `--resume`, `--continue`, dalla cronologia con freccia su e dall'elenco `claude agents`. Le sessioni non interattive `claude -p` vengono comunque mantenute. Imposta `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per sovrascrivere questa esclusione. Richiede Claude Code v2.1.172 o successiva |235| `CLAUDE_CODE_CHILD_SESSION` | Impostata su `1` nei sottoprocessi che Claude Code avvia tramite gli strumenti Bash, PowerShell e Monitor, i comandi degli [hook](/docs/it/hooks) e i comandi della [riga di stato](/docs/it/statusline). Non è impostata per i sottoprocessi dei [server MCP](/docs/it/mcp) stdio, che sono di lunga durata e sopravvivono alla sessione che li ha avviati. A differenza di `CLAUDECODE`, viene impostata solo da Claude Code stesso quando avvia un sottoprocesso e non dalle estensioni IDE, quindi distingue in modo affidabile una sessione annidata da un `claude` di primo livello avviato in un terminale integrato nell'IDE. Una TUI `claude` interattiva annidata avviata in questo modo viene esclusa automaticamente da `--resume`, `--continue`, dalla cronologia con freccia su e dall'elenco `claude agents`. Le sessioni non interattive `claude -p` vengono comunque salvate. Imposta `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` per annullare questa esclusione. Richiede Claude Code v2.1.172 o successiva |

236| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |236| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |

237| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata del client per l'autenticazione mTLS |237| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata client per l'autenticazione mTLS |

238| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per la CLAUDE\_CODE\_CLIENT\_KEY crittografata (facoltativa) |238| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per la CLAUDE\_CODE\_CLIENT\_KEY crittografata (facoltativa) |

239| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimossa nella v2.1.186 e ora senza effetto. In precedenza impostava un timeout separato per la fase di connessione, TLS e header di risposta di una richiesta API in streaming. Usa `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase degli header di risposta di una richiesta in streaming, consulta `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |239| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | Rimossa nella v2.1.186 e ora senza effetto. In precedenza impostava un timeout separato per la fase di connessione, TLS e header di risposta di una richiesta API in streaming. Usa `API_TIMEOUT_MS` per il timeout per richiesta. Per la fase degli header di risposta di una richiesta in streaming, vedi `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` |

240| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrive il percorso del file di log di debug. Nonostante il nome, si tratta di un percorso di file, non di una directory. Richiede che la modalità di debug sia abilitata separatamente tramite `--debug`, `/debug` o la variabile d'ambiente `DEBUG`: impostare solo questa variabile non abilita il logging. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambe le cose contemporaneamente. Il valore predefinito è `~/.claude/debug/<session-id>.txt` |240| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrive il percorso del file di log di debug. Nonostante il nome, si tratta di un percorso di file, non di una directory. Richiede che la modalità di debug sia abilitata separatamente tramite `--debug`, `/debug` o la variabile d'ambiente `DEBUG`: impostare solo questa variabile non abilita il logging. Il flag [`--debug-file`](/docs/it/cli-reference#cli-flags) fa entrambe le cose contemporaneamente. Il valore predefinito è `~/.claude/debug/<session-id>.txt` |

241| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello minimo di log scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della riga di stato, oppure alza a `error` per ridurre il rumore |241| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della riga di stato, oppure alza a `error` per ridurre il rumore |

242| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta su `1` per disabilitare il supporto della [finestra di contesto da 1M](/docs/it/model-config#extended-context). Quando è impostata, le varianti dei modelli da 1M non sono disponibili nel selettore dei modelli e Claude Code limita le sessioni sui modelli con una finestra nativa da 1M, come [Sonnet 5.5](/docs/it/model-config#sonnet-5-5-and-sonnet-5-context-window) e i modelli Fable, a una finestra da 200K; consulta [Contesto esteso](/docs/it/model-config#extended-context) per sapere come viene applicato questo limite. Utile per ambienti enterprise con requisiti di conformità. Per il suo ruolo nella correzione della finestra per un ID modello `[1m]` non riconosciuto, consulta [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |242| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta su `1` per disattivare il supporto della [finestra di contesto da 1M](/docs/it/model-config#extended-context). Claude Code rimuove le varianti di modello `[1m]` dal selettore dei modelli e limita a una finestra da 200K i modelli che per impostazione predefinita funzionano con la finestra da 1M. Vedi [Disattivare il contesto da 1M](/docs/it/model-config#turn-off-1m-context). Utile per ambienti aziendali con requisiti di conformità. Per il suo ruolo nella correzione della finestra per un ID di modello `[1m]` non riconosciuto, vedi [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |

243| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta su `1` per disabilitare il [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e ripiegare sul budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui [modelli Fable](/docs/it/model-config#extended-thinking), su Sonnet 5 e successivi, su Haiku 5.5 o su Opus 4.7 e successivi, che usano sempre il ragionamento adattivo |243| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta su `1` per disabilitare il [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e ripiegare sul budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Non ha effetto sui [modelli Fable](/docs/it/model-config#extended-thinking), su Sonnet 5 e successivi, su Haiku 5.5 o su Opus 4.7 e successivi, che usano sempre il ragionamento adattivo |

244| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Imposta su `1` per impedire a Claude Code di unire chiave per chiave i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) tra le origini di amministrazione, in modo che si applichi solo l'intero blocco `env` dell'origine con la priorità più alta, come prima della v2.1.223. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successiva |244| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Imposta su `1` per impedire a Claude Code di unire per chiave i blocchi `env` delle [impostazioni gestite](/docs/it/managed-settings#precedence-within-the-managed-tier) tra le origini di amministrazione, così si applica solo l'intero blocco `env` dell'origine con la priorità più alta, come prima della v2.1.223. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.223 o successiva |

245| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Imposta su `1` per disabilitare lo [strumento advisor](/docs/it/advisor). Il comando `/advisor` diventa non disponibile, qualsiasi `advisorModel` configurato viene ignorato e il flag `--advisor` viene accettato ma non ha effetto, così gli script esistenti che lo passano continuano a funzionare senza errori |245| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | Imposta su `1` per disabilitare lo [strumento advisor](/docs/it/advisor). Il comando `/advisor` diventa non disponibile, qualsiasi `advisorModel` configurato viene ignorato e il flag `--advisor` viene accettato ma non ha effetto, così gli script esistenti che lo passano continuano a funzionare senza errori |

246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta su `1` per disattivare [gli agenti in background e la vista agenti](/docs/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore on-demand. Equivalente all'impostazione [`disableAgentView`](/docs/it/settings-reference#disableagentview) |246| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta su `1` per disattivare gli [agenti in background e la vista agenti](/docs/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore on demand. Equivalente all'impostazione [`disableAgentView`](/docs/it/settings-reference#disableagentview) |

247| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e usare il renderer classico sullo schermo principale. La conversazione resta nello scrollback nativo del terminale, così `Cmd+f` e la modalità copia di tmux funzionano normalmente. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/docs/it/settings-reference#tui). Puoi anche cambiare modalità con `/tui default`. Non si applica alle sessioni in background aperte dalla [vista agenti](/docs/it/agent-view), che usano sempre il rendering a schermo intero |247| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/docs/it/fullscreen) e usare il renderer classico della schermata principale. La conversazione rimane nello scrollback nativo del terminale, così `Cmd+f` e la modalità copia di tmux funzionano come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/docs/it/settings-reference#tui). Puoi anche passare con `/tui default`. Non si applica alle sessioni in background aperte dalla [vista agenti](/docs/it/agent-view), che usano sempre il rendering a schermo intero |

248| `CLAUDE_CODE_DISABLE_ARTIFACT` | Imposta su `1` per disattivare lo strumento [Artifact](/docs/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostata, nessun file di impostazioni riattiva lo strumento. Per disattivare invece lo strumento da un file di impostazioni, imposta [`enableArtifact`](/docs/it/settings-reference#enableartifact) su `false`; anche la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva |248| `CLAUDE_CODE_DISABLE_ARTIFACT` | Imposta su `1` per disattivare lo strumento [Artifact](/docs/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Una volta impostata, nessun file di impostazioni riattiva lo strumento. Per disattivare invece lo strumento da un file di impostazioni, imposta [`enableArtifact`](/docs/it/settings-reference#enableartifact) su `false`; anche la chiave deprecata [`disableArtifact`](/docs/it/settings-reference#disableartifact) lo disattiva |

249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file |249| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file |

250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Imposta su `1` per fare in modo che un processo Claude Code esegua da sé il proprio comando [`gcpAuthRefresh`](/docs/it/settings-reference#gcpauthrefresh) o [`awsAuthRefresh`](/docs/it/settings-reference#awsauthrefresh) invece di attendere mentre un altro processo lo esegue. Richiede Claude Code v2.1.286 o successiva |250| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | Imposta su `1` per fare in modo che un processo Claude Code esegua da sé il comando [`gcpAuthRefresh`](/docs/it/settings-reference#gcpauthrefresh) o [`awsAuthRefresh`](/docs/it/settings-reference#awsauthrefresh) invece di attendere mentre lo esegue un altro processo. Richiede Claude Code v2.1.286 o successiva |

251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta su `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Imposta su `0` per forzare l'attivazione della memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero. Quando è disabilitata, Claude non crea né carica file di memoria automatica |251| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta su `1` per disabilitare la [memoria automatica](/docs/it/memory#auto-memory). Imposta su `0` per forzare l'attivazione della memoria automatica anche quando la modalità `--bare` o [`autoMemoryEnabled: false`](/docs/it/settings-reference#automemoryenabled) la disabiliterebbero. Quando è disabilitata, Claude non crea né carica file di memoria automatica |

252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disabilitare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` negli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |252| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disabilitare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` degli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |

253| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come il flusso di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia rimosso l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge quindi il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o successiva |253| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come lo stream di eventi binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia rimosso l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge quindi il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o successiva |

254| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta su `1` per saltare il controllo che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway per inoltrare l'header `Content-Type` e il corpo senza modifiche invece di impostare questa variabile. Richiede Claude Code v2.1.208 o successiva |254| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta su `1` per saltare il controllo che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway per inoltrare l'header `Content-Type` e il corpo senza modifiche anziché impostare questa variabile. Richiede Claude Code v2.1.208 o successiva |

255| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta su `1` per arrestare i comandi shell in background in esecuzione, i workflow dinamici e, dalla v2.1.198, i subagent in background di una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Influisce solo su quel passaggio: spostare una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva |255| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta su `1` per arrestare i comandi shell in background in esecuzione, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background di una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Influisce solo su quel passaggio: mettere una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva |

256| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) in condizioni di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o successiva |256| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è inattiva da 30 minuti senza alcun turno o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi questa variabile non ha effetto lì. Richiede Claude Code v2.1.193 o successiva |

257| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disabilitare le [skill](/docs/it/skills) e i workflow inclusi in Claude Code: le skill incluse e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma vengono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; per nasconderlo usa invece `DISABLE_DOCTOR_COMMAND`. Le skill provenienti da plugin, `.claude/skills/` e `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |257| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disabilitare le [skill](/docs/it/skills) e i workflow inclusi con Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma vengono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill dei plugin, di `.claude/skills/` e di `.claude/commands/` non sono interessate. Equivalente all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |

258| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta su `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Pensata per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o successiva |258| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta su `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o successiva |

259| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria utente, di progetto e automatica |259| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento nel contesto di qualsiasi file di memoria CLAUDE.md, inclusi i file di memoria utente, di progetto e di memoria automatica |

260| `CLAUDE_CODE_DISABLE_CRON` | Imposta su `1` per disabilitare le [attività pianificate](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione |260| `CLAUDE_CODE_DISABLE_CRON` | Imposta su `1` per disabilitare le [attività pianificate](/docs/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse quelle già in esecuzione a metà sessione |

261| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta su `1` per disattivare il limite di tempo sulle richieste di conferma per la [rimozione di percorsi critici](/docs/it/permission-modes#critical-paths). In modalità `auto` Claude Code invia invece queste rimozioni al classificatore, e in modalità `bypassPermissions` la richiesta attende la tua risposta. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |261| `CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT` | Imposta su `1` per disattivare il limite di tempo sulle richieste di conferma per la [rimozione di percorsi critici](/docs/it/permission-modes#critical-paths). In modalità `auto` Claude Code invia invece queste rimozioni al classificatore, e in modalità `bypassPermissions` la richiesta attende la tua risposta. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |

262| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere dalle richieste API gli header di richiesta `anthropic-beta` in pre-release, i campi del corpo associati e i campi beta dello schema degli strumenti come `defer_loading` e `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l'header `anthropic-beta` o con un errore `Extra inputs are not permitted`. [Disabilitare le funzionalità in pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) elenca cosa rimuove la variabile, incluso [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search), e cosa Claude Code continua a inviare |262| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere dalle richieste API gli header di richiesta `anthropic-beta` pre-release, i campi del corpo associati e i campi beta dello schema degli strumenti come `defer_loading` ed `eager_input_streaming`. Usala quando un gateway proxy rifiuta le richieste con un errore `Unexpected value(s)` per l'header `anthropic-beta` o con un errore `Extra inputs are not permitted`. [Disabilitare le funzionalità pre-release](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) elenca cosa rimuove la variabile, incluso [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search), e cosa Claude Code continua a inviare |

263| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta su `1` per disabilitare i [subagent Explore e Plan](/docs/it/sub-agents#built-in-subagents) integrati. Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente anziché avviare gli agenti Explore e Plan. I subagent personalizzati chiamati `Explore` o `Plan` non sono interessati. Per rimuovere tutti i tipi di subagent integrati nell'Agent SDK o in modalità non interattiva, usa invece `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successiva |263| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | Imposta su `1` per disabilitare i [subagent integrati Explore e Plan](/docs/it/sub-agents#built-in-subagents). Claude esplora invece con i suoi strumenti di ricerca o con il subagent general-purpose, e il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) legge i file direttamente anziché avviare gli agenti Explore e Plan. I subagent personalizzati denominati `Explore` o `Plan` non sono interessati. Per rimuovere ogni tipo di subagent integrato nell'Agent SDK o in modalità non interattiva, usa invece `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`. Richiede Claude Code v2.1.198 o successiva |

264| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disabilitare la [modalità veloce](/docs/it/fast-mode) |264| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disabilitare la [modalità veloce](/docs/it/fast-mode) |

265| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi sono disabilitati anche quando è impostata `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non li riattivi. Per impostare una frequenza di campionamento invece di disabilitarli del tutto, usa l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Consulta [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |265| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione "How is Claude doing?". I sondaggi vengono disabilitati anche quando è impostata `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non li riattivi. Per impostare una frequenza di campionamento anziché disabilitarli del tutto, usa l'impostazione [`feedbackSurveyRate`](/docs/it/settings-reference#feedbacksurveyrate). Vedi [Sondaggi sulla qualità della sessione](/docs/it/data-usage#session-quality-surveys) |

266| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disabilitare il [checkpointing](/docs/it/checkpointing) dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](/docs/it/settings-reference#filecheckpointingenabled) |266| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disabilitare il [checkpointing](/docs/it/checkpointing) dei file. Il comando `/rewind` non potrà ripristinare le modifiche al codice. Sovrascrive l'impostazione [`fileCheckpointingEnabled`](/docs/it/settings-reference#filecheckpointingenabled) |

267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta su `1` per rimuovere dal contesto di Claude le istruzioni integrate sul workflow di commit e PR e lo snapshot dello stato git. Utile quando usi le tue skill per il workflow git. Quando è impostata, ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) |267| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta su `1` per rimuovere dal contesto di Claude le istruzioni integrate sui workflow di commit e PR e lo snapshot dello stato git. Utile quando usi le tue skill per i workflow git. Quando è impostata, ha la precedenza sull'impostazione [`includeGitInstructions`](/docs/it/settings-reference#includegitinstructions) |

268| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Imposta su `1` per impedire a Claude Code di esaminare gli script passati a una shell con `-c`, come `bash -c 'rm -rf ~'`, alla ricerca di rimozioni di [percorsi critici](/docs/it/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code controlla comunque le destinazioni date da variabili di shell e parametri posizionali in quegli script, e gli altri controlli sui percorsi critici continuano a essere eseguiti. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.288 o successiva |268| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | Imposta su `1` per impedire a Claude Code di leggere gli script passati a una shell con `-c`, come `bash -c 'rm -rf ~'`, alla ricerca di rimozioni di [percorsi critici](/docs/it/permission-modes#removals-inside-nested-commands-and-inline-scripts). Claude Code controlla comunque le destinazioni costituite da variabili di shell e parametri posizionali in quegli script, e gli altri controlli sui percorsi critici continuano a essere eseguiti. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.288 o successiva |

269| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta su `1` per impedire la rimappatura automatica di Opus 4.0 e 4.1 alla versione attuale di Opus sull'API Anthropic. Usala quando vuoi intenzionalmente fissare un modello più vecchio. La rimappatura non viene eseguita su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry |269| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta su `1` per impedire la rimappatura automatica di Opus 4.0 e 4.1 alla versione attuale di Opus sull'API Anthropic. Usala quando vuoi intenzionalmente fissare un modello più vecchio. La rimappatura non viene eseguita su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry |

270| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Imposta su `1` per impedire a Claude Code su [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) di passare a un modello più vecchio quando il tuo account perde l'accesso al modello di una sessione durante la sessione stessa; la richiesta rifiutata fallisce invece immediatamente. Una [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) che configuri effettua comunque il passaggio in caso di rifiuto, e i [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) usano comunque un fallback al momento dell'avvio. Richiede Claude Code v2.1.285 o successiva |270| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | Imposta su `1` per impedire a Claude Code su [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) di passare a un modello più vecchio quando il tuo account perde l'accesso al modello di una sessione a metà sessione; la richiesta rifiutata fallisce invece subito. Una [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) che configuri cambia comunque modello in caso di quel rifiuto, e i [controlli del modello all'avvio](/docs/it/amazon-bedrock#startup-model-checks) ripiegano comunque su un fallback all'avvio. Richiede Claude Code v2.1.285 o successiva |

271| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Usala per mantenere il comportamento nativo del terminale di copia alla selezione |271| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/docs/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` continua a funzionare. Usala per mantenere il comportamento nativo di copia alla selezione del terminale |

272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Imposta su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento con la rotellina del mouse. Usala quando vuoi che lo scorrimento con la rotellina funzioni in Claude Code ma non vuoi che i clic posizionino il cursore, espandano l'output degli strumenti o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando sono impostate entrambe. Richiede Claude Code v2.1.195 o successiva |272| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | Imposta su `1` per disabilitare la gestione di clic, trascinamento e passaggio del mouse nel [rendering a schermo intero](/docs/it/fullscreen) mantenendo lo scorrimento con la rotellina del mouse. Usala quando vuoi che lo scorrimento con la rotellina funzioni all'interno di Claude Code ma non vuoi che i clic posizionino il cursore, espandano l'output degli strumenti o aprano i link. `CLAUDE_CODE_DISABLE_MOUSE` ha la precedenza quando sono impostate entrambe. Richiede Claude Code v2.1.195 o successiva |

273| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Imposta su `1` per impedire a Claude Code di rileggere il [certificato client e la chiave mTLS](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un reset della connessione o un errore dell'handshake TLS. Con la ricarica disabilitata, Claude Code carica i file ruotati solo alla successiva applicazione delle impostazioni o al successivo avvio. Richiede Claude Code v2.1.232 o successiva |273| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | Imposta su `1` per impedire a Claude Code di rileggere il [certificato client e la chiave mTLS](/docs/it/network-config#mtls-authentication) quando una richiesta API fallisce con un errore a livello di connessione, come un reset della connessione o un errore dell'handshake TLS. Con il ricaricamento disabilitato, Claude Code carica i file ruotati solo la prossima volta che applica le impostazioni o al prossimo avvio. Richiede Claude Code v2.1.232 o successiva |

274| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Imposta su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: aggiornamenti automatici, telemetria, segnalazione degli errori, il comando `/feedback`, il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), le note di rilascio, i controlli del [badge di stato di PR e MR](/docs/it/interactive-mode#pr-review-status) e i controlli di disponibilità come quello della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle origini `command` dei plugin](/docs/it/plugins/loading#when-a-command-source-re-runs), che sono comandi locali anziché traffico di rete, perché possono attivare l'installazione di dipendenze. **Impostarla su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per consentirlo di nuovo. Disabilita anche il recupero dei feature flag, il che rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). L'installazione automatica del marketplace ufficiale dei plugin non è inclusa; disabilitala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sul [rilevamento dei modelli del gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha una propria attivazione esplicita |274| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Imposta su qualsiasi valore non vuoto, come `1`, per disabilitare il traffico di rete non essenziale: aggiornamenti automatici, telemetria, segnalazione degli errori, il comando `/feedback`, il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), le note di rilascio, i controlli del [badge di stato di PR e MR](/docs/it/interactive-mode#pr-review-status) e i controlli di disponibilità come quello della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways). Interrompe anche le [esecuzioni in background delle origini `command` dei plugin](/docs/it/plugins/loading#when-a-command-source-re-runs), che sono comandi locali anziché traffico di rete, perché possono avviare installazioni di dipendenze. **Impostarla su `0` o `false` disabilita comunque questo traffico**, a differenza della maggior parte delle variabili di attivazione/disattivazione; rimuovi la variabile per consentirlo di nuovo. Disabilita anche il recupero dei feature flag, il che rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). L'installazione automatica del marketplace ufficiale dei plugin non è inclusa; disabilitala con `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`. Non influisce sulla [scoperta dei modelli del gateway](/docs/it/llm-gateway-connect#add-gateway-models-to-the-model-picker), che ha una propria attivazione esplicita |

275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà stream. Gli errori di streaming vengono invece propagati al livello dei nuovi tentativi. Utile quando un proxy o un gateway fa sì che il fallback produca un'esecuzione duplicata degli strumenti |275| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta su `1` per disabilitare il fallback non in streaming quando una richiesta in streaming fallisce a metà stream. Gli errori di streaming vengono invece propagati al livello dei nuovi tentativi. Utile quando un proxy o un gateway fa sì che il fallback produca un'esecuzione duplicata degli strumenti |

276| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Imposta su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre stai digitando nel terminale o questo ha il focus. Per impostazione predefinita lo strumento salta sia la notifica desktop sia la [notifica push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva attività recente della tastiera o il focus sul terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere la notifica push mobile quando rileva che sei attivo. Richiede Claude Code v2.1.193 o successiva |276| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | Imposta su `1` per inviare la notifica desktop dello strumento `PushNotification` anche mentre stai digitando nel terminale o lo hai in primo piano. Per impostazione predefinita lo strumento salta sia la notifica desktop sia la [notifica push mobile](/docs/it/remote-control#mobile-push-notifications) quando rileva attività recente della tastiera o il focus sul terminale. Questa variabile disabilita solo quel controllo locale, quindi il server può comunque sopprimere la notifica push mobile quando rileva che sei attivo. Richiede Claude Code v2.1.193 o successiva |

277| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo su una macchina. Se la variabile è impostata in quel momento, Claude Code salta la registrazione in modo permanente. Rimuovere la variabile in seguito non annulla il salto. Esegui `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |277| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta su `1` per disabilitare la registrazione automatica del marketplace ufficiale dei plugin. Claude Code legge la variabile quando sta per registrare il marketplace, di solito durante il primo avvio interattivo su una macchina. Se la variabile è impostata in quel momento, Claude Code salta la registrazione in modo permanente. Rimuovere la variabile in seguito non annulla il salto. Esegui `claude plugin marketplace add anthropics/claude-plugins-official` per registrare il marketplace in qualsiasi momento |

278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Imposta su `1` per impedire a Claude Code di eseguire i tuoi [hook `Notification` per le richieste di permesso senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia alla callback `canUseTool` dell'Agent SDK, che è il modo in cui Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni da terminale. Richiede Claude Code v2.1.233 o successiva |278| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Imposta su `1` per impedire a Claude Code di eseguire i tuoi [hook `Notification` per le richieste di permesso senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia alla callback `canUseTool` dell'Agent SDK, che è il modo in cui Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni del terminale. Richiede Claude Code v2.1.233 o successiva |

279| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Imposta su `1` per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni in container o CI che non devono caricare skill fornite dall'operatore |279| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Imposta su `1` per saltare il caricamento delle skill dalla directory delle skill gestite a livello di sistema. Utile per sessioni in container o CI che non devono caricare skill fornite dall'operatore |

280| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Imposta su `1` per disattivare il controllo dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) che nega i comandi integrati di `cmd` `rd`, `rmdir`, `del` ed `erase` su un [percorso di sistema](/docs/it/permission-modes#remove-item-in-powershell), come la radice di un'unità o la tua directory home. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successiva |280| `CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY` | Imposta su `1` per disattivare il controllo dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) che nega i comandi integrati di `cmd` `rd`, `rmdir`, `del` ed `erase` su un [percorso di sistema](/docs/it/permission-modes#remove-item-in-powershell), come la radice di un'unità o la tua directory home. Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.283 o successiva |

281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Imposta su `1` per disattivare il [cambio automatico di modello quando un classificatore di sicurezza segnala una richiesta](/docs/it/model-config#automatic-model-fallback), il comportamento controllato dall'impostazione [`switchModelsOnFlag`](/docs/it/settings-reference#switchmodelsonflag) |281| `CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK` | Imposta su `1` per disattivare il [cambio automatico di modello quando un classificatore di sicurezza segnala una richiesta](/docs/it/model-config#automatic-model-fallback), il comportamento controllato dall'impostazione [`switchModelsOnFlag`](/docs/it/settings-reference#switchmodelsonflag) |

282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Imposta su `1` per impedire a Claude Code di inviare il campo di output strutturato `output_config.format` e il valore `anthropic-beta` associato, per un [gateway LLM](/docs/it/llm-gateway-protocol#feature-pass-through) il cui upstream li rifiuta. Lascia attive le altre funzionalità in pre-release che [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) disattiva. Richiede Claude Code v2.1.288 o successiva |282| `CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS` | Imposta su `1` per impedire a Claude Code di inviare il campo di output strutturato `output_config.format` e il valore `anthropic-beta` associato, per un [gateway LLM](/docs/it/llm-gateway-protocol#feature-pass-through) il cui upstream li rifiuta. Lascia attive le altre funzionalità pre-release che [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) disattiva. Richiede Claude Code v2.1.288 o successiva |

283| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Imposta su `1` per disattivare il controllo dei [percorsi critici](/docs/it/permission-modes#critical-paths) per un `rm` ricorsivo la cui destinazione è interamente l'output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli sui percorsi critici continuano a essere eseguiti. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |283| `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT` | Imposta su `1` per disattivare il controllo dei [percorsi critici](/docs/it/permission-modes#critical-paths) per un `rm` ricorsivo la cui destinazione è interamente l'output di una sostituzione di comando, come `rm -rf "$(pwd)"`. Gli altri controlli sui percorsi critici continuano a essere eseguiti. Impostala nell'ambiente che avvia Claude Code, poiché Claude Code ignora una copia fornita tramite un blocco `env` delle impostazioni. Richiede Claude Code v2.1.281 o successiva |

284| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Imposta su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale basati sul contesto della conversazione. Salta anche la richiesta in background al modello piccolo/veloce che [genera un titolo per la sessione](/docs/it/sessions#name-your-sessions) |284| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Imposta su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta in background al modello small/fast che [genera il titolo della sessione](/docs/it/sessions#name-your-sessions) |

285| `CLAUDE_CODE_DISABLE_THINKING` | Imposta su `1` per omettere completamente il parametro `thinking` dalle richieste API. È un'opzione di compatibilità per proxy e gateway che rifiutano il parametro. Sui modelli che ragionano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque ragionare. Per disabilitare esplicitamente il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, usa invece `MAX_THINKING_TOKENS=0`. Nessuna delle due variabili disattiva il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), anche `MAX_THINKING_TOKENS=0` omette il parametro, quindi lì le due variabili si comportano allo stesso modo |285| `CLAUDE_CODE_DISABLE_THINKING` | Imposta su `1` per omettere completamente il parametro `thinking` dalle richieste API. È un'opzione di compatibilità per proxy e gateway che rifiutano il parametro. Sui modelli che ragionano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque ragionare. Per disabilitare esplicitamente il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, usa invece `MAX_THINKING_TOKENS=0`. Nessuna delle due variabili disattiva il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), anche `MAX_THINKING_TOKENS=0` omette il parametro, quindi lì le due variabili si comportano allo stesso modo |

286| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Imposta su `1` per saltare la [compattazione automatica](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di un [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta in base alla finestra di contesto che presume per quell'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può invece correggere la finestra presunta; consulta [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per sapere quando si applica ciascuna variabile. Richiede Claude Code v2.1.223 o successiva |286| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Imposta su `1` per saltare la [compattazione automatica](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di un [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta in base alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può invece correggere la finestra presunta; vedi [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per sapere quando si applica ciascuna variabile. Richiede Claude Code v2.1.223 o successiva |

287| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Imposta su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) ed eseguire il rendering di ogni messaggio nella trascrizione. Usala se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero comparire i messaggi |287| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Imposta su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) e visualizzare ogni messaggio della trascrizione. Usala se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero comparire i messaggi |

288| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Imposta su `1` per disattivare lo strumento [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior). Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) resta disponibile. Richiede Claude Code v2.1.285 o successiva |288| `CLAUDE_CODE_DISABLE_WEB_FETCH` | Imposta su `1` per disattivare lo strumento [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior). Lo strumento [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) rimane disponibile. Richiede Claude Code v2.1.285 o successiva |

289| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Imposta su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente invece che tramite il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [passare al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [sposti la sessione in background](/docs/it/agent-view#from-inside-a-session). Se imposti la variabile, un comando PowerShell in background si arresta quando il processo della sessione termina. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successiva |289| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Imposta su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente anziché tramite il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [passare al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [metti la sessione in background](/docs/it/agent-view#from-inside-a-session). Se imposti la variabile, un comando PowerShell in background si arresta quando il processo della sessione termina. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successiva |

290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Imposta su `1` per disabilitare i [workflow](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |290| `CLAUDE_CODE_DISABLE_WORKFLOWS` | Imposta su `1` per disabilitare i [workflow](/docs/it/workflows#turn-workflows-off). Equivalente all'impostazione [`disableWorkflows`](/docs/it/settings-reference#disableworkflows) |

291| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` oppure `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e sulle impostazioni `modelSettings` ed `effortLevel`. Si applica comunque un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel). Consulta [Regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level) |291| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` oppure `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `--effort`, `/effort` e sulle impostazioni `modelSettings` ed `effortLevel`. Un limite [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) si applica comunque. Vedi [Regolare il livello di sforzo](/docs/it/model-config#adjust-effort-level) |

292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Imposta su `1` per aggiungere al flusso di messaggi i messaggi [`session_state_changed`](/docs/it/agent-sdk/typescript#sdksessionstatechangedmessage), che contengono lo stato della sessione. Richiede l'[Agent SDK](/docs/it/agent-sdk/overview) oppure `--print`, `--output-format stream-json` e `--verbose` |292| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | Imposta su `1` per aggiungere allo stream dei messaggi i messaggi [`session_state_changed`](/docs/it/agent-sdk/typescript#sdksessionstatechangedmessage), che contengono lo stato della sessione. Richiede l'[Agent SDK](/docs/it/agent-sdk/overview) oppure `--print`, `--output-format stream-json` e `--verbose` |

293| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettata per compatibilità con le versioni precedenti e non ha alcun effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e le sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) con accesso effettuato. Dalla v2.1.158 alla v2.1.206, era necessario impostarla su `1` per rendere disponibile la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) su quei provider |293| `CLAUDE_CODE_ENABLE_AUTO_MODE` | Accettata per compatibilità con le versioni precedenti e non ha alcun effetto. La modalità auto è disponibile per impostazione predefinita su ogni provider, inclusi Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e le sessioni [Claude apps gateway](/docs/it/claude-apps-gateway) con accesso effettuato. Dalla v2.1.158 alla v2.1.206, impostarla su `1` era necessario per rendere disponibile la [modalità auto](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) su quei provider |

294| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrive la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Imposta su `0` per forzare la disattivazione dei riepiloghi indipendentemente dall'interruttore in `/config`. Imposta su `1` per forzare l'attivazione dei riepiloghi quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e sull'interruttore in `/config` |294| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrive la disponibilità del [riepilogo della sessione](/docs/it/interactive-mode#session-recap). Imposta su `0` per forzare la disattivazione dei riepiloghi indipendentemente dall'interruttore in `/config`. Imposta su `1` per forzare l'attivazione dei riepiloghi quando [`awaySummaryEnabled`](/docs/it/settings-reference#awaysummaryenabled) è `false`. Ha la precedenza sull'impostazione e sull'interruttore in `/config` |

295| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta su `1` per aggiornare lo stato dei plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione in background. Disattivata per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida il [prompt caching](/docs/it/prompt-caching) per quel turno |295| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta su `1` per aggiornare lo stato dei plugin ai confini dei turni in [modalità non interattiva](/docs/it/headless) dopo il completamento di un'installazione in background. Disattivata per impostazione predefinita perché l'aggiornamento modifica il prompt di sistema a metà sessione, il che invalida il [prompt caching](/docs/it/prompt-caching) per quel turno |

296| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per instradare il sondaggio sulla qualità della sessione "How is Claude doing?" verso il tuo [collector OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale diretto ad Anthropic è bloccato. Le valutazioni del sondaggio vengono emesse solo come eventi OTEL verso il collector configurato. In questa modalità nessun dato del sondaggio viene inviato ad Anthropic. Si applica quando è impostata `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, altrimenti non ha effetto. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la policy dell'organizzazione sul feedback del prodotto hanno la precedenza |296| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per indirizzare il sondaggio sulla qualità della sessione "How is Claude doing?" al tuo [collector OpenTelemetry](/docs/it/monitoring-usage) quando il traffico non essenziale diretto ad Anthropic è bloccato. Le valutazioni del sondaggio vengono emesse solo come eventi OTEL verso il collector configurato. In questa modalità nessun dato del sondaggio viene inviato ad Anthropic. Si applica quando è impostata `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK`, e altrimenti non ha alcun effetto. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la policy dell'organizzazione sul feedback del prodotto hanno la precedenza |

297| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate agli strumenti vengono trasmessi in streaming dall'API man mano che Claude li genera. Con questa opzione disattivata, un input di grandi dimensioni, come la scrittura di un file lungo, arriva solo dopo che Claude ha finito di generarlo, il che può sembrare un blocco. Attivata per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Google Cloud's Agent Platform, attivata per ogni modello dove il container distribuito la supporta. Imposta su `0` per disattivarla. Imposta su `1` per forzarne l'attivazione quando instradi tramite un proxy con `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivata per impostazione predefinita su Microsoft Foundry e sulle connessioni tramite [gateway](/docs/it/llm-gateway) |297| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate agli strumenti vengono trasmessi in streaming dall'API mentre Claude li genera. Con questa opzione disattivata, un input di grandi dimensioni per uno strumento, come la scrittura di un file lungo, arriva solo dopo che Claude ha finito di generarlo, il che può far sembrare che sia bloccato. Attivata per impostazione predefinita sull'API Anthropic. Su Amazon Bedrock e Google Cloud's Agent Platform, è attivata per modello dove il container distribuito la supporta. Imposta su `0` per disattivarla. Imposta su `1` per forzarne l'attivazione quando instradi tramite un proxy con `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivata per impostazione predefinita su Microsoft Foundry e sulle connessioni tramite [gateway](/docs/it/llm-gateway) |

298| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del tuo gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivata per impostazione predefinita perché i gateway basati su una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli rilevati vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) ricevuta dalla sessione; distribuisci l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché la [distribuzione gestita dal server non è disponibile nelle configurazioni con gateway](/docs/it/server-managed-settings#platform-availability) |298| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del tuo gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivata per impostazione predefinita perché i gateway basati su una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli rilevati vengono comunque filtrati da un'allowlist [`availableModels`](/docs/it/settings-reference#availablemodels) che la sessione riceve; fornisci l'elenco tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms), poiché [la distribuzione gestita dal server non è disponibile nelle configurazioni con gateway](/docs/it/server-managed-settings#platform-availability) |

299| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimossa nella v2.1.142, quando il modello predefinito della [modalità veloce](/docs/it/fast-mode) è passato da Opus 4.6 a Opus 4.7 |299| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Rimossa nella v2.1.142, quando il modello predefinito della [modalità veloce](/docs/it/fast-mode) è passato da Opus 4.6 a Opus 4.7 |

300| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta su `false` per disattivare i suggerimenti di prompt, le previsioni in grigio che compaiono nell'input del prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quella scritta dall'interruttore **Prompt suggestions** in `/config`. Claude Code inoltre [sospende i suggerimenti quando il tuo account è vicino al limite di utilizzo o lo ha raggiunto](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Imposta su `true` per mantenerli attivi fino al raggiungimento del limite. Richiede Claude Code v2.1.238 o successiva. Consulta [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |300| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta su `false` per disattivare i suggerimenti di prompt, le previsioni in grigio che compaiono nel campo di input del prompt. Ha la precedenza sull'impostazione [`promptSuggestionEnabled`](/docs/it/settings-reference#promptsuggestionenabled), che è quella scritta dall'interruttore **Prompt suggestions** in `/config`. Claude Code inoltre [sospende i suggerimenti quando il tuo account è vicino al limite di utilizzo o lo ha raggiunto](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Imposta su `true` per mantenerli attivi finché non raggiungi il limite. Richiede Claude Code v2.1.238 o successiva. Consulta [Suggerimenti di prompt](/docs/it/interactive-mode#prompt-suggestions) |

301| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività fornisce Claude Code nelle [sessioni che li prevedono](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Imposta su `0` per ottenere invece lo strumento legacy `TodoWrite`. Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |301| `CLAUDE_CODE_ENABLE_TASKS` | Seleziona quali strumenti di tracciamento delle attività fornisce Claude Code nelle [sessioni che li prevedono](/docs/it/tools-reference#task-tool-availability). Per impostazione predefinita, Claude Code fornisce gli strumenti Task `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList`. Imposta su `0` per ottenere invece lo strumento legacy `TodoWrite`. Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |

302| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Necessaria prima di configurare gli exporter OTel. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage) |302| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta su `1` per attivare la raccolta dati OpenTelemetry per metriche e logging. Necessaria prima di configurare gli exporter OTel. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

303| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Imposta su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di essa, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` continua a selezionare gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successiva |303| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | Imposta su `1` per ottenere gli strumenti di tracciamento delle attività su ogni modello. Senza di essa, Claude Code li fornisce per impostazione predefinita solo sui modelli elencati in [Disponibilità dello strumento Task](/docs/it/tools-reference#task-tool-availability). `CLAUDE_CODE_ENABLE_TASKS` continua a selezionare gli strumenti Task o `TodoWrite`. Richiede Claude Code v2.1.233 o successiva |

304| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il ciclo delle query diventa inattivo prima di uscire automaticamente. Utile per workflow automatizzati e script che usano la modalità SDK |304| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il ciclo delle query diventa inattivo prima di uscire automaticamente. Utile per workflow automatizzati e script che usano la modalità SDK |

305| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta su `1` per abilitare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |305| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta su `1` per attivare i [team di agenti](/docs/it/agent-teams). I team di agenti sono sperimentali e disattivati per impostazione predefinita |

306| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore del corpo di ogni richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella tua shell si applica anche alle [sessioni in background](/docs/it/agent-view) che avvii con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e usavano la copia ereditata dal processo supervisore in background |306| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore del corpo di ogni richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente. Un valore esportato nella tua shell si applica anche alle [sessioni in background](/docs/it/agent-view) che avvii con `claude agents` o `--bg`. Prima della v2.1.206, le sessioni in background ignoravano un valore esportato dalla shell e usavano la copia ereditata dal processo supervisore in background |

307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrive il limite di token predefinito per la lettura dei file. Utile quando devi leggere per intero file più grandi |307| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrive il limite di token predefinito per la lettura dei file. Utile quando devi leggere per intero file più grandi |

308| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione in `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione di Claude Code. Usala quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o da un launcher in background avviato inizialmente dallo strumento Bash di Claude Code, fa sì che una vera sessione di primo livello venga erroneamente classificata come annidata. A partire dalla v2.1.178, Claude Code rileva automaticamente il caso di tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Rispettata anche nella v2.1.169 e precedenti; non ha effetto nella v2.1.170 e v2.1.171, in cui il rilevamento delle sessioni annidate che sovrascrive era stato rimosso |308| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione in `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione di Claude Code. Usala quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da una sessione `screen` o da un launcher in background avviato inizialmente dallo strumento Bash di Claude Code, fa sì che una vera sessione di primo livello venga erroneamente classificata come annidata. A partire dalla v2.1.178, Claude Code rileva automaticamente il caso tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Rispettata anche nella v2.1.169 e precedenti; non ha effetto nelle v2.1.170 e v2.1.171, in cui il rilevamento delle sessioni annidate che essa sovrascrive era stato rimosso |

309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Imposta su `1` per forzare la visualizzazione barrata di `~~text~~` nelle risposte di Claude quando il tuo terminale la supporta ma non viene rilevato automaticamente, ad esempio tramite SSH senza inoltro di `TERM_PROGRAM`. Senza questa variabile, i terminali non rilevati mostrano i marcatori `~~` letterali invece di visualizzare il testo barrato. Richiede Claude Code v2.1.186 o successiva |309| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | Imposta su `1` per forzare il rendering barrato di `~~text~~` nelle risposte di Claude quando il tuo terminale lo supporta ma non viene rilevato automaticamente, ad esempio tramite SSH senza inoltro di `TERM_PROGRAM`. Senza di essa, i terminali non rilevati mostrano i marcatori `~~` letterali invece di rendere il testo barrato. Richiede Claude Code v2.1.186 o successiva |

310| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta su `1` per forzare l'attivazione dell'[output sincronizzato](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) della modalità privata DEC 2026 quando il tuo terminale lo supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono alla verifica delle funzionalità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questa variabile non cambia il renderer |310| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta su `1` per forzare l'attivazione della modalità privata DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando il tuo terminale la supporta ma non viene rilevato automaticamente. Utile per emulatori come `eat` di Emacs che implementano BSU/ESU ma non rispondono alla verifica delle funzionalità. Non ha effetto sotto tmux. A differenza di `CLAUDE_CODE_NO_FLICKER`, che passa al [rendering a schermo intero](/docs/it/fullscreen), questa non cambia il renderer |

311| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di generare autonomamente [subagent biforcati](/docs/it/sub-agents#fork-the-current-conversation) ed è attiva per impostazione predefinita solo nelle sessioni interattive. Imposta su `1` per attivarla anche in `claude -p` e nell'Agent SDK, oppure su `0` per disattivarla in ogni tipo di sessione. Puoi eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. Il comportamento predefinito nelle sessioni interattive richiede Claude Code v2.1.232 o successiva; nelle versioni precedenti, imposta la variabile su `1` per attivare la modalità fork |311| `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` | Imposta su `1` per disegnare gli [elementi `Image` dei mod](/docs/it/plugins/mods/reference#elements) come immagini quando il tuo terminale disegna immagini del protocollo grafico kitty con segnaposto Unicode ma non viene rilevato automaticamente. Consulta [quali terminali rileva Claude Code](/docs/it/plugins/mods/gallery#image-and-client) e perché non aiuta all'interno di tmux o screen |

312| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Imposta su `1` per emettere il testo e i blocchi di ragionamento dei [subagent](/docs/it/sub-agents) nell'output di `claude -p --output-format stream-json`, lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Usa la variabile quando un harness invoca `claude` e non può passare il flag da solo. A differenza del flag, che termina con un errore al di fuori della modalità non interattiva con output stream-json, in quel caso la variabile viene ignorata, così che le invocazioni annidate continuino a funzionare quando è impostata a livello di processo. Richiede Claude Code v2.1.211 o successiva |312| `CLAUDE_CODE_FORK_SUBAGENT` | Controlla la [modalità fork](/docs/it/sub-agents#turn-fork-mode-on-or-off), che consente a Claude di avviare autonomamente [subagent fork](/docs/it/sub-agents#fork-the-current-conversation) ed è attiva per impostazione predefinita solo nelle sessioni interattive. Imposta su `1` per attivarla anche in `claude -p` e nell'Agent SDK, oppure su `0` per disattivarla in ogni tipo di sessione. Puoi eseguire `/subtask` indipendentemente dal fatto che la modalità fork sia attiva. L'impostazione predefinita interattiva richiede Claude Code v2.1.232 o successiva; nelle versioni precedenti, imposta la variabile su `1` per attivare la modalità fork |

313| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | Imposta su `1` per emettere i blocchi di testo e di ragionamento dei [subagent](/docs/it/sub-agents) nell'output di `claude -p --output-format stream-json`, con lo stesso comportamento del flag [`--forward-subagent-text`](/docs/it/cli-reference#cli-flags). Usa la variabile quando un harness invoca `claude` e non può passare il flag direttamente. A differenza del flag, che termina con un errore al di fuori della modalità non interattiva con output stream-json, la variabile lì viene ignorata, in modo che le invocazioni annidate continuino a funzionare quando è impostata per l'intero processo. Richiede Claude Code v2.1.211 o successiva |

313| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Imposta su `1` per inviare gli [header di suggerimento per il gateway](/docs/it/llm-gateway-protocol#gateway-hint-headers), come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o su un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Imposta su `0` per smettere di inviarli su ogni connessione, inclusa una connessione diretta all'API Anthropic, dove Claude Code li invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successiva |314| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | Imposta su `1` per inviare gli [header di suggerimento per il gateway](/docs/it/llm-gateway-protocol#gateway-hint-headers), come `x-claude-code-request-class` e `x-claude-code-compaction`, su un proxy personalizzato o su un provider di terze parti come Amazon Bedrock o Claude Platform on AWS. Imposta su `0` per smettere di inviarli su ogni connessione, inclusa una connessione diretta all'API Anthropic, dove Claude Code li invia per impostazione predefinita. Richiede Claude Code v2.1.273 o successiva |

314| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in millisecondi per la richiesta di [rilevamento dei modelli del gateway](/docs/it/llm-gateway-protocol#model-discovery) attivata da `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` (predefinito: `3000`). Aumentalo quando il tuo gateway impiega più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, i valori negativi e altre forme mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva |315| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | Timeout in millisecondi per la richiesta di [rilevamento dei modelli del gateway](/docs/it/llm-gateway-protocol#model-discovery) che `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` attiva (predefinito: `3000`). Aumentalo quando il tuo gateway impiega più di tre secondi per rispondere a `/v1/models` all'avvio. Accetta solo cifre semplici; `0`, i valori negativi e altre grafie mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successiva |

315| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile di Git Bash (`bash.exe`). Usala quando Git Bash è installato ma non si trova nel tuo PATH. Se il percorso non esiste o il file non si chiama `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e rileva automaticamente Git Bash come se non fosse impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code terminava all'avvio quando il percorso non esisteva e usava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Consulta [Configurazione su Windows](/docs/it/setup#set-up-on-windows) |316| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile di Git Bash (`bash.exe`). Usala quando Git Bash è installato ma non è nel tuo PATH. Se il percorso non esiste o il file non si chiama `bash.exe`, `sh.exe`, `bash` o `sh`, Claude Code ignora la variabile e rileva automaticamente Git Bash come se non fosse impostata, registrando un avviso visibile con `--debug`. Prima della v2.1.219, Claude Code terminava all'avvio quando il percorso non esisteva e usava qualsiasi file esistente come shell senza verificare che fosse bash o sh. Consulta [Configurazione su Windows](/docs/it/setup#set-up-on-windows) |

316| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta su `false` per escludere i dotfile dai risultati quando Claude invoca lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior). Inclusi per impostazione predefinita. Non influisce sul completamento automatico dei file con `@`, su `ls`, Grep o Read |317| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta su `false` per escludere i dotfile dai risultati quando Claude invoca lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior). Inclusi per impostazione predefinita. Non influisce sul completamento automatico dei file con `@`, su `ls`, Grep o Read |

317| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta su `false` per far rispettare allo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior) i pattern di `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti, compresi quelli ignorati da Git. Non influisce sul completamento automatico dei file con `@`, che ha la propria [impostazione `respectGitignore`](/docs/it/settings-reference#respectgitignore) |318| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta su `false` per fare in modo che lo [strumento Glob](/docs/it/tools-reference#glob-tool-behavior) rispetti i pattern di `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti, compresi quelli ignorati da git. Non influisce sul completamento automatico dei file con `@`, che ha una propria [impostazione `respectGitignore`](/docs/it/settings-reference#respectgitignore) |

318| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per il rilevamento dei file da parte dello strumento Glob. Il valore predefinito è 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |319| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per il rilevamento dei file dello strumento Glob. Il valore predefinito è 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |

319| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Per quanti minuti il lavoro in background può tenere in attesa un obiettivo attivo prima che Claude Code [chieda a Claude di controllarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Imposta `0` per disattivare i controlli. Indica minuti interi in cifre semplici, al massimo `10080`, cioè una settimana. Claude Code tratta qualsiasi altro valore come non impostato e usa il valore predefinito. Richiede Claude Code v2.1.234 o successiva |320| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | Per quanti minuti il lavoro in background può tenere in attesa un obiettivo attivo prima che Claude Code [chieda a Claude di verificarlo](/docs/it/goal#background-work-defers-evaluation). Predefinito `30`. Imposta `0` per disattivare le verifiche. Indica minuti interi in cifre semplici, al massimo `10080`, cioè una settimana. Claude Code tratta qualsiasi altro valore come non impostato e usa il valore predefinito. Richiede Claude Code v2.1.234 o successiva |

320| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Imposta su `0` per disattivare la compressione gzip dei corpi delle richieste dell'API Claude, della telemetria e della pubblicazione degli [artefatti](/docs/it/artifacts) inviate a `api.anthropic.com`. Per impostazione predefinita, Claude Code comprime i corpi delle richieste di grandi dimensioni sulle connessioni dirette e salta la compressione quando invii le richieste tramite un proxy, configuri un certificato client o imposti `NODE_EXTRA_CA_CERTS`. Usa `0` se un [proxy con ispezione TLS](/docs/it/network-config#ca-certificate-store) che Claude Code non riesce a rilevare gestisce male le richieste compresse |321| `CLAUDE_CODE_GZIP_REQUEST_BODIES` | Imposta su `0` per disattivare la compressione gzip dei corpi delle richieste dell'API Claude, della telemetria e di pubblicazione degli [artefatti](/docs/it/artifacts) inviati a `api.anthropic.com`. Per impostazione predefinita, Claude Code comprime i corpi delle richieste di grandi dimensioni sulle connessioni dirette e salta la compressione quando invii le richieste tramite un proxy, configuri un certificato client o imposti `NODE_EXTRA_CA_CERTS`. Usa `0` se un [proxy con ispezione TLS](/docs/it/network-config#ca-certificate-store) che Claude Code non riesce a rilevare gestisce male le richieste compresse |

321| `CLAUDE_CODE_HIDE_CWD` | Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per condivisioni dello schermo o registrazioni in cui il percorso espone il nome utente del tuo sistema operativo |322| `CLAUDE_CODE_HIDE_CWD` | Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per condivisioni dello schermo o registrazioni in cui il percorso espone il tuo nome utente del sistema operativo |

322| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrive l'indirizzo host usato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso l'instradamento da WSL a Windows |323| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrive l'indirizzo host usato per connettersi all'estensione dell'IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso l'instradamento da WSL a Windows |

323| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Imposta su `1` per saltare l'installazione automatica delle estensioni IDE. Equivale a impostare [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) su `false` |324| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Imposta su `1` per saltare l'installazione automatica delle estensioni IDE. Equivale a impostare [`autoInstallIdeExtension`](/docs/it/settings-reference#autoinstallideextension) su `false` |

324| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta su `1` per saltare la convalida delle voci del lockfile dell'IDE durante la connessione. Usala quando la connessione automatica non riesce a trovare il tuo IDE nonostante sia in esecuzione |325| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta su `1` per saltare la convalida delle voci del lockfile dell'IDE durante la connessione. Usala quando la connessione automatica non riesce a trovare il tuo IDE nonostante sia in esecuzione |

325| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quanti [subagent](/docs/it/sub-agents#concurrent-subagent-limit) possono essere in esecuzione in una sessione prima che lo strumento Agent si rifiuti di generarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi la variabile può modificare il limite ma non disattivarlo. Richiede Claude Code v2.1.217 o successiva |326| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Quanti [subagent](/docs/it/sub-agents#concurrent-subagent-limit) possono essere in esecuzione in una sessione prima che lo strumento Agent si rifiuti di avviarne un altro (predefinito: 20). Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi la variabile può modificare il limite ma non disattivarlo. Richiede Claude Code v2.1.217 o successiva |

326| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrive la dimensione della finestra di contesto che Claude Code presuppone per il modello attivo. A partire dalla v2.1.193, il modo in cui si applica dipende da come Claude Code risolve l'ID del modello; consulta [Correggere la finestra per un gateway o un ID di modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Usala quando instradi verso un modello tramite `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione integrata per il suo nome |327| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrive la dimensione della finestra di contesto che Claude Code presuppone per il modello attivo. A partire dalla v2.1.193, il modo in cui si applica dipende da come Claude Code risolve l'ID del modello; consulta [Correggere la finestra per un gateway o un ID modello personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id). Usala quando instradi verso un modello tramite `ANTHROPIC_BASE_URL` la cui finestra di contesto non corrisponde alla dimensione integrata per il suo nome |

327| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Lunghezza massima in caratteri di ogni descrizione di strumento MCP e delle istruzioni di ogni server MCP che Claude Code invia al modello (predefinito: 2048). Claude Code [tronca il testo più lungo](/docs/it/mcp#for-mcp-server-authors). Accetta un numero intero positivo in cifre semplici. Qualsiasi altro valore viene ignorato e si applica il valore predefinito. Richiede Claude Code v2.1.280 o successiva |328| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Lunghezza massima in caratteri di ciascuna descrizione degli strumenti MCP e delle istruzioni di ciascun server MCP che Claude Code invia al modello (predefinito: 2048). Claude Code [tronca il testo più lungo](/docs/it/mcp#for-mcp-server-authors). Accetta un numero intero positivo in cifre semplici. Qualsiasi altro valore viene ignorato e si applica il valore predefinito. Richiede Claude Code v2.1.280 o successiva |

328| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti variano in base al modello; consulta [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code riduce al limite un valore superiore al limite di un modello. Per un ID di modello che Claude Code non riesce a ricondurre a un modello conosciuto, il valore predefinito è 32000 e il limite è 128000. Aumentare questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la [compattazione automatica](/docs/it/costs#reduce-token-usage) |329| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e i limiti variano in base al modello; consulta [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). Claude Code riduce al limite un valore superiore al limite di un modello. Per un ID modello che Claude Code non riesce a ricondurre a un modello conosciuto, il valore predefinito è 32000 e il limite è 128000. Aumentare questo valore riduce la finestra di contesto effettiva disponibile prima che si attivi la [compattazione automatica](/docs/it/costs#reduce-token-usage) |

329| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrive il numero di nuovi tentativi per le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire dalla v2.1.186; a partire dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per le sessioni non presidiate che devono attendere interruzioni più lunghe, imposta invece `CLAUDE_CODE_RETRY_WATCHDOG` |330| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrive il numero di volte in cui riprovare le richieste API non riuscite (predefinito: 10). Limitato a 15 a partire dalla v2.1.186; a partire dalla v2.1.199, `CLAUDE_CODE_RETRY_WATCHDOG` aumenta il valore predefinito e rimuove il limite. Per le sessioni non presidiate che devono attendere interruzioni più lunghe, imposta invece `CLAUDE_CODE_RETRY_WATCHDOG` |

330| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimossa nella v2.1.224 e ora non ha alcun effetto. In precedenza limitava il numero totale di [subagent](/docs/it/sub-agents) che Claude poteva generare con lo strumento Agent in una sessione (predefinito: 200); la generazione oltre il limite falliva con `Subagent spawn limit reached`. Il [limite di subagent simultanei](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) continuano ad applicarsi |331| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | Rimossa nella v2.1.224 e ora non ha alcun effetto. In precedenza limitava il numero totale di [subagent](/docs/it/sub-agents) che Claude poteva avviare con lo strumento Agent in una sessione (predefinito: 200); l'avvio oltre il limite falliva con `Subagent spawn limit reached`. Il [limite di subagent simultanei](/docs/it/sub-agents#concurrent-subagent-limit) e il [limite di profondità](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) si applicano ancora |

331| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Numero di [livelli di subagent](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) consentiti sotto la conversazione principale (predefinito: 3). Con il valore predefinito, i subagent possono generare i propri subagent e un subagent al terzo livello non può generarne altri; imposta `1` per disattivare l'annidamento. Dalla v2.1.217 alla v2.1.218 il valore predefinito era 1, quindi un subagent non poteva generarne di propri a meno che non aumentassi il limite; la v2.1.219 ha portato il valore predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi il limite può essere modificato ma non rimosso. Richiede Claude Code v2.1.217 o successiva |332| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | Numero di [livelli di subagent](/docs/it/sub-agents#let-subagents-spawn-their-own-subagents) consentiti sotto la conversazione principale (predefinito: 3). Con il valore predefinito, i subagent possono avviare i propri subagent, e un subagent al terzo livello non può avviarne altri; imposta `1` per disattivare l'annidamento. Dalla v2.1.217 alla v2.1.218, il valore predefinito era 1, quindi un subagent non poteva avviarne di propri a meno che non aumentassi il limite; la v2.1.219 ha aumentato il valore predefinito a 3. Accetta un numero intero positivo in cifre semplici; qualsiasi altro valore viene ignorato, quindi il limite può essere modificato ma non rimosso. Richiede Claude Code v2.1.217 o successiva |

332| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |333| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |

333| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivale a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando sono impostati entrambi. Un valore che non è un numero intero positivo viene rifiutato all'avvio con un errore invece di essere trattato come assenza di limite |334| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivale a passare [`--max-turns`](/docs/it/cli-reference#cli-flags), che ha la precedenza quando sono impostati entrambi. Un valore che non è un intero positivo viene rifiutato all'avvio con un errore anziché essere trattato come assenza di limite |

334| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite al numero totale di chiamate [WebSearch](/docs/it/tools-reference#websearch-tool-behavior) che una sessione può effettuare (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate WebSearch restituiscono un avviso che gli indica di proseguire con le informazioni già raccolte. Accetta un numero intero positivo senza limite superiore. Qualsiasi altro valore viene ignorato e si applica il valore predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successiva |335| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | Limite alle chiamate a [WebSearch](/docs/it/tools-reference#session-search-limit) (predefinito: 200). Quando Claude raggiunge il limite, le ulteriori chiamate a WebSearch restituiscono un avviso che gli indica di proseguire con le informazioni già raccolte. Accetta un numero intero positivo senza limite superiore. Qualsiasi altro valore viene ignorato e si applica il valore predefinito, quindi il limite può essere aumentato ma non disattivato. Richiede Claude Code v2.1.212 o successiva |

335| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta su `1` per avviare i server MCP stdio con solo un ambiente di base sicuro più l'`env` configurato del server, invece di ereditare l'ambiente della tua shell |336| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta su `1` per avviare i server MCP stdio con solo un ambiente di base sicuro più l'`env` configurato per il server, invece di ereditare l'ambiente della tua shell |

336| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata a uno strumento MCP ancora in esecuzione [passi a un'attività in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, ovvero 2 minuti). Imposta su `0` per disattivare il passaggio automatico in background. Richiede Claude Code v2.1.212 o successiva |337| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | Tempo trascorso in millisecondi prima che una chiamata a uno strumento MCP ancora in esecuzione [venga spostata in un'attività in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls) (predefinito: 120000, ovvero 2 minuti). Imposta su `0` per disattivare lo spostamento automatico in background. Richiede Claude Code v2.1.212 o successiva |

337| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Per quanto tempo in millisecondi il primo turno di una sessione [non interattiva](/docs/it/headless) attende i server MCP che si stanno ancora connettendo, al posto dell'[attesa del primo turno](/docs/it/agent-sdk/mcp#connection-timing) predefinita. Quando è impostata, l'attesa copre ogni server in sospeso. Imposta su `0` per saltare l'attesa. Un server [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) mantiene la propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successiva |338| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | Per quanto tempo in millisecondi il primo turno di una sessione [non interattiva](/docs/it/headless) attende i server MCP che si stanno ancora connettendo, al posto dell'[attesa predefinita del primo turno](/docs/it/agent-sdk/mcp#connection-timing). Quando è impostata, l'attesa copre ogni server in sospeso. Imposta su `0` per saltare l'attesa. Un server [`--permission-prompt-tool`](/docs/it/cli-reference#cli-flags) mantiene la propria attesa `MCP_TIMEOUT` indipendentemente dal valore. Richiede Claude Code v2.1.274 o successiva |

338| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate agli strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o un [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) non invia alcuna risposta né alcuna notifica di avanzamento per questo intervallo, la chiamata allo strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sovrascrive i valori predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Imposta su `0` per disabilitare il controllo di inattività. I valori inferiori a 1000 vengono portati a un secondo e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 porta la finestra di inattività di quel server almeno al valore di `timeout`. Non si applica ai server IDE né ai server in-process dell'SDK. Richiede Claude Code v2.1.187 o successiva. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività |339| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | Timeout di inattività in millisecondi per le chiamate agli strumenti MCP. Quando un server MCP stdio, HTTP, SSE, WebSocket o [connettore claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) non invia alcuna risposta e alcuna notifica di avanzamento per questo intervallo, la chiamata allo strumento si interrompe con un errore invece di attendere il `MCP_TOOL_TIMEOUT` complessivo. Sovrascrive i valori predefiniti per trasporto di 300000 (5 minuti) per i server di rete e 1800000 (30 minuti) per i server stdio. Imposta su `0` per disattivare il controllo di inattività. I valori inferiori a 1000 vengono portati a un secondo e il valore è limitato al `MCP_TOOL_TIMEOUT` effettivo. Un `timeout` per server in `.mcp.json` di almeno 1000 porta la finestra di inattività di quel server almeno al valore di `timeout`. Non si applica ai server IDE né ai server in-process dell'SDK. Richiede Claude Code v2.1.187 o successiva. Prima della v2.1.203, i server stdio erano esenti dal timeout di inattività |

339| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket di inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket verso gli hook e i comandi Bash quando associa il socket. In una sessione che si avvia con la messaggistica attiva, Claude Code associa il socket prima che venga eseguito qualsiasi hook. Le altre sessioni sulla macchina recapitano i messaggi a questo percorso. Ogni sessione esporta il proprio socket anziché uno ereditato da una sessione padre, e i messaggi che vi arrivano passano attraverso i [controlli in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.224 o successiva |340| `CLAUDE_CODE_MESSAGING_SOCKET` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta il percorso di quel socket verso gli hook e i comandi Bash quando associa il socket. In una sessione che si avvia con la messaggistica attiva, Claude Code associa il socket prima dell'esecuzione di qualsiasi hook. Le altre sessioni sulla macchina consegnano i messaggi a questo percorso. Ogni sessione esporta il proprio socket anziché uno ereditato da una sessione padre, e i messaggi che vi arrivano passano attraverso i [controlli in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) della sessione. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.224 o successiva |

340| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket di inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione verso gli hook e i comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che scrive sul socket può inviare `{"type":"auth","token":"<token>"}` come prima riga per dimostrare di appartenere alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non inizi con una riga valida. Le [regole sui processi figli propri](/docs/it/cross-session-messaging#the-sessions-inbox-socket) indicano quando Claude Code consulta il token. Ogni sessione esporta il proprio token, mai uno ereditato da una sessione padre. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.228 o successiva |341| `CLAUDE_CODE_MESSAGING_TOKEN` | Impostata da Claude Code, non da te: nelle sessioni che associano un [socket inbox](/docs/it/cross-session-messaging#the-sessions-inbox-socket), Claude Code esporta questo token per sessione verso gli hook e i comandi Bash insieme a `CLAUDE_CODE_MESSAGING_SOCKET`. Uno script che invia messaggi al socket può inviare `{"type":"auth","token":"<token>"}` come prima riga per dimostrare di appartenere alla sessione. Su Windows nativo, Claude Code richiede questa riga e chiude qualsiasi connessione che non inizi con una riga valida. Le [regole sui processi figli propri](/docs/it/cross-session-messaging#the-sessions-inbox-socket) indicano quando Claude Code consulta il token. Ogni sessione esporta il proprio token, mai uno ereditato da una sessione padre. I blocchi `env` delle impostazioni non possono impostarla. Richiede Claude Code v2.1.228 o successiva |

341| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta su `1` per mostrare il cursore nativo del terminale nel punto di inserimento invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggiamento, forma e focus del terminale. Impostare `0` equivale a lasciare la variabile non impostata, quindi non ripristina il blocco disegnato in una sessione in cui il cursore nativo del terminale è già attivo |342| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta su `1` per mostrare il cursore proprio del terminale nel punto di inserimento invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggiamento, forma e focus del terminale. Impostare `0` equivale a lasciare la variabile non impostata, quindi non ripristina il blocco disegnato in una sessione in cui il cursore proprio del terminale è già attivo |

342| `CLAUDE_CODE_NEW_INIT` | Imposta su `1` per far eseguire a `/init` un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare il codebase e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere nulla |343| `CLAUDE_CODE_NEW_INIT` | Imposta su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, tra cui CLAUDE.md, skill e hook, prima di esplorare il codebase e scriverli. Senza questa variabile, `/init` genera automaticamente un CLAUDE.md senza chiedere nulla |

343| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta su `1` per scrivere l'output del terminale tramite un secondo file descriptor non bloccante, in modo che un terminale che smette di leggere, come un riquadro tmux in control mode 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 |344| `CLAUDE_CODE_NONBLOCKING_STDOUT` | Imposta su `1` per scrivere l'output del terminale tramite un secondo descrittore di file non bloccante, in modo che un terminale che smette di leggere, come un riquadro tmux in control mode 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 |

344| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code reinvia una [richiesta non in streaming](/docs/it/errors#streaming-response-ended-before-any-complete-data-was-received) che va in timeout. Con `0`, la richiesta fallisce al primo timeout. Non impostata per impostazione predefinita, quindi è `CLAUDE_CODE_MAX_RETRIES` a limitare questi reinvii. Consulta [Regolare il comportamento dei nuovi tentativi](/docs/it/errors#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |345| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | Limita quante volte Claude Code invia di nuovo una [richiesta non in streaming](/docs/it/errors#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](/docs/it/errors#tune-retry-behavior) per il timeout. Richiede Claude Code v2.1.285 o successiva |

345| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per abilitare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene stabile la memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](/docs/it/settings-reference#tui); puoi anche passare con `/tui fullscreen` |346| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per attivare il [rendering a schermo intero](/docs/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene costante la memoria nelle conversazioni lunghe. Sovrascrive l'impostazione [`tui`](/docs/it/settings-reference#tui); puoi anche passarvi con `/tui fullscreen` |

346| `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 predisporre l'autenticazione in ambienti automatizzati |347| `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 predisporre l'autenticazione in ambienti automatizzati |

347| `CLAUDE_CODE_OAUTH_SCOPES` | Scope OAuth separati da spazi con cui è stato emesso il token di aggiornamento, ad esempio `"user:profile user:inference user:sessions:claude_code"`. Obbligatoria quando è impostata `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` |348| `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` |

348| `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`](/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](/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 |349| `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`](/docs/it/authentication#generate-a-long-lived-token). A meno che tu non esegua [`/login`](/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 |

349| `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](/docs/it/fast-mode) su Claude Opus 4.6 invece del modello predefinito attuale. Opus 4.6 non supporta più la modalità veloce |350| `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](/docs/it/fast-mode) su Claude Opus 4.6 invece del valore predefinito attuale. Opus 4.6 non supporta più la modalità veloce |

350| `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 attributi superiori a 64 KB, oppure riducila per diminuire il volume di telemetria. Richiede Claude Code v2.1.214 o successiva. Consulta [Monitoraggio](/docs/it/monitoring-usage) |351| `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](/docs/it/monitoring-usage) |

351| `CLAUDE_CODE_OTEL_DIAG_STDERR` | Imposta su `1` per scrivere su stderr gli errori diagnostici degli exporter OpenTelemetry. Per impostazione predefinita questi errori compaiono solo con `--debug`, quindi un exporter configurato male, ad esempio per un conflitto di porte di Prometheus, altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successiva. Consulta [Monitoraggio](/docs/it/monitoring-usage) |352| `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 un conflitto di porta di Prometheus, altrimenti fallisce senza segnalarlo. Richiede Claude Code v2.1.179 o successiva. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

352| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo svuotamento degli span OpenTelemetry in sospeso (predefinito: 5000). Consulta [Monitoraggio](/docs/it/monitoring-usage) |353| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo svuotamento degli span OpenTelemetry in sospeso (predefinito: 5000). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

353| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo di aggiornamento degli header OpenTelemetry dinamici in millisecondi (predefinito: 1740000 / 29 minuti). Consulta [Header dinamici](/docs/it/monitoring-usage#dynamic-headers) |354| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento degli header dinamici OpenTelemetry in millisecondi (predefinito: 1740000 / 29 minuti). Consulta [Header dinamici](/docs/it/monitoring-usage#dynamic-headers) |

354| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi entro cui l'exporter OpenTelemetry deve terminare allo spegnimento (predefinito: 2000). Aumentalo se le metriche vengono perse all'uscita. Consulta [Monitoraggio](/docs/it/monitoring-usage) |355| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi entro cui l'exporter OpenTelemetry deve terminare alla chiusura (predefinito: 2000). Aumentalo se le metriche vengono perse all'uscita. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

355| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta su `1` per consentire a Claude Code di eseguire in background il comando di aggiornamento del tuo gestore di pacchetti quando è disponibile una nuova versione. Si applica alle installazioni tramite Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Consulta [Aggiornamenti automatici](/docs/it/setup#auto-updates) |356| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta su `1` per consentire a Claude Code di eseguire in background il comando di aggiornamento del tuo gestore di pacchetti quando è disponibile una nuova versione. Si applica alle installazioni tramite Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Consulta [Aggiornamenti automatici](/docs/it/setup#auto-updates) |

356| `CLAUDE_CODE_PERFORCE_MODE` | Imposta su `1` per abilitare la protezione in scrittura compatibile con Perforce. Quando è impostata, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione non ha il bit di scrittura del proprietario, che Perforce rimuove dai file sincronizzati finché `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento delle modifiche di Perforce |357| `CLAUDE_CODE_PERFORCE_MODE` | Imposta su `1` per attivare la protezione in scrittura compatibile con Perforce. Quando è impostata, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione non ha il bit di scrittura del proprietario, che Perforce rimuove dai file sincronizzati finché `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento delle modifiche di Perforce |

357| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrive la directory radice dei plugin. Nonostante il nome, imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory di questo percorso. Il valore predefinito è `~/.claude/plugins` |358| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrive la directory radice dei plugin. Nonostante il nome, imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory di questo percorso. Il valore predefinito è `~/.claude/plugins` |

358| `CLAUDE_CODE_PLUGIN_DIRS` | Directory di plugin da caricare per la sessione, ciascuna caricata come la caricherebbe un flag [`--plugin-dir`](/docs/it/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Separa più percorsi con `:` su Unix o `;` su Windows. Indica ogni percorso come percorso assoluto o fallo iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successiva. Consulta [Caricare un plugin per una sessione](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) |359| `CLAUDE_CODE_PLUGIN_DIRS` | Directory dei plugin da caricare per la sessione, ciascuna caricata come la caricherebbe un flag [`--plugin-dir`](/docs/it/plugins/cli-reference#flags-that-load-a-plugin-for-one-session). Separa più percorsi con `:` su Unix o `;` su Windows. Indica ciascun percorso come percorso assoluto o fallo iniziare con `~`, perché Claude Code salta i percorsi relativi. Richiede Claude Code v2.1.280 o successiva. Consulta [Caricare un plugin per una sessione](/docs/it/plugins/create#load-a-directory-or-archive-for-one-session) |

359| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Controlla se Claude Code ricarica un [mod](/docs/it/plugins/mods/overview) quando i file del mod cambiano. Il ricaricamento si applica a un mod che carichi da una directory con `--plugin-dir` ed è attivo per impostazione predefinita nelle sessioni interattive. Imposta su `1` per attivarlo anche nelle sessioni non interattive, oppure su `0` per disattivarlo in ogni sessione. Richiede Claude Code v2.1.287 o successiva. Consulta [impostazioni e variabili d'ambiente dei mod](/docs/it/plugins/mods/reference#settings-and-environment-variables) |360| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Controlla se Claude Code ricarica un [mod](/docs/it/plugins/mods/overview) quando i file del mod cambiano. Il ricaricamento si applica a un mod che carichi da una directory con `--plugin-dir` ed è attivo per impostazione predefinita nelle sessioni interattive. Imposta su `1` per attivarlo anche nelle sessioni non interattive, oppure su `0` per disattivarlo in ogni sessione. Richiede Claude Code v2.1.287 o successiva. Consulta [impostazioni e variabili d'ambiente dei mod](/docs/it/plugins/mods/reference#settings-and-environment-variables) |

360| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per clonare o aggiornare un marketplace di plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Consulta [Git clone timed out](/docs/it/plugins/troubleshooting#git-clone-timed-out-after-120s) |361| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per la clonazione o l'aggiornamento di un marketplace di plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Consulta [Git clone timed out](/docs/it/plugins/troubleshooting#git-clone-timed-out-after-120s) |

361| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta su `1` per saltare il tentativo di nuova clonazione e continuare a usare il checkout esistente del marketplace quando un aggiornamento del marketplace non riesce a raggiungere il remoto o ad autenticarsi presso di esso. Utile in ambienti offline o isolati in cui una nuova clonazione fallirebbe allo stesso modo. Consulta [Gli aggiornamenti del marketplace falliscono in ambienti offline](/docs/it/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |362| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta su `1` per saltare il tentativo di nuova clonazione e continuare a usare il checkout esistente del marketplace quando un aggiornamento del marketplace non riesce a raggiungere il remoto o ad autenticarsi. Utile in ambienti offline o air-gapped in cui una nuova clonazione fallirebbe allo stesso modo. Consulta [Gli aggiornamenti del marketplace non riescono negli ambienti offline](/docs/it/plugins/troubleshooting#marketplace-updates-keep-failing-offline) |

362| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le sorgenti in forma abbreviata GitHub `owner/repo` tramite HTTPS invece che SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |363| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le sorgenti GitHub in forma abbreviata `owner/repo` tramite HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, nonché a `/plugin marketplace add` e `update`. Utile nei runner CI, nei container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

363| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Usala per includere in un'immagine container una directory di plugin prepopolata. Claude Code registra i marketplace da queste directory all'avvio e usa i plugin già memorizzati nella cache senza clonarli di nuovo. Consulta [Prepopolare i plugin per i container](/docs/it/plugins/org#seed-containers-and-ci) |364| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory seed di plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Usala per includere una directory di plugin già popolata in un'immagine container. Claude Code registra i marketplace da queste directory all'avvio e usa i plugin già presenti nella cache senza clonarli di nuovo. Consulta [Prepopolare i plugin per i container](/docs/it/plugins/org#seed-containers-and-ci) |

364| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Imposta su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando avvia PowerShell per le chiamate agli strumenti, gli hook e i comandi della riga di stato, e rispettare invece la execution policy effettiva della macchina. Per impostazione predefinita Claude Code aggira la execution policy a livello di processo, in modo che gli script `.ps1` e le importazioni di moduli funzionino nelle installazioni di Windows con policy predefinita Restricted. L'aggiramento a livello di processo non sovrascrive mai `MachinePolicy` o `UserPolicy` dei Criteri di gruppo, indipendentemente da questa impostazione |365| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Imposta su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando avvia PowerShell per le chiamate agli strumenti, gli hook e i comandi della riga di stato, rispettando invece la policy di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code aggira la policy di esecuzione a livello di processo, in modo che gli script `.ps1` e le importazioni di moduli funzionino sulle installazioni Windows con policy predefinita Restricted. L'aggiramento a livello di processo non sovrascrive mai le policy di gruppo `MachinePolicy` o `UserPolicy`, indipendentemente da questa impostazione |

365| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Limite massimo in millisecondi per l'attesa inattiva del lavoro in background, come subagent e workflow, dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude esegue un turno per gestire un risultato in background. Predefinito: `600000`, ovvero 10 minuti. Quando l'attesa inattiva raggiunge il limite, Claude Code smette di attendere le attività in background rimanenti ed esce. Imposta su `0` per attendere indefinitamente. Questo limite è separato dal periodo di tolleranza di cinque secondi che si applica alle semplici shell in background. Richiede Claude Code v2.1.182 o successiva |366| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | Tetto massimo in millisecondi per l'attesa inattiva del lavoro in background, come subagent e workflow, dopo il turno finale in [modalità non interattiva](/docs/it/headless#background-tasks-at-exit) con il flag `-p`. L'attesa inattiva ricomincia ogni volta che Claude esegue un turno per gestire un risultato in background. Predefinito: `600000`, ovvero 10 minuti. Quando l'attesa inattiva raggiunge il tetto, Claude Code smette di attendere le restanti attività in background. Un comando in background in esecuzione avviato dalla conversazione principale mantiene aperta l'esecuzione oltre tale tetto. Imposta su `0` per attendere indefinitamente. Richiede Claude Code v2.1.182 o successiva |

366| `CLAUDE_CODE_PROCESS_WRAPPER` | Avvia i processi che Claude Code lancia dal proprio binario, come il servizio in background che ospita le sessioni di [agent view](/docs/it/agent-view), tramite un launcher aziendale indicato come prefisso argv, ad esempio `/opt/corp/launcher`. Impostala nel blocco `env` delle impostazioni utente o delle [impostazioni gestite](/docs/it/managed-settings), non come export della shell, in modo che il servizio in background scollegato la erediti; le impostazioni di progetto e locali non possono impostarla. Equivale all'[impostazione `processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successiva; questa variabile ha la precedenza quando sono impostate entrambe. L'estensione VS Code configura il proprio launcher separatamente tramite la sua impostazione `claudeProcessWrapper`. Ignorata su Windows. Consulta [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, ciò che il launcher copre e il contratto che il launcher deve rispettare. Richiede Claude Code v2.1.208 o successiva |367| `CLAUDE_CODE_PROCESS_WRAPPER` | Avvia i processi che Claude Code lancia dal proprio binario, come il servizio in background che ospita le sessioni di [agent view](/docs/it/agent-view), tramite un launcher aziendale indicato come prefisso argv, ad esempio `/opt/corp/launcher`. Impostala nel blocco `env` delle impostazioni utente o delle [impostazioni gestite](/docs/it/managed-settings), non come export della shell, in modo che il servizio in background scollegato la erediti; le impostazioni di progetto e locali non possono impostarla. Equivale all'[impostazione `processWrapper`](/docs/it/settings-reference#processwrapper), che richiede Claude Code v2.1.210 o successiva; questa variabile ha la precedenza quando sono impostate entrambe. L'estensione per VS Code configura il proprio launcher separatamente tramite la sua impostazione `claudeProcessWrapper`. Ignorata su Windows. Consulta [Eseguire Claude Code dietro un launcher aziendale](/docs/it/corporate-launcher) per il formato del valore, cosa copre il launcher e il contratto che il launcher deve rispettare. Richiede Claude Code v2.1.208 o successiva |

367| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostala insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory in `projects/` in cui Claude Code memorizza le trascrizioni e la memoria automatica di quella sessione, al posto di un nome derivato dal percorso della directory di lavoro. Ad esempio, avviare Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` le memorizza in `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostata, e la legge solo dall'ambiente da cui avvii `claude`, mai da un [blocco `env` di un file di impostazioni](#in-settings-files). Consulta [Assegnare tu il nome alla directory del progetto](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successiva |368| `CLAUDE_CODE_PROJECT_DIR_NAME` | Impostala insieme a `CLAUDE_CONFIG_DIR` per scegliere il nome della directory in `projects/` in cui Claude Code memorizza le trascrizioni e la memoria automatica di quella sessione, al posto di un nome derivato dal percorso della directory di lavoro. Ad esempio, avviando Claude Code con `CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` li memorizza in `/srv/tenant-a/projects/work/`. Claude Code ignora questa variabile quando `CLAUDE_CONFIG_DIR` non è impostata e la legge solo dall'ambiente da cui avvii `claude`, mai da un [blocco `env` di un file di impostazioni](#in-settings-files). Consulta [Assegnare tu il nome alla directory del progetto](/docs/it/sessions#name-the-project-directory-yourself). Richiede Claude Code v2.1.234 o successiva |

368| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper eseguiti inline con essi. Ha la precedenza sull'impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |369| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper che vengono eseguiti in linea con essi. Ha la precedenza sull'impostazione `promptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API addebita le scritture nella cache di 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |

369| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta su `1` per propagare il contesto di trace W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'header `traceparent` sulle richieste al modello e ai server MCP HTTP e la variabile d'ambiente `TRACEPARENT` per i sottoprocessi di Bash, PowerShell e degli hook. Per impostazione predefinita, la propagazione è abilitata solo quando la connessione è diretta all'API Anthropic. Aggiunta nella v2.1.152. Consulta [Trace (beta)](/docs/it/monitoring-usage#traces-beta) |370| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta su `1` per propagare il contesto di trace W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'header `traceparent` nelle richieste al modello e ai server MCP HTTP e la variabile d'ambiente `TRACEPARENT` per i sottoprocessi di Bash, PowerShell e degli hook. Per impostazione predefinita, la propagazione è attiva solo quando sei connesso direttamente all'API Anthropic. Aggiunta nella v2.1.152. Consulta [Trace (beta)](/docs/it/monitoring-usage#traces-beta) |

370| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostata dalle piattaforme host che incorporano Claude Code e gestiscono per suo conto l'instradamento verso il provider del modello. Quando è impostata, Claude Code ignora nei file di impostazioni le variabili di selezione del provider, di endpoint e di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY`, in modo che le impostazioni utente non possano sovrascrivere l'instradamento dell'host. Claude Code ignora inoltre le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle [impostazioni gestite](/docs/it/managed-settings), qualunque sia la fonte gestita che le fornisce, così che la configurazione del modello dell'host abbia la precedenza su un modello fissato nelle impostazioni gestite non aggiornato. Claude Code ignora anche le variabili di selezione del modello come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL` in un blocco `env` gestito; un'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) nelle impostazioni gestite continua ad applicarsi a meno che l'host non ne fornisca una propria. Claude Code salta inoltre la disattivazione automatica della telemetria che altrimenti applica sui provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, quindi la telemetria segue la disattivazione standard tramite `DISABLE_TELEMETRY`. Consulta [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |371| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostata dalle piattaforme host che incorporano Claude Code e gestiscono per suo conto l'instradamento verso il provider del modello. Quando è impostata, Claude Code ignora le variabili di selezione del provider, dell'endpoint e di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni, in modo che le impostazioni utente non possano sovrascrivere l'instradamento dell'host. Claude Code ignora inoltre le chiavi di selezione del modello come `model`, `fallbackModel` e `modelOverrides` nelle [impostazioni gestite](/docs/it/managed-settings), qualunque sia la sorgente gestita che le fornisce, in modo che la configurazione del modello dell'host abbia la precedenza su un modello fissato nelle impostazioni gestite non aggiornato. Claude Code ignora inoltre le variabili di selezione del modello come `ANTHROPIC_MODEL` e la famiglia `ANTHROPIC_DEFAULT_*_MODEL` in un blocco `env` gestito; un'allowlist [`availableModels`](/docs/it/model-config#restrict-model-selection) nelle impostazioni gestite si applica comunque, a meno che l'host non ne fornisca una propria. Claude Code salta inoltre la disattivazione automatica della telemetria che altrimenti applica sui provider di terze parti come Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform e Microsoft Foundry, quindi la telemetria segue la disattivazione standard tramite `DISABLE_TELEMETRY`. Consulta [Comportamenti predefiniti per provider API](/docs/it/data-usage#default-behaviors-by-api-provider) |

371| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS al posto del chiamante. Opzione facoltativa per gli ambienti in cui la risoluzione dei nomi host deve essere gestita dal proxy |372| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS al posto del chiamante. Opzione facoltativa per gli ambienti in cui il proxy deve gestire la risoluzione dei nomi host |

372| `CLAUDE_CODE_REMOTE` | Impostata automaticamente su `true` quando Claude Code è in esecuzione come [sessione cloud](/docs/it/claude-code-on-the-web). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |373| `CLAUDE_CODE_REMOTE` | Impostata automaticamente su `true` quando Claude Code è in esecuzione come [sessione cloud](/docs/it/claude-code-on-the-web). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |

373| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta [Collegare l'output alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |374| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](/docs/it/claude-code-on-the-web) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta [Collegare l'output alla sessione](/docs/it/cloud-environments#link-output-back-to-the-session) |

374| `CLAUDE_CODE_RESTRICTED` | Imposta su `1` per avviare la sessione in modalità limitata, come passando [`--restricted`](/docs/it/cli-reference#cli-flags). Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successiva |375| `CLAUDE_CODE_RESTRICTED` | Imposta su `1` per avviare la sessione in modalità con restrizioni, come passando [`--restricted`](/docs/it/cli-reference#cli-flags). Claude Code ignora questa variabile nel blocco `env` di un file di impostazioni. Richiede Claude Code v2.1.248 o successiva |

375| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta su `1` per riprendere automaticamente se la sessione precedente si è interrotta a metà turno. Usata in modalità SDK affinché il modello continui senza che l'SDK debba reinviare il prompt. Per disattivarla, rimuovi la variabile o impostala su `0`. Per il pannello chat di VS Code, consulta [Continuare le conversazioni dopo un ricaricamento](/docs/it/vs-code#continue-conversations-after-a-reload) |376| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Usata in modalità SDK affinché il modello prosegua senza che l'SDK debba inviare di nuovo il prompt. Per disattivarla, rimuovi la variabile o impostala su `0`. Per il pannello chat di VS Code, consulta [Continuare le conversazioni dopo un ricaricamento](/docs/it/vs-code#continue-conversations-after-a-reload) |

376| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione interrotta a metà turno continui automaticamente alla ripresa. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e il relativo messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT`, e la sessione si avvia inattiva così che tu possa continuare esplicitamente. Non impostata o `0` significa nessun limite, tranne per il fatto che un turno la cui ultima richiesta è fallita con un errore API riprende solo finché quell'errore ha meno di sei ore. Un valore positivo limita ogni turno, inclusi quelli; un valore negativo o non numerico applica un limite di un'ora. Gli script di avvio per agenti di lunga durata possono impostarla in modo che un riavvio su una trascrizione vecchia non riesegua un prompt obsoleto. Claude Code imposta da sé un limite di un'ora quando riavvia una sessione di [agent view](/docs/it/agent-view) andata in crash che aveva ereditato la sua conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successiva |377| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | Età massima in millisecondi dell'ultimo messaggio della trascrizione affinché una sessione terminata a metà turno prosegua automaticamente alla ripresa. Quando l'ultimo messaggio è più vecchio di questo limite, Claude Code salta la ripresa automatica di `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` e il relativo messaggio di continuazione `CLAUDE_CODE_RESUME_PROMPT`, e la sessione si avvia inattiva affinché tu prosegua esplicitamente. Non impostata o `0` significa nessun limite, tranne per il fatto che un turno la cui ultima richiesta è fallita con un errore API riprende solo finché quell'errore ha meno di sei ore. Un valore positivo limita ogni turno, inclusi questi; un valore negativo o non numerico applica un limite di un'ora. Gli script di avvio per agenti a lunga esecuzione possono impostarla in modo che un riavvio su una vecchia trascrizione non riesegua un prompt obsoleto. Claude Code imposta autonomamente un limite di un'ora quando riavvia una sessione di [agent view](/docs/it/agent-view) andata in crash che aveva ereditato la conversazione da una sessione interattiva. Richiede Claude Code v2.1.211 o successiva |

377| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrive il messaggio di continuazione che Claude Code invia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` continua un turno interrotto invece di reinviarne il prompt, oppure quando riprendi una [chiamata a uno strumento rinviata](/docs/it/hooks#defer-a-tool-call-for-later) con `-p`. Il valore predefinito è `Continue from where you left off.`. Una stringa vuota usa il valore predefinito |378| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrive il messaggio di continuazione che Claude Code invia a Claude quando `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` prosegue un turno interrotto invece di inviare di nuovo il suo prompt, oppure quando riprendi una [chiamata a uno strumento differita](/docs/it/hooks#defer-a-tool-call-for-later) con `-p`. Il valore predefinito è `Continue from where you left off.`. Una stringa vuota usa il valore predefinito |

378| `CLAUDE_CODE_RETRY_WATCHDOG` | Imposta su `1` per le sessioni non presidiate come harness di valutazione, job CI o worker remoti. Riprova indefinitamente in caso di errori di capacità `429` e `529` invece di fallire dopo `CLAUDE_CODE_MAX_RETRIES` tentativi. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche se proviene da un [limite di spesa del gateway](/docs/it/errors#spend-limit-reached) che si azzera secondo una pianificazione. Prima della v2.1.239, il watchdog riprovava indefinitamente anche in questi casi. Per le richieste in modalità veloce, consulta [Gestire i rate limit](/docs/it/fast-mode#handle-rate-limits). Il watchdog attende fino a 5 minuti tra un tentativo e l'altro, oppure fino all'azzeramento del limite quando la risposta riporta un orario di azzeramento del rate limit, così una sessione che raggiunge un limite di utilizzo attende la fine della finestra rimanente. Nella v2.1.199 o successiva aumenta anche a 300 il numero predefinito di nuovi tentativi per altri errori transitori, come errori del server, timeout e connessioni interrotte, pari a circa tre ore di attesa, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successiva |379| `CLAUDE_CODE_RETRY_WATCHDOG` | Imposta su `1` per le sessioni non presidiate come harness di valutazione, job CI o worker remoti. Riprova indefinitamente gli errori di capacità `429` e `529` invece di fallire dopo `CLAUDE_CODE_MAX_RETRIES` tentativi. Claude Code fallisce immediatamente quando una richiesta a velocità standard riceve un `429` che segnala un limite di spesa o crediti di utilizzo esauriti, anche se proviene da un [limite di spesa del gateway](/docs/it/errors#spend-limit-reached) che si azzera secondo una pianificazione. Prima della v2.1.239, il watchdog li riprovava indefinitamente. Per le richieste in modalità veloce, consulta [Gestire i rate limit](/docs/it/fast-mode#handle-rate-limits). Il watchdog attende fino a 5 minuti tra un tentativo e l'altro, oppure fino all'azzeramento del limite quando la risposta riporta un orario di azzeramento del rate limit, in modo che una sessione che raggiunge un limite di utilizzo attenda la fine della finestra rimanente. Nella v2.1.199 o successiva aumenta inoltre a 300 il numero predefinito di nuovi tentativi per altri errori transitori, come errori del server, timeout e connessioni interrotte, pari a circa tre ore di attesa progressiva, e rimuove il limite di 15 su `CLAUDE_CODE_MAX_RETRIES` se imposti esplicitamente quella variabile. Richiede Claude Code v2.1.186 o successiva |

379| `CLAUDE_CODE_SAFE_MODE` | Imposta su `1` per avviare in modalità provvisoria: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti personalizzati, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della riga di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione danneggiata. La policy delle impostazioni gestite continua ad applicarsi, inclusi gli hook, la riga di stato e i comandi dei suggerimenti di file configurati dalla policy; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati dalla policy invece no. Equivale a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figli avviati direttamente ereditano la variabile |380| `CLAUDE_CODE_SAFE_MODE` | Imposta su `1` per avviare in modalità provvisoria: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti personalizzati, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della riga di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione non funzionante. Le policy delle impostazioni gestite si applicano comunque, inclusi gli hook, la riga di stato e i comandi dei suggerimenti di file configurati tramite policy; i plugin gestiti, le skill gestite, il CLAUDE.md gestito e i server MCP configurati tramite policy no. Equivale a passare [`--safe-mode`](/docs/it/cli-reference#cli-flags). I processi figli avviati direttamente ereditano la variabile |

380| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando è impostata `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Le chiavi sono sottostringhe confrontate con il testo del comando; i valori sono limiti interi di chiamate. Ad esempio, `{"deploy.sh": 2}` consente di chiamare `deploy.sh` al massimo due volte. La corrispondenza si basa su sottostringhe, quindi i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` vengono comunque conteggiati nel limite. La moltiplicazione a runtime tramite `xargs` o `find -exec` non viene rilevata; si tratta di un controllo di difesa in profondità |381| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere invocati per sessione quando è impostata `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`. Le chiavi sono sottostringhe confrontate con il testo del comando; i valori sono limiti interi di chiamate. Ad esempio, `{"deploy.sh": 2}` consente di chiamare `deploy.sh` al massimo due volte. La corrispondenza si basa su sottostringhe, quindi i trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` vengono comunque conteggiati nel limite. La moltiplicazione a runtime tramite `xargs` o `find -exec` non viene rilevata; si tratta di un controllo di difesa in profondità |

381| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotellina del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato di trackpad e rotellina nei terminali che già amplificano gli eventi della rotellina. Imposta su `3` per corrispondere a `vim` se il tuo terminale invia un evento della rotellina per scatto senza amplificazione. Ignorata nel terminale degli IDE JetBrains, dove Claude Code usa la propria gestione dello scorrimento |382| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotellina del mouse nel [rendering a schermo intero](/docs/it/fullscreen#mouse-wheel-scrolling). Accetta qualsiasi valore positivo fino a 20, inclusi valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato del trackpad e della rotellina nei terminali che già amplificano gli eventi della rotellina. Imposta su `3` per corrispondere a `vim` se il tuo terminale invia un evento di rotellina per scatto senza amplificazione. Ignorata nel terminale degli IDE JetBrains, dove Claude Code usa una propria gestione dello scorrimento |

382| `CLAUDE_CODE_SEND_FEEDBACK` | Imposta su `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Imposta su `1` per attivarlo dove il tuo account ha già accesso; la variabile non può concedere l'accesso da sola, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell'impostazione [`feedbackDrafts`](/docs/it/settings-reference#feedbackdrafts), continuano ad applicarsi |383| `CLAUDE_CODE_SEND_FEEDBACK` | Imposta su `0` per disattivare il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior) per una sessione. Imposta su `1` per attivarlo dove il tuo account ha già accesso; la variabile non può concedere l'accesso di per sé, e gli altri interruttori che disattivano il feedback, come `DISABLE_FEEDBACK_COMMAND` e il valore `off` dell'impostazione [`feedbackDrafts`](/docs/it/settings-reference#feedbackdrafts), si applicano comunque |

383| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrive il tempo disponibile in millisecondi per gli hook [SessionEnd](/docs/it/hooks#sessionend). Il valore è anche il timeout per ogni hook che non imposta un proprio `timeout`. Si applica all'uscita dalla sessione, a `/clear` e al cambio di sessione tramite `/resume` interattivo. Per impostazione predefinita il tempo disponibile è di 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout degli hook forniti dai plugin non aumentano il tempo disponibile |384| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrive il tempo a disposizione in millisecondi per gli hook [SessionEnd](/docs/it/hooks#sessionend). Il valore è anche il timeout per ogni hook che non imposta un proprio `timeout`. Si applica all'uscita dalla sessione, a `/clear` e al cambio di sessione tramite `/resume` interattivo. Per impostazione predefinita il tempo a disposizione è di 1,5 secondi, aumentato automaticamente al `timeout` per hook più alto configurato nei file di impostazioni, fino a 60 secondi. I timeout degli hook forniti dai plugin non aumentano il tempo a disposizione |

384| `CLAUDE_CODE_SESSION_ID` | Impostata automaticamente sull'ID della sessione corrente nei sottoprocessi degli strumenti Bash e PowerShell, nei sottoprocessi dei [comandi hook](/docs/it/hooks) e nei sottoprocessi dei [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e gli hook corrisponde al campo `session_id` nell'input JSON dell'hook e viene aggiornata con `/clear`. Un sottoprocesso di un server MCP conserva l'ID con cui è stato avviato. Con `--resume <session-id>` riceve l'ID ripreso, in linea con gli hook e Bash. Con `--continue` o `--resume` senza un ID esplicito potrebbe invece ricevere l'ID iniziale di avvio. Usala per correlare script e strumenti esterni con la sessione di Claude Code che li ha avviati |385| `CLAUDE_CODE_SESSION_ID` | Impostata automaticamente sull'ID della sessione corrente nei sottoprocessi degli strumenti Bash e PowerShell, nei sottoprocessi dei [comandi hook](/docs/it/hooks) e nei sottoprocessi dei [server MCP](/docs/it/mcp) stdio. Per Bash, PowerShell e gli hook corrisponde al campo `session_id` nell'input JSON dell'hook e viene aggiornata con `/clear`. Un sottoprocesso di un server MCP mantiene l'ID con cui è stato avviato. Con `--resume <session-id>` riceve l'ID ripreso, come gli hook e Bash. Con `--continue` o `--resume` senza un ID esplicito potrebbe ricevere invece l'ID iniziale di avvio. Usala per correlare script e strumenti esterni con la sessione di Claude Code che li ha avviati |

385| `CLAUDE_CODE_SHELL` | Imposta la shell che Claude Code usa per eseguire i comandi dello strumento Bash. Accetta un percorso a un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e ripiega sul rilevamento automatico. Il rilevamento automatico usa il tuo `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` funzionante, poi `bash`, trovato nel tuo `PATH` e nei percorsi di installazione standard |386| `CLAUDE_CODE_SHELL` | Imposta la shell che Claude Code usa per eseguire i comandi dello strumento Bash. Accetta un percorso a un binario `bash` o `zsh`, ad esempio `/opt/homebrew/bin/bash`. Altre shell come `fish` non sono supportate. Se il valore non è un percorso `bash` o `zsh` funzionante, Claude Code lo ignora e ripiega sul rilevamento automatico. Il rilevamento automatico usa la tua `$SHELL` quando punta a `bash` o `zsh`, altrimenti sceglie il primo `zsh` e poi `bash` funzionante trovato nel tuo `PATH` e nei percorsi di installazione standard |

386| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che avvolge i comandi shell avviati da Claude Code: chiamate allo strumento Bash, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline) e comandi di avvio dei [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per il logging o l'auditing. Impostare un semplice percorso di eseguibile come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come singolo argomento quotato per la shell in `$1`, quindi il wrapper deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un semplice percorso di eseguibile interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate allo strumento Bash, `$1` contiene l'intera invocazione della shell assemblata da Claude Code, inclusa la configurazione dell'ambiente, non solo il comando eseguito da Claude |387| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso di comando che avvolge i comandi di shell avviati da Claude Code: chiamate allo strumento Bash, comandi degli [hook](/docs/it/hooks), comandi della [riga di stato](/docs/it/statusline) e comandi di avvio dei [server MCP](/docs/it/mcp) stdio. Gli hook PowerShell e gli hook in forma exec vengono eseguiti senza il prefisso. Utile per il logging o l'auditing. Impostare un semplice percorso di eseguibile come `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh '<command>'`. Il wrapper riceve la riga di comando come singolo argomento quotato per la shell in `$1`, quindi deve rivalutare `$1` con una shell, ad esempio `exec bash -c "$1"`. Trattare `$1` come un semplice percorso di eseguibile interrompe i server MCP stdio che passano argomenti come `npx -y <package>`. Per le chiamate allo strumento Bash, `$1` contiene l'intera invocazione della shell assemblata da Claude Code, inclusa la configurazione dell'ambiente, non solo il comando eseguito da Claude |

387| `CLAUDE_CODE_SIMPLE` | Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, di lettura file e di modifica file. Gli strumenti MCP da `--mcp-config` rimangono disponibili. Disabilita il rilevamento automatico di hook, skill, comandi personalizzati, subagent, plugin installati, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory passata con `--add-dir` vengono comunque caricate. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivale a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |388| `CLAUDE_CODE_SIMPLE` | Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, di lettura e di modifica dei file. Gli strumenti MCP da `--mcp-config` restano disponibili. Disattiva il rilevamento automatico di hook, skill, comandi personalizzati, subagent, plugin installati, server MCP, memoria automatica e CLAUDE.md. Le skill in una directory che passi con `--add-dir` vengono comunque caricate. I token OAuth e le credenziali del portachiavi non vengono letti, quindi l'autenticazione Anthropic deve provenire da `ANTHROPIC_API_KEY` o da un `apiKeyHelper` in `--settings`. Equivale a passare [`--bare`](/docs/it/headless#start-faster-with-bare-mode) |

388| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Imposta su `1` per usare un prompt di sistema più breve e descrizioni degli strumenti abbreviate su qualsiasi modello. Imposta su `0`, `false`, `no` o `off` per disattivarla anche sui modelli in cui l'esperimento o la configurazione del server la abiliterebbero altrimenti. Il set completo di strumenti, gli hook, i server MCP e il rilevamento di CLAUDE.md restano abilitati |389| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Scegli tra il prompt di sistema completo di Claude Code e uno più breve con descrizioni degli strumenti abbreviate. Quando non è impostata, Haiku 4.5, Sonnet 5, Opus 4.7 e i modelli precedenti di quelle famiglie usano per impostazione predefinita il prompt completo, mentre i modelli più recenti usano quello più breve. Imposta su `1` per usare il prompt più breve su qualsiasi modello. Imposta su `0`, `false`, `no` o `off` per usare il prompt completo su qualsiasi modello, anche dove un esperimento o una configurazione del server selezionerebbe altrimenti quello più breve. Entrambi i prompt mantengono l'intero set di strumenti, gli hook, i server MCP e il rilevamento di CLAUDE.md |

389| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano le richieste autonomamente |390| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/docs/it/claude-platform-on-aws), per i gateway che firmano autonomamente le richieste |

390| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Imposta su `1` per disattivare la cache in-process delle credenziali risolte dalla catena predefinita dei provider di credenziali AWS, così che Claude Code risolva la catena a ogni richiesta API. Con la cache disattivata, un profilo basato su SSO richiede le credenziali a IAM Identity Center a ogni richiesta. Consulta [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |391| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | Imposta su `1` per disattivare la cache in-process delle credenziali risolte dalla catena predefinita di provider di credenziali AWS, in modo che Claude Code risolva la catena a ogni richiesta API. Con la cache disattivata, un profilo basato su SSO richiede le credenziali a IAM Identity Center a ogni richiesta. Consulta [memorizzazione nella cache delle credenziali e timeout di risoluzione](/docs/it/amazon-bedrock#credential-caching-and-resolution-timeout). Richiede Claude Code v2.1.207 o successiva |

391| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock (ad esempio, quando usi un gateway LLM) |392| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock (ad esempio, quando usi un gateway LLM) |

392| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Imposta su `1` per trattare come disponibile una verifica di disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) non riuscita, per le reti che bloccano la richiesta diretta della verifica a `api.anthropic.com`. Claude Code rispetta comunque una risposta "disabled by your organization" |393| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Imposta su `1` per considerare disponibile la [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) quando il controllo di disponibilità fallisce, per le reti che bloccano la richiesta diretta del controllo verso `api.anthropic.com`. Claude Code rispetta comunque una risposta "disabled by your organization" |

393| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Imposta su `1` per saltare la verifica lato client della disponibilità della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), per i proxy che intercettano la richiesta della verifica invece di rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la tua organizzazione ha disabilitato la modalità veloce |394| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | Imposta su `1` per saltare il controllo di disponibilità lato client della [modalità veloce](/docs/it/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways), per i proxy che intercettano la richiesta del controllo anziché rifiutarla. L'API rifiuta comunque le richieste in modalità veloce quando la tua organizzazione ha disattivato la modalità veloce |

394| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry, per un proxy o gateway che inserisce il proprio header `Authorization`. Claude Code invia le richieste senza una credenziale Azure e mantiene l'header `Authorization` che fornisci, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorata quando è impostata `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Prima della v2.1.203, questa variabile rendeva il client Microsoft Foundry incapace di inviare richieste a meno che non fosse impostata anche una chiave API |395| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry, per un proxy o un gateway che inserisce il proprio header `Authorization`. Claude Code invia le richieste senza una credenziale Azure e preserva l'header `Authorization` che fornisci, ad esempio tramite `ANTHROPIC_CUSTOM_HEADERS`. Ignorata quando è impostata `ANTHROPIC_FOUNDRY_API_KEY` o `ANTHROPIC_FOUNDRY_AUTH_TOKEN`. Prima della v2.1.203, questa variabile rendeva il client Microsoft Foundry incapace di inviare richieste a meno che non fosse impostata anche una chiave API |

395| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando usi un gateway LLM) |396| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Amazon Bedrock Mantle (ad esempio, quando usi un gateway LLM) |

396| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | I [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) su [Amazon Bedrock](/docs/it/amazon-bedrock) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) ricordano su questa macchina, per un massimo di un giorno, quali modelli hanno rilevato che il tuo account non può invocare. Imposta su `1` per disattivare questa memoria. Richiede Claude Code v2.1.285 o successiva |397| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | I [controlli dei modelli all'avvio](/docs/it/amazon-bedrock#startup-model-checks) su [Amazon Bedrock](/docs/it/amazon-bedrock) e [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) ricordano su questa macchina, per un massimo di un giorno, quali modelli hanno rilevato che il tuo account non può invocare. Imposta su `1` per disattivare questa memoria. Richiede Claude Code v2.1.285 o successiva |

397| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta su `1` per non scrivere su disco la cronologia dei prompt e le trascrizioni delle sessioni. Le sessioni avviate con questa variabile impostata non compaiono in `--resume`, `--continue` né nella cronologia con la freccia su. Utile per sessioni effimere gestite da script |398| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta su `1` per non scrivere su disco la cronologia dei prompt e le trascrizioni delle sessioni. Le sessioni avviate con questa variabile impostata non compaiono in `--resume`, `--continue` né nella cronologia con freccia su. Utile per sessioni effimere tramite script |

398| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Google Cloud's Agent Platform (ad esempio, quando usi un gateway LLM) |399| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Google Cloud's Agent Platform (ad esempio, quando usi un gateway LLM) |

399| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Imposta su `1` affinché una sessione avviata con `--output-format stream-json` scriva un [messaggio di risultato che indica il motivo per cui Claude Code si è rifiutato di avviarsi](/docs/it/agent-sdk/typescript#startup_failure_reason) per gli errori di avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successiva |400| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | Imposta su `1` per fare in modo che una sessione avviata con `--output-format stream-json` scriva un [messaggio di risultato che indica perché Claude Code si è rifiutato di avviarsi](/docs/it/agent-sdk/typescript#startup_failure_reason) per i fallimenti all'avvio che altrimenti terminano solo con stderr. Richiede Claude Code v2.1.274 o successiva |

400| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive in cui un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può impedire la fine del turno prima che Claude Code lo sovrascriva e termini comunque il turno (predefinito: 8). Imposta su `0` per disabilitare il limite. Aumentalo se il tuo hook ha legittimamente bisogno di più iterazioni per concludersi |401| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive in cui un hook [Stop](/docs/it/hooks#stop) o [SubagentStop](/docs/it/hooks#subagentstop) può impedire la fine del turno prima che Claude Code lo sovrascriva e termini comunque il turno (predefinito: 8). Imposta su `0` per disattivare il limite. Aumentalo se il tuo hook ha legittimamente bisogno di più iterazioni per risolversi |

401| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i membri dei [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti dei [workflow](/docs/it/workflows) a cui non viene assegnato un modello in altro modo. Accetta un alias come `haiku` o un nome completo di modello. Due fonti hanno la precedenza su di essa: un modello che Claude passa quando genera l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare questo comportamento, imposta [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Consulta [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. Impostarla su `inherit` equivale a lasciarla non impostata. Prima della v2.1.251, questa variabile sovrascriveva sia il modello per invocazione sia il campo `model` della definizione |402| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i membri dei [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti dei [workflow](/docs/it/workflows) a cui non è assegnato un modello in altro modo. Accetta un alias come `haiku` o un nome completo del modello. Due sorgenti hanno la precedenza su di essa: un modello che Claude passa quando avvia l'agente e un campo `model` nella definizione dell'agente, incluso `inherit`. Per cambiare questo comportamento, imposta [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model). Consulta [Scegliere un modello](/docs/it/sub-agents#choose-a-model) per l'ordine completo. Impostarla su `inherit` equivale a lasciarla non impostata. Prima della v2.1.251, questa variabile sovrascriveva sia il modello per invocazione sia il campo `model` della definizione |

402| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Imposta su `1` per forzare un unico modello per subagent, membri del team e agenti dei workflow. [Eseguire ogni subagent su un unico modello](/docs/it/sub-agents#run-every-subagent-on-one-model) indica di quale modello si tratta. Richiede Claude Code v2.1.257 o successiva |403| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | Imposta su `1` per forzare un unico modello su subagent, membri del team e agenti dei workflow. [Eseguire ogni subagent su un unico modello](/docs/it/sub-agents#run-every-subagent-on-one-model) indica quale modello sia. Richiede Claude Code v2.1.257 o successiva |

403| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), workflow e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |404| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori che Claude Code accetta, per scegliere il [TTL della cache dei prompt](/docs/it/prompt-caching#cache-lifetime) per le richieste al di fuori della conversazione principale, come [subagent](/docs/it/sub-agents), workflow e lavoro in background. Ha la precedenza sull'impostazione `subagentPromptCacheTtl` e su `ENABLE_PROMPT_CACHING_1H`, mentre `FORCE_PROMPT_CACHING_5M` la sovrascrive. L'API addebita le scritture nella cache di 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |

404| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta su `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi avviati da Claude Code, come comandi Bash, hook e server MCP stdio. La pulizia riconosce una credenziale dal nome della variabile o dal suo valore, e lascia al loro posto i token GitHub e le impostazioni del proxy. Consulta [Cosa rimuove la pulizia dell'ambiente dei sottoprocessi](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la imposta automaticamente quando è configurato `allowed_non_write_users` |405| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta su `1` per rimuovere le credenziali dagli ambienti dei sottoprocessi avviati da Claude Code, come comandi Bash, hook e server MCP stdio. La pulizia riconosce una credenziale dal nome della variabile o dal suo valore e lascia al loro posto i token GitHub e le impostazioni del proxy. Consulta [Cosa rimuove la pulizia dell'ambiente dei sottoprocessi](#what-the-subprocess-environment-scrub-removes). `claude-code-action` la imposta automaticamente quando è configurato `allowed_non_write_users` |

405| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione dei plugin prima della prima query. Senza di essa, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combinala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |406| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione dei plugin prima della prima query. Senza di essa, i plugin vengono installati in background e potrebbero non essere disponibili al primo turno. Combinala con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |

406| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona dei plugin. Quando viene superato, Claude Code procede senza plugin e registra un errore. Nessun valore predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |407| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona dei plugin. Se viene superato, Claude Code prosegue senza plugin e registra un errore. Nessun valore predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |

407| `CLAUDE_CODE_SYNC_SKILLS` | Imposta su `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi in quell'esecuzione le skill abilitate per il tuo account claude.ai e ne attenda l'elenco, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. Richiede l'autenticazione claude.ai. Le sessioni nel terminale in cui accedi con il tuo account claude.ai [sincronizzano queste skill](/docs/it/skills#where-synced-skills-load) senza questa variabile, quindi impostala solo quando un'esecuzione `-p` ha bisogno delle tue skill attuali alla prima query |408| `CLAUDE_CODE_SYNC_SKILLS` | Imposta su `1` in modalità non interattiva con il flag `-p` per fare in modo che Claude Code scarichi in quell'esecuzione le skill attivate per il tuo account claude.ai e attenda il loro elenco, fino a `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`, prima di eseguire la prima query. Richiede l'autenticazione claude.ai. Le sessioni del terminale in cui accedi con il tuo account claude.ai [sincronizzano queste skill](/docs/it/skills#where-synced-skills-load) senza questa variabile, quindi impostala solo quando un'esecuzione `-p` ha bisogno delle tue skill attuali alla prima query |

408| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per la risincronizzazione delle skill che viene eseguita a metà sessione quando un'app basata sull'[Agent SDK](/docs/it/agent-sdk/typescript#query-object) ricarica le skill (predefinito: 30000). Quando viene superato, il ricaricamento prosegue con le skill già arrivate e i download rimanenti terminano in background |409| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per la nuova sincronizzazione delle skill eseguita a metà sessione quando un'app basata sull'[Agent SDK](/docs/it/agent-sdk/typescript#query-object) ricarica le skill (predefinito: 30000). Se viene superato, il ricaricamento prosegue con le skill già arrivate e i download rimanenti terminano in background |

409| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi per l'attesa dell'elenco iniziale delle skill da parte della prima query quando è impostata `CLAUDE_CODE_SYNC_SKILLS` (predefinito: 5000). Quando viene superato, la prima query viene eseguita con le skill già arrivate. I download terminano comunque in background, e Claude attende il download di una skill quando la invoca |410| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | Timeout in millisecondi per cui la prima query attende l'elenco iniziale delle skill quando è impostata `CLAUDE_CODE_SYNC_SKILLS` (predefinito: 5000). Se viene superato, la prima query viene eseguita con le skill già arrivate. I download terminano comunque in background, e Claude attende il download di una skill quando invoca quella skill |

410| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta su `false` per disabilitare l'evidenziazione della sintassi nell'output dei diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disabilitare l'evidenziazione anche nei blocchi di codice e nelle anteprime dei file, usa l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |411| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta su `false` per disattivare l'evidenziazione della sintassi nell'output dei diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disattivare l'evidenziazione anche nei blocchi di codice e nelle anteprime dei file, usa l'impostazione [`syntaxHighlightingDisabled`](/docs/it/settings-reference#syntaxhighlightingdisabled) |

411| `CLAUDE_CODE_TASK_LIST_ID` | Condivide un elenco di attività tra sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinarti su un elenco di attività condiviso, nelle [sessioni che dispongono degli strumenti Task](/docs/it/tools-reference#task-tool-availability). Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |412| `CLAUDE_CODE_TASK_LIST_ID` | Condivide un elenco di attività tra sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinarti su un elenco di attività condiviso, nelle [sessioni che dispongono degli strumenti Task](/docs/it/tools-reference#task-tool-availability). Consulta [Elenco delle attività](/docs/it/interactive-mode#task-list) |

412| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sovrascrive, in millisecondi, per quanto tempo una sessione non interattiva attende all'uscita che il suo [team di agenti](/docs/it/agent-teams) finisca lo smantellamento. Accetta valori da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successiva |413| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | Sovrascrive, in millisecondi, per quanto tempo una sessione non interattiva attende all'uscita che il suo [team di agenti](/docs/it/agent-teams) finisca lo smantellamento. Accetta valori da 1000 a 60000; un valore fuori intervallo viene ignorato e si applica il valore predefinito di 10000. Richiede Claude Code v2.1.206 o successiva |

413| `CLAUDE_CODE_TMPDIR` | Sovrascrive la directory temporanea usata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` a questo percorso su Unix, oppure `/claude/` su Windows. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash in [sandbox](/docs/it/sandboxing) ricevono un `$TMPDIR` di fallback breve nella directory predefinita di sistema quando la tua sovrascrittura è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash senza sandbox ereditano il `$TMPDIR` della tua shell quando è impostato. Su Windows nativo, quando la tua shell non imposta `$TMPDIR`, un comando Bash che fa riferimento a `$TMPDIR` riceve la tua sovrascrittura, oppure `%TEMP%` se non ne hai impostata una. I file temporanei di Claude Code usano sempre la tua sovrascrittura. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |414| `CLAUDE_CODE_TMPDIR` | Sovrascrive la directory temporanea usata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` a questo percorso su Unix, oppure `/claude/` su Windows. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux e Windows. Su macOS e Linux, i sottoprocessi Bash in [sandbox](/docs/it/sandboxing) ricevono un `$TMPDIR` di fallback breve sotto il valore predefinito di sistema quando il tuo override è un percorso lungo, poiché alcuni strumenti falliscono quando i percorsi temporanei diventano troppo lunghi. I comandi Bash non in sandbox ereditano il `$TMPDIR` della tua shell quando è impostato. Su Windows nativo, quando la tua shell non imposta `$TMPDIR`, un comando Bash che fa riferimento a `$TMPDIR` riceve il tuo override, oppure `%TEMP%` se non ne hai impostato uno. I file temporanei di Claude Code usano sempre il tuo override. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

414| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta su qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **Impostarla su `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare la limitazione a 256 colori. Per impostazione predefinita, Claude Code limita a 256 colori quando `$TMUX` è impostata, perché tmux non lascia passare le sequenze di escape truecolor a meno che non sia configurato per farlo. Impostala dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Consulta [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni di tmux |415| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta su qualsiasi valore non vuoto, come `1`, per consentire l'output truecolor a 24 bit all'interno di tmux. **Impostarla su `0` o `false` consente comunque il truecolor**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare la limitazione a 256 colori. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostata, perché tmux non inoltra le sequenze di escape truecolor a meno che non sia configurato per farlo. Impostala dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Consulta [Configurazione del terminale](/docs/it/terminal-config) per altre impostazioni di tmux |

415| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, imposta un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria degli strumenti](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Imposta `none` per limitare ogni tipo, oppure `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene sotto il limite i comandi degli strumenti Bash, PowerShell e Monitor qualunque cosa tu elenchi. Richiede Claude Code v2.1.246 o successiva |416| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Su Linux e WSL, impostala su un elenco separato da virgole dei tipi di processi che Claude Code [esclude dal limite di memoria degli strumenti](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), come `mcp` o `lsp`. Imposta `none` per limitare ogni tipo, oppure `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Claude Code mantiene i comandi degli strumenti Bash, PowerShell e Monitor sotto il limite indipendentemente da ciò che elenchi. Richiede Claude Code v2.1.246 o successiva |

416| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, imposta una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono usare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e quella dei comandi dello strumento Monitor nella v2.1.246 o successiva. Scrivi la dimensione in cifre semplici, da sola per un numero di byte oppure con un suffisso `K`, `M`, `G` o `T`. Imposta `0` o `off` per disattivare il limite. Una volta che il primo processo avviato da Claude Code ha attivato o disattivato il limite, un valore modificato ha effetto al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva |417| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Su Linux e WSL, impostala su una dimensione come `4G` per [limitare la memoria che i comandi degli strumenti Bash e PowerShell possono usare](/docs/it/tools-reference#memory-limit-on-linux-and-wsl), e dei comandi dello strumento Monitor nella v2.1.246 o successiva. Scrivi la dimensione in cifre semplici, da sole per un numero di byte oppure con un suffisso `K`, `M`, `G` o `T`. Imposta `0` o `off` per disattivare il limite. Una volta che il primo processo avviato da Claude Code ha attivato o disattivato il limite, un valore modificato ha effetto al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successiva |

417| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Imposta su `1` per limitare quanto può crescere il [file di trascrizione](/docs/it/sessions#where-transcripts-are-stored) di una lunga sessione `-p` o dell'Agent SDK. Dopo ogni compattazione, una volta che il file supera i 5 MB, Claude Code rimuove la cronologia precedente a quella compattazione. La ripresa della sessione ripristina la stessa conversazione indipendentemente dal fatto che il file sia stato ridotto. Impostala nell'ambiente da cui avvii Claude Code, poiché un blocco `env` delle impostazioni non può attivarla. Richiede Claude Code v2.1.287 o successiva |418| `CLAUDE_CODE_TRANSCRIPT_LOCAL_GC` | Imposta su `1` per limitare quanto cresce il [file della trascrizione](/docs/it/sessions#where-transcripts-are-stored) di una lunga sessione `-p` o Agent SDK. Dopo ogni compattazione, quando il file supera i 5 MB, Claude Code rimuove la cronologia precedente a quella compattazione. Riprendere la sessione ripristina la stessa conversazione indipendentemente dal fatto che il file sia stato ridotto. Impostala nell'ambiente da cui avvii Claude Code, poiché un blocco `env` delle impostazioni non può attivarla. Richiede Claude Code v2.1.287 o successiva |

418| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un host [Remote Control](/docs/it/remote-control) o SDK, oppure la finestra di approvazione per un [messaggio tra sessioni trattenuto](/docs/it/cross-session-messaging#control-inbound-messages); le richieste di permesso e le domande di `AskUserQuestion` usano flussi propri e non sono regolate da essa. In Claude Code v2.1.236 o successiva, limita anche la [richiesta di consenso per i crediti di utilizzo di Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione in una sessione che potrebbe essere in esecuzione senza supervisione. [Controllare i messaggi in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) e [sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) descrivono le regole complete di scadenza dei messaggi trattenuti, inclusi i casi in cui la scadenza non si applica. Sovrascrive l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disabilita la scadenza |419| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Scadenza in millisecondi prima che Claude Code annulli una finestra di dialogo che inoltra a un client remoto come un host [Remote Control](/docs/it/remote-control) o SDK, oppure la finestra di approvazione per un [messaggio tra sessioni trattenuto](/docs/it/cross-session-messaging#control-inbound-messages); le richieste di permesso e le domande di `AskUserQuestion` usano flussi propri e non sono regolate da questa variabile. Su Claude Code v2.1.236 o successiva, limita inoltre la [richiesta di consenso ai crediti di utilizzo di Fable](/docs/it/model-config#fable-and-usage-credits) a metà sessione in una sessione che potrebbe essere in esecuzione senza presidio. [Controllare i messaggi in ingresso](/docs/it/cross-session-messaging#control-inbound-messages) e [sessioni non interattive](/docs/it/cross-session-messaging#non-interactive-sessions) descrivono le regole complete di scadenza dei messaggi trattenuti, inclusi i casi in cui la scadenza non si applica. Sovrascrive l'impostazione [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry). `0` o un valore negativo disattiva la scadenza |

419| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usa [Claude Platform on AWS](/docs/it/claude-platform-on-aws) |420| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Usa [Claude Platform on AWS](/docs/it/claude-platform-on-aws) |

420| `CLAUDE_CODE_USE_BEDROCK` | Usa [Amazon Bedrock](/docs/it/amazon-bedrock) |421| `CLAUDE_CODE_USE_BEDROCK` | Usa [Amazon Bedrock](/docs/it/amazon-bedrock) |

421| `CLAUDE_CODE_USE_FOUNDRY` | Usa [Microsoft Foundry](/docs/it/microsoft-foundry) |422| `CLAUDE_CODE_USE_FOUNDRY` | Usa [Microsoft Foundry](/docs/it/microsoft-foundry) |

422| `CLAUDE_CODE_USE_MANTLE` | Usa l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |423| `CLAUDE_CODE_USE_MANTLE` | Usa l'[endpoint Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint) di Amazon Bedrock |

423| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta su `1` per rilevare comandi personalizzati, subagent e stili di output usando le API dei file di Node.js invece di ripgrep. Impostala se il binario ripgrep incluso non è disponibile o è bloccato nel tuo ambiente. Non influisce su Grep né sugli strumenti di ricerca dei file |424| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta su `1` per rilevare comandi personalizzati, subagent e stili di output usando le API dei file di Node.js invece di ripgrep. Impostala se il binario ripgrep incluso non è disponibile o è bloccato nel tuo ambiente. Non influisce su Grep né sugli strumenti di ricerca dei file |

424| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento viene abilitato automaticamente; imposta `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; imposta `1` per abilitarlo nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, oppure `0` per disattivarlo. Su Linux, macOS e WSL, imposta `1` per abilitarlo, il che richiede `pwsh` nel tuo `PATH`. Quando è abilitato su Windows, Claude può eseguire i comandi PowerShell in modo nativo invece di passare attraverso Git Bash. Consulta [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |425| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è attivo per impostazione predefinita per gli account claude.ai e Console; imposta `1` per abilitarlo nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, oppure `0` per disattivarlo. Su Linux, macOS e WSL, imposta `1` per abilitarlo, il che richiede `pwsh` nel tuo `PATH`. Quando è abilitato su Windows, Claude può eseguire i comandi PowerShell in modo nativo invece di passare attraverso Git Bash. Consulta [Strumento PowerShell](/docs/it/tools-reference#powershell-tool) |

425| `CLAUDE_CODE_USE_VERTEX` | Usa [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |426| `CLAUDE_CODE_USE_VERTEX` | Usa [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) |

426| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Imposta il numero di millisecondi per cui [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene nella cache la risposta di ciascun URL recuperato. Il valore predefinito è `900000`, ovvero 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra scrittura mantiene il valore predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successivo |427| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | Imposta il numero di millisecondi per cui [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) mantiene nella cache la risposta di ciascun URL recuperato. Il valore predefinito è `900000`, ovvero 15 minuti. Accetta solo cifre semplici; `0`, un decimale o qualsiasi altra scrittura mantiene il valore predefinito. Claude Code legge il valore una volta per avvio, quindi una modifica in un blocco `env` delle impostazioni si applica al successivo avvio di `claude`. Richiede Claude Code v2.1.233 o successivo |

427| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superiore in millisecondi per quanto tempo [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) attende il download di una pagina, inclusi eventuali reindirizzamenti che segue. Un download non completato entro quel tempo fallisce con un errore di scadenza. Il valore predefinito è `300000`, ovvero cinque minuti. Imposta `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra scrittura mantiene il valore predefinito. Richiede Claude Code v2.1.268 o successivo |428| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | Limite superiore in millisecondi del tempo per cui [WebFetch](/docs/it/tools-reference#webfetch-tool-behavior) attende il download di una pagina, inclusi gli eventuali reindirizzamenti che segue. Un download non completato entro quel tempo fallisce con un errore di scadenza. Il valore predefinito è `300000`, ovvero cinque minuti. Imposta `0` per rimuovere il limite. Accetta solo cifre semplici; un decimale o qualsiasi altra scrittura mantiene il valore predefinito. Richiede Claude Code v2.1.268 o successivo |

428| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è impostata su `1`, quanto tempo Claude Code attende prima di ogni promemoria a Claude per controllare i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta una o più attese separate da virgole in secondi interi da `1` a `86400`, come `600` o `600,1800,3600`. Ogni valore è l'attesa prima del promemoria successivo, e l'ultimo valore si ripete. Accetta solo cifre semplici; qualsiasi altro valore o scrittura viene considerato come non impostato. Quando non è impostata, non ci sono promemoria. Richiede Claude Code v2.1.283 o successivo |429| `CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR` | Velocità con cui si ricarica il [limite di WebSearch](/docs/it/tools-reference#session-search-limit) di una sessione, in chiamate all'ora. Il valore predefinito è `100` in una sessione interattiva del terminale. In una sessione [non interattiva](/docs/it/headless) il valore predefinito è `0`, che disattiva la ricarica. Accetta solo cifre semplici; qualsiasi altra scrittura viene considerata come non impostata. Richiede Claude Code v2.1.290 o successivo |

430| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | Quando `CLAUDE_AUTO_BACKGROUND_TASKS` è impostato su `1`, quanto tempo Claude Code attende prima di ogni promemoria a Claude per controllare i [subagent in background](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ancora in esecuzione. Accetta una o più attese separate da virgole, in secondi interi da `1` a `86400`, come `600` o `600,1800,3600`. Ogni valore è l'attesa prima del promemoria successivo, e l'ultimo valore si ripete. Accetta solo cifre semplici; qualsiasi altro valore o scrittura viene considerato come non impostato. Quando non è impostata, non ci sono promemoria. Richiede Claude Code v2.1.283 o successivo |

429| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quanti agenti esegue contemporaneamente una singola esecuzione di un [workflow](/docs/it/workflows), da `1` a `256`. Per impostazione predefinita, un'esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code ha meno CPU disponibili; le chiamate `agent()` in coda attendono uno slot libero. La trascrizione di ogni agente in esecuzione resta nella memoria di Claude Code, quindi valori più alti aumentano l'uso di memoria. Accetta solo cifre semplici; i valori fuori intervallo e le altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successivo |431| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | Quanti agenti esegue contemporaneamente una singola esecuzione di un [workflow](/docs/it/workflows), da `1` a `256`. Per impostazione predefinita, un'esecuzione esegue fino a 16 agenti contemporaneamente, meno quando Claude Code ha meno CPU disponibili; le chiamate `agent()` in coda attendono uno slot libero. La trascrizione di ogni agente in esecuzione resta nella memoria di Claude Code, quindi valori più alti aumentano l'uso di memoria. Accetta solo cifre semplici; i valori fuori intervallo e le altre scritture mantengono il valore predefinito. Richiede Claude Code v2.1.269 o successivo |

430| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superiore in millisecondi per quanto tempo un agente di un [workflow](/docs/it/workflows) attende che inizi la prima risposta di un agente fratello con lo stesso prefisso prima di inviare la propria prima richiesta. Quando un fan-out avvia diversi agenti che condividono un [prefisso della cache del prompt](/docs/it/workflows#prompt-caching-in-a-fan-out), Claude Code trattiene tutti gli agenti tranne il primo fino a questo tempo, in modo che gli altri leggano il prefisso memorizzato nella cache invece di elaborarlo ciascuno senza cache. Valore predefinito `5000`. Imposta `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostata, gli agenti non attendono mai. Richiede Claude Code v2.1.229 o successivo |432| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | Limite superiore in millisecondi del tempo per cui un agente di un [workflow](/docs/it/workflows) attende l'inizio della prima risposta di un agente fratello con lo stesso prefisso prima di inviare la propria prima richiesta. Quando un fan-out avvia diversi agenti che condividono un [prefisso della prompt cache](/docs/it/workflows#prompt-caching-in-a-fan-out), Claude Code trattiene tutti gli agenti tranne il primo fino a questo tempo, in modo che gli altri leggano il prefisso memorizzato nella cache invece di elaborarlo ciascuno senza cache. Valore predefinito `5000`. Imposta `0` per disabilitare l'attesa. Quando `DISABLE_PROMPT_CACHING` è impostato, gli agenti non attendono mai. Richiede Claude Code v2.1.229 o successivo |

431| `CLAUDE_CONFIG_DIR` | Sovrascrive la directory di configurazione (predefinita: `~/.claude`). Tutte le impostazioni, la cronologia delle sessioni e i plugin sono archiviati in questo percorso. Per le credenziali, consulta [dove Claude Code archivia le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account in parallelo: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. In un file di impostazioni, scrivi il [percorso assoluto](#in-settings-files). Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |433| `CLAUDE_CONFIG_DIR` | Sovrascrive la directory di configurazione (predefinita: `~/.claude`). Tutte le impostazioni, la cronologia delle sessioni e i plugin sono archiviati in questo percorso. Per le credenziali, consulta [dove Claude Code archivia le credenziali](/docs/it/authentication#credential-management). Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. In un file di impostazioni, scrivi il [percorso assoluto](#in-settings-files). Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

432| `CLAUDE_DISABLE_ADOPT` | Imposta `1` per interrompere il lavoro in background in corso invece di trasferirlo quando metti una sessione in background premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code ti chiede conferma prima di passare in background, quindi interrompe le attività che altrimenti verrebbero trasferite. Richiede Claude Code v2.1.195 o successivo |434| `CLAUDE_DISABLE_ADOPT` | Imposta `1` per interrompere il lavoro in background in corso invece di trasferirlo quando metti una sessione in background premendo `←` o con [`/background`](/docs/it/agent-view#from-inside-a-session). Claude Code ti chiede di confermare prima di mettere in background, quindi interrompe le attività che altrimenti verrebbero trasferite. Richiede Claude Code v2.1.195 o successivo |

433| `CLAUDE_EFFORT` | Impostata automaticamente nei sottoprocessi dello strumento Bash e nei comandi degli hook sul [livello di sforzo](/docs/it/model-config#adjust-effort-level) in vigore all'avvio del sottoprocesso: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostata solo quando il modello corrente supporta il parametro effort |435| `CLAUDE_EFFORT` | Impostata automaticamente nei sottoprocessi dello strumento Bash e nei comandi degli hook al [livello di sforzo](/docs/it/model-config#adjust-effort-level) in vigore all'avvio del sottoprocesso: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/docs/it/hooks). Impostata solo quando il modello corrente supporta il parametro effort |

434| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta `1` per forzare l'abilitazione del watchdog di inattività dello streaming a livello di byte, oppure `0` per forzarne la disabilitazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui tale scadenza è attiva. Quando non è impostata, il watchdog è abilitato per impostazione predefinita per le connessioni dirette all'API Anthropic e a [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming sulle connessioni tramite [gateway](/docs/it/gateways) raggiunte attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non era attivo su quelle connessioni tramite gateway, quindi il watchdog a livello di evento poteva segnalare uno stallo anche mentre arrivavano i ping keep-alive. Per i timeout e il modo in cui i timer interagiscono, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |436| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta `1` per forzare l'abilitazione del watchdog di inattività dello streaming a livello di byte, oppure `0` per forzarne la disabilitazione. `0` disattiva anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle connessioni in cui tale scadenza è attiva. Quando non è impostata, il watchdog è abilitato per impostazione predefinita per le connessioni dirette all'API Anthropic e a [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e per le risposte in streaming sulle connessioni tramite [gateway](/docs/it/gateways) raggiunte attraverso `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL`; prima della v2.1.222 non era attivo su quelle connessioni tramite gateway, quindi il watchdog a livello di evento poteva segnalare uno stallo anche mentre arrivavano ping di keep-alive. Per i timeout e l'interazione tra i timer, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

435| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Imposta `1` per abilitare il watchdog di inattività dello streaming a livello di byte sulle risposte Amazon Bedrock `vnd.amazon.eventstream`, il che abilita anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste in streaming Bedrock. Disattivato per impostazione predefinita. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |437| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Imposta `1` per abilitare il watchdog di inattività dello streaming a livello di byte sulle risposte `vnd.amazon.eventstream` di Amazon Bedrock, il che abilita anche la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs) sulle richieste in streaming di Bedrock. Disattivato per impostazione predefinita. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

436| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta `0` per forzare la disabilitazione del watchdog di inattività dello streaming a livello di evento, oppure `1` per forzarne l'abilitazione. Quando non è impostata, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il valore predefinito in assenza di impostazione era controllato dal server sull'API Anthropic diretta e disattivato sugli altri provider. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che funzionano insieme a questo, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |438| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta `0` per forzare la disabilitazione del watchdog di inattività dello streaming a livello di evento, oppure `1` per forzarne l'abilitazione. Quando non è impostata, il watchdog è attivo per impostazione predefinita per tutti i provider. Prima della v2.1.196, il valore predefinito in assenza di impostazione era controllato dal server sull'API Anthropic diretta e disattivato sugli altri provider. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`; per gli altri timer di stallo che operano insieme a questo, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

437| `CLAUDE_ENV_FILE` | Percorso di uno script di shell il cui contenuto Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, così che gli export nel file siano visibili al comando. Usala per mantenere l'attivazione di virtualenv o conda tra i comandi. Viene anche popolata dinamicamente dagli hook [SessionStart](/docs/it/hooks#persist-environment-variables), [Setup](/docs/it/hooks#setup), [CwdChanged](/docs/it/hooks#cwdchanged) e [FileChanged](/docs/it/hooks#filechanged) |439| `CLAUDE_ENV_FILE` | Percorso di uno script di shell il cui contenuto Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Usala per mantenere l'attivazione di virtualenv o conda tra i comandi. Viene anche popolata dinamicamente dagli hook [SessionStart](/docs/it/hooks#persist-environment-variables), [Setup](/docs/it/hooks#setup), [CwdChanged](/docs/it/hooks#cwdchanged) e [FileChanged](/docs/it/hooks#filechanged) |

438| `CLAUDE_JOB_DIR` | Impostata da Claude Code in ogni [sessione in background](/docs/it/agent-view) sulla directory `~/.claude/jobs/<id>` di quella sessione. I comandi di shell eseguiti dalla sessione la ereditano. Scrivi i file temporanei in [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` e `Edit` di Claude in quella posizione non chiedono il permesso, e la directory viene rimossa quando la sessione viene eliminata |440| `CLAUDE_JOB_DIR` | Impostata da Claude Code in ogni [sessione in background](/docs/it/agent-view) sulla directory `~/.claude/jobs/<id>` di quella sessione. I comandi di shell eseguiti dalla sessione la ereditano. Scrivi i file temporanei in [`$CLAUDE_JOB_DIR/tmp`](/docs/it/agent-view#where-state-is-stored). Le chiamate `Write` ed `Edit` di Claude in quella posizione non richiedono permessi, e la directory viene rimossa quando la sessione viene eliminata |

439| `CLAUDE_PID` | Claude Code la imposta sul proprio ID di processo nei sottoprocessi che avvia: i comandi degli strumenti Bash e PowerShell e i comandi degli hook. Su Linux, l'integrazione della shell dello strumento Bash la usa per rifiutare un pattern `pkill` che corrisponderebbe al processo stesso di Claude Code; consulta [il riferimento agli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggila dai tuoi script per identificare o inviare deliberatamente segnali al processo padre di Claude Code. Richiede Claude Code v2.1.214 o successivo |441| `CLAUDE_PID` | Claude Code la imposta sul proprio ID di processo nei sottoprocessi che avvia: comandi degli strumenti Bash e PowerShell e comandi degli hook. Su Linux, l'integrazione con la shell dello strumento Bash la usa per rifiutare un pattern `pkill` che corrisponderebbe al processo stesso di Claude Code; consulta [il riferimento agli errori](/docs/it/errors#pkill-pattern-matches-the-claude-code-process). Leggila dai tuoi script per identificare o inviare deliberatamente segnali al processo padre di Claude Code. Richiede Claude Code v2.1.214 o successivo |

440| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Il valore predefinito è l'hostname della tua macchina, che produce nomi come `myhost-graceful-unicorn`. Il flag della CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |442| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/docs/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Il valore predefinito è l'hostname della tua macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |

441| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui è attiva la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs). Per come Claude Code la limita, il tempo aggiuntivo che aggiunge per i corpi di richiesta di grandi dimensioni e come sceglie la scadenza quando non la imposti, consulta [No response from API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |443| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | Scadenza in millisecondi per il primo byte di risposta di una richiesta in streaming, sulle connessioni in cui è attiva la [scadenza del primo byte](/docs/it/network-config#streaming-idle-watchdogs). Per come Claude Code la limita, il tempo aggiuntivo che aggiunge per corpi di richiesta di grandi dimensioni e come sceglie la scadenza quando non la imposti, consulta [No response from API](/docs/it/errors#no-response-from-api). Richiede Claude Code v2.1.242 o successivo |

442| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività dello streaming a livello di evento e di byte chiudano una connessione in stallo. Quando imposti esplicitamente questa variabile, il minimo è `300000` (5 minuti); i valori inferiori vengono silenziosamente portati al minimo per assorbire le pause del ragionamento esteso e il buffering dei proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i valori predefiniti di ciascun watchdog in assenza di impostazione, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |444| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che i watchdog di inattività dello streaming a livello di evento e di byte chiudano una connessione in stallo. Quando imposti esplicitamente questa variabile, il minimo è `300000` (5 minuti); i valori inferiori vengono limitati silenziosamente per assorbire le pause di ragionamento esteso e il buffering dei proxy, e il watchdog a livello di byte limita il valore a 30 minuti. `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` ha la precedenza su questa variabile per il watchdog a livello di byte. Per i valori predefiniti di ciascun watchdog in assenza di impostazione, consulta [Watchdog di inattività dello streaming](/docs/it/network-config#streaming-idle-watchdogs) |

443| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimossa nella v2.1.260 e ora non ha alcun effetto. In precedenza limitava, in millisecondi, la durata di esecuzione di un [comando di shell in background](/docs/it/interactive-mode#background-bash-commands) avviato da un [subagent](/docs/it/sub-agents), con un valore predefinito di 60 minuti. Consulta [le regole sulla durata dei comandi in background](/docs/it/tools-reference#background-commands) |445| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | Rimossa nella v2.1.260 e ora senza effetto. In precedenza limitava per quanto tempo poteva essere eseguito un [comando di shell in background](/docs/it/interactive-mode#background-bash-commands) avviato da un [subagent](/docs/it/sub-agents), in millisecondi, con un valore predefinito di 60 minuti. Consulta [le regole sulla durata dei comandi in background](/docs/it/tools-reference#background-commands) |

444| `DEBUG` | Imposta `1` per abilitare la modalità di debug, equivalente all'avvio con [`--debug`](/docs/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, oppure nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori veritieri `1`, `true`, `yes` e `on` abilitano la modalità di debug, quindi pattern di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |446| `DEBUG` | Imposta `1` per abilitare la modalità di debug, equivalente all'avvio con [`--debug`](/docs/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, oppure nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori veri `1`, `true`, `yes` e `on` abilitano la modalità di debug, quindi pattern di namespace come `DEBUG=express:*` impostati per altri strumenti non la attivano |

445| `DISABLE_AUTOUPDATER` | Imposta `1` per disabilitare gli aggiornamenti automatici in background. Il comando manuale `claude update` continua a funzionare. Usa `DISABLE_UPDATES` per bloccare entrambi |447| `DISABLE_AUTOUPDATER` | Imposta `1` per disabilitare gli aggiornamenti automatici in background. Il comando manuale `claude update` funziona ancora. Usa `DISABLE_UPDATES` per bloccare entrambi |

446| `DISABLE_AUTO_COMPACT` | Imposta `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` resta disponibile. Usala quando vuoi un controllo esplicito su quando avviene la compattazione. Sovrascrive l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |448| `DISABLE_AUTO_COMPACT` | Imposta `1` per disabilitare la compattazione automatica quando ci si avvicina al limite di contesto. Il comando manuale `/compact` resta disponibile. Usala quando vuoi un controllo esplicito su quando avviene la compattazione. Sovrascrive l'impostazione [`autoCompactEnabled`](/docs/it/settings-reference#autocompactenabled) |

447| `DISABLE_COMPACT` | Imposta `1` per disabilitare tutta la compattazione: sia la compattazione automatica sia il comando manuale `/compact` |449| `DISABLE_COMPACT` | Imposta `1` per disabilitare tutta la compattazione: sia la compattazione automatica sia il comando manuale `/compact` |

448| `DISABLE_COST_WARNINGS` | Imposta `1` per disabilitare i messaggi di avviso sui costi |450| `DISABLE_COST_WARNINGS` | Imposta `1` per disabilitare i messaggi di avviso sui costi |

449| `DISABLE_DOCTOR_COMMAND` | Imposta `1` per nascondere la skill di controllo della configurazione [`/doctor`](/docs/it/commands#all-commands) e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire la diagnostica della configurazione da una sessione. Non influisce sul comando da terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva il comando della schermata di diagnostica `/doctor` |451| `DISABLE_DOCTOR_COMMAND` | Imposta `1` per nascondere la skill di controllo della configurazione [`/doctor`](/docs/it/commands#all-commands) e il suo alias `/checkup`. Utile per le distribuzioni gestite in cui gli utenti non dovrebbero eseguire la diagnostica della configurazione da una sessione. Non influisce sul comando di terminale `claude doctor`. Prima della v2.1.205, questa variabile nascondeva il comando della schermata di diagnostica `/doctor` |

450| `DISABLE_ERROR_REPORTING` | Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la segnalazione degli errori |452| `DISABLE_ERROR_REPORTING` | Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la segnalazione degli errori. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la segnalazione degli errori |

451| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit |453| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i rate limit |

452| `DISABLE_FEEDBACK_COMMAND` | Imposta `1` per disabilitare il comando `/feedback` e il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior). Disabilita anche `/bug` e `/share`, che inviano le segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando veniva disabilitato con tutti i nomi. È accettato anche il nome precedente `DISABLE_BUG_COMMAND` |454| `DISABLE_FEEDBACK_COMMAND` | Imposta `1` per disabilitare il comando `/feedback` e il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior). Disabilita anche `/bug` e `/share`, che inviano segnalazioni attraverso lo stesso percorso; prima della v2.1.212 erano alias di `/feedback`, quindi il comando veniva disabilitato con ogni nome. Viene accettato anche il nome precedente `DISABLE_BUG_COMMAND` |

453| `DISABLE_GROWTHBOOK` | Imposta `1` o `true` per disabilitare il recupero dei feature flag di GrowthBook e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). Impostarla su `0` o `false` lascia attivo il recupero. La registrazione degli eventi di telemetria resta attiva a meno che non sia impostata anche `DISABLE_TELEMETRY` |455| `DISABLE_GROWTHBOOK` | Imposta `1` o `true` per disabilitare il recupero dei feature flag di GrowthBook e usare i valori predefiniti del codice per ogni flag. Questo rende non disponibili [Remote Control](/docs/it/remote-control#requirements) e le altre [funzionalità che richiedono il recupero dei feature flag](#features-that-need-feature-flag-fetching). Impostarla su `0` o `false` lascia attivo il recupero. La registrazione degli eventi di telemetria resta attiva a meno che non sia impostata anche `DISABLE_TELEMETRY` |

454| `DISABLE_INSTALLATION_CHECKS` | Imposta `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, poiché può mascherare problemi con le installazioni standard |456| `DISABLE_INSTALLATION_CHECKS` | Imposta `1` per disabilitare gli avvisi di installazione. Usala solo quando gestisci manualmente il percorso di installazione, poiché può nascondere problemi con le installazioni standard |

455| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta `1` per nascondere il comando `/install-github-app`. È già nascosto quando si usano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry) |457| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta `1` per nascondere il comando `/install-github-app`. Già nascosto quando si usano provider di terze parti (Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry) |

456| `DISABLE_INTERLEAVED_THINKING` | Imposta `1` per impedire l'invio dell'header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [ragionamento interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |458| `DISABLE_INTERLEAVED_THINKING` | Imposta `1` per evitare l'invio dell'header beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [ragionamento interlacciato](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

457| `DISABLE_LOGIN_COMMAND` | Imposta `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |459| `DISABLE_LOGIN_COMMAND` | Imposta `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |

458| `DISABLE_LOGOUT_COMMAND` | Imposta `1` per nascondere il comando `/logout` |460| `DISABLE_LOGOUT_COMMAND` | Imposta `1` per nascondere il comando `/logout` |

459| `DISABLE_PROMPT_CACHING` | Imposta `1` per disabilitare il [prompt caching](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello) |461| `DISABLE_PROMPT_CACHING` | Imposta `1` per disabilitare il [prompt caching](/docs/it/prompt-caching#disable-prompt-caching) per tutti i modelli (ha la precedenza sulle impostazioni per modello) |

460| `DISABLE_PROMPT_CACHING_FABLE` | Imposta `1` per disabilitare il prompt caching per i modelli Fable |462| `DISABLE_PROMPT_CACHING_FABLE` | Imposta `1` per disabilitare il prompt caching per i modelli Fable |

461| `DISABLE_PROMPT_CACHING_HAIKU` | Imposta `1` per disabilitare il prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching), ovunque venga eseguito |463| `DISABLE_PROMPT_CACHING_HAIKU` | Imposta `1` per disabilitare il prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching), ovunque venga eseguito |

462| `DISABLE_PROMPT_CACHING_OPUS` | Imposta `1` per disabilitare il prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |464| `DISABLE_PROMPT_CACHING_OPUS` | Imposta `1` per disabilitare il prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

463| `DISABLE_PROMPT_CACHING_SONNET` | Imposta `1` per disabilitare il prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |465| `DISABLE_PROMPT_CACHING_SONNET` | Imposta `1` per disabilitare il prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

464| `DISABLE_TELEMETRY` | Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la telemetria. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi Bash. Disabilita anche il [recupero dei feature flag](#features-that-need-feature-flag-fetching). Consulta [Disattivare la telemetria per la tua organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |466| `DISABLE_TELEMETRY` | Imposta un qualsiasi valore non vuoto, come `1`, per disattivare la telemetria. **Impostarla su `0` o `false` la disattiva comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per riattivare la telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi Bash. Disabilita anche il [recupero dei feature flag](#features-that-need-feature-flag-fetching). Consulta [Disattivare la telemetria per la tua organizzazione](/docs/it/managed-settings#turn-telemetry-off-for-your-organization) |

465| `DISABLE_UPDATES` | Imposta `1` per bloccare tutti gli aggiornamenti, inclusi `claude update` e `claude install` manuali. Più restrittiva di `DISABLE_AUTOUPDATER`. Usala quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non devono aggiornarlo autonomamente |467| `DISABLE_UPDATES` | Imposta `1` per bloccare tutti gli aggiornamenti, inclusi i comandi manuali `claude update` e `claude install`. Più restrittiva di `DISABLE_AUTOUPDATER`. Usala quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non devono aggiornarlo autonomamente |

466| `DISABLE_UPGRADE_COMMAND` | Imposta `1` per nascondere il comando `/upgrade` |468| `DISABLE_UPGRADE_COMMAND` | Imposta `1` per nascondere il comando `/upgrade` |

467| `DO_NOT_TRACK` | Imposta `1` per disattivare la telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, anche sul [recupero dei feature flag](#features-that-need-feature-flag-fetching). Claude Code legge questa variabile come un booleano standard, quindi `0` lascia attiva la telemetria, e la rispetta come convenzione trasversale riconosciuta da molte CLI per sviluppatori |469| `DO_NOT_TRACK` | Imposta `1` per disattivare la telemetria, con lo stesso effetto di `DISABLE_TELEMETRY`, anche sul [recupero dei feature flag](#features-that-need-feature-flag-fetching). Claude Code legge questa variabile come un booleano standard, quindi `0` lascia attiva la telemetria, e la rispetta come convenzione trasversale riconosciuta da molte CLI per sviluppatori |

468| `ENABLE_BETA_TRACING_DETAILED` | Imposta `1`, e imposta `BETA_TRACING_ENDPOINT` sull'endpoint del tuo collector OTLP/HTTP, per attivare il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi di span contenenti dati e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono inoltre che la tua organizzazione sia inclusa nella allowlist della beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |470| `ENABLE_BETA_TRACING_DETAILED` | Imposta `1`, e imposta `BETA_TRACING_ENDPOINT` sull'endpoint del tuo collector OTLP/HTTP, per attivare il [tracing beta dettagliato](/docs/it/monitoring-usage#traces-beta), che aggiunge attributi di span con contenuto e lo span `claude_code.hook`. Le sessioni CLI interattive richiedono inoltre che la tua organizzazione sia inclusa nella allowlist per la beta. Entrambe le variabili vengono ignorate nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env) |

469| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta `false` per impedire a Claude Code di recuperare i [server MCP di claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Abilitata per impostazione predefinita per gli utenti che hanno effettuato l'accesso. Per disabilitarla per progetto o per organizzazione, imposta invece [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |471| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta `false` per impedire a Claude Code di recuperare i [server MCP di claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai). Abilitata per impostazione predefinita per gli utenti che hanno effettuato l'accesso. Per disabilitarla per progetto o per organizzazione, imposta invece [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors) nelle impostazioni |

470| `ENABLE_PROMPT_CACHING_1H` | Imposta `1` per richiedere un [TTL della cache del prompt](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Pensata per gli utenti con chiave API, [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Gli utenti con abbonamento entro l'utilizzo incluso ricevono automaticamente il TTL di 1 ora sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti con abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarla per mantenere il TTL di 1 ora. Le scritture nella cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere invece il TTL per ciascun gruppo di richieste, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |472| `ENABLE_PROMPT_CACHING_1H` | Imposta `1` per richiedere un [TTL della prompt cache](/docs/it/prompt-caching#cache-lifetime) di 1 ora invece dei 5 minuti predefiniti. Pensata per gli utenti con chiave API, [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) e [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Gli utenti con abbonamento entro l'utilizzo incluso ricevono automaticamente il TTL di 1 ora sulla [conversazione principale](/docs/it/prompt-caching#which-ttl-each-request-gets). Gli utenti con abbonamento che attingono ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) possono impostarla per mantenere il TTL di 1 ora. Le scritture nella cache di 1 ora vengono fatturate a una tariffa più alta. Per scegliere invece il TTL per ciascun gruppo di richieste, usa `CLAUDE_CODE_PROMPT_CACHE_TTL` e `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, che hanno la precedenza su questa variabile |

471| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecata. Usa invece `ENABLE_PROMPT_CACHING_1H` |473| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecata. Usa invece `ENABLE_PROMPT_CACHING_1H` |

472| `ENABLE_TOOL_SEARCH` | Controlla [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search). Se non è impostata, Claude Code differisce tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su un deploy di Microsoft Foundry ospitato su Azure e quando `ANTHROPIC_BASE_URL` punta a un host non first-party. `true` differisce sempre e invia l'header beta, tranne su quegli stessi modelli di Agent Platform e deploy di Microsoft Foundry; le richieste falliscono sui proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti rientrano nel 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore impostato da te viene ignorato quando è impostata `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che non impostassi questa variabile su `true` |474| `ENABLE_TOOL_SEARCH` | Controlla [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search). Se non è impostata, Claude Code rinvia tutti gli strumenti MCP per impostazione predefinita. Li carica comunque in anticipo sui modelli di Google Cloud's Agent Platform precedenti alla generazione Claude 4.5, su un deploy di Microsoft Foundry ospitato su Azure, e quando `ANTHROPIC_BASE_URL` punta a un host non proprietario. `true` rinvia sempre e invia l'header beta, tranne su quegli stessi modelli di Agent Platform e deploy di Microsoft Foundry; le richieste falliscono sui proxy che non supportano `tool_reference`. `auto` carica in anticipo quando le definizioni degli strumenti rientrano nel 10% del contesto. `auto:N` imposta una soglia personalizzata, come `auto:5` per il 5%. `false` carica tutti gli strumenti in anticipo. Un valore impostato da te viene ignorato quando è impostata `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`. Prima della v2.1.221, Claude Code disabilitava la ricerca degli strumenti per tutti i modelli su Google Cloud's Agent Platform a meno che questa variabile non fosse impostata su `true` |

473| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta un qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di riprovare in caso di errori di sovraccarico ripetuti per ogni modello quando non è configurato alcun modello di fallback. **Impostarla su `0` o `false` abilita comunque questo comportamento**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare il comportamento predefinito dei nuovi tentativi. Senza di essa, Claude Code smette di riprovare in questo modo sui modelli che riconosce come Opus, Fable o Mythos quando ti autentichi con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) anziché con un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) configurata in caso di errori di sovraccarico ripetuti per qualsiasi modello principale, quindi questa variabile non influisce sul passaggio a un modello di fallback |475| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta un qualsiasi valore non vuoto, come `1`, per fare in modo che Claude Code smetta di riprovare in caso di errori di sovraccarico ripetuti per ogni modello quando non è configurato alcun modello di fallback. **Impostarla su `0` o `false` la abilita comunque**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per ripristinare il comportamento predefinito dei nuovi tentativi. Senza di essa, Claude Code smette di riprovare in questo modo sui modelli che riconosce come modelli Opus, Fable o Mythos quando ti autentichi con una chiave API o un [provider di terze parti](/docs/it/third-party-integrations) anziché con un abbonamento Claude. Su Claude Code v2.1.160 o successivo, Claude Code passa alla [catena di modelli di fallback](/docs/it/model-config#fallback-model-chains) configurata in caso di errori di sovraccarico ripetuti per qualsiasi modello principale, quindi questa variabile non influisce sul passaggio a un modello di fallback |

474| `FORCE_AUTOUPDATE_PLUGINS` | Imposta `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'aggiornamento automatico principale è disabilitato tramite `DISABLE_AUTOUPDATER` |476| `FORCE_AUTOUPDATE_PLUGINS` | Imposta `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'aggiornamento automatico principale è disabilitato tramite `DISABLE_AUTOUPDATER` |

475| `FORCE_HYPERLINK` | Imposta `1` per abilitare i collegamenti ipertestuali OSC 8 cliccabili quando il tuo terminale li supporta ma non viene rilevato automaticamente, oppure `0` per disabilitarli. Quando non è impostata, Claude Code abilita i collegamenti ipertestuali solo quando rileva il supporto del terminale. Claude Code interpreta questo valore come un numero, non come un booleano, quindi un valore come `false`, `no` o `off` abilita i collegamenti ipertestuali anziché disabilitarli. Il [badge della PR o della merge request](/docs/it/interactive-mode#pr-review-status) nel piè di pagina viene visualizzato come collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del terminale, ad esempio tramite SSH. Imposta `0` per visualizzare il badge come testo semplice |477| `FORCE_HYPERLINK` | Imposta `1` per abilitare i collegamenti ipertestuali OSC 8 cliccabili quando il tuo terminale li supporta ma non viene rilevato automaticamente, oppure `0` per disabilitarli. Quando non è impostata, Claude Code abilita i collegamenti ipertestuali solo quando rileva il supporto del terminale. Claude Code interpreta questo valore come un numero, non come un booleano, quindi un valore come `false`, `no` o `off` abilita i collegamenti ipertestuali invece di disabilitarli. Il [badge della PR o della merge request](/docs/it/interactive-mode#pr-review-status) nel piè di pagina viene visualizzato come collegamento ipertestuale anche quando Claude Code non riesce a rilevare il supporto del terminale, ad esempio tramite SSH. Imposta `0` per visualizzare il badge come testo semplice |

476| `FORCE_PROMPT_CACHING_5M` | Imposta `1` per forzare il TTL della cache del prompt di 5 minuti anche quando altrimenti si applicherebbe il TTL di 1 ora. Sovrascrive `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |478| `FORCE_PROMPT_CACHING_5M` | Imposta `1` per forzare il TTL della prompt cache di 5 minuti anche quando altrimenti si applicherebbe il TTL di 1 ora. Sovrascrive `CLAUDE_CODE_PROMPT_CACHE_TTL`, `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`, `ENABLE_PROMPT_CACHING_1H` e le impostazioni `promptCacheTtl` e `subagentPromptCacheTtl` |

477| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |479| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |

478| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |480| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |

479| `IS_DEMO` | Imposta un qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output di `/status`, e salta l'onboarding. **Impostarla su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per disattivarla. Utile quando trasmetti in streaming o registri una sessione |481| `IS_DEMO` | Imposta un qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output di `/status`, e salta l'onboarding. **Impostarla su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; rimuovi la variabile per disattivarla. Utile quando trasmetti in streaming o registri una sessione |

480| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP (predefinito: 25000). Claude Code mostra un avviso quando l'output supera i 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) usano invece quel limite di caratteri per il contenuto testuale, ma il contenuto di immagini di quegli strumenti resta soggetto a questa variabile. Un risultato testuale riuscito più lungo di 50.000 caratteri da uno strumento senza tale annotazione viene [salvato in un file](/docs/it/mcp#mcp-output-limits-and-warnings) indipendentemente da questa variabile |482| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP (predefinito: 25000). Claude Code mostra un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/docs/it/mcp#raise-the-limit-for-a-specific-tool) usano invece quel limite di caratteri per il contenuto testuale, ma il contenuto di immagini di quegli strumenti resta soggetto a questa variabile. Un risultato testuale riuscito più lungo di 50.000 caratteri da uno strumento senza quell'annotazione viene [salvato in un file](/docs/it/mcp#mcp-output-limits-and-warnings) indipendentemente da questa variabile |

481| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto a [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi falliti senza un output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di un [workflow](/docs/it/workflows) non supera la convalida. Il valore predefinito è 5, un primo tentativo più quattro nuovi tentativi |483| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la validazione rispetto a [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi falliti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di un [workflow](/docs/it/workflows) non supera la validazione. Il valore predefinito è 5, un primo tentativo più quattro nuovi tentativi |

482| `MAX_THINKING_TOKENS` | Budget fisso di token per il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token in meno rispetto al numero massimo di token di output della richiesta e mai al di sotto di 1.024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato tale limite. Quando non è impostata e il ragionamento è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono autonomamente la profondità del ragionamento, e gli altri modelli usano il limite. Imposta `0` per disabilitare il ragionamento sull'API Anthropic, tranne su Opus 5.5, Sonnet 5.5, Haiku 5.5 e i modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), `0` omette invece il parametro `thinking`. Con il ragionamento disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Per un valore positivo, Claude Code ignora il numero stesso sui modelli con ragionamento adattivo, tranne quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |484| `MAX_THINKING_TOKENS` | Budget fisso di token per il [ragionamento esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token in meno rispetto al massimo di token di output della richiesta e mai al di sotto di 1.024. Consulta `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non è impostata e il ragionamento è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la propria profondità di ragionamento, e gli altri modelli usano il limite. Imposta `0` per disabilitare il ragionamento sull'API Anthropic, tranne su Opus 5.5, Sonnet 5.5, Haiku 5.5 e i modelli Fable, per i quali il ragionamento non può essere disattivato. Sui [provider di terze parti](/docs/it/third-party-integrations), `0` omette invece il parametro `thinking`. Con il ragionamento disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Per un valore positivo, Claude Code ignora il numero stesso sui modelli con ragionamento adattivo, tranne quando `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |

483| `MCP_CLIENT_SECRET` | Client secret OAuth per i server MCP che richiedono [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita la richiesta interattiva quando aggiungi un server con `--client-secret` |485| `MCP_CLIENT_SECRET` | Client secret OAuth per i server MCP che richiedono [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials). Evita la richiesta interattiva quando aggiungi un server con `--client-secret` |

484| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio attende la connessione dei server MCP prima della prima query. L'avvio MCP non è bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che terminano. Imposta `0` per fare in modo che Claude Code attenda la connessione dei server prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque attendere l'avvio in ogni caso, tranne quando vengono serviti dalla [cache di discovery](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code attende anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passi esplicitamente [`--mcp-config`](/docs/it/cli-reference#cli-flags), l'attesa ha una scadenza più lunga; consulta la voce di quel flag per l'eccezione relativa ai server nella cache |486| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio attende la connessione dei server MCP prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che terminano. Imposta `0` per fare in modo che Claude Code attenda la connessione dei server prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque attendere l'avvio, tranne quando vengono serviti dalla [cache di rilevamento](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code attende inoltre i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passi esplicitamente [`--mcp-config`](/docs/it/cli-reference#cli-flags), l'attesa ha una scadenza più lunga; consulta la voce di quel flag per l'eccezione relativa ai server nella cache |

485| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo l'avvio MCP bloccante attende, in millisecondi, il batch di connessioni prima di acquisire l'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinta da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |487| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo attende l'avvio MCP bloccante, in millisecondi, per il gruppo di connessioni prima di acquisire l'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinta da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |

486| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di discovery MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che hai già usato può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata a uno strumento invece che all'avvio. La cache è disattivata per impostazione predefinita, a meno che un rilascio graduale non l'abbia abilitata per il tuo account. Imposta `1` per attivarla, oppure `0` per mantenerla disattivata anche quando il rilascio l'ha abilitata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo |488| `MCP_DISCOVERY_CACHE` | Attiva o disattiva la [cache di rilevamento MCP](/docs/it/mcp#server-status-detail). Con la cache attiva, un server HTTP o SSE remoto che hai già usato può mostrare lo [stato `cached`](/docs/it/mcp#server-status-detail), e Claude Code lo connette alla sua prima chiamata a uno strumento invece che all'avvio. La cache è disattivata per impostazione predefinita, a meno che un rilascio graduale non l'abbia abilitata per il tuo account. Imposta `1` per attivarla, oppure `0` per mantenerla disattivata anche quando il rilascio l'ha abilitata. Prima della v2.1.238, la cache era attiva per impostazione predefinita. Lo stato `cached` richiede Claude Code v2.1.221 o successivo |

487| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di discovery](/docs/it/mcp#server-status-detail) (predefinita: 14400, ovvero 4 ore). A un avvio in cui la voce è più vecchia di così, Claude Code la scarta e connette il server all'avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il valore predefinito era 86400, ovvero 24 ore, e Claude Code non limitava il valore |489| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | Età massima, in secondi, di una voce della [cache di rilevamento](/docs/it/mcp#server-status-detail) (predefinita: 14400, ovvero 4 ore). A un avvio in cui la voce è più vecchia, Claude Code la scarta e connette il server all'avvio, come fa con la cache disattivata. Claude Code limita il valore a 7 giorni. Prima della v2.1.238, il valore predefinito era 86400, ovvero 24 ore, e Claude Code non limitava il valore |

488| `MCP_DISCOVERY_CACHE_STRIKES` | A un avvio in cui una voce della [cache di discovery](/docs/it/mcp#server-status-detail) è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti consecutivi possono fallire prima che Claude Code scarti la voce e connetta invece il server all'avvio successivo (predefinito: 1). Aumentala se la tua connessione di rete cade occasionalmente, in modo che un singolo aggiornamento fallito non scarti la voce. Richiede Claude Code v2.1.238 o successivo |490| `MCP_DISCOVERY_CACHE_STRIKES` | A un avvio in cui una voce della [cache di rilevamento](/docs/it/mcp#server-status-detail) è più vecchia di `MCP_DISCOVERY_CACHE_TTL_S`, Claude Code la aggiorna in background. Questa variabile imposta quanti aggiornamenti consecutivi possono fallire prima che Claude Code scarti la voce e connetta invece il server all'avvio successivo (predefinito: 1). Aumentala se la tua connessione di rete cade occasionalmente, in modo che un singolo aggiornamento fallito non scarti la voce. Richiede Claude Code v2.1.238 o successivo |

489| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi per cui Claude Code usa una voce della [cache di discovery](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). A un avvio in cui la voce è più vecchia di così, Claude Code la usa comunque ma la aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code invece la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è di 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore |491| `MCP_DISCOVERY_CACHE_TTL_S` | Secondi per cui Claude Code usa una voce della [cache di rilevamento](/docs/it/mcp#server-status-detail) senza aggiornarla (predefinito: 900). A un avvio in cui la voce è più vecchia, Claude Code la usa comunque ma la aggiorna in background. Una volta che la voce è più vecchia di `MCP_DISCOVERY_CACHE_MAX_STALE_S`, Claude Code la scarta. Claude Code limita il valore a `MCP_DISCOVERY_CACHE_MAX_STALE_S`, che è di 4 ore per impostazione predefinita. Prima della v2.1.238, Claude Code non limitava il valore |

490| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando aggiungi un server MCP con [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |492| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando aggiungi un server MCP con [credenziali preconfigurate](/docs/it/mcp#use-pre-configured-oauth-credentials) |

491| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes), indica se Claude Code interroga i server per la revisione del protocollo MCP 2026-07-28. Imposta `auto` per interrogare i server HTTP, connettori claude.ai e stdio, oppure `legacy` per non interrogarne nessuno. Con la variabile non impostata, Claude Code interroga i server descritti in [Runtime client MCP](/docs/it/mcp#mcp-client-runtimes). Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo |493| `MCP_PROTOCOL_NEGOTIATION` | Solo sul [runtime client MCP v2](/docs/it/mcp#mcp-client-runtimes), se Claude Code sonda i server per la revisione del protocollo MCP 2026-07-28. Imposta `auto` per sondare i server HTTP, connettore claude.ai e stdio, oppure `legacy` per non sondarne nessuno. Con la variabile non impostata, Claude Code sonda i server descritti in [Runtime client MCP](/docs/it/mcp#mcp-client-runtimes). Qualsiasi altro valore viene ignorato con un avviso nel log di debug. Richiede Claude Code v2.1.221 o successivo |

492| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |494| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |

493| `MCP_SDK_GENERATION` | Fissa il [runtime client MCP](/docs/it/mcp#mcp-client-runtimes) con cui questo processo si connette ai server MCP: `v1`, basato su MCP TypeScript SDK 1.x, oppure `v2`, basato su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code usa v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 verifica l'issuer che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fa fallire l'accesso con un errore che inizia con `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questo controllo. Se imposti un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo |495| `MCP_SDK_GENERATION` | Fissa il [runtime client MCP](/docs/it/mcp#mcp-client-runtimes) con cui questo processo si connette ai server MCP: `v1`, basato su MCP TypeScript SDK 1.x, oppure `v2`, basato su [MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/). Senza la variabile, Claude Code usa v2, a partire dalle versioni elencate in quella sezione. Su Claude Code v2.1.221 o successivo, il runtime v2 controlla l'issuer che un server OAuth MCP restituisce nella sua risposta di autorizzazione e fa fallire l'accesso con un errore che inizia con `Issuer mismatch in authorization response` quando non corrisponde. Il runtime v1 non esegue questo controllo. Se imposti un valore non riconosciuto, Claude Code lo ignora e scrive un avviso nel log di debug. Claude Code legge il valore una volta per processo. Richiede Claude Code v2.1.218 o successivo |

494| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |496| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |

495| `MCP_TIMEOUT` | Timeout in millisecondi per l'avvio dei server MCP (predefinito: 30000, ovvero 30 secondi) |497| `MCP_TIMEOUT` | Timeout in millisecondi per l'avvio del server MCP (predefinito: 30000, ovvero 30 secondi) |

496| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione degli strumenti MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta scade inoltre dopo 60 secondi per impostazione predefinita; imposta questa variabile, o il `timeout` per server, al di sopra di 60000 per aumentare quel limite per richiesta. Un valore inferiore riduce comunque il timeout complessivo di esecuzione dello strumento ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` la sovrascrive per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra minima di inattività per le chiamate agli strumenti di quel server, così che `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompa mai prima; questa soglia minima richiede Claude Code v2.1.203 o successivo. Per la variabile d'ambiente, i valori inferiori a 1000 vengono portati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |498| `MCP_TOOL_TIMEOUT` | Timeout in millisecondi per l'esecuzione degli strumenti MCP (predefinito: 100000000, circa 28 ore). Per un server HTTP, SSE o connettore claude.ai, ogni richiesta va inoltre in timeout dopo 60 secondi per impostazione predefinita; imposta questa variabile, o il `timeout` per server, sopra 60000 per aumentare quel limite per richiesta. Un valore inferiore accorcia comunque il timeout complessivo di esecuzione dello strumento ma lascia il limite per richiesta a 60 secondi. I server stdio e WebSocket non hanno un timer per richiesta. Un campo `timeout` per server in `.mcp.json` sovrascrive questo valore per quel server. Un `timeout` per server di almeno 1000 imposta anche la finestra minima di inattività per le chiamate agli strumenti di quel server, in modo che `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` non le interrompa mai prima; questa soglia minima richiede Claude Code v2.1.203 o successivo. Per la variabile d'ambiente, i valori inferiori a 1000 vengono portati a un secondo; per il campo per server, i valori inferiori a 1000 vengono ignorati |

497| `NO_PROXY` | Elenco di domini e IP a cui le richieste verranno inviate direttamente, bypassando il proxy |499| `NO_PROXY` | Elenco di domini e IP a cui le richieste verranno inviate direttamente, aggirando il proxy |

498| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard dell'SDK OpenTelemetry sulla lunghezza del valore degli attributi. Claude Code limita gli attributi di telemetria contenenti dati al minore tra questo valore e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, così che il marcatore di troncamento resti entro il limite dell'SDK. Claude Code legge allo stesso modo le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, e il valore impostato più piccolo si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |500| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | Limite standard dell'SDK OpenTelemetry sulla lunghezza dei valori degli attributi. Claude Code limita gli attributi di telemetria con contenuto al minore tra questo e `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH`, in modo che il marcatore di troncamento resti entro il limite dell'SDK. Claude Code legge allo stesso modo le varianti `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` e `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`, e il valore impostato più piccolo si applica a tutti i segnali. Richiede Claude Code v2.1.214 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#common-configuration-variables) |

499| `OTEL_LOG_ASSISTANT_RESPONSES` | Imposta `1` per includere il testo della risposta del modello negli eventi di log OpenTelemetry `assistant_response`. Quando non è impostata, Claude Code usa invece il valore di `OTEL_LOG_USER_PROMPTS`. Imposta `0` per mantenere le risposte oscurate anche quando `OTEL_LOG_USER_PROMPTS` è impostata. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.193 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |501| `OTEL_LOG_ASSISTANT_RESPONSES` | Imposta `1` per includere il testo della risposta del modello negli eventi di log OpenTelemetry `assistant_response`. Quando non è impostata, Claude Code usa invece il valore di `OTEL_LOG_USER_PROMPTS`. Imposta `0` per mantenere le risposte oscurate anche quando `OTEL_LOG_USER_PROMPTS` è impostata. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Richiede Claude Code v2.1.193 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#assistant-response-event) |

500| `OTEL_LOG_MANAGED_SETTINGS` | Imposta `1` per aggiungere le impostazioni gestite oscurate, e un digest SHA-256 delle impostazioni prima dell'oscuramento, agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitata per impostazione predefinita. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite; un valore nelle impostazioni di progetto o locali non la attiva. Richiede Claude Code v2.1.274 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |502| `OTEL_LOG_MANAGED_SETTINGS` | Imposta `1` per aggiungere le impostazioni gestite oscurate, e un digest SHA-256 delle impostazioni prima dell'oscuramento, agli eventi di log OpenTelemetry `managed_settings_resolved`. Disabilitata per impostazione predefinita. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite; un valore nelle impostazioni di progetto o locali non la attiva. Richiede Claude Code v2.1.274 o successivo. Consulta [Monitoraggio](/docs/it/monitoring-usage#managed-settings-resolved-event) |

501| `OTEL_LOG_RAW_API_BODIES` | Emette il JSON delle richieste e delle risposte della Messages API di Anthropic come eventi di log `api_request_body` / `api_response_body`. Imposta `1` per corpi inline troncati al limite di contenuto, oppure `file:<dir>` per scrivere su disco i corpi non troncati ed emettere invece un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitata per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |503| `OTEL_LOG_RAW_API_BODIES` | Emette il JSON delle richieste e delle risposte della Messages API di Anthropic come eventi di log `api_request_body` / `api_response_body`. Imposta `1` per corpi inline troncati al limite di contenuto, oppure `file:<dir>` per scrivere su disco i corpi non troncati ed emettere invece un percorso `body_ref`. `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` configura il limite di contenuto, 60 KB per impostazione predefinita. Disabilitata per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env). Consulta [Monitoraggio](/docs/it/monitoring-usage#api-request-body-event) |

502| `OTEL_LOG_TOOL_CONTENT` | Imposta `1` per includere il contenuto degli strumenti nell'evento di span OpenTelemetry `tool.output`. Gli attributi di span riportano il contenuto degli strumenti in base ai [propri controlli](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracing](/docs/it/monitoring-usage#traces-beta). Disabilitata per impostazione predefinita per proteggere i dati sensibili. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |504| `OTEL_LOG_TOOL_CONTENT` | Imposta `1` per includere il contenuto degli strumenti nell'evento di span OpenTelemetry `tool.output`. Gli attributi di span contengono il contenuto degli strumenti secondo [i propri controlli](/docs/it/monitoring-usage#new-context-gates). Richiede il [tracing](/docs/it/monitoring-usage#traces-beta). Disabilitata per impostazione predefinita per proteggere i dati sensibili. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage#tool-output-span-event) |

503| `OTEL_LOG_TOOL_DETAILS` | Imposta `1` per includere gli argomenti di input degli strumenti; i nomi dei server MCP; i nomi dei workflow creati dagli utenti; le stringhe di errore grezze in caso di errori degli strumenti; la `category` del rifiuto negli eventi `api_refusal`; i nomi reali di agenti, skill, plugin e server MCP nelle [metriche di costo e token](/docs/it/monitoring-usage#cost-counter); e altri dettagli degli strumenti nelle metriche, nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita per proteggere le PII. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |505| `OTEL_LOG_TOOL_DETAILS` | Imposta `1` per includere gli argomenti di input degli strumenti; i nomi dei server MCP; i nomi dei workflow creati dagli utenti; le stringhe di errore grezze in caso di errori degli strumenti; la `category` del rifiuto negli eventi `api_refusal`; i nomi reali di agenti, skill, plugin e server MCP nelle [metriche di costo e token](/docs/it/monitoring-usage#cost-counter); e altri dettagli degli strumenti nelle metriche, nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita per proteggere le PII. Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

504| `OTEL_LOG_USER_PROMPTS` | Imposta `1` per includere il testo dei prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita (i prompt vengono oscurati). Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |506| `OTEL_LOG_USER_PROMPTS` | Imposta `1` per includere il testo dei prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitata per impostazione predefinita (i prompt vengono oscurati). Impostala nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Ignorata nelle [impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

505| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |507| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

506| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Imposta `true` per includere l'entrypoint della sessione negli attributi delle metriche (predefinito: escluso). Aggiunta nella v2.1.152. Consulta [Monitoraggio](/docs/it/monitoring-usage) |508| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | Imposta `true` per includere l'entrypoint della sessione negli attributi delle metriche (predefinito: escluso). Aggiunta nella v2.1.152. Consulta [Monitoraggio](/docs/it/monitoring-usage) |

507| `OTEL_METRICS_INCLUDE_REPOSITORY` | Imposta `true` per contrassegnare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Consulta [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |509| `OTEL_METRICS_INCLUDE_REPOSITORY` | Imposta `true` per contrassegnare le metriche e gli eventi OpenTelemetry con attributi `vcs.*` che identificano il repository della sessione (predefinito: escluso). Richiede Claude Code v2.1.269 o successivo. Consulta [Attributi del repository](/docs/it/monitoring-usage#repository-attributes) |

508| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code associa le chiavi di `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei datapoint delle metriche. Imposta `false` per escluderle (predefinito: incluse). Consulta [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |510| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | A partire dalla v2.1.161, Claude Code associa le chiavi di `OTEL_RESOURCE_ATTRIBUTES` alle etichette dei datapoint delle metriche. Imposta `false` per escluderle (predefinito: incluse). Consulta [Monitoraggio](/docs/it/monitoring-usage#multi-team-organization-support) |

509| `OTEL_METRICS_INCLUDE_SESSION_ID` | Imposta `false` per escludere l'ID di sessione dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |511| `OTEL_METRICS_INCLUDE_SESSION_ID` | Imposta `false` per escludere l'ID della sessione dagli attributi delle metriche (predefinito: incluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

510| `OTEL_METRICS_INCLUDE_VERSION` | Imposta `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |512| `OTEL_METRICS_INCLUDE_VERSION` | Imposta `true` per includere la versione di Claude Code negli attributi delle metriche (predefinito: escluso). Consulta [Monitoraggio](/docs/it/monitoring-usage) |

511| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sovrascrive il budget di caratteri per i metadati delle skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si adatta dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per retrocompatibilità |513| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | Sovrascrive il budget di caratteri per i metadati delle skill mostrati allo [strumento Skill](/docs/it/skills#control-who-invokes-a-skill). Il budget si adatta dinamicamente all'1% della finestra di contesto, con un fallback di 8.000 caratteri. Nome legacy mantenuto per retrocompatibilità |

512| `TASK_MAX_OUTPUT_LENGTH` | Rimossa nella v2.1.277 e ora non ha alcun effetto, insieme allo strumento `TaskOutput` di cui definiva la dimensione. In precedenza impostava il numero massimo di caratteri dell'output di un'[attività in background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` conservava. Claude ora legge invece il file di output di un'attività in background con `Read` |514| `TASK_MAX_OUTPUT_LENGTH` | Rimossa nella v2.1.277 e ora senza effetto, insieme allo strumento `TaskOutput` di cui determinava le dimensioni. In precedenza impostava il numero massimo di caratteri dell'output di un'[attività in background](/docs/it/tools-reference#background-commands) che lo strumento `TaskOutput` conservava. Claude ora legge il file di output di un'attività in background con `Read` |

513| `USE_BUILTIN_RIPGREP` | Imposta `0` per usare `rg` installato nel sistema invece di `rg` incluso in Claude Code |515| `USE_BUILTIN_RIPGREP` | Imposta `0` per usare `rg` installato nel sistema invece di `rg` incluso in Claude Code |

514| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sovrascrive la regione per Claude 3.5 Haiku quando si usa Google Cloud's Agent Platform |516| `VERTEX_REGION_CLAUDE_3_5_HAIKU` | Sovrascrive la regione per Claude 3.5 Haiku quando usi Google Cloud's Agent Platform |

515| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sovrascrive la regione per Claude 3.5 Sonnet quando si usa Google Cloud's Agent Platform |517| `VERTEX_REGION_CLAUDE_3_5_SONNET` | Sovrascrive la regione per Claude 3.5 Sonnet quando usi Google Cloud's Agent Platform |

516| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sovrascrive la regione per Claude 3.7 Sonnet quando si usa Google Cloud's Agent Platform |518| `VERTEX_REGION_CLAUDE_3_7_SONNET` | Sovrascrive la regione per Claude 3.7 Sonnet quando usi Google Cloud's Agent Platform |

517| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sovrascrive la regione per Claude 4.0 Opus quando si usa Google Cloud's Agent Platform |519| `VERTEX_REGION_CLAUDE_4_0_OPUS` | Sovrascrive la regione per Claude 4.0 Opus quando usi Google Cloud's Agent Platform |

518| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sovrascrive la regione per Claude 4.0 Sonnet quando si usa Google Cloud's Agent Platform |520| `VERTEX_REGION_CLAUDE_4_0_SONNET` | Sovrascrive la regione per Claude 4.0 Sonnet quando usi Google Cloud's Agent Platform |

519| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sovrascrive la regione per Claude 4.1 Opus quando si usa Google Cloud's Agent Platform |521| `VERTEX_REGION_CLAUDE_4_1_OPUS` | Sovrascrive la regione per Claude 4.1 Opus quando usi Google Cloud's Agent Platform |

520| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sovrascrive la regione per Claude Opus 4.5 quando si usa Google Cloud's Agent Platform |522| `VERTEX_REGION_CLAUDE_4_5_OPUS` | Sovrascrive la regione per Claude Opus 4.5 quando usi Google Cloud's Agent Platform |

521| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sovrascrive la regione per Claude Sonnet 4.5 quando si usa Google Cloud's Agent Platform |523| `VERTEX_REGION_CLAUDE_4_5_SONNET` | Sovrascrive la regione per Claude Sonnet 4.5 quando usi Google Cloud's Agent Platform |

522| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sovrascrive la regione per Claude Opus 4.6 quando si usa Google Cloud's Agent Platform |524| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Sovrascrive la regione per Claude Opus 4.6 quando usi Google Cloud's Agent Platform |

523| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sovrascrive la regione per Claude Sonnet 4.6 quando si usa Google Cloud's Agent Platform |525| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Sovrascrive la regione per Claude Sonnet 4.6 quando usi Google Cloud's Agent Platform |

524| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sovrascrive la regione per Claude Opus 4.7 quando si usa Google Cloud's Agent Platform |526| `VERTEX_REGION_CLAUDE_4_7_OPUS` | Sovrascrive la regione per Claude Opus 4.7 quando usi Google Cloud's Agent Platform |

525| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sovrascrive la regione per Claude Opus 4.8 quando si usa Google Cloud's Agent Platform |527| `VERTEX_REGION_CLAUDE_4_8_OPUS` | Sovrascrive la regione per Claude Opus 4.8 quando usi Google Cloud's Agent Platform |

526| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sovrascrive la regione per Claude Opus 5.5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.280 |528| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Sovrascrive la regione per Claude Opus 5.5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.280 |

527| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5.5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.284 |529| `VERTEX_REGION_CLAUDE_5_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5.5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.284 |

528| `VERTEX_REGION_CLAUDE_5_OPUS` | Sovrascrive la regione per Claude Opus 5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.219 |530| `VERTEX_REGION_CLAUDE_5_OPUS` | Sovrascrive la regione per Claude Opus 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.219 |

529| `VERTEX_REGION_CLAUDE_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.197 |531| `VERTEX_REGION_CLAUDE_5_SONNET` | Sovrascrive la regione per Claude Sonnet 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.197 |

530| `VERTEX_REGION_CLAUDE_FABLE_5` | Sovrascrive la regione per Claude Fable 5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.170 |532| `VERTEX_REGION_CLAUDE_FABLE_5` | Sovrascrive la regione per Claude Fable 5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.170 |

531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sovrascrive la regione per Claude Fable 5.1 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.257 |533| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Sovrascrive la regione per Claude Fable 5.1 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.257 |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando si usa Google Cloud's Agent Platform |534| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando usi Google Cloud's Agent Platform |

533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sovrascrive la regione per Claude Haiku 5.5 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.293 |535| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Sovrascrive la regione per Claude Haiku 5.5 quando usi Google Cloud's Agent Platform. Aggiunta nella v2.1.293 |

534 536 

535Sono supportate anche le variabili standard degli exporter OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e le varianti specifiche per segnale). Consulta [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.537Sono supportate anche le variabili standard degli exporter OpenTelemetry (`OTEL_METRICS_EXPORTER`, `OTEL_LOGS_EXPORTER`, `OTEL_EXPORTER_OTLP_ENDPOINT`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `OTEL_EXPORTER_OTLP_HEADERS`, `OTEL_METRIC_EXPORT_INTERVAL`, `OTEL_RESOURCE_ATTRIBUTES` e le varianti specifiche per segnale). Consulta [Monitoraggio](/docs/it/monitoring-usage) per i dettagli di configurazione.

536 538 

537Imposta `CLAUDE_CODE_ENABLE_TELEMETRY` e le variabili OpenTelemetry che attivano l'esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code [le ignora nelle impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. `OTEL_RESOURCE_ATTRIBUTES` e le variabili di intervallo di esportazione, timeout e compressione, come `OTEL_METRIC_EXPORT_INTERVAL`, si applicano comunque dalle impostazioni di progetto e locali.539Imposta `CLAUDE_CODE_ENABLE_TELEMETRY` e le variabili OpenTelemetry che attivano l'esportazione, ne scelgono la destinazione o acquisiscono contenuti nella tua shell, nelle impostazioni utente o nelle impostazioni gestite. Claude Code [le ignora nelle impostazioni di progetto e locali](/docs/it/settings-reference#variables-claude-code-ignores-in-env), a parte i valori di disattivazione descritti in quella sezione. `OTEL_RESOURCE_ATTRIBUTES` e le variabili di intervallo, timeout e compressione dell'esportazione, come `OTEL_METRIC_EXPORT_INTERVAL`, si applicano comunque dalle impostazioni di progetto e locali.

538 540 

539<h2 id="what-the-subprocess-environment-scrub-removes">541<h2 id="what-the-subprocess-environment-scrub-removes">

540 Cosa rimuove la pulizia dell'ambiente dei sottoprocessi542 Cosa rimuove la pulizia dell'ambiente dei sottoprocessi


587* Usare [lo strumento advisor](/docs/it/advisor#requirements)589* Usare [lo strumento advisor](/docs/it/advisor#requirements)

588* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)590* Leggere o rispondere ai [commenti su un artefatto](/docs/it/artifacts#collect-comments-on-an-artifact)

589* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](/docs/it/artifacts#read-an-artifact-shared-with-you)591* Far leggere a Claude [l'artefatto pubblico di un'altra organizzazione](/docs/it/artifacts#read-an-artifact-shared-with-you)

590* Far sondare a Claude Code i server dei connettori claude.ai o i server stdio per la [revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes), a meno che tu non imposti `MCP_PROTOCOL_NEGOTIATION=auto`592* Far sondare a Claude Code i server dei connettori claude.ai per la [revisione del protocollo MCP 2026-07-28](/docs/it/mcp#mcp-client-runtimes), a meno che tu non imposti `MCP_PROTOCOL_NEGOTIATION=auto`

591* Ottenere lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) per impostazione predefinita per gli account claude.ai e Console su Windows con Git Bash installato; Claude Code instrada i comandi della shell tramite Git Bash a meno che tu non imposti `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Su Windows senza Git Bash, lo strumento resta attivo593* Ottenere lo [strumento PowerShell](/docs/it/tools-reference#powershell-tool) per impostazione predefinita per gli account claude.ai e Console su Windows con Git Bash installato; Claude Code instrada i comandi della shell tramite Git Bash a meno che tu non imposti `CLAUDE_CODE_USE_POWERSHELL_TOOL=1`. Su Windows senza Git Bash, lo strumento resta attivo

592* Ottenere il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato594* Ottenere il [feedback redatto da Claude](/docs/it/tools-reference#sendfeedback-tool-behavior), che Claude Code attiva tramite un flag recuperato

593* Fare in modo che Claude [tratti i contenuti incollati di grandi dimensioni come testo incollato anziché digitato](/docs/it/terminal-config#how-claude-treats-pasted-text); il contenuto dietro un segnaposto `[Pasted text #N]` raggiunge Claude senza contrassegni595* Fare in modo che Claude [tratti i contenuti incollati di grandi dimensioni come testo incollato anziché digitato](/docs/it/terminal-config#how-claude-treats-pasted-text); il contenuto dietro un segnaposto `[Pasted text #N]` raggiunge Claude senza contrassegni

errors.md +76 −80

Details

725 725 

726In una sessione interattiva con accesso tramite abbonamento claude.ai, Claude Code può anche attendere nella sessione aperta e continuare l'attività interrotta poco dopo il ripristino. Vedi [Wait for a usage limit to reset](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset) per quello che vedi, come avviare o annullare un'attesa e come disattivare la continuazione automatica. Prima della v2.1.234, Claude Code non offriva questa attesa.726In una sessione interattiva con accesso tramite abbonamento claude.ai, Claude Code può anche attendere nella sessione aperta e continuare l'attività interrotta poco dopo il ripristino. Vedi [Wait for a usage limit to reset](/docs/it/interactive-mode#wait-for-a-usage-limit-to-reset) per quello che vedi, come avviare o annullare un'attesa e come disattivare la continuazione automatica. Prima della v2.1.234, Claude Code non offriva questa attesa.

727 727 

728L'utilizzo conta sia per le indennità di sessione che settimanali contemporaneamente. Un singolo picco di attività intensa, come un grande fanout di flusso di lavoro, può esaurire l'indennità settimanale prima che la finestra di sessione si ripristini.728L'utilizzo conta sia per le indennità di sessione che settimanali contemporaneamente. Un singolo picco di attività intensa, come un grande fanout di workflow, può esaurire l'indennità settimanale prima che la finestra di sessione si ripristini.

729 729 

730**Cosa fare:**730**Cosa fare:**

731 731 

732* Attendi l'ora di ripristino mostrata nell'errore732* Attendi l'ora di ripristino mostrata nell'errore

733* Nella scheda Code dell'[app Desktop](/docs/it/desktop), la scheda session-limit offre una casella di controllo **Auto-continue when limits reset**. La scheda weekly-limit non lo fa. Quando è selezionata, l'app Desktop ritenta il turno interrotto dopo il ripristino e mostra l'ora del nuovo tentativo sulla scheda. La casella di controllo Desktop e l'impostazione **Continue automatically at usage limit** della CLI in `/config` sono separate, quindi disattiva ciascuna per conto proprio.733* Nella scheda Code dell'[app Desktop](/docs/it/desktop), la scheda session-limit offre una casella di controllo **Auto-continue when limits reset**. La scheda weekly-limit non lo fa. Quando è selezionata, l'app Desktop riprova il turno interrotto dopo il ripristino e mostra l'ora del nuovo tentativo sulla scheda. La casella di controllo Desktop e l'impostazione **Continue automatically at usage limit** della CLI in `/config` sono separate, quindi disattiva ciascuna per conto proprio.

734* Per il limite Opus o Sonnet, esegui `/model` e passa a un modello al di fuori di quella famiglia per continuare a lavorare. Ogni modello ha la propria cache di prompt, quindi la richiesta successiva rilegge l'intera conversazione senza hit della cache; vedi [Switching models](/docs/it/prompt-caching#switching-models)734* Per il limite Opus o Sonnet, esegui `/model` e passa a un modello al di fuori di quella famiglia per continuare a lavorare. Ogni modello ha la propria cache di prompt, quindi la richiesta successiva rilegge l'intera conversazione senza hit della cache; vedi [Switching models](/docs/it/prompt-caching#switching-models)

735* Esegui `/usage` per vedere i limiti del tuo piano e quando si ripristinano735* Esegui `/usage` per vedere i limiti del tuo piano e quando si ripristinano

736* Esegui `/usage-credits` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al tuo amministratore su Team ed Enterprise. Vedi [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per come viene fatturato.736* Esegui `/usage-credits` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al tuo amministratore su Team ed Enterprise. Vedi [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per come viene fatturato.


767 The prompt to confirm went unanswered767 The prompt to confirm went unanswered

768</h3>768</h3>

769 769 

770Se il tuo account richiede il [consenso per i crediti di utilizzo Fable](/docs/it/model-config#fable-and-usage-credits), Claude Code ti chiede di confermare prima che una richiesta Fable fatturi i crediti di utilizzo. Quando il prompt di consenso si chiude senza che nessuno lo risponda, Claude Code termina il turno con uno di questi messaggi:770Se il tuo account richiede il [consenso per i crediti di utilizzo Fable](/docs/it/model-config#fable-and-usage-credits), Claude Code ti chiede di confermare prima che una richiesta Fable fatturi i crediti di utilizzo. Quando il prompt di consenso si chiude senza che nessuno risponda, Claude Code termina il turno con uno di questi messaggi:

771 771 

772```text theme={null}772```text theme={null}

773Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change773Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change


776 776 

777I messaggi nominano il modello Fable della sessione, quindi su Fable 5 leggono `continuing on Fable 5` e `Fable 5 now uses usage credits`. Prima della v2.1.257, il primo messaggio iniziava `Fable 5 limit reached`.777I messaggi nominano il modello Fable della sessione, quindi su Fable 5 leggono `continuing on Fable 5` e `Fable 5 now uses usage credits`. Prima della v2.1.257, il primo messaggio iniziava `Fable 5 limit reached`.

778 778 

779Questo accade nelle sessioni [Remote Control](/docs/it/remote-control), [sessioni in background](/docs/it/agent-view), [team agente](/docs/it/agent-teams) sessioni compagni, e sessioni che un'altra applicazione ospita tramite Agent SDK. Per quando Claude Code chiude il prompt, vedi [Fable and usage credits](/docs/it/model-config#fable-and-usage-credits).779Questo accade nelle sessioni [Remote Control](/docs/it/remote-control), nelle [sessioni in background](/docs/it/agent-view), nelle sessioni dei membri di un [team di agenti](/docs/it/agent-teams) e nelle sessioni che un'altra applicazione ospita tramite Agent SDK. Per quando Claude Code chiude il prompt, vedi [Fable and usage credits](/docs/it/model-config#fable-and-usage-credits).

780 780 

781**Cosa fare:**781**Cosa fare:**

782 782 


796API Error: Server is temporarily limiting requests (not your usage limit)796API Error: Server is temporarily limiting requests (not your usage limit)

797```797```

798 798 

799Claude Code distingue questi dalla tua quota di piano per l'assenza delle intestazioni di quota unificata che una vera risposta di limite porta. A partire dalla v2.1.199 questo viene [ritentato automaticamente](#automatic-retries) con backoff prima di essere mostrato, indipendentemente da come ti autentichi. Nelle versioni precedenti, una sessione con accesso tramite abbonamento claude.ai ha fallito il turno alla prima occorrenza; solo le chiavi API e gli accessi Enterprise lo hanno ritentato.799Claude Code distingue questi casi dal limite del tuo piano per l'assenza delle intestazioni di quota unificata che una vera risposta di limite porta. A partire dalla v2.1.199 questo viene [riprovato automaticamente](#automatic-retries) con backoff prima di essere mostrato, indipendentemente da come ti autentichi. Nelle versioni precedenti, una sessione con accesso tramite abbonamento claude.ai faceva fallire il turno alla prima occorrenza; solo gli accessi con chiave API ed Enterprise riprovavano.

800 800 

801**Cosa fare:**801**Cosa fare:**

802 802 


807 Request rejected (429)807 Request rejected (429)

808</h3>808</h3>

809 809 

810Hai raggiunto il limite di velocità configurato per la tua chiave API, il progetto Amazon Bedrock o il progetto Google Cloud.810Hai raggiunto il rate limit configurato per la tua chiave API, il progetto Amazon Bedrock o il progetto Google Cloud.

811 811 

812```text theme={null}812```text theme={null}

813API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.813API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.


819 819 

820**Cosa fare:**820**Cosa fare:**

821 821 

822* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` casuale nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.822* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` dimenticato nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.

823* Controlla la console del tuo provider per i limiti attivi e richiedi un livello più elevato se necessario823* Controlla la console del tuo provider per i limiti attivi e richiedi un livello più elevato se necessario

824* Per le chiavi API Anthropic, vedi il [riferimento ai limiti di velocità](https://platform.claude.com/docs/en/api/rate-limits) per come funzionano i livelli e come impostare i limiti di spesa per workspace824* Per le chiavi API Anthropic, vedi il [riferimento sui rate limit](https://platform.claude.com/docs/en/api/rate-limits) per come funzionano i livelli e come impostare i limiti per workspace

825* Riduci la concorrenza: abbassa [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/it/env-vars), evita di eseguire molti subagenzi paralleli, o passa a un modello più piccolo con `/model` per esecuzioni script ad alto volume825* Riduci la concorrenza: abbassa [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/it/env-vars), evita di eseguire molti subagent in parallelo, o passa a un modello più piccolo con `/model` per esecuzioni script ad alto volume

826 826 

827<h3 id="youve-hit-your-monthly-spend-limit">827<h3 id="youve-hit-your-monthly-spend-limit">

828 You've hit your monthly spend limit828 You've hit your monthly spend limit


831L'utilizzo incluso nel tuo piano non può coprire questa richiesta, e i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) che altrimenti la pagherebbero hanno raggiunto un limite di spesa. Ciò accade quando una delle finestre di utilizzo del tuo piano si è esaurita, o quando la richiesta è una che solo i crediti di utilizzo pagano, come una richiesta a un modello che [fattura ai crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits). Il messaggio nomina il limite che ti ha bloccato. Il testo dopo il `·` dice come aumentare quel limite, e varia in base al tuo piano e se gestisci la fatturazione:831L'utilizzo incluso nel tuo piano non può coprire questa richiesta, e i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) che altrimenti la pagherebbero hanno raggiunto un limite di spesa. Ciò accade quando una delle finestre di utilizzo del tuo piano si è esaurita, o quando la richiesta è una che solo i crediti di utilizzo pagano, come una richiesta a un modello che [fattura ai crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits). Il messaggio nomina il limite che ti ha bloccato. Il testo dopo il `·` dice come aumentare quel limite, e varia in base al tuo piano e se gestisci la fatturazione:

832 832 

833```text theme={null}833```text theme={null}

834You've hit your monthly spend limit · raise it at claude.ai/settings/usage834You've hit your monthly spend limit · raise it at https://claude.ai/settings/usage?from=cc_cli_limit_message

835You've hit your individual spend limit · ask your admin for a higher limit835You've hit your individual spend limit · ask your admin for a higher limit

836You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it836You've hit your org's monthly spend limit · visit https://claude.ai/admin-settings/usage to raise it

837You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage837You've hit your team's shared budget · ask your admin to raise it at https://claude.ai/admin-settings/usage

838You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings838You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

839```839```

840 840 

841`team's shared budget` è un budget in pool che un amministratore ha assegnato a un gruppo a cui appartieni; il messaggio non nomina il gruppo. `channel's monthly spend limit` è il budget del canale Slack in cui viene eseguita la sessione, quindi la tua organizzazione potrebbe ancora avere budget al di fuori di esso.841`team's shared budget` è un budget in pool che un amministratore ha assegnato a un gruppo a cui appartieni; il messaggio non nomina il gruppo. `channel's monthly spend limit` è il budget dell'unico canale Slack in cui viene eseguita la sessione, quindi la tua organizzazione potrebbe ancora avere budget al di fuori di esso.

842 842 

843Quando una delle finestre del tuo piano è quella che si è esaurita, il messaggio dice anche quando quella finestra si ripristina, ad esempio `· your session limit resets 3:45pm`, e l'accesso ritorna allora senza che nessuno aumenti il limite. Nelle organizzazioni con fatturazione basata sull'utilizzo, il messaggio dice `usage limit` al posto di `spend limit`, come in `You've hit your individual usage limit`.843Quando una delle finestre del tuo piano è quella che si è esaurita, il messaggio dice anche quando quella finestra si ripristina, ad esempio `· your session limit resets 3:45pm`, e l'accesso ritorna allora senza che nessuno aumenti il limite. Nelle organizzazioni con fatturazione basata sull'utilizzo, il messaggio dice `usage limit` al posto di `spend limit`, come in `You've hit your individual usage limit`.

844 844 

845Prima della v2.1.239, il messaggio non nominava l'ora di ripristino della finestra del piano. Prima della v2.1.268, il budget in pool di un gruppo produceva il messaggio `individual spend limit` invece di `team's shared budget`.845Se ti connetti tramite un gateway di app Claude e vedi `spend limit reached` minuscolo, quello è invece il limite dell'operatore del gateway; vedi [Spend limit reached](#spend-limit-reached).

846 

847Se ti connetti tramite un gateway di app Claude e vedi `spend limit reached` minuscolo, quello è il limite dell'operatore del gateway invece; vedi [Spend limit reached](#spend-limit-reached).

848 846 

849**Cosa fare:**847**Cosa fare:**

850 848 

851* Su Pro e Max, aumenta il tuo limite di spesa mensile in [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, o esegui `/usage-credits`849* Su Pro e Max, aumenta il tuo limite di spesa mensile in [**Settings > Usage**](https://claude.ai/settings/usage) su claude.ai, o esegui `/usage-credits`

852* Su Team ed Enterprise, aumenta il limite in [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) se gestisci la fatturazione, o chiedi a un amministratore di farlo. `/usage-credits` invia quella richiesta al tuo amministratore per te850* Su Team ed Enterprise, aumenta il limite in [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) se gestisci la fatturazione, o chiedi a un amministratore di farlo. `/usage-credits` invia quella richiesta al tuo amministratore per te

853* Per il limite di un canale, chiedi a un proprietario dell'organizzazione o al manager del canale di aumentarlo su claude.ai. Vedi [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) nella documentazione Claude Tag851* Per il limite di un canale, chiedi a un proprietario dell'organizzazione o al manager del canale di aumentarlo su claude.ai. Vedi [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) nella documentazione Claude Tag

854* Se il messaggio nomina un'ora di ripristino per la finestra del tuo piano, puoi aspettare invece852* Se il messaggio nomina un'ora di ripristino per la finestra del tuo piano, puoi invece aspettare

855* Esegui `/usage` per vedere le finestre del tuo piano e quando ciascuna si ripristina853* Esegui `/usage` per vedere le finestre del tuo piano e quando ciascuna si ripristina

856 854 

857<h3 id="spend-limit-reached">855<h3 id="spend-limit-reached">

858 Spend limit reached856 Spend limit reached

859</h3>857</h3>

860 858 

861Ti connetti tramite un [gateway di app Claude](/docs/it/claude-apps-gateway) e hai superato un [limite di spesa](/docs/it/claude-apps-gateway-spend-limits) impostato dall'operatore del gateway. Il gateway blocca le tue richieste fino a quando il periodo denominato non si ripristina o l'operatore non aumenta il limite. Contrassegna ogni risposta `429` bloccata con `x-should-retry: false`, quindi Claude Code mostra questo messaggio senza ritentare.859Ti connetti tramite un [gateway di app Claude](/docs/it/claude-apps-gateway) e hai superato un [limite di spesa](/docs/it/claude-apps-gateway-spend-limits) impostato dall'operatore del gateway. Il gateway blocca le tue richieste fino a quando il periodo indicato non si ripristina o l'operatore non aumenta il limite. Contrassegna ogni risposta `429` bloccata con `x-should-retry: false`, quindi Claude Code mostra questo messaggio senza riprovare.

862 860 

863```text theme={null}861```text theme={null}

864spend limit reached (daily; resets 2026-08-09 00:00 UTC)862spend limit reached (daily; resets 2026-08-09 00:00 UTC)

865```863```

866 864 

867Il messaggio nomina il periodo del limite e l'ora di ripristino, e quando l'operatore ha configurato un `blocked_message`, le sue istruzioni lo seguono. Prima della v2.1.225, il messaggio leggeva solo `spend limit reached`; un gateway su una versione precedente invia ancora quella forma più breve.865Il messaggio nomina il periodo del limite e l'ora di ripristino, e quando l'operatore ha configurato un `blocked_message`, le sue istruzioni lo seguono. Prima della v2.1.225, il messaggio diceva solo `spend limit reached`; un gateway su una versione precedente invia ancora quella forma più breve.

868 866 

869**Cosa fare:**867**Cosa fare:**

870 868 

871* Attendi l'ora di ripristino che il messaggio nomina, o segui le istruzioni dell'operatore se il messaggio le contiene869* Attendi l'ora di ripristino che il messaggio nomina, o segui le istruzioni dell'operatore se il messaggio le contiene

872* Chiedi al tuo operatore del gateway di aumentare il limite se lo raggiungi regolarmente870* Chiedi al tuo operatore del gateway di aumentare il limite se lo raggiungi regolarmente

873 871 

874Un messaggio correlato, `spend limit unavailable`, significa che il gateway non poteva leggere i suoi record di spesa e ha bloccato la richiesta come precauzione piuttosto che per il tuo limite. Di solito si risolve da solo; se persiste, comunica al tuo operatore del gateway.872Un messaggio correlato, `spend limit unavailable`, significa che il gateway non poteva leggere i suoi record di spesa e ha bloccato la richiesta come precauzione piuttosto che per il tuo limite. Di solito si risolve da solo; se persiste, avvisa il tuo operatore del gateway.

875 873 

876<h3 id="credit-balance-is-too-low">874<h3 id="credit-balance-is-too-low">

877 Credit balance is too low875 Credit balance is too low


887 885 

888* Se hai un piano Pro, Max, Team o Enterprise e vedi questo, esegui `/status` e controlla la riga `API key`. Un `ANTHROPIC_API_KEY` approvato nel tuo ambiente instrada le richieste attraverso quella chiave invece del tuo abbonamento. Annullalo nella shell corrente e rimuovilo dal tuo profilo shell, quindi riavvia `claude`. Esegui `/login` se non hai ancora effettuato l'accesso con il tuo abbonamento.886* Se hai un piano Pro, Max, Team o Enterprise e vedi questo, esegui `/status` e controlla la riga `API key`. Un `ANTHROPIC_API_KEY` approvato nel tuo ambiente instrada le richieste attraverso quella chiave invece del tuo abbonamento. Annullalo nella shell corrente e rimuovilo dal tuo profilo shell, quindi riavvia `claude`. Esegui `/login` se non hai ancora effettuato l'accesso con il tuo abbonamento.

889* Aggiungi crediti su [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considera di abilitare il ricaricamento automatico lì in modo che il saldo si riempia prima di raggiungere lo zero887* Aggiungi crediti su [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), e considera di abilitare il ricaricamento automatico lì in modo che il saldo si riempia prima di raggiungere lo zero

890* Imposta i limiti di spesa per workspace nella Console per evitare che un singolo progetto dreni il saldo dell'organizzazione. Vedi [Manage costs effectively](/docs/it/costs).888* Imposta i limiti di spesa per workspace nella Console per evitare che un singolo progetto esaurisca il saldo dell'organizzazione. Vedi [Manage costs effectively](/docs/it/costs).

891 889 

892<h3 id="could-not-update-your-spend-limit">890<h3 id="could-not-update-your-spend-limit">

893 Could not update your spend limit891 Could not update your spend limit


899Could not update your spend limit: <reason from the server>897Could not update your spend limit: <reason from the server>

900```898```

901 899 

902Quando il server spiega il rifiuto, il messaggio termina con quel motivo, e ritentare lo stesso valore fallisce di nuovo. Quando il fallimento non ha un motivo fornito dal server, come una connessione interrotta, il messaggio legge `Could not update your spend limit. Press Enter to retry.` e ritentare può avere successo. Prima della v2.1.216, Claude Code mostrava la forma generica per ogni fallimento.900Quando il server spiega il rifiuto, il messaggio termina con quel motivo, e riprovare con lo stesso valore fallisce di nuovo. Quando il fallimento non ha un motivo fornito dal server, come una connessione interrotta, il messaggio dice `Could not update your spend limit. Press Enter to retry.` e riprovare può avere successo. Prima della v2.1.216, Claude Code mostrava la forma generica per ogni fallimento.

903 901 

904**Cosa fare:**902**Cosa fare:**

905 903 

906* Se il messaggio include un motivo, scegli un limite che lo soddisfi, come un importo inferiore904* Se il messaggio include un motivo, scegli un limite che lo soddisfi, come un importo inferiore

907* Se il messaggio mostra solo la forma generica, ritenta; il fallimento potrebbe essere transitorio905* Se il messaggio mostra solo la forma generica, riprova; il fallimento potrebbe essere transitorio

908* Se la modifica continua a fallire, effettuala dalle tue [impostazioni di fatturazione claude.ai](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) nel browser invece906* Se la modifica continua a fallire, effettuala invece dalle tue [impostazioni di fatturazione claude.ai](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) nel browser

909 907 

910<h2 id="authentication-errors">908<h2 id="authentication-errors">

911 Errori di autenticazione909 Errori di autenticazione


2861 2859 

2862Se il messaggio include la riga `` Details: `[reasoning_extraction]` ``, vedi [Le misure di protezione hanno segnalato una richiesta del ragionamento di Claude](#safeguards-flagged-a-request-for-claudes-reasoning).2860Se il messaggio include la riga `` Details: `[reasoning_extraction]` ``, vedi [Le misure di protezione hanno segnalato una richiesta del ragionamento di Claude](#safeguards-flagged-a-request-for-claudes-reasoning).

2863 2861 

2864Il messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede l'accesso per il lavoro di cibersicurezza legittimo. Su Opus 5.5 e Sonnet 5.5, il messaggio si apre invece con `<model>'s safeguards flagged this session`. Quando la categoria contrassegnata ha un modello di fallback disponibile, Claude Code [cambia modelli](/docs/it/model-config#automatic-model-fallback) piuttosto che mostrare questo errore.2862Questo messaggio si collega al [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), che concede l'accesso per il lavoro di cibersicurezza legittimo. I modelli con [fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) mostrano un messaggio diverso, senza questo link; su Opus 5.5 e Sonnet 5.5 si apre con `<model>'s safeguards flagged this session`. Quella sezione spiega anche quando Claude Code cambia invece modello.

2865 2863 

2866Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), e [Microsoft Foundry](/docs/it/microsoft-foundry), un flag di cibersicurezza produce invece il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal).2864Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), e [Microsoft Foundry](/docs/it/microsoft-foundry), un flag di cibersicurezza produce invece il messaggio di [rifiuto della politica di utilizzo](#usage-policy-refusal).

2867 2865 


4747 4745 

4748I comandi che aprono una finestra di dialogo interattiva non possono farlo mentre nessun terminale è collegato a una sessione in background. `/install-github-app`, l'elenco delle impostazioni `/mcp` e le azioni di autenticazione nel menu del server MCP rispondono con un messaggio. Per `/install-github-app` e l'elenco delle impostazioni `/mcp`, la sessione appare anche sotto **Needs input** nella [vista agente](/docs/it/agent-view) in modo che tu possa trovarla, collegarti ed eseguire di nuovo il comando. Mentre un terminale è collegato, questi comandi funzionano normalmente.4746I comandi che aprono una finestra di dialogo interattiva non possono farlo mentre nessun terminale è collegato a una sessione in background. `/install-github-app`, l'elenco delle impostazioni `/mcp` e le azioni di autenticazione nel menu del server MCP rispondono con un messaggio. Per `/install-github-app` e l'elenco delle impostazioni `/mcp`, la sessione appare anche sotto **Needs input** nella [vista agente](/docs/it/agent-view) in modo che tu possa trovarla, collegarti ed eseguire di nuovo il comando. Mentre un terminale è collegato, questi comandi funzionano normalmente.

4749 4747 

4750Prima della v2.1.216, la sessione non appariva sotto **Needs input** dopo il rifiuto di `/install-github-app` o dell'elenco delle impostazioni `/mcp`. Nella v2.1.213 attraverso v2.1.215, i comandi funzionavano ancora mentre un terminale era collegato, e il messaggio di rifiuto ti diceva di collegarti ed eseguire di nuovo il comando. Dalla v2.1.208 attraverso v2.1.212, Claude Code li rifiutava anche mentre un terminale era collegato, con un messaggio come `Can't open MCP settings in a background session`; su quelle versioni, esegui il comando da una sessione `claude` regolare invece, o esegui l'upgrade. Prima della v2.1.208, aprivano la loro finestra di dialogo all'interno della sessione in background. Solo nella v2.1.208, Claude Code ha anche rifiutato il selettore `/model` in una sessione in background, e `/upgrade` ha stampato l'URL di upgrade invece di aprire un browser.4748Prima della v2.1.216, la sessione non appariva sotto **Needs input** dopo il rifiuto di `/install-github-app` o dell'elenco delle impostazioni `/mcp`. Dalla v2.1.213 alla v2.1.215, i comandi funzionavano ancora mentre un terminale era collegato, e il messaggio di rifiuto ti diceva di collegarti ed eseguire di nuovo il comando. Dalla v2.1.208 alla v2.1.212, Claude Code li rifiutava anche mentre un terminale era collegato, con un messaggio come `Can't open MCP settings in a background session`; su quelle versioni, esegui invece il comando da una normale sessione `claude`, o esegui l'upgrade. Prima della v2.1.208, aprivano la loro finestra di dialogo all'interno della sessione in background. Solo nella v2.1.208, Claude Code ha anche rifiutato il selettore `/model` in una sessione in background, e `/upgrade` ha stampato l'URL di upgrade invece di aprire un browser.

4751 4749 

4752La formulazione nomina il comando. L'elenco delle impostazioni `/mcp` riporta:4750La formulazione nomina il comando. L'elenco delle impostazioni `/mcp` riporta:

4753 4751 


4802* Il comando punta git al checkout principale.4800* Il comando punta git al checkout principale.

4803* Claude Code non può verificare dal testo del comando che qualsiasi git che il comando esegue rimanga all'interno del worktree. Un comando che non nomina mai git può comunque essere rifiutato per questo motivo, perché espandere un'indirezione di variabile come `${!name}` o eseguire una sostituzione di funzione Bash come `${ command; }` produce un valore in fase di esecuzione che può essere esso stesso un comando.4801* Claude Code non può verificare dal testo del comando che qualsiasi git che il comando esegue rimanga all'interno del worktree. Un comando che non nomina mai git può comunque essere rifiutato per questo motivo, perché espandere un'indirezione di variabile come `${!name}` o eseguire una sostituzione di funzione Bash come `${ command; }` produce un valore in fase di esecuzione che può essere esso stesso un comando.

4804 4802 

4805Il mezzo del messaggio nomina cosa non poteva essere verificato:4803La parte centrale del messaggio nomina cosa non poteva essere verificato:

4806 4804 

4807```text wrap theme={null}4805```text wrap theme={null}

4808This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.4806This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.


4815* Per agire sul checkout principale di proposito, esegui il comando tu stesso in un terminale al di fuori della sessione4813* Per agire sul checkout principale di proposito, esegui il comando tu stesso in un terminale al di fuori della sessione

4816 4814 

4817<h3 id="this-session-has-no-saved-transcript">4815<h3 id="this-session-has-no-saved-transcript">

4818 Questa sessione non ha una trascrizione salvata4816 This session has no saved transcript

4819</h3>4817</h3>

4820 4818 

4821Hai collegato una [sessione in background](/docs/it/agent-view) interrotta che è stata messa in background da un'altra conversazione con `←` o `/background` e interrotta prima che la sua prima risposta finisse. Fino a quando quella prima risposta non finisce, la conversazione vive ancora solo nella sessione da cui è stata messa in background, quindi `claude attach` rifiuta di avviare la sessione interrotta piuttosto che iniziare una conversazione vuota con lo stesso ID di sessione. Il messaggio termina con il comando `claude respawn` per questa sessione:4819Ti sei collegato a una [sessione in background](/docs/it/agent-view) interrotta che è stata messa in background da un'altra conversazione con `←` o `/background` e interrotta prima che la sua prima risposta finisse. Fino a quando quella prima risposta non finisce, la conversazione vive ancora solo nella sessione da cui è stata messa in background, quindi `claude attach` rifiuta di avviare la sessione interrotta piuttosto che iniziare una conversazione vuota con lo stesso ID di sessione. Il messaggio termina con il comando `claude respawn` per questa sessione:

4822 4820 

4823```text theme={null}4821```text theme={null}

4824This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4822This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.

4825```4823```

4826 4824 

4827Aprire la stessa riga della sessione nella [vista agente](/docs/it/agent-view) mostra `Press enter again to restart this session fresh` sotto l'elenco invece, e un secondo `Enter` sulla riga riavvia la sessione con una conversazione vuota. Prima della v2.1.212, aprire la riga mostrava il messaggio di rifiuto senza modo di riavviare dalla vista agente. Prima della v2.1.211, aprire la sessione interrotta avviava silenziosamente quella conversazione vuota e poteva rieseguire il prompt originale della sessione.4825Aprire la stessa riga della sessione nella [vista agente](/docs/it/agent-view) mostra invece `Press enter again to restart this session fresh` sotto l'elenco, e un secondo `Enter` sulla riga riavvia la sessione con una conversazione vuota.

4828 4826 

4829**Cosa fare:**4827**Cosa fare:**

4830 4828 

4831* La conversazione che hai messo in background è intatta: riprendi con [`claude --resume`](/docs/it/sessions) o continua a lavorarci4829* La conversazione che hai messo in background è intatta: riprendila con [`claude --resume`](/docs/it/sessions) o continua a lavorarci

4832* Per avviare la sessione interrotta da zero comunque, esegui `claude respawn <id>` con l'ID dal messaggio, o premi `Enter` due volte sulla sua riga nella vista agente4830* Per avviare comunque da zero la sessione interrotta, esegui `claude respawn <id>` con l'ID dal messaggio, o premi `Enter` due volte sulla sua riga nella vista agente

4833* Se la sessione ha finito una risposta e vedi ancora questo rifiuto su una versione prima della v2.1.214, una cartella illeggibile in `~/.claude/projects` potrebbe far sì che la scansione della trascrizione perda la conversazione salvata; aggiorna alla v2.1.214 o successiva, che tollera le cartelle illeggibili durante la scansione4831* Se la sessione ha finito una risposta e vedi ancora questo rifiuto su una versione precedente alla v2.1.214, una cartella illeggibile in `~/.claude/projects` potrebbe far sì che la scansione della trascrizione perda la conversazione salvata; aggiorna alla v2.1.214 o successiva, che tollera le cartelle illeggibili durante la scansione

4834 4832 

4835<h3 id="this-session-is-running-in-another-terminal">4833<h3 id="this-session-is-running-in-another-terminal">

4836 Questa sessione è in esecuzione in un altro terminale4834 This session is running in another terminal

4837</h3>4835</h3>

4838 4836 

4839Hai aperto la riga di una sessione interrotta nella [vista agente](/docs/it/agent-view), e la sua conversazione salvata è già aperta in un altro processo Claude Code attivo su questa macchina, quindi Claude Code rifiuta di avviare un secondo processo che scriverebbe sulla stessa trascrizione. Quale messaggio vedi dipende da [cosa tiene la conversazione](/docs/it/agent-view#opening-a-session-says-the-conversation-is-already-open):4837Hai aperto la riga di una sessione interrotta nella [vista agente](/docs/it/agent-view), e la sua conversazione salvata è già aperta in un altro processo Claude Code attivo su questa macchina, quindi Claude Code rifiuta di avviare un secondo processo che scriverebbe sulla stessa trascrizione. Quale messaggio vedi dipende da [cosa tiene la conversazione](/docs/it/agent-view#opening-a-session-says-the-conversation-is-already-open):


4846* **`running in another terminal`**: un terminale tiene la conversazione, ad esempio uno in cui l'hai ripresa con `claude --resume` o `/resume`. La riga mostra anche `Open in a terminal`.4844* **`running in another terminal`**: un terminale tiene la conversazione, ad esempio uno in cui l'hai ripresa con `claude --resume` o `/resume`. La riga mostra anche `Open in a terminal`.

4847* **`already open in another running Claude session`**: un altro processo Claude Code non interattivo la tiene, ad esempio un processo [sessione in background](/docs/it/agent-view#the-supervisor-process) per la stessa conversazione che non è ancora uscito.4845* **`already open in another running Claude session`**: un altro processo Claude Code non interattivo la tiene, ad esempio un processo [sessione in background](/docs/it/agent-view#the-supervisor-process) per la stessa conversazione che non è ancora uscito.

4848 4846 

4849Claude Code salva una risposta che hai digitato quando apri la riga e la invia come il prossimo prompt della sessione quando la sessione si avvia di nuovo.

4850 

4851**Cosa fare:**4847**Cosa fare:**

4852 4848 

4853* Continua la conversazione nel processo che l'ha aperta, o esci da quel processo e apri di nuovo la riga4849* Continua la conversazione nel processo che l'ha aperta, o esci da quel processo e apri di nuovo la riga


4855Prima della v2.1.248, esisteva solo il rifiuto `already open in another running Claude session`: una conversazione ripresa in un terminale non contava come aperta, e aprire la riga avviava un secondo processo Claude Code che scriveva sulla stessa conversazione.4851Prima della v2.1.248, esisteva solo il rifiuto `already open in another running Claude session`: una conversazione ripresa in un terminale non contava come aperta, e aprire la riga avviava un secondo processo Claude Code che scriveva sulla stessa conversazione.

4856 4852 

4857<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">4853<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">

4858 La conversazione salvata di questa sessione non è più su disco4854 This session's saved conversation is no longer on disk

4859</h3>4855</h3>

4860 4856 

4861Hai aperto una [sessione in background](/docs/it/agent-view) che è terminata mentre il servizio in background era spento, e la [pulizia della trascrizione](/docs/it/settings-reference#cleanupperioddays) ha da allora rimosso la sua conversazione salvata, ad esempio dopo che la macchina è stata spenta per settimane. Aprire una tale riga normalmente [riprende la sua conversazione salvata](/docs/it/agent-view#sessions-show-as-failed-after-shutdown). Non avendo nulla da riprendere, Claude Code rifiuta piuttosto che rieseguire il prompt originale della sessione senza chiedere:4857Hai aperto una [sessione in background](/docs/it/agent-view) che è terminata mentre il servizio in background era spento, e la [pulizia della trascrizione](/docs/it/settings-reference#cleanupperioddays) ha da allora rimosso la sua conversazione salvata, ad esempio dopo che la macchina è stata spenta per settimane. Aprire una tale riga normalmente [riprende la sua conversazione salvata](/docs/it/agent-view#sessions-show-as-failed-after-shutdown). Non avendo nulla da riprendere, Claude Code rifiuta piuttosto che rieseguire il prompt originale della sessione senza chiedere:


4868 4864 

4869**Cosa fare:**4865**Cosa fare:**

4870 4866 

4871* Esegui `claude rm <id>` per eliminare la riga. Quando uno dei [casi mantenuti](/docs/it/agent-view#what-deleting-a-session-removes) si applica, `claude rm` mantiene la riga e il worktree invece e nomina il motivo4867* Esegui `claude rm <id>` per eliminare la riga. Quando uno dei [casi mantenuti](/docs/it/agent-view#what-deleting-a-session-removes) si applica, `claude rm` mantiene invece la riga e il worktree e nomina il motivo

4872* Per eseguire di nuovo il prompt originale della sessione come una conversazione fresca, esegui `claude respawn <id>`4868* Per eseguire di nuovo il prompt originale della sessione come una conversazione nuova, esegui `claude respawn <id>`

4873 4869 

4874Prima della v2.1.248, aprire una tale riga rieseguiva il prompt originale della sessione invece di rifiutare, tirando un compito di settimane fa in primo piano.4870Prima della v2.1.248, aprire una tale riga rieseguiva il prompt originale della sessione invece di rifiutare, riportando in primo piano un compito vecchio di settimane.

4875 4871 

4876<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">4872<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">

4877 Worktree ha commit che non sono spinti da nessuna parte4873 Worktree has commits that are not pushed anywhere

4878</h3>4874</h3>

4879 4875 

4880Hai provato a eliminare una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) il cui worktree contiene commit che Claude Code non può confermare siano salvati altrove. Claude Code mantiene il worktree e la riga della sessione piuttosto che distruggere i commit senza vederli. `claude rm` nomina il branch e i commit non spinti, e dice come procedere:4876Hai provato a eliminare una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) il cui worktree contiene commit che Claude Code non può confermare siano salvati altrove. Claude Code mantiene il worktree e la riga della sessione piuttosto che distruggere i commit senza che tu li veda. `claude rm` nomina il branch e i commit non inviati con push, e dice come procedere:

4881 4877 

4882```text theme={null}4878```text theme={null}

4883kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”4879kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”


4885 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4881 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef

4886```4882```

4887 4883 

4888Quando Claude Code non può riassumere i commit, la riga di dettaglio legge `The worktree has unpushed commits` invece. Nella [vista agente](/docs/it/agent-view), la riga della sessione mostra `not deleted` con lo stesso motivo.4884Quando Claude Code non può riassumere i commit, la riga di dettaglio riporta invece `The worktree has unpushed commits`. Nella [vista agente](/docs/it/agent-view), la riga della sessione mostra `not deleted` con lo stesso motivo.

4889 4885 

4890I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del branch predefinito del tuo remote `origin`, purché quel branch sia estratto nel tuo checkout principale, la directory del repository stesso piuttosto che un worktree.4886I commit su un remote non bloccano l'eliminazione. Nemmeno i commit sulla copia locale del branch predefinito del tuo remote `origin`, purché quel branch sia estratto nel tuo checkout principale, la directory del repository stesso piuttosto che un worktree.

4891 4887 

4892**Cosa fare:**4888**Cosa fare:**

4893 4889 

4894* Per mantenere i commit, esegui il push del branch del worktree, o esegui il merge nel branch predefinito estratto nel tuo checkout principale, quindi elimina di nuovo la sessione4890* Per mantenere i commit, esegui il push del branch del worktree, o esegui il merge nel branch predefinito estratto nel tuo checkout principale, quindi elimina di nuovo la sessione

4895* Per scartare i commit, esegui il comando `claude rm <id> --discard-unpushed` che il messaggio ha stampato, o premi `Ctrl+X` due volte sulla riga della sessione nella vista agente di nuovo. Questo rimuove la sessione e il worktree insieme al suo branch, ai commit non spinti e a qualsiasi modifica non sottoposta a commit. Se il worktree ha guadagnato un commit dal rifiuto, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato4891* Per scartare i commit, esegui il comando `claude rm <id> --discard-unpushed` che il messaggio ha stampato, o premi di nuovo `Ctrl+X` due volte sulla riga della sessione nella vista agente. Questo rimuove la sessione e il worktree insieme al suo branch, ai commit non inviati con push e a qualsiasi modifica non sottoposta a commit. Se il worktree ha ricevuto un commit dopo il rifiuto, Claude Code lo mantiene di nuovo e mostra lo stato aggiornato

4896* Quando il messaggio dice che il worktree è anche registrato da un'altra sessione terminata, eliminare di nuovo non lo scarta: esegui il push dei commit, quindi elimina di nuovo la sessione4892* Quando il messaggio dice che il worktree è anche registrato da un'altra sessione terminata, eliminare di nuovo non lo scarta: esegui il push dei commit, quindi elimina di nuovo la sessione

4897 4893 

4898Prima della v2.1.268, `claude rm` metteva il riassunto del commit sulla riga `kept` stessa. Quando `claude rm` non poteva riassumere i commit, la riga `kept` leggeva `worktree has commits that are not pushed anywhere` al posto del riassunto.4894Prima della v2.1.268, `claude rm` metteva il riassunto dei commit sulla riga `kept` stessa. Quando `claude rm` non poteva riassumere i commit, la riga `kept` riportava `worktree has commits that are not pushed anywhere` al posto del riassunto.

4899 4895 

4900Prima della v2.1.260, il messaggio non nominava il branch o i commit, e eliminare di nuovo era rifiutato allo stesso modo: eliminare la sessione senza eseguire il push significava rimuovere il worktree tu stesso con `git worktree remove --force <path>`, quindi eseguire di nuovo `claude rm <id>`.4896Prima della v2.1.260, il messaggio non nominava il branch o i commit, ed eliminare di nuovo era rifiutato allo stesso modo: eliminare la sessione senza eseguire il push significava rimuovere il worktree tu stesso con `git worktree remove --force <path>`, quindi eseguire di nuovo `claude rm <id>`.

4901 4897 

4902Prima della v2.1.248, il branch predefinito estratto nel tuo checkout principale non contava: un branch di cui avevi già eseguito il merge lì attivava ancora questo rifiuto fino a quando i suoi commit non raggiungevano un remote.4898Prima della v2.1.248, il branch predefinito estratto nel tuo checkout principale non contava: un branch di cui avevi già eseguito il merge lì attivava ancora questo rifiuto fino a quando i suoi commit non raggiungevano un remote.

4903 4899 

4904<h3 id="terminal-host-process-died">4900<h3 id="terminal-host-process-died">

4905 Il processo host del terminale è morto4901 Terminal host process died

4906</h3>4902</h3>

4907 4903 

4908Ogni [terminale della sessione in background](/docs/it/agent-view) viene eseguito in un processo host sotto il servizio in background, e quel processo è morto mentre il servizio manteneva ancora la sua connessione, quindi la sessione non poteva essere raggiunta.4904Il terminale di ogni [sessione in background](/docs/it/agent-view) viene eseguito in un processo host sotto il servizio in background, e quel processo è morto mentre il servizio manteneva ancora la sua connessione, quindi la sessione non poteva essere raggiunta.

4909 4905 

4910Su Linux e WSL, il servizio in background controlla ogni processo host ogni pochi secondi, contrassegna la sessione come fallita quando il processo è uscito ma la sua connessione al servizio non si è mai chiusa, e mostra il motivo sulla sua riga nella [vista agente](/docs/it/agent-view#read-session-state):4906Su Linux e WSL, il servizio in background controlla ogni processo host ogni pochi secondi, contrassegna la sessione come fallita quando il processo è uscito ma la sua connessione al servizio non si è mai chiusa, e mostra il motivo sulla sua riga nella [vista agente](/docs/it/agent-view#read-session-state):

4911 4907 


4913terminal host process died — press Enter to restart4909terminal host process died — press Enter to restart

4914```4910```

4915 4911 

4916Dalla shell, `claude attach <id>` riavvia una sessione già contrassegnata come fallita per un host morto, e altrimenti stampa il motivo e esce:4912Dalla shell, `claude attach <id>` riavvia una sessione già contrassegnata come fallita per un host morto, e altrimenti stampa il motivo ed esce:

4917 4913 

4918```text theme={null}4914```text theme={null}

4919Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.4915Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.

4920```4916```

4921 4917 

4922La conversazione è salvata comunque.4918La conversazione è salvata in entrambi i casi.

4923 4919 

4924Una riga che esegue un [comando shell](/docs/it/agent-view#run-a-shell-command) invece mostra `terminal host process died — its output is gone; the command was not run again`, e `claude attach` stampa `This command's terminal host process died — its output is gone and the command was not run again`. Claude Code non riesegue mai il comando per te.4920Una riga che esegue un [comando shell](/docs/it/agent-view#run-a-shell-command) mostra invece `terminal host process died — its output is gone; the command was not run again`, e `claude attach` stampa `This command's terminal host process died — its output is gone and the command was not run again`. Claude Code non riesegue mai il comando per te.

4925 4921 

4926**Cosa fare:**4922**Cosa fare:**

4927 4923 


4929* Dalla shell, esegui di nuovo `claude attach <id>`. Claude Code stampa `Session <id>'s terminal host died — restarting it on a fresh one…` e riapre la sessione4925* Dalla shell, esegui di nuovo `claude attach <id>`. Claude Code stampa `Session <id>'s terminal host died — restarting it on a fresh one…` e riapre la sessione

4930* Non puoi riavviare una riga di comando shell in questo modo; invia di nuovo il comando per rieseguirlo4926* Non puoi riavviare una riga di comando shell in questo modo; invia di nuovo il comando per rieseguirlo

4931 4927 

4932Prima della v2.1.247, un processo host morto poteva passare ogni controllo di vitalità che il servizio in background eseguiva, quindi aprire la sessione mostrava `opening… · esc to cancel` indefinitamente e `claude attach <id>` aspettava senza segnalare un errore.4928Prima della v2.1.247, un processo host morto poteva superare ogni controllo di vitalità che il servizio in background eseguiva, quindi aprire la sessione mostrava `opening… · esc to cancel` indefinitamente e `claude attach <id>` aspettava senza segnalare un errore.

4933 4929 

4934<h3 id="session-isnt-responding">4930<h3 id="session-isnt-responding">

4935 La sessione non sta rispondendo4931 Session isn't responding

4936</h3>4932</h3>

4937 4933 

4938Hai aperto una [sessione in background](/docs/it/agent-view) e il servizio in background ha accettato l'apertura, ma nessun output è arrivato per circa dieci secondi, quindi Claude Code conclude che il processo che trasmette il terminale della sessione non può fornire output, e termina il tentativo invece di aspettare.4934Hai aperto una [sessione in background](/docs/it/agent-view) e il servizio in background ha accettato l'apertura, ma nessun output è arrivato per circa dieci secondi, quindi Claude Code conclude che il processo che trasmette il terminale della sessione non può fornire output, e termina il tentativo invece di aspettare.


4943Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).4939Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).

4944```4940```

4945 4941 

4946Dalla shell, `claude attach <id>` stampa il motivo e esce:4942Dalla shell, `claude attach <id>` stampa il motivo ed esce:

4947 4943 

4948```text theme={null}4944```text theme={null}

4949Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).4945Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).

4950```4946```

4951 4947 

4952Claude Code non riavvia mai una riga che esegue un [comando shell](/docs/it/agent-view#run-a-shell-command) per te, perché un riavvio rieseguirebbe il comando.4948Claude Code non riavvia mai per te una riga che esegue un [comando shell](/docs/it/agent-view#run-a-shell-command), perché un riavvio rieseguirebbe il comando.

4953 4949 

4954**Cosa fare:**4950**Cosa fare:**

4955 4951 

4956* Nella vista agente, premi `Enter` sulla stessa riga di nuovo. Claude Code interrompe il processo che non risponde e riavvia la sessione, e la conversazione riprende. Nulla viene interrotto senza quella seconda pressione4952* Nella vista agente, premi di nuovo `Enter` sulla stessa riga. Claude Code interrompe il processo che non risponde e riavvia la sessione, e la conversazione riprende. Nulla viene interrotto senza quella seconda pressione

4957* Dalla shell, esegui `claude stop <id>`, quindi `claude attach <id>`4953* Dalla shell, esegui `claude stop <id>`, quindi `claude attach <id>`

4958* Per una riga di comando shell, premi `Ctrl+X` nella vista agente o esegui `claude stop <id>` per interromperla; invia di nuovo il comando per rieseguirlo4954* Per una riga di comando shell, premi `Ctrl+X` nella vista agente o esegui `claude stop <id>` per interromperla; invia di nuovo il comando per rieseguirlo

4959 4955 

4960<h3 id="session-was-stopped-while-the-respawn-was-in-flight">4956<h3 id="session-was-stopped-while-the-respawn-was-in-flight">

4961 La sessione è stata interrotta mentre il respawn era in volo4957 Session was stopped while the respawn was in flight

4962</h3>4958</h3>

4963 4959 

4964Hai aperto una [sessione in background](/docs/it/agent-view) il cui processo non era in esecuzione, e mentre Claude Code la stava riavviando, un altro processo Claude Code l'ha interrotta, ad esempio `claude stop` in un altro terminale. Claude Code mantiene la sessione interrotta:4960Hai aperto una [sessione in background](/docs/it/agent-view) il cui processo non era in esecuzione, e mentre Claude Code la stava riavviando, un altro processo Claude Code l'ha interrotta, ad esempio `claude stop` in un altro terminale. Claude Code mantiene la sessione interrotta:


4967Session <id> was stopped while the respawn was in flight4963Session <id> was stopped while the respawn was in flight

4968```4964```

4969 4965 

4970Aprire una sessione che hai appena inviato, mentre il suo processo è ancora in avvio, aspetta il processo invece. Prima della v2.1.246, aprirla in quel momento poteva interromperla e mostrare questo messaggio.4966Aprire una sessione che hai appena inviato, mentre il suo processo è ancora in avvio, attende invece il processo. Prima della v2.1.246, aprirla in quel momento poteva interromperla e mostrare questo messaggio.

4971 4967 

4972**Cosa fare:**4968**Cosa fare:**

4973 4969 


4978 Agente della sessione non più disponibile4974 Agente della sessione non più disponibile

4979</h3>4975</h3>

4980 4976 

4981Hai ripreso una sessione che stava eseguendo un [agente personalizzato](/docs/it/sub-agents#invoke-subagents-explicitly), avviato con `--agent` o l'impostazione `agent`, e Claude Code non ha trovato un agente con quel nome. Cerca prima nella directory originale della sessione, quando hai [fiducia in quel workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi nella directory da cui riprendi. La sessione riprende comunque, ma con gli strumenti predefiniti, quindi le restrizioni dello strumento dell'agente non si applicano più:4977Hai ripreso una sessione che stava eseguendo un [agente personalizzato](/docs/it/sub-agents#invoke-subagents-explicitly), avviato con `--agent` o l'impostazione `agent`, e Claude Code non ha trovato un agente con quel nome. Cerca prima nella directory originale della sessione, quando hai [concesso la fiducia a quel workspace](/docs/it/permissions#project-allow-rules-and-workspace-trust), quindi nella directory da cui riprendi. La sessione riprende comunque, ma con gli strumenti predefiniti, quindi le restrizioni sugli strumenti dell'agente non si applicano più:

4982 4978 

4983```text theme={null}4979```text theme={null}

4984This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4980This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.

4985```4981```

4986 4982 

4987L'avviso nomina solo le directory che Claude Code ha cercato, e appare nella conversazione ripresa sia che tu svegli una [sessione in background](/docs/it/agent-view), esegua `/resume` o `claude --resume`, o riprenda in [modalità non interattiva](/docs/it/headless), dove va anche a stderr. Le sessioni che usano `--input-format stream-json` non lo mostrano, perché l'Agent SDK fornisce agenti dopo l'avvio.4983L'avviso nomina solo le directory che Claude Code ha cercato, e appare nella conversazione ripresa sia che tu risvegli una [sessione in background](/docs/it/agent-view), esegua `/resume` o `claude --resume`, o riprenda in [modalità non interattiva](/docs/it/headless), dove va anche a stderr. Le sessioni che usano `--input-format stream-json` non lo mostrano, perché l'Agent SDK fornisce gli agenti dopo l'avvio.

4988 4984 

4989Claude Code non salva il fallback nella sessione, quindi l'avviso si ripete ad ogni ripresa fino a quando non agisci. L'agente `claude` integrato non attiva l'avviso, poiché ripiegare sul set di strumenti predefinito non cambia nulla per esso. Prima della v2.1.216, Claude Code continuava silenziosamente come l'agente predefinito, e la ricerca copriva solo la directory da cui riprendevi, quindi un agente con ambito di progetto era perso ad ogni ripresa da un'altra directory.4985Claude Code non salva il fallback nella sessione, quindi l'avviso si ripete a ogni ripresa finché non intervieni. L'agente `claude` integrato non attiva l'avviso, poiché ripiegare sul set di strumenti predefinito non cambia nulla per esso. Prima della v2.1.216, Claude Code continuava silenziosamente come l'agente predefinito, e la ricerca copriva solo la directory da cui riprendevi, quindi un agente con ambito di progetto andava perso a ogni ripresa da un'altra directory.

4990 4986 

4991**Cosa fare:**4987**Cosa fare:**

4992 4988 

4993* Ricrea il file dell'agente in `.claude/agents/<name>.md` nel progetto della sessione, o in `~/.claude/agents/<name>.md` per un agente personale, quindi riprendi di nuovo4989* Ricrea il file dell'agente in `.claude/agents/<name>.md` nel progetto della sessione, o in `~/.claude/agents/<name>.md` per un agente personale, quindi riprendi di nuovo

4994* Oppure riprendi con `--agent <name>` nominando un agente che esiste, per eseguire la sessione come quell'agente invece4990* Oppure riprendi con `--agent <name>` nominando un agente che esiste, per eseguire invece la sessione come quell'agente

4995* Se l'agente ha ambito di progetto e non hai fiducia nella directory originale della sessione, esegui Claude Code lì una volta, accetta la finestra di dialogo di fiducia, quindi riprendi di nuovo4991* Se l'agente ha ambito di progetto e non hai concesso la fiducia alla directory originale della sessione, esegui Claude Code lì una volta, accetta la finestra di dialogo di fiducia, quindi riprendi di nuovo

4996 4992 

4997<h3 id="claude_code_process_wrapper-launcher-errors">4993<h3 id="claude_code_process_wrapper-launcher-errors">

4998 Errori del launcher CLAUDE\_CODE\_PROCESS\_WRAPPER4994 Errori del launcher CLAUDE\_CODE\_PROCESS\_WRAPPER


5004CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file5000CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

5005```5001```

5006 5002 

5007Un launcher che si avvia ma esce senza sostituirsi con Claude Code fallisce la sessione che stava avviando, e la riga della sessione nella vista agente riporta che il launcher `must exec, not daemonize`, seguito da qualsiasi cosa il launcher abbia stampato. Una sessione che non può avviarsi o raggiungere il servizio in background a causa del launcher riporta il problema del launcher come motivo all'interno di `Couldn't reach the background service (...)`.5003Un launcher che si avvia ma esce senza sostituirsi con Claude Code fa fallire la sessione che stava avviando, e la riga della sessione nella vista agente riporta che il launcher `must exec, not daemonize`, seguito da qualsiasi cosa il launcher abbia stampato. Una sessione che non può avviarsi o raggiungere il servizio in background a causa del launcher riporta il problema del launcher come motivo all'interno di `Couldn't reach the background service (...)`.

5008 5004 

5009**Cosa fare:**5005**Cosa fare:**

5010 5006 

5011* Imposta la variabile al percorso assoluto di un eseguibile che termina chiamando `exec "$@"`. Vedi [il contratto del launcher](/docs/it/corporate-launcher#the-launcher-contract) per il contratto completo5007* Imposta la variabile sul percorso assoluto di un eseguibile che termina chiamando `exec "$@"`. Vedi [il contratto del launcher](/docs/it/corporate-launcher#the-launcher-contract) per il contratto completo

5012* Controlla `/status`, che mostra il comando di avvio risolto nella sua voce Self-exec e avverte quando il servizio in background in esecuzione non corrisponde, o esegui `claude daemon status` da una shell5008* Controlla `/status`, che mostra il comando di avvio risolto nella sua voce Self-exec e avverte quando il servizio in background in esecuzione non corrisponde, o esegui `claude daemon status` da una shell

5013* Dopo aver corretto il valore nel blocco `env` delle [impostazioni](/docs/it/corporate-launcher#set-up-the-launcher), riavvia il servizio in background con `claude daemon stop --any` in modo che il prossimo invio avvii uno avvolto5009* Dopo aver corretto il valore nel blocco `env` delle [impostazioni](/docs/it/corporate-launcher#set-up-the-launcher), riavvia il servizio in background con `claude daemon stop --any` in modo che il prossimo invio ne avvii uno tramite il wrapper

5014 5010 

5015<h3 id="eunknown-when-starting-a-background-session">5011<h3 id="eunknown-when-starting-a-background-session">

5016 EUNKNOWN quando si avvia una sessione in background5012 EUNKNOWN quando si avvia una sessione in background

5017</h3>5013</h3>

5018 5014 

5019Windows ha rifiutato di avviare un programma con un codice di errore che non ha un nome standard, quindi l'errore emerge come `EUNKNOWN`. Il trigger solito è una politica di restrizione del software, come Group Policy o AppLocker, che blocca il programma in fase di avvio. L'errore appare quando avvii una [sessione in background](/docs/it/agent-view) con `/background` o `claude --bg`:5015Windows ha rifiutato di avviare un programma con un codice di errore che non ha un nome standard, quindi l'errore emerge come `EUNKNOWN`. La causa abituale è una politica di restrizione del software, come Group Policy o AppLocker, che blocca il programma in fase di avvio. L'errore appare quando avvii una [sessione in background](/docs/it/agent-view) con `/background` o `claude --bg`:

5020 5016 

5021```text theme={null}5017```text theme={null}

5022Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'5018Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'


5024 5020 

5025Su alcuni account il messaggio dice `daemon` al posto di `background service`.5021Su alcuni account il messaggio dice `daemon` al posto di `background service`.

5026 5022 

5027Su un'installazione npm, un `EUNKNOWN` che appare mentre `npm install -g @anthropic-ai/claude-code` sta sostituendo il binario ha la stessa causa di [`EACCES` durante una reinstallazione](#eacces-when-starting-a-background-session) e si cancella quando riprovi dopo che l'installazione finisce.5023Su un'installazione npm, un `EUNKNOWN` che appare mentre `npm install -g @anthropic-ai/claude-code` sta sostituendo il binario ha la stessa causa di [`EACCES` durante una reinstallazione](#eacces-when-starting-a-background-session) e scompare quando riprovi dopo che l'installazione finisce.

5028 5024 

5029Claude Code avvia il servizio in background attraverso PowerShell in modo che il servizio sopravviva alla chiusura del terminale, usando PowerShell 7 quando è installato e Windows PowerShell 5.1 altrimenti. Quando nessun PowerShell può essere eseguito, Claude Code avvia il servizio direttamente invece, quindi una politica che blocca solo PowerShell non causa questo errore.5025Claude Code avvia il servizio in background attraverso PowerShell in modo che il servizio sopravviva alla chiusura del terminale, usando PowerShell 7 quando è installato e Windows PowerShell 5.1 altrimenti. Quando nessuno dei due PowerShell può essere eseguito, Claude Code avvia invece il servizio direttamente, quindi una politica che blocca solo PowerShell non causa questo errore.

5030 5026 

5031Prima della v2.1.212, Claude Code usava solo Windows PowerShell 5.1 per avviare il servizio, quindi qualsiasi macchina dove Group Policy bloccava PowerShell 5.1 falliva con `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, anche con PowerShell 7 installato.5027Prima della v2.1.212, Claude Code usava solo Windows PowerShell 5.1 per avviare il servizio, quindi qualsiasi macchina dove Group Policy bloccava PowerShell 5.1 falliva con `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, anche con PowerShell 7 installato.

5032 5028 

5033**Cosa fare:**5029**Cosa fare:**

5034 5030 

5035* Se il messaggio legge `Couldn't start the session`, aggiorna alla v2.1.212 o successiva. Su versioni precedenti puoi anche eseguire `claude daemon run` in un terminale separato per primo, quindi avviare di nuovo la sessione in background. Quel comando esegue il servizio in background in primo piano del terminale, quindi il servizio dura solo finché quel terminale rimane aperto.5031* Se il messaggio riporta `Couldn't start the session`, aggiorna alla v2.1.212 o successiva. Sulle versioni precedenti puoi anche eseguire prima `claude daemon run` in un terminale separato, quindi avviare di nuovo la sessione in background. Quel comando esegue il servizio in background in primo piano nel terminale, quindi il servizio dura solo finché quel terminale rimane aperto.

5036* Se un npm install stava sostituendo il binario, aspetta che finisca, quindi avvia di nuovo la sessione in background5032* Se un npm install stava sostituendo il binario, aspetta che finisca, quindi avvia di nuovo la sessione in background

5037* Se l'errore appare su v2.1.212 o successiva mentre nessun npm install è in esecuzione, verifica con il tuo amministratore Windows se una politica di restrizione blocca l'eseguibile Claude Code5033* Se l'errore appare sulla v2.1.212 o successiva mentre nessun npm install è in esecuzione, verifica con il tuo amministratore Windows se una politica di restrizione blocca l'eseguibile Claude Code

5038* Se il servizio in background si interrompe quando chiudi il terminale, Claude Code l'ha avviato senza PowerShell. Installa PowerShell 7, o chiedi al tuo amministratore di sbloccare PowerShell, in modo che il servizio possa sopravvivere al terminale.5034* Se il servizio in background si interrompe quando chiudi il terminale, Claude Code l'ha avviato senza PowerShell. Installa PowerShell 7, o chiedi al tuo amministratore di sbloccare PowerShell, in modo che il servizio possa sopravvivere al terminale.

5039 5035 

5040<h3 id="eacces-when-starting-a-background-session">5036<h3 id="eacces-when-starting-a-background-session">

5041 EACCES quando si avvia una sessione in background5037 EACCES quando si avvia una sessione in background

5042</h3>5038</h3>

5043 5039 

5044Claude Code non poteva eseguire il suo stesso binario per avviare il [servizio in background](/docs/it/agent-view#the-supervisor-process) che ospita le sessioni in background. Su un'installazione npm, questo di solito significa che `npm install -g @anthropic-ai/claude-code` stava sostituendo il binario in quel momento, sia che l'abbia eseguito tu che l'[auto-updater](/docs/it/setup#auto-updates). L'errore appare quando apri una sessione dalla [vista agente](/docs/it/agent-view):5040Claude Code non poteva eseguire il suo stesso binario per avviare il [servizio in background](/docs/it/agent-view#the-supervisor-process) che ospita le sessioni in background. Su un'installazione npm, questo di solito significa che `npm install -g @anthropic-ai/claude-code` stava sostituendo il binario in quel momento, sia che l'abbia eseguito tu sia che l'abbia fatto l'[auto-updater](/docs/it/setup#auto-updates). L'errore appare quando apri una sessione dalla [vista agente](/docs/it/agent-view):

5045 5041 

5046```text theme={null}5042```text theme={null}

5047Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'5043Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'

5048```5044```

5049 5045 

5050Quando avvii una sessione con `/background` o `claude --bg`, lo stesso motivo appare all'interno di `Couldn't reach the background service (...)`. Durante la stessa finestra di reinstallazione l'errore può nominare un altro codice invece, come `ENOENT` o `ENOEXEC`, o `EUNKNOWN` o `EPERM` su Windows; un `EUNKNOWN` che persiste attraverso i nuovi tentativi ha una [causa diversa](#eunknown-when-starting-a-background-session).5046Quando avvii una sessione con `/background` o `claude --bg`, lo stesso motivo appare all'interno di `Couldn't reach the background service (...)`. Durante la stessa finestra di reinstallazione l'errore può invece nominare un altro codice, come `ENOENT` o `ENOEXEC`, o `EUNKNOWN` o `EPERM` su Windows; un `EUNKNOWN` che persiste attraverso i nuovi tentativi ha una [causa diversa](#eunknown-when-starting-a-background-session).

5051 5047 

5052Su un'installazione npm, Claude Code aspetta che la reinstallazione finisca e riprova da solo: fino a dieci secondi, e fino a due minuti mentre un npm install di Claude Code è visibilmente ancora in esecuzione sulla macchina, che copre un altro processo Claude Code che scarica un aggiornamento. Quando l'installazione dura più di quella attesa, l'errore nomina l'aggiornamento invece del codice di errore nudo:5048Su un'installazione npm, Claude Code aspetta che la reinstallazione finisca e riprova da solo: fino a dieci secondi, e fino a due minuti mentre un npm install di Claude Code è visibilmente ancora in esecuzione sulla macchina, il che copre un altro processo Claude Code che scarica un aggiornamento. Quando l'installazione dura più di quella attesa, l'errore nomina l'aggiornamento invece del semplice codice di errore:

5053 5049 

5054```text theme={null}5050```text theme={null}

5055Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes5051Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes


5072Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'5068Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'

5073```5069```

5074 5070 

5075Quando apri una sessione dalla [vista agente](/docs/it/agent-view), lo stesso motivo segue `Couldn't start the background service —`. Quando il servizio non ha stampato nulla prima di uscire, il messaggio dice `nothing on stderr` invece.5071Quando apri una sessione dalla [vista agente](/docs/it/agent-view), lo stesso motivo segue `Couldn't start the background service —`. Quando il servizio non ha stampato nulla prima di uscire, il messaggio dice invece `nothing on stderr`.

5076 5072 

5077Claude Code riporta l'errore con la riga di errore del servizio. Prima della v2.1.246, l'errore emergeva solo dopo un'attesa di 45 secondi, come `background service did not become reachable within 45s`, senza la riga di errore del servizio.5073Claude Code riporta l'errore con la riga di errore del servizio. Prima della v2.1.246, l'errore emergeva solo dopo un'attesa di 45 secondi, come `background service did not become reachable within 45s`, senza la riga di errore del servizio.

5078 5074 

5079Due motivi citati hanno cause note:5075Due motivi citati hanno cause note:

5080 5076 

5081* `Error: claude native binary not installed.`: un npm install stava sostituendo il binario Claude Code in quel momento, quindi il servizio ha eseguito il placeholder di npm invece. Riprova dopo che l'installazione finisce; se la riga persiste senza nessun install in esecuzione, [completa l'npm install](/docs/it/troubleshoot-install#native-binary-not-found-after-npm-install). Prima della v2.1.257, un auto-aggiornamento npm di macOS ha prodotto questo errore ad ogni avvio durante la finestra di installazione.5077* `Error: claude native binary not installed.`: un npm install stava sostituendo il binario Claude Code in quel momento, quindi il servizio ha eseguito invece il placeholder di npm. Riprova dopo che l'installazione finisce; se la riga persiste senza nessuna installazione in esecuzione, [completa l'npm install](/docs/it/troubleshoot-install#native-binary-not-found-after-npm-install). Prima della v2.1.257, un auto-aggiornamento npm su macOS produceva questo errore a ogni avvio durante la finestra di installazione.

5082* `nothing on stderr` con codice di uscita 1, ad ogni avvio, su Windows: `daemon.lock` nomina un processo che Claude Code non può né segnalare né provare sia andato, quindi ogni nuovo servizio conclude che un altro lo tiene e esce. Un lock il cui scrittore Claude Code può provare sia andato viene sostituito da solo e non produce questo errore. Quando l'errore si ripete ad ogni avvio, elimina `~/.claude/daemon.lock`, quindi apri di nuovo la sessione o invia di nuovo. Prima della v2.1.257, tale lock bloccava ogni avvio fino a quando non eliminavi il file.5078* `nothing on stderr` con codice di uscita 1, a ogni avvio, su Windows: `daemon.lock` nomina un processo a cui Claude Code non può né inviare segnali né dimostrare che sia terminato, quindi ogni nuovo servizio conclude che un altro detiene il lock ed esce. Un lock il cui scrittore Claude Code può dimostrare che sia terminato viene sostituito automaticamente e non produce questo errore. Quando l'errore si ripete a ogni avvio, elimina `~/.claude/daemon.lock`, quindi apri di nuovo la sessione o invia di nuovo. Prima della v2.1.257, tale lock bloccava ogni avvio fino a quando non eliminavi il file.

5083 5079 

5084**Cosa fare:**5080**Cosa fare:**

5085 5081 


5096Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)5092Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

5097```5093```

5098 5094 

5099Prima della v2.1.257, la sessione sembrava avviarsi e poi mostrava nella vista agente come una riga fallita con lo stesso motivo.5095Prima della v2.1.257, la sessione sembrava avviarsi e poi appariva nella vista agente come una riga fallita con lo stesso motivo.

5100 5096 

5101Prima della v2.1.281, questo messaggio appariva anche quando la directory era già scomparsa prima che avviassi la sessione. Quel caso riporta [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).5097Prima della v2.1.281, questo messaggio appariva anche quando la directory era già scomparsa prima che avviassi la sessione. Quel caso riporta [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).

5102 5098 


5114Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.5110Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.

5115```5111```

5116 5112 

5117Da un terminale nella directory della sessione stessa, lo stesso comando mostra la finestra di dialogo di fiducia invece e avvia la sessione una volta che accetti. Questo messaggio appare dove nessuna finestra di dialogo può, come in uno script, o quando riavvii una sessione da una directory diversa dalla sua.5113Da un terminale nella directory della sessione stessa, lo stesso comando mostra invece la finestra di dialogo di fiducia e avvia la sessione una volta che accetti. Questo messaggio appare dove nessuna finestra di dialogo può apparire, come in uno script, o quando riavvii una sessione da una directory diversa dalla sua.

5118 5114 

5119Due varianti nominano una causa diversa:5115Due varianti nominano una causa diversa:

5120 5116 


5126**Cosa fare:**5122**Cosa fare:**

5127 5123 

5128* Esegui `claude` nella directory che il messaggio nomina e accetta la finestra di dialogo di fiducia, quindi esegui di nuovo il comando5124* Esegui `claude` nella directory che il messaggio nomina e accetta la finestra di dialogo di fiducia, quindi esegui di nuovo il comando

5129* Per il messaggio della directory home, esegui il comando da un terminale nella tua directory home in modo che la finestra di dialogo possa apparire, o avvia la sessione da una directory di progetto invece5125* Per il messaggio della directory home, esegui il comando da un terminale nella tua directory home in modo che la finestra di dialogo possa apparire, o avvia invece la sessione da una directory di progetto

5130* Per il messaggio `could not be resolved on disk`, ricrea la directory, o avvia una nuova sessione da una directory che esiste5126* Per il messaggio `could not be resolved on disk`, ricrea la directory, o avvia una nuova sessione da una directory che esiste

5131 5127 

5132<h2 id="wrapper-and-ide-errors">5128<h2 id="wrapper-and-ide-errors">

Details

92 <td>✗</td>92 <td>✗</td>

93 <td>✓</td>93 <td>✓</td>

94 <td>Vedi nota <sup><a href="#fn1">1</a></sup></td>94 <td>Vedi nota <sup><a href="#fn1">1</a></sup></td>

95 <td>✓ ([distribuzioni ospitate su Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options))</td>95 <td>✓</td>

96 </tr>96 </tr>

97 97 

98 <tr>98 <tr>


200 <tr>200 <tr>

201 <td>[Server-managed settings](/docs/it/server-managed-settings)</td>201 <td>[Server-managed settings](/docs/it/server-managed-settings)</td>

202 <td>✓ (Team e Enterprise)</td>202 <td>✓ (Team e Enterprise)</td>

203 <td>✓ (Team e Enterprise)</td>203 <td>Vedi [Disponibilità per piattaforma](/docs/it/server-managed-settings#platform-availability)</td>

204 <td>✗</td>204 <td>✗</td>

205 <td>✗</td>205 <td>✗</td>

206 <td>✗</td>206 <td>✗</td>


283 **Supporto parziale:**283 **Supporto parziale:**

284 284 

285 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)285 * [Desktop](/docs/it/desktop): solo tramite [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)

286 * [Web search](/docs/it/tools-reference#websearch-tool-behavior): [distribuzioni ospitate su Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) soltanto

287 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5 o successivi, Opus 4.7 o successivi, Haiku 5.5 e modelli Fable soltanto286 * [Auto mode](/docs/it/auto-mode-config): Sonnet 5 o successivi, Opus 4.7 o successivi, Haiku 5.5 e modelli Fable soltanto

288 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>287 * [Cross-session messaging](/docs/it/cross-session-messaging): tra le tue sessioni su questa macchina soltanto <sup><a href="#fn5">5</a></sup>

289 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Azure288 * [Zero Data Retention](/docs/it/zero-data-retention): soggetto al tuo accordo Azure


294 <Tab title="Anthropic Console">293 <Tab title="Anthropic Console">

295 **Non disponibile:** tutte le [funzionalità che richiedono un abbonamento Claude](#features-that-require-a-claude-subscription).294 **Non disponibile:** tutte le [funzionalità che richiedono un abbonamento Claude](#features-that-require-a-claude-subscription).

296 295 

297 Tutto in [Funzionalità CLI che variano per provider](#cli-capabilities-that-vary-by-provider) è disponibile, tranne che [fast mode](/docs/it/fast-mode) richiede [accesso provisioned](/docs/it/fast-mode#enable-fast-mode-for-your-organization). [Server-managed settings](/docs/it/server-managed-settings) sono anche disponibili quando la tua chiave API appartiene a un'organizzazione Team o Enterprise.296 Tutto in [Funzionalità CLI che variano per provider](#cli-capabilities-that-vary-by-provider) è disponibile, tranne che [fast mode](/docs/it/fast-mode) richiede [accesso provisioned](/docs/it/fast-mode#enable-fast-mode-for-your-organization). Le [server-managed settings](/docs/it/server-managed-settings) che configuri in un'organizzazione Team o Enterprise su claude.ai non raggiungono una sessione che si autentica con una chiave API della Console. Consulta [Disponibilità per piattaforma](/docs/it/server-managed-settings#platform-availability) per sapere come coprire quelle sessioni.

298 </Tab>297 </Tab>

299</Tabs>298</Tabs>

300 299 

Details

140| Autorizzazione | Accesso |140| Autorizzazione | Accesso |

141| - | - |141| - | - |

142| Actions | Lettura e scrittura |142| Actions | Lettura e scrittura |

143| Administration | Lettura |

143| Checks | Lettura e scrittura |144| Checks | Lettura e scrittura |

144| Contents | Lettura e scrittura |145| Contents | Lettura e scrittura |

145| Discussions | Lettura e scrittura |146| Discussions | Lettura e scrittura |

146| Issues | Lettura e scrittura |147| Issues | Lettura e scrittura |

147| Members | Lettura |148| Members | Lettura |

149| Merge queues | Lettura |

148| Metadata | Lettura |150| Metadata | Lettura |

149| Pull requests | Lettura e scrittura |151| Pull requests | Lettura e scrittura |

150| Repository hooks | Lettura e scrittura |152| Repository hooks | Lettura e scrittura |

glossary.md +1 −1

Details

294 Output style294 Output style

295</h3>295</h3>

296 296 

297Una configurazione che modifica le istruzioni che Claude Code fornisce a Claude, per impostare il comportamento della risposta, il tono o il formato. A differenza di [CLAUDE.md](#claude-md), che aggiunge il contesto del progetto insieme alle istruzioni predefinite di Claude Code, uno stile di output personalizzato può sostituire le istruzioni predefinite di ingegneria del software.297Una configurazione che modifica le istruzioni che Claude Code fornisce a Claude, per impostare il comportamento della risposta, il tono o il formato. A differenza di [CLAUDE.md](#claude-md), che aggiunge il contesto del progetto insieme alle istruzioni predefinite di Claude Code, uno stile di output personalizzato aggiunge le proprie istruzioni e può omettere le istruzioni predefinite di ingegneria del software.

298 298 

299Scopri di più: [Output styles](/docs/it/output-styles)299Scopri di più: [Output styles](/docs/it/output-styles)

300 300 

Details

342 Finestra di contesto da 1M token342 Finestra di contesto da 1M token

343</h2>343</h2>

344 344 

345Claude Sonnet 5, Opus 4.6 e versioni successive, e Sonnet 4.6 supportano la [finestra di contesto da 1M token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) su Google Cloud's Agent Platform. Sonnet 5 funziona sempre con la finestra da 1M, senza alcuna variante `[1m]` da selezionare. Per gli altri modelli, Claude Code abilita automaticamente la finestra di contesto estesa quando selezioni una variante di modello 1M.345I modelli Fable, Sonnet 5 e versioni successive, e Opus 4.7 e versioni successive funzionano con la [finestra di contesto da 1M token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per impostazione predefinita su Google Cloud's Agent Platform, senza bisogno del suffisso `[1m]`. Per mantenere invece una finestra da 200K, imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/model-config#turn-off-1m-context).

346 346 

347La [procedura guidata di configurazione](#sign-in-with-agent-platform) offre un'opzione di contesto 1M quando fissa i modelli. Per abilitarla per un modello fissato manualmente, aggiungi `[1m]` all'ID del modello. Consulta [Fissa i modelli per le distribuzioni di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments) per i dettagli, incluso come utilizzare la finestra 1M senza modificare il pin.347Opus 4.6 e Sonnet 4.6 raggiungono la finestra da 1M quando selezioni la loro variante `[1m]`. La [procedura guidata di configurazione](#sign-in-with-agent-platform) offre un'opzione di contesto 1M quando fissa i modelli. Per abilitarla invece per un modello fissato manualmente, aggiungi `[1m]` all'ID del modello. Consulta [Fissa i modelli per le distribuzioni di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments) per i dettagli, incluso come utilizzare la finestra 1M senza modificare il pin.

348 

349Prima della v2.1.287, i modelli Fable e Opus 4.7 e versioni successive funzionavano con una finestra da 200K per impostazione predefinita su Google Cloud's Agent Platform e raggiungevano la finestra da 1M tramite il suffisso `[1m]`.

348 350 

349<h2 id="troubleshooting">351<h2 id="troubleshooting">

350 Risoluzione dei problemi352 Risoluzione dei problemi

headless.md +9 −4

Details

78 Attività in background all'uscita78 Attività in background all'uscita

79</h3>79</h3>

80 80 

81Se Claude avvia un'[attività Bash in background](/docs/it/tools-reference#bash-tool-behavior) durante un'esecuzione di `claude -p`, ad esempio un server di sviluppo o una build di watch, tale shell viene terminata circa cinque secondi dopo che Claude ha restituito il suo risultato finale e stdin è stato chiuso. Il periodo di grazia consente a un'attività che termina subito dopo il risultato di consegnare comunque il suo output.81Dopo che Claude ha terminato il suo turno e stdin è stato chiuso, un'esecuzione di `claude -p` può rimanere aperta per attendere il lavoro in background avviato da Claude.

82 82 

83Se Claude avvia un [subagente](/docs/it/sub-agents) in background o un flusso di lavoro, `claude -p` rimane invece aperto fino al completamento di quel lavoro, perché il suo risultato fa parte dell'output finale.83A meno che non sia ancora in esecuzione un comando in background avviato dalla conversazione principale, per impostazione predefinita Claude Code interrompe tutto ciò che è ancora in esecuzione dopo 10 minuti di attesa continua inattiva e scarta il suo risultato parziale. Per modificare il limite di 10 minuti, imposta [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/it/env-vars), oppure impostalo su `0` per attendere senza limite.

84 84 

85Per impostazione predefinita l'attesa termina dopo 10 minuti di attesa continua inattiva, quindi un subagente o un flusso di lavoro bloccato non può mantenere il processo aperto indefinitamente. A quel punto Claude Code interrompe tutto ciò che è ancora in esecuzione e scarta il suo risultato parziale. Per modificare il limite, imposta [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/docs/it/env-vars), oppure impostalo su `0` per attendere senza uno.85L'esecuzione attende il lavoro in background come comandi in background, subagent e workflow, watch di Monitor e risvegli `/loop` in sospeso:

86 86 

87Se Claude avvia un watch [Monitor](/docs/it/tools-reference#monitor-tool) durante un'esecuzione di `claude -p`, Claude Code attende il watch fino a quando non scade o il limite di dieci minuti termina l'attesa, a seconda di quale arriva prima. Mentre attende, Claude continua a rispondere a ciò che il watch segnala. Per impostazione predefinita, un watch scade cinque minuti dopo che Claude lo avvia.87* **[Comandi in background](/docs/it/tools-reference#background-commands)**: per un comando avviato dalla conversazione principale, ad esempio un server di sviluppo o una build in modalità watch, l'esecuzione attende finché il comando non esce o raggiunge il suo [limite di tempo](/docs/it/tools-reference#time-limit-for-background-commands). Claude esegue quindi un ulteriore turno con l'esito, e il risultato di quel turno diventa l'ultimo dell'esecuzione, ovvero quello stampato dagli output `text` e `json`. Mentre il comando è in esecuzione, il limite di 10 minuti non termina l'attesa.

88* **[Subagent](/docs/it/sub-agents) e workflow in background**: l'esecuzione rimane aperta fino al completamento di quel lavoro, perché il suo risultato fa parte dell'output finale.

89* **Watch di [Monitor](/docs/it/tools-reference#monitor-tool)**: l'esecuzione attende finché il watch non scade o il limite di 10 minuti termina l'attesa, a seconda di quale evento si verifica prima. Mentre attende, Claude continua a rispondere a ciò che il watch segnala. Per impostazione predefinita, un watch scade cinque minuti dopo che Claude lo avvia.

90* **Risvegli in sospeso**: in un'esecuzione il cui prompt hai passato come testo anziché con `--input-format stream-json`, quando Claude ha pianificato un [risveglio `/loop` a ritmo autonomo](/docs/it/scheduled-tasks#let-claude-choose-the-interval), l'esecuzione attende che ogni risveglio scatti ed esegue la relativa iterazione finché il [loop non termina](/docs/it/scheduled-tasks#stop-a-loop), anche oltre il limite di 10 minuti.

91 

92Se l'esecuzione raggiunge il limite di [`--max-budget-usd`](/docs/it/cli-reference#cli-flags), Claude Code interrompe il lavoro in background rimanente invece di attendere.

88 93 

89<h3 id="stop-a-run-with-sigterm">94<h3 id="stop-a-run-with-sigterm">

90 Interrompi un'esecuzione con SIGTERM95 Interrompi un'esecuzione con SIGTERM

hooks.md +2 −0

Details

3862 3862 

3863Impostare `type` su `"prompt"` e fornire una stringa `prompt` invece di un `command`. Utilizzare il segnaposto `$ARGUMENTS` per iniettare i dati di input JSON del hook nel testo del prompt.3863Impostare `type` su `"prompt"` e fornire una stringa `prompt` invece di un `command`. Utilizzare il segnaposto `$ARGUMENTS` per iniettare i dati di input JSON del hook nel testo del prompt.

3864 3864 

3865In un hook di prompt o in un [hook agente](#agent-based-hooks), puoi scrivere il `prompt` come una regola su cosa bloccare o consentire, ad esempio "Blocca qualsiasi comando Bash che legge file `.env`", oppure come una condizione che deve essere soddisfatta, ad esempio "Tutti i test unitari passano".

3866 

3865Questo hook `Stop` chiede all'LLM di valutare se tutti i compiti sono completi prima di consentire a Claude di terminare:3867Questo hook `Stop` chiede all'LLM di valutare se tutti i compiti sono completi prima di consentire a Claude di terminare:

3866 3868 

3867```json theme={null}3869```json theme={null}

keybindings.md +49 −0

Details

68| `EffortSlider` | Cursore di sforzo aperto da `/effort` |68| `EffortSlider` | Cursore di sforzo aperto da `/effort` |

69| `Select` | Componenti generici di selezione/elenco |69| `Select` | Componenti generici di selezione/elenco |

70| `Plugin` | Dialogo dei plugin (sfoglia, scopri, gestisci) |70| `Plugin` | Dialogo dei plugin (sfoglia, scopri, gestisci) |

71| `AbovePrompt` | La [fascia sopra il prompt](#above-prompt-actions), o un pulsante al suo interno, ha il focus della tastiera |

72| `AbovePromptInput` | Un campo di input nella fascia sopra il prompt o nel riquadro di un mod ha il focus della tastiera |

73| `AbovePromptSelect` | Una selezione nella fascia sopra il prompt o nel riquadro di un mod ha il focus della tastiera |

71| `Pane` | Un riquadro disegnato da un [mod](/docs/it/plugins/mods/interface#know-which-keys-your-mod-can-receive) ha il focus della tastiera |74| `Pane` | Un riquadro disegnato da un [mod](/docs/it/plugins/mods/interface#know-which-keys-your-mod-can-receive) ha il focus della tastiera |

72| `PaneField` | Un campo di input o una selezione nel riquadro di un mod ha il focus della tastiera |75| `PaneField` | Un campo di input o una selezione nel riquadro di un mod ha il focus della tastiera |

73| `Agents` | [Visualizzazione agente](/docs/it/agent-view) (`claude agents`) |76| `Agents` | [Visualizzazione agente](/docs/it/agent-view) (`claude agents`) |


442| `plugin:install` | I | Installa i plugin selezionati |445| `plugin:install` | I | Installa i plugin selezionati |

443| `plugin:favorite` | F | Contrassegna il plugin selezionato come preferito in modo che si ordini vicino alla parte superiore della scheda Installato |446| `plugin:favorite` | F | Contrassegna il plugin selezionato come preferito in modo che si ordini vicino alla parte superiore della scheda Installato |

444 447 

448<h3 id="above-prompt-actions">

449 Azioni sopra il prompt

450</h3>

451 

452Azioni per la fascia sopra il prompt, la striscia condivisa in cui i [mod](/docs/it/plugins/mods/interface#pick-where-to-draw) disegnano pulsanti, campi di input e selettori. `abovePrompt:toggle` e `abovePrompt:focus` si applicano nel contesto `Chat`. Le altre azioni si applicano nel [contesto](#contexts) di qualunque elemento abbia il focus della tastiera nella fascia o in un riquadro.

453 

454| Azione | Predefinito | Descrizione |

455| :- | :- | :- |

456| `abovePrompt:toggle` | Ctrl+X Ctrl+A | Comprimi la fascia in un suggerimento di una riga, o espandila di nuovo |

457| `abovePrompt:focus` | Ctrl+X Tab | Sposta il focus della tastiera nella fascia, poi su ogni [riquadro](#pane-actions) aperto, e dall'ultimo riquadro di nuovo al prompt |

458| `abovePrompt:next` | Tab | Sposta il focus sul controllo successivo |

459| `abovePrompt:previous` | Shift+Tab | Sposta il focus sul controllo precedente |

460| `abovePrompt:press` | Invio | Premi il pulsante con il focus, invia il campo di input con il focus o scegli l'opzione evidenziata in un selettore |

461| `abovePrompt:leave` | Escape | Riporta il focus della tastiera al prompt |

462| `abovePrompt:highlightNext` | Giù | Evidenzia l'opzione successiva in un selettore con il focus |

463| `abovePrompt:highlightPrevious` | Su | Evidenzia l'opzione precedente in un selettore con il focus |

464 

465Due contesti associano per impostazione predefinita altri tasti a queste azioni:

466 

467* **`AbovePrompt`**: anche Destra e Sinistra eseguono `abovePrompt:next` e `abovePrompt:previous`, e anche Spazio esegue `abovePrompt:press`

468* **`AbovePromptInput`**: anche Giù e Su eseguono `abovePrompt:next` e `abovePrompt:previous`

469 

470Il contesto `AbovePrompt` associa anche Su, Giù, PagSu, PagGiù, Home e Fine alle [azioni di scorrimento del riquadro](#pane-actions) da `pane:scrollUp` a `pane:bottom`, quindi per cambiare uno di quei tasti per la fascia, associa l'azione di scorrimento in un blocco `AbovePrompt`.

471 

472<h3 id="pane-actions">

473 Azioni dei riquadri

474</h3>

475 

476Azioni per un riquadro disegnato da un [mod](/docs/it/plugins/mods/interface#know-which-keys-your-mod-can-receive). Le azioni di scorrimento, ridimensionamento e chiusura si applicano nel [contesto](#contexts) `Pane`. `pane:close` si applica anche nel contesto `PaneField`, quindi funziona mentre uno dei campi del riquadro ha il focus. `pane:next` e `pane:previous` si applicano nel contesto `Global` mentre è aperto più di un riquadro.

477 

478| Azione | Predefinito | Descrizione |

479| :- | :- | :- |

480| `pane:scrollUp` | Su | Scorri il riquadro verso l'alto quando ha più righe di quante ne possa mostrare |

481| `pane:scrollDown` | Giù | Scorri il riquadro verso il basso quando ha più righe di quante ne possa mostrare |

482| `pane:pageUp` | PagSu | Scorri il riquadro verso l'alto di una pagina |

483| `pane:pageDown` | PagGiù | Scorri il riquadro verso il basso di una pagina |

484| `pane:top` | Home | Salta all'inizio del riquadro |

485| `pane:bottom` | Fine | Salta alla fine del riquadro |

486| `pane:grow` | Ctrl+X Sinistra, Ctrl+X Su | Dai più spazio al riquadro: in larghezza quando si trova accanto alla trascrizione, in altezza quando si trova sopra il prompt |

487| `pane:shrink` | Ctrl+X Destra, Ctrl+X Giù | Dai meno spazio al riquadro: in larghezza quando si trova accanto alla trascrizione, in altezza quando si trova sopra il prompt |

488| `pane:close` | Ctrl+X X | Chiudi il riquadro |

489| `pane:next` | (non associato) | Mostra il riquadro aperto successivo |

490| `pane:previous` | (non associato) | Mostra il riquadro aperto precedente |

491 

492Il contesto `Pane` associa anche Tab, Shift+Tab, Invio ed Escape alle stesse [azioni sopra il prompt](#above-prompt-actions) della fascia, e i campi di input e i selettori di un riquadro usano i contesti `AbovePromptInput` e `AbovePromptSelect`. [Focus della tastiera e hotkey](/docs/it/plugins/mods/interface#know-which-keys-your-mod-can-receive) elenca cosa fa ogni tasto in un riquadro.

493 

445<h3 id="settings-actions">494<h3 id="settings-actions">

446 Azioni delle impostazioni495 Azioni delle impostazioni

447</h3>496</h3>

Details

200 200 

201| Intestazione | Cosa restituire e perché |201| Intestazione | Cosa restituire e perché |

202| :- | :- |202| :- | :- |

203| `content-type` | Restituisci `text/event-stream` sulle risposte in formato Anthropic Messages in streaming, e `application/vnd.amazon.eventstream`, senza modifiche, sulle risposte in formato Amazon Bedrock, dove [un tipo diverso non riesce nella richiesta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). [Streaming](#streaming) elenca quali connessioni eseguono il rilevamento di stallo su questi flussi |203| `content-type` | Restituisci `text/event-stream` sulle risposte in formato Anthropic Messages in streaming, e `application/vnd.amazon.eventstream`, senza modifiche, sulle risposte in formato Amazon Bedrock, dove [un tipo diverso fa fallire la richiesta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) |

204| `retry-after` | Restituisci secondi interi anziché una data HTTP. Claude Code attende almeno quel tempo prima del prossimo [tentativo automatico](/docs/it/errors#automatic-retries), e al di fuori delle sessioni [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/it/env-vars) un valore superiore a 60 interrompe i tentativi e mostra l'errore immediatamente |204| `retry-after` | Restituisci secondi interi anziché una data HTTP. Claude Code attende almeno quel tempo prima del prossimo [tentativo automatico](/docs/it/errors#automatic-retries), e al di fuori delle sessioni [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/it/env-vars) un valore superiore a 60 interrompe i tentativi e mostra l'errore immediatamente |

205| `x-should-retry` | Passa il valore upstream senza modifiche. Claude Code legge questa intestazione come uno degli input quando decide se riprovare una richiesta non riuscita: `true` contrassegna la risposta come ritentabile e `false` la contrassegna come non ritentabile. Per i conteggi dei tentativi, il backoff e quali errori Claude Code riprova, vedi [tentativi automatici](/docs/it/errors#automatic-retries) |205| `x-should-retry` | Passa il valore upstream senza modifiche. Claude Code legge questa intestazione come uno degli input quando decide se riprovare una richiesta non riuscita: `true` contrassegna la risposta come ritentabile e `false` la contrassegna come non ritentabile. Per i conteggi dei tentativi, il backoff e quali errori Claude Code riprova, vedi [tentativi automatici](/docs/it/errors#automatic-retries) |

206| `anthropic-ratelimit-unified-*` | Inoltra i valori upstream senza modifiche su ogni risposta. Claude Code li legge sulle risposte riuscite per mostrare l'utilizzo rispetto ai limiti del piano agli sviluppatori che hanno effettuato l'accesso con claude.ai, e su un `429` per distinguere un limite del piano o un limite di spesa da una limitazione temporanea; vedi [limiti di utilizzo](/docs/it/errors#usage-limits) |206| `anthropic-ratelimit-unified-*` | Inoltra i valori upstream senza modifiche su ogni risposta. Claude Code li legge sulle risposte riuscite per mostrare l'utilizzo rispetto ai limiti del piano agli sviluppatori che hanno effettuato l'accesso con claude.ai, e su un `429` per distinguere un limite del piano o un limite di spesa da una limitazione temporanea; vedi [limiti di utilizzo](/docs/it/errors#usage-limits) |

Details

144 144 

145Quando la tua organizzazione fornisce più di una fonte gestita alla stessa macchina, la chiave [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) decide cosa Claude Code fa con le altre:145Quando la tua organizzazione fornisce più di una fonte gestita alla stessa macchina, la chiave [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) decide cosa Claude Code fa con le altre:

146 146 

147* **`"first-wins"`, l'impostazione predefinita**: Claude Code utilizza la fonte con il ranking più alto che fornisce almeno una chiave di policy e ignora il resto piuttosto che unirle, a parte le chiavi in [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source). Claude Code non mostra alcun avviso per le fonti che salta; `/status` [nomina la fonte che ha utilizzato e quelle che ha saltato](#read-the-source-in-/status).147* **`"first-wins"`, l'impostazione predefinita**: Claude Code utilizza la fonte con il ranking più alto che fornisce almeno una chiave di policy e ignora il resto piuttosto che farne il merge, a parte le chiavi in [Chiavi lette da ogni fonte di amministrazione](#keys-read-from-every-admin-source). Claude Code non mostra alcun avviso per le fonti che salta; `/status` [nomina la fonte che ha utilizzato e quelle che ha saltato](#read-the-source-in-/status).

148* **`"merge"`**: Claude Code applica ogni fonte admin che fornisce una chiave di policy e le combina per tipo di chiave: sulla maggior parte delle chiavi il valore della fonte con ranking più alto si applica, gli elenchi si uniscono e i blocchi prendono il valore più restrittivo. [Componi ogni fonte gestita](#compose-every-managed-source) dice dove impostare la chiave e come ogni tipo di chiave si combina. Richiede Claude Code v2.1.242 o successivo.148* **`"merge"`**: Claude Code applica ogni fonte di amministrazione che fornisce una chiave di policy e le combina per tipo di chiave: sulla maggior parte delle chiavi il valore della fonte con ranking più alto si applica, gli elenchi si uniscono e i blocchi prendono il valore più restrittivo. [Componi ogni fonte gestita](#compose-every-managed-source) dice dove impostare la chiave e come ogni tipo di chiave si combina. Richiede Claude Code v2.1.242 o successivo.

149 149 

150Entrambe le impostazioni classificano le fonti nello stesso modo. Questi termini ricorrono in questa sezione:150Entrambe le impostazioni classificano le fonti nello stesso modo. Questi termini ricorrono in questa sezione:

151 151 

152* **Chiave di policy**: qualsiasi chiave di impostazioni diversa dalle due chiavi di controllo, [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior). Un file di impostazioni gestite o una policy MDM che contiene solo quelle non conta, e Claude Code passa alla fonte successiva.152* **Chiave di policy**: qualsiasi chiave di impostazioni diversa dalle due chiavi di controllo, [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior). Un file di impostazioni gestite o una policy MDM che contiene solo quelle non conta, e Claude Code passa alla fonte successiva.

153* **Fonte admin**: una delle prime tre fonti di seguito. Il registro HKCU è scrivibile dall'utente e non è una.153* **Fonte di amministrazione**: una delle prime tre fonti di seguito. Il registro HKCU è scrivibile dall'utente e non è una.

154 154 

155Claude Code controlla le fonti in questo ordine, dalla priorità più alta alla più bassa:155Claude Code controlla le fonti in questo ordine, dalla priorità più alta alla più bassa:

156 156 

1571. Impostazioni remote, fornite da claude.ai come [impostazioni gestite dal server](/docs/it/server-managed-settings) o da un [gateway di app Claude](/docs/it/claude-apps-gateway). Claude Code recupera questa fonte solo quando la sessione si autentica direttamente all'API di Anthropic con un [login o chiave idonei](/docs/it/server-managed-settings#platform-availability), o accede a un gateway con `/login`. Su altri provider, o quando `ANTHROPIC_BASE_URL` punta da qualche parte diversa dall'API di Anthropic, inizia dalla fonte successiva1571. Impostazioni remote, fornite da claude.ai come [impostazioni gestite dal server](/docs/it/server-managed-settings) o da un [gateway di app Claude](/docs/it/claude-apps-gateway). Claude Code recupera questa fonte solo quando la sessione si autentica direttamente all'API di Anthropic con una [credenziale idonea](/docs/it/server-managed-settings#platform-availability), o accede a un gateway con `/login`. Su altri provider, o quando `ANTHROPIC_BASE_URL` punta da qualche parte diversa dall'API di Anthropic, inizia dalla fonte successiva

1582. Policy MDM o a livello di OS: la plist di macOS o la chiave del registro HKLM1582. Policy MDM o a livello di OS: la plist di macOS o la chiave del registro HKLM

1593. File di impostazioni gestite, `managed-settings.d/*.json` e `managed-settings.json` uniti insieme1593. File di impostazioni gestite, `managed-settings.d/*.json` e `managed-settings.json` combinati tramite merge

1604. Il registro HKCU, su Windows, e su WSL una volta che il registro HKLM o il file di impostazioni gestite di Windows attiva [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e anche il valore HKCU lo imposta. Claude Code lo legge solo quando [nessun documento di amministrazione è presente sopra di esso](#present-admin-documents) e nessuna [impostazione padre fornita dall'host](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva1604. Il registro HKCU, su Windows, e su WSL una volta che il registro HKLM o il file di impostazioni gestite di Windows attiva [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) e anche il valore HKCU lo imposta. Claude Code lo legge solo quando [nessun documento di amministrazione è presente sopra di esso](#present-admin-documents) e nessuna [impostazione padre fornita dall'host](#let-an-embedding-host-add-policy) fornisce una chiave restrittiva

161 161 

162Questo diagramma mostra la classificazione, con esempi delle chiavi cross-source che Claude Code legge dalle prime tre fonti in entrambe le impostazioni:162Questo diagramma mostra la classificazione, con esempi delle chiavi cross-source che Claude Code legge dalle prime tre fonti in entrambe le impostazioni:


177Su WSL, anche `/etc/claude-code` è scrivibile dall'utente, e la voce [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) dice quando i documenti Windows stanno sopra di esso.177Su WSL, anche `/etc/claude-code` è scrivibile dall'utente, e la voce [`wslInheritsWindowsSettings`](/docs/it/settings-reference#wslinheritswindowssettings) dice quando i documenti Windows stanno sopra di esso.

178 178 

179<h3 id="keys-read-from-every-admin-source">179<h3 id="keys-read-from-every-admin-source">

180 Chiavi lette da ogni fonte admin180 Chiavi lette da ogni fonte di amministrazione

181</h3>181</h3>

182 182 

183Con l'impostazione predefinita `"first-wins"`, Claude Code legge la maggior parte delle chiavi solo dalla [fonte che ha selezionato](#how-claude-code-combines-managed-sources), e ignora un valore in una fonte con ranking inferiore anche quando la fonte selezionata lascia quella chiave non impostata.183Con l'impostazione predefinita `"first-wins"`, Claude Code legge la maggior parte delle chiavi solo dalla [fonte che ha selezionato](#how-claude-code-combines-managed-sources), e ignora un valore in una fonte con ranking inferiore anche quando la fonte selezionata lascia quella chiave non impostata.

184 184 

185Alcune chiavi funzionano diversamente. Claude Code le legge da ogni fonte admin, quindi una policy MDM con ranking inferiore o un file di impostazioni gestite può comunque impostarle quando la fonte selezionata non lo fa. Claude Code esclude il registro HKCU scrivibile dall'utente da quella scansione; quando HKCU è l'unica fonte e nessun host fornisce impostazioni padre, HKCU si applica come qualsiasi fonte selezionata.185Alcune chiavi funzionano diversamente. Claude Code le legge da ogni fonte di amministrazione, quindi una policy MDM con ranking inferiore o un file di impostazioni gestite può comunque impostarle quando la fonte selezionata non lo fa. Claude Code esclude il registro HKCU scrivibile dall'utente da quella scansione; quando HKCU è l'unica fonte e nessun host fornisce impostazioni padre, HKCU si applica come qualsiasi fonte selezionata.

186 186 

187Le chiavi cross-source includono:187Le chiavi cross-source includono:

188 188 

189* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: un `true` in qualsiasi fonte admin attiva il blocco. Mentre un blocco è attivo, Claude Code unisce l'allowlist che blocca, `sandbox.network.allowedDomains` insieme alle regole di autorizzazione `WebFetch(domain:...)`, o `sandbox.filesystem.allowRead`, attraverso ogni fonte admin. Senza il blocco, Claude Code tratta l'allowlist come qualsiasi altra chiave, quindi sotto `"first-wins"` l'allowlist di una fonte admin non selezionata viene ignorata189* `sandbox.network.allowManagedDomainsOnly` e `sandbox.filesystem.allowManagedReadPathsOnly`: un `true` in qualsiasi fonte di amministrazione attiva il blocco. Mentre un blocco è attivo, Claude Code unisce l'allowlist che blocca, `sandbox.network.allowedDomains` insieme alle regole di autorizzazione `WebFetch(domain:...)`, o `sandbox.filesystem.allowRead`, attraverso ogni fonte di amministrazione. Senza il blocco, Claude Code tratta l'allowlist come qualsiasi altra chiave, quindi sotto `"first-wins"` l'allowlist di una fonte di amministrazione non selezionata viene ignorata

190* `allowAllClaudeAiMcps`190* `allowAllClaudeAiMcps`

191* `allowManagedMcpServersOnly`: un `true` in qualsiasi fonte admin attiva il blocco dell'allowlist MCP. Mentre il blocco è attivo, l'elenco `allowedMcpServers` gestito proviene dalla fonte admin con ranking più alto che ne imposta uno. Un elenco gestito dal server sostituisce l'elenco di una fonte inferiore piuttosto che combinarsi con esso.191* `allowManagedMcpServersOnly`: un `true` in qualsiasi fonte di amministrazione attiva il blocco dell'allowlist MCP. Mentre il blocco è attivo, l'elenco `allowedMcpServers` gestito proviene dalla fonte di amministrazione con ranking più alto che ne imposta uno. Un elenco gestito dal server sostituisce l'elenco di una fonte inferiore piuttosto che combinarsi con esso.

192 192 

193 Se nessuna fonte admin imposta un elenco, ogni server che supera la denylist si carica, a meno che [le impostazioni padre](#let-an-embedding-host-add-policy) forniscano un elenco.193 Se nessuna fonte di amministrazione imposta un elenco, ogni server che supera la denylist si carica, a meno che [le impostazioni padre](#let-an-embedding-host-add-policy) forniscano un elenco.

194 194 

195 Senza il blocco, Claude Code legge `allowedMcpServers` dalla fonte gestita che applica, quindi sotto `"first-wins"` l'elenco di una fonte admin non selezionata viene ignorato. Richiede Claude Code v2.1.273 o successivo195 Senza il blocco, Claude Code legge `allowedMcpServers` dalla fonte gestita che applica, quindi sotto `"first-wins"` l'elenco di una fonte di amministrazione non selezionata viene ignorato. Richiede Claude Code v2.1.273 o successivo

196* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors): una voce o un `true` in qualsiasi fonte admin si applica. Richiede Claude Code v2.1.273 o successivo196* `deniedMcpServers` e [`disableClaudeAiConnectors`](/docs/it/settings-reference#disableclaudeaiconnectors): una voce o un `true` in qualsiasi fonte di amministrazione si applica. Richiede Claude Code v2.1.273 o successivo

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

198* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](/docs/it/settings-reference#sandbox-ripgrep)198* Il binario sandbox `ripgrep`, [`sandbox.ripgrep`](/docs/it/settings-reference#sandbox-ripgrep)

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

200* [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](/docs/it/settings-reference#syncclaudeaiplugins), dove un `false` da qualsiasi fonte admin disattiva il comportamento. Un `false` nelle impostazioni utente o locali dello sviluppatore lo disattiva anche; ogni chiave può solo negare200* [`useAutoModeDuringPlan`](/docs/it/settings-reference#useautomodeduringplan), [`syncClaudeAiSkills`](/docs/it/settings-reference#syncclaudeaiskills), e [`syncClaudeAiPlugins`](/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 negare

201* [`enableArtifact`](/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte admin disattiva lo [strumento Artifact](/docs/it/artifacts). 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](/docs/it/settings#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo201* [`enableArtifact`](/docs/it/settings-reference#enableartifact), dove un `false` da qualsiasi fonte di amministrazione disattiva lo [strumento Artifact](/docs/it/artifacts). 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](/docs/it/settings#exceptions-to-managed-settings-precedence). Richiede Claude Code v2.1.242 o successivo

202* [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel), dove il limite più basso in qualsiasi fonte admin 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 successivo202* [`maxEffortLevel`](/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

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

204* [`forceRemoteSettingsRefresh`](/docs/it/server-managed-settings)204* [`forceRemoteSettingsRefresh`](/docs/it/server-managed-settings)

205* `env`, unito per variabile attraverso le fonti admin: ogni variabile proviene dalla fonte con priorità più alta che la definisce, quindi le fonti inferiori riempiono le variabili che quelle superiori lasciano non impostate. Alcune variabili seguono le proprie regole; [Eccezioni per chiave attraverso le fonti gestite](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources) nomina ognuna. Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applicava solo l'intero blocco `env` della fonte selezionata205* `env`, sottoposto a merge per variabile attraverso le fonti di amministrazione: ogni variabile proviene dalla fonte con priorità più alta che la definisce, quindi le fonti inferiori riempiono le variabili che quelle superiori lasciano non impostate. Alcune variabili seguono le proprie regole; [Eccezioni per chiave attraverso le fonti gestite](/docs/it/server-managed-settings#per-key-exceptions-across-managed-sources) nomina ognuna. Richiede Claude Code v2.1.223 o successivo. Prima della v2.1.223, Claude Code applicava solo l'intero blocco `env` della fonte selezionata

206 206 

207Le [chiavi di accesso al gateway](#choose-a-delivery-mechanism) seguono una regola separata. Claude Code non le legge mai dalle impostazioni gestite dal server, quindi mentre le impostazioni gestite dal server sono la fonte selezionata, la fonte admin con ranking più alto sulla macchina che porta una chiave di policy le fornisce comunque. Un valore in una fonte admin classificata al di sotto di quella, o nel registro HKCU, viene ignorato.207Le [chiavi di accesso al gateway](#choose-a-delivery-mechanism) seguono una regola separata. Claude Code non le legge mai dalle impostazioni gestite dal server, quindi mentre le impostazioni gestite dal server sono la fonte selezionata, la fonte di amministrazione con ranking più alto sulla macchina che porta una chiave di policy le fornisce comunque. Un valore in una fonte di amministrazione classificata al di sotto di quella, o nel registro HKCU, viene ignorato.

208 208 

209[`allowedProviders`](/docs/it/settings-reference#allowedproviders) ha la sua propria regola: la nota Scope della sua voce dice come un elenco impostato sulla macchina si combina con uno gestito dal server. Richiede Claude Code v2.1.285 o successivo.209[`allowedProviders`](/docs/it/settings-reference#allowedproviders) ha la sua propria regola: la nota Scope della sua voce dice come un elenco impostato sulla macchina si combina con uno gestito dal server. Richiede Claude Code v2.1.285 o successivo.

210 210 

211Quando una fonte admin imposta `allowManagedMcpServersOnly` o un elenco `allowedMcpServers` e quel valore non è quello in vigore, `/status` e `claude doctor` nominano quella fonte e chiave.211Quando una fonte di amministrazione imposta `allowManagedMcpServersOnly` o un elenco `allowedMcpServers` e quel valore non è quello in vigore, `/status` e `claude doctor` nominano quella fonte e chiave.

212 212 

213<h3 id="compose-every-managed-source">213<h3 id="compose-every-managed-source">

214 Componi ogni fonte gestita214 Componi ogni fonte gestita

215</h3>215</h3>

216 216 

217Per fare in modo che Claude Code applichi ogni fonte admin che la tua organizzazione fornisce, imposta [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) su `"merge"` nella fonte con ranking più alto che distribuisci. Claude Code legge la chiave solo dalla fonte con ranking più alto che porta la chiave o una chiave di policy, quindi una fonte inferiore non può optare per l'unione con la fonte sopra di essa, e una macchina che non riceve mai impostazioni gestite dal server ha bisogno della chiave anche nel suo profilo MDM. Il registro HKCU scrivibile dall'utente non si unisce mai con un'altra fonte. Richiede Claude Code v2.1.242 o successivo.217Per fare in modo che Claude Code applichi ogni fonte di amministrazione che la tua organizzazione fornisce, imposta [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) su `"merge"` nella fonte con ranking più alto che distribuisci. Claude Code legge la chiave solo dalla fonte con ranking più alto che porta la chiave o una chiave di policy, quindi una fonte inferiore non può optare per il merge con la fonte sopra di essa, e una macchina che non riceve mai impostazioni gestite dal server ha bisogno della chiave anche nel suo profilo MDM. Il registro HKCU scrivibile dall'utente non esegue mai il merge con un'altra fonte. Richiede Claude Code v2.1.242 o successivo.

218 218 

219Sotto `"merge"`, Claude Code aggiunge le voci di elenco di una fonte inferiore, come le regole `permissions.allow` e gli hook, alla policy, quindi attivalo solo quando ogni fonte classificata al di sotto di quella più alta è sotto il controllo di un amministratore.219Sotto `"merge"`, Claude Code aggiunge le voci di elenco di una fonte inferiore, come le regole `permissions.allow` e gli hook, alla policy, quindi attivalo solo quando ogni fonte classificata al di sotto di quella più alta è sotto il controllo di un amministratore.

220 220 


228| Valori presi interi | Prende il valore intero dalla fonte con ranking più alto che lo imposta, senza combinare voci o campi da fonti inferiori | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |228| Valori presi interi | Prende il valore intero dalla fonte con ranking più alto che lo imposta, senza combinare voci o campi da fonti inferiori | `sandbox.credentials.awsPairs`, `sandbox.ripgrep` |

229| Server MCP forniti | Combina i nomi dei server da ogni fonte; quando due fonti impostano lo stesso nome, applica la voce intera della fonte con ranking più alto | `managedMcpServers` |229| Server MCP forniti | Combina i nomi dei server da ogni fonte; quando due fonti impostano lo stesso nome, applica la voce intera della fonte con ranking più alto | `managedMcpServers` |

230| Chiavi lette solo dalla fonte con ranking più alto | Ignora la chiave in ogni fonte inferiore, anche quando la fonte con ranking più alto la lascia non impostata | Helper di credenziali come `apiKeyHelper`, pin di accesso come `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |230| Chiavi lette solo dalla fonte con ranking più alto | Ignora la chiave in ogni fonte inferiore, anche quando la fonte con ranking più alto la lascia non impostata | Helper di credenziali come `apiKeyHelper`, pin di accesso come `forceLoginOrgUUID`, `modelPicker`, `permissions.defaultMode` |

231| `env` | Si unisce per variabile attraverso le fonti admin in entrambe le impostazioni, come [Chiavi lette da ogni fonte admin](#keys-read-from-every-admin-source) descrive | |231| `env` | Esegue il merge per variabile attraverso le fonti di amministrazione in entrambe le impostazioni, come [Chiavi lette da ogni fonte di amministrazione](#keys-read-from-every-admin-source) descrive | |

232| Ogni altra chiave | Prende il valore dalla fonte con ranking più alto che lo imposta | `model`, `cleanupPeriodDays` |232| Ogni altra chiave | Prende il valore dalla fonte con ranking più alto che lo imposta | `model`, `cleanupPeriodDays` |

233 233 

234Per confermare quali fonti si sono combinate su una macchina, [leggi la riga `Setting sources` in `/status`](#read-the-source-in-/status); quella sezione dice cosa significa ogni etichetta.234Per confermare quali fonti si sono combinate su una macchina, [leggi la riga `Setting sources` in `/status`](#read-the-source-in-/status); quella sezione dice cosa significa ogni etichetta.


239 239 

240Un [`policyHelper`](/docs/it/settings-reference#policyhelper) è un eseguibile che la tua policy MDM o il file di impostazioni gestite nomina, e Claude Code lo esegue per calcolare le impostazioni gestite all'avvio. Quando la fonte selezionata ne configura uno e l'helper emette un oggetto `managedSettings`, quell'output cambia cosa Claude Code legge:240Un [`policyHelper`](/docs/it/settings-reference#policyhelper) è un eseguibile che la tua policy MDM o il file di impostazioni gestite nomina, e Claude Code lo esegue per calcolare le impostazioni gestite all'avvio. Quando la fonte selezionata ne configura uno e l'helper emette un oggetto `managedSettings`, quell'output cambia cosa Claude Code legge:

241 241 

242* **L'oggetto `managedSettings` emesso è l'unica impostazione gestita per la sessione**, incluso per le [chiavi che altrimenti legge da ogni fonte admin](#keys-read-from-every-admin-source), a parte [`forceRemoteSettingsRefresh`, che ha la sua propria regola di avvio](/docs/it/settings-reference#forceremotesettingsrefresh)242* **L'oggetto `managedSettings` emesso è l'unica impostazione gestita per la sessione**, incluso per le [chiavi che altrimenti legge da ogni fonte di amministrazione](#keys-read-from-every-admin-source), a parte [`forceRemoteSettingsRefresh`, che ha la sua propria regola di avvio](/docs/it/settings-reference#forceremotesettingsrefresh)

243 243 

244Per quali esecuzioni di helper falliscono, e cosa Claude Code fa quando una lo fa, vedi [Helper failures](/docs/it/settings-reference#helper-failures).244Per quali esecuzioni di helper falliscono, e cosa Claude Code fa quando una lo fa, vedi [Helper failures](/docs/it/settings-reference#helper-failures).

245 245 


255 255 

256Quando un'altra applicazione avvia Claude Code, come Claude Desktop, un'estensione IDE, o un'app Agent SDK, quell'host può passare le proprie impostazioni gestite attraverso l'opzione SDK `managedSettings`. Claude Code chiama queste impostazioni padre.256Quando un'altra applicazione avvia Claude Code, come Claude Desktop, un'estensione IDE, o un'app Agent SDK, quell'host può passare le proprie impostazioni gestite attraverso l'opzione SDK `managedSettings`. Claude Code chiama queste impostazioni padre.

257 257 

258Per impostazione predefinita, Claude Code ignora le impostazioni padre ogni volta che una fonte admin è presente: impostazioni gestite dal server, una policy MDM o a livello di OS, o un file di impostazioni gestite.258Per impostazione predefinita, Claude Code ignora le impostazioni padre ogni volta che una fonte di amministrazione è presente: impostazioni gestite dal server, una policy MDM o a livello di OS, o un file di impostazioni gestite.

259 259 

260Per fare in modo che Claude Code unisca le impostazioni padre insieme a una fonte admin, imposta [`parentSettingsBehavior`](/docs/it/settings-reference#parentsettingsbehavior) su `"merge"` nella fonte gestita con priorità più alta; Claude Code legge la chiave solo da quella fonte.260Per fare in modo che Claude Code esegua il merge delle impostazioni padre insieme a una fonte di amministrazione, imposta [`parentSettingsBehavior`](/docs/it/settings-reference#parentsettingsbehavior) su `"merge"` nella fonte gestita con priorità più alta; Claude Code legge la chiave solo da quella fonte.

261 261 

262Claude Code quindi mantiene solo i valori dell'host che limitano quello che Claude può fare, con un gap da conoscere: a meno che tu non imposti anche i blocchi `allowManaged*Only`, le regole di autorizzazione dell'host e gli allowlist sandbox si applicano ancora. Vedi [Limita le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) per i blocchi.262Claude Code quindi mantiene solo i valori dell'host che limitano quello che Claude può fare, con un gap da conoscere: a meno che tu non imposti anche i blocchi `allowManaged*Only`, le regole di autorizzazione dell'host e le allowlist sandbox si applicano ancora. Vedi [Limita le impostazioni padre](/docs/it/claude-apps-gateway#restrict-parent-settings) per i blocchi.

263 263 

264Un [`policyHelper`](/docs/it/settings-reference#policyhelper) può disattivare l'unione padre indipendentemente da questa chiave; la sua voce dice quando.264Un [`policyHelper`](/docs/it/settings-reference#policyhelper) può disattivare il merge delle impostazioni padre indipendentemente da questa chiave; la sua voce dice quando.

265 265 

266Claude Code applica anche questi controlli ai valori forniti dal padre da soli:266Claude Code applica anche questi controlli ai valori forniti dal padre da soli:

267 267 

268* Quando qualsiasi fonte admin imposta `allowManagedPermissionRulesOnly`, Claude Code elimina le [regole di autorizzazione fornite dal padre](/docs/it/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` mentre le legge, anche quando una fonte con priorità più alta lascia la chiave non impostata. L'effetto della chiave sulle tue stesse regole di autorizzazione proviene dalle impostazioni gestite che Claude Code applica, o dalle impostazioni padre che hai scelto di unire268* Quando qualsiasi fonte di amministrazione imposta `allowManagedPermissionRulesOnly`, Claude Code elimina le [regole di autorizzazione fornite dal padre](/docs/it/claude-apps-gateway#restrict-parent-settings) e `additionalDirectories` mentre le legge, anche quando una fonte con priorità più alta lascia la chiave non impostata. L'effetto della chiave sulle tue stesse regole di autorizzazione proviene dalle impostazioni gestite che Claude Code applica, o dalle impostazioni padre di cui hai scelto di fare il merge

269* Claude Code applica il valore `forceLoginOrgUUID` o `allowedMcpServers` nelle impostazioni gestite che applica e blocca uno fornito dal padre. Al di fuori del blocco dell'allowlist MCP, un valore in una fonte admin inferiore che Claude Code non applica né si applica né blocca quello del padre.269* Claude Code applica il valore `forceLoginOrgUUID` o `allowedMcpServers` nelle impostazioni gestite che applica e blocca uno fornito dal padre. Al di fuori del blocco dell'allowlist MCP, un valore in una fonte di amministrazione inferiore che Claude Code non applica né si applica né blocca quello del padre.

270 270 

271 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte admin con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte admin ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte admin bloccava quello del padre271 Su Claude Code v2.1.273 o successivo, mentre `allowManagedMcpServersOnly` è attivo, l'elenco `allowedMcpServers` dalla fonte di amministrazione con ranking più alto che ne imposta uno si applica e blocca quello del padre, come una [chiave cross-source](#keys-read-from-every-admin-source). L'elenco del padre si applica solo quando nessuna fonte di amministrazione ne imposta uno. La voce [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) dice quale fonte fornisce ogni chiave sotto `"merge"`. Prima della v2.1.223, un valore in qualsiasi fonte di amministrazione bloccava quello del padre

272* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre272* Per `availableModels`, Claude Code applica il valore nelle impostazioni gestite che applica e blocca un elenco fornito dal padre

273* Per `strictKnownMarketplaces`, Claude Code allo stesso modo applica l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo273* Per `strictKnownMarketplaces`, Claude Code allo stesso modo applica l'elenco nelle impostazioni gestite che applica e blocca uno fornito dal padre. L'elenco del padre si applica solo quando nessuna fonte gestita applicata ne imposta uno. Richiede Claude Code v2.1.282 o successivo

274* Per `allowedProviders`, un elenco nella [fonte gestita selezionata](#which-managed-source-claude-code-uses) blocca uno fornito dal padre, e con l'opt-in `"merge"` di [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) lo fa un elenco in qualsiasi fonte admin. Richiede Claude Code v2.1.285 o successivo274* Per `allowedProviders`, un elenco nella [fonte gestita selezionata](#which-managed-source-claude-code-uses) blocca uno fornito dal padre, e con l'opt-in `"merge"` di [`managedSourcesBehavior`](/docs/it/settings-reference#managedsourcesbehavior) lo fa un elenco in qualsiasi fonte di amministrazione. Richiede Claude Code v2.1.285 o successivo

275* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo275* Un `blockedMarketplaces` fornito dal padre si applica in aggiunta a qualsiasi blocklist che una fonte gestita imposta. Richiede Claude Code v2.1.282 o successivo

276 276 

277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">277<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">


293}293}

294```294```

295 295 

296Dopo aver distribuito la policy, Claude può salvare i file sotto quella cartella in una nuova sessione Cowork. [Leggi e modifica le regole](/docs/it/permissions#read-and-edit) coprono la sintassi del percorso, incluso il modulo `//` per i percorsi assoluti.296Dopo aver distribuito la policy, Claude può salvare i file sotto quella cartella in una nuova sessione Cowork. Le [regole Read ed Edit](/docs/it/permissions#read-and-edit) coprono la sintassi del percorso, incluso il modulo `//` per i percorsi assoluti.

297 297 

298<h3 id="what-a-developer-can-change">298<h3 id="what-a-developer-can-change">

299 Cosa uno sviluppatore può cambiare299 Cosa uno sviluppatore può cambiare

300</h3>300</h3>

301 301 

302I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sostituiscono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi stanno al di fuori di quella regola:302I file di impostazioni propri di uno sviluppatore, i valori `--settings` e i file di progetto non sovrascrivono mai un valore gestito; le [eccezioni](/docs/it/settings#exceptions-to-managed-settings-precedence) permettono solo a un valore di livello inferiore più restrittivo di contare. Questi casi stanno al di fuori di quella regola:

303 303 

304* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono ancora il modello per quella sessione, quindi distribuisci [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.304* **Il modello per una sessione**: un `model` gestito è un predefinito, non un blocco. `--model` e `ANTHROPIC_MODEL` scelgono ancora il modello per quella sessione, quindi distribuisci [`availableModels`](/docs/it/settings-reference#availablemodels) per limitare la scelta.

305* **La finestra di compattazione automatica per una sessione**: anche un [`autoCompactWindow`](/docs/it/settings-reference#autocompactwindow) gestito è un predefinito. Il flag `--autocompact` e la variabile `CLAUDE_CODE_AUTO_COMPACT_WINDOW` impostano ancora la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) per quella sessione.305* **La finestra di compattazione automatica per una sessione**: anche un [`autoCompactWindow`](/docs/it/settings-reference#autocompactwindow) gestito è un predefinito. Il flag `--autocompact` e la variabile `CLAUDE_CODE_AUTO_COMPACT_WINDOW` impostano ancora la [finestra di compattazione automatica](/docs/it/model-config#set-the-auto-compact-window) per quella sessione.

306* **Diritti admin locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.306* **Diritti di amministrazione locali**: uno sviluppatore che è un amministratore sulla macchina può modificare la fonte gestita stessa, motivo per cui gli strumenti MDM possono ridistribuire il profilo o il file su una pianificazione e motivo per cui il registro HKLM e il dominio delle preferenze gestite di macOS esistono.

307* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).307* **La cache gestita dal server**: le impostazioni gestite dal server provengono dai server di Anthropic, e una modifica alla cache locale [dura solo fino al prossimo recupero riuscito](/docs/it/server-managed-settings#security-considerations).

308* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.308* **Altri strumenti**: le impostazioni gestite vincolano solo Claude Code. Uno sviluppatore che chiama l'API da un altro strumento non è sotto di esse.

309 309 

mcp.md +7 −14

Details

142```142```

143 143 

144<Note>144<Note>

145 **Importante: Separare gli argomenti del server con `--`**

146 

147 Per i server stdio, il `--` (doppio trattino) separa le opzioni di Claude, come `--transport`, `--env`, e `--scope`, dal comando e dagli argomenti che eseguono il server. Tutto ciò che viene dopo `--` viene passato al server senza modifiche.145 Per i server stdio, il `--` (doppio trattino) separa le opzioni di Claude, come `--transport`, `--env`, e `--scope`, dal comando e dagli argomenti che eseguono il server. Tutto ciò che viene dopo `--` viene passato al server senza modifiche.

148 146 

149 Ad esempio:147 Ad esempio:


275* `✘ Rejected (see disabledMcpjsonServers in settings)`: un server `.mcp.json` che una voce [`disabledMcpjsonServers`](/docs/it/settings-reference#disabledmcpjsonservers) rifiuta. Claude Code lo mostra solo in `claude mcp get <name>`.273* `✘ Rejected (see disabledMcpjsonServers in settings)`: un server `.mcp.json` che una voce [`disabledMcpjsonServers`](/docs/it/settings-reference#disabledmcpjsonservers) rifiuta. Claude Code lo mostra solo in `claude mcp get <name>`.

276* `⊘ Disabled for this project (re-enable via /mcp)`: un server nominato dall'elenco [`disabledMcpServers`](#disable-a-server-without-removing-it) del progetto. Claude Code lo mostra sia in `claude mcp list` che in `claude mcp get <name>`. Riattiva il server dal pannello `/mcp`.274* `⊘ Disabled for this project (re-enable via /mcp)`: un server nominato dall'elenco [`disabledMcpServers`](#disable-a-server-without-removing-it) del progetto. Claude Code lo mostra sia in `claude mcp list` che in `claude mcp get <name>`. Riattiva il server dal pannello `/mcp`.

277 275 

278I server WebSocket non appaiono nell'output di `claude mcp list`. Utilizza `claude mcp get <name>` o il pannello `/mcp` per controllarli.

279 

280<h4 id="project-server-approvals-and-workspace-trust">276<h4 id="project-server-approvals-and-workspace-trust">

281 Approvazioni dei server di progetto e attendibilità del workspace277 Approvazioni dei server di progetto e attendibilità del workspace

282</h4>278</h4>


371 367 

372Su v2, Claude Code inoltre:368Su v2, Claude Code inoltre:

373 369 

374* Chiede ai server HTTP se supportano la revisione più recente, e la utilizza con quelli che la supportano. Nelle sessioni in cui recupera i feature flag, lo chiede anche ai server dei connettori claude.ai, e su Claude Code v2.1.285 o successivo lo chiede ai server stdio man mano che Anthropic distribuisce questa modifica. Per fargli porre la domanda ai server dei connettori e ai server stdio in ogni sessione, imposta [`MCP_PROTOCOL_NEGOTIATION`](/docs/it/env-vars) su `auto`. Si connette a ogni altro server come fa v1.370* Chiede ai server HTTP e stdio se supportano la revisione più recente, e la utilizza con quelli che la supportano. Nelle sessioni in cui recupera i feature flag, lo chiede anche ai server dei connettori claude.ai. Si connette a ogni altro server come fa v1.

375* Riceve le notifiche `list_changed` dai server sulla revisione più recente tramite un [flusso che mantiene aperto](#notification-streams-on-the-v2-runtime).371* Riceve le notifiche `list_changed` dai server sulla revisione più recente tramite un [flusso che mantiene aperto](#notification-streams-on-the-v2-runtime).

376* Non registra un server [canale](#push-messages-with-channels) che si connette sulla revisione più recente, perché quella revisione non può trasportare messaggi di canale.372* Non registra un server [canale](#push-messages-with-channels) che si connette sulla revisione più recente, perché quella revisione non può trasportare messaggi di canale.

377* Fa fallire un [accesso OAuth MCP](#authenticate-with-remote-mcp-servers) la cui risposta di autorizzazione indica un emittente inatteso.373* Fa fallire un [accesso OAuth MCP](#authenticate-with-remote-mcp-servers) la cui risposta di autorizzazione indica un emittente inatteso.


458 454 

459Sul [runtime v2](#mcp-client-runtimes), un server di canale che negozia la revisione del protocollo MCP 2026-07-28 non può consegnare messaggi di canale, quindi Claude Code non lo registra come canale. Un server di canale che non supporta quella revisione si connette con l'handshake precedente e si registra come prima.455Sul [runtime v2](#mcp-client-runtimes), un server di canale che negozia la revisione del protocollo MCP 2026-07-28 non può consegnare messaggi di canale, quindi Claude Code non lo registra come canale. Un server di canale che non supporta quella revisione si connette con l'handshake precedente e si registra come prima.

460 456 

461Claude Code chiede quella revisione ai server stdio quando imposti [`MCP_PROTOCOL_NEGOTIATION`](/docs/it/env-vars) su `auto`. Anthropic sta inoltre attivando questo comportamento per impostazione predefinita, per Claude Code v2.1.285 o successivo, nelle sessioni in cui Claude Code [recupera i feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching). Per mantenere un server di canale stdio sull'handshake precedente, imposta `MCP_PROTOCOL_NEGOTIATION` su `legacy`, che mantiene ogni server su di esso.457Claude Code chiede quella revisione ai server stdio per impostazione predefinita. Per mantenere un server di canale stdio sull'handshake precedente, imposta [`MCP_PROTOCOL_NEGOTIATION`](/docs/it/env-vars) su `legacy`, che mantiene ogni server su di esso.

462 458 

463<Tip>459<Tip>

464 Suggerimenti:460 Suggerimenti:


1403Quando gli strumenti MCP producono output di grandi dimensioni, Claude Code aiuta a gestire l'utilizzo dei token per evitare di sovraccaricare il contesto della conversazione:1399Quando gli strumenti MCP producono output di grandi dimensioni, Claude Code aiuta a gestire l'utilizzo dei token per evitare di sovraccaricare il contesto della conversazione:

1404 1400 

1405* **Soglia di avviso di output**: Claude Code visualizza un avviso quando l'output di qualsiasi strumento MCP supera 10.000 token1401* **Soglia di avviso di output**: Claude Code visualizza un avviso quando l'output di qualsiasi strumento MCP supera 10.000 token

1406* **Limite configurabile**: è possibile regolare il massimo numero di token di output MCP consentiti utilizzando la variabile di ambiente `MAX_MCP_OUTPUT_TOKENS`1402* **Limite configurabile**: puoi regolare il numero massimo di token di output MCP consentiti utilizzando la variabile d'ambiente `MAX_MCP_OUTPUT_TOKENS`

1407* **Limite predefinito**: il massimo predefinito è 25.000 token1403* **Limite predefinito**: il massimo predefinito è 25.000 token

1408* **Ambito**: la variabile di ambiente si applica agli strumenti che non dichiarano il proprio limite. Gli strumenti che impostano [`anthropic/maxResultSizeChars`](#raise-the-limit-for-a-specific-tool) utilizzano invece quel valore per il contenuto di testo, indipendentemente da ciò che `MAX_MCP_OUTPUT_TOKENS` è impostato. Gli strumenti che restituiscono dati di immagine sono comunque soggetti a `MAX_MCP_OUTPUT_TOKENS`1404* **Ambito**: la variabile d'ambiente si applica agli strumenti che non dichiarano il proprio limite. Gli strumenti che impostano [`anthropic/maxResultSizeChars`](#raise-the-limit-for-a-specific-tool) utilizzano invece quel valore per il contenuto di testo, indipendentemente dal valore impostato per `MAX_MCP_OUTPUT_TOKENS`. Gli strumenti che restituiscono dati di immagine sono comunque soggetti a `MAX_MCP_OUTPUT_TOKENS`

1409* **Oltre il limite**: quando un risultato riuscito senza contenuto di immagine supera il limite di token, Claude Code lo salva in un file e lo sostituisce nella conversazione con un messaggio che nomina il percorso del file, in modo che Claude legga il file quando ha bisogno del contenuto. Il file si trova nella directory `tool-results` della sessione sotto [`~/.claude/projects/`](/docs/it/claude-directory#cleaned-up-automatically).1405* **Oltre il limite**: quando un risultato riuscito senza contenuto di immagine supera il limite di token, Claude Code lo salva in un file e lo sostituisce nella conversazione con un messaggio che nomina il percorso del file, in modo che Claude legga il file quando ha bisogno del contenuto. Il file si trova nella directory `tool-results` della sessione sotto [`~/.claude/projects/`](/docs/it/claude-directory#cleaned-up-automatically).

1406* **Dimensione della risposta dai server HTTP e SSE**: Claude Code smette di leggere una risposta da un server [HTTP](#option-1-add-a-remote-http-server) o [SSE](#option-2-add-a-remote-sse-server) non appena un singolo corpo di risposta JSON, o un singolo evento di un flusso di eventi, supera i 16 MB dopo la decompressione. La richiesta a cui quella risposta risponde non riesce. Se gestisci il server, restituisci meno dati per risposta per rimanere sotto il limite, ad esempio impaginando i risultati

1410 1407 

1411Una chiamata che Claude Code ha [spostato in un'attività in background](#automatic-backgrounding-of-long-tool-calls) riporta il proprio risultato tramite la notifica dell'attività. A una chiamata che si completa in primo piano si applicano altri due limiti:1408Una chiamata che Claude Code ha [spostato in un'attività in background](#automatic-backgrounding-of-long-tool-calls) riporta il proprio risultato tramite la notifica dell'attività. A una chiamata che si completa in primo piano si applicano altri due limiti:

1412 1409 


1438}1435}

1439```1436```

1440 1437 

1441L'annotazione si applica indipendentemente da `MAX_MCP_OUTPUT_TOKENS` per il contenuto di testo, quindi gli utenti non hanno bisogno di aumentare la variabile di ambiente per gli strumenti che la dichiarano. Gli strumenti che restituiscono dati di immagine sono comunque soggetti al limite di token.1438L'annotazione si applica indipendentemente da `MAX_MCP_OUTPUT_TOKENS` per il contenuto di testo, quindi gli utenti non hanno bisogno di aumentare la variabile d'ambiente per gli strumenti che la dichiarano. Gli strumenti che restituiscono dati di immagine sono comunque soggetti al limite di token.

1442 

1443<Warning>

1444 Se incontrate frequentemente avvisi di output con server MCP specifici che non controllate, considerate di aumentare il limite `MAX_MCP_OUTPUT_TOKENS`. Potete anche chiedere all'autore del server di aggiungere l'annotazione `anthropic/maxResultSizeChars` o di impaginare le loro risposte. L'annotazione non ha effetto sugli strumenti che restituiscono contenuto di immagine; per quelli, aumentare `MAX_MCP_OUTPUT_TOKENS` è l'unica opzione.

1445</Warning>

1446 1439 

1447<h3 id="images-in-tool-results">1440<h3 id="images-in-tool-results">

1448 Immagini nei risultati degli strumenti1441 Immagini nei risultati degli strumenti


1450 1443 

1451Quando uno strumento MCP restituisce un'immagine PNG, JPEG, GIF o WebP, Claude vede l'immagine inline nella conversazione. La copia inline può essere ridimensionata o compressa per adattarsi ai limiti di dimensione dell'immagine del modello. Claude Code salva anche i byte originali in un file nella directory `tool-results` della sessione sotto [`~/.claude/projects/`](/docs/it/claude-directory#cleaned-up-automatically) e fornisce a Claude il percorso. Claude può quindi ritagliare, convertire o riutilizzare il file a risoluzione completa con strumenti come Bash.1444Quando uno strumento MCP restituisce un'immagine PNG, JPEG, GIF o WebP, Claude vede l'immagine inline nella conversazione. La copia inline può essere ridimensionata o compressa per adattarsi ai limiti di dimensione dell'immagine del modello. Claude Code salva anche i byte originali in un file nella directory `tool-results` della sessione sotto [`~/.claude/projects/`](/docs/it/claude-directory#cleaned-up-automatically) e fornisce a Claude il percorso. Claude può quindi ritagliare, convertire o riutilizzare il file a risoluzione completa con strumenti come Bash.

1452 1445 

1453Se disabilitate la persistenza della sessione con [`--no-session-persistence`](/docs/it/cli-reference#cli-flags) o [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars), Claude Code non scrive alcun file di immagine e Claude riceve solo la copia inline.1446Se disabiliti la persistenza della sessione con [`--no-session-persistence`](/docs/it/cli-reference#cli-flags) o [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars), Claude Code non scrive alcun file di immagine e Claude riceve solo la copia inline.

1454 1447 

1455Il salvataggio dei risultati delle immagini MCP in un file richiede Claude Code v2.1.283 o versioni successive.1448Il salvataggio dei risultati delle immagini MCP in un file richiede Claude Code v2.1.283 o versioni successive.

1456 1449 

memory.md +5 −3

Details

161 161 

162Tutti i file scoperti vengono concatenati in contesto invece di sovrascriversi a vicenda. Nell'albero delle directory, il contenuto è ordinato dalla radice del filesystem fino alla tua directory di lavoro. Per l'esempio `foo/bar/`, `foo/CLAUDE.md` appare in contesto prima di `foo/bar/CLAUDE.md`, quindi le istruzioni più vicine a dove hai avviato Claude vengono lette per ultime. All'interno di ogni directory, `CLAUDE.local.md` viene aggiunto dopo `CLAUDE.md`, quindi le tue note personali sono l'ultima cosa che Claude legge a quel livello.162Tutti i file scoperti vengono concatenati in contesto invece di sovrascriversi a vicenda. Nell'albero delle directory, il contenuto è ordinato dalla radice del filesystem fino alla tua directory di lavoro. Per l'esempio `foo/bar/`, `foo/CLAUDE.md` appare in contesto prima di `foo/bar/CLAUDE.md`, quindi le istruzioni più vicine a dove hai avviato Claude vengono lette per ultime. All'interno di ogni directory, `CLAUDE.local.md` viene aggiunto dopo `CLAUDE.md`, quindi le tue note personali sono l'ultima cosa che Claude legge a quel livello.

163 163 

164Claude scopre anche i file `CLAUDE.md` e `CLAUDE.local.md` nelle sottodirectory sotto la tua directory di lavoro corrente. Invece di caricarli all'avvio, Claude Code li include quando Claude utilizza lo strumento [Read](/docs/it/tools-reference#read-tool-behavior), [Write](/docs/it/tools-reference#write-tool-behavior) o [Edit](/docs/it/tools-reference#edit-tool-behavior) su un file in quelle sottodirectory. Se Claude ha già utilizzato uno di questi strumenti sul `CLAUDE.md` stesso di una sottodirectory, quel file non viene caricato in questo modo, perché Claude Code lo considera già presente nella conversazione. Per i file all'interno di un worktree sotto `.claude/worktrees/`, consulta [Isolare i subagent con i worktree](/docs/it/worktrees#isolate-subagents-with-worktrees).164Claude scopre anche i file `CLAUDE.md` e `CLAUDE.local.md` nelle sottodirectory sotto la tua directory di lavoro corrente. Invece di caricarli all'avvio, Claude Code carica ciascuno di essi quando Claude legge, scrive o modifica un altro file in quella sottodirectory. La lettura include la visualizzazione del file con un comando Bash che [conta come lettura](/docs/it/tools-reference#edit-tool-behavior), come `cat` o `head` su un singolo file. Per i file all'interno di un worktree sotto `.claude/worktrees/`, consulta [Isolare i subagent con i worktree](/docs/it/worktrees#isolate-subagents-with-worktrees).

165 165 

166Se lavori in un grande monorepo in cui vengono raccolti i file CLAUDE.md di altri team, utilizza [`claudeMdExcludes`](#exclude-specific-claude-md-files) per saltarli. Per il layout completo dei file CLAUDE.md e delle regole a livello di radice e per directory, consulta [Monorepo e repository di grandi dimensioni](/docs/it/large-codebases).166Se lavori in un grande monorepo in cui vengono raccolti i file CLAUDE.md di altri team, utilizza [`claudeMdExcludes`](#exclude-specific-claude-md-files) per saltarli. Per il layout completo dei file CLAUDE.md e delle regole a livello di radice e per directory, consulta [Monorepo e repository di grandi dimensioni](/docs/it/large-codebases).

167 167 


232- Includi commenti di documentazione OpenAPI232- Includi commenti di documentazione OpenAPI

233```233```

234 234 

235Le regole senza un campo `paths` vengono caricate incondizionatamente e si applicano a tutti i file. Le regole con ambito di percorso si attivano quando Claude utilizza lo strumento Read, Write o Edit su un file che corrisponde al modello, non a ogni utilizzo di uno strumento. La corrispondenza funziona anche quando Claude raggiunge un file attraverso un percorso che è un collegamento simbolico alla directory del progetto, ad esempio in un checkout collegato tramite collegamento simbolico.235Le regole senza un campo `paths` vengono caricate incondizionatamente e si applicano a tutti i file. Una regola con ambito di percorso si carica quando Claude utilizza lo strumento Read, Write o Edit su un file corrispondente. Si carica anche quando Claude visualizza un file corrispondente con un comando Bash che [conta come lettura](/docs/it/tools-reference#edit-tool-behavior), come `cat` o `head` su un singolo file. La corrispondenza funziona anche quando Claude raggiunge un file attraverso un percorso che è un collegamento simbolico alla directory del progetto, ad esempio in un checkout collegato tramite collegamento simbolico.

236 236 

237Utilizza i modelli glob nel campo `paths` per far corrispondere i file per estensione, directory o qualsiasi combinazione:237Utilizza i modelli glob nel campo `paths` per far corrispondere i file per estensione, directory o qualsiasi combinazione:

238 238 


278 278 

279La directory `.claude/rules/` supporta i collegamenti simbolici, quindi puoi mantenere un set di regole condivise e collegarle in più progetti. I collegamenti simbolici circolari vengono rilevati e gestiti correttamente.279La directory `.claude/rules/` supporta i collegamenti simbolici, quindi puoi mantenere un set di regole condivise e collegarle in più progetti. I collegamenti simbolici circolari vengono rilevati e gestiti correttamente.

280 280 

281Claude Code tratta un collegamento simbolico la cui destinazione è al di fuori della tua directory di lavoro come un'[importazione esterna](#import-additional-files). Le regole collegate non si caricano finché non approvi le importazioni esterne per il progetto, e dopo di che si caricano solo quelle senza un [campo `paths`](#path-specific-rules). Claude Code chiede quell'approvazione solo quando un file di memoria di progetto importa un file al di fuori della directory di lavoro con `@path`, non per i soli collegamenti simbolici. Per caricare le regole condivise senza quell'approvazione, mantienile in [`~/.claude/rules/`](#user-level-rules), dove si applicano a ogni progetto sulla tua macchina.281Claude Code tratta un collegamento simbolico la cui destinazione è al di fuori della tua directory di lavoro come un'[importazione esterna](#import-additional-files). Le regole collegate non si caricano finché non approvi le importazioni esterne per il progetto, e dopo di che si caricano solo quelle senza un [campo `paths`](#path-specific-rules).

282 

283Claude Code chiede quell'approvazione una sola volta per progetto, in una finestra di dialogo all'inizio di una sessione interattiva. La finestra di dialogo elenca i file di regole collegati insieme a eventuali importazioni `@path` esterne. Per caricare le regole condivise senza quell'approvazione, mantienile in [`~/.claude/rules/`](#user-level-rules), dove si applicano a ogni progetto sulla tua macchina.

282 284 

283Questo esempio collega sia una directory condivisa che un singolo file:285Questo esempio collega sia una directory condivisa che un singolo file:

284 286 

Details

116 2) Configure Azure credentials116 2) Configure Azure credentials

117</h3>117</h3>

118 118 

119Claude Code supporta tre metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza.119Claude Code supporta tre metodi di autenticazione per Microsoft Foundry. Scegli il metodo che meglio si adatta ai tuoi requisiti di sicurezza:

120 120 

121**Option A: API key authentication**121* [Chiave API](#use-an-api-key): copi una chiave dal portale Microsoft Foundry e la imposti come `ANTHROPIC_FOUNDRY_API_KEY`

122* [Microsoft Entra ID](#use-microsoft-entra-id): Claude Code ottiene i token tramite la catena di credenziali predefinita di Azure SDK, ad esempio da una sessione `az login`, quindi non c'è alcuna chiave API da memorizzare

123* [Token bearer](#use-a-bearer-token): un altro processo ottiene un token di accesso Microsoft Entra ID e tu lo passi in `ANTHROPIC_FOUNDRY_AUTH_TOKEN`

124 

125<Note>

126 Quando si utilizza Microsoft Foundry, il comando `/logout` non è disponibile poiché l'autenticazione viene gestita tramite le credenziali Azure.

127</Note>

128 

129<h4 id="use-an-api-key">

130 Usa una chiave API

131</h4>

132 

133Copia una chiave dal portale Microsoft Foundry, quindi impostala come variabile d'ambiente:

122 134 

1231. Accedi alla tua risorsa nel portale Microsoft Foundry1351. Accedi alla tua risorsa nel portale Microsoft Foundry

1242. Vai alla sezione **Endpoints and keys**1362. Apri la sezione **Endpoints and keys**

1253. Copia **API Key**1373. Copia **API Key**

1264. Imposta la variabile d'ambiente, sostituendo `your-azure-api-key` con la chiave che hai copiato:1384. Imposta la variabile d'ambiente, sostituendo `your-azure-api-key` con la chiave che hai copiato:

127 139 


129export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key141export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

130```142```

131 143 

132**Option B: Microsoft Entra ID authentication**144<h4 id="use-microsoft-entra-id">

145 Usa Microsoft Entra ID

146</h4>

133 147 

134Quando né `ANTHROPIC_FOUNDRY_API_KEY` né `ANTHROPIC_FOUNDRY_AUTH_TOKEN` sono impostati, Claude Code utilizza automaticamente la [catena di credenziali predefinita](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) di Azure SDK.148Lascia `ANTHROPIC_FOUNDRY_API_KEY` e `ANTHROPIC_FOUNDRY_AUTH_TOKEN` non impostati. Claude Code utilizza quindi la [catena di credenziali predefinita](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview) di Azure SDK.

135Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.149Questo supporta una varietà di metodi per autenticare carichi di lavoro locali e remoti.

136 150 

137Negli ambienti locali, puoi comunemente utilizzare Azure CLI:151Su una macchina locale, accedi con Azure CLI:

138 152 

139```bash theme={null}153```bash theme={null}

140az login154az login

141```155```

142 156 

143**Option C: Bearer token authentication**157Per i ruoli necessari alla tua identità, consulta [Configurazione di Azure RBAC](#azure-rbac-configuration).

158 

159<h4 id="use-a-bearer-token">

160 Usa un token bearer

161</h4>

144 162 

145Claude Code invia il valore di `ANTHROPIC_FOUNDRY_AUTH_TOKEN` su ogni richiesta come intestazione `Authorization: Bearer`. Utilizza questa opzione quando un altro processo, come un'applicazione host o uno script di accesso, ha già ottenuto un token di accesso per te. Richiede Claude Code v2.1.203 o successivo.163Claude Code invia il valore di `ANTHROPIC_FOUNDRY_AUTH_TOKEN` su ogni richiesta come intestazione `Authorization: Bearer`. Utilizza questa opzione quando un altro processo, come un'applicazione host o uno script di accesso, ha già ottenuto un token di accesso per te. Richiede Claude Code v2.1.203 o successivo.

146 164 


152 170 

153`ANTHROPIC_FOUNDRY_AUTH_TOKEN` ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita.171`ANTHROPIC_FOUNDRY_AUTH_TOKEN` ha la precedenza su `ANTHROPIC_FOUNDRY_API_KEY` e sulla catena di credenziali predefinita.

154 172 

155<Note>

156 Quando si utilizza Microsoft Foundry, il comando `/logout` non è disponibile poiché l'autenticazione viene gestita tramite le credenziali Azure.

157</Note>

158 

159<h3 id="3-configure-claude-code">173<h3 id="3-configure-claude-code">

160 3. Configure Claude Code174 3. Configure Claude Code

161</h3>175</h3>


240 254 

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

242 256 

257<h2 id="1m-token-context-window">

258 Finestra di contesto da 1M token

259</h2>

260 

261Su Microsoft Foundry, quando Claude Code riesce a determinare quale modello serve il tuo deploy, i modelli Fable, Sonnet 5 e successivi e Opus 4.7 e successivi vengono eseguiti con la [finestra di contesto da 1M token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per impostazione predefinita, senza bisogno del suffisso `[1m]`. Claude Code ricava il modello dal nome del deploy nelle tue variabili del modello. Assegna a ciascun deploy come nome il relativo ID del modello, ad esempio `claude-opus-4-8`, oppure associa il modello al nome del tuo deploy con [`modelOverrides`](/docs/it/model-config#override-model-ids-per-version). Per un nome di deploy che non riesce ad associare a un modello, Claude Code presuppone una finestra da 200K, a meno che tu non [ne dichiari una diversa](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id).

262 

263Questa voce di `settings.json` indica a Claude Code che un deploy chiamato `team-opus-prod` serve Opus 4.8:

264 

265```json theme={null}

266{

267 "modelOverrides": {

268 "claude-opus-4-8": "team-opus-prod"

269 }

270}

271```

272 

273Per mantenere invece una finestra da 200K, imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/model-config#turn-off-1m-context).

274 

275Opus 4.6 e Sonnet 4.6 raggiungono la finestra da 1M quando aggiungi `[1m]` al nome del deploy in `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`, come descritto in [Fissare i modelli per i deploy di terze parti](/docs/it/model-config#pin-models-for-third-party-deployments). Prima della v2.1.287, anche i modelli Fable e Opus 4.7 e successivi richiedevano quel suffisso su Microsoft Foundry e, senza di esso, venivano eseguiti con una finestra da 200K per impostazione predefinita.

276 

243<h2 id="troubleshooting">277<h2 id="troubleshooting">

244 Risoluzione dei problemi278 Risoluzione dei problemi

245</h2>279</h2>

model-config.md +292 −281

Details

10 Modelli disponibili10 Modelli disponibili

11</h2>11</h2>

12 12 

13Per l'impostazione `model` in Claude Code, è possibile configurare:13Per l'impostazione `model` in Claude Code, puoi configurare:

14 14 

15* Un **alias del modello**15* Un **alias del modello**

16* Un **nome del modello**16* Un **nome del modello**


19 * Microsoft Foundry: un nome di distribuzione19 * Microsoft Foundry: un nome di distribuzione

20 * Agent Platform di Google Cloud: un nome di versione20 * Agent Platform di Google Cloud: un nome di versione

21 21 

22Per indicazioni su quale modello e livello di impegno si adattano a diversi tipi di lavoro, consultare [Scelta di un modello Claude e livello di impegno in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.22Per indicazioni su quale modello e livello di sforzo si adattano a diversi tipi di lavoro, consulta [Scelta di un modello Claude e livello di sforzo in Claude Code](https://claude.com/blog/claude-model-and-effort-level-in-claude-code) sul blog.

23 23 

24<Note>24<Note>

25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello le risponde. Per instradare Claude attraverso un gateway LLM, consultare [Gateway LLM](/docs/it/llm-gateway).25 `ANTHROPIC_BASE_URL` cambia dove vengono inviate le richieste, non quale modello risponde. Per instradare Claude attraverso un gateway LLM, consulta [Gateway LLM](/docs/it/llm-gateway).

26</Note>26</Note>

27 27 

28<h3 id="model-aliases">28<h3 id="model-aliases">

29 Alias dei modelli29 Alias dei modelli

30</h3>30</h3>

31 31 

32Utilizzare un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:32Usa un alias del modello per selezionare le impostazioni del modello senza ricordare i numeri di versione esatti:

33 33 

34| Alias del modello | Comportamento |34| Alias del modello | Comportamento |

35| - | - |35| - | - |

36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il vostro account](#default-model-setting). Non è di per sé un alias del modello |36| **`default`** | Valore speciale che cancella qualsiasi override del modello e ripristina il [valore predefinito di runtime per il tuo account](#default-model-setting). Non è di per sé un alias del modello |

37| **`best`** | Utilizza il modello a cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per voi, altrimenti lo stesso modello di `opus` |37| **`best`** | Usa il modello in cui si risolve l'alias [`fable`](#fable-alias-resolution) dove Fable è disponibile per te, altrimenti lo stesso modello di `opus` |

38| **`fable`** | Utilizza il [modello Fable per il vostro provider](#fable-alias-resolution) per i vostri compiti più difficili e lunghi |38| **`fable`** | Usa il [modello Fable per il tuo provider](#fable-alias-resolution) per i tuoi compiti più difficili e più lunghi |

39| **`sonnet`** | Utilizza il modello Sonnet più recente per i compiti di codifica quotidiani |39| **`sonnet`** | Usa il modello Sonnet più recente per i compiti di programmazione quotidiani |

40| **`opus`** | Utilizza il modello Opus più recente per i compiti di ragionamento complesso |40| **`opus`** | Usa il modello Opus più recente per i compiti di ragionamento complesso |

41| **`haiku`** | Utilizza il modello Haiku veloce ed efficiente per i compiti semplici |41| **`haiku`** | Usa il modello Haiku veloce ed efficiente per i compiti semplici |

42| **`sonnet[1m]`** | Utilizza Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5.5 o Sonnet 5 con la sua finestra nativa di 1M |42| **`sonnet[1m]`** | Usa Sonnet con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `sonnet` si risolve già in Sonnet 5.5 o Sonnet 5 con la loro finestra nativa di 1M |

43| **`opus[1m]`** | Utilizza Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe |43| **`opus[1m]`** | Usa Opus con una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe. Nessun effetto quando `opus` si risolve già in Opus 4.7 o successivo con la sua finestra nativa di 1M |

44| **`opusplan`** | Modalità speciale che utilizza `opus` durante la modalità piano, quindi passa a `sonnet` per l'esecuzione |44| **`opusplan`** | Modalità speciale che usa `opus` durante il plan mode, quindi passa a `sonnet` per l'esecuzione |

45 45 

46Gli alias `opus`, `sonnet` e `haiku` si risolvono nella versione più recente sull'API Anthropic e in una versione precedente su alcuni altri provider:46Gli alias `opus`, `sonnet` e `haiku` si risolvono nella versione più recente sull'API Anthropic e in una versione precedente su alcuni altri provider:

47 47 


54 54 

55<span id="fable-alias-resolution" />55<span id="fable-alias-resolution" />

56 56 

57A meno che non impostiate `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni di [gateway delle app Claude](/docs/it/claude-apps-gateway), dove `fable` e `best` si risolvono in Fable 5.57A meno che tu non imposti `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5.1, tranne nelle sessioni del [gateway delle app Claude](/docs/it/claude-apps-gateway), dove `fable` e `best` si risolvono in Fable 5.

58 58 

59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per utilizzare Fable 5.1 attraverso un gateway che lo serve, selezionarlo con `/model claude-fable-5-1`.59Un gateway non configurato per servire `claude-fable-5-1` rifiuta le richieste per quel modello. Per usare Fable 5.1 attraverso un gateway che lo serve, selezionalo con `/model claude-fable-5-1`.

60 60 

61Dove `opus` o `sonnet` si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando esplicitamente il nome completo del modello o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.61Dove `opus` o `sonnet` si risolve in un modello più vecchio, i modelli più recenti sono disponibili selezionando esplicitamente il nome completo del modello o impostando `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`.

62 62 

63Le versioni precedenti risolvono questi alias a modelli più vecchi. Per la versione in cui ogni alias è cambiato, consultare [Cronologia delle versioni](#version-history).63Le versioni precedenti risolvono questi alias in modelli più vecchi. Per la versione in cui ogni alias è cambiato, consulta [Cronologia delle versioni](#version-history).

64 64 

65Gli alias puntano alla versione consigliata per il vostro provider e si aggiornano nel tempo. Per fissare una versione specifica, utilizzare il nome completo del modello, ad esempio `claude-opus-5-5`, o impostare la variabile di ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.65Gli alias puntano alla versione consigliata per il tuo provider e si aggiornano nel tempo. Per fissare una versione specifica, usa il nome completo del modello, ad esempio `claude-opus-5-5`, o imposta la variabile d'ambiente corrispondente come `ANTHROPIC_DEFAULT_OPUS_MODEL`.

66 66 

67<Note>67<Note>

68 Sonnet 5.5 richiede Claude Code v2.1.284 o successiva, e Opus 5.5 richiede v2.1.280 o successiva. Se una richiesta per uno di essi da una versione precedente non riesce, consulta [Claude Code non supporta questo modello](/docs/it/errors#claude-code-does-not-support-this-model). Usa v2.1.293 o successiva con Haiku 5.5. Esegui `claude update` per aggiornare.68 Sonnet 5.5 richiede Claude Code v2.1.284 o successiva, e Opus 5.5 richiede v2.1.280 o successiva. Se una richiesta per uno di essi da una versione precedente non riesce, consulta [Claude Code non supporta questo modello](/docs/it/errors#claude-code-does-not-support-this-model). Usa v2.1.293 o successiva con Haiku 5.5. Esegui `claude update` per aggiornare.


72 Lavorare con Fable72 Lavorare con Fable

73</h3>73</h3>

74 74 

75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione. Sostengono lunghe sessioni autonome, investigano prima di agire e verificano il loro lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.75[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) e Claude Fable 5 sono i modelli più capaci in Claude Code, adatti a compiti più grandi di una singola sessione di lavoro. Sostengono lunghe sessioni autonome, indagano prima di agire e verificano il proprio lavoro più spesso rispetto ai modelli più piccoli. Fable 5.1 è la versione più recente.

76 76 

77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionarne uno esplicitamente:77Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionane uno esplicitamente:

78 78 

79* **Fable 5.1**: eseguire `/model fable`, o avviare con `claude --model fable`. Nelle sessioni di [gateway delle app Claude](/docs/it/claude-apps-gateway), dove l'alias si risolve in Fable 5, eseguire invece `/model claude-fable-5-1`.79* **Fable 5.1**: esegui `/model fable`, o avvia con `claude --model fable`. Nelle sessioni del [gateway delle app Claude](/docs/it/claude-apps-gateway), dove l'alias si risolve in Fable 5, esegui invece `/model claude-fable-5-1`.

80* **Fable 5**: selezionarlo per ID del modello. Sull'API Anthropic, eseguire `/model claude-fable-5` o avviare con `claude --model claude-fable-5`. Su altri provider, utilizzare l'ID del modello Fable 5 del vostro provider o [fissarlo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.80* **Fable 5**: selezionalo tramite l'ID del modello. Sull'API Anthropic, esegui `/model claude-fable-5` o avvia con `claude --model claude-fable-5`. Su altri provider, usa l'ID del modello Fable 5 del tuo provider o [fissalo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.

81 81 

82Se vi connettete direttamente all'API Anthropic e le impostazioni dell'utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché avete selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che eseguite v2.1.257 o successiva. La riga del modello di avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane come è.82Se ti connetti direttamente all'API Anthropic e le tue impostazioni utente contengono `claude-fable-5` o `claude-fable-5[1m]` come modello, ad esempio perché hai selezionato Fable nel selettore `/model` prima della v2.1.257, Claude Code cambia quel valore salvato nell'alias `fable` o `fable[1m]` la prima volta che esegui la v2.1.257 o successiva. La riga del modello all'avvio mostra `(auto-updated)` una volta. Un valore `claude-fable-5` nelle impostazioni di progetto, locali o gestite rimane invariato.

83 83 

84Le richieste che i classificatori di sicurezza di un modello Fable contrassegnano, più spesso nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).84Le richieste che i classificatori di sicurezza di un modello Fable segnalano, più spesso nei domini della sicurezza informatica e della biologia, attivano il [fallback automatico del modello](#automatic-model-fallback).

85 85 

86Per ottenere il massimo da Fable:86Per ottenere il massimo da Fable:

87 87 

88* **Descrivere il risultato, non i passaggi**: fornitegli il risultato che desiderate e lasciate che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [impostare un obiettivo](/docs/it/goal).88* **Descrivi il risultato, non i passaggi**: indicagli il risultato che desideri e lascia che pianifichi il percorso. Per mantenerlo orientato verso quel risultato, [imposta un obiettivo](/docs/it/goal).

89* **Fornitegli problemi ambigui**: le indagini sulla causa principale, il debug dei disservizi e le decisioni architettoniche sono dove l'investigazione e la verifica aggiuntive ripagano.89* **Affidagli problemi ambigui**: le indagini sulla causa principale, il debug dei disservizi e le decisioni architetturali sono i casi in cui l'indagine e la verifica aggiuntive ripagano.

90* **Saltate i promemoria di verifica**: verifica il suo lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare sono solitamente non necessari.90* **Salta i promemoria di verifica**: verifica il proprio lavoro con meno sollecitazioni, quindi i promemoria per testare o controllare di solito non sono necessari.

91* **Dimensionate i compiti più grandi**: fornitegli il lavoro che normalmente dividereste in pezzi. Sostiene lunghe sessioni senza perdere il filo.91* **Aumenta la dimensione dei compiti**: affidagli lavoro che normalmente divideresti in parti. Sostiene lunghe sessioni senza perdere il filo.

92 92 

93<Note>93<Note>

94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta da una versione precedente non riesce, consultare [Claude Code non supporta questo modello](/docs/it/errors#claude-code-does-not-support-this-model). Eseguire `claude update` per aggiornare. Per la disponibilità con conservazione dati zero, consultare [Disponibilità del modello con ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).94 Fable 5.1 richiede Claude Code v2.1.257 o successiva. Se una richiesta da una versione precedente non riesce, consulta [Claude Code non supporta questo modello](/docs/it/errors#claude-code-does-not-support-this-model). Esegui `claude update` per aggiornare. Per la disponibilità con conservazione dati zero, consulta [Disponibilità del modello con ZDR](/docs/it/zero-data-retention#model-availability-under-zdr).

95</Note>95</Note>

96 96 

97Sull'API Anthropic, un modello Fable appare nel selettore `/model` a meno che [`availableModels`](#restrict-model-selection) o [restrizioni del modello dell'organizzazione](#organization-model-restrictions) lo escludano. Quando la vostra organizzazione non può utilizzare Fable affatto, ad esempio con [conservazione dati zero](/docs/it/zero-data-retention#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.97Sull'API Anthropic, un modello Fable appare nel selettore `/model` a meno che [`availableModels`](#restrict-model-selection) o le [restrizioni del modello dell'organizzazione](#organization-model-restrictions) lo escludano. Quando la tua organizzazione non può usare Fable in alcun modo, ad esempio con la [conservazione dati zero](/docs/it/zero-data-retention#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.

98 98 

99<h4 id="fable-and-usage-credits">99<h4 id="fable-and-usage-credits">

100 Fable e crediti di utilizzo100 Fable e crediti di utilizzo

101</h4>101</h4>

102 102 

103A seconda del vostro piano e livello di posto, l'utilizzo di Fable può fatturare ai [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel vostro piano. Quando lo fa, il selettore `/model` mostra "Richiede crediti di utilizzo" sulla riga Fable. Per gestire i crediti di utilizzo, consultare [Aggiungere crediti di utilizzo al vostro abbonamento](/docs/it/costs#add-usage-credits-to-your-subscription).103A seconda del tuo piano e del livello della tua postazione, l'utilizzo di Fable può essere addebitato sui [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) invece di attingere ai limiti inclusi nel tuo piano. In questo caso, il selettore `/model` mostra "Richiede crediti di utilizzo" sulla riga di Fable. Per gestire i crediti di utilizzo, consulta [Aggiungere crediti di utilizzo al tuo abbonamento](/docs/it/costs#add-usage-credits-to-your-subscription).

104 104 

105Nelle sessioni interattive, Claude Code mostra un prompt di consenso prima che una richiesta Fable fatturi i crediti di utilizzo. I membri dei piani Enterprise con fatturazione organizzativa non vedono il prompt. Potete continuare su Fable utilizzando i crediti di utilizzo o passare al vostro modello predefinito. Potete anche chiudere il prompt:105Nelle sessioni interattive, Claude Code mostra una richiesta di consenso prima che una richiesta Fable venga addebitata sui crediti di utilizzo. I membri dei piani Enterprise con fatturazione a livello di organizzazione non vedono la richiesta. Puoi continuare su Fable usando i crediti di utilizzo o passare al tuo modello predefinito. Puoi anche chiudere la richiesta:

106 106 

107* Quando selezionate un modello Fable con `/model`, mantenete il vostro modello attuale.107* Quando selezioni un modello Fable con `/model`, mantieni il tuo modello attuale.

108* A metà sessione, Claude Code continua il turno sul vostro modello predefinito.108* A metà sessione, Claude Code continua il turno sul tuo modello predefinito.

109 109 

110Dopo aver scelto di continuare su Fable utilizzando i crediti di utilizzo, Claude Code non mostra più il prompt.110Dopo che hai scelto di continuare su Fable usando i crediti di utilizzo, Claude Code non mostra più la richiesta.

111 111 

112In una sessione con [Remote Control](/docs/it/remote-control) connesso, una [sessione in background](/docs/it/agent-view), o una sessione di un compagno di [team di agenti](/docs/it/agent-teams), nessuno potrebbe essere al terminale, quindi Claude Code tiene il prompt di consenso a metà sessione per la scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che il client Remote Control mostra anche. La vostra selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al vostro prossimo messaggio.112In una sessione con [Remote Control](/docs/it/remote-control) connesso, in una [sessione in background](/docs/it/agent-view) o nella sessione di un membro di un [team di agenti](/docs/it/agent-teams), potrebbe non esserci nessuno al terminale, quindi Claude Code mantiene la richiesta di consenso a metà sessione fino alla scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), cinque minuti per impostazione predefinita. Se nessuno ha risposto entro la scadenza, Claude Code termina il turno senza inviare la richiesta e aggiunge un avviso alla trascrizione, che viene mostrato anche dal client Remote Control. La tua selezione del modello rimane invariata e Claude Code chiede di nuovo il consenso al tuo prossimo messaggio.

113 113 

114Quello che potete fare mentre il prompt è in attesa dipende dalla sessione:114Cosa puoi fare mentre la richiesta è in attesa dipende dalla sessione:

115 115 

116* Con Remote Control connesso o in una sessione di un compagno, premete un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la vostra risposta.116* Con Remote Control connesso o nella sessione di un membro del team, premi un tasto qualsiasi al terminale per annullare la scadenza, e Claude Code attende la tua risposta.

117* In una sessione in background, rispondete prima della scadenza.117* In una sessione in background, rispondi prima della scadenza.

118* Se inviate un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il vostro nuovo messaggio inizia il turno successivo. Dopo che qualcuno digita al terminale, Claude Code continua ad aspettare la risposta e mette in coda il vostro nuovo messaggio dietro di essa.118* Se invii un nuovo messaggio dal client remoto prima che qualcuno abbia digitato al terminale, Claude Code termina il turno allo stesso modo e il tuo nuovo messaggio avvia il turno successivo. Dopo che qualcuno ha digitato al terminale, Claude Code continua ad attendere la risposta e mette in coda il tuo nuovo messaggio dopo di essa.

119 119 

120In una sessione un'altra applicazione ospita attraverso l'[Agent SDK](/docs/it/agent-sdk/overview), se il prompt appare dipende da quell'applicazione. Se appare e nessuno risponde prima della stessa scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), Claude Code termina il turno senza inviare la richiesta.120In una sessione ospitata da un'altra applicazione tramite l'[Agent SDK](/docs/it/agent-sdk/overview), è quell'applicazione a decidere se la richiesta appare. Se appare e nessuno risponde prima della stessa scadenza [`dialogExpiry`](/docs/it/settings-reference#dialogexpiry), Claude Code termina il turno senza inviare la richiesta.

121 121 

122In [modalità non interattiva](/docs/it/headless) con il flag `-p`, e in un'applicazione Agent SDK che non mostra il prompt, Claude Code non chiede mai il consenso. Quando una richiesta Fable lì fatturasse ai crediti di utilizzo, Claude Code la fattura senza chiedere.122In [modalità non interattiva](/docs/it/headless) con il flag `-p`, e in un'applicazione Agent SDK che non mostra la richiesta, Claude Code non chiede mai il consenso. Quando in quei casi una richiesta Fable verrebbe addebitata sui crediti di utilizzo, Claude Code la addebita senza chiedere.

123 123 

124<h3 id="setting-your-model">124<h3 id="setting-your-model">

125 Impostazione del vostro modello125 Impostare il modello

126</h3>126</h3>

127 127 

128Potete configurare il vostro modello in diversi modi, elencati in ordine di priorità:128Puoi configurare il modello in diversi modi, elencati in ordine di priorità:

129 129 

1301. **Durante la sessione**: utilizzare `/model <alias|name>` per passare immediatamente, o eseguire `/model` senza argomenti per aprire il selettore. Consultare [quando Claude Code vi chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)1301. **Durante la sessione**: usa `/model <alias|name>` per passare immediatamente, o esegui `/model` senza argomenti per aprire il selettore. Consulta [quando Claude Code ti chiede di confermare il passaggio](/docs/it/prompt-caching#switching-models)

1312. **All'avvio**: avviare con `claude --model <alias|name>`1312. **All'avvio**: avvia con `claude --model <alias|name>`

1323. **Variabile di ambiente**: impostare `ANTHROPIC_MODEL=<alias|name>`1323. **Variabile d'ambiente**: imposta `ANTHROPIC_MODEL=<alias|name>`

1334. **Impostazioni**: configurare permanentemente nel vostro file di impostazioni utilizzando il campo `model`1334. **Impostazioni**: configura in modo permanente nel tuo file di impostazioni usando il campo `model`

1345. **[Valore predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>`1345. **[Valore predefinito per le nuove sessioni](#set-a-default-model-for-new-sessions)**: imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>`

135 135 

136`/model` salva la vostra scelta come valore predefinito per le nuove sessioni scrivendo il campo `model` nelle impostazioni dell'utente. Nel selettore:136`/model` salva la tua scelta come valore predefinito per le nuove sessioni scrivendo il campo `model` nelle tue impostazioni utente. Nel selettore:

137 137 

138* `Enter`: passa il modello e salva come vostro valore predefinito138* `Enter`: cambia modello e lo salva come tuo valore predefinito

139* `s`: passa il modello solo per questa sessione e lascia il vostro valore predefinito invariato. Per utilizzare un tasto diverso, riassegnare [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)139* `s`: cambia modello solo per questa sessione e lascia invariato il tuo valore predefinito. Per usare un tasto diverso, riassegna [`modelPicker:thisSessionOnly`](/docs/it/keybindings#model-picker-actions)

140 140 

141Digitare `/model <name>` direttamente si comporta come `Enter`. Per passare solo per questa sessione, aprire il selettore con `/model` e premere `s` sulla riga del modello.141Digitare direttamente `/model <name>` si comporta come `Enter`. Per cambiare solo per questa sessione, apri il selettore con `/model` e premi `s` sulla riga del modello.

142 142 

143Su un piano Enterprise, quando siete connessi con il vostro account claude.ai e salvate un valore predefinito con `/model`, Claude Code registra anche la scelta su quell'account. Questo richiede Claude Code v2.1.280 o successiva.143Su un piano Enterprise, quando hai effettuato l'accesso con il tuo account claude.ai e salvi un valore predefinito con `/model`, Claude Code registra la scelta anche su quell'account. Questo richiede Claude Code v2.1.280 o successiva.

144 144 

145* Quando il vostro amministratore non ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), l'opzione [Predefinito](#default-model-setting) può risolversi al modello registrato, e quando lo fa, la riga Predefinito del selettore mostra il nome di quel modello.145* Quando il tuo amministratore non ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), l'[opzione Predefinito](#default-model-setting) può risolversi nel modello registrato e, in tal caso, la riga Predefinito del selettore mostra il nome di quel modello.

146* Se le [restrizioni del modello](#restrict-model-selection) escludono il modello registrato o non è disponibile per il vostro account, e il vostro amministratore non ha impostato un modello predefinito dell'organizzazione, l'opzione Predefinito si risolve come se nulla fosse stato registrato.146* Se le [restrizioni del modello](#restrict-model-selection) escludono il modello registrato o questo non è disponibile per il tuo account, e il tuo amministratore non ha impostato un modello predefinito dell'organizzazione, l'opzione Predefinito si risolve come se nulla fosse stato registrato.

147* Se scegliete Predefinito o `opusplan` in `/model`, la scelta registrata non cambia.147* Se scegli Predefinito o `opusplan` in `/model`, la scelta registrata non cambia.

148 148 

149Se passate i modelli con `/model`, il passaggio raggiunge anche i [subagenti che ereditano il modello della conversazione principale](/docs/it/sub-agents#choose-a-model), perché Claude Code risolve il loro modello da quello che la vostra sessione sta utilizzando quando Claude li avvia. Passate a Opus prima che Claude deleghi ricerche o esecuzioni di test a uno di loro, e quel lavoro viene eseguito su Opus anche. Per mantenere un subagente personalizzato su un modello più piccolo, impostare `model` nella sua definizione.149Se cambi modello con `/model`, il cambio raggiunge anche i [subagent che ereditano il modello della conversazione principale](/docs/it/sub-agents#choose-a-model), perché Claude Code risolve il loro modello a partire da quello che la tua sessione sta usando quando Claude li avvia. Passa a Opus prima che Claude deleghi ricerche o esecuzioni di test a uno di essi, e anche quel lavoro verrà eseguito su Opus. Per mantenere un subagent personalizzato su un modello più piccolo, imposta `model` nella sua definizione.

150 150 

151Se impostate un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la vostra scelta si applica solo alla sessione corrente e non viene salvata come vostro valore predefinito; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite hanno ancora la precedenza e si riapplicano al prossimo avvio. Un [modello predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha configurato per ignorare la selezione dell'utente si riapplica anche al prossimo avvio.151Se imposti un modello con `/model` in [modalità non interattiva](/docs/it/headless), con il flag `-p`, la tua scelta si applica solo alla sessione corrente e non viene salvata come valore predefinito; `/model` in quella modalità richiede Claude Code v2.1.205 o successiva. Le impostazioni di progetto e gestite hanno comunque la precedenza e vengono riapplicate al prossimo avvio. Anche un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha configurato per sovrascrivere la selezione dell'utente viene riapplicato al prossimo avvio.

152 152 

153Nella v2.1.144 attraverso v2.1.152, `/model` si applicava solo alla sessione corrente e `d` nel selettore salvava un valore predefinito.153Dalla v2.1.144 alla v2.1.152, `/model` si applicava solo alla sessione corrente e `d` nel selettore salvava un valore predefinito.

154 154 

155Il flag `--model` e la variabile di ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avviate con loro. Per eseguire modelli diversi in terminali diversi contemporaneamente, avviate ciascuno con il suo flag `--model` piuttosto che passare con `/model`.155Il flag `--model` e la variabile d'ambiente `ANTHROPIC_MODEL` si applicano solo alla sessione che avvii con essi. Per eseguire modelli diversi in terminali diversi contemporaneamente, avvia ciascuno con il proprio flag `--model` anziché cambiare con `/model`.

156 156 

157I prezzi nel selettore `/model` appaiono quando Claude Code parla all'API Anthropic, direttamente o attraverso un [gateway LLM](/docs/it/llm-gateway) che lo fa da proxy, e il prezzo su una riga è il prezzo del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway delle app Claude](/docs/it/claude-apps-gateway), il vostro provider o gateway determina quello che pagate, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello una riga seleziona o su quello che il vostro provider fattura. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni del gateway mostravano i prezzi di listino di Anthropic, e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.157I prezzi nel selettore `/model` appaiono quando Claude Code comunica con l'API Anthropic, direttamente o tramite un [gateway LLM](/docs/it/llm-gateway) che le fa da proxy, e il prezzo su una riga è quello del modello che quella riga seleziona. Su [provider di terze parti](/docs/it/third-party-integrations) come Amazon Bedrock e sul [gateway delle app Claude](/docs/it/claude-apps-gateway), è il tuo provider o gateway a determinare quanto paghi, quindi le righe del selettore non mostrano alcun prezzo. Il prezzo è solo un'etichetta di visualizzazione; non influisce su quale modello seleziona una riga né su quanto ti fattura il provider. Prima della v2.1.206, [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e le sessioni tramite gateway mostravano i prezzi di listino di Anthropic, e una riga poteva mostrare il prezzo di un modello diverso da quello che selezionava.

158 158 

159Le sessioni riprese con `claude --resume`, `--continue` o il selettore `/resume` mantengono il modello che stavano usando quando la trascrizione è stata salvata. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione segue il normale ordine di precedenza. Sui provider che usano ID di distribuzione specifici del provider anziché ID di modello Anthropic, come Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, il modello della trascrizione non viene ripristinato affatto e la sessione risolve il proprio modello attraverso il normale ordine di precedenza.159Le sessioni riprese con `claude --resume`, `--continue` o il selettore `/resume` mantengono il modello che stavano usando quando la trascrizione è stata salvata. Se il modello ripristinato è stato ritirato o è escluso da [`availableModels`](#restrict-model-selection), la sessione segue il normale ordine di precedenza. Sui provider che usano ID di distribuzione specifici del provider anziché ID di modello Anthropic, come Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry, il modello della trascrizione non viene ripristinato affatto e la sessione risolve il proprio modello attraverso il normale ordine di precedenza.

160 160 

161Se la tua impostazione `model` è `haiku`, una sessione salvata su un modello Haiku riprende sul modello in cui `haiku` si risolve attualmente. Ad esempio, quando `haiku` si risolve in Haiku 5.5, una sessione salvata su Haiku 4.5 riprende su Haiku 5.5.161Se la tua impostazione `model` è `haiku`, una sessione salvata su un modello Haiku riprende sul modello in cui `haiku` si risolve attualmente. Ad esempio, quando `haiku` si risolve in Haiku 5.5, una sessione salvata su Haiku 4.5 riprende su Haiku 5.5.

162 162 

163Un modello che scegliete per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` ha ancora la precedenza sul modello ripristinato. A partire dalla v2.1.195, così come una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions) può anche, secondo le condizioni elencate nella sua sezione.163Un modello che scegli per il nuovo avvio con `--model` o `ANTHROPIC_MODEL` ha comunque la precedenza sul modello ripristinato. Dalla v2.1.195, lo stesso vale per una variabile della famiglia [`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables). Può averla anche [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), alle condizioni elencate nella sua sezione.

164 164 

165Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite piuttosto che dalla vostra selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per ignorare; l'impostazione di progetto o gestita si riapplica al prossimo avvio. Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un elenco di consentiti `availableModels` gestito rimane in vigore a meno che l'host non fornisca il suo; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host ignora.165Quando il modello attivo all'avvio proviene dalle impostazioni di progetto o gestite anziché dalla tua selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Esegui `/model` per sovrascriverlo; l'impostazione di progetto o gestita viene riapplicata al prossimo avvio. Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un'allowlist `availableModels` gestita rimane in vigore a meno che l'host non ne fornisca una propria; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sovrascrive.

166 166 

167Se voi o la vostra organizzazione configurate [hook PreModelSwitch](/docs/it/hooks#premodelswitch), vengono eseguiti prima che un passaggio richiesto si applichi e possono bloccarlo o chiedervi di confermare.167Se tu o la tua organizzazione configurate [hook PreModelSwitch](/docs/it/hooks#premodelswitch), questi vengono eseguiti prima che un cambio richiesto venga applicato e possono bloccarlo o chiederti di confermare.

168 168 

169Quando Claude Code non può dire quali hook PreModelSwitch i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della vostra organizzazione forniscono, ad esempio perché un plugin gestito non è riuscito a caricarsi, rifiuta il passaggio piuttosto che applicarlo senza controllo, e controlla di nuovo ad ogni nuovo tentativo. Consultare [Il passaggio del modello è stato bloccato da un hook PreModelSwitch](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il recupero.169Quando Claude Code non riesce a determinare quali hook PreModelSwitch forniscono i [plugin gestiti](/docs/it/settings-reference#enabledplugins) della tua organizzazione, ad esempio perché un plugin gestito non è stato caricato, rifiuta il cambio anziché applicarlo senza controllo, e ricontrolla a ogni nuovo tentativo. Consulta [Model switch was blocked by a PreModelSwitch hook](/docs/it/errors#model-switch-was-blocked-by-a-premodelswitch-hook) per il messaggio e il ripristino.

170 170 

171Quando passate i modelli attraverso il metodo [`setModel()`](/docs/it/agent-sdk/overview) dell'Agent SDK, attraverso un'app come l'[app Desktop](/docs/it/desktop), o da un dispositivo connesso attraverso [Remote Control](/docs/it/remote-control), Claude Code controlla il valore al passaggio:171Quando cambi modello tramite il metodo `setModel()` dell'[Agent SDK](/docs/it/agent-sdk/overview), tramite un'app come l'[app Desktop](/docs/it/desktop) o da un dispositivo connesso tramite [Remote Control](/docs/it/remote-control), Claude Code controlla il valore al momento del cambio:

172 172 

173* **Agent SDK o un'app**: con Claude Code v2.1.268 o successiva, a meno che Claude Code non accetti un ID modello localmente, come fa per la vostra [opzione di modello personalizzato](#add-a-custom-model-option), conferma l'ID con il vostro provider la prima volta che la sessione passa a esso. La conferma viene eseguita su ogni provider, e un ID che il vostro provider non offre viene rifiutato al passaggio invece di fallire alla vostra prossima richiesta.173* **Agent SDK o un'app**: con Claude Code v2.1.268 o successiva, a meno che Claude Code non accetti un ID modello localmente, come fa per la tua [opzione di modello personalizzato](#add-a-custom-model-option), conferma l'ID con il tuo provider la prima volta che la sessione passa a esso. La conferma viene eseguita su ogni provider, e un ID che il tuo provider non offre viene rifiutato al momento del cambio invece di fallire alla tua richiesta successiva.

174* **Remote Control**: sull'API Anthropic, Claude Code controlla il valore localmente e non invia alcuna richiesta.174* **Remote Control**: sull'API Anthropic, Claude Code controlla il valore localmente e non invia alcuna richiesta.

175 175 

176Consultare [Model is not a recognized model id](/docs/it/errors#model-is-not-a-recognized-model-id) e [Model not found](/docs/it/errors#model-not-found) per i messaggi.176Consulta [Model is not a recognized model id](/docs/it/errors#model-is-not-a-recognized-model-id) e [Model not found](/docs/it/errors#model-not-found) per i messaggi.

177 177 

178Se impostate il modello con il flag `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o l'impostazione `model`, Claude Code non lo controlla in anticipo, e un valore digitato male produce [There's an issue with the selected model](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta.178Se imposti il modello con il flag `--model`, la variabile d'ambiente `ANTHROPIC_MODEL` o l'impostazione `model`, Claude Code non lo controlla in anticipo, e un valore digitato in modo errato produce [There's an issue with the selected model](/docs/it/errors#theres-an-issue-with-the-selected-model) alla prima richiesta.

179 179 

180Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che nomina il modello richiesto. Le sessioni interattive lo mostrano come un avviso di avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](/docs/it/headless) quando si utilizza il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter del subagente](/docs/it/sub-agents). L'avviso su stderr è soppresso per `--output-format json` e `stream-json`; leggere il modello effettivo dal campo `modelUsage` del [messaggio di risultato](/docs/it/headless#get-structured-output) invece.180Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che indica il modello richiesto. Le sessioni interattive lo mostrano come avviso all'avvio. Dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](/docs/it/headless) quando si usa il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter di un subagent](/docs/it/sub-agents). L'avviso su stderr viene soppresso per `--output-format json` e `stream-json`; in questi casi leggi il modello effettivo dal campo `modelUsage` del [messaggio di risultato](/docs/it/headless#get-structured-output).

181 181 

182Ad esempio, avviare una sessione su Opus:182Ad esempio, avvia una sessione su Opus:

183 183 

184```bash theme={null}184```bash theme={null}

185claude --model opus185claude --model opus

186```186```

187 187 

188Quindi passare i modelli dalla sessione:188Poi cambia modello dall'interno della sessione:

189 189 

190```text theme={null}190```text theme={null}

191/model sonnet191/model sonnet


206 Impostare un modello predefinito per le nuove sessioni206 Impostare un modello predefinito per le nuove sessioni

207</h4>207</h4>

208 208 

209Impostare `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le vostre sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.209Imposta `ANTHROPIC_DEFAULT_MODEL=<alias|name>` per scegliere il modello su cui le tue sessioni si avviano per impostazione predefinita. Richiede Claude Code v2.1.236 o successiva.

210 210 

211Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi seleziona un modello:211Claude Code avvia una nuova sessione sul modello della variabile solo quando nessuno di questi elementi seleziona un modello:

212 212 

213* Il flag `--model`213* Il flag `--model`

214* `ANTHROPIC_MODEL`214* `ANTHROPIC_MODEL`

215* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvate con `/model`215* Un valore `model` in qualsiasi file di impostazioni, inclusa la scelta che salvi con `/model`

216* Un [modello predefinito dell'organizzazione](#organization-default-model)216* Un [modello predefinito dell'organizzazione](#organization-default-model)

217 217 

218Una scelta che salvate con `/model` ha la precedenza sulla variabile anche ai prossimi avvii. Con `ANTHROPIC_MODEL` impostato invece, Claude Code ritorna al modello della variabile al prossimo avvio, qualunque cosa abbiate salvato con `/model`.218Una scelta che salvi con `/model` ha la precedenza sulla variabile anche negli avvii successivi. Se invece imposti `ANTHROPIC_MODEL`, Claude Code torna al modello di quella variabile al prossimo avvio, qualunque cosa tu abbia salvato con `/model`.

219 219 

220Claude Code risolve anche l'opzione Predefinito al modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Predefinito si risolve al modello della variabile, la riga Predefinito nel selettore `/model` mostra l'etichetta Impostato da ANTHROPIC\_DEFAULT\_MODEL.220Claude Code risolve anche l'opzione Predefinito nel modello della variabile, a meno che non si applichi un modello predefinito dell'organizzazione. Quando l'opzione Predefinito si risolve nel modello della variabile, la riga Predefinito nel selettore `/model` mostra l'etichetta Impostato da ANTHROPIC\_DEFAULT\_MODEL.

221 221 

222Claude Code ignora la variabile in questi casi, e l'opzione Predefinito si risolve come se non l'aveste impostata:222Claude Code ignora la variabile nei seguenti casi, e l'opzione Predefinito si risolve come se non l'avessi impostata:

223 223 

224* L'avete impostata a `default`, `inherit`, `opusplan`, o `haiku`224* L'hai impostata su `default`, `inherit`, `opusplan` o `haiku`

225* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo225* [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) è attivo

226* Le [restrizioni del modello](#restrict-model-selection) della vostra organizzazione escludono il modello226* Le [restrizioni del modello](#restrict-model-selection) della tua organizzazione escludono il modello

227* Il modello non è disponibile per il vostro account227* Il modello non è disponibile per il tuo account

228 228 

229Quando una nuova sessione si avvierebbe sul modello della variabile, una sessione che riprendete con `claude --resume`, `--continue`, o il selettore `/resume` si avvia su di esso anche. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Altrimenti Claude Code non utilizza la variabile quando [riprendete una sessione](#setting-your-model).229Quando una nuova sessione si avvierebbe sul modello della variabile, anche una sessione che riprendi con `claude --resume`, `--continue` o il selettore `/resume` si avvia su di esso. Claude Code non ripristina il modello salvato nella trascrizione di quella sessione. Negli altri casi Claude Code non usa la variabile quando [riprendi una sessione](#setting-your-model).

230 230 

231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">231<h4 id="a-new-session-starts-on-a-different-model-than-you-picked">

232 Una nuova sessione si avvia su un modello diverso da quello che avete scelto232 Una nuova sessione si avvia su un modello diverso da quello che hai scelto

233</h4>233</h4>

234 234 

235Quando scegliete un modello con `/model` e la vostra prossima sessione si avvia su qualcos'altro, queste sono le cause solite:235Quando scegli un modello con `/model` e la sessione successiva si avvia su un altro, queste sono le cause più comuni:

236 236 

237* **L'avete scelto per una sessione.** Premere `s` nel selettore, avviare con `--model`, e eseguire `/model` in modalità non interattiva si applicano tutti alla sessione corrente e lasciano il vostro valore predefinito salvato da solo.237* **L'hai scelto per una sola sessione.** Premere `s` nel selettore, avviare con `--model` ed eseguire `/model` in modalità non interattiva si applicano tutti alla sessione corrente e lasciano invariato il valore predefinito salvato.

238* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella vostra shell, o un [modello predefinito dell'organizzazione](#organization-default-model) che il vostro amministratore ha impostato per ignorare le scelte dell'utente si applica di nuovo ad ogni avvio. La vostra scelta `/model` è ancora salvata; è superata. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio nomina il file.238* **Qualcosa con priorità più alta imposta il modello.** Un valore `model` nelle impostazioni di progetto o gestite, `ANTHROPIC_MODEL` nella tua shell o un [modello predefinito dell'organizzazione](#organization-default-model) che il tuo amministratore ha impostato per sovrascrivere le scelte dell'utente si applica di nuovo a ogni avvio. La tua scelta in `/model` resta salvata, ma ha una priorità inferiore. Quando le impostazioni di progetto o gestite impostano il modello, l'intestazione di avvio indica il file.

239* **Claude Code non poteva salvare la vostra scelta.** `/model` scrive `model` a `~/.claude/settings.json`. Se non potete scrivere su quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello che avete scelto dura per la sessione e il prossimo avvio legge il valore vecchio. Impostare `model` nello strumento che genera il file, o rendere il file scrivibile. Consultare [Una modifica che avete fatto in Claude Code viene persa nelle nuove sessioni](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).239* **Claude Code non è riuscito a salvare la tua scelta.** `/model` scrive `model` in `~/.claude/settings.json`. Se non puoi scrivere su quel file, ad esempio perché un altro strumento lo genera o lo collega a una copia di sola lettura, il modello scelto resta valido per la sessione e all'avvio successivo viene letto il valore precedente. Imposta `model` nello strumento che genera il file, oppure rendi il file scrivibile. Consulta [Una modifica fatta in Claude Code viene persa nelle nuove sessioni](/docs/it/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).

240* **Avete ripreso una sessione.** Una sessione che riprendete con `claude --resume` o `--continue` solitamente [mantiene il modello che stava utilizzando](#setting-your-model) piuttosto che il vostro valore predefinito attuale.240* **Hai ripreso una sessione.** Una sessione che riprendi con `claude --resume` o `--continue` di solito [mantiene il modello che stava usando](#setting-your-model) anziché il tuo valore predefinito attuale.

241 241 

242<h2 id="restrict-model-selection">242<h2 id="restrict-model-selection">

243 Limitare la selezione del modello243 Limitare la selezione del modello


310* Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) vengono eseguite in ambienti cloud ma non ricevono impostazioni gestite dal server; in un [ambiente self-hosted](/docs/it/self-hosted-environments), leggono comunque il file di impostazioni gestite nell'immagine del runner. Per impostare il modello per quelle sessioni, vedere [Scegliere il modello per un ambito](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) nella guida di amministrazione di Claude Tag.310* Le sessioni [Claude Tag](https://claude.com/docs/claude-tag/overview) vengono eseguite in ambienti cloud ma non ricevono impostazioni gestite dal server; in un [ambiente self-hosted](/docs/it/self-hosted-environments), leggono comunque il file di impostazioni gestite nell'immagine del runner. Per impostare il modello per quelle sessioni, vedere [Scegliere il modello per un ambito](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) nella guida di amministrazione di Claude Tag.

311* Cowork, la scheda agentic-work nell'app Claude Desktop, esegue le sue sessioni su Claude Code ma, per progettazione, non riceve impostazioni gestite dal server dalla console di amministrazione claude.ai. Quando l'elenco `availableModels` nelle tue impostazioni gestite dal server è non vuoto e un utente sceglie un modello al di fuori di esso, il server rifiuta quel modello per una sessione Cowork remota. Un file di impostazioni gestite si applica alle sessioni Cowork quando è presente dove la sessione viene eseguita; le sessioni Cowork remote vengono eseguite su VM gestite da Anthropic, dove un file distribuito dal dispositivo non è presente.311* Cowork, la scheda agentic-work nell'app Claude Desktop, esegue le sue sessioni su Claude Code ma, per progettazione, non riceve impostazioni gestite dal server dalla console di amministrazione claude.ai. Quando l'elenco `availableModels` nelle tue impostazioni gestite dal server è non vuoto e un utente sceglie un modello al di fuori di esso, il server rifiuta quel modello per una sessione Cowork remota. Un file di impostazioni gestite si applica alle sessioni Cowork quando è presente dove la sessione viene eseguita; le sessioni Cowork remote vengono eseguite su VM gestite da Anthropic, dove un file distribuito dal dispositivo non è presente.

312* Le sessioni su [provider di terze parti](/docs/it/server-managed-settings#platform-availability) come Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, e [Claude Platform on AWS](/docs/it/claude-platform-on-aws) non ricevono impostazioni gestite dal server, quindi consegna l'allowlist tramite file MDM o impostazioni gestite lì.312* Le sessioni su [provider di terze parti](/docs/it/server-managed-settings#platform-availability) come Amazon Bedrock, Agent Platform di Google Cloud, Microsoft Foundry, e [Claude Platform on AWS](/docs/it/claude-platform-on-aws) non ricevono impostazioni gestite dal server, quindi consegna l'allowlist tramite file MDM o impostazioni gestite lì.

313* La consegna gestita dal server richiede anche che la sessione si autentichi con un [login o chiave idonei](/docs/it/server-managed-settings#platform-availability). Le flotte che generano chiavi solo tramite uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) dovrebbero consegnare l'allowlist tramite file MDM o impostazioni gestite.313* La consegna dalla console di amministrazione richiede anche che la sessione effettui il recupero con un [login idoneo](/docs/it/server-managed-settings#platform-availability) alla tua organizzazione o con un token OAuth emesso per essa. Per le flotte che si autenticano con chiavi API, sia configurate direttamente sia generate da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper), consegna l'allowlist tramite file MDM o impostazioni gestite.

314* La scheda Desktop Code ospita anche [sessioni SSH](/docs/it/desktop#ssh-sessions), che leggono il file di impostazioni gestite dall'host remoto su cui vengono eseguite. Vedere [Impostazioni gestite desktop](/docs/it/desktop#managed-settings).314* La scheda Desktop Code ospita anche [sessioni SSH](/docs/it/desktop#ssh-sessions), che leggono il file di impostazioni gestite dall'host remoto su cui vengono eseguite. Vedere [Impostazioni gestite desktop](/docs/it/desktop#managed-settings).

315* I selezionatori di modelli su claude.ai e nell'app Desktop nascondono o disattivano i modelli esclusi dall'allowlist della tua organizzazione. Lo stato del selezionatore è una comodità per gli utenti; non applica l'allowlist.315* I selezionatori di modelli su claude.ai e nell'app Desktop nascondono o disattivano i modelli esclusi dall'allowlist della tua organizzazione. Lo stato del selezionatore è una comodità per gli utenti; non applica l'allowlist.

316 316 


500 500 

501Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione, o nel modello [registrato sul tuo account](#setting-your-model).501Quando un amministratore ha impostato un [modello predefinito dell'organizzazione](#organization-default-model), `default` si risolve in quel modello invece del valore predefinito del tipo di account sopra indicato. Richiede Claude Code v2.1.196 o successiva. `default` può anche risolversi nel modello impostato con [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), secondo le condizioni elencate nella relativa sezione, o nel modello [registrato sul tuo account](#setting-your-model).

502 502 

503Quando nulla è registrato sul tuo account, le impostazioni gestite [applicano l'elenco consentito per il modello predefinito](#enforce-the-allowlist-for-the-default-model), e il valore predefinito del tipo di account non è in `availableModels`, `default` si risolve nel valore predefinito applicato invece del valore predefinito del tipo di account sopra indicato. Quando entrambi si applicano, il valore predefinito dell'organizzazione sostituisce prima il valore predefinito del tipo di account e l'applicazione si applica quindi ad esso: un valore predefinito dell'organizzazione nell'elenco consentito viene mantenuto, mentre uno al di fuori dell'elenco si risolve nel valore predefinito applicato.503Quando nulla è registrato sul tuo account, le impostazioni gestite [applicano l'allowlist per il modello predefinito](#enforce-the-allowlist-for-the-default-model), e il valore predefinito del tipo di account non è in `availableModels`, `default` si risolve nel valore predefinito applicato invece del valore predefinito del tipo di account sopra indicato. Quando si applicano sia un valore predefinito dell'organizzazione sia l'applicazione dell'allowlist, il valore predefinito dell'organizzazione sostituisce prima il valore predefinito del tipo di account e l'applicazione si applica quindi ad esso: un valore predefinito dell'organizzazione presente nell'allowlist viene mantenuto, mentre uno al di fuori dell'elenco si risolve nel valore predefinito applicato.

504 504 

505I modelli Fable non sono il valore predefinito del tipo di account su nessun piano o provider. Sceglierne uno con `/model` lo salva come modello selezionato nelle impostazioni utente, in modo che le sessioni successive inizino su di esso. Per il cambio una tantum che Claude Code apporta a una selezione Fable 5 salvata nella v2.1.257, vedere [Lavorare con Fable](#work-with-fable).505I modelli Fable non sono il valore predefinito del tipo di account su nessun piano o provider. Sceglierne uno con `/model` lo salva come modello selezionato nelle impostazioni utente, in modo che le sessioni successive inizino su di esso. Per il cambio una tantum che Claude Code apporta a una selezione Fable 5 salvata nella v2.1.257, consulta [Lavorare con Fable](#work-with-fable).

506 506 

507<h3 id="opusplan-model-setting">507<h3 id="opusplan-model-setting">

508 Impostazione del modello `opusplan`508 Impostazione del modello `opusplan`


510 510 

511L'alias del modello `opusplan` fornisce un approccio ibrido automatizzato:511L'alias del modello `opusplan` fornisce un approccio ibrido automatizzato:

512 512 

513* **In Plan Mode**: utilizza `opus` per il ragionamento complesso e le decisioni architettoniche513* **In plan mode**: utilizza `opus` per il ragionamento complesso e le decisioni architetturali

514* **In modalità esecuzione**: passa automaticamente a `sonnet` per la generazione del codice e l'implementazione514* **In modalità esecuzione**: passa automaticamente a `sonnet` per la generazione del codice e l'implementazione

515 515 

516Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.516Questo abbina il ragionamento di Opus per la pianificazione con l'efficienza di Sonnet per l'esecuzione.

517 517 

518La fase Opus in Plan Mode utilizza la stessa finestra di contesto dell'impostazione del modello `opus`, e la fase di esecuzione utilizza la stessa finestra di `sonnet`. Quando `opus` e `sonnet` si risolvono in modelli che vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita, come i modelli attuali su Anthropic API, entrambe le fasi vengono eseguite con essa. Per richiedere il contesto 1M per entrambe le fasi dove non lo fanno, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.518La fase Opus in plan mode utilizza la stessa finestra di contesto dell'impostazione del modello `opus`, e la fase di esecuzione utilizza la stessa finestra di `sonnet`. Quando `opus` e `sonnet` si risolvono in modelli che vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita, come i modelli attuali su Anthropic API, entrambe le fasi vengono eseguite con essa. Per richiedere il contesto 1M per entrambe le fasi dove non lo fanno, [imposta il modello](#setting-your-model) su `opusplan[1m]`, ad esempio con `/model opusplan[1m]`. Impostarlo con `/model` richiede Claude Code v2.1.265 o successiva; nelle versioni precedenti, usa il flag `--model` o l'impostazione `model`.

519 519 

520Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente si aggiornerebbe a Sonnet in Plan Mode utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, Plan Mode rimase sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'elenco consentito ne consentiva una precedente.520Quando [`availableModels`](#restrict-model-selection) esclude l'Opus più recente ma consente una versione precedente, ad esempio `["sonnet", "claude-opus-4-6"]`, `opusplan` utilizza l'Opus più recente consentito per la pianificazione e rimane su Sonnet solo quando ogni Opus è escluso. Una sessione Haiku che normalmente passerebbe a Sonnet in plan mode utilizza allo stesso modo il Sonnet più recente consentito e rimane su Haiku solo quando ogni Sonnet è escluso. Prima della v2.1.205, il plan mode rimaneva sul modello della sessione ogni volta che la versione più recente della famiglia di aggiornamento era esclusa, anche quando l'allowlist ne consentiva una precedente.

521 521 

522La sostituzione di una versione precedente consentita si applica su Anthropic API e [Claude Platform su AWS](/docs/it/claude-platform-on-aws). Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, i cui deployment utilizzano ID modello specifici del provider, Plan Mode rimane sul modello della sessione ogni volta che il modello di aggiornamento è escluso.522La sostituzione di una versione precedente consentita si applica su Anthropic API e [Claude Platform su AWS](/docs/it/claude-platform-on-aws). Su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry e Mantle, i cui deployment utilizzano ID modello specifici del provider, il plan mode rimane sul modello della sessione ogni volta che il modello di aggiornamento è escluso.

523 523 

524Per un approccio ibrido in cui Claude decide a metà attività quando consultare un secondo modello piuttosto che passare al confine del piano, vedere lo [strumento advisor](/docs/it/advisor).524Per un approccio ibrido in cui Claude decide a metà attività quando consultare un secondo modello piuttosto che passare al confine del piano, consulta lo [strumento advisor](/docs/it/advisor).

525 525 

526<h3 id="fallback-model-chains">526<h3 id="fallback-model-chains">

527 Catene di modelli di fallback527 Catene di modelli di fallback

528</h3>528</h3>

529 529 

530Quando il modello primario è sovraccarico, non disponibile o restituisce un altro errore del server non ripetibile, Claude Code può passare a un modello di fallback invece di non riuscire nella richiesta. Gli errori di autenticazione, fatturazione, limite di velocità, dimensione della richiesta e trasporto, e un [rifiuto dalla verifica della politica della tua organizzazione](/docs/it/errors#automatic-retries), non attivano mai un passaggio; questi seguono il loro normale retry e gestione degli errori. Passa quando [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) o [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) rifiuta un modello che il tuo account non può invocare, che Claude Code tratta come il modello non disponibile piuttosto che come un errore di autenticazione.530Quando il modello primario è sovraccarico, non disponibile o restituisce un altro errore del server per cui non è possibile riprovare, Claude Code può passare a un modello di fallback invece di far fallire la richiesta. Gli errori di autenticazione, fatturazione, rate limit, dimensione della richiesta e trasporto, e un [rifiuto da parte del controllo delle policy della tua organizzazione](/docs/it/errors#automatic-retries), non attivano mai un passaggio; questi seguono i loro normali nuovi tentativi e la normale gestione degli errori. Il passaggio avviene invece quando [Amazon Bedrock](/docs/it/amazon-bedrock#when-a-model-is-disabled-mid-session) o [Google Cloud's Agent Platform](/docs/it/google-vertex-ai#when-a-model-is-disabled-mid-session) rifiuta un modello che il tuo account non può invocare, che Claude Code tratta come modello non disponibile piuttosto che come un errore di autenticazione.

531 531 

532Configura uno o più modelli di fallback e Claude Code li prova in ordine, mostrando un avviso quando passa. Il passaggio dura solo per il turno corrente, quindi il tuo prossimo messaggio prova prima il modello primario di nuovo. Claude Code limita le catene a tre modelli dopo la rimozione dei duplicati e ignora le voci extra.532Configura uno o più modelli di fallback e Claude Code li prova in ordine, mostrando un avviso quando passa. Il passaggio dura solo per il turno corrente, quindi il tuo prossimo messaggio prova di nuovo prima il modello primario. Claude Code limita le catene a tre modelli dopo la rimozione dei duplicati e ignora le voci extra.

533 533 

534Imposta una catena per una sessione con il flag `--fallback-model`, che accetta un elenco separato da virgole:534Imposta una catena per una sessione con il flag `--fallback-model`, che accetta un elenco separato da virgole:

535 535 


537claude --fallback-model sonnet,haiku537claude --fallback-model sonnet,haiku

538```538```

539 539 

540Per mantenere una catena tra le sessioni, imposta `fallbackModel` in [settings](/docs/it/settings) come array:540Per mantenere una catena tra le sessioni, imposta `fallbackModel` nelle [impostazioni](/docs/it/settings) come array:

541 541 

542```json theme={null}542```json theme={null}

543{543{


549 549 

550Claude Code non conferma la catena all'avvio e `/status` non la visualizza. L'avviso mostrato quando si verifica un passaggio è il primo segno visibile che un fallback è configurato.550Claude Code non conferma la catena all'avvio e `/status` non la visualizza. L'avviso mostrato quando si verifica un passaggio è il primo segno visibile che un fallback è configurato.

551 551 

552Quando una richiesta fallisce, Claude Code prova ogni voce in ordine finché una non l'accetta. Una voce che non può essere raggiunta nemmeno, come un modello ritirato bloccato nelle impostazioni, fallisce alla successiva nello stesso modo. Claude Code rimuove due tipi di voce prima di quel percorso:552Quando una richiesta passa al fallback, Claude Code prova ogni voce in ordine finché una non l'accetta. Anche una voce che non può essere raggiunta, come un modello ritirato bloccato nelle impostazioni, passa alla successiva nello stesso modo. Claude Code rimuove due tipi di voce prima che inizi questo percorso:

553 553 

554* **Al di fuori dell'elenco consentito**: Claude Code elimina qualsiasi voce non consentita da [`availableModels`](#restrict-model-selection) quando legge la catena.554* **Al di fuori dell'allowlist**: Claude Code elimina qualsiasi voce non consentita da [`availableModels`](#restrict-model-selection) quando legge la catena.

555* **Finestra di contesto più piccola durante la compattazione**: la catena copre anche la [compattazione](/docs/it/context-window#what-survives-compaction), ma Claude Code non farà fallback a un modello con una finestra di contesto più piccola di quella del primario, poiché il riassunto lì taglierebbe prima parte della conversazione. Se ogni fallback è più piccolo, la compattazione mostra l'errore originale e puoi riprovare.555* **Finestra di contesto più piccola durante la compattazione**: la catena copre anche la [compattazione](/docs/it/context-window#what-survives-compaction), ma Claude Code non ripiegherà su un modello con una finestra di contesto più piccola di quella del primario, poiché il riassunto lì taglierebbe prima parte della conversazione. Se ogni fallback è più piccolo, la compattazione mostra l'errore originale e puoi riprovare.

556 556 

557Claude Code applica anche la catena ai [subagenti](/docs/it/sub-agents). Quando la richiesta di un subagente fallisce, Claude Code prova i tuoi modelli di fallback configurati in ordine, e il subagente continua sul modello che accetta la richiesta. Il modello della tua sessione rimane invariato. Prima della v2.1.247, un fallimento che la catena copriva terminava il subagente.557Claude Code applica la catena anche ai [subagent](/docs/it/sub-agents). Quando la richiesta di un subagent passa al fallback, Claude Code prova i modelli di fallback configurati in ordine, e il subagent continua sul modello che accetta la richiesta. Il modello della tua sessione rimane invariato. Prima della v2.1.247, un errore coperto dalla catena terminava invece il subagent.

558 558 

559<h3 id="automatic-model-fallback">559<h3 id="automatic-model-fallback">

560 Fallback automatico del modello560 Fallback automatico del modello

561</h3>561</h3>

562 562 

563Questa sezione copre il fallback basato sul contenuto dai modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, vedere [Catene di modelli di fallback](#fallback-model-chains).563Questa sezione copre il fallback basato sul contenuto dai modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5. Per il fallback basato sulla disponibilità quando un modello è sovraccarico o non disponibile, consulta [Catene di modelli di fallback](#fallback-model-chains).

564 564 

565I modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte contrassegnano il contenuto di sicurezza informatica e biologia. Quando un classificatore contrassegna una richiesta e la categoria contrassegnata ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e mostra un avviso nella trascrizione. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:565I modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 vengono eseguiti con classificatori di sicurezza, che il più delle volte segnalano contenuti di sicurezza informatica e biologia. Per queste due categorie, il modello di fallback dipende da quale modello ha rifiutato:

566 566 

567* **Fable 5.1, Fable 5 e Opus 5.5**: le richieste contrassegnate per biologia vengono rieseguite su Opus 5, e le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8.567* **Fable 5.1, Fable 5 e Opus 5.5**: le richieste segnalate per biologia vengono rieseguite su Opus 5, e le richieste segnalate per sicurezza informatica vengono rieseguite su Opus 4.8.

568* **Sonnet 5.5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Sonnet 5. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Sonnet 5.5 non ha un modello di fallback biologico.568* **Sonnet 5.5**: le richieste segnalate per sicurezza informatica vengono rieseguite su Sonnet 5. Le richieste segnalate per biologia terminano invece con un rifiuto, perché Sonnet 5.5 non ha un modello di fallback per la biologia.

569* **Opus 5**: le richieste contrassegnate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste contrassegnate per biologia terminano con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.569* **Opus 5**: le richieste segnalate per sicurezza informatica vengono rieseguite su Opus 4.8. Le richieste segnalate per biologia terminano invece con un rifiuto, perché Opus 5 esegue i propri classificatori di biologia senza modello di fallback.

570 570 

571Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve questi target attraverso il tuo deployment's model IDs. Vedere [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).571Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, Claude Code risolve invece questi target tramite gli ID modello del tuo deployment. Consulta [Abilitare il fallback su Bedrock, Agent Platform e Foundry](#enable-fallback-on-bedrock-agent-platform-and-foundry).

572 

573Quando Claude Code passa una richiesta segnalata al modello di fallback per la sua categoria, riesegue la richiesta su quel modello. Nella conversazione principale, mostra un avviso nella trascrizione. Per ricevere prima una richiesta di conferma, consulta [Chiedere prima di passare](#ask-before-switching).

572 574 

573Dopo un fallback, la sessione continua sul modello di fallback. Per tornare al tuo modello originale, esegui [`/model`](#setting-your-model).575Dopo un fallback, la sessione continua sul modello di fallback. Per tornare al tuo modello originale, esegui [`/model`](#setting-your-model).

574 576 

575Il fallback basato sulla categoria richiede Claude Code v2.1.219 o successiva. Prima della v2.1.219, ogni richiesta Fable 5 contrassegnata veniva rieseguita sul modello Opus predefinito del tuo provider, e Opus 5 non era una fonte di fallback.577Il fallback basato sulla categoria richiede Claude Code v2.1.219 o successiva. Prima della v2.1.219, ogni richiesta Fable 5 segnalata veniva rieseguita sul modello Opus predefinito del tuo provider, e Opus 5 non era una fonte di fallback.

576 578 

577Il modello di fallback viene controllato rispetto a [`availableModels`](#restrict-model-selection). Quando è bloccato, non si verifica alcun fallback. Il rifiuto viene mostrato come un errore normale e il modello della sessione rimane invariato.579Il modello di fallback viene controllato rispetto a [`availableModels`](#restrict-model-selection). Quando è bloccato, non si verifica alcun fallback. Il rifiuto viene mostrato come un errore normale e il modello della sessione rimane invariato.

578 580 


580 Livello di sforzo dopo un fallback582 Livello di sforzo dopo un fallback

581</h4>583</h4>

582 584 

583Quando Claude Code passa la tua sessione al modello di fallback, mantiene il livello di sforzo con cui è stata eseguita la richiesta segnalata al posto dello sforzo predefinito di quel modello. Ad esempio, una sessione su Opus 5.5 al suo valore predefinito `medium` che ripiega su Opus 4.8 rimane a `medium`, anche se il valore predefinito di Opus 4.8 è `high`.585Quando Claude Code passa la tua sessione al modello di fallback, mantiene il livello di sforzo con cui è stata eseguita la richiesta segnalata. Ad esempio, una sessione su Opus 5.5 al suo valore predefinito `medium` che ripiega su Opus 4.8 rimane a `medium`, anche se il valore predefinito di Opus 4.8 è `high`.

584 586 

585Un livello diverso si applica in casi come questi:587Un livello diverso si applica in casi come questi:

586 588 

587* **Impostazioni o valore predefinito dell'organizzazione**: si applica invece un livello nelle tue impostazioni valido per il modello di fallback, o uno sforzo predefinito che la tua organizzazione ha impostato per esso.

588* **Una tua modifica**: una volta che scegli un livello di sforzo, selezioni un modello in `/model` o riprendi la sessione in seguito, il livello della richiesta segnalata non viene più mantenuto.589* **Una tua modifica**: una volta che scegli un livello di sforzo, selezioni un modello in `/model` o riprendi la sessione in seguito, il livello della richiesta segnalata non viene più mantenuto.

589* **Sforzo della skill**: un livello impostato dal frontmatter `effort` di una skill per la richiesta segnalata si applica a quel turno, e i turni successivi vengono eseguiti al livello che l'[ordine di risoluzione dello sforzo](#adjust-effort-level) assegna al modello di fallback.590* **Sforzo della skill**: un livello impostato dal frontmatter `effort` di una skill per la richiesta segnalata si applica a quel turno, e i turni successivi vengono eseguiti al livello che l'[ordine di risoluzione dello sforzo](#adjust-effort-level) assegna al modello di fallback.

590 591 

591L'intestazione della sessione mostra il livello in vigore accanto al nome del modello. Per cambiarlo, esegui `/effort` nella sessione.592Nella sessione, esegui `/effort status` per vedere il livello in vigore, oppure `/effort` per cambiarlo.

592 593 

593<h4 id="check-what-triggered-fallback">594<h4 id="check-what-triggered-fallback">

594 Verificare cosa ha attivato il fallback595 Verificare cosa ha attivato il fallback

595</h4>596</h4>

596 597 

597Il fallback può attivarsi alla prima richiesta di una sessione, prima di inviare qualcosa di insolito, perché la prima richiesta contiene il contesto dell'area di lavoro come il contenuto di CLAUDE.md e lo stato di git. Un repository che contiene materiale di sicurezza o biologia può attivare il classificatore solo su quel contesto.598Il fallback può attivarsi alla prima richiesta di una sessione, prima di inviare qualcosa di insolito, perché la prima richiesta contiene il contesto del workspace come il contenuto di CLAUDE.md e lo stato di git. Un repository che contiene materiale di sicurezza o biologia può attivare il classificatore solo con quel contesto.

598 599 

599Per verificare se le personalizzazioni sono il trigger, avvia una sessione con `claude --safe-mode`, che disabilita le personalizzazioni come CLAUDE.md, skills, server MCP e hooks. Lo stato di git e i nomi delle directory non sono personalizzazioni e sono ancora inclusi.600Per verificare se le personalizzazioni sono la causa, avvia una sessione con `claude --safe-mode`, che disabilita le personalizzazioni come CLAUDE.md, skill, server MCP e hook. Lo stato di git e i nomi delle directory non sono personalizzazioni e sono comunque inclusi.

600 601 

601<h4 id="ask-before-switching">602<h4 id="ask-before-switching">

602 Chiedere prima di passare603 Chiedere prima di passare

603</h4>604</h4>

604 605 

605Per decidere cosa accade ogni volta che una richiesta viene contrassegnata, piuttosto che passare automaticamente, esegui `/config` e disattiva **Cambia modelli quando un messaggio viene contrassegnato**, oppure imposta [`switchModelsOnFlag`](/docs/it/settings-reference#switchmodelsonflag) su `false` nel tuo file di impostazioni. Una richiesta contrassegnata mette quindi in pausa la sessione con due opzioni: passare al modello di fallback o modificare il prompt e riprovare sul modello corrente.606Per decidere cosa accade ogni volta che una richiesta viene segnalata, esegui `/config`, seleziona **Cambia modelli quando un messaggio viene segnalato** e scegli **Chiedi ogni volta**. Puoi anche impostare [`switchModelsOnFlag`](/docs/it/settings-reference#switchmodelsonflag) su `false` nel tuo file di impostazioni. Claude Code quindi si ferma a una richiesta segnalata che cambierebbe modello e ti offre due opzioni: passare al modello di fallback, oppure modificare il prompt e riprovare.

607 

608La prima volta che una richiesta segnalata cambierebbe modello in una sessione interattiva, Claude Code potrebbe chiederti se passare automaticamente da quel momento in poi. Lo chiede solo se non hai impostato `switchModelsOnFlag`, e salva la tua scelta come quella chiave nelle impostazioni utente.

609 

610Se scegli invece di restare sul modello corrente, il valore salvato è `false`, come per **Chiedi ogni volta**. Se ignori la domanda, Claude Code non salva nulla e la ripropone la prossima volta che una richiesta segnalata cambierebbe modello.

606 611 

607Alcuni casi si comportano diversamente:612Quando hai scelto **Chiedi ogni volta**, alcuni casi si comportano diversamente:

608 613 

609* Quando la categoria contrassegnata non ha un modello di fallback, come un flag di biologia su Opus 5 o Sonnet 5.5, Claude Code non mostra il prompt e la richiesta termina con il rifiuto.614* Quando la categoria segnalata non ha un modello di fallback, come un flag di biologia su Opus 5 o Sonnet 5.5, Claude Code non mostra la richiesta di conferma e la richiesta termina con il rifiuto.

610* Se entrambi i modelli contrassegnano la stessa richiesta, puoi modificare il prompt e riprovare, o avviare una nuova sessione.615* Se entrambi i modelli segnalano la stessa richiesta, puoi modificare il prompt e riprovare, o avviare una nuova sessione.

611* Su sessioni mobili [Claude Code sul web](/docs/it/claude-code-on-the-web), la modifica e il retry non sono supportati. Cambia modelli o continua la sessione da un browser desktop o dall'app desktop.616* Nelle [sessioni cloud](/docs/it/claude-code-on-the-web) sull'app mobile, la modifica e il nuovo tentativo non sono supportati. Cambia modello, oppure continua la sessione da un browser desktop o dall'app desktop.

612* In [modalità non interattiva](/docs/it/cli-reference#cli-flags) e integrazioni SDK che non possono mostrare il prompt, una richiesta contrassegnata termina il turno con un rifiuto.617* In [modalità non interattiva](/docs/it/cli-reference#cli-flags) e nelle integrazioni SDK che non possono mostrare la richiesta di conferma, una richiesta segnalata termina invece il turno con un rifiuto.

613* Quando il target di fallback è bloccato da [`availableModels`](#restrict-model-selection), Claude Code non mostra il prompt. La richiesta contrassegnata termina con il rifiuto, come il fallback automatico quando il target è bloccato.618* In un [subagent](/docs/it/sub-agents), Claude Code non mostra la richiesta di conferma, e una richiesta segnalata che cambierebbe modello viene rieseguita sul modello di fallback.

619* Quando il target di fallback è bloccato da [`availableModels`](#restrict-model-selection), Claude Code non mostra la richiesta di conferma. La richiesta segnalata termina con il rifiuto, come il fallback automatico quando il target è bloccato.

614 620 

615<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">621<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

616 Abilitare il fallback su Bedrock, Agent Platform e Foundry622 Abilitare il fallback su Bedrock, Agent Platform e Foundry

617</h4>623</h4>

618 624 

619Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare entrambi i modelli coinvolti:625Su [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai) e [Microsoft Foundry](/docs/it/microsoft-foundry), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare ciascun modello coinvolto:

620 626 

621* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).627* Claude Code deve riconoscere il modello corrente come fonte di fallback. Fable 5.1 e Fable 5 vengono riconosciuti quando l'ID modello contiene `claude-fable-5`, corrisponde al valore di `ANTHROPIC_DEFAULT_FABLE_MODEL` o è mappato con [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 e Opus 5 vengono riconosciuti dal loro ID modello del provider o da un mapping [`modelOverrides`](#override-model-ids-per-version).

622* Un target Opus deve risolversi nel tuo deployment, indipendentemente da quale modello ha rifiutato: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL`, o mantieni una voce Opus 4.8 nell'elenco dei modelli del provider. Senza uno, il fallback rimane disattivato per ogni modello sorgente, incluso Sonnet 5.5, e le richieste contrassegnate terminano con un rifiuto.628* Un target Opus deve risolversi nel tuo deployment, indipendentemente da quale modello ha rifiutato: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL`, o mantieni una voce Opus 4.8 nell'elenco dei modelli del provider. Senza di esso, il fallback rimane disattivato per ogni modello sorgente, incluso Sonnet 5.5, e le richieste segnalate terminano con un rifiuto.

623* Il modello di fallback della categoria contrassegnata deve risolversi nel tuo deployment. Da un modello Fable, Opus 5.5 o Opus 5, se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste contrassegnate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste contrassegnate per sicurezza informatica vengono rieseguite sulla voce Opus 4.8, e le richieste contrassegnate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5. Da Sonnet 5.5, le richieste contrassegnate per sicurezza informatica vengono rieseguite sul modello che imposti in `ANTHROPIC_DEFAULT_SONNET_MODEL`, o su una voce Sonnet 5 nell'elenco dei modelli del provider se non lo imposti.629* Il modello di fallback della categoria segnalata deve risolversi nel tuo deployment. Da un modello Fable, Opus 5.5 o Opus 5, se imposti `ANTHROPIC_DEFAULT_OPUS_MODEL`, le richieste segnalate vengono rieseguite su quel modello per ogni categoria che ha un fallback; un flag di biologia su Opus 5 termina comunque con un rifiuto. Se non lo imposti, le richieste segnalate per sicurezza informatica vengono rieseguite sulla voce Opus 4.8, e le richieste segnalate per biologia da un modello Fable o Opus 5.5 su una voce Opus 5. Da Sonnet 5.5, le richieste segnalate per sicurezza informatica vengono rieseguite sul modello che imposti in `ANTHROPIC_DEFAULT_SONNET_MODEL`, o su una voce Sonnet 5 nell'elenco dei modelli del provider se non lo imposti.

624 630 

625Se uno dei modelli non può essere identificato, Claude Code non passa. La richiesta contrassegnata termina con un messaggio di rifiuto e puoi cambiare modelli con [`/model`](#setting-your-model) e riprovare. Per rendere entrambi i modelli identificabili, imposta i pin per il tuo modello sorgente:631Se uno dei modelli non può essere identificato, Claude Code non cambia modello. La richiesta segnalata termina con un messaggio di rifiuto e puoi cambiare modello con [`/model`](#setting-your-model) e riprovare. Per rendere entrambi i modelli identificabili, imposta i pin per il tuo modello sorgente:

626 632 

627* **Modelli Fable**: imposta `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable in modo che Claude Code lo riconosca come fonte di fallback.633* **Modelli Fable**: imposta `ANTHROPIC_DEFAULT_FABLE_MODEL` sul tuo ID modello Fable in modo che Claude Code lo riconosca come fonte di fallback.

628* **Ogni modello sorgente**: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus per attivare il fallback e fornire alle categorie contrassegnate un target. Un pin che nomina un modello al di fuori della famiglia Opus, o il modello che ha rifiutato, lascia il rifiuto in piedi.634* **Ogni modello sorgente**: imposta `ANTHROPIC_DEFAULT_OPUS_MODEL` su un ID modello Opus per attivare il fallback e fornire un target alle categorie segnalate. Un pin che indica un modello al di fuori della famiglia Opus, o il modello che ha rifiutato, lascia invariato il rifiuto.

629* **Sonnet 5.5**: oltre al pin Opus, imposta `ANTHROPIC_DEFAULT_SONNET_MODEL` o mantieni una voce Sonnet 5 nell'elenco dei modelli del provider per fornire il modello su cui la richiesta viene rieseguita. Un pin Sonnet che nomina un modello al di fuori della famiglia Sonnet, o Sonnet 5.5 stesso, lascia il rifiuto in piedi.635* **Sonnet 5.5**: oltre al pin Opus, imposta `ANTHROPIC_DEFAULT_SONNET_MODEL` o mantieni una voce Sonnet 5 nell'elenco dei modelli del provider per fornire il modello su cui la richiesta viene rieseguita. Un pin Sonnet che indica un modello al di fuori della famiglia Sonnet, o Sonnet 5.5 stesso, lascia invariato il rifiuto.

636 

637Il modello di fallback deve inoltre avere una finestra di contesto grande almeno quanto quella della sessione, altrimenti Claude Code non cambia modello e la richiesta segnalata termina con lo stesso rifiuto. Su questi provider i modelli sorgente vengono eseguiti con la [finestra di contesto 1M](#extended-context) per impostazione predefinita. Blocca un modello che faccia altrettanto, come Opus 4.8 in `ANTHROPIC_DEFAULT_OPUS_MODEL` o Sonnet 5 in `ANTHROPIC_DEFAULT_SONNET_MODEL`, tramite un ID che Claude Code [possa associare a quel modello](#pin-models-for-third-party-deployments).

630 638 

631<h4 id="security-research-and-biology-workloads">639<h4 id="security-research-and-biology-workloads">

632 Ricerca sulla sicurezza e carichi di lavoro biologici640 Ricerca sulla sicurezza e carichi di lavoro biologici

633</h4>641</h4>

634 642 

635I carichi di lavoro in sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e basi di codice adiacenti alla biologia, attivano il fallback frequentemente, spesso alla prima richiesta. Per un lavoro biologico sostanziale su Fable 5.1, Fable 5 o Opus 5.5, Claude Code sposta la sessione a Opus 5 alla prima richiesta contrassegnata, e le successive richieste contrassegnate per biologia terminano in rifiuti lì, perché Opus 5 non ha fallback biologico. Su Opus 5 e Sonnet 5.5, ricevi quei rifiuti dalla prima richiesta contrassegnata.643I carichi di lavoro di sicurezza offensiva o biologia, inclusi test di penetrazione, esercizi Capture the Flag (CTF) e codebase legati alla biologia, attivano frequentemente il fallback, spesso alla prima richiesta. Per un lavoro sostanziale di biologia su Fable 5.1, Fable 5 o Opus 5.5, la prima richiesta segnalata che cambia modello sposta la sessione su Opus 5, e le successive richieste segnalate per biologia terminano lì con dei rifiuti, perché Opus 5 non ha fallback per la biologia. Su Opus 5 e Sonnet 5.5, ricevi quei rifiuti fin dalla prima richiesta segnalata.

636 644 

637Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.645Questo è il routing previsto per questi domini, non un flag dell'account. Se la tua organizzazione ha bisogno di capacità di classe Fable per questo lavoro, chiedi al tuo team di account Anthropic informazioni sui programmi di accesso affidabile.

638 646 


640 Regola il livello di sforzo648 Regola il livello di sforzo

641</h3>649</h3>

642 650 

643I [livelli di sforzo](https://platform.claude.com/docs/en/build-with-claude/effort) controllano il ragionamento adattivo, che consente al modello di decidere se e quanto pensare ad ogni passo in base alla complessità dell'attività. Lo sforzo inferiore è più veloce e più economico per attività semplici e circoscritte, mentre lo sforzo superiore fornisce un ragionamento più profondo per problemi complessi.651I [livelli di sforzo](https://platform.claude.com/docs/en/build-with-claude/effort) controllano il ragionamento adattivo, che consente al modello di decidere se e quanto ragionare a ogni passo in base alla complessità dell'attività. Uno sforzo inferiore è più veloce ed economico per attività semplici, mentre uno sforzo superiore fornisce un ragionamento più profondo per problemi complessi.

644 652 

645I livelli di sforzo disponibili dipendono dal modello. I modelli non elencati qui non supportano lo sforzo:653I livelli di sforzo disponibili dipendono dal modello. I modelli non elencati qui non supportano lo sforzo:

646 654 


650| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 e Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |658| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 e Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |

651| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |659| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |

652 660 

653Se imposti un livello che il modello attivo non supporta, Claude Code fallback al livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; vedere [Limiti di sforzo dell'organizzazione](#organization-effort-limits).661Se imposti un livello che il modello attivo non supporta, Claude Code ripiega sul livello supportato più alto pari o inferiore a quello impostato. Ad esempio, `xhigh` viene eseguito come `high` su Opus 4.6. La tua organizzazione o le tue stesse impostazioni possono anche limitare i livelli che un modello offre; consulta [Limiti di sforzo dell'organizzazione](#organization-effort-limits).

654 662 

655Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:663Claude Code risolve il livello di sforzo della sessione in questo ordine, prendendo il primo che si applica:

656 664 

6571. Una scelta esplicita: la variabile di ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha effetto più ristretto](#non-interactive-effort))6651. Una scelta esplicita: la variabile d'ambiente [`CLAUDE_CODE_EFFORT_LEVEL`](/docs/it/env-vars#variables), l'avvio con `--effort`, o `/effort` nella sessione ([un `/effort` non interattivo ha un effetto più ristretto](#non-interactive-effort))

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

6593. 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`; inoltre, quando 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. Dopo un fallback automatico del modello, consulta [Livello di sforzo dopo un fallback](#effort-level-after-a-fallback) per il livello che si applica.6673. 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`; inoltre, quando 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

668 

669Dopo un fallback automatico del modello, consulta [Livello di sforzo dopo un fallback](#effort-level-after-a-fallback) per il livello che si applica.

660 670 

661Opus 5.5 inizia a `medium` a meno che una delle fonti sopra non imposti un livello per esso, e un `effortLevel` di livello superiore nel tuo file di impostazioni utente non conta per Opus 5.5. Quella chiave è la forma più vecchia che `/effort` ha scritto 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 fino a quando non scegli un livello per loro con `/effort` o il selettore `/model`. Un `effortLevel` di livello superiore nelle impostazioni di progetto, locale o gestite, o uno passato con `--settings`, si applica a ogni modello.671Opus 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.

662 672 

663Quando imposti `low`, `medium`, `high` o `xhigh` in una sessione interattiva sulla tua macchina, scegli quanto dura selezionando come lo confermi:673Quando imposti `low`, `medium`, `high` o `xhigh` in una sessione interattiva sulla tua macchina, scegli quanto dura in base a come lo confermi:

664 674 

665* `Enter` nel cursore `/effort` o nel selettore `/model`, o un livello digitato dopo `/effort`: salva il livello come predefinito e applicalo nelle sessioni successive675* `Enter` nel cursore `/effort` o nel selettore `/model`, o un livello digitato dopo `/effort`: salva il livello come predefinito e applicalo nelle sessioni successive

666* `s` nel cursore `/effort` o nel selettore `/model`: applica il livello solo a questa sessione. Richiede Claude Code v2.1.257 o successiva676* `s` nel cursore `/effort` o nel selettore `/model`: applica il livello solo a questa sessione. Richiede Claude Code v2.1.257 o successiva

667 677 

668Claude Code salva il livello per modello, sotto la chiave [`modelSettings`](/docs/it/settings-reference#modelsettings) nelle tue impostazioni utente, quindi ogni modello mantiene il suo livello salvato.678Claude Code salva il livello per modello, sotto la chiave [`modelSettings`](/docs/it/settings-reference#modelsettings) nelle tue impostazioni utente, quindi ogni modello mantiene il proprio livello salvato.

669 679 

670`max` è il livello di ragionamento più profondo. A meno che non lo imposti tramite la variabile di ambiente `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code applica `max` solo alla sessione corrente.680`max` è il livello di ragionamento più profondo. A meno che non lo imposti tramite la variabile d'ambiente `CLAUDE_CODE_EFFORT_LEVEL`, Claude Code applica `max` solo alla sessione corrente.

671 681 

672<Note>682<Note>

673 Un livello che scegli dal controllo dello sforzo su un telefono o browser connesso tramite [Remote Control](/docs/it/remote-control#what-connected-devices-see) si applica solo a quella sessione.683 Un livello che scegli dal controllo dello sforzo su un telefono o browser connesso tramite [Remote Control](/docs/it/remote-control#what-connected-devices-see) si applica solo a quella sessione.


675 685 

676<span id="non-interactive-effort" />686<span id="non-interactive-effort" />

677 687 

678Quando imposti un livello con `/effort` in un'esecuzione [`-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito.688Quando imposti un livello con `/effort` in un'[esecuzione `-p`](/docs/it/headless), Claude Code lo applica solo a quella sessione e non lo salva come predefinito.

679 689 

680Il cursore `/effort` ha anche un'opzione **Ultracode**. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: con essa attivata, Claude orchestra [flussi di lavoro dinamici](/docs/it/workflows) per attività sostanziali, a qualsiasi livello di sforzo la sessione viene eseguita. Per dove può essere impostato in modo persistente, vedere l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).690Il cursore `/effort` ha anche un'opzione **Ultracode**. Ultracode è un'impostazione di Claude Code piuttosto che un livello di sforzo del modello: quando è attiva, Claude orchestra [workflow dinamici](/docs/it/workflows) per attività sostanziali, a qualunque livello di sforzo venga eseguita la sessione. Per sapere dove può essere impostata in modo persistente, consulta l'impostazione [`ultracode`](/docs/it/settings-reference#ultracode).

681 691 

682Attivare o disattivare ultracode con `/effort` o l'impostazione `ultracode` lascia il livello di sforzo invariato. Il flag `--effort ultracode` e il valore Agent SDK `effortLevel: "ultracode"` lo attivano e impostano anche il livello a `xhigh`. Scegliere un livello nel cursore `/effort` o nel selettore `/model` lascia ultracode come era.692Attivare o disattivare ultracode con `/effort` o l'impostazione `ultracode` lascia invariato il livello di sforzo. Il flag `--effort ultracode` e il valore Agent SDK `effortLevel: "ultracode"` lo attivano e impostano anche il livello a `xhigh`. Scegliere un livello nel cursore `/effort` o nel selettore `/model` lascia ultracode com'era.

683 693 

684Puoi attivare ultracode attraverso uno dei seguenti:694Puoi attivare ultracode in uno dei seguenti modi:

685 695 

686* **`/effort`**: esegui `/effort ultracode` per attivarlo per la sessione corrente o `/effort ultracode off` per disattivarlo. Nel cursore `/effort`, premi `Tab` per capovolgere l'opzione **Ultracode**, quindi `Enter` per applicarla696* **`/effort`**: esegui `/effort ultracode` per attivarlo per la sessione corrente o `/effort ultracode off` per disattivarlo. Nel cursore `/effort`, premi `Tab` per cambiare lo stato dell'opzione **Ultracode**, quindi `Enter` per applicarla

687* **Flag `--effort`**: avvia con `claude --effort ultracode`, che avvia la sessione a sforzo `xhigh` con ultracode attivato697* **Flag `--effort`**: avvia con `claude --effort ultracode`, che avvia la sessione a sforzo `xhigh` con ultracode attivato

688* **Impostazione `ultracode`**: imposta [`"ultracode": true`](/docs/it/settings-reference#ultracode) in un file di impostazioni, con `--settings`, o in una richiesta di controllo Agent SDK. Una richiesta [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) accetta anche `effortLevel: "ultracode"`, che lo attiva e imposta il livello di sforzo a `xhigh`698* **Impostazione `ultracode`**: imposta [`"ultracode": true`](/docs/it/settings-reference#ultracode) in un file di impostazioni, con `--settings`, o in una richiesta di controllo Agent SDK. Una richiesta [`applyFlagSettings()`](/docs/it/agent-sdk/typescript#applyflagsettings) accetta anche `effortLevel: "ultracode"`, che lo attiva e imposta il livello di sforzo a `xhigh`

689 699 

690La forma `/effort ultracode off`, il cursore toggle e mantenere ultracode attivato a livelli di sforzo diversi da `xhigh` richiedono Claude Code v2.1.284 o successiva. Prima della v2.1.284, attivare ultracode impostava la sessione a sforzo `xhigh`, scegliere un altro livello lo disattivava, e un limite di sforzo inferiore a `xhigh` lo rendeva non disponibile.700La forma `/effort ultracode off`, l'opzione nel cursore e il mantenimento di ultracode attivato a livelli di sforzo diversi da `xhigh` richiedono Claude Code v2.1.284 o successiva. Prima della v2.1.284, attivare ultracode impostava la sessione a sforzo `xhigh`, scegliere un altro livello lo disattivava, e un limite di sforzo inferiore a `xhigh` lo rendeva non disponibile.

691 701 

692Passare `ultracode` al flag `--effort` o al valore Agent SDK `effortLevel` richiede Claude Code v2.1.203 o successiva. Prima della v2.1.203, `--effort ultracode` stampava `Unknown --effort value 'ultracode'` e la sessione iniziava allo sforzo predefinito.702Passare `ultracode` al flag `--effort` o al valore Agent SDK `effortLevel` richiede Claude Code v2.1.203 o successiva. Prima della v2.1.203, `--effort ultracode` stampava `Unknown --effort value 'ultracode'` e la sessione iniziava allo sforzo predefinito.

693 703 

694L'impostazione `effortLevel` persistente e la variabile di ambiente `CLAUDE_CODE_EFFORT_LEVEL` non accettano `ultracode`. Se `CLAUDE_CODE_EFFORT_LEVEL` o un [limite di sforzo](#organization-effort-limits) imposta il livello della sessione, ultracode rimane attivato a quel livello.704L'impostazione persistente `effortLevel` e la variabile d'ambiente `CLAUDE_CODE_EFFORT_LEVEL` non accettano `ultracode`. Se `CLAUDE_CODE_EFFORT_LEVEL` o un [limite di sforzo](#organization-effort-limits) imposta il livello della sessione, ultracode rimane attivato a quel livello.

695 705 

696<span id="when-ultracode-is-available" />706<span id="when-ultracode-is-available" />

697 707 

698Ultracode non è disponibile quando:708Ultracode non è disponibile quando:

699 709 

700* [I flussi di lavoro sono disattivati](/docs/it/workflows#turn-workflows-off)710* [I workflow sono disattivati](/docs/it/workflows#turn-workflows-off)

701* Il modello non supporta lo sforzo `xhigh`711* Il modello non supporta lo sforzo `xhigh`

702 712 

703In questi casi `--effort ultracode` avvia la sessione con ultracode disattivato, al livello di sforzo più alto che il modello e qualsiasi limite consentono, fino a `xhigh`.713In questi casi `--effort ultracode` avvia la sessione con ultracode disattivato, al livello di sforzo più alto che il modello e un eventuale limite consentono, fino a `xhigh`.

704 714 

705<h4 id="choose-an-effort-level">715<h4 id="choose-an-effort-level">

706 Scegli un livello di sforzo716 Scegli un livello di sforzo

707</h4>717</h4>

708 718 

709Ogni livello scambia la spesa di token rispetto alla capacità. Il predefinito si adatta alla maggior parte dei compiti di codifica; regola quando desideri un equilibrio diverso.719Ogni livello bilancia la spesa di token rispetto alla capacità. Il predefinito si adatta alla maggior parte delle attività di programmazione; regolalo quando desideri un equilibrio diverso.

710 720 

711| Livello | Quando usarlo |721| Livello | Quando usarlo |

712| :- | :- |722| :- | :- |

713| `low` | Scambi rapidi dove rivedi ogni risultato, come brainstorming, uno schizzo iniziale o un piccolo cambio come una ridenominazione |723| `low` | Scambi rapidi in cui rivedi ogni risultato, come brainstorming, una prima bozza o una piccola modifica come una ridenominazione |

714| `medium` | Il predefinito su Opus 5.5, Sonnet 5.5 e Haiku 5.5. Su Opus 5.5 e Sonnet 5.5, si adatta al lavoro di ingegneria quotidiano con un ambito chiaro, come l'implementazione di una nuova funzionalità. Sui modelli con un predefinito più alto, riduce l'utilizzo di token per il lavoro sensibile ai costi che può sacrificare un po' di intelligenza |724| `medium` | Il predefinito su Opus 5.5, Sonnet 5.5 e Haiku 5.5. Su Opus 5.5 e Sonnet 5.5, si adatta al lavoro di ingegneria quotidiano con un ambito chiaro, come l'implementazione di una nuova funzionalità. Sui modelli con un predefinito più alto, riduce l'utilizzo di token per il lavoro sensibile ai costi che può sacrificare un po' di intelligenza |

715| `high` | Lavoro dove la verifica è importante o i casi limite sono probabili, come la correzione di un bug in un codebase esistente. Il predefinito su ogni modello tranne Opus 5.5, Sonnet 5.5, Haiku 5.5 e Opus 4.7 |725| `high` | Lavoro in cui la verifica è importante o i casi limite sono probabili, come la correzione di un bug in un codebase esistente. Il predefinito su ogni modello tranne Opus 5.5, Sonnet 5.5, Haiku 5.5 e Opus 4.7 |

716| `xhigh` | Ragionamento più profondo a spesa di token più elevata. Il predefinito su Opus 4.7 |726| `xhigh` | Ragionamento più profondo a una spesa di token più elevata. Il predefinito su Opus 4.7 |

717| `max` | Problemi difficili che desideri che Claude risolva senza di te, come trovare vulnerabilità di sicurezza. `max` può mostrare rendimenti decrescenti ed è soggetto a eccesso di riflessione, quindi prova prima di adottare ampiamente |727| `max` | Problemi difficili che vuoi che Claude risolva senza di te, come trovare vulnerabilità di sicurezza. `max` può mostrare rendimenti decrescenti ed è soggetto a ragionamento eccessivo, quindi provalo prima di adottarlo su larga scala |

718| `ultracode` | Un'impostazione di Claude Code piuttosto che un livello: pianifica un [flusso di lavoro dinamico](/docs/it/workflows) per ogni attività sostanziale a qualsiasi livello di sforzo |728| `ultracode` | Un'impostazione di Claude Code piuttosto che un livello: pianifica un [workflow dinamico](/docs/it/workflows) per ogni attività sostanziale a qualsiasi livello di sforzo |

719 729 

720Nei test su Opus 5.5 e Fable 5.1, Claude a un livello superiore ha testato più casi limite e ha verificato più del suo lavoro prima di rispondere. Ha anche fatto più scelte da solo. A un livello inferiore, Claude ha restituito un punto di partenza più velocemente, che si adatta al lavoro dove rivedi ogni risultato e guidi il passo successivo. Per vedere gli stessi compiti eseguiti a ogni livello, leggi [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) sul blog.730Nei test su Opus 5.5 e Fable 5.1, Claude a un livello superiore ha testato più casi limite e ha verificato una parte maggiore del suo lavoro prima di rispondere. Ha anche fatto più scelte in autonomia. A un livello inferiore, Claude ha restituito un punto di partenza più velocemente, il che si adatta al lavoro in cui rivedi ogni risultato e guidi il passo successivo. Per vedere le stesse attività eseguite a ogni livello, leggi [Using Claude Code: Spending your effort](https://claude.dev/blog/spending-your-effort/) sul blog.

721 731 

722La scala dello sforzo è calibrata per modello, quindi lo stesso nome di livello non rappresenta lo stesso valore sottostante tra i modelli.732La scala dello sforzo è calibrata per modello, quindi lo stesso nome di livello non rappresenta lo stesso valore sottostante tra i modelli.

723 733 

724Opus 5.5 [predefinito a `medium`](#adjust-effort-level), un livello sotto il predefinito di Opus 5 di `high`. Nei test di Anthropic, Opus 5.5 a `medium` corrisponde o supera Opus 5 a `high` su valutazioni di codifica e lavoro di conoscenza. A un dato livello, Opus 5.5 tende a pensare più per turno rispetto a Opus 5. Quando passi da Opus 5 a Opus 5.5, inizia a `medium` piuttosto che portare il livello che hai usato su Opus 5. Per testare i livelli rispetto al tuo lavoro, vedere [Calibra lo sforzo](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) nella guida al prompting di Opus 5.5.734Il predefinito di Opus 5.5 è [`medium`](#adjust-effort-level), un livello sotto il predefinito `high` di Opus 5. Nei test di Anthropic, Opus 5.5 a `medium` eguaglia o supera Opus 5 a `high` nelle valutazioni di programmazione e lavoro di conoscenza. A parità di livello, Opus 5.5 tende a ragionare di più per turno rispetto a Opus 5. Quando passi da Opus 5 a Opus 5.5, inizia da `medium` invece di riportare il livello che usavi su Opus 5. Per testare i livelli sul tuo lavoro, consulta [Calibrate effort](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-opus-5-5#calibrate-effort) nella guida al prompting di Opus 5.5.

725 735 

726<h4 id="use-ultrathink-for-one-off-deep-reasoning">736<h4 id="use-ultrathink-for-one-off-deep-reasoning">

727 Usa ultrathink per il ragionamento profondo una tantum737 Usa ultrathink per un ragionamento profondo una tantum

728</h4>738</h4>

729 739 

730Includi `ultrathink` in qualsiasi punto del tuo prompt per richiedere un ragionamento più profondo su quel turno senza modificare l'impostazione dello sforzo della sessione. Claude Code riconosce la parola chiave e aggiunge un'istruzione nel contesto. Il livello di sforzo inviato all'API rimane invariato. Claude Code passa altre frasi come "think", "think hard" e "think more" come testo di prompt ordinario e non le riconosce come parole chiave.740Includi `ultrathink` in qualsiasi punto del tuo prompt per richiedere un ragionamento più profondo in quel turno senza modificare l'impostazione dello sforzo della sessione. Claude Code riconosce la parola chiave e aggiunge un'istruzione nel contesto. Il livello di sforzo inviato all'API rimane invariato. Claude Code passa altre frasi come "think", "think hard" e "think more" come normale testo del prompt e non le riconosce come parole chiave.

731 741 

732<h4 id="set-the-effort-level">742<h4 id="set-the-effort-level">

733 Imposta il livello di sforzo743 Imposta il livello di sforzo

734</h4>744</h4>

735 745 

736Puoi modificare lo sforzo attraverso uno dei seguenti:746Puoi modificare lo sforzo in uno dei seguenti modi:

737 747 

738* **`/effort`**: esegui `/effort` senza argomenti per aprire un cursore interattivo, `/effort` seguito da un nome di livello per impostarlo direttamente, o `/effort auto` per cancellare il tuo livello salvato per il modello attivo. Puoi eseguirlo mentre Claude sta lavorando, e una volta confermato l'[avviso della cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla richiesta successiva nel turno748* **`/effort`**: esegui `/effort` senza argomenti per aprire un cursore interattivo, `/effort` seguito da un nome di livello per impostarlo direttamente, o `/effort auto` per cancellare il livello salvato per il modello attivo. Puoi eseguirlo mentre Claude sta lavorando e, una volta confermato l'[avviso sulla cache](/docs/it/prompt-caching#changing-effort-level), se Claude Code ne mostra uno, Claude Code applica il nuovo livello alla richiesta successiva nel turno

739* **In `/model`**: usa i tasti freccia sinistra/destra per regolare il cursore dello sforzo quando selezioni un modello749* **In `/model`**: usa i tasti freccia sinistra/destra per regolare il cursore dello sforzo quando selezioni un modello

740* **Flag `--effort`**: passa un nome di livello per impostarlo per una singola sessione quando avvii Claude Code750* **Flag `--effort`**: passa un nome di livello per impostarlo per una singola sessione quando avvii Claude Code

741* **Variabile di ambiente**: imposta `CLAUDE_CODE_EFFORT_LEVEL` su un nome di livello o `auto`751* **Variabile d'ambiente**: imposta `CLAUDE_CODE_EFFORT_LEVEL` su un nome di livello o `auto`

742* **Impostazioni**: imposta un livello per modello in [`modelSettings`](/docs/it/settings-reference#modelsettings), o imposta [`effortLevel`](/docs/it/settings-reference#effortlevel) su `low`, `medium`, `high` o `xhigh` come predefinito per i modelli senza uno. `max` non è accettato in nessuna delle due chiavi, e `ultracode` ha la sua propria chiave [`ultracode`](/docs/it/settings-reference#ultracode)752* **Impostazioni**: imposta un livello per modello in [`modelSettings`](/docs/it/settings-reference#modelsettings), o imposta [`effortLevel`](/docs/it/settings-reference#effortlevel) su `low`, `medium`, `high` o `xhigh` come predefinito per i modelli che non ne hanno uno. `max` non è accettato come livello in nessuna delle due chiavi, e `ultracode` ha la sua chiave [`ultracode`](/docs/it/settings-reference#ultracode)

743* **Da un dispositivo connesso**: in una sessione [Remote Control](/docs/it/remote-control#what-connected-devices-see), scegli un livello dal controllo dello sforzo sul tuo telefono o nel tuo browser. Il livello si applica solo alla sessione corrente. Richiede Claude Code v2.1.234 o successiva753* **Da un dispositivo connesso**: in una sessione [Remote Control](/docs/it/remote-control#what-connected-devices-see), scegli un livello dal controllo dello sforzo sul tuo telefono o nel browser. Il livello si applica solo alla sessione corrente. Richiede Claude Code v2.1.234 o successiva

744* **Frontmatter di skill e subagente**: imposta `effort` in un file markdown [skill](/docs/it/skills#frontmatter-reference) o [subagente](/docs/it/sub-agents#supported-frontmatter-fields) per sostituire il livello di sforzo quando quella skill o subagente viene eseguito754* **Frontmatter di skill e subagent**: imposta `effort` nel file markdown di una [skill](/docs/it/skills#frontmatter-reference) o di un [subagent](/docs/it/sub-agents#supported-frontmatter-fields) per sovrascrivere il livello di sforzo quando quella skill o quel subagent viene eseguito

745 755 

746Lo sforzo del frontmatter si applica quando quella skill o subagente è attivo, sostituendo il livello della sessione ma non la variabile di ambiente. Un [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel) o [limite di sforzo dell'organizzazione](#organization-effort-limits) limita comunque il livello a cui la skill o il subagente viene eseguito.756Lo sforzo del frontmatter si applica quando quella skill o quel subagent è attivo, sovrascrivendo il livello della sessione ma non la variabile d'ambiente. Un [`maxEffortLevel`](/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.

747 757 

748Se imposti `effortLevel` nelle [impostazioni gestite](/docs/it/managed-settings), 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 o sotto un livello, imposta [`maxEffortLevel`](/docs/it/settings-reference#maxeffortlevel).758Se imposti `effortLevel` nelle [impostazioni gestite](/docs/it/managed-settings), 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`](/docs/it/settings-reference#maxeffortlevel).

749 759 

750Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Il livello di sforzo corrente è anche mostrato nell'intestazione della sessione accanto al nome del modello, ad esempio "con sforzo basso", in modo che tu possa confermare quale impostazione è attiva senza aprire `/model`. Il piè di pagina mostra anche brevemente il livello di sforzo all'avvio e quando cambia.760Il cursore dello sforzo appare in `/model` quando è selezionato un modello supportato. Il livello di sforzo corrente è mostrato anche nell'intestazione della sessione accanto al nome del modello, ad esempio "with low effort", così puoi verificare quale impostazione è attiva senza aprire `/model`. Il piè di pagina mostra anche brevemente il livello di sforzo all'avvio e quando cambia.

751 761 

752<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">762<h4 id="adaptive-reasoning-and-fixed-thinking-budgets">

753 Ragionamento adattivo e budget di pensiero fissi763 Ragionamento adattivo e budget di ragionamento fissi

754</h4>764</h4>

755 765 

756Il ragionamento adattivo rende il pensiero opzionale ad ogni passo, quindi Claude può rispondere più velocemente ai prompt di routine e riservare il pensiero più profondo ai passi che ne traggono beneficio. Se desideri che Claude pensi più o meno spesso di quanto il livello corrente produce, puoi dirlo direttamente nel tuo prompt o in `CLAUDE.md`; il modello risponde a quella guida entro la sua impostazione di sforzo.766Il ragionamento adattivo rende il ragionamento opzionale a ogni passo, quindi Claude può rispondere più velocemente ai prompt di routine e riservare un ragionamento più profondo ai passi che ne traggono beneficio. Se vuoi che Claude ragioni più o meno spesso di quanto produce il livello corrente, puoi dirlo direttamente nel tuo prompt o in `CLAUDE.md`; il modello segue quell'indicazione entro la sua impostazione di sforzo.

757 767 

758I modelli Fable, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi utilizzano sempre il ragionamento adattivo. La modalità di budget di ragionamento fisso e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` non si applicano a loro.768I modelli Fable, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi utilizzano sempre il ragionamento adattivo. La modalità con budget di ragionamento fisso e `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` non si applicano a loro.

759 769 

760Su Opus 4.6 e Sonnet 4.6, puoi impostare `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` per tornare al precedente budget di pensiero fisso controllato da `MAX_THINKING_TOKENS`. Vedere [variabili di ambiente](/docs/it/env-vars).770Su Opus 4.6 e Sonnet 4.6, puoi impostare `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` per tornare al precedente budget di ragionamento fisso controllato da `MAX_THINKING_TOKENS`. Consulta [variabili d'ambiente](/docs/it/env-vars).

761 771 

762<h3 id="extended-thinking">772<h3 id="extended-thinking">

763 Extended thinking773 Ragionamento esteso

764</h3>774</h3>

765 775 

766Extended thinking è il ragionamento che Claude emette prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo primario per quanto pensiero accade; le impostazioni di seguito attivano o disattivano il pensiero e controllano come viene visualizzato. Con il pensiero disattivato su Anthropic API, Claude Code invia sforzo `high` invece di un livello superiore ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.776Il ragionamento esteso è il ragionamento che Claude produce prima di rispondere. Sui modelli che supportano il [ragionamento adattivo](#adjust-effort-level), il livello di sforzo è il controllo principale della quantità di ragionamento; le impostazioni seguenti attivano o disattivano il ragionamento e controllano come viene visualizzato. Con il ragionamento disattivato su Anthropic API, Claude Code invia lo sforzo `high` invece di un livello superiore ai modelli che sa [non accettare quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5.

767 777 

768| Controllo | Come impostarlo |778| Controllo | Come impostarlo |

769| :- | :- |779| :- | :- |

770| Attiva/disattiva per la sessione corrente | Premi `Option+T` su macOS o `Alt+T` su Windows e Linux |780| Attiva/disattiva per la sessione corrente | Premi `Option+T` su macOS o `Alt+T` su Windows e Linux |

771| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di pensiero. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |781| Imposta il predefinito globale | Esegui `/config` e attiva/disattiva la modalità di ragionamento. Salvato come `alwaysThinkingEnabled` in `~/.claude/settings.json` |

772| Disattiva tramite una variabile d'ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il ragionamento su Anthropic API tranne che su Opus 5.5, Sonnet 5.5, Haiku 5.5 e sui modelli Fable. Sui [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette invece il parametro `thinking`, e i modelli con ragionamento adattivo potrebbero comunque ragionare |782| Disattiva tramite una variabile d'ambiente | Imposta [`MAX_THINKING_TOKENS=0`](/docs/it/env-vars), che disattiva il ragionamento su Anthropic API tranne che su Opus 5.5, Sonnet 5.5, Haiku 5.5 e sui modelli Fable. Sui [provider di terze parti](/docs/it/third-party-integrations), Claude Code omette invece il parametro `thinking`, e i modelli con ragionamento adattivo potrebbero comunque ragionare |

773 783 

774Non puoi disattivare il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable. L'opzione della sessione e la riga di `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` salvato non ha effetto lì. Su questi modelli, il modello decide per ogni passo quanto ragionare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che la accetta.784Non puoi disattivare il ragionamento su Opus 5.5, Sonnet 5.5, Haiku 5.5 o sui modelli Fable. L'opzione della sessione e la riga di `/config` mostrano `Thinking can't be turned off` per questi modelli invece di offrire l'interruttore, e un `alwaysThinkingEnabled: false` o `MAX_THINKING_TOKENS=0` salvato non ha effetto lì. Su questi modelli, il modello decide per ogni passo quanto ragionare in base al livello di sforzo. L'impostazione salvata si applica di nuovo quando passi a un modello che la accetta.

775 785 

776Claude Code comprime l'output di pensiero per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedi il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di pensiero redatti per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se desideri i riassunti completi disponibili quando espandi. Ti viene addebitato per tutti i token di pensiero generati, anche quando compressi o redatti.786Claude Code comprime l'output del ragionamento per impostazione predefinita. Premi `Ctrl+O` per attivare/disattivare la modalità dettagliata e vedere il ragionamento come testo grigio in corsivo. Le sessioni interattive su Anthropic API ricevono blocchi di ragionamento oscurati per impostazione predefinita, quindi imposta `showThinkingSummaries: true` nelle [impostazioni](/docs/it/settings) se vuoi che i riassunti completi siano disponibili quando espandi. Ti vengono addebitati tutti i token di ragionamento generati, anche quando compressi o oscurati.

777 787 

778<a id="extended-context-with-1m" />788<a id="extended-context-with-1m" />

779 789 

790<span id="sonnet-5-5-and-sonnet-5-context-window" />

791 

780<h3 id="extended-context">792<h3 id="extended-context">

781 Extended context793 Contesto esteso

782</h3>794</h3>

783 795 

784Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, Opus 4.6 e successivi, e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con codebase di grandi dimensioni.796Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, Opus 4.6 e successivi, e Sonnet 4.6 supportano una [finestra di contesto di 1 milione di token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) per sessioni lunghe con codebase di grandi dimensioni.

785 797 

786Su Anthropic API, Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi vengono eseguiti con la finestra 1M su ogni piano, incluso Pro. Non selezioni una variante `[1m]` né attivi crediti di utilizzo per la finestra 1M su questi modelli. L'utilizzo di Fable stesso può essere fatturato ai crediti di utilizzo su alcuni piani; vedere [Fable e crediti di utilizzo](#fable-and-usage-credits).798Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi vengono eseguiti con la finestra 1M per impostazione predefinita, senza bisogno del suffisso `[1m]`. Ciò include le sessioni su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, e le sessioni tramite [Claude apps gateway](/docs/it/claude-apps-gateway). Per eseguirli invece con una finestra di 200K, consulta [Disattiva il contesto 1M](#turn-off-1m-context).

787 799 

788Opus 4.6 e Sonnet 4.6 raggiungono 1M solo attraverso la loro variante `[1m]`, e l'accesso a quella variante dipende dal tuo piano. Su piani Max, Team ed Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus 4.6 con contesto 1M è incluso nel tuo abbonamento. Sonnet 4.6 con contesto 1M richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.800Opus 4.6 e Sonnet 4.6 raggiungono 1M solo attraverso la loro variante `[1m]`, e l'accesso a quella variante dipende dal tuo piano. Sui piani Max, Team ed Enterprise, inclusi sia i posti Team Standard che Team Premium, Opus 4.6 con contesto 1M è incluso nel tuo abbonamento. Sonnet 4.6 con contesto 1M richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) su ogni piano di abbonamento, incluso Max.

789 801 

790| Piano | Opus 4.6 con contesto 1M | Sonnet 4.6 con contesto 1M |802| Piano | Opus 4.6 con contesto 1M | Sonnet 4.6 con contesto 1M |

791| - | - | - |803| - | - | - |


793| Pro | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |805| Pro | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) | Richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

794| API e pagamento a consumo | Accesso completo | Accesso completo |806| API e pagamento a consumo | Accesso completo | Accesso completo |

795 807 

796Claude Code controlla questi requisiti del piano solo quando si connette direttamente a Anthropic API. Se punti `ANTHROPIC_BASE_URL` a un [gateway LLM](/docs/it/llm-gateway#subscriptions-and-gateways) e il tuo accesso salvato a claude.ai rimane la credenziale attiva, Claude Code non controlla i crediti di utilizzo del tuo piano. Le opzioni `[1m]` rimangono disponibili in `/model`, e il gateway decide se la richiesta ha successo. Prima della v2.1.229, Claude Code rifiutava `/model sonnet[1m]` in quella configurazione quando non poteva confermare i crediti di utilizzo sull'account.808Claude Code controlla questi requisiti del piano solo quando si connette direttamente ad Anthropic API. Se punti `ANTHROPIC_BASE_URL` a un [gateway LLM](/docs/it/llm-gateway#subscriptions-and-gateways) e il tuo accesso salvato a claude.ai rimane la credenziale attiva, Claude Code non controlla i crediti di utilizzo del tuo piano. Le opzioni `[1m]` rimangono disponibili in `/model`, e il gateway decide se la richiesta ha successo. Prima della v2.1.229, Claude Code rifiutava `/model sonnet[1m]` in quella configurazione quando non poteva confermare i crediti di utilizzo sull'account.

797 

798<span id="context-window-behind-a-gateway" />

799 

800Se imposti `ANTHROPIC_BASE_URL` su un [gateway LLM](/docs/it/llm-gateway) o un altro proxy, Claude Code assegna a ogni modello che riconosce la stessa finestra di contesto che il modello ha su Anthropic API. Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi ottengono la finestra 1M senza una variante `[1m]` da selezionare, e un modello che raggiunge 1M solo tramite la sua variante `[1m]`, come Opus 4.6, viene eseguito a 200K senza di essa. Claude Code non può rilevare un limite inferiore applicato dal gateway o dal server che si trova dietro di esso. Se il tuo gateway rifiuta le richieste sopra i 200K token, imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/it/env-vars) nell'ambiente che avvia Claude Code, in modo che le sessioni su ogni modello [si compattino a quel limite](#set-the-auto-compact-window).

801 

802Per disattivare il contesto 1M, imposta `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code rimuove le varianti di modello 1M dal selettore di modelli. Su modelli con una finestra 1M nativa, come Sonnet 5 e i modelli Fable, tratta anche il modello come avente una finestra di contesto di 200K:

803 809 

804* Con la compattazione automatica attivata, le sessioni si compattano al confine 200K attraverso la [compattazione automatica](#set-the-auto-compact-window). Impostare la finestra di compattazione automatica sopra 200K non solleva il mantenimento, perché Claude Code limita quella finestra alla finestra di contesto del modello.810Su Anthropic API, la finestra di contesto 1M utilizza i prezzi standard del modello senza sovrapprezzo per i token oltre 200K, tranne su Haiku 5.5, che [costa di più sui prompt più lunghi di 100K token](#haiku-5-5-context-window-and-pricing). Per i piani in cui il contesto esteso è incluso nel tuo abbonamento, l'utilizzo rimane coperto dal tuo abbonamento. Per i piani che accedono al contesto esteso tramite crediti di utilizzo, i token vengono fatturati ai crediti di utilizzo.

805* Con la compattazione automatica disattivata, le sessioni si fermano al confine 200K con l'[errore di limite di contesto](/docs/it/errors#prompt-is-too-long) invece di compattarsi.

806 811 

807Prima della v2.1.223, Claude Code manteneva solo le sessioni Sonnet 5, Opus 4.8 e Opus 5 a 200K. Vedere [variabili di ambiente](/docs/it/env-vars).812<h4 id="select-1m-context-for-opus-4-6-or-sonnet-4-6">

808 813 Seleziona il contesto 1M per Opus 4.6 o Sonnet 4.6

809La finestra di contesto 1M utilizza i prezzi standard del modello senza sovrapprezzo per i token oltre 200K, tranne su Haiku 5.5, che [costa di più sui prompt più lunghi di 100K token](#haiku-5-5-context-window-and-pricing). Per i piani in cui il contesto esteso è incluso nel tuo abbonamento, l'utilizzo rimane coperto dal tuo abbonamento. Per i piani che accedono al contesto esteso tramite crediti di utilizzo, i token vengono fatturati ai crediti di utilizzo.814</h4>

810 

811Se il tuo account supporta il contesto 1M, l'opzione appare nel selettore `/model` nelle versioni più recenti di Claude Code. Se non la vedi, prova a riavviare la tua sessione, e su un provider di terze parti verifica se il tuo deployment [ha bloccato il modello](#pin-models-for-third-party-deployments) con una variabile `ANTHROPIC_DEFAULT_*_MODEL`.

812 815 

813Puoi anche usare il suffisso `[1m]` con alias di modello o nomi di modello completi:816Per selezionare una variante 1M per nome, aggiungi il suffisso `[1m]` a un alias di modello o a un nome di modello completo:

814 817 

815```text theme={null}818```text theme={null}

816# Usa l'alias opus[1m] o sonnet[1m]819# Aggiungi [1m] a un nome di modello completo

817/model opus[1m]820/model claude-opus-4-6[1m]

818/model sonnet[1m]821/model claude-sonnet-4-6[1m]

819 822 

820# O aggiungi [1m] a un nome di modello completo823# Oppure a un alias: il suffisso si applica al modello in cui l'alias si risolve

821/model claude-opus-4-8[1m]824/model opus[1m]

822```825```

823 826 

824<h4 id="sonnet-5-5-and-sonnet-5-context-window">827<span id="context-window-behind-a-gateway" />

825 Finestra di contesto di Sonnet 5.5 e Sonnet 5828 

829<h4 id="context-window-behind-an-llm-gateway">

830 Finestra di contesto dietro un gateway LLM

826</h4>831</h4>

827 832 

828Su Anthropic API, Sonnet 5.5 e Sonnet 5 vengono sempre eseguiti con la finestra di contesto 1M. Non c'è variante 200K, nessun suffisso `[1m]` da selezionare e nessun credito di utilizzo richiesto su nessun piano. Le sessioni si compattano automaticamente prima che la finestra si riempia, a circa 967K token per impostazione predefinita; imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars) per scegliere una soglia diversa.833Se imposti `ANTHROPIC_BASE_URL` su un [gateway LLM](/docs/it/llm-gateway) o un altro proxy, Claude Code assegna a ogni modello che riconosce la stessa finestra di contesto che il modello ha su Anthropic API. Fable 5.1, Fable 5, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi ottengono la finestra 1M senza una variante `[1m]` da selezionare, e un modello che raggiunge 1M solo tramite la sua variante `[1m]`, come Opus 4.6, viene eseguito a 200K senza di essa. Claude Code non può rilevare un limite inferiore applicato dal gateway o dal server che si trova dietro di esso. Se il tuo gateway rifiuta le richieste sopra i 200K token, imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/it/env-vars) nell'ambiente che avvia Claude Code, in modo che le sessioni su ogni modello [si compattino a quel limite](#set-the-auto-compact-window).

829 834 

830Claude Code assegna a Sonnet 5.5 e Sonnet 5 la stessa finestra 1M dietro un [gateway LLM](/docs/it/llm-gateway) o un altro `ANTHROPIC_BASE_URL` personalizzato. Se il tuo gateway applica un limite inferiore, vedere [la finestra di contesto dietro un gateway](#context-window-behind-a-gateway).835<h4 id="turn-off-1m-context">

836 Disattiva il contesto 1M

837</h4>

831 838 

832Questa impostazione limita la finestra a 200K:839Per mantenere le sessioni a una finestra di 200K, imposta `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` nella tua shell o in un [file di impostazioni](/docs/it/env-vars#set-environment-variables). Claude Code rimuove le varianti di modello `[1m]` dal selettore di modelli. Sui modelli che vengono eseguiti con la finestra 1M per impostazione predefinita, come i modelli Fable, Sonnet 5 e successivi, e Opus 4.7 e successivi, tratta anche il modello come avente una finestra di contesto di 200K:

833 840 

834* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: mantiene le sessioni su ogni modello con una finestra 1M nativa a una finestra 200K; vedere [Extended context](#extended-context) per come il mantenimento viene applicato. Utile per i deployment che devono limitare il contesto.841* Con la compattazione automatica attivata, le sessioni si compattano al limite di 200K tramite la [compattazione automatica](#set-the-auto-compact-window). Impostare la finestra di compattazione automatica sopra 200K non rimuove il limite, perché Claude Code limita quella finestra alla finestra di contesto del modello.

842* Con la compattazione automatica disattivata, le sessioni si fermano al limite di 200K con l'[errore di limite di contesto](/docs/it/errors#prompt-is-too-long) invece di compattarsi.

835 843 

836<h4 id="haiku-5-5-context-window-and-pricing">844<h4 id="haiku-5-5-context-window-and-pricing">

837 Finestra di contesto e prezzi di Haiku 5.5845 Finestra di contesto e prezzi di Haiku 5.5


844Le sessioni si compattano automaticamente a circa 967K token per impostazione predefinita. Per compattare prima, [imposta una finestra di compattazione automatica più piccola](#set-the-auto-compact-window) per il modello.852Le sessioni si compattano automaticamente a circa 967K token per impostazione predefinita. Per compattare prima, [imposta una finestra di compattazione automatica più piccola](#set-the-auto-compact-window) per il modello.

845 853 

846<h2 id="context-window-and-auto-compaction">854<h2 id="context-window-and-auto-compaction">

847 Finestra di contesto e auto-compattazione855 Finestra di contesto e compattazione automatica

848</h2>856</h2>

849 857 

850La finestra auto-compact è il livello di riempimento della finestra di contesto prima che Claude Code compatti la conversazione. Per informazioni su cosa la compattazione mantiene e scarta per ogni meccanismo, vedere [What survives compaction](/docs/it/context-window#what-survives-compaction).858La finestra di compattazione automatica è il livello di riempimento della finestra di contesto prima che Claude Code compatti la conversazione. Per informazioni su cosa la compattazione mantiene e scarta per ogni meccanismo, consulta [Cosa sopravvive alla compattazione](/docs/it/context-window#what-survives-compaction).

851 859 

852<h3 id="set-the-auto-compact-window">860<h3 id="set-the-auto-compact-window">

853 Impostare la finestra auto-compact861 Impostare la finestra di compattazione automatica

854</h3>862</h3>

855 863 

856Puoi impostare la finestra di compattazione automatica in queste posizioni:864Puoi impostare la finestra di compattazione automatica in queste posizioni:

857 865 

858* **Per il modello corrente, in questa sessione e in quelle successive**: esegui `/autocompact` con un valore, come `/autocompact 500k`. Claude Code lo salva nelle tue impostazioni utente sotto il modello corrente in [`modelSettings`](/docs/it/settings-reference#modelsettings) e lo applica alla sessione corrente. Se un [ambito di impostazioni](/docs/it/settings#settings-precedence) con priorità più alta, come le impostazioni gestite, imposta una propria finestra per quel modello o per tutti i modelli, il comando salva il tuo valore ma la sessione mantiene la finestra di tale ambito, e il comando lo comunica. Esegui `/autocompact auto` per tornare alla finestra ottimizzata per il tuo modello. Prima della v2.1.288, il comando salvava un'unica finestra per tutti i modelli, come `autoCompactWindow` di primo livello.866* **Per il modello corrente, in questa sessione e in quelle successive**: esegui `/autocompact` con un valore, come `/autocompact 500k`. Claude Code lo salva nelle tue impostazioni utente sotto il modello corrente in [`modelSettings`](/docs/it/settings-reference#modelsettings) e lo applica alla sessione corrente. Se un [ambito di impostazioni](/docs/it/settings#settings-precedence) con priorità più alta, come le impostazioni gestite, imposta una propria finestra per quel modello o per tutti i modelli, il comando salva il tuo valore ma la sessione mantiene la finestra di tale ambito, e il comando lo comunica. Esegui `/autocompact auto` per tornare alla finestra ottimizzata per il tuo modello. Prima della v2.1.288, il comando salvava un'unica finestra per tutti i modelli, come `autoCompactWindow` di primo livello.

859* **Per tutti i modelli**: imposta [`autoCompactWindow`](/docs/it/settings-reference#autocompactwindow) in un file di impostazioni, ad esempio `"autoCompactWindow": 200000` in `~/.claude/settings.json`. Una finestra che hai salvato per un modello con `/autocompact` ha la precedenza su questa chiave nello stesso file per quel modello.867* **Per tutti i modelli**: imposta [`autoCompactWindow`](/docs/it/settings-reference#autocompactwindow) in un file di impostazioni, ad esempio `"autoCompactWindow": 200000` in `~/.claude/settings.json`. Una finestra che hai salvato per un modello con `/autocompact` ha la precedenza su questa chiave nello stesso file per quel modello.

860* **Per un singolo avvio**: passare [`--autocompact`](/docs/it/cli-reference#cli-flags) all'avvio di Claude Code. Il flag sostituisce l'impostazione salvata per tale avvio senza modificarla, e `claude --autocompact auto` esegue la sessione alla finestra ottimizzata anche se l'impostazione salvata ha un valore. A differenza di `/autocompact`, il flag non è prevenuto da un ambito di impostazioni con priorità più alta, come le impostazioni gestite.868* **Per un singolo avvio**: passa [`--autocompact`](/docs/it/cli-reference#cli-flags) all'avvio di Claude Code. Il flag sovrascrive l'impostazione salvata per tale avvio senza modificarla, e `claude --autocompact auto` esegue la sessione alla finestra ottimizzata anche se l'impostazione salvata ha un valore. A differenza di `/autocompact`, il flag non è prevenuto da un ambito di impostazioni con priorità più alta, come le impostazioni gestite.

861* **In script e ambienti cloud**: impostare [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars). Mentre è impostato, ha precedenza sul comando, sul flag e sull'impostazione, e `/autocompact` segnala l'override invece di modificare la finestra.869* **In script e ambienti cloud**: imposta [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/it/env-vars). Mentre è impostata, ha la precedenza sul comando, sul flag e sull'impostazione, e `/autocompact` segnala l'override invece di modificare la finestra.

862 870 

863Il comando e il flag accettano una dimensione della finestra da 100K a 1M token, in una qualsiasi di queste forme:871Il comando e il flag accettano una dimensione della finestra da 100K a 1M token, in una qualsiasi di queste forme:

864 872 


866* Un suffisso `k` o `M`, come `500k` o `1M`874* Un suffisso `k` o `M`, come `500k` o `1M`

867* Un numero semplice da 100 a 1000, che significa migliaia, quindi `200` imposta 200.000875* Un numero semplice da 100 a 1000, che significa migliaia, quindi `200` imposta 200.000

868 876 

869La variabile di ambiente accetta solo il conteggio di token semplice. Claude Code limita la finestra alla finestra di contesto del modello.877La variabile d'ambiente accetta solo il conteggio di token semplice. Claude Code limita la finestra alla finestra di contesto del modello.

870 878 

871<h3 id="default-auto-compact-thresholds">879<h3 id="default-auto-compact-thresholds">

872 Soglie auto-compact predefinite880 Soglie di compattazione automatica predefinite

873</h3>881</h3>

874 882 

875Se non si imposta una finestra auto-compact, Claude Code compatta quando la conversazione raggiunge il limite di contesto del modello, tranne in queste sessioni:883Se non imposti una finestra di compattazione automatica, Claude Code compatta quando la conversazione raggiunge il limite di contesto del modello, tranne in queste sessioni:

876 884 

877* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello885* Le [sessioni cloud](/docs/it/claude-code-on-the-web) si compattano mentre la conversazione si avvicina al limite del modello

878* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K, così come Opus 4.8 e versioni successive quando vengono eseguiti con una finestra di contesto di 200K, come su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry886* Sonnet 4.6 e Opus 4.6 senza [contesto esteso](#extended-context) si compattano al limite di 200K

879* Quando si imposta [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K887* Quando imposti [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars), i modelli con una finestra nativa di 1M, come Sonnet 5 e i modelli Fable, si compattano al limite di 200K

880* I modelli in esecuzione con una finestra nativa di 1M si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Su Anthropic API, questi includono Sonnet 5, Haiku 5.5, i modelli Fable e Opus 4.7 e versioni successive. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, consulta [Pin models for third-party deployments](#pin-models-for-third-party-deployments) per sapere quali modelli vengono eseguiti con quella finestra. Dietro un `ANTHROPIC_BASE_URL` personalizzato, consulta [the context window behind a gateway](#context-window-behind-a-gateway)888* I modelli in esecuzione con una finestra nativa di 1M si compattano prima che la finestra si riempia, a circa 967K token per impostazione predefinita. Questi includono i modelli Fable, Sonnet 5 e versioni successive, Haiku 5.5 e Opus 4.7 e versioni successive. Dietro un `ANTHROPIC_BASE_URL` personalizzato, consulta [la finestra di contesto dietro un gateway](#context-window-behind-a-gateway)

881* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; vedere [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)889* Le sessioni su un ID modello che Claude Code non riconosce, come un alias [LLM gateway](/docs/it/llm-gateway), si compattano alla finestra di contesto che Claude Code assume per l'ID; consulta [Correggere la finestra per un gateway o un ID modello personalizzato](#correct-the-window-for-a-gateway-or-custom-model-id)

882 890 

883<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">891<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">

884 Correggere la finestra per un gateway o un ID modello personalizzato892 Correggere la finestra per un gateway o un ID modello personalizzato

885</h3>893</h3>

886 894 

887Su un [LLM gateway](/docs/it/llm-gateway) o un'altra distribuzione personalizzata, Claude Code può assumere una finestra di contesto per l'ID modello che differisce dalla finestra reale del modello, indipendentemente dal fatto che risolva l'ID a un modello Claude o meno. Impostare [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.895Su un [LLM gateway](/docs/it/llm-gateway) o un altro deploy personalizzato, Claude Code può assumere una finestra di contesto per l'ID modello che differisce dalla finestra reale del modello, indipendentemente dal fatto che risolva l'ID a un modello Claude o meno. Imposta [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.

888 896 

889Il modo in cui la variabile si applica dipende dall'ID. Claude Code tratta un ID come un provider o un'ortografia personalizzata quando non inizia con `claude-`, in qualsiasi maiuscola/minuscola, o quando porta un suffisso che Claude Code rimuove durante la lettura dell'ID, come la data `@YYYYMMDD` utilizzata su Google Cloud's Agent Platform. Prima della v2.1.259, Claude Code non contava un suffisso rimosso, quindi un ID `claude-` non riconosciuto con un suffisso di data era trattato come un nome `claude-` semplice.897Il modo in cui la variabile si applica dipende dall'ID. Claude Code tratta un ID come un provider o un'ortografia personalizzata quando non inizia con `claude-`, in qualsiasi maiuscola/minuscola, o quando porta un suffisso che Claude Code rimuove durante la lettura dell'ID, come la data `@YYYYMMDD` utilizzata su Google Cloud's Agent Platform. Prima della v2.1.259, Claude Code non contava un suffisso rimosso, quindi un ID `claude-` non riconosciuto con un suffisso di data era trattato come un nome `claude-` semplice.

890 898 

891Un provider non riconosciuto o un'ortografia personalizzata, la stessa ortografia con `[1m]` e ogni altro ID sono tre casi separati:899Un provider non riconosciuto o un'ortografia personalizzata, la stessa ortografia con `[1m]` e ogni altro ID sono tre casi separati:

892 900 

893* Se Claude Code non può risolvere un provider o un'ortografia personalizzata a un modello che riconosce e l'ID non contiene `[1m]`, la variabile si applica direttamente e la compattazione proattiva continua alla finestra dichiarata.901* Se Claude Code non può risolvere un provider o un'ortografia personalizzata a un modello che riconosce e l'ID non contiene `[1m]`, la variabile si applica direttamente e la compattazione proattiva continua alla finestra dichiarata.

894* Se Claude Code non può risolvere un provider o un'ortografia personalizzata a un modello che riconosce e l'ID contiene `[1m]`, in qualsiasi maiuscola/minuscola, Claude Code assume una finestra di 1M per esso e la variabile non si applica da sola. Per correggere la finestra mantenendo la compattazione proattiva, impostare anche [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars). Con quella variabile impostata, Claude Code dimensiona l'ID come la stessa ortografia senza `[1m]`, quindi `CLAUDE_CODE_MAX_CONTEXT_TOKENS` si applica quando si applicherebbe a tale ortografia senza tag.902* Se Claude Code non può risolvere un provider o un'ortografia personalizzata a un modello che riconosce e l'ID contiene `[1m]`, in qualsiasi maiuscola/minuscola, Claude Code assume una finestra di 1M per esso e la variabile non si applica da sola. Per correggere la finestra mantenendo la compattazione proattiva, imposta anche [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/it/env-vars). Con quella variabile impostata, Claude Code dimensiona l'ID come la stessa ortografia senza `[1m]`, quindi `CLAUDE_CODE_MAX_CONTEXT_TOKENS` si applica quando si applicherebbe a tale ortografia senza tag.

895 903 

896 Con una finestra dichiarata superiore a 200K, Claude Code mostra quindi un [avviso di avvio](/docs/it/errors#the-200k-limit-isnt-enforced) che il limite di 200K non è applicato. L'avviso è previsto in questa configurazione.904 Con una finestra dichiarata superiore a 200K, Claude Code mostra quindi un [avviso di avvio](/docs/it/errors#the-200k-limit-isnt-enforced) che il limite di 200K non è applicato. L'avviso è previsto in questa configurazione.

897* Se l'ID si risolve a un modello che Claude Code riconosce, o l'ID è un nome `claude-` semplice senza suffisso per Claude Code da rimuovere, in qualsiasi maiuscola/minuscola, la variabile ha effetto solo quando si imposta anche [`DISABLE_COMPACT`](/docs/it/env-vars), che disabilita tutta la compattazione.905* Se l'ID si risolve a un modello che Claude Code riconosce, o l'ID è un nome `claude-` semplice senza suffisso per Claude Code da rimuovere, in qualsiasi maiuscola/minuscola, la variabile ha effetto solo quando imposti anche [`DISABLE_COMPACT`](/docs/it/env-vars), che disabilita tutta la compattazione.

898 906 

899 Ad esempio, un ID che contiene un nome di modello Claude che Claude Code conosce, come `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, o il datato `claude-sonnet-4-5@20250929`, si risolve a quel modello. Questo include gli ID che contengono anche `[1m]`: Claude Code risolve `claude-opus-4-8[1m]` a Opus 4.8 anche con `CLAUDE_CODE_DISABLE_1M_CONTEXT` impostato.907 Ad esempio, un ID che contiene un nome di modello Claude che Claude Code conosce, come `anthropic/claude-opus-4-8`, `us.anthropic.claude-…-v1:0`, o il datato `claude-sonnet-4-5@20250929`, si risolve a quel modello. Questo include gli ID che contengono anche `[1m]`: Claude Code risolve `claude-opus-4-8[1m]` a Opus 4.8 anche con `CLAUDE_CODE_DISABLE_1M_CONTEXT` impostato.

900 908 

901Per un ID modello che Claude Code non riconosce, impostare [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/it/env-vars) per fare in modo che Claude Code si compatti solo dopo che l'API rifiuta la conversazione con un [errore di lunghezza eccessiva che Claude Code riconosce](/docs/it/errors#prompt-is-too-long). Claude Code non esegue quel recupero quando un gateway [riscrive l'errore](/docs/it/llm-gateway-connect#troubleshoot-gateway-errors) con una formulazione che Claude Code non riconosce.909Per un ID modello che Claude Code non riconosce, imposta [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/it/env-vars) per fare in modo che Claude Code si compatti solo dopo che l'API rifiuta la conversazione con un [errore di lunghezza eccessiva che Claude Code riconosce](/docs/it/errors#prompt-is-too-long). Claude Code non esegue quel recupero quando un gateway [riscrive l'errore](/docs/it/llm-gateway-connect#troubleshoot-gateway-errors) con una formulazione che Claude Code non riconosce.

902 910 

903<h2 id="checking-your-current-model">911<h2 id="checking-your-current-model">

904 Verifica del modello corrente912 Verifica del modello corrente


939Un ID personalizzato che incorpora un nome di famiglia, come `my-gateway/claude-opus-5-5`, conta come una voce specifica per quella famiglia e disabilita il suo wildcard, quindi elencare anche le versioni che intendete mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).947Un ID personalizzato che incorpora un nome di famiglia, come `my-gateway/claude-opus-5-5`, conta come una voce specifica per quella famiglia e disabilita il suo wildcard, quindi elencare anche le versioni che intendete mantenere selezionabili. Vedere [Comportamento di unione](#merge-behavior).

940 948 

941<h2 id="environment-variables">949<h2 id="environment-variables">

942 Variabili di ambiente950 Variabili d'ambiente

943</h2>951</h2>

944 952 

945Utilizzare le seguenti variabili di ambiente per controllare i nomi dei modelli a cui gli alias si mappano. Ogni valore deve essere un nome di modello completo, o l'identificatore equivalente per il provider API. Per scegliere il modello su cui iniziano le sessioni, impostare [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), che questa tabella omette.953Usa le seguenti variabili d'ambiente per controllare i nomi dei modelli a cui gli alias si mappano. Ogni valore deve essere un nome di modello completo, o l'identificatore equivalente per il tuo provider API. Per scegliere il modello su cui iniziano le tue sessioni, imposta [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), che questa tabella omette.

946 954 

947| Variabile di ambiente | Descrizione |955| Variabile d'ambiente | Descrizione |

948| - | - |956| - | - |

949| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Il modello da utilizzare per `fable`, e l'ID del modello che Claude Code riconosce come modello Fable per il [fallback automatico del modello](#automatic-model-fallback) su provider di terze parti |957| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Il modello da usare per `fable`, e l'ID del modello che Claude Code riconosce come modello Fable per il [fallback automatico del modello](#automatic-model-fallback) su provider di terze parti |

950| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Il modello da utilizzare per `opus`, o per `opusplan` quando Plan Mode è attivo. |958| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Il modello da usare per `opus`, o per `opusplan` quando Plan Mode è attivo. |

951| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Il modello da utilizzare per `sonnet`, o per `opusplan` quando Plan Mode non è attivo. |959| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Il modello da usare per `sonnet`, o per `opusplan` quando Plan Mode non è attivo. |

952| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da utilizzare per `haiku`, o [funzionalità in background](/docs/it/costs#background-token-usage) |960| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da usare per `haiku`, o per le [funzionalità in background](/docs/it/costs#background-token-usage) |

953| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per [subagents](/docs/it/sub-agents#choose-a-model), [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) compagni di squadra, e agenti [workflow](/docs/it/workflows) che non sono assegnati a un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Un modello per invocazione o il campo `model` di una definizione, incluso `inherit`, ha la precedenza. Per modificare questo, impostare [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model) |961| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello predefinito per i [subagent](/docs/it/sub-agents#choose-a-model), i membri di un [team di agenti](/docs/it/agent-teams#specify-teammates-and-models) e gli agenti dei [workflow](/docs/it/workflows) a cui non è assegnato un modello in un altro modo. Accetta un alias come `haiku` o un nome di modello completo. Un modello per singola invocazione o il campo `model` di una definizione, incluso `inherit`, ha la precedenza. Per cambiare questo comportamento, imposta [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/it/sub-agents#run-every-subagent-on-one-model) |

954 962 

955Su provider di terze parti, [Personalizzare la visualizzazione e le capacità del modello fissato](#customize-pinned-model-display-and-capabilities) descrive cosa mostra la riga di un modello fissato nel selettore `/model`.963Sui provider di terze parti, [Personalizzare la visualizzazione e le capacità del modello fissato](#customize-pinned-model-display-and-capabilities) descrive cosa mostra la riga di un modello fissato nel selettore `/model`.

956 964 

957Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di `ANTHROPIC_DEFAULT_HAIKU_MODEL`.965Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di

966`ANTHROPIC_DEFAULT_HAIKU_MODEL`.

958 967 

959<h3 id="pin-models-for-third-party-deployments">968<h3 id="pin-models-for-third-party-deployments">

960 Fissare i modelli per distribuzioni di terze parti969 Fissare i modelli per distribuzioni di terze parti

961</h3>970</h3>

962 971 

963Quando si distribuisce Claude Code tramite [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry), o [Claude Platform on AWS](/docs/it/claude-platform-on-aws), fissare le versioni dei modelli prima di distribuire agli utenti.972Quando distribuisci Claude Code tramite [Amazon Bedrock](/docs/it/amazon-bedrock), [Google Cloud's Agent Platform](/docs/it/google-vertex-ai), [Microsoft Foundry](/docs/it/microsoft-foundry) o [Claude Platform on AWS](/docs/it/claude-platform-on-aws), fissa le versioni dei modelli prima di distribuirlo agli utenti.

964 973 

965Senza fissaggio, Claude Code utilizza alias di modelli come `fable`, `opus`, `sonnet` e `haiku` che si risolvono in un ID di modello predefinito incorporato per ogni provider. Tale impostazione predefinita può rimanere indietro rispetto alla versione più recente di Anthropic, e il modello a cui punta potrebbe non essere ancora abilitato nell'account di un utente. Quando l'impostazione predefinita non è disponibile, gli utenti Amazon Bedrock e Google Cloud's Agent Platform vedono un avviso e la sessione ricade nella versione precedente del modello predefinito, o nel modello Sonnet predefinito quando l'impostazione predefinita è un modello Opus e nessuna versione di Opus è disponibile. Gli utenti Microsoft Foundry vedono errori invece, perché Microsoft Foundry non ha alcun controllo di avvio equivalente.974Senza fissaggio, Claude Code usa alias di modelli come `fable`, `opus`, `sonnet` e `haiku` che si risolvono in un ID di modello predefinito incorporato per ogni provider. Questo valore predefinito può rimanere indietro rispetto alla versione più recente di Anthropic, e il modello a cui punta potrebbe non essere ancora abilitato nell'account di un utente. Quando il valore predefinito non è disponibile, gli utenti di Amazon Bedrock e Google Cloud's Agent Platform vedono un avviso e la sessione usa come fallback una versione precedente del modello predefinito, o il modello Sonnet predefinito quando il valore predefinito è un modello Opus e nessuna versione di Opus è disponibile. Gli utenti di Microsoft Foundry vedono invece degli errori, perché Microsoft Foundry non ha alcun controllo di avvio equivalente.

966 975 

967Su Amazon Bedrock e Google Cloud's Agent Platform, un utente che avvia la sessione su una versione specifica di Sonnet oppure Opus, ad esempio con `--model`, `ANTHROPIC_MODEL`, o l'impostazione `model`, fissa quella versione come impostazione predefinita della sessione per l'alias corrispondente: il controllo di avvio salta l'impostazione predefinita incorporata che sostituisce e non mostra alcun avviso di fallback. Prima della v2.1.211, il controllo veniva eseguito e poteva mostrare un avviso anche quando un modello di sessione era configurato esplicitamente.976Su Amazon Bedrock e Google Cloud's Agent Platform, un utente che avvia la sessione su una versione specifica di Sonnet o Opus, ad esempio con `--model`, `ANTHROPIC_MODEL` o l'impostazione `model`, fissa quella versione come predefinita della sessione per l'alias corrispondente: il controllo di avvio salta il valore predefinito incorporato che essa sostituisce e non mostra alcun avviso di fallback. Prima della v2.1.211, il controllo veniva eseguito e poteva mostrare un avviso anche quando un modello di sessione era configurato esplicitamente.

968 977 

969<Warning>978<Warning>

970 Impostare le variabili di ambiente del modello su ID di versione specifici come parte della configurazione iniziale. Il fissaggio consente di controllare quando i vostri utenti passano a un nuovo modello.979 Imposta le variabili d'ambiente del modello su ID di versione specifici come parte della configurazione iniziale. Il fissaggio ti permette di controllare quando i tuoi utenti passano a un nuovo modello.

971</Warning>980</Warning>

972 981 

973Utilizzare le seguenti variabili di ambiente con ID di modello specifici della versione per il provider:982Usa le seguenti variabili d'ambiente con ID di modello specifici della versione per il tuo provider:

974 983 

975| Provider | Esempio |984| Provider | Esempio |

976| :- | :- |985| :- | :- |


978| Google Cloud's Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |987| Google Cloud's Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

979| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |988| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

980 989 

981Applicare lo stesso modello per `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` e `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Per gli ID di modello attuali e legacy su tutti i provider, vedere [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per aggiornare gli utenti a una nuova versione del modello, aggiornare queste variabili di ambiente e ridistribuire.990Applica lo stesso schema per `ANTHROPIC_DEFAULT_FABLE_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL` e `ANTHROPIC_DEFAULT_HAIKU_MODEL`. Per gli ID di modello attuali e legacy su tutti i provider, consulta la [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per aggiornare gli utenti a una nuova versione del modello, aggiorna queste variabili d'ambiente e ridistribuisci.

991 

992Un modello fissato con una finestra 1M nativa, come Opus 4.8 o Sonnet 5, viene eseguito con la [finestra di contesto 1M](#extended-context) senza alcun suffisso quando Claude Code riesce ad abbinare l'ID fissato a quel modello. L'ID corrisponde quando contiene l'ID API Anthropic del modello, come `us.anthropic.claude-opus-4-8` contiene `claude-opus-4-8`, oppure quando una voce di [`modelOverrides`](#override-model-ids-per-version) mappa il modello su di esso. Con un ID fissato che Claude Code non riesce ad abbinare a un modello, le sessioni vengono eseguite per impostazione predefinita con una finestra di 200K, a meno che l'ID non contenga il suffisso `[1m]`.

982 993 

983Per abilitare il [contesto esteso](#extended-context) per un modello fissato, aggiungere `[1m]` all'ID del modello in `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, o `ANTHROPIC_DEFAULT_FABLE_MODEL`:994Per un modello che raggiunge 1M tramite la sua variante `[1m]`, come Opus 4.6 o Sonnet 4.6, abilita il contesto esteso aggiungendo `[1m]` all'ID del modello in `ANTHROPIC_DEFAULT_OPUS_MODEL` o `ANTHROPIC_DEFAULT_SONNET_MODEL`:

984 995 

985```bash theme={null}996```bash theme={null}

986export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'997export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'

987```998```

988 999 

989Con il suffisso `[1m]`, la finestra di contesto 1M si applica a tutto l'utilizzo dell'alias fissato, inclusa la fase Opus in modalità piano di [`opusplan`](#opusplan-model-setting) e [subagents](/docs/it/sub-agents#choose-a-model) il cui frontmatter `model` nomina l'alias.1000Con il suffisso `[1m]`, la finestra di contesto 1M si applica a tutto l'utilizzo dell'alias fissato, inclusa la fase Opus in plan mode di [`opusplan`](#opusplan-model-setting) e i [subagent](/docs/it/sub-agents#choose-a-model) il cui frontmatter `model` nomina l'alias.

990 1001 

991* Claude Code rimuove il suffisso prima di inviare l'ID del modello al provider.1002* Claude Code rimuove il suffisso prima di inviare l'ID del modello al tuo provider.

992* Aggiungere `[1m]` solo quando il modello sottostante [supporta il contesto 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).1003* Aggiungi `[1m]` solo quando il modello sottostante [supporta il contesto 1M](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model).

993* Il suffisso viene letto per variabile, non per modello. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, un ID di modello senza `[1m]` in una variabile utilizza il contesto 200K anche se un'altra variabile imposta lo stesso modello con il suffisso. Sonnet 5 viene sempre eseguito con la finestra 1M su questi provider e non ha mai bisogno del suffisso.1004* Il suffisso viene letto per variabile, non per modello. Su Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry, un ID di Opus 4.6 o Sonnet 4.6 senza `[1m]` in una variabile usa il contesto 200K anche se un'altra variabile imposta lo stesso modello con il suffisso.

994 1005 

995Quando si imposta una variabile `ANTHROPIC_DEFAULT_*_MODEL`, il selettore `/model` mostra una riga per quel modello al posto delle righe incorporate della famiglia, incluse eventuali righe di contesto 1M. Per raggiungere la finestra 1M senza aggiungere il suffisso a quella variabile, i vostri utenti eseguono `/model opus[1m]`, e Claude Code applica il suffisso al modello che la variabile nomina. `/model sonnet[1m]` funziona allo stesso modo.1006Quando imposti una variabile `ANTHROPIC_DEFAULT_*_MODEL`, il selettore `/model` mostra una riga per quel modello al posto delle righe incorporate della famiglia, incluse eventuali righe di contesto 1M. Per raggiungere la finestra 1M senza aggiungere il suffisso a quella variabile, i tuoi utenti eseguono `/model opus[1m]` e Claude Code applica il suffisso al modello indicato dalla variabile. `/model sonnet[1m]` funziona allo stesso modo.

996 1007 

997<Note>1008<Note>

998 Un elenco di autorizzazione `availableModels` fornito tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) si applica comunque quando si utilizzano provider di terze parti; [le impostazioni gestite dal server non vengono fornite lì](/docs/it/server-managed-settings#platform-availability).1009 Un'allowlist `availableModels` fornita tramite [MDM o un file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) si applica comunque quando usi provider di terze parti; [le impostazioni gestite dal server non vengono fornite lì](/docs/it/server-managed-settings#platform-availability).

999 1010 

1000 Il filtraggio corrisponde a un alias di modello come `opus`, a un prefisso di versione come `claude-opus-4-8`, o all'ID di modello completo in forma di provider. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi, quindi per consentire un modello specifico, elencare il suo ID completo in forma di provider, o mapparlo tramite [`modelOverrides`](#override-model-ids-per-version). Per un modello fissato, quell'ID è il valore impostato nella sua variabile `ANTHROPIC_DEFAULT_*_MODEL`. Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'elenco di autorizzazione che dal modello richiesto prima della corrispondenza.1011 Il filtraggio corrisponde a un alias di modello come `opus`, a un prefisso di versione come `claude-opus-4-8` o all'ID di modello completo nella forma del provider. I prefissi specifici del provider come `us.anthropic.` non vengono rimossi, quindi per consentire un modello specifico, elenca il suo ID completo nella forma del provider, oppure mappalo tramite [`modelOverrides`](#override-model-ids-per-version). Per un modello fissato, quell'ID è il valore che imposti nella sua variabile `ANTHROPIC_DEFAULT_*_MODEL`. Qualsiasi suffisso `[1m]` viene rimosso sia dalla voce dell'allowlist sia dal modello richiesto prima della corrispondenza.

1001</Note>1012</Note>

1002 1013 

1003<h3 id="customize-pinned-model-display-and-capabilities">1014<h3 id="customize-pinned-model-display-and-capabilities">

1004 Personalizzare la visualizzazione e le capacità del modello fissato1015 Personalizzare la visualizzazione e le capacità del modello fissato

1005</h3>1016</h3>

1006 1017 

1007Quando si fissa un modello su un provider di terze parti, la sua riga nel selettore `/model` mostra il nome del modello per impostazione predefinita se Claude Code riconosce l'ID fissato, e l'ID grezzo altrimenti:1018Quando fissi un modello su un provider di terze parti, la sua riga nel selettore `/model` mostra per impostazione predefinita il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID grezzo:

1008 1019 

1009* **Riconosciuto**: l'ID esatto di un modello che Claude Code conosce, come il suo ID API Anthropic o la forma del provider o del gateway, con o senza il suffisso `[1m]`. Fissare `us.anthropic.claude-sonnet-4-5-20250929-v1:0` e la riga legge `Sonnet 4.5`.1020* **Riconosciuto**: l'ID esatto di un modello che Claude Code conosce, come il suo ID API Anthropic o la forma usata dal tuo provider o gateway, con o senza il suffisso `[1m]`. Se fissi `us.anthropic.claude-sonnet-4-5-20250929-v1:0`, la riga mostra `Sonnet 4.5`.

1010* **Non riconosciuto**: qualsiasi altro ID, come un ARN di profilo di inferenza dell'applicazione o una versione del modello che Claude Code non conosce, a meno che una voce [`modelOverrides`](#override-model-ids-per-version) non mappi un modello a quella stringa esatta. Su Microsoft Foundry, i nomi di distribuzione sono definiti dall'utente, quindi Claude Code non riconosce mai un ID fissato lì, mappato o meno, e la riga mostra il nome di distribuzione per impostazione predefinita.1021* **Non riconosciuto**: qualsiasi altro ID, come un ARN di un application inference profile o una versione del modello che Claude Code non conosce, a meno che una voce di [`modelOverrides`](#override-model-ids-per-version) non mappi un modello su quella stringa esatta. Su Microsoft Foundry, i nomi dei deploy sono definiti dall'utente, quindi Claude Code non riconosce mai un ID fissato lì, mappato o meno, e la riga mostra per impostazione predefinita il nome del deploy.

1011 1022 

1012Quando una riga mostra il nome del modello, la sua descrizione predefinita include l'ID fissato in modo da poter comunque vedere quale ID è fissato.1023Quando una riga mostra il nome del modello, la sua descrizione predefinita include l'ID fissato, così puoi comunque vedere quale ID è fissato.

1013 1024 

1014Claude Code potrebbe anche non riconoscere quali funzionalità supporta un modello fissato. È possibile impostare il nome di visualizzazione e la descrizione da soli e dichiarare le capacità con variabili di ambiente complementari per ogni modello fissato.1025Claude Code potrebbe anche non riconoscere quali funzionalità supporta un modello fissato. Puoi impostare tu stesso il nome visualizzato e la descrizione, e dichiarare le capacità con variabili d'ambiente complementari per ogni modello fissato.

1015 1026 

1016Queste variabili hanno effetto su provider di terze parti come Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Le variabili `_NAME` e `_DESCRIPTION` hanno effetto anche quando `ANTHROPIC_BASE_URL` punta a un [gateway LLM](/docs/it/llm-gateway). Non hanno effetto quando si effettua la connessione direttamente a `api.anthropic.com`.1027Queste variabili hanno effetto sui provider di terze parti come Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Le variabili `_NAME` e `_DESCRIPTION` hanno effetto anche quando `ANTHROPIC_BASE_URL` punta a un [gateway LLM](/docs/it/llm-gateway). Non hanno alcun effetto quando ti connetti direttamente a `api.anthropic.com`.

1017 1028 

1018| Variabile di ambiente | Descrizione |1029| Variabile d'ambiente | Descrizione |

1019| - | - |1030| - | - |

1020| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome di visualizzazione per il modello Opus fissato nel selettore `/model`. Quando non impostato, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, e l'ID fissato altrimenti |1031| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | Nome visualizzato per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra il nome del modello se Claude Code riconosce l'ID fissato, altrimenti l'ID fissato |

1021| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione di visualizzazione per il modello Opus fissato nel selettore `/model`. Quando non impostato, la riga mostra una descrizione predefinita che inizia con `Custom Opus model` |1032| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | Descrizione visualizzata per il modello Opus fissato nel selettore `/model`. Se non è impostata, la riga mostra una descrizione predefinita che inizia con `Custom Opus model` |

1022| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle capacità che il modello Opus fissato supporta |1033| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | Elenco separato da virgole delle capacità supportate dal modello Opus fissato |

1023 1034 

1024Gli stessi suffissi `_NAME`, `_DESCRIPTION` e `_SUPPORTED_CAPABILITIES` sono disponibili per `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` e `ANTHROPIC_CUSTOM_MODEL_OPTION`.1035Gli stessi suffissi `_NAME`, `_DESCRIPTION` e `_SUPPORTED_CAPABILITIES` sono disponibili per `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, `ANTHROPIC_DEFAULT_FABLE_MODEL` e `ANTHROPIC_CUSTOM_MODEL_OPTION`.

1025 1036 

1026Claude Code abilita funzionalità come [livelli di sforzo](#adjust-effort-level) e [extended thinking](#extended-thinking) abbinando l'ID del modello rispetto a modelli noti. Gli ID specifici del provider come ARN Amazon Bedrock o nomi di distribuzione personalizzati spesso non corrispondono a questi modelli, lasciando le funzionalità supportate disabilitate. Impostare `_SUPPORTED_CAPABILITIES` per dire a Claude Code quali funzionalità il modello effettivamente supporta:1037Claude Code abilita funzionalità come i [livelli di sforzo](#adjust-effort-level) e il [ragionamento esteso](#extended-thinking) confrontando l'ID del modello con schemi noti. Gli ID specifici del provider, come gli ARN di Amazon Bedrock o i nomi di deploy personalizzati, spesso non corrispondono a questi schemi, lasciando disabilitate funzionalità supportate. Imposta `_SUPPORTED_CAPABILITIES` per indicare a Claude Code quali funzionalità il modello supporta effettivamente:

1027 1038 

1028| Valore di capacità | Abilita |1039| Valore di capacità | Abilita |

1029| - | - |1040| - | - |

1030| `effort` | [Livelli di sforzo](#adjust-effort-level) e il comando `/effort` |1041| `effort` | I [livelli di sforzo](#adjust-effort-level) e il comando `/effort` |

1031| `xhigh_effort` | Il livello di sforzo `xhigh` |1042| `xhigh_effort` | Il livello di sforzo `xhigh` |

1032| `max_effort` | Il livello di sforzo `max` |1043| `max_effort` | Il livello di sforzo `max` |

1033| `thinking` | [Extended thinking](#extended-thinking) |1044| `thinking` | Il [ragionamento esteso](#extended-thinking) |

1034| `adaptive_thinking` | Ragionamento adattivo che alloca dinamicamente il pensiero in base alla complessità dell'attività |1045| `adaptive_thinking` | Ragionamento adattivo che alloca dinamicamente il ragionamento in base alla complessità dell'attività |

1035| `interleaved_thinking` | Pensiero tra le chiamate di strumento |1046| `interleaved_thinking` | Ragionamento tra le chiamate agli strumenti |

1036 1047 

1037Quando `_SUPPORTED_CAPABILITIES` è impostato, Claude Code abilita le capacità elencate e disabilita quelle non elencate per il modello fissato corrispondente. Quando la variabile non è impostata, Claude Code ricade sulla rilevazione incorporata basata sull'ID del modello.1048Quando `_SUPPORTED_CAPABILITIES` è impostata, Claude Code abilita le capacità elencate e disabilita quelle non elencate per il modello fissato corrispondente. Quando la variabile non è impostata, Claude Code ripiega sul rilevamento incorporato basato sull'ID del modello.

1038 1049 

1039Questo esempio fissa Opus a un ARN di modello personalizzato Amazon Bedrock, imposta un nome amichevole e dichiara le sue capacità:1050Questo esempio fissa Opus a un ARN di un modello personalizzato di Amazon Bedrock, imposta un nome descrittivo e dichiara le sue capacità:

1040 1051 

1041```bash theme={null}1052```bash theme={null}

1042export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'1053export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'


1046```1057```

1047 1058 

1048<h3 id="override-model-ids-per-version">1059<h3 id="override-model-ids-per-version">

1049 Eseguire l'override degli ID di modello per versione1060 Sovrascrivere gli ID di modello per versione

1050</h3>1061</h3>

1051 1062 

1052Su piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni del modello gestite, mentre un elenco di autorizzazione `availableModels` gestito rimane in vigore a meno che l'host non fornisca il proprio; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) dice quali chiavi e variabili l'host sostituisce.1063Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza sulle impostazioni gestite relative al modello, mentre un'allowlist `availableModels` gestita rimane in vigore a meno che l'host non fornisca la propria; [Eccezioni alla precedenza delle impostazioni gestite](/docs/it/settings#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sovrascrive.

1053 1064 

1054Le variabili di ambiente a livello di famiglia sopra configurano un ID di modello per alias di famiglia. Se è necessario mappare diverse versioni all'interno della stessa famiglia a ID di provider distinti, utilizzare invece l'impostazione `modelOverrides`.1065Le variabili d'ambiente a livello di famiglia descritte sopra configurano un ID di modello per ogni alias di famiglia. Se devi mappare diverse versioni della stessa famiglia su ID di provider distinti, usa invece l'impostazione `modelOverrides`.

1055 1066 

1056`modelOverrides` mappa i singoli ID di modello Anthropic alle stringhe specifiche del provider che Claude Code invia all'API del provider. Quando un utente seleziona un modello mappato nel selettore `/model`, Claude Code utilizza il valore configurato invece del valore predefinito incorporato.1067`modelOverrides` mappa i singoli ID di modello Anthropic sulle stringhe specifiche del provider che Claude Code invia all'API del tuo provider. Quando un utente seleziona un modello mappato nel selettore `/model`, Claude Code usa il valore che hai configurato invece del valore predefinito incorporato.

1057 1068 

1058Questo consente agli amministratori aziendali di instradare ogni versione del modello a un ARN di profilo di inferenza Amazon Bedrock specifico, a un nome di versione Google Cloud's Agent Platform o a un nome di distribuzione Microsoft Foundry per governance, allocazione dei costi o instradamento regionale.1069Questo permette agli amministratori aziendali di instradare ogni versione del modello verso un ARN di inference profile di Amazon Bedrock specifico, un nome di versione di Google Cloud's Agent Platform o un nome di deploy di Microsoft Foundry, per esigenze di governance, allocazione dei costi o instradamento regionale.

1059 1070 

1060Impostare `modelOverrides` nel [file delle impostazioni](/docs/it/settings#where-settings-live):1071Imposta `modelOverrides` nel tuo [file delle impostazioni](/docs/it/settings#where-settings-live):

1061 1072 

1062```json theme={null}1073```json theme={null}

1063{1074{


1069}1080}

1070```1081```

1071 1082 

1072Le chiavi devono essere ID di modello Anthropic come elencati nella [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per gli ID di modello datati, includere il suffisso della data esattamente come appare lì. Le chiavi sconosciute vengono ignorate.1083Le chiavi devono essere ID di modello Anthropic come elencati nella [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Per gli ID di modello con data, includi il suffisso della data esattamente come appare lì. Le chiavi sconosciute vengono ignorate.

1073 1084 

1074Per interrompere la [riga diagnostica](/docs/it/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` per un ID come un alias di gateway, aggiungere una voce con quell'ID come suo valore.1085Per eliminare la [riga diagnostica](/docs/it/errors#unrecognized-model-id-on-a-request) `[claude-code:unrecognized_model]` per un ID come un alias di gateway, aggiungi una voce che abbia quell'ID come valore.

1075 1086 

1076Gli override sostituiscono gli ID di modello incorporati che supportano ogni voce nel selettore `/model`. Su Amazon Bedrock, le voci `modelOverrides` hanno la precedenza su qualsiasi profilo di inferenza che Claude Code scopre automaticamente all'avvio. Claude Code passa i valori che sono già nativi del provider, come ARN di profilo di inferenza Amazon Bedrock o nomi di distribuzione Microsoft Foundry, al provider così come sono.1087Gli override sostituiscono gli ID di modello incorporati alla base di ogni voce del selettore `/model`. Su Amazon Bedrock, le voci di `modelOverrides` hanno la precedenza su qualsiasi inference profile che Claude Code rileva automaticamente all'avvio. Claude Code passa al provider così come sono i valori che sono già nativi del provider, come gli ARN di inference profile di Amazon Bedrock o i nomi di deploy di Microsoft Foundry.

1077 1088 

1078Gli override si applicano anche quando si passa un ID di modello Anthropic direttamente tramite `--model`, la variabile di ambiente `ANTHROPIC_MODEL`, o una variabile di ambiente `ANTHROPIC_DEFAULT_*_MODEL`. Su Amazon Bedrock, Google Cloud's Agent Platform e [Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint), un ID di modello Anthropic senza voce `modelOverrides` si risolve nello stesso ID specifico del provider della riga del selettore `/model` per quella versione, quando il provider supporta quella versione. Mantle supporta un sottoinsieme di versioni. Per un ID di modello Anthropic al di fuori di quel sottoinsieme, Claude Code invia l'ID grezzo a Mantle senza mapparlo, a meno che una voce `modelOverrides` lo copra. Prima della v2.1.200, `--model` e i valori delle variabili di ambiente raggiungevano il provider così come erano senza passare attraverso la mappa di override.1089Gli override si applicano anche quando passi un ID di modello Anthropic direttamente tramite `--model`, la variabile d'ambiente `ANTHROPIC_MODEL` o una variabile d'ambiente `ANTHROPIC_DEFAULT_*_MODEL`. Su Amazon Bedrock, Google Cloud's Agent Platform e [Mantle](/docs/it/amazon-bedrock#use-the-mantle-endpoint), un ID di modello Anthropic senza una voce in `modelOverrides` si risolve nello stesso ID specifico del provider della riga del selettore `/model` per quella versione, quando il provider supporta quella versione. Mantle supporta un sottoinsieme di versioni. Per un ID di modello Anthropic al di fuori di quel sottoinsieme, Claude Code invia a Mantle l'ID grezzo senza mapparlo, a meno che non sia coperto da una voce di `modelOverrides`. Prima della v2.1.200, `--model` e i valori delle variabili d'ambiente raggiungevano il provider così come erano, senza passare per la mappa degli override.

1079 1090 

1080`modelOverrides` funziona insieme a `availableModels`. L'elenco di autorizzazione viene valutato rispetto all'ID di modello Anthropic, non al valore di override, quindi una voce come `"opus"` in `availableModels` continua a corrispondere anche quando le versioni di Opus sono mappate a ARN. Quando `enforceAvailableModels` è impostato nelle impostazioni gestite, il Default applicato si risolve tramite `modelOverrides` dalle [impostazioni gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources) solo. Il mapping di un amministratore, come una versione fissata a un ARN di profilo di inferenza, viene rispettato nel Default applicato. Gli override dalle impostazioni utente o progetto non lo influenzano.1091`modelOverrides` funziona insieme a `availableModels`. L'allowlist viene valutata rispetto all'ID di modello Anthropic, non al valore di override, quindi una voce come `"opus"` in `availableModels` continua a corrispondere anche quando le versioni di Opus sono mappate su ARN. Quando `enforceAvailableModels` è impostata nelle impostazioni gestite, il Default imposto si risolve tramite `modelOverrides` solo dalle [impostazioni gestite](/docs/it/managed-settings#how-claude-code-combines-managed-sources). La mappatura di un amministratore, come una versione fissata su un ARN di inference profile, viene rispettata nel Default imposto. Gli override dalle impostazioni utente o di progetto non lo influenzano.

1081 1092 

1082Quando `availableModels` è impostato nelle [impostazioni gestite](/docs/it/managed-settings), solo `modelOverrides` dalle impostazioni gestite si applicano a un ID di modello Anthropic passato direttamente tramite `--model` o le variabili di ambiente sopra. Claude Code ignora gli override nelle impostazioni utente o progetto per quegli ID, e non risolve mai un ID che l'elenco gestito esclude tramite `modelOverrides` da alcuna fonte di impostazioni. Questa restrizione di fonte gestita richiede Claude Code v2.1.200 o successivo. Vedere [Limitare la selezione del modello](#restrict-model-selection) per come vengono gestiti gli ID bloccati.1093Quando `availableModels` è impostata nelle [impostazioni gestite](/docs/it/managed-settings), a un ID di modello Anthropic passato direttamente tramite `--model` o le variabili d'ambiente descritte sopra si applicano solo i `modelOverrides` delle impostazioni gestite. Claude Code ignora gli override nelle impostazioni utente o di progetto per quegli ID, e non risolve mai tramite `modelOverrides`, da qualsiasi origine di impostazioni, un ID che l'elenco gestito esclude. Questa restrizione all'origine gestita richiede Claude Code v2.1.200 o successiva. Consulta [Limitare la selezione del modello](#restrict-model-selection) per sapere come vengono gestiti gli ID bloccati.

1083 1094 

1084<h3 id="prompt-caching-configuration">1095<h3 id="prompt-caching-configuration">

1085 Configurazione della prompt caching1096 Configurazione del prompt caching

1086</h3>1097</h3>

1087 1098 

1088Claude Code utilizza automaticamente la [prompt caching](/docs/it/prompt-caching) per ottimizzare le prestazioni e ridurre i costi. È possibile disabilitare la prompt caching globalmente o per livelli di modello specifici:1099Claude Code usa automaticamente il [prompt caching](/docs/it/prompt-caching) per ottimizzare le prestazioni e ridurre i costi. Puoi disabilitare il prompt caching globalmente o per livelli di modello specifici:

1089 1100 

1090| Variabile di ambiente | Descrizione |1101| Variabile d'ambiente | Descrizione |

1091| - | - |1102| - | - |

1092| `DISABLE_PROMPT_CACHING` | Impostare su `1` per disabilitare la prompt caching per tutti i modelli. Ha la precedenza sulle impostazioni per modello |1103| `DISABLE_PROMPT_CACHING` | Imposta su `1` per disabilitare il prompt caching per tutti i modelli. Ha la precedenza sulle impostazioni per modello |

1093| `DISABLE_PROMPT_CACHING_HAIKU` | Impostare su `1` per disabilitare la prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching) |1104| `DISABLE_PROMPT_CACHING_HAIKU` | Imposta su `1` per disabilitare il prompt caching per il [modello Haiku predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

1094| `DISABLE_PROMPT_CACHING_SONNET` | Impostare su `1` per disabilitare la prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |1105| `DISABLE_PROMPT_CACHING_SONNET` | Imposta su `1` per disabilitare il prompt caching per il [modello Sonnet predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

1095| `DISABLE_PROMPT_CACHING_OPUS` | Impostare su `1` per disabilitare la prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |1106| `DISABLE_PROMPT_CACHING_OPUS` | Imposta su `1` per disabilitare il prompt caching per il [modello Opus predefinito](/docs/it/prompt-caching#disable-prompt-caching) |

1096| `DISABLE_PROMPT_CACHING_FABLE` | Impostare su `1` per disabilitare la prompt caching solo per i modelli Fable |1107| `DISABLE_PROMPT_CACHING_FABLE` | Imposta su `1` per disabilitare il prompt caching solo per i modelli Fable |

1097 1108 

1098Per scegliere il TTL della cache per la conversazione principale e per i subagents separatamente, vedere [scegliere il TTL da soli](/docs/it/prompt-caching#choose-the-ttl-yourself). Per cosa attiva un cache miss, vedere [Come Claude Code utilizza la prompt caching](/docs/it/prompt-caching).1109Per scegliere separatamente il TTL della cache per la conversazione principale e per i subagent, consulta [scegliere tu il TTL](/docs/it/prompt-caching#choose-the-ttl-yourself). Per sapere cosa provoca un cache miss, consulta [Come Claude Code usa il prompt caching](/docs/it/prompt-caching).

1099 1110 

1100<h2 id="version-history">1111<h2 id="version-history">

1101 Cronologia delle versioni1112 Cronologia delle versioni

Details

551* **Impostazioni gestite dal server**: aggiungetele al blocco `env` delle [impostazioni gestite dal server](/docs/it/server-managed-settings) della vostra organizzazione. Claude Code recupera quelle impostazioni all'avvio ovunque [si applichino le impostazioni gestite dal server](/docs/it/model-config#surface-coverage), il che include i dispositivi dei vostri utenti e le sessioni cloud diverse dalle sessioni del canale Claude Tag. Le sessioni Claude Tag non ricevono le vostre impostazioni gestite dal server, quindi questo percorso non le configura.551* **Impostazioni gestite dal server**: aggiungetele al blocco `env` delle [impostazioni gestite dal server](/docs/it/server-managed-settings) della vostra organizzazione. Claude Code recupera quelle impostazioni all'avvio ovunque [si applichino le impostazioni gestite dal server](/docs/it/model-config#surface-coverage), il che include i dispositivi dei vostri utenti e le sessioni cloud diverse dalle sessioni del canale Claude Tag. Le sessioni Claude Tag non ricevono le vostre impostazioni gestite dal server, quindi questo percorso non le configura.

552* **Le variabili dell'ambiente**: aggiungetele alle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables) di un ambiente cloud per configurare solo le sessioni eseguite in quell'ambiente. Questo è il percorso che raggiunge le sessioni Claude Tag.552* **Le variabili dell'ambiente**: aggiungetele alle [variabili di ambiente](/docs/it/cloud-environments#set-environment-variables) di un ambiente cloud per configurare solo le sessioni eseguite in quell'ambiente. Questo è il percorso che raggiunge le sessioni Claude Tag.

553 553 

554Chiunque utilizzi un ambiente può leggerne le variabili, quindi non inserire lì una credenziale, come un token del collector in `OTEL_EXPORTER_OTLP_HEADERS`. Nemmeno un [segreto di rete](/docs/it/cloud-environments#add-api-credentials) sull'ambiente è utile, perché l'esportazione della telemetria di Claude Code stesso è una delle [richieste che non ricevono mai il segreto](/docs/it/cloud-environments#requests-that-never-get-the-credential). Se il tuo collector richiede una credenziale, configura invece l'intera esportazione tramite le impostazioni gestite dal server, perché quando imposti lì una credenziale, [Claude Code rimuove le variabili di endpoint impostate al di fuori delle impostazioni gestite](#how-managed-settings-lock-the-otlp-destination).554Chiunque utilizzi un ambiente può leggerne le variabili, quindi non inserire lì una credenziale, come un token del collector in `OTEL_EXPORTER_OTLP_HEADERS`. Nemmeno un [segreto di rete](/docs/it/cloud-environments#add-network-secrets) sull'ambiente è utile, perché l'esportazione della telemetria di Claude Code stesso è una delle [richieste che non ricevono mai il segreto](/docs/it/cloud-environments#requests-that-never-get-the-credential). Se il tuo collector richiede una credenziale, configura invece l'intera esportazione tramite le impostazioni gestite dal server, perché quando imposti lì una credenziale, [Claude Code rimuove le variabili di endpoint impostate al di fuori delle impostazioni gestite](#how-managed-settings-lock-the-otlp-destination).

555 555 

556Tenete presenti questi vincoli quando configurate la telemetria per le sessioni cloud:556Tenete presenti questi vincoli quando configurate la telemetria per le sessioni cloud:

557 557 


1314* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)1314* `event.sequence`: contatore per processo per ordinare gli eventi, descritto sotto [Attributi di correlazione degli eventi](#event-correlation-attributes)

1315* `plugin_id`: identificatore del plugin in forma `<name>@<marketplace>`1315* `plugin_id`: identificatore del plugin in forma `<name>@<marketplace>`

1316* `hook_event`: tipo di evento hook che ha emesso le metriche1316* `hook_event`: tipo di evento hook che ha emesso le metriche

1317* Fino a 20 chiavi di metriche emesse dal plugin. I nomi corrispondono a `^[a-z][a-z0-9_]{0,39}$`. I valori sono booleani o numeri.1317* Fino a 20 chiavi di metriche emesse dal plugin. I nomi corrispondono a `^[a-z][a-z0-9_]{0,39}$`. I valori sono booleani o numerici.

1318 1318 

1319<h4 id="compaction-event">1319<h4 id="compaction-event">

1320 Evento di compattazione1320 Evento di compattazione


1382* `appearance_id`: ID univoco che collega gli eventi emessi per un'istanza di sondaggio1382* `appearance_id`: ID univoco che collega gli eventi emessi per un'istanza di sondaggio

1383* `survey_type`: Quale sondaggio ha prodotto l'evento. `"session"` è il prompt di valutazione "Come sta andando Claude?"1383* `survey_type`: Quale sondaggio ha prodotto l'evento. `"session"` è il prompt di valutazione "Come sta andando Claude?"

1384* `response`: La selezione dell'utente su eventi `responded`1384* `response`: La selezione dell'utente su eventi `responded`

1385* `enabled_via_override`: `true` quando [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/it/env-vars) è impostato. Emesso come booleano, non come stringa. Presente su eventi di sondaggio `session`. Filtra su questo attributo per confermare che l'override è applicato in una flotta1385* `enabled_via_override`: `true` quando è impostato [`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`](/docs/it/env-vars). Emesso come Boolean, non come stringa. Presente negli eventi del sondaggio `session`. Filtra su questo attributo per verificare che l'override sia applicato su un'intera flotta

1386 1386 

1387<h4 id="retention-sweep-event">1387<h4 id="retention-sweep-event">

1388 Evento di sweep di conservazione1388 Evento di sweep di conservazione


1473 Ad esempio, le impostazioni gestite con `apiKeyHelper`, due variabili `env`, e una regola di negazione vengono esportate come `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.1473 Ad esempio, le impostazioni gestite con `apiKeyHelper`, due variabili `env`, e una regola di negazione vengono esportate come `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}`.

1474 1474 

1475 Claude Code taglia il valore a 8 KB di UTF-8, e il valore tagliato non è JSON valido1475 Claude Code taglia il valore a 8 KB di UTF-8, e il valore tagliato non è JSON valido

1476* `managed_settings.settings_truncated` (quando `managed_settings.settings` è presente): `true` quando Claude Code ha tagliato `managed_settings.settings` a 8 KB, `false` altrimenti. Emesso come booleano, non come stringa1476* `managed_settings.settings_truncated` (quando `managed_settings.settings` è presente): `true` quando Claude Code ha troncato `managed_settings.settings` a 8 KB, `false` altrimenti. Emesso come Boolean, non come stringa

1477 1477 

1478<h2 id="interpret-metrics-and-events-data">1478<h2 id="interpret-metrics-and-events-data">

1479 Interpretazione dei dati di metriche e eventi1479 Interpretazione dei dati di metriche e eventi

Details

209| :- | :- | :- | :- |209| :- | :- | :- | :- |

210| Scadenza del primo byte | Nessun header di risposta arriva dopo che Claude Code invia la richiesta | API Anthropic diretta e [Claude Platform on AWS](/docs/it/claude-platform-on-aws), incluso attraverso un proxy HTTPS, ma non quando `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` le instradano attraverso un [gateway](/docs/it/gateways). Opt-in su Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; non viene eseguito su Google Cloud's Agent Platform o Microsoft Foundry | 180 secondi sull'API Anthropic diretta, 300 secondi altrove, più un secondo per ogni 32KB del corpo della richiesta |210| Scadenza del primo byte | Nessun header di risposta arriva dopo che Claude Code invia la richiesta | API Anthropic diretta e [Claude Platform on AWS](/docs/it/claude-platform-on-aws), incluso attraverso un proxy HTTPS, ma non quando `ANTHROPIC_BASE_URL` o `ANTHROPIC_AWS_BASE_URL` le instradano attraverso un [gateway](/docs/it/gateways). Opt-in su Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; non viene eseguito su Google Cloud's Agent Platform o Microsoft Foundry | 180 secondi sull'API Anthropic diretta, 300 secondi altrove, più un secondo per ogni 32KB del corpo della richiesta |

211| Watchdog a livello di evento | Nessun evento di risposta viene analizzato. Su connessioni in cui viene eseguito il watchdog a livello di byte, i byte in arrivo, inclusi i ping keep-alive, ripristinano anche questo watchdog, per circa cinque minuti senza un evento analizzato | Ogni provider | 300 secondi |211| Watchdog a livello di evento | Nessun evento di risposta viene analizzato. Su connessioni in cui viene eseguito il watchdog a livello di byte, i byte in arrivo, inclusi i ping keep-alive, ripristinano anche questo watchdog, per circa cinque minuti senza un evento analizzato | Ogni provider | 300 secondi |

212| Watchdog a livello di byte | Nessun byte arriva sul filo, inclusi i ping keep-alive SSE | API Anthropic diretta, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e [gateway](/docs/it/gateways) connessioni, incluso un `ANTHROPIC_BASE_URL` personalizzato. Opt-in su risposte Amazon Bedrock `vnd.amazon.eventstream` con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; non viene eseguito su Google Cloud's Agent Platform o Microsoft Foundry | 180 secondi sull'API Anthropic diretta, 300 secondi altrove |212| Watchdog a livello di byte | Nessun byte arriva sul filo, inclusi i ping keep-alive SSE | API Anthropic diretta, [Claude Platform on AWS](/docs/it/claude-platform-on-aws), e [gateway](/docs/it/gateways) connessioni, incluso un `ANTHROPIC_BASE_URL` personalizzato. Opt-in su risposte Amazon Bedrock `vnd.amazon.eventstream` con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`; non viene eseguito su Google Cloud's Agent Platform o Microsoft Foundry | 180 secondi sull'API Anthropic diretta. Attraverso un `ANTHROPIC_BASE_URL` personalizzato, 180 secondi quando Claude Code ha [recuperato i feature flag](/docs/it/env-vars#features-that-need-feature-flag-fetching) e 300 secondi quando non lo ha fatto. 300 secondi altrove |

213| Timeout di inattività del corpo | Nessun byte arriva per 5 minuti | Provider diversi dall'API Anthropic diretta, Claude Platform on AWS, e Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostato, a meno che [`API_FORCE_IDLE_TIMEOUT`](/docs/it/env-vars) non lo modifichi | 5 minuti |213| Timeout di inattività del corpo | Nessun byte arriva per 5 minuti | Provider diversi dall'API Anthropic diretta, Claude Platform on AWS, e Amazon Bedrock con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` impostato, a meno che [`API_FORCE_IDLE_TIMEOUT`](/docs/it/env-vars) non lo modifichi | 5 minuti |

214 214 

215Se si imposta `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, il watchdog a livello di byte sostituisce il timeout di inattività del corpo su Bedrock piuttosto che essere eseguito insieme ad esso. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` governa quindi anche quanto a lungo uno stream Bedrock può rimanere silenzioso prima che Claude Code consideri la connessione come morta, entro i limiti elencati di seguito. I byte in arrivo ancora non ripristinano il watchdog a livello di evento su Bedrock. Con la registrazione di debug attivata, ogni stream Bedrock registra quindi un messaggio di debug che inizia con `wire-heartbeat: _chunkTimes absent`.215Se si imposta `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`, il watchdog a livello di byte sostituisce il timeout di inattività del corpo su Bedrock piuttosto che essere eseguito insieme ad esso. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` governa quindi anche quanto a lungo uno stream Bedrock può rimanere silenzioso prima che Claude Code consideri la connessione come morta, entro i limiti elencati di seguito. I byte in arrivo ancora non ripristinano il watchdog a livello di evento su Bedrock. Con la registrazione di debug attivata, ogni stream Bedrock registra quindi un messaggio di debug che inizia con `wire-heartbeat: _chunkTimes absent`.

Details

183| :- | :- | :- |183| :- | :- | :- |

184| `name` | No | Nome dello stile di output, mostrato nel picker `/config`. Predefinito: il nome del file |184| `name` | No | Nome dello stile di output, mostrato nel picker `/config`. Predefinito: il nome del file |

185| `description` | No | Descrizione dello stile di output, mostrata nel picker `/config` |185| `description` | No | Descrizione dello stile di output, mostrata nel picker `/config` |

186| `keep-coding-instructions` | No | Impostate su `true` per mantenere le istruzioni integrate di ingegneria del software di Claude Code insieme al vostro stile. Predefinito: `false` |186| `keep-coding-instructions` | No | Imposta su `true` per mantenere la sezione di istruzioni integrate di ingegneria del software di Claude Code, che solo il prompt di sistema completo include, insieme al tuo stile. Consulta [Come funzionano gli stili di output](#how-output-styles-work). Predefinito: `false` |

187| `force-for-plugin` | No | Solo output styles dei plugin. Impostate su `true` per applicare questo stile automaticamente ogni volta che il plugin è abilitato, senza richiedere agli utenti di selezionarlo. Sostituisce l'impostazione `outputStyle` dell'utente. Se più plugin abilitati impostano questo, Claude Code utilizza il primo caricato. Predefinito: `false` |187| `force-for-plugin` | No | Solo output styles dei plugin. Impostate su `true` per applicare questo stile automaticamente ogni volta che il plugin è abilitato, senza richiedere agli utenti di selezionarlo. Sostituisce l'impostazione `outputStyle` dell'utente. Se più plugin abilitati impostano questo, Claude Code utilizza il primo caricato. Predefinito: `false` |

188 188 

189<span id="comparisons-to-related-features" />189<span id="comparisons-to-related-features" />


214Un output style modifica le istruzioni che Claude Code fornisce a Claude.214Un output style modifica le istruzioni che Claude Code fornisce a Claude.

215 215 

216* Claude Code invia le istruzioni dello style attivo con ogni richiesta.216* Claude Code invia le istruzioni dello style attivo con ogni richiesta.

217* Gli output styles personalizzati omettono le istruzioni di ingegneria del software integrate di Claude Code, come il modo di limitare le modifiche, scrivere commenti e verificare il lavoro, a meno che `keep-coding-instructions` non sia impostato su `true`.217* Nel prompt di sistema completo, gli stili di output personalizzati omettono la sezione di Claude Code con le istruzioni di ingegneria del software integrate, come il modo di limitare le modifiche, scrivere commenti e verificare il lavoro, a meno che `keep-coding-instructions` non sia impostato su `true`. Il prompt di sistema più breve non include quella sezione, quindi in quel caso il campo non ha effetto. Per fare affidamento sul campo, imposta [`CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT`](/docs/it/env-vars#variables) su `0`, che seleziona il prompt completo su qualsiasi modello.

218 218 

219Gli output styles si applicano alla conversazione principale e a un [fork](/docs/it/sub-agents#fork-the-current-conversation), che eredita la conversazione completa e il prompt di sistema del genitore. Altri [subagents eseguono il loro prompt di sistema](/docs/it/sub-agents#what-loads-at-startup), quindi gli styles non cambiano il modo in cui rispondono.219Gli stili di output si applicano alla conversazione principale e a un [fork](/docs/it/sub-agents#fork-the-current-conversation), che eredita la conversazione completa e il prompt di sistema del genitore. Gli altri [subagent eseguono il proprio prompt di sistema](/docs/it/sub-agents#what-loads-at-startup), quindi gli stili non cambiano il modo in cui rispondono.

220 220 

221L'utilizzo dei token dipende dallo style. Le istruzioni di uno style aggiungono token di input, anche se il prompt caching riduce questo costo dopo la prima richiesta in una sessione.221L'utilizzo dei token dipende dallo style. Le istruzioni di uno style aggiungono token di input, anche se il prompt caching riduce questo costo dopo la prima richiesta in una sessione.

222 222 

overview.md +1 −1

Details

42 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd42 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

43 ```43 ```

44 44 

45 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).45 Il comando di installazione non mostra alcun avanzamento mentre scarica Claude Code. Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

46 46 

47 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.47 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.

48 48 

permissions.md +1 −1

Details

700Le autorizzazioni e il [sandboxing](/docs/it/sandboxing) sono livelli di sicurezza complementari:700Le autorizzazioni e il [sandboxing](/docs/it/sandboxing) sono livelli di sicurezza complementari:

701 701 

702* **Autorizzazioni** controllano quali strumenti Claude Code può utilizzare e quali file o domini può accedere. Si applicano a Bash, Read, Edit, WebFetch, MCP e ogni altro strumento, tranne per il fatto che una regola deny o ask non può bloccare [`EndConversation`](/docs/it/tools-reference#endconversation-tool-behavior) mentre rimane qualsiasi altro strumento.702* **Autorizzazioni** controllano quali strumenti Claude Code può utilizzare e quali file o domini può accedere. Si applicano a Bash, Read, Edit, WebFetch, MCP e ogni altro strumento, tranne per il fatto che una regola deny o ask non può bloccare [`EndConversation`](/docs/it/tools-reference#endconversation-tool-behavior) mentre rimane qualsiasi altro strumento.

703* **Sandboxing** fornisce l'applicazione a livello del sistema operativo che limita l'accesso al filesystem e alla rete dei comandi Bash, PowerShell e [Monitor](/docs/it/tools-reference#monitor-tool) e dei loro processi figlio.703* **Sandboxing**: fornisce un'applicazione a livello del sistema operativo che limita l'accesso al filesystem e alla rete dei comandi della shell. Si applica ai comandi degli strumenti Bash, PowerShell e [Monitor](/docs/it/tools-reference#monitor-tool) e ai loro processi figlio.

704 704 

705Utilizzate entrambi per la difesa in profondità, poiché le restrizioni sandbox si applicano comunque anche se un'iniezione di prompt bypassa il processo decisionale di Claude. I percorsi e i domini dalle impostazioni sandbox e dalle regole di autorizzazione sono [uniti nella configurazione sandbox finale](/docs/it/sandboxing#permission-rules).705Utilizzate entrambi per la difesa in profondità, poiché le restrizioni sandbox si applicano comunque anche se un'iniezione di prompt bypassa il processo decisionale di Claude. I percorsi e i domini dalle impostazioni sandbox e dalle regole di autorizzazione sono [uniti nella configurazione sandbox finale](/docs/it/sandboxing#permission-rules).

706 706 

plugin-evals.md +26 −5

Details

335* **Sostituzioni**: inserite i campi dalla chiamata dell'input con `{{input.<field>}}`, e il contenuto di un file fixture accanto al mock con `{{file:fixtures/{input.<field>}.json}}`.335* **Sostituzioni**: inserite i campi dalla chiamata dell'input con `{{input.<field>}}`, e il contenuto di un file fixture accanto al mock con `{{file:fixtures/{input.<field>}.json}}`.

336* **`expect:`**: il blocco `expect:` protegge l'input. Se una chiamata lo viola, l'esecuzione si interrompe con punteggio 0 e registra il motivo, in modo che un caso possa asserire cosa il vostro plugin ha chiesto al server di fare.336* **`expect:`**: il blocco `expect:` protegge l'input. Se una chiamata lo viola, l'esecuzione si interrompe con punteggio 0 e registra il motivo, in modo che un caso possa asserire cosa il vostro plugin ha chiesto al server di fare.

337* **`error: true`**: impostate `error: true` per restituire il corpo come errore di tool.337* **`error: true`**: impostate `error: true` per restituire il corpo come errore di tool.

338* **`type: agent`**: imposta `type: agent` per far rispondere il modello giudice come se fosse il server, seguendo le istruzioni nel corpo.338* **`type: agent`**: imposta `type: agent` per far rispondere il modello giudice come se fosse il server, seguendo le istruzioni nel corpo. Le chiamate ai mock agent condividono un unico [budget per esecuzione](#mock-call-budget-exceeded) pari a quattro volte il `max_turns` del caso, e una chiamata che lo supera interrompe l'esecuzione con punteggio 0.

339 339 

340Il [mock file reference](#mock-files) elenca ogni chiave e i file `_server.md` e `_tools.json`.340Il [mock file reference](#mock-files) elenca ogni chiave e i file `_server.md` e `_tools.json`.

341 341 


370| :- | :- |370| :- | :- |

371| La directory root di un plugin, come `.` | Ogni caso sotto la sua directory eval, con quel plugin caricato |371| La directory root di un plugin, come `.` | Ogni caso sotto la sua directory eval, con quel plugin caricato |

372| Un singolo file `prompt.md` o `case.yaml` | Quel caso, con il suo plugin contenitore caricato |372| Un singolo file `prompt.md` o `case.yaml` | Quel caso, con il suo plugin contenitore caricato |

373| Un plugin installato per nome, `name` o `name@marketplace` | I casi nella directory eval della copia installata, con la copia installata caricata. I risultati vengono scritti sotto `./evals/results/` nella tua directory corrente, o `./<dir>/results/` con `--eval-dir` |373| Un plugin installato per nome, `name` o `name@marketplace` | Il plugin e i casi nella sua directory eval, letti [sul posto o dalla copia installata](/docs/it/plugins/loading#in-place-and-copied-plugins). I risultati vengono scritti sotto `./evals/results/` nella tua directory corrente, o `./<dir>/results/` con `--eval-dir` |

374| `name@skills-dir` | Lo stesso, per un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository) |374| `name@skills-dir` | Lo stesso, per un [plugin skills-directory](/docs/it/plugins/loading#plugins-shared-through-a-repository) |

375| Omesso | La directory corrente come percorso |375| Omesso | La directory corrente come percorso |

376 376 


502| `cases[].aggregates.score` | Punteggio medio dell'esecuzione with-arm per il caso |502| `cases[].aggregates.score` | Punteggio medio dell'esecuzione with-arm per il caso |

503| `cases[].aggregates.delta` | Punteggio with-arm meno punteggio without-arm. Omesso quando gli arm non sono comparabili |503| `cases[].aggregates.delta` | Punteggio with-arm meno punteggio without-arm. Omesso quando gli arm non sono comparabili |

504| `cases[].arms.with[].error` | `null`, o perché un'esecuzione è terminata anormalmente, come `timed out after 300s`. Un'esecuzione che è iniziata ma è terminata male è ancora valutata su quello che ha prodotto, quindi un errore non nullo non implica punteggio 0 |504| `cases[].arms.with[].error` | `null`, o perché un'esecuzione è terminata anormalmente, come `timed out after 300s`. Un'esecuzione che è iniziata ma è terminata male è ancora valutata su quello che ha prodotto, quindi un errore non nullo non implica punteggio 0 |

505| `cases[].arms.with[].aborted` | Presente quando un [mock](#mock-mcp-servers) `expect:` o `abort_when` ha fermato l'esecuzione, con `server`, `tool`, e `reason`. L'esecuzione ottiene un punteggio 0 e `error` rimane `null` |505| `cases[].arms.with[].aborted` | Presente quando un [mock](#mock-mcp-servers) ha fermato l'esecuzione tramite `expect:`, `abort_when` o il [budget di chiamate dell'agent-mock](#mock-call-budget-exceeded), con `server`, `tool`, e `reason`. L'esecuzione ottiene un punteggio 0 e `error` rimane `null` |

506| `cases[].arms.with[].skippedPaidGraders` | `true` quando il limite di costo ha saltato i grader judge di questa esecuzione, quindi il suo punteggio non è comparabile |506| `cases[].arms.with[].skippedPaidGraders` | `true` quando il limite di costo ha saltato i grader judge di questa esecuzione, quindi il suo punteggio non è comparabile |

507| `costUsd`, `durationSeconds`, `claudeVersion` | Costo stimato al prezzo di listino incluse le chiamate judge, secondi di parete, e la versione di Claude Code che ha eseguito la suite |507| `costUsd`, `durationSeconds`, `claudeVersion` | Costo stimato al prezzo di listino incluse le chiamate judge, secondi di parete, e la versione di Claude Code che ha eseguito la suite |

508 508 


658| Chiave | Predefinito | Scopo |658| Chiave | Predefinito | Scopo |

659| :- | :- | :- |659| :- | :- | :- |

660| `type` | `fixed` | `fixed` restituisce il corpo come scritto. `agent` tratta il corpo come istruzioni per il [modello judge](#command-options), che fa da server per l'esecuzione e vede le chiamate precedenti come storia |660| `type` | `fixed` | `fixed` restituisce il corpo come scritto. `agent` tratta il corpo come istruzioni per il [modello judge](#command-options), che fa da server per l'esecuzione e vede le chiamate precedenti come storia |

661| `expect` | non impostato | Una mappa da percorsi di input punteggiati a un nome di tipo come `string`, `number`, `boolean`, `array`, o `object`, un `/regex/`, un letterale, o un elenco di letterali consentiti. Una chiamata che lo viola interrompe l'esecuzione con punteggio 0 ed è riportata come `aborted` con il server, lo strumento, e il motivo |661| `expect` | non impostato | Una mappa da percorsi di input punteggiati a un nome di tipo come `string`, `number`, `boolean`, `array`, o `object`, un [`/regex/`](#expect-patterns), un letterale, o un elenco di letterali consentiti. Una chiamata che lo viola interrompe l'esecuzione con punteggio 0 ed è riportata come `aborted` con il server, lo strumento, e il motivo |

662| `error` | `false` | `fixed` solo. Restituisci il corpo come errore dello strumento |662| `error` | `false` | `fixed` solo. Restituisci il corpo come errore dello strumento |

663| `abort_when` | non impostato | `agent` solo. Prosa che elenca le uniche condizioni sotto le quali l'agente può interrompere l'esecuzione |663| `abort_when` | non impostato | `agent` solo. Prosa che elenca le uniche condizioni sotto le quali l'agente può interrompere l'esecuzione |

664 664 

665Due file opzionali si trovano accanto ai file dello strumento nella directory di un server:665Due file opzionali si trovano accanto ai file dello strumento nella directory di un server:

666 666 

667* **`_server.md`**: un singolo mock `type: agent` che risponde a diversi strumenti, elencati nella sua chiave frontmatter `tools:`. Un `<tool>.md` per lo stesso strumento ha precedenza. Metti una guardia `expect:` sul singolo `<tool>.md`, non qui667* **`_server.md`**: un singolo mock `type: agent` che risponde a diversi strumenti, elencati nella sua chiave frontmatter `tools:`. Un `<tool>.md` per lo stesso strumento ha la precedenza. Una guardia `expect:` qui è un errore di caricamento a meno che `tools:` non elenchi un singolo strumento, quindi metti invece la guardia sul singolo `<tool>.md`

668* **`_tools.json`**: una risposta `tools/list` salvata dal vero server, in modo che gli strumenti mockati portino le loro vere descrizioni e schemi di input invece di un placeholder permissivo668* **`_tools.json`**: una risposta `tools/list` salvata dal vero server, in modo che gli strumenti mockati portino le loro vere descrizioni e schemi di input invece di un placeholder permissivo

669 669 

670La directory `mocks/` propria di un caso usa lo stesso layout e sostituisce i file della suite file per file.670La directory `mocks/` propria di un caso usa lo stesso layout e sostituisce i file della suite file per file.

671 671 

672<h4 id="expect-patterns">

673 Pattern regex in expect

674</h4>

675 

676Un valore `/regex/` in `expect:` usa un piccolo dialetto che Claude Code controlla quando carica la suite:

677 

678* Caratteri letterali, `.`, escape come `\d`, e classi di caratteri come `[a-z]`

679* I quantificatori `*`, `+`, `?`, e le forme `{m,n}`, ognuno su un singolo carattere, escape o classe

680* Un `^` opzionale all'inizio e un `$` alla fine

681* Solo i flag `i` e `s`

682 

683Un pattern fuori dal dialetto, come uno con un gruppo, un'alternanza, un backreference, un lookaround o un altro flag, impedisce il caricamento del caso: il caso ottiene punteggio 0 e il suo errore nomina il pattern. Per consentire diversi valori esatti, scrivi un elenco di letterali invece di un'alternanza.

684 

685Ogni pattern controlla i valori solo fino a una lunghezza massima, e un valore più lungo conta come violazione. I quantificatori possono abbassare quella lunghezza, e un `^` iniziale la alza, quindi ancora i pattern con `^` e usa pochi quantificatori.

686 

672<h2 id="troubleshooting">687<h2 id="troubleshooting">

673 Risoluzione dei problemi688 Risoluzione dei problemi

674</h2>689</h2>


777 792 

778Se il tuo account raggiunge il limite di utilizzo del piano o un limite di velocità API mentre una suite è in esecuzione, ogni esecuzione successiva termina con quell'errore, viene valutata su quello che ha prodotto, e di solito ottiene un punteggio 0. La suite finisce comunque e non è contrassegnata `partial`, quindi il risultato può sembrare una regressione. Controlla la colonna `NOTES` o `cases[].arms.with[].error` nel JSON per il messaggio di limite prima di fidarti dei punteggi, poi riesegui dopo che il limite si ripristina, con `--runs 1` o un filtro `--case` se hai bisogno di rimanere sotto di esso.793Se il tuo account raggiunge il limite di utilizzo del piano o un limite di velocità API mentre una suite è in esecuzione, ogni esecuzione successiva termina con quell'errore, viene valutata su quello che ha prodotto, e di solito ottiene un punteggio 0. La suite finisce comunque e non è contrassegnata `partial`, quindi il risultato può sembrare una regressione. Controlla la colonna `NOTES` o `cases[].arms.with[].error` nel JSON per il messaggio di limite prima di fidarti dei punteggi, poi riesegui dopo che il limite si ripristina, con `--runs 1` o un filtro `--case` se hai bisogno di rimanere sotto di esso.

779 794 

795<h3 id="mock-call-budget-exceeded">

796 "mock call budget exceeded"

797</h3>

798 

799Ogni [mock](#mock-mcp-servers) `type: agent` in un'esecuzione attinge a un unico budget di chiamate pari a quattro volte il `max_turns` del caso, ovvero 40 chiamate con il valore predefinito di 10. Contano anche le chiamate a cui si risponde dalle registrazioni in `.replay/`, e la riga di avanzamento `mock budget` del caso stampa il budget. Una chiamata oltre il budget interrompe l'esecuzione con punteggio 0 e questo motivo, quindi aumenta `max_turns` nel caso per una skill che effettua molte chiamate ai mock di agente.

800 

780<h3 id="runs-time-out-or-hit-the-turn-cap">801<h3 id="runs-time-out-or-hit-the-turn-cap">

781 Le esecuzioni scadono o colpiscono il limite di turni802 Le esecuzioni scadono o colpiscono il limite di turni

782</h3>803</h3>

Details

76 plugin install76 plugin install

77</h3>77</h3>

78 78 

79Installa un plugin da un marketplace che hai aggiunto. `i` è un alias per `install`.79Installa un plugin da uno dei tuoi marketplace. `i` è un alias per `install`.

80 80 

81```bash theme={null}81```bash theme={null}

82claude plugin install <plugin> [options]82claude plugin install <plugin> [options]


129 129 

130Un errore di utilizzo, come uno `--scope` non valido, non stampa alcuna riga di risultato ed esce con `1` con il motivo su stderr.130Un errore di utilizzo, come uno `--scope` non valido, non stampa alcuna riga di risultato ed esce con `1` con il motivo su stderr.

131 131 

132<h4 id="json-result-for-marketplace-commands">

133 Risultato JSON per i comandi marketplace

134</h4>

135 

136Su `plugin marketplace add`, `plugin marketplace remove` e `plugin marketplace update`, `--json` stampa un oggetto JSON sull'ultima riga di stdout con i campi `command`, `outcome` e `message`. Quanto segue è il risultato di `claude plugin marketplace remove your-marketplace --json`:

137 

138```json theme={null}

139{"command":"marketplace-remove","outcome":"ok","marketplace":"your-marketplace","message":"Successfully removed marketplace: your-marketplace"}

140```

141 

142Il valore di `command` è `marketplace-add`, `marketplace-remove` o `marketplace-update`. I campi seguenti appaiono solo quando si applicano:

143 

144* `marketplace`: il nome del marketplace su cui il comando ha agito

145* `failureCode`: un codice che indica perché il comando è fallito, come `invalid_source`

146 

147`plugin marketplace add` e `plugin marketplace remove` possono non stampare alcuna riga di risultato quando l'argomento è il [nome riservato](/docs/it/plugins/marketplace-reference#reserved-names) `anthropic-plugin-directory`, quindi controlla il codice di uscita per quel nome.

148 

132<h4 id="accept-a-displayed-install-command">149<h4 id="accept-a-displayed-install-command">

133 Accetta un comando di installazione visualizzato150 Accetta un comando di installazione visualizzato

134</h4>151</h4>


490| `-j, --concurrency <n>` | Sessioni di agente da eseguire contemporaneamente, da 1 a 8. Condividono il tuo rate limit | `1` |507| `-j, --concurrency <n>` | Sessioni di agente da eseguire contemporaneamente, da 1 a 8. Condividono il tuo rate limit | `1` |

491| `--model <model>` | Modello per l'agente in test | Il `model` di ogni caso, altrimenti `ANTHROPIC_MODEL` se impostato, altrimenti il predefinito di Claude Code |508| `--model <model>` | Modello per l'agente in test | Il `model` di ogni caso, altrimenti `ANTHROPIC_MODEL` se impostato, altrimenti il predefinito di Claude Code |

492| `--judge-model <model>` | Modello per i grader `llm` e `baseline` | Il modello per le [attività in background](/docs/it/plugin-evals#grade-the-result) |509| `--judge-model <model>` | Modello per i grader `llm` e `baseline` | Il modello per le [attività in background](/docs/it/plugin-evals#grade-the-result) |

493| `--ablation <mode>` | `none` o `with-without`. Vedi [Confronta con una baseline senza plugin](/docs/it/plugin-evals#compare-against-a-no-plugin-baseline) | Deciso per caso, come quella sezione descrive |510| `--ablation <mode>` | `none` o `with-without`. Vedi [Valuta rispetto alla baseline senza plugin](/docs/it/plugin-evals#compare-against-a-no-plugin-baseline) | Deciso per caso, come quella sezione descrive |

494| `--threshold <0..1>` | Esci con 1 se un caso qualsiasi punteggia sotto questo | `1.0` |511| `--threshold <0..1>` | Esci con 1 se un caso qualsiasi punteggia sotto questo | `1.0` |

495| `--max-cost-usd <usd>` | Ferma prima della prossima esecuzione una volta che la spesa raggiunge questo, esci con 2 e riporta risultati parziali | Nessun limite |512| `--max-cost-usd <usd>` | Ferma prima della prossima esecuzione una volta che la spesa raggiunge questo, esci con 2 e riporta risultati parziali | Nessun limite |

496| `--allow-tools <tools...>` | Concedi strumenti oltre al set di sola lettura, come `Bash`, `Write`, `Edit` o `"mcp__plugin_<plugin>_<server>__*"`. Vedi [Concedi strumenti](/docs/it/plugin-evals#grant-tools) | |513| `--allow-tools <tools...>` | Concedi strumenti oltre al set di sola lettura, come `Bash`, `Write`, `Edit` o `"mcp__plugin_<plugin>_<server>__*"`. Vedi [Concedi strumenti](/docs/it/plugin-evals#grant-tools) | |


672* `target`: il percorso risolto che Claude Code ha convalidato689* `target`: il percorso risolto che Claude Code ha convalidato

673* `manifest`: il risultato del manifest stesso, o `null` per un'esecuzione senza manifest690* `manifest`: il risultato del manifest stesso, o `null` per un'esecuzione senza manifest

674* `contents`: risultati per file, ognuno nominando il suo `file` e portando array `errors`, `warnings` e `notes`691* `contents`: risultati per file, ognuno nominando il suo `file` e portando array `errors`, `warnings` e `notes`

692 * `gatingHooks`: se ogni hook del [mod](/docs/it/plugins/mods/overview) che può rifiutare un'azione, come un hook `tool.call`, ha un [gestore `.catch`](/docs/it/plugins/mods/events#handle-a-hook-that-fails). Ogni elemento fornisce `module`, `pattern`, `hook` e `hasCatch`. Richiede Claude Code v2.1.290 o successivo

675 693 

676All'uscita `2`, il comando non scrive nulla su stdout. Il messaggio di errore va su stderr.694All'uscita `2`, il comando non scrive nulla su stdout. Il messaggio di errore va su stderr.

677 695 


692 710 

693Aggiungi un marketplace da un repository GitHub, un URL git, un `marketplace.json` ospitato o un percorso locale, e dichiaralo in un file di impostazioni.711Aggiungi un marketplace da un repository GitHub, un URL git, un `marketplace.json` ospitato o un percorso locale, e dichiaralo in un file di impostazioni.

694 712 

695Dopo averlo aggiunto, Claude Code installa qualsiasi [dipendenza](/docs/it/plugins/dependencies) che i tuoi plugin installati stavano perdendo.713Dopo averlo aggiunto, Claude Code installa qualsiasi [dipendenza](/docs/it/plugins/dependencies) che mancava ai tuoi plugin installati.

696 714 

697```bash theme={null}715```bash theme={null}

698claude plugin marketplace add <source> [options]716claude plugin marketplace add <source> [options]


703| `--scope <scope>` | File di impostazioni in cui dichiarare il marketplace: `user`, `project` o `local`. Predefinito a `user` |721| `--scope <scope>` | File di impostazioni in cui dichiarare il marketplace: `user`, `project` o `local`. Predefinito a `user` |

704| `--sparse <paths...>` | Limita il checkout git a queste directory, per monorepo. Solo fonti `github` e `git` |722| `--sparse <paths...>` | Limita il checkout git a queste directory, per monorepo. Solo fonti `github` e `git` |

705| `--claudeai` | Leggi l'argomento come il nome di un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai) invece di una fonte. Richiede Claude Code v2.1.273 o successivo |723| `--claudeai` | Leggi l'argomento come il nome di un [marketplace ospitato su claude.ai](/docs/it/plugins/install#add-from-claude-ai) invece di una fonte. Richiede Claude Code v2.1.273 o successivo |

724| `--json` | Stampa se il comando è riuscito, e il relativo messaggio, come un unico oggetto JSON sull'ultima riga di stdout, nel [formato di risultato JSON](#plugin-json-result). Non ha effetto con `--claudeai`. Richiede Claude Code v2.1.287 o successivo |

706 725 

707`<source>` accetta uno qualsiasi dei moduli nella tabella sottostante, e il suo modulo decide il tipo di fonte e come Claude Code recupera il marketplace. Per l'oggetto source risultante, vedi il [riferimento marketplace](/docs/it/plugins/marketplace-reference).726`<source>` accetta uno qualsiasi dei moduli nella tabella sottostante, e il suo modulo decide il tipo di fonte e come Claude Code recupera il marketplace. Per l'oggetto source risultante, vedi il [riferimento marketplace](/docs/it/plugins/marketplace-reference).

708 727 


765| `repo` | `owner/repo`. Solo fonti `github` |784| `repo` | `owner/repo`. Solo fonti `github` |

766| `url` | L'URL di clone o recupero. Solo fonti `git` e `url` |785| `url` | L'URL di clone o recupero. Solo fonti `git` e `url` |

767| `path` | Il percorso locale. Solo fonti `directory` e `file` |786| `path` | Il percorso locale. Solo fonti `directory` e `file` |

768| `ref` | Il ramo o tag fissato. Fonti `github` e `git`, solo quando fissato |787| `ref` | Il branch o tag fissato. Fonti `github` e `git`, solo quando fissato |

769| `installLocation` | Dove Claude Code ha memorizzato nella cache il marketplace |788| `installLocation` | Dove Claude Code ha memorizzato nella cache il marketplace |

770 789 

771Un marketplace [claude.ai](/docs/it/plugins/install#add-from-claude-ai) aggiunto non ha un clone locale, quindi la sua entry porta i suoi identificatori claude.ai, `marketplaceId` e `organizationUuid`, al posto di `installLocation`. Porta anche `scope` quando uno è registrato, e `status`.790Un marketplace [claude.ai](/docs/it/plugins/install#add-from-claude-ai) aggiunto non ha un clone locale, quindi la sua entry porta i suoi identificatori claude.ai, `marketplaceId` e `organizationUuid`, al posto di `installLocation`. Porta anche `scope` quando uno è registrato, e `status`.


797| Flag | Descrizione |816| Flag | Descrizione |

798| :- | :- |817| :- | :- |

799| `--scope <scope>` | Rimuovi la dichiarazione da un ambito di impostazioni: `user`, `project` o `local`. Senza di esso, Claude Code rimuove la dichiarazione da ogni ambito |818| `--scope <scope>` | Rimuovi la dichiarazione da un ambito di impostazioni: `user`, `project` o `local`. Senza di esso, Claude Code rimuove la dichiarazione da ogni ambito |

819| `--json` | Stampa se il comando è riuscito, e il relativo messaggio, come un unico oggetto JSON sull'ultima riga di stdout, nel [formato di risultato JSON](#plugin-json-result). Richiede Claude Code v2.1.287 o successivo |

800 820 

801Rimuovi un marketplace da ogni ambito:821Rimuovi un marketplace da ogni ambito:

802 822 


806 826 

807Claude Code stampa `Successfully removed marketplace: your-marketplace`. Quando il comando disinstalla i plugin, l'output li elenca sotto una riga come `Also uninstalled 2 plugins from this marketplace:`. Per usarne uno di nuovo, aggiungi il marketplace di nuovo e reinstalla il plugin.827Claude Code stampa `Successfully removed marketplace: your-marketplace`. Quando il comando disinstalla i plugin, l'output li elenca sotto una riga come `Also uninstalled 2 plugins from this marketplace:`. Per usarne uno di nuovo, aggiungi il marketplace di nuovo e reinstalla il plugin.

808 828 

809Se scopi a un file di impostazioni che non dichiara il marketplace, il comando fallisce con `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`829Se limiti il comando a un file di impostazioni che non dichiara il marketplace, il comando fallisce con `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.`

810 830 

811<h3 id="plugin-marketplace-update">831<h3 id="plugin-marketplace-update">

812 plugin marketplace update832 plugin marketplace update

813</h3>833</h3>

814 834 

815Aggiorna un marketplace, o ogni marketplace, dalla sua fonte per recuperare nuovi plugin e versioni. Un marketplace aggiunto con un ramo o tag `ref` si aggiorna al commit più recente di quel ref, non al ramo predefinito del repository.835Aggiorna un marketplace, o ogni marketplace, dalla sua fonte per recuperare nuovi plugin e versioni. Un marketplace aggiunto con un branch o tag `ref` si aggiorna al commit più recente di quel ref, non al branch predefinito del repository.

816 836 

817```bash theme={null}837```bash theme={null}

818claude plugin marketplace update [name]838claude plugin marketplace update [name] [options]

819```839```

820 840 

821Il comando non accetta flag oltre a `--help`.841| Flag | Descrizione |

842| :- | :- |

843| `--json` | Stampa se il comando è riuscito, e il relativo messaggio, come un unico oggetto JSON sull'ultima riga di stdout, nel [formato di risultato JSON](#plugin-json-result). Senza un nome, il comando rifiuta `--json` ed esce con `1`. Richiede Claude Code v2.1.287 o successivo |

822 844 

823Aggiorna un marketplace:845Aggiorna un marketplace:

824 846 


826claude plugin marketplace update your-marketplace848claude plugin marketplace update your-marketplace

827```849```

828 850 

829Claude Code stampa `Successfully updated marketplace: your-marketplace`. Quando ometti il nome, stampa un conteggio come `Successfully updated 2 marketplaces`. Senza marketplace aggiunti, stampa `No marketplaces configured` ed esce con `0`.851Claude Code stampa `Successfully updated marketplace: your-marketplace`. Quando ometti il nome, stampa un conteggio come `Successfully updated 2 marketplaces`.

830 852 

831<h2 id="plugin-in-a-session">853<h2 id="plugin-in-a-session">

832 /plugin in una sessione854 /plugin in una sessione

Details

1034]1034]

1035```1035```

1036 1036 

1037Il comando viene eseguito in una shell, nella directory di lavoro in cui la sessione è stata avviata.1037Il comando viene eseguito in una shell, nella directory di lavoro corrente della sessione. Viene eseguito con tutti i tuoi permessi utente e al di fuori della [sandbox](/docs/it/sandboxing).

1038 1038 

1039Il comando di un monitor è limitato in dove inizia e cosa può fare riferimento:1039Il comando di un monitor è limitato in dove inizia e cosa può fare riferimento:

1040 1040 

Details

52* **Nomi che Claude Code utilizza per i plugin che non provengono da un marketplace**: `inline` per i plugin caricati con [`--plugin-dir`](/docs/it/cli-reference), `builtin` per i plugin integrati, `skills-dir` per i plugin caricati automaticamente da [`.claude/skills/`](/docs/it/skills) e `synced` per i plugin sincronizzati dal proprio account claude.ai. Anche `claude-plugin-test` è riservato. `skills-dir` appare anche come `{"source": "skills-dir"}` in `strictKnownMarketplaces` e `blockedMarketplaces`, descritto in [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).52* **Nomi che Claude Code utilizza per i plugin che non provengono da un marketplace**: `inline` per i plugin caricati con [`--plugin-dir`](/docs/it/cli-reference), `builtin` per i plugin integrati, `skills-dir` per i plugin caricati automaticamente da [`.claude/skills/`](/docs/it/skills) e `synced` per i plugin sincronizzati dal proprio account claude.ai. Anche `claude-plugin-test` è riservato. `skills-dir` appare anche come `{"source": "skills-dir"}` in `strictKnownMarketplaces` e `blockedMarketplaces`, descritto in [Source values valid only in policy lists](#source-values-valid-only-in-policy-lists).

53* **`npm`, `pip`, `uv`, `cargo`, `github` e `gh`**: riservati in qualsiasi maiuscola. Questo controllo richiede Claude Code v2.1.275 o successivo.53* **`npm`, `pip`, `uv`, `cargo`, `github` e `gh`**: riservati in qualsiasi maiuscola. Questo controllo richiede Claude Code v2.1.275 o successivo.

54* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.54* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

55* **La cartella di download di un marketplace GitHub registrato, `<owner>-<repo>`**: Claude Code scarica un marketplace aggiunto da una sorgente `github` come `acme/x-tools` tramite una cartella denominata `acme-x-tools`, qualunque sia il `name` di quel marketplace. Finché quel marketplace è registrato con un nome diverso da `acme-x-tools`, `claude plugin marketplace add` rifiuta un marketplace diverso chiamato `acme-x-tools` dopo averlo scaricato e segnala `Can't use the marketplace name "acme-x-tools"`. Questo controllo richiede Claude Code v2.1.290 o successivo.

55 56 

56Quando un marketplace registrato smette di caricarsi perché il suo nome imita uno ufficiale, `claude plugin list` e `/plugin` segnalano `Claude Code refuses the marketplace name "<name>"`. Il messaggio indica di rimuovere il marketplace. La rimozione disinstalla anche i suoi plugin e cancella i loro dati salvati. Questo messaggio di rifiuto denominato richiede Claude Code v2.1.282 o successivo.57Quando un marketplace registrato smette di caricarsi perché il suo nome imita uno ufficiale, `claude plugin list` e `/plugin` segnalano `Claude Code refuses the marketplace name "<name>"`. Il messaggio indica di rimuovere il marketplace. La rimozione disinstalla anche i suoi plugin e cancella i loro dati salvati. Questo messaggio di rifiuto denominato richiede Claude Code v2.1.282 o successivo.

57 58 


498| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Error | `plugins[i].name` |499| `Claude Code cannot install plugin "x". Each part of a plugin id (plugin@marketplace) may use only the letters a-z and A-Z, digits, ".", "_" and "-", and must start with a letter or digit. Change this entry's "name".` | Error | `plugins[i].name` |

499| `Duplicate plugin name "x" found in marketplace` | Error | Due voci condividono un `name` |500| `Duplicate plugin name "x" found in marketplace` | Error | Due voci condividono un `name` |

500| `plugins.i.source: Invalid input` | Error | La `source` della voce non corrisponde a nessun tipo. Vedere [Invalid input on a source](#invalid-input-on-a-source) |501| `plugins.i.source: Invalid input` | Error | La `source` della voce non corrisponde a nessun tipo. Vedere [Invalid input on a source](#invalid-input-on-a-source) |

502| `plugins.i.source: Invalid string: must start with "./"` | Error | Una `source` di percorso relativo senza il `./` iniziale. Prima della v2.1.285, questo errore stampava invece `Invalid input` |

501| `plugins[i].source: Path contains "..": <path>` | Error | Una `source` relativa che sfugge dalla radice del marketplace |503| `plugins[i].source: Path contains "..": <path>` | Error | Una `source` relativa che sfugge dalla radice del marketplace |

502| `source.source: 'unsupported' is a parse-time placeholder and cannot be authored` | Error | `plugins[i].source` |504| `source.source: 'unsupported' is a parse-time placeholder and cannot be authored` | Error | `plugins[i].source` |

503| `Plugin "x" sets headersHelper but is not "strict": false` | Error | `plugins[i].headersHelper`, su una voce `archive` |505| `Plugin "x" sets headersHelper but is not "strict": false` | Error | `plugins[i].headersHelper`, su una voce `archive` |


524 526 

525`Invalid input` su una `source` significa che l'oggetto non ha corrisposto a nessun tipo di sorgente. Controllare queste cause:527`Invalid input` su una `source` significa che l'oggetto non ha corrisposto a nessun tipo di sorgente. Controllare queste cause:

526 528 

527* Un percorso relativo che non inizia con `./`, diverso da `"."` o un [nome bare sotto `metadata.pluginRoot`](#relative-path-plugin-source)

528* Un `package` `npm` contenente `..`529* Un `package` `npm` contenente `..`

529* Un tipo di `source` che non è uno delle [sorgenti di plugin](#plugin-sources)530* Un tipo di `source` che non è uno delle [sorgenti di plugin](#plugin-sources)

530* Un tipo noto con un campo obbligatorio mancante o di tipo errato, come `github` senza `repo`531* Un tipo noto con un campo obbligatorio mancante o di tipo errato, come `github` senza `repo`

531 532 

533Un percorso relativo che non inizia con `./`, diverso da `"."` o da un [nome bare sotto `metadata.pluginRoot`](#relative-path-plugin-source), fallisce con `Invalid string: must start with "./"`. Prima della v2.1.285, stampava `Invalid input` come le cause sopra.

534 

532<h3 id="failures-that-validation-doesn’t-catch">535<h3 id="failures-that-validation-doesn’t-catch">

533 Failures that validation doesn't catch536 Failures that validation doesn't catch

534</h3>537</h3>

Details

25 Impedire il caricamento dei mod installati dagli utenti25 Impedire il caricamento dei mod installati dagli utenti

26</h2>26</h2>

27 27 

28Per impedire il caricamento di tutti i mod portati dai tuoi utenti, imposta l'opzione `allowManagedModsOnly` sulla [protezione integrata](#know-what-happens-by-default), un mod di criteri che Claude Code carica prima di ogni mod installato da un utente. L'opzione va nelle impostazioni gestite sotto `pluginConfigs`, con chiave `cc-plugin-sec-default@builtin`:28Per impedire a tutti i mod portati dai tuoi utenti di eseguire i propri hook, imposta l'opzione `allowManagedModsOnly` sulla [protezione integrata](#know-what-happens-by-default), un mod di criteri che Claude Code carica prima di ogni mod installato da un utente. L'opzione va nelle impostazioni gestite sotto `pluginConfigs`, con chiave `cc-plugin-sec-default@builtin`:

29 29 

30```json managed-settings.json theme={null}30```json managed-settings.json theme={null}

31{31{


41 41 

42Con l'opzione impostata nelle impostazioni gestite:42Con l'opzione impostata nelle impostazioni gestite:

43 43 

44* **Nessun mod portato da un utente viene caricato**: questo include un mod in un plugin installato dall'utente, un mod caricato con `--plugin-dir` e un mod [scritto da Claude durante una sessione](/docs/it/plugins/mods/create#ask-claude-for-a-mod)44* **Nessun mod portato da un utente esegue i propri hook**: questo include un mod in un plugin installato dall'utente, un mod caricato con `--plugin-dir` e un mod [scritto da Claude durante una sessione](/docs/it/plugins/mods/create#ask-claude-for-a-mod)

45* **I mod della tua organizzazione vengono comunque caricati**: un mod che [conta come appartenente alla tua organizzazione](#install-your-organizations-mods) non viene controllato. Ogni altro mod conta come appartenente a un utente e non viene caricato. Questo include un mod in un plugin che abiliti da GitHub o da un altro marketplace remoto, e uno che la tua organizzazione attiva per i propri membri su claude.ai. Se nessuno conta come tuo, nessun mod installato viene caricato.45* **I mod della tua organizzazione vengono comunque eseguiti**: un mod che [conta come appartenente alla tua organizzazione](#install-your-organizations-mods) non viene controllato. Ogni altro mod conta come appartenente a un utente e viene rifiutato. Questo include un mod in un plugin che abiliti da GitHub o da un altro marketplace remoto, e uno che la tua organizzazione attiva per i propri membri su claude.ai. Se nessuno conta come tuo, nessun mod installato esegue i propri hook.

46* **Gli utenti non possono annullarlo**: la protezione integrata legge l'opzione solo dalle impostazioni gestite, quindi la stessa voce in un file di impostazioni utente, di progetto o locale, o in un file passato con `--settings`, non cambia nulla46* **Gli utenti non possono annullarlo**: la protezione integrata legge l'opzione solo dalle impostazioni gestite, quindi la stessa voce in un file di impostazioni utente, di progetto o locale, o in un file passato con `--settings`, non cambia nulla

47* **Un file o un criterio MDM copre ogni provider**: quando distribuisci l'opzione come file o tramite MDM, funziona allo stesso modo su Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry. Per la distribuzione dalla console di amministrazione di claude.ai, consulta [Disponibilità delle piattaforme](/docs/it/server-managed-settings#platform-availability)47* **Un file o un criterio MDM copre ogni provider**: quando distribuisci l'opzione come file o tramite MDM, funziona allo stesso modo su Amazon Bedrock, Agent Platform di Google Cloud e Microsoft Foundry. Per la distribuzione dalla console di amministrazione di claude.ai, consulta [Disponibilità delle piattaforme](/docs/it/server-managed-settings#platform-availability)

48* **Le altre personalizzazioni degli utenti continuano a funzionare**: i loro [hook nei file di impostazioni](/docs/it/hooks), le righe di stato e `/goal` non sono interessati48* **Le altre personalizzazioni degli utenti continuano a funzionare**: i loro [hook nei file di impostazioni](/docs/it/hooks) e nel file `hooks/hooks.json` dei plugin, le righe di stato e `/goal` non sono interessati

49* **I mod integrati continuano a funzionare**: i mod integrati in Claude Code, come il supporto per `AGENTS.md`, hanno ciascuno [il proprio interruttore](/docs/it/plugins/mods/overview#mods-built-into-claude-code)49* **I mod integrati continuano a funzionare**: i mod integrati in Claude Code, come il supporto per `AGENTS.md`, hanno ciascuno [il proprio interruttore](/docs/it/plugins/mods/overview#mods-built-into-claude-code)

50 50 

51Per verificare l'opzione sul computer di un utente, avvia lì Claude Code con `--plugin-dir` e il percorso di una directory che contiene un mod, ad esempio `claude --plugin-dir ./first-mod`. Gli hook del mod non vengono eseguiti, e la trascrizione e il log di debug contengono il [messaggio della protezione integrata](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard), che indica il nome del mod e `allowManagedModsOnly`. Se il mod viene caricato, consulta [Verificare che un criterio sia in vigore](/docs/it/managed-settings#check-that-a-policy-is-in-force) e le [regole che determinano se un'opzione ha effetto](#set-options-on-the-built-in-guard).51Per verificare l'opzione sul computer di un utente, avvia lì Claude Code con `--plugin-dir` e il percorso di una directory che contiene un mod, ad esempio `claude --plugin-dir ./first-mod`. Gli hook del mod non vengono eseguiti, e la trascrizione e il log di debug contengono il [messaggio della protezione integrata](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard), che indica il nome del mod e `allowManagedModsOnly`. Se il messaggio non è presente, consulta [Verificare che un criterio sia in vigore](/docs/it/managed-settings#check-that-a-policy-is-in-force) e le [regole che determinano se un'opzione ha effetto](#set-options-on-the-built-in-guard).

52 52 

53Se durante l'accesso anticipato hai impostato `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` su `0`, sostituiscila con questa opzione. Claude Code v2.1.287 e versioni successive ignorano la variabile con qualsiasi valore, quindi un `0` lascia i mod attivi.53Se durante l'accesso anticipato hai impostato `CLAUDE_CODE_ENABLE_FUNCTION_HOOKS` su `0`, sostituiscila con questa opzione. Claude Code v2.1.287 e versioni successive ignorano la variabile con qualsiasi valore, quindi un `0` lascia i mod attivi.

54 54 


117claude plugin validate ./some-mod117claude plugin validate ./some-mod

118```118```

119 119 

120Due righe dell'output descrivono il codice del mod:120Le righe `hooks:` e `calls:` dell'output descrivono il codice del mod:

121 121 

122```text theme={null}122```text theme={null}

123 ❯ ./register.js hooks: session.start, tool.call, ui.render{component=Pane}123 ❯ ./register.js hooks: session.start, tool.call, ui.render{component=Pane}


150 150 

151| Cosa desideri | Impostazioni |151| Cosa desideri | Impostazioni |

152| :- | :- |152| :- | :- |

153| Nessun mod installato, con gli hook non toccati | Imposta [`allowManagedModsOnly`](#set-options-on-the-built-in-guard) e non distribuire alcun mod tuo |153| Nessun mod installato viene eseguito, con gli hook delle impostazioni non toccati | Imposta [`allowManagedModsOnly`](#set-options-on-the-built-in-guard) e non distribuire alcun mod tuo |

154| Nessun mod installato e nessun hook, inclusi i tuoi hook gestiti | Imposta `disableAllHooks` su `true` |154| Nessun mod installato e nessun hook, inclusi i tuoi hook gestiti | Imposta `disableAllHooks` su `true` |

155| Solo i mod della tua organizzazione | Imposta l'[opzione `allowManagedModsOnly`](#stop-user-installed-mods-from-loading) della protezione, e [installa i tuoi mod](#install-your-organizations-mods) in modo che vengano considerati tuoi |155| Solo i mod della tua organizzazione | Imposta l'[opzione `allowManagedModsOnly`](#stop-user-installed-mods-from-loading) della protezione, e [installa i tuoi mod](#install-your-organizations-mods) in modo che vengano considerati tuoi |

156| Qualsiasi mod dai marketplace che approvi | Mantieni le tue [restrizioni sui marketplace](/docs/it/plugins/org#restrict-what-users-can-install), e imposta `disableSideloadFlags` su `true` |156| Qualsiasi mod dai marketplace che approvi | Mantieni le tue [restrizioni sui marketplace](/docs/it/plugins/org#restrict-what-users-can-install), e imposta `disableSideloadFlags` su `true` |


158 158 

159Cosa fa ciascuna impostazione:159Cosa fa ciascuna impostazione:

160 160 

161* **`allowManagedModsOnly`**: un'opzione della protezione integrata. I mod degli utenti non vengono caricati, mentre i loro hook delle impostazioni, le righe di stato e `/goal` continuano a funzionare. [Impedire il caricamento dei mod installati dagli utenti](#stop-user-installed-mods-from-loading) elenca cosa copre.161* **`allowManagedModsOnly`**: un'opzione della protezione integrata. Claude Code rifiuta i mod degli utenti, quindi nessuno dei loro hook viene eseguito. Gli hook delle impostazioni degli utenti, le righe di stato e `/goal` continuano a funzionare. [Impedire il caricamento dei mod installati dagli utenti](#stop-user-installed-mods-from-loading) elenca cosa copre.

162* **`allowManagedHooksOnly`**: un'impostazione più ampia. Vengono caricati solo [i mod della tua organizzazione](#install-your-organizations-mods) e i mod integrati in Claude Code. Un mod installato da un utente non viene caricato. L'impostazione blocca anche gli hook nei file di impostazioni degli utenti. Leggi [Cosa viene eseguito con `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) prima di impostarla.162* **`allowManagedHooksOnly`**: un'impostazione più ampia. Vengono caricati solo [i mod della tua organizzazione](#install-your-organizations-mods) e i mod integrati in Claude Code. Un mod installato da un utente non viene caricato. L'impostazione blocca anche gli hook nei file di impostazioni degli utenti. Leggi [Cosa viene eseguito con `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) prima di impostarla.

163* **`disableAllHooks`**: l'impostazione più ampia. Nelle impostazioni gestite, blocca i mod in ogni plugin installato, inclusi i tuoi, e disattiva ogni hook nei file di impostazioni, quindi un hook `PreToolUse` nelle tue impostazioni gestite non blocca più nulla. Anche le righe di stato personalizzate e `/goal` smettono di funzionare. Leggi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks) prima di impostarla.163* **`disableAllHooks`**: l'impostazione più ampia. Nelle impostazioni gestite, blocca i mod in ogni plugin installato, inclusi i tuoi, e disattiva ogni hook nei file di impostazioni, quindi un hook `PreToolUse` nelle tue impostazioni gestite non blocca più nulla. Anche le righe di stato personalizzate e `/goal` smettono di funzionare. Leggi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks) prima di impostarla.

164* **`disableSideloadFlags`**: rifiuta `--plugin-dir` e `--plugin-url` all'avvio, e impedisce il caricamento dei mod che Claude scrive durante una sessione. L'impostazione rifiuta anche `--agents` e `--mcp-config`. Leggi [`disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags) prima di impostarla.164* **`disableSideloadFlags`**: rifiuta `--plugin-dir` e `--plugin-url` all'avvio, e impedisce il caricamento dei mod che Claude scrive durante una sessione. L'impostazione rifiuta anche `--agents` e `--mcp-config`. Leggi [`disableSideloadFlags`](/docs/it/settings-reference#disablesideloadflags) prima di impostarla.

165 165 

166I mod integrati in Claude Code, come il supporto per `AGENTS.md`, non sono interessati da queste impostazioni. Ognuno ha [il proprio interruttore](/docs/it/plugins/mods/overview#mods-built-into-claude-code).166I mod integrati in Claude Code, come il supporto per `AGENTS.md`, non sono interessati da queste impostazioni. Ognuno ha [il proprio interruttore](/docs/it/plugins/mods/overview#mods-built-into-claude-code).

167 167 

168Un utente il cui mod non è stato caricato trova il motivo nel proprio log di debug. [Messaggi di rifiuto](/docs/it/plugins/mods/troubleshoot#refusal-messages) elenca le righe per `allowManagedHooksOnly` e `disableAllHooks`, e [Messaggi dalla protezione integrata](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard) riporta la riga per `allowManagedModsOnly`.168Un utente il cui mod è stato rifiutato o non è stato caricato trova il motivo nel proprio log di debug. [Messaggi di rifiuto](/docs/it/plugins/mods/troubleshoot#refusal-messages) elenca le righe per `allowManagedHooksOnly` e `disableAllHooks`, e [Messaggi dalla protezione integrata](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard) riporta la riga per `allowManagedModsOnly`.

169 169 

170<h3 id="allow-only-your-organization’s-mods">170<h3 id="allow-only-your-organization’s-mods">

171 Consentire solo i mod della tua organizzazione171 Consentire solo i mod della tua organizzazione


228 228 

229| Opzione | Non impostata | `true` |229| Opzione | Non impostata | `true` |

230| :- | :- | :- |230| :- | :- | :- |

231| `allowManagedModsOnly` | I mod degli utenti vengono caricati | Vengono caricati solo [i mod della tua organizzazione](#install-your-organizations-mods) e i mod integrati in Claude Code. Claude Code rifiuta ogni altro mod, incluso uno installato da un utente o indicato con `--plugin-dir`. |231| `allowManagedModsOnly` | I mod degli utenti vengono eseguiti | Solo [i mod della tua organizzazione](#install-your-organizations-mods) e i mod integrati in Claude Code eseguono i propri hook. Claude Code rifiuta ogni altro mod, incluso uno installato da un utente o indicato con `--plugin-dir`. |

232| `allowModsToOverrideDenyRules` | Le regole `deny` hanno la precedenza sui mod degli utenti | Un mod di un utente che approva le chiamate agli strumenti può approvare una chiamata che una regola `deny` rifiuta |232| `allowModsToOverrideDenyRules` | Le regole `deny` hanno la precedenza sui mod degli utenti | Un mod di un utente che approva le chiamate agli strumenti può approvare una chiamata che una regola `deny` rifiuta |

233 233 

234Queste regole stabiliscono se un'opzione ha effetto:234Queste regole stabiliscono se un'opzione ha effetto:


285}285}

286```286```

287 287 

288Un plugin che Claude Code copia nella sua cache viene considerato di un utente, anche quando l'impostazione gestita `enabledPlugins` lo abilita. Questo vale per ogni plugin proveniente da una sorgente GitHub, git, URL o npm. Il suo mod viene eseguito tra i mod degli utenti, `prependPlugins` e `appendPlugins` lo ignorano e non viene caricato con `allowManagedModsOnly` o `allowManagedHooksOnly`. Il log di debug dell'utente contiene una riga che inizia con l'id del plugin e `is enabled by managed settings, but`.288Un plugin che Claude Code copia nella sua cache viene considerato di un utente, anche quando l'impostazione gestita `enabledPlugins` lo abilita. Questo vale per ogni plugin proveniente da una sorgente GitHub, git, URL o npm. Il suo mod viene eseguito tra i mod degli utenti, `prependPlugins` e `appendPlugins` lo ignorano, `allowManagedModsOnly` lo rifiuta e `allowManagedHooksOnly` ne impedisce il caricamento. Il log di debug dell'utente contiene una riga che inizia con l'id del plugin e `is enabled by managed settings, but`.

289 289 

290Claude Code genera un evento ogni volta che sta per compiere un'azione, come eseguire uno strumento, e lo passa a ciascun mod a turno. Un mod che viene considerato tuo [viene eseguito prima dei mod degli utenti](/docs/it/plugins/mods/events#the-order-mods-run-in) anche se non lo elenchi da nessuna parte. Per impostarne la posizione, elenca il suo id in una delle due impostazioni. L'id è il nome del plugin, `@` e il nome del marketplace, ad esempio `acme-guard@acme-tools`.290Claude Code genera un evento ogni volta che sta per compiere un'azione, come eseguire uno strumento, e lo passa a ciascun mod a turno. Un mod che viene considerato tuo [viene eseguito prima dei mod degli utenti](/docs/it/plugins/mods/events#the-order-mods-run-in) anche se non lo elenchi da nessuna parte. Per impostarne la posizione, elenca il suo id in una delle due impostazioni. L'id è il nome del plugin, `@` e il nome del marketplace, ad esempio `acme-guard@acme-tools`.

291 291 

Details

71 71 

72Quando chiedi informazioni su un ticket, Claude può chiamare `mcp__my-mod__ticket` con il suo id. Il secondo hook recupera il ticket e restituisce il corpo della risposta, che Claude legge come risultato dello strumento. Quando il server risponde con uno stato di errore, Claude legge `Lookup failed with status` e il numero.72Quando chiedi informazioni su un ticket, Claude può chiamare `mcp__my-mod__ticket` con il suo id. Il secondo hook recupera il ticket e restituisce il corpo della risposta, che Claude legge come risultato dello strumento. Quando il server risponde con uno stato di errore, Claude legge `Lookup failed with status` e il numero.

73 73 

74<Tip>

75 Quando [MCP Tool Search](/docs/it/mcp#scale-with-mcp-tool-search) differisce uno strumento registrato, Claude ne vede il nome ma non la descrizione finché non lo cerca. Se Claude deve considerare lo strumento a ogni turno, aggiungi [`isDeferred: false`](/docs/it/plugins/mods/reference#tools) alla registrazione per [caricare subito lo strumento completo](/docs/it/mcp#exempt-a-server-from-deferral). Il campo richiede Claude Code v2.1.293 o versioni successive, e le versioni precedenti lo ignorano.

76</Tip>

77 

74<h2 id="call-a-model">78<h2 id="call-a-model">

75 Chiamare un modello79 Chiamare un modello

76</h2>80</h2>


208 212 

209Ognuna di queste chiamate è a sua volta un evento, denominato in base al suo namespace e al suo metodo senza il `$.`, come `fs.read` per `$.fs.read`. Un mod [precedente nella catena](/docs/it/plugins/mods/events#the-order-mods-run-in) può osservare, riscrivere o rifiutare la tua chiamata, ed è così che un'organizzazione limita ciò a cui i mod possono accedere.213Ognuna di queste chiamate è a sua volta un evento, denominato in base al suo namespace e al suo metodo senza il `$.`, come `fs.read` per `$.fs.read`. Un mod [precedente nella catena](/docs/it/plugins/mods/events#the-order-mods-run-in) può osservare, riscrivere o rifiutare la tua chiamata, ed è così che un'organizzazione limita ciò a cui i mod possono accedere.

210 214 

215Un mod può rifiutare la tua chiamata `$.process.spawn` dopo che il comando ha prodotto output o è terminato, e nulla di ciò che il comando ha fatto viene annullato. La chiamata viene quindi rifiutata con un messaggio che termina con una di queste stringhe seguita dal motivo indicato dal mod che ha rifiutato:

216 

217* **`$.process.spawn started, and a plugin withheld its result:`**: il mod che ha rifiutato non aveva letto l'output del comando fino alla fine. Claude Code arresta il comando se è ancora in esecuzione.

218* **`$.process.spawn ran, and a plugin withheld its result:`**: il mod che ha rifiutato aveva letto l'output del comando fino alla fine, quindi il comando era già terminato

219 

211<h2 id="next-steps">220<h2 id="next-steps">

212 Passaggi successivi221 Passaggi successivi

213</h2>222</h2>

Details

316✔ Validation passed316✔ Validation passed

317```317```

318 318 

319La riga `hooks:` elenca gli eventi a cui il tuo modulo si aggancia, ciascuno con il suo filtro tra parentesi graffe. La riga `calls:` elenca ogni metodo dell'API dei mod che chiama. Un modulo che legge o imposta variabili d'ambiente ottiene anche le righe `env reads:` e `env writes:`, e uno che usa [`$.state`](/docs/it/plugins/mods/interface#keep-state) ottiene `state reads:` e `state writes:`.319Controlla nella riga `hooks:` gli eventi a cui il tuo modulo si aggancia, ciascuno con il suo filtro tra parentesi graffe, e nella riga `calls:` ogni metodo dell'API dei mod che chiama. Se il tuo modulo legge o imposta variabili d'ambiente, cerca anche le righe `env reads:` e `env writes:`, e `state reads:` e `state writes:` se usa [`$.state`](/docs/it/plugins/mods/interface#keep-state). Vedi inoltre una riga per ogni hook che può rifiutare un'azione, ad esempio `gating hook without .catch: tool.call`, che indica se quell'hook ha un [gestore `.catch`](/docs/it/plugins/mods/events#handle-a-hook-that-fails).

320 320 

321Se un evento che intendevi gestire manca dalla prima riga, nemmeno Claude Code chiamerà quell'hook. La causa più comune è un nome di evento scritto in modo errato, che il comando segnala con un errore come `"tool.calls" is not an event`.321Se un evento che intendevi gestire manca dalla prima riga, nemmeno Claude Code chiamerà quell'hook. La causa più comune è un nome di evento scritto in modo errato, che il comando segnala con un errore come `"tool.calls" is not an event`.

322 322 

Details

245 245 

246Quando invii un prompt come `open a PR for this change`, il tuo messaggio appare invariato nella trascrizione, e Claude legge anche una riga come `Current branch: feature/auth` dopo di esso. Un prompt che non menziona una pull request passa invariato, e `git` non viene eseguito.246Quando invii un prompt come `open a PR for this change`, il tuo messaggio appare invariato nella trascrizione, e Claude legge anche una riga come `Current branch: feature/auth` dopo di esso. Un prompt che non menziona una pull request passa invariato, e `git` non viene eseguito.

247 247 

248Per bloccare un prompt, restituisci `{ drop: 'the reason' }` senza chiamare `next`. Se il tuo hook restituisce un `drop` dopo che la sua chiamata a `next(e)` ha lasciato passare il prompt, il turno viene comunque eseguito e l'hook [non riesce](#handle-a-hook-that-fails) con un messaggio che include `a drop after its next() was answered`.

249 

248[Altri eventi](/docs/it/plugins/mods/reference#prompts-and-what-claude-reads) coprono il resto di ciò che Claude legge: `prompt.section` per ogni sezione del prompt di sistema, `prompt.context` per il contesto inviato con il primo messaggio e `skill.prompt` per il testo di una skill. Il testo di questi hook che cambia tra una richiesta e l'altra [invalida la cache dei prompt](/docs/it/prompt-caching).250[Altri eventi](/docs/it/plugins/mods/reference#prompts-and-what-claude-reads) coprono il resto di ciò che Claude legge: `prompt.section` per ogni sezione del prompt di sistema, `prompt.context` per il contesto inviato con il primo messaggio e `skill.prompt` per il testo di una skill. Il testo di questi hook che cambia tra una richiesta e l'altra [invalida la cache dei prompt](/docs/it/prompt-caching).

249 251 

250<h3 id="follow-a-turn">252<h3 id="follow-a-turn">


341 343 

342Una riga indica il mod, l'evento e il motivo, ad esempio `my-mod: tool.call hook skipped: threw Error: boom`. Dove la leggi dipende dalla sessione, come elencato in [Scoprire perché un mod non fa nulla](/docs/it/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing). Un hook `ui.render` il cui disegno non supera la validazione viene segnalato in modo diverso, come descritto in [Costruire un albero a partire dagli elementi](/docs/it/plugins/mods/interface#build-a-tree-from-elements).344Una riga indica il mod, l'evento e il motivo, ad esempio `my-mod: tool.call hook skipped: threw Error: boom`. Dove la leggi dipende dalla sessione, come elencato in [Scoprire perché un mod non fa nulla](/docs/it/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing). Un hook `ui.render` il cui disegno non supera la validazione viene segnalato in modo diverso, come descritto in [Costruire un albero a partire dagli elementi](/docs/it/plugins/mods/interface#build-a-tree-from-elements).

343 345 

344Per fare in modo che un hook che blocca le chiamate fallisca in modo chiuso, aggiungi un gestore di errori `.catch` che risponda al suo posto. Qui, `guard` è la tua funzione hook:346Per fare in modo che un hook che blocca le chiamate fallisca in modo chiuso, aggiungi un gestore di errori `.catch` che risponda al suo posto. Qui, `guard` è la tua funzione hook, e il gestore verifica [`next.called`](/docs/it/plugins/mods/reference#the-hook-function) per capire se `guard` aveva già chiamato `next` quando è fallito:

345 347 

346```javascript theme={null}348```javascript theme={null}

347// on returns a registration, and .catch attaches a handler to that one hook349// on returns a registration, and .catch attaches a handler to that one hook

348on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {350on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {

349 // next.error.kind is 'throw' or 'timeout', which says how guard failed351 // guard had already called next, so return what came back

352 if (next.called) return next(e)

353 // next.error.kind says why the handler was asked, such as 'throw' or 'timeout'

350 return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }354 return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }

351})355})

352```356```

353 357 

354Finché `guard` funziona, il gestore non viene mai eseguito. Quando `guard` genera un'eccezione o va in timeout su una chiamata Bash, Claude Code chiama il gestore con lo stesso evento. Il gestore restituisce `{ deny }`, quindi il comando non viene eseguito, e Claude legge il testo con `throw` o `timeout` alla fine. Senza il gestore, Claude Code salterebbe `guard` ed eseguirebbe il comando. Il gestore ha un proprio [limite di tempo](/docs/it/plugins/mods/reference#limits) più breve.358Quando `guard` genera un'eccezione o va in timeout su una chiamata Bash, Claude Code chiama il gestore con lo stesso evento:

359 

360* **`guard` è fallito prima di chiamare `next`**: il comando non viene eseguito, e Claude legge il testo di `deny` con il tipo alla fine

361* **`guard` è fallito dopo aver chiamato `next`**: il `next(e)` del gestore si risolve nel risultato prodotto dalla chiamata di `guard` senza eseguire di nuovo il comando, e Claude legge quel risultato

362 

363Il gestore ha un proprio [limite di tempo](/docs/it/plugins/mods/reference#limits) più breve. Se il gestore stesso genera un'eccezione o va in timeout, Claude Code salta l'hook come se non avesse alcun gestore. Se `guard` non aveva chiamato `next`, il comando prosegue quindi come farebbe senza il mod.

364 

365La stessa forma del gestore si adatta a una protezione su `prompt.submit` o `config.set`. Quando `next.called` è false, restituisci il rifiuto che il [riferimento degli eventi](/docs/it/plugins/mods/reference#events) elenca per quell'evento: `{ drop: 'the reason' }` per `prompt.submit`, `{ deny: 'the reason' }` per `config.set`.

366 

367Su `tool.check` e `plugin.register`, un rifiuto restituito dopo che `next` è stato risolto rimane comunque valido, quindi restituiscilo senza verificare `next.called`:

368 

369* **`tool.check`**: restituisci `{ decision: 'deny', reason: 'the reason' }`

370* **`plugin.register`**: restituisci `{ refuse: 'the reason' }`, come mostrato in [Rifiutare i mod quando il tuo controllo fallisce](/docs/it/plugins/mods/admin#refuse-mods-when-your-check-fails)

355 371 

356<h2 id="next-steps">372<h2 id="next-steps">

357 Passaggi successivi373 Passaggi successivi

Details

443 443 

444In una sessione avviata con `--plugin-dir`, una riga della trascrizione lo segnala, ad esempio `ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own`. Il [log di debug](/docs/it/plugins/mods/troubleshoot#read-the-debug-log) lo registra come `ui.render (Pane): a hook returned a tree that does not validate` con lo stesso motivo. Nient'altro compare nella sessione, quindi quando un disegno non viene visualizzato, controlla quella riga o il log.444In una sessione avviata con `--plugin-dir`, una riga della trascrizione lo segnala, ad esempio `ui.render (Pane) refused: Text prop "bogusProp" is not allowed; the engine drew its own`. Il [log di debug](/docs/it/plugins/mods/troubleshoot#read-the-debug-log) lo registra come `ui.render (Pane): a hook returned a tree that does not validate` con lo stesso motivo. Nient'altro compare nella sessione, quindi quando un disegno non viene visualizzato, controlla quella riga o il log.

445 445 

446<h3 id="when-a-client-fails">

447 Quando un `Client` non riesce

448</h3>

449 

450Nel terminale, quando il file eseguito da un `Client` non riesce, una riga attenuata come `my-mod: Client client/spinner.js: boom` prende il posto del `Client`, e il resto del tuo disegno continua a essere visualizzato.

451 

452Se il tuo mod gestisce [`ui.fault`](/docs/it/plugins/mods/reference#interface), Claude Code quindi [disegna di nuovo quel punto](#when-claude-code-redraws-without-being-asked).

453 

446<h3 id="draw-a-grid-of-colored-cells">454<h3 id="draw-a-grid-of-colored-cells">

447 Disegnare una griglia di celle colorate455 Disegnare una griglia di celle colorate

448</h3>456</h3>


806Al codice si applicano queste regole:814Al codice si applicano queste regole:

807 815 

808* **Scrivi `plugin` e `key` come stringhe letterali**: `claude plugin validate` li legge dal tuo codice sorgente816* **Scrivi `plugin` e `key` come stringhe letterali**: `claude plugin validate` li legge dal tuo codice sorgente

817* **Conserva il risultato di ogni chiamata ad `atom` in una `const`**: se dichiari `count` con `let`, la validazione fallisce con `takes a source the scan can read`

809* **Dichiara ogni valore nel file di dichiarazione dei tipi**: altrimenti la validazione fallisce con `hello-tabs.count is not declared`818* **Dichiara ogni valore nel file di dichiarazione dei tipi**: altrimenti la validazione fallisce con `hello-tabs.count is not declared`

810* **Scrivi da una callback o dall'hook di un altro evento**: un hook `ui.render` può leggere lo stato ma non può scriverlo, quindi scrivi da `onPress`, `onSubmit` o da un hook per un altro evento819* **Scrivi da una callback o dall'hook di un altro evento**: un hook `ui.render` può leggere lo stato ma non può scriverlo, quindi scrivi da `onPress`, `onSubmit` o da un hook per un altro evento

811 820 

Details

113I mod sono attivi per impostazione predefinita. Nel terminale, usa Claude Code v2.1.287 o versioni successive. L'app Desktop include una propria copia di Claude Code e i mod funzionano lì a partire dalla v2.1.286. Controlla la versione nel punto in cui usi i mod:113I mod sono attivi per impostazione predefinita. Nel terminale, usa Claude Code v2.1.287 o versioni successive. L'app Desktop include una propria copia di Claude Code e i mod funzionano lì a partire dalla v2.1.286. Controlla la versione nel punto in cui usi i mod:

114 114 

115* **Terminale**: nella tua shell, esegui `claude --version`. Se la tua versione è precedente, [aggiorna Claude Code](/docs/it/setup#update-claude-code).115* **Terminale**: nella tua shell, esegui `claude --version`. Se la tua versione è precedente, [aggiorna Claude Code](/docs/it/setup#update-claude-code).

116* **App Desktop**: in una sessione locale nella scheda Code, inserisci `/status` e leggi la riga **Claude Code**, che mostra una versione come `2.1.286`. Se la tua versione è precedente, aggiorna l'app Desktop.116* **App Desktop**: in una sessione locale nella scheda Code, inserisci `/status` e leggi la riga **Claude Code**, che mostra una versione come `2.1.286`. Se la tua versione è precedente, [aggiorna l'app Desktop](/docs/it/desktop#claude-code-version-in-the-code-tab).

117 117 

118Per disattivare i mod, scegli quanti fermarne e per quanto tempo. Per riattivarli, annulla la stessa modifica:118Per disattivare i mod, scegli quanti fermarne e per quanto tempo. Per riattivarli, annulla la stessa modifica:

119 119 

Details

43| `next.origin` | `{ plugin, tier }` di chi ha generato l'evento. Claude Code stesso è `{ plugin: 'engine', tier: 'core' }`. Il `tier` di un mod è il suo gruppo di priorità nell'[ordine in cui vengono eseguiti i mod](/docs/it/plugins/mods/events#the-order-mods-run-in): `prepend`, `user`, `append` o `builtin`. |43| `next.origin` | `{ plugin, tier }` di chi ha generato l'evento. Claude Code stesso è `{ plugin: 'engine', tier: 'core' }`. Il `tier` di un mod è il suo gruppo di priorità nell'[ordine in cui vengono eseguiti i mod](/docs/it/plugins/mods/events#the-order-mods-run-in): `prepend`, `user`, `append` o `builtin`. |

44| `next.budget` | Il limite di tempo dell'hook in millisecondi: `next.budget.ms` è il limite complessivo e `next.budget.remainingMs` è il tempo rimanente in quel momento |44| `next.budget` | Il limite di tempo dell'hook in millisecondi: `next.budget.ms` è il limite complessivo e `next.budget.remainingMs` è il tempo rimanente in quel momento |

45| `next.to(e, tier)` | Salta a un tier successivo, che può essere `append`, `builtin` o `core`. `next.to(e, 'append')` salta i mod installati da un utente. Solo un mod in `prependPlugins` o `appendPlugins` può chiamarlo. |45| `next.to(e, tier)` | Salta a un tier successivo, che può essere `append`, `builtin` o `core`. `next.to(e, 'append')` salta i mod installati da un utente. Solo un mod in `prependPlugins` o `appendPlugins` può chiamarlo. |

46| `next.error`, `next.called` | Solo in un gestore `.catch`. `next.error.kind` è `throw` o `timeout`, `next.error.message` è il testo dell'errore e `next.called` è `true` quando l'hook non riuscito aveva chiamato `next`. |46| `next.error` | Solo in un gestore `.catch`. `kind` è `throw` o `timeout` quando l'hook non è riuscito, e `message` è il testo dell'errore. `kind` è `re-entry` quando l'hook è stato saltato perché l'evento proveniva dall'interno di una delle sue chiamate all'API dei mod, e `cause` è `lent` se a generare quell'evento è stato un metodo che un altro mod aggiunge all'API dei mod. `re-entry` e `cause` richiedono Claude Code v2.1.292 o versioni successive. |

47| `next.called` | Solo in un gestore `.catch`. `true` quando l'hook aveva chiamato `next`. |

47 48 

48<h2 id="events">49<h2 id="events">

49 Eventi50 Eventi


259| [`Text`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |260| [`Text`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | `color`, `backgroundColor`, `bold`, `italic`, `underline`, `dimColor`, `inverse`, `wrap` | ✓ | ✓ |

260| [`Button`](/docs/it/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |261| [`Button`](/docs/it/plugins/mods/interface#respond-to-presses-and-typing) | `key`, `label`, `onPress`, `hotkey`, `plain`, `dimColor`, `autoFocus`, `action` | ✓ | ✓ |

261| `Link` | `href`, `label` | ✓ | ✓ |262| `Link` | `href`, `label` | ✓ | ✓ |

262| `Code` | Il codice | ✓ | ✓ |263| [`Code`](/docs/it/plugins/mods/gallery#show-code-and-changes) | `source`, `language`, `path`, `startLine`, `format`, `wrap` | ✓ | ✓ |

263| `Markdown` | `text`, `key`, `dimColor`, `onLinkPress`, `pressableLinks` | ✓ | ✓ |264| `Markdown` | `text`, `key`, `dimColor`, `onLinkPress`, `pressableLinks` | ✓ | ✓ |

264| [`Input`](/docs/it/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`, `label`, `placeholder`, `value`, `submitLabel`, `onSubmit`, `onInput`, `autoFocus` | ✓ | ✓ |265| [`Input`](/docs/it/plugins/mods/interface#take-typed-input-and-draw-a-row-for-each-item) | `key`, `label`, `placeholder`, `value`, `submitLabel`, `onSubmit`, `onInput`, `autoFocus` | ✓ | ✓ |

265| `Select` | `key`, `label`, `options`, `value`, `onSelect`, `autoFocus` | ✓ | ✓ |266| `Select` | `key`, `label`, `options`, `value`, `onSelect`, `autoFocus` | ✓ | ✓ |

266| `Svg` | Un documento SVG, fino a 131.072 caratteri | | ✓ |267| `Svg` | Un documento SVG, fino a 131.072 caratteri | | ✓ |

267| [`Client`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ |268| [`Client`](/docs/it/plugins/mods/interface#build-a-tree-from-elements) | `module`, `key` | ✓ | ✓ |

268| [`Raster`](/docs/it/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` fino a 512, `rows` fino a 256, `cells`. Consulta [Disegna una griglia di celle colorate](/docs/it/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | |269| [`Raster`](/docs/it/plugins/mods/interface#draw-a-grid-of-colored-cells) | `key`, `columns` fino a 512, `rows` fino a 256, `cells`. Consulta [Disegna una griglia di celle colorate](/docs/it/plugins/mods/interface#draw-a-grid-of-colored-cells). | ✓ | |

269| `Image` | Byte PNG o RGBA fino a 2 MiB, oppure un percorso di file | ✓ | |270| `Image` | Byte PNG o RGBA fino a 2 MiB, oppure un percorso di file, `columns` e `rows` fino a 255, e testo `alt`. | ✓ | |

270 271 

271Altre regole per `Button`: `action` indica una delle [scorciatoie da tastiera](/docs/it/keybindings) di Claude Code, e la combinazione assegnata dall'utente a quell'azione preme il pulsante quando si tratta di un accordo o di un tasto con modificatore. Un `hotkey` numerico su un pulsante nella banda si attiva anche quando l'utente digita solo quella cifra in un prompt vuoto e si ferma. Quando due pulsanti nello stesso disegno indicano lo stesso `hotkey`, lo ottiene quello successivo. `autoFocus` accetta solo `true` su qualsiasi controllo, quindi ometti la prop per lasciarlo disattivato.272Altre regole per `Button`: `action` indica una delle [scorciatoie da tastiera](/docs/it/keybindings) di Claude Code, e la combinazione assegnata dall'utente a quell'azione preme il pulsante quando si tratta di un accordo o di un tasto con modificatore. Un `hotkey` numerico su un pulsante nella banda si attiva anche quando l'utente digita solo quella cifra in un prompt vuoto e si ferma. Quando due pulsanti nello stesso disegno indicano lo stesso `hotkey`, lo ottiene quello successivo. `autoFocus` accetta solo `true` su qualsiasi controllo, quindi ometti la prop per lasciarlo disattivato.

272 273 


295 Limiti296 Limiti

296</h2>297</h2>

297 298 

298Gli hook e le chiamate all'API dei mod sono soggetti a limiti di tempo e di dimensione. Claude Code salta un hook che supera un limite di tempo e rifiuta una chiamata che supera un limite di dimensione.299Gli hook e le chiamate all'API dei mod sono soggetti a limiti di tempo e di dimensione. Claude Code salta un hook che supera un limite di tempo.

299 300 

300| Limite | Valore |301| Limite | Valore |

301| :- | :- |302| :- | :- |


306| `maxTokens` di `$.model.complete` | 1024 per impostazione predefinita, fino a 64.000 o al limite di output del modello |307| `maxTokens` di `$.model.complete` | 1024 per impostazione predefinita, fino a 64.000 o al limite di output del modello |

307| `$.fs.read` e `$.fs.write` | 4 MiB per un singolo file |308| `$.fs.read` e `$.fs.write` | 4 MiB per un singolo file |

308| Testo in un singolo albero | Vengono disegnati i primi 100.000 caratteri |309| Testo in un singolo albero | Vengono disegnati i primi 100.000 caratteri |

310| Il `language` o il `path` di un `Code`, il `value` di un'opzione `Select` o il `module` di un `Client` | 10.000 caratteri. Se uno è più lungo, Claude Code [disegna la propria versione del sito](/docs/it/plugins/mods/interface#build-a-tree-from-elements). |

309| `$.store` | 4 MiB di JSON in totale |311| `$.store` | 4 MiB di JSON in totale |

310| `$.session.messages()` | Le 4.096 voci più recenti |312| `$.session.messages()` | Le 4.096 voci più recenti |

311| Ridisegni di `$.ui.invalidate('ui.render')` | Limitati a 10 al secondo, o 30 nel terminale per il riquadro visibile, la fascia espansa e la riga di suggerimento sotto il prompt. Le chiamate che arrivano prima vengono accorpate. |313| Ridisegni di `$.ui.invalidate('ui.render')` | Limitati a 10 al secondo, o 30 nel terminale per il riquadro visibile, la fascia espansa e la riga di suggerimento sotto il prompt. Le chiamate che arrivano prima vengono accorpate. |


325| `CLAUDE_CODE_PLUGIN_DIRS` | Ambiente, oppure `env` in `~/.claude/settings.json` | Directory di plugin da caricare come fa `--plugin-dir`, per le app a cui non puoi passare un flag. Percorsi assoluti separati da `:`, oppure da `;` su Windows. |327| `CLAUDE_CODE_PLUGIN_DIRS` | Ambiente, oppure `env` in `~/.claude/settings.json` | Directory di plugin da caricare come fa `--plugin-dir`, per le app a cui non puoi passare un flag. Percorsi assoluti separati da `:`, oppure da `;` su Windows. |

326| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Ambiente | `1` fa sì che una sessione non interattiva di lunga durata ricarichi i mod di `--plugin-dir` al salvataggio |328| `CLAUDE_CODE_PLUGIN_DIR_WATCH` | Ambiente | `1` fa sì che una sessione non interattiva di lunga durata ricarichi i mod di `--plugin-dir` al salvataggio |

327| `prependPlugins`, `appendPlugins` | Impostazioni gestite. Impostazioni utente solo su una macchina senza impostazioni gestite, per un utente che non ha effettuato l'accesso con un piano Team o Enterprise. | Elenchi di id di plugin, come `acme-guard@acme-tools`. I mod in `prependPlugins` vengono eseguiti prima di ogni mod installato da un utente, e i mod in `appendPlugins` vengono eseguiti dopo, nell'ordine elencato. Consulta [L'ordine in cui vengono eseguiti i mod](/docs/it/plugins/mods/events#the-order-mods-run-in). |329| `prependPlugins`, `appendPlugins` | Impostazioni gestite. Impostazioni utente solo su una macchina senza impostazioni gestite, per un utente che non ha effettuato l'accesso con un piano Team o Enterprise. | Elenchi di id di plugin, come `acme-guard@acme-tools`. I mod in `prependPlugins` vengono eseguiti prima di ogni mod installato da un utente, e i mod in `appendPlugins` vengono eseguiti dopo, nell'ordine elencato. Consulta [L'ordine in cui vengono eseguiti i mod](/docs/it/plugins/mods/events#the-order-mods-run-in). |

328| `allowManagedModsOnly` | Impostazioni gestite, come [opzione della protezione integrata](/docs/it/plugins/mods/admin#set-options-on-the-built-in-guard) | Vengono caricati solo i mod che [contano come quelli della tua organizzazione](/docs/it/plugins/mods/admin#install-your-organizations-mods) e i mod integrati in Claude Code. Gli hook delle impostazioni degli utenti continuano a essere eseguiti. |330| `allowManagedModsOnly` | Impostazioni gestite, come [opzione della protezione integrata](/docs/it/plugins/mods/admin#set-options-on-the-built-in-guard) | Solo i mod che [contano come quelli della tua organizzazione](/docs/it/plugins/mods/admin#install-your-organizations-mods) e i mod integrati in Claude Code eseguono i propri hook. Gli hook delle impostazioni degli utenti continuano a essere eseguiti. |

329| `allowModsToOverrideDenyRules` | Impostazioni gestite, come [opzione della protezione integrata](/docs/it/plugins/mods/admin#set-options-on-the-built-in-guard) | Consente a un mod installato da un utente di approvare una chiamata a uno strumento che una regola `deny` rifiuta |331| `allowModsToOverrideDenyRules` | Impostazioni gestite, come [opzione della protezione integrata](/docs/it/plugins/mods/admin#set-options-on-the-built-in-guard) | Consente a un mod installato da un utente di approvare una chiamata a uno strumento che una regola `deny` rifiuta |

330| `allowManagedHooksOnly` | Impostazioni gestite | Blocca gli hook e i mod installati che non appartengono alla tua organizzazione. Consulta [cosa continua a essere eseguito](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly). |332| `allowManagedHooksOnly` | Impostazioni gestite | Blocca gli hook e i mod installati che non appartengono alla tua organizzazione. Consulta [cosa continua a essere eseguito](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly). |

331| `disableAllHooks` | Qualsiasi file di impostazioni | Nelle impostazioni gestite, non viene eseguito alcun mod o hook di un plugin installato. Nelle tue impostazioni, ciò che la tua organizzazione gestisce continua a essere eseguito. Consulta [`disableAllHooks`](/docs/it/settings-reference#disableallhooks). |333| `disableAllHooks` | Qualsiasi file di impostazioni | Nelle impostazioni gestite, non viene eseguito alcun mod o hook di un plugin installato. Nelle tue impostazioni, ciò che la tua organizzazione gestisce continua a essere eseguito. Consulta [`disableAllHooks`](/docs/it/settings-reference#disableallhooks). |

Details

107 107 

108Uno stub per una chiamata della mods API restituisce un oggetto con un campo `value`, che contiene ciò in cui la chiamata si risolve nel tuo mod: `{ value: 7 }` fa sì che `$.store.get` si risolva in `7`. Uno stub per uno degli eventi di Claude Code, come [`turn.step`](/docs/it/plugins/mods/reference#turns) o `tool.call`, restituisce il risultato proprio di quell'evento, come `{ result: 'ok' }`. Anche `$.session.send` e `$.prompt.fill` accettano il risultato del loro evento, come mostra la tabella. [Consultare cosa restituisce uno stub](#look-up-what-a-stub-returns) mostra quale forma assume ciascun nome comune. Questi errori indicano che uno stub è errato o mancante. L'output di un test fallito include un blocco intitolato `the engine reported:`, e ogni errore compare lì:108Uno stub per una chiamata della mods API restituisce un oggetto con un campo `value`, che contiene ciò in cui la chiamata si risolve nel tuo mod: `{ value: 7 }` fa sì che `$.store.get` si risolva in `7`. Uno stub per uno degli eventi di Claude Code, come [`turn.step`](/docs/it/plugins/mods/reference#turns) o `tool.call`, restituisce il risultato proprio di quell'evento, come `{ result: 'ok' }`. Anche `$.session.send` e `$.prompt.fill` accettano il risultato del loro evento, come mostra la tabella. [Consultare cosa restituisce uno stub](#look-up-what-a-stub-returns) mostra quale forma assume ciascun nome comune. Questi errori indicano che uno stub è errato o mancante. L'output di un test fallito include un blocco intitolato `the engine reported:`, e ogni errore compare lì:

109 109 

110* `returned neither { value } nor { deny }`: uno stub per una chiamata della mods API ha restituito un valore semplice110* `returned neither { value } nor { deny }`: uno stub per una chiamata della mods API ha restituito un valore semplice, il che fa fallire il test

111* `no implementation for` seguito da un nome: il tuo mod ha effettuato quella chiamata e nessuno stub risponde111* `no implementation for` seguito da un nome: il tuo mod ha effettuato quella chiamata e nessuno stub risponde

112 112 

113Il kit esporta anche mock in memoria che rispondono per te a un intero namespace. `mock.clock(on)` risponde a [`$.clock`](/docs/it/plugins/mods/api#run-work-in-the-background), `mock.store(on, { count: 7 })` risponde a `$.store` da uno store che inizia con quelle voci, e `mock.env(on, { CI: 'true' })` risponde a `$.env.get` da quelle variabili. `mock.clock` restituisce un orologio mock che il tuo test fa avanzare, così un test di un timer non deve attendere. `mock.store` non restituisce nulla, quindi per verificare cosa ha salvato il tuo mod, scrivi tu stesso i due stub `store` come fa il [test di disegno](#test-a-drawing).113Il kit esporta anche mock in memoria che rispondono per te a un intero namespace. `mock.clock(on)` risponde a [`$.clock`](/docs/it/plugins/mods/api#run-work-in-the-background), `mock.store(on, { count: 7 })` risponde a `$.store` da uno store che inizia con quelle voci, e `mock.env(on, { CI: 'true' })` risponde a `$.env.get` da quelle variabili. `mock.clock` restituisce un orologio mock che il tuo test fa avanzare, così un test di un timer non deve attendere. `mock.store` non restituisce nulla, quindi per verificare cosa ha salvato il tuo mod, scrivi tu stesso i due stub `store` come fa il [test di disegno](#test-a-drawing).


198 198 

199`expect` dispone delle asserzioni `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` e `toThrow`, e di `.not` prima di ciascuna di esse.199`expect` dispone delle asserzioni `toBe`, `toEqual`, `toMatch`, `toMatchObject`, `toContain`, `toBeDefined`, `toBeUndefined` e `toThrow`, e di `.not` prima di ciascuna di esse.

200 200 

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

202 

201<h2 id="test-a-timer">203<h2 id="test-a-timer">

202 Testare un timer204 Testare un timer

203</h2>205</h2>

Details

30| :- | :- |30| :- | :- |

31| `no hooks module to load` | I mod possono essere caricati. Il comando non ha trovato alcun mod da testare in questa directory. |31| `no hooks module to load` | I mod possono essere caricati. Il comando non ha trovato alcun mod da testare in questa directory. |

32| `hooks modules are turned off here` | Un'impostazione sta bloccando i tuoi mod: `disableAllHooks` nelle tue impostazioni oppure la policy della tua organizzazione |32| `hooks modules are turned off here` | Un'impostazione sta bloccando i tuoi mod: `disableAllHooks` nelle tue impostazioni oppure la policy della tua organizzazione |

33| `hooks modules are turned off in this process` | Anthropic ha disattivato da remoto i mod installati. Nessuna impostazione sulla tua macchina li riattiva. |33| `hooks modules are turned off in this process: the rollout switch served off` | Anthropic ha disattivato da remoto i mod installati. |

34| `hooks modules are turned off in this process: the rollout switch was saved off by an earlier session` | Il comando ha usato un valore salvato da una sessione precedente, che potrebbe non essere aggiornato. Avvia `claude` una volta per aggiornarlo, quindi esegui di nuovo il comando. |

34 35 

35Un'organizzazione può anche impostare `allowManagedModsOnly` per consentire solo i propri mod, cosa che questo comando non segnala. In tal caso un mod che installi non viene caricato e [un messaggio ne spiega il motivo](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard).36Un'organizzazione può anche impostare `allowManagedModsOnly` per consentire solo i propri mod, cosa che questo comando non segnala. In tal caso Claude Code rifiuta un mod che installi e [un messaggio ne spiega il motivo](/docs/it/plugins/mods/troubleshoot#messages-from-the-built-in-guard).

36 37 

37<h2 id="the-mod-doesn’t-load">38<h2 id="the-mod-doesn’t-load">

38 Il mod non si carica39 Il mod non si carica


72 73 

73| Il messaggio inizia con | Cosa significa |74| Il messaggio inizia con | Cosa significa |

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

75| `hooks modules are turned off for installed plugins in this process` | Anthropic ha disattivato da remoto i mod installati. Nessuna impostazione sul tuo computer li riattiva. |76| `hooks modules are turned off for installed plugins in this process: the rollout switch served off` | Anthropic ha disattivato da remoto i mod installati. |

77| `hooks modules are turned off for installed plugins in this process: the rollout switch was saved off by an earlier session` | La sessione ha usato un valore salvato da una sessione precedente, che potrebbe non essere aggiornato. Avvia di nuovo Claude Code per aggiornarlo. |

76| `disableAllHooks in managed settings` | La tua organizzazione ha disattivato gli hook dei plugin installati |78| `disableAllHooks in managed settings` | La tua organizzazione ha disattivato gli hook dei plugin installati |

77| `only managed plugins and built-in plugins run` | È impostato `allowManagedHooksOnly`, oppure `disableAllHooks` è impostato in un file di impostazioni diverso dalle impostazioni gestite |79| `only managed plugins and built-in plugins run` | È impostato `allowManagedHooksOnly`, oppure `disableAllHooks` è impostato in un file di impostazioni diverso dalle impostazioni gestite |

78| `installed plugins that are not managed load no hooks module in this mode (--bare)` | Hai avviato Claude Code con `--bare` |80| `installed plugins that are not managed load no hooks module in this mode (--bare)` | Hai avviato Claude Code con `--bare` |


86 88 

87| Il messaggio contiene | Cosa significa | Dove appare |89| Il messaggio contiene | Cosa significa | Dove appare |

88| :- | :- | :- |90| :- | :- | :- |

89| `mods are limited to your organization's by policy (allowManagedModsOnly)` | La tua organizzazione consente solo [i propri mod](/docs/it/plugins/mods/admin#install-your-organizations-mods), quindi il tuo non è stato caricato | Il log di debug e la trascrizione in una [sessione che ricarica a caldo una directory di plugin](#find-out-why-a-mod-does-nothing) |91| `mods are limited to your organization's by policy (allowManagedModsOnly)` | La tua organizzazione consente solo [i propri mod](/docs/it/plugins/mods/admin#install-your-organizations-mods), quindi il tuo è stato rifiutato | Il log di debug e la trascrizione in una [sessione che ricarica a caldo una directory di plugin](#find-out-why-a-mod-does-nothing) |

90| `tried to lift a deny rule in your settings` | L'hook [`tool.check`](/docs/it/plugins/mods/reference#tools) del tuo mod ha approvato una chiamata che una regola `deny` rifiuta. La chiamata resta negata. | La trascrizione e il log di debug, una volta per ogni mod in una sessione. In un'esecuzione di `claude -p`, solo il log di debug. |92| `tried to lift a deny rule in your settings` | L'hook [`tool.check`](/docs/it/plugins/mods/reference#tools) del tuo mod ha approvato una chiamata che una regola `deny` rifiuta. La chiamata resta negata. | La trascrizione e il log di debug, una volta per ogni mod in una sessione. In un'esecuzione di `claude -p`, solo il log di debug. |

91| `the deny rules in your settings could not be checked for this call, so it is refused` | La protezione non è riuscita a completare la verifica di una chiamata approvata da un mod, quindi ha rifiutato la chiamata | Il motivo che Claude legge per la chiamata negata |93| `the deny rules in your settings could not be checked for this call, so it is refused` | La protezione non è riuscita a completare la verifica di una chiamata approvata da un mod, quindi ha rifiutato la chiamata | Il motivo che Claude legge per la chiamata negata |

92 94 


163 165 

164Correggi l'hook.166Correggi l'hook.

165 167 

168<h3 id="its-session-start-ran-again-in-a-fresh-copy">

169 `its session.start ran again in a fresh copy`

170</h3>

171 

172La riga inizia con il nome del mod e indica una chiamata a `$.prompt.submit`, `$.command.run` o `$.agent.spawn`, come in `first-mod: its session.start ran again in a fresh copy; the $.prompt.submit call it had already made was not made again`. Claude Code ha caricato di nuovo il modulo del mod, ad esempio dopo che il worker degli hook si è arrestato in modo anomalo ed è stato sostituito, e l'hook [`session.start`](/docs/it/plugins/mods/reference#session) della nuova copia è stato eseguito. La chiamata indicata dalla riga si è risolta con il risultato della sua prima esecuzione invece di essere eseguita di nuovo, quindi il tuo mod non invia il prompt, non esegue il comando né avvia il subagent due volte. Il resto dell'hook è stato eseguito normalmente.

173 

174Non c'è nulla da correggere.

175 

176Prima della v2.1.292, la chiamata veniva eseguita una seconda volta, quindi il prompt veniva inviato, il comando eseguito o il subagent avviato due volte.

177 

166<h3 id="mods-that-run-in-the-hooks-worker-are-off-for-this-session">178<h3 id="mods-that-run-in-the-hooks-worker-are-off-for-this-session">

167 `mods that run in the hooks worker are off for this session`179 `mods that run in the hooks worker are off for this session`

168</h3>180</h3>


207 219 

208Leggi il motivo su quella riga. Le cause comuni sono una prop che l'elemento non accetta e un elemento che l'app non possiede.220Leggi il motivo su quella riga. Le cause comuni sono una prop che l'elemento non accetta e un elemento che l'app non possiede.

209 221 

222<h3 id="the-module-failed-without-a-message">

223 `the module failed without a message`

224</h3>

225 

226Un [`Client`](/docs/it/plugins/mods/interface#when-a-client-fails) non è riuscito a causa di un errore privo di messaggio, come `throw new Error()`. La riga al suo posto appare come `my-mod: Client client/spinner.js: the module failed without a message`.

227 

228Trova il throw nel codice del tuo `Client` e assegna un messaggio all'errore. La riga mostrerà quindi quel messaggio.

229 

230Prima della v2.1.289, la riga mostrava invece `Error` come motivo.

231 

210<h3 id="$-ui-open-runs-and-no-pane-appears">232<h3 id="$-ui-open-runs-and-no-pane-appears">

211 `$.ui.open` viene eseguito e nessun riquadro appare233 `$.ui.open` viene eseguito e nessun riquadro appare

212</h3>234</h3>


285 307 

286Anche un disegno che non ha superato la validazione conta come risultato rifiutato e ottiene una riga. Per scrivere le tue righe nel log, chiama [`$.ui.log`](/docs/it/plugins/mods/api#show-something-without-starting-a-turn) con un secondo argomento, come in `$.ui.log('message', { to: 'debug' })`. Senza il secondo argomento, `$.ui.log` aggiunge una riga attenuata alla trascrizione.308Anche un disegno che non ha superato la validazione conta come risultato rifiutato e ottiene una riga. Per scrivere le tue righe nel log, chiama [`$.ui.log`](/docs/it/plugins/mods/api#show-something-without-starting-a-turn) con un secondo argomento, come in `$.ui.log('message', { to: 'debug' })`. Senza il secondo argomento, `$.ui.log` aggiunge una riga attenuata alla trascrizione.

287 309 

288Mentre modifichi un mod caricato con `--plugin-dir`, la trascrizione mostra una riga per ogni ricaricamento che nomina il mod ed elenca i suoi hook. Se un salvataggio rompe il modulo, la riga riporta `reload failed, the previous version stays loaded:` con il motivo, e l'ultima versione funzionante continua a essere eseguita.310Mentre modifichi un mod caricato con `--plugin-dir`, la trascrizione mostra una riga per ogni ricaricamento che nomina il mod ed elenca i suoi hook. Se un salvataggio rompe il modulo, la riga riporta `reload failed, the previous version stays loaded:` con il motivo, e l'ultima versione funzionante continua a essere eseguita finché Claude Code non ricarica di nuovo i plugin, ad esempio quando esegui `/reload-plugins`.

289 311 

290<h2 id="next-steps">312<h2 id="next-steps">

291 Passaggi successivi313 Passaggi successivi

plugins/org.md +1 −1

Details

212| `pluginTrustMessage` | Aggiunge il vostro testo all'avviso di fiducia che `/plugin` mostra prima che un plugin si installi | Non cambia il testo dell'avviso stesso |212| `pluginTrustMessage` | Aggiunge il vostro testo all'avviso di fiducia che `/plugin` mostra prima che un plugin si installi | Non cambia il testo dell'avviso stesso |

213| `allowedChannelPlugins` | Sostituisce l'elenco predefinito di plugin autorizzati a inviare messaggi di canale. Richiede `channelsEnabled: true` | Vedere [Limitare quali plugin di canale possono essere eseguiti](/docs/it/channels#restrict-which-channel-plugins-can-run) |213| `allowedChannelPlugins` | Sostituisce l'elenco predefinito di plugin autorizzati a inviare messaggi di canale. Richiede `channelsEnabled: true` | Vedere [Limitare quali plugin di canale possono essere eseguiti](/docs/it/channels#restrict-which-channel-plugins-can-run) |

214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/it/env-vars) | Interrompe le sessioni di terminale interattive dal registrare automaticamente il marketplace ufficiale | Non rimuove un marketplace già registrato. L'elenco consentito e l'elenco bloccato controllano la stessa registrazione automatica senza di esso. Una macchina che ha iniziato una volta con esso impostato non riprende la registrazione automatica dopo averlo disimpostato |214| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/it/env-vars) | Interrompe le sessioni di terminale interattive dal registrare automaticamente il marketplace ufficiale | Non rimuove un marketplace già registrato. L'elenco consentito e l'elenco bloccato controllano la stessa registrazione automatica senza di esso. Una macchina che ha iniziato una volta con esso impostato non riprende la registrazione automatica dopo averlo disimpostato |

215| [`allowManagedModsOnly`](/docs/it/plugins/mods/admin#stop-user-installed-mods-from-loading) | Interrompe ogni [mod](/docs/it/plugins/mods/overview) installato che non [conta come della vostra organizzazione](/docs/it/plugins/mods/admin#install-your-organizations-mods) dal caricamento | Non interrompe un plugin che contiene un mod dall'installazione. Per questo, usate le chiavi di marketplace in questa tabella |215| [`allowManagedModsOnly`](/docs/it/plugins/mods/admin#stop-user-installed-mods-from-loading) | Impedisce a ogni [mod](/docs/it/plugins/mods/overview) installato che non [conta come della tua organizzazione](/docs/it/plugins/mods/admin#install-your-organizations-mods) di eseguire i propri hook | Non impedisce l'installazione di un plugin che contiene un mod. Per questo, usa le chiavi di marketplace in questa tabella |

216 216 

217Ogni chiave nella tabella è un'impostazione gestita, a parte `enabledPlugins`, `syncClaudeAiPlugins`, `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` e `allowManagedModsOnly`:217Ogni chiave nella tabella è un'impostazione gestita, a parte `enabledPlugins`, `syncClaudeAiPlugins`, `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` e `allowManagedModsOnly`:

218 218 

Details

29Un plugin può contenere contenuti che eseguono codice sulla tua macchina con i tuoi privilegi utente e contenuti che entrano nel contesto di Claude come istruzioni, quindi [esamina un plugin prima di installarlo](#review-a-plugin-before-you-install). Ecco cosa può fare un plugin installato:29Un plugin può contenere contenuti che eseguono codice sulla tua macchina con i tuoi privilegi utente e contenuti che entrano nel contesto di Claude come istruzioni, quindi [esamina un plugin prima di installarlo](#review-a-plugin-before-you-install). Ecco cosa può fare un plugin installato:

30 30 

31* **Hooks**: gli [hooks](/docs/it/hooks) di un plugin vengono eseguiti come comandi shell in punti del ciclo di vita di Claude Code, come prima o dopo una chiamata a uno strumento.31* **Hooks**: gli [hooks](/docs/it/hooks) di un plugin vengono eseguiti come comandi shell in punti del ciclo di vita di Claude Code, come prima o dopo una chiamata a uno strumento.

32* **Monitor**: i [monitor](/docs/it/plugins/components#monitors) di un plugin vengono eseguiti come comandi shell in background che Claude Code avvia da solo quando la sessione inizia, quando ricarichi i plugin o la prima volta che viene eseguita una skill designata.

32* **Mods**: un [mod](/docs/it/plugins/mods/overview) di un plugin esegue JavaScript all'interno di Claude Code con le tue autorizzazioni. Per elencare cosa fa un mod prima di installarlo, vedi [Decide whether to trust a mod](/docs/it/plugins/mods/overview#decide-whether-to-trust-a-mod).33* **Mods**: un [mod](/docs/it/plugins/mods/overview) di un plugin esegue JavaScript all'interno di Claude Code con le tue autorizzazioni. Per elencare cosa fa un mod prima di installarlo, vedi [Decide whether to trust a mod](/docs/it/plugins/mods/overview#decide-whether-to-trust-a-mod).

33* **Server MCP e LSP**: Claude Code si connette ai [server MCP](/docs/it/mcp) che un plugin abilitato dichiara e fornisce a Claude i loro strumenti. Un server MCP stdio viene eseguito come un processo che Claude Code avvia sulla tua macchina. Claude Code avvia anche i language server che il plugin dichiara.34* **Server MCP e LSP**: Claude Code si connette ai [server MCP](/docs/it/mcp) che un plugin abilitato dichiara e fornisce a Claude i loro strumenti. Un server MCP stdio viene eseguito come un processo che Claude Code avvia sulla tua macchina. Claude Code avvia anche i language server che il plugin dichiara.

34* **Directory `bin/`**: Claude Code aggiunge la directory `bin/` di ogni plugin abilitato al `PATH` della shell dello strumento Bash, quindi i comandi Bash di Claude possono eseguire qualsiasi eseguibile lì.35* **Directory `bin/`**: Claude Code aggiunge la directory `bin/` di ogni plugin abilitato al `PATH` della shell dello strumento Bash, quindi i comandi Bash di Claude possono eseguire qualsiasi eseguibile lì.


37 38 

38Le [regole di autorizzazione](/docs/it/permissions) e la [sandbox](/docs/it/sandboxing) di Claude Code coprono le chiamate agli strumenti che Claude fa, non il codice che un plugin esegue da solo:39Le [regole di autorizzazione](/docs/it/permissions) e la [sandbox](/docs/it/sandboxing) di Claude Code coprono le chiamate agli strumenti che Claude fa, non il codice che un plugin esegue da solo:

39 40 

40* **Hook e processi server**: gli hook dei comandi eseguono comandi shell con i tuoi permessi utente completi. Claude Code esegue hook, server MCP e i processi che un [mod](/docs/it/plugins/mods/overview#what-a-mod-can-reach) avvia al di fuori della sandbox.41* **Hook, monitor e processi server**: gli hook di comando e i monitor sono comandi shell che vengono eseguiti con i tuoi permessi utente completi. Claude Code esegue hook, monitor, server MCP, server LSP e i processi che un [mod](/docs/it/plugins/mods/overview#what-a-mod-can-reach) avvia al di fuori della sandbox.

41* **Chiamate agli strumenti di Claude**: una chiamata a uno degli strumenti MCP del plugin e un comando Bash che esegue un eseguibile dalla `bin/` del plugin sono chiamate agli strumenti, quindi le tue regole di autorizzazione si applicano a loro. Per cosa può fare un mod a una chiamata a uno strumento, vedi [Decide whether to trust a mod](/docs/it/plugins/mods/overview#decide-whether-to-trust-a-mod).42* **Chiamate agli strumenti di Claude**: una chiamata a uno degli strumenti MCP del plugin e un comando Bash che esegue un eseguibile dalla `bin/` del plugin sono chiamate agli strumenti, quindi le tue regole di autorizzazione si applicano a loro. Per cosa può fare un mod a una chiamata a uno strumento, vedi [Decide whether to trust a mod](/docs/it/plugins/mods/overview#decide-whether-to-trust-a-mod).

42 43 

43L'installazione di un plugin lo abilita anche, a meno che il suo manifest o la voce del marketplace non imposti [`defaultEnabled: false`](/docs/it/plugins/install#choose-an-install-scope) e tu non l'abbia abilitato tu stesso.44L'installazione di un plugin lo abilita anche, a meno che il suo manifest o la voce del marketplace non imposti [`defaultEnabled: false`](/docs/it/plugins/install#choose-an-install-scope) e tu non l'abbia abilitato tu stesso.

Details

96 96 

97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante il plan mode e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione del plan mode è un cambio di modello e avvia una cache nuova.97L'[impostazione del modello `opusplan`](/docs/it/model-config#opusplan-model-setting) si risolve in Opus durante il plan mode e Sonnet durante l'esecuzione, quindi ogni attivazione/disattivazione del plan mode è un cambio di modello e avvia una cache nuova.

98 98 

99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza segnala una richiesta in una categoria che ha un modello di fallback, Claude Code riesegue la richiesta su quel modello e la sessione continua lì.99[Il fallback automatico del modello](/docs/it/model-config#automatic-model-fallback) sui modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 è anche un cambio di modello. Quando un classificatore di sicurezza segnala una richiesta in una categoria che ha un modello di fallback e Claude Code riesegue la richiesta su quel modello, la sessione continua lì.

100 100 

101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.101Quando il frontmatter di una skill o di un comando nomina un [`model`](/docs/it/skills#frontmatter-reference) diverso dal modello corrente della sessione, quel turno è anche un cambio di modello: la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Il modello della sessione riprende al tuo prossimo prompt. Una skill `context: fork` imposta il [modello del subagent con fork](/docs/it/skills#run-skills-in-a-subagent) invece.

102 102 

quickstart.md +16 −14

Details

53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd53 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

54 ```54 ```

55 55 

56 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).56 Il comando di installazione non mostra alcun avanzamento mentre scarica Claude Code. Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

57 57 

58 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.58 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.

59 59 


229 Passaggio 7: Prova altri workflow comuni229 Passaggio 7: Prova altri workflow comuni

230</h2>230</h2>

231 231 

232Ci sono diversi modi per lavorare con Claude:232Prova qualche altro prompt. Puoi chiedere a Claude di fare il refactoring del codice, scrivere test, aggiornare la documentazione o revisionare le tue modifiche:

233 

234**Refactoring del codice**

235 233 

236```text wrap theme={null}234```text wrap theme={null}

237refactor the authentication module to use async/await instead of callbacks235refactor the authentication module to use async/await instead of callbacks

238```236```

239 237 

240**Scrivere test**

241 

242```text wrap theme={null}238```text wrap theme={null}

243write unit tests for the calculator functions239write unit tests for the calculator functions

244```240```

245 241 

246**Aggiornare la documentazione**

247 

248```text wrap theme={null}242```text wrap theme={null}

249update the README with installation instructions243update the README with installation instructions

250```244```

251 245 

252**Code review**

253 

254```text wrap theme={null}246```text wrap theme={null}

255review my changes and suggest improvements247review my changes and suggest improvements

256```248```


263 Comandi essenziali255 Comandi essenziali

264</h2>256</h2>

265 257 

266Ecco i comandi più importanti per l'uso quotidiano. I comandi shell vengono eseguiti dal vostro terminale per avviare o riprendere Claude Code. I comandi di sessione vengono eseguiti all'interno di Claude Code dopo l'avvio.258Ecco i comandi più importanti per l'uso quotidiano, raggruppati in base a dove li esegui.

267 259 

268**Comandi shell**260<h3 id="shell-commands">

261 Comandi shell

262</h3>

263 

264Eseguili dal tuo terminale per avviare o riprendere Claude Code.

269 265 

270| Comando | Cosa fa | Esempio |266| Comando | Cosa fa | Esempio |

271| - | - | - |267| - | - | - |


275| `claude -c` | Continua la conversazione più recente nella directory corrente | `claude -c` |271| `claude -c` | Continua la conversazione più recente nella directory corrente | `claude -c` |

276| `claude -r` | Riprendi una conversazione precedente | `claude -r` |272| `claude -r` | Riprendi una conversazione precedente | `claude -r` |

277 273 

278**Comandi di sessione**274Consulta il [riferimento CLI](/docs/it/cli-reference) per l'elenco completo dei comandi shell.

275 

276<h3 id="session-commands">

277 Comandi di sessione

278</h3>

279 

280Eseguili all'interno di Claude Code dopo l'avvio.

279 281 

280| Comando | Cosa fa | Esempio |282| Comando | Cosa fa | Esempio |

281| - | - | - |283| - | - | - |


283| `/help` | Mostra i comandi disponibili | `/help` |285| `/help` | Mostra i comandi disponibili | `/help` |

284| `/exit` o Ctrl+D due volte | Esci da Claude Code | `/exit` |286| `/exit` o Ctrl+D due volte | Esci da Claude Code | `/exit` |

285 287 

286Vedi il [riferimento CLI](/docs/it/cli-reference) per l'elenco completo dei comandi shell e il [riferimento comandi](/docs/it/commands) per l'elenco completo dei comandi di sessione.288Consulta il [riferimento comandi](/docs/it/commands) per l'elenco completo dei comandi di sessione.

287 289 

288<h2 id="pro-tips-for-beginners">290<h2 id="pro-tips-for-beginners">

289 Suggerimenti professionali per i principianti291 Suggerimenti professionali per i principianti

Details

201* **`false`**: disattiva la connessione automatica, anche se un `true` dalle [impostazioni gestite](/docs/it/managed-settings) lo supera, perché Claude Code salva la scelta nelle tue impostazioni utente. Un `false` nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`) disattiva la connessione automatica anche su un `true` gestito.201* **`false`**: disattiva la connessione automatica, anche se un `true` dalle [impostazioni gestite](/docs/it/managed-settings) lo supera, perché Claude Code salva la scelta nelle tue impostazioni utente. Un `false` nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`) disattiva la connessione automatica anche su un `true` gestito.

202* **`default`**: cancella la tua scelta e segui il valore predefinito dell'amministratore della tua organizzazione se ne è stato impostato uno, altrimenti il valore predefinito attuale di Claude Code.202* **`default`**: cancella la tua scelta e segui il valore predefinito dell'amministratore della tua organizzazione se ne è stato impostato uno, altrimenti il valore predefinito attuale di Claude Code.

203 203 

204Lo stesso interruttore appare al di fuori della CLI:204Anche l'estensione VS Code e l'app Desktop hanno un interruttore per la connessione automatica:

205 205 

206* **App Desktop**: **Settings > Claude Code > Connect new sessions to Remote Control**.

207* **Estensione VS Code**: **Enable Remote Control for all sessions** nella sezione Settings del [menu dei comandi](/docs/it/vs-code#use-the-prompt-box).206* **Estensione VS Code**: **Enable Remote Control for all sessions** nella sezione Settings del [menu dei comandi](/docs/it/vs-code#use-the-prompt-box).

207* **App Desktop**: **Settings > Claude Code > Connect new sessions to Remote Control**. Consulta [Controllare quali sessioni appaiono sugli altri dispositivi](/docs/it/desktop#control-which-sessions-appear-on-your-other-devices).

208 208 

209Per attivare la connessione automatica da un file di impostazioni, imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) su `true` nel tuo file `~/.claude/settings.json` utente o nelle [impostazioni gestite](/docs/it/managed-settings). Nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code onora un `false` e disattiva la connessione automatica per quel repository, ma ignora un `true`, quindi un file archiviato non può attivare Remote Control per tutti coloro che aprono il repository.209Per attivare la connessione automatica da un file di impostazioni, imposta [`remoteControlAtStartup`](/docs/it/settings-reference#remotecontrolatstartup) su `true` nel tuo file `~/.claude/settings.json` utente o nelle [impostazioni gestite](/docs/it/managed-settings). Nelle impostazioni di progetto o locali (`.claude/settings.json`, `.claude/settings.local.json`), Claude Code onora un `false` e disattiva la connessione automatica per quel repository, ma ignora un `true`, quindi un file archiviato non può attivare Remote Control per tutti coloro che aprono il repository.

210 210 

routines.md +1 −1

Details

93 Scegli un [cloud environment](/docs/it/cloud-environments) per la routine. Gli ambienti controllano a cosa ha accesso la sessione cloud:93 Scegli un [cloud environment](/docs/it/cloud-environments) per la routine. Gli ambienti controllano a cosa ha accesso la sessione cloud:

94 94 

95 * **Network access**: imposta il livello di accesso a Internet disponibile durante ogni esecuzione95 * **Network access**: imposta il livello di accesso a Internet disponibile durante ogni esecuzione

96 * **Environment variables**: fornisci valori che Claude può utilizzare durante ogni esecuzione. Sono [visibili a chiunque utilizzi l'ambiente](/docs/it/cloud-environments#what-carries-over-from-your-setup), quindi nei piani Pro e Max archivia invece le chiavi per le API che Claude chiama durante un'esecuzione come [segreti di rete](/docs/it/cloud-environments#add-api-credentials). Quella sezione elenca anche le richieste che non ricevono mai un segreto96 * **Environment variables**: fornisci valori che Claude può utilizzare durante ogni esecuzione. Sono [visibili a chiunque utilizzi l'ambiente](/docs/it/cloud-environments#what-carries-over-from-your-setup), quindi nei piani Pro e Max archivia invece le chiavi per le API che Claude chiama durante un'esecuzione come [segreti di rete](/docs/it/cloud-environments#add-network-secrets). Quella sezione elenca anche le richieste che non ricevono mai un segreto

97 * **Setup script**: installa le dipendenze e gli strumenti di cui la routine ha bisogno. Il risultato è [cached](/docs/it/cloud-environments#environment-caching), quindi lo script non viene rieseguito su ogni sessione97 * **Setup script**: installa le dipendenze e gli strumenti di cui la routine ha bisogno. Il risultato è [cached](/docs/it/cloud-environments#environment-caching), quindi lo script non viene rieseguito su ogni sessione

98 98 

99 Un ambiente **Default** è fornito con accesso di rete **Trusted**, che consente solo l'[elenco predefinito](/docs/it/cloud-environments#default-allowed-domains) di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni attraverso la rete della sessione. I connector che aggiungi alla routine raggiungono i loro servizi attraverso i server di Anthropic, quindi non hanno bisogno di modifiche all'elenco consentito. Se la tua routine ha bisogno di raggiungere i tuoi servizi direttamente o un dominio al di fuori di tale elenco, modifica l'[accesso di rete](/docs/it/cloud-environments#network-access) dell'ambiente prima di eseguire. Per utilizzare un ambiente separato, [creane uno](/docs/it/cloud-environments#configure-your-environment) prima.99 Un ambiente **Default** è fornito con accesso di rete **Trusted**, che consente solo l'[elenco predefinito](/docs/it/cloud-environments#default-allowed-domains) di registri di pacchetti, API di provider cloud, registri di container e domini di sviluppo comuni attraverso la rete della sessione. I connector che aggiungi alla routine raggiungono i loro servizi attraverso i server di Anthropic, quindi non hanno bisogno di modifiche all'elenco consentito. Se la tua routine ha bisogno di raggiungere i tuoi servizi direttamente o un dominio al di fuori di tale elenco, modifica l'[accesso di rete](/docs/it/cloud-environments#network-access) dell'ambiente prima di eseguire. Per utilizzare un ambiente separato, [creane uno](/docs/it/cloud-environments#configure-your-environment) prima.

Details

22 22 

23| Approccio | Cosa è isolato | Richiede Docker | Sforzo di setup |23| Approccio | Cosa è isolato | Richiede Docker | Sforzo di setup |

24| :- | :- | :- | :- |24| :- | :- | :- | :- |

25| [Sandboxed Bash tool](#sandboxed-bash-tool) | Comandi Bash, PowerShell e Monitor e i loro processi figli | No | Minimo su macOS; basso su Linux e WSL2 |25| [Strumento Bash in sandbox](#sandboxed-bash-tool) | Comandi degli strumenti Bash, PowerShell e Monitor e i loro processi figli | No | Minimo su macOS; basso su Linux e WSL2 |

26| [Sandbox runtime](#sandbox-runtime) | L'intero processo Claude Code, inclusi i file tools, i server MCP e gli hooks | No | Basso |26| [Sandbox runtime](#sandbox-runtime) | L'intero processo Claude Code, inclusi i file tools, i server MCP e gli hooks | No | Basso |

27| [Dev container](#dev-containers) | Ambiente di sviluppo completo | Sì | Medio |27| [Dev container](#dev-containers) | Ambiente di sviluppo completo | Sì | Medio |

28| [Custom container](#custom-container) | Ambiente di sviluppo completo | Sì | Medio-alto |28| [Custom container](#custom-container) | Ambiente di sviluppo completo | Sì | Medio-alto |


76 Questa opzione non supporta Windows nativo. Su host Windows, utilizzare WSL2 o uno degli approcci con container o VM di seguito.76 Questa opzione non supporta Windows nativo. Su host Windows, utilizzare WSL2 o uno degli approcci con container o VM di seguito.

77</Note>77</Note>

78 78 

79Lo strumento Bash in sandbox è integrato in Claude Code. Utilizza primitive del sistema operativo per limitare l'accesso al filesystem e alla rete di ogni comando Bash, PowerShell o Monitor che Claude esegue.79Lo strumento Bash in sandbox è integrato in Claude Code. Utilizza primitive del sistema operativo per limitare l'accesso al filesystem e alla rete dei comandi degli strumenti Bash, PowerShell e Monitor che Claude esegue.

80 80 

81Eseguire il comando `/sandbox` per aprire il pannello sandbox e scegliere una modalità. La guida [Sandboxing](/docs/it/sandboxing) copre le modalità di approvazione, il limite predefinito e come ampliarlo o restringerlo.81Eseguire il comando `/sandbox` per aprire il pannello sandbox e scegliere una modalità. La guida [Sandboxing](/docs/it/sandboxing) copre le modalità di approvazione, il limite predefinito e come ampliarlo o restringerlo.

82 82 

83La sandbox per comando non copre tutto ciò che viene eseguito in una sessione:83La sandbox per comando non copre tutto ciò che viene eseguito in una sessione:

84 84 

85* Altri [strumenti integrati](/docs/it/tools-reference) come Read, Edit e WebFetch vengono eseguiti all'interno del processo Claude Code e non generano codice arbitrario. Le [regole di autorizzazione](/docs/it/permissions) per il percorso o il dominio li controllano invece.85* Altri [strumenti integrati](/docs/it/tools-reference) come Read, Edit e WebFetch vengono eseguiti all'interno del processo Claude Code e non generano codice arbitrario. Le [regole di autorizzazione](/docs/it/permissions) per il percorso o il dominio li controllano invece.

86* I server [MCP](/docs/it/mcp) e gli [hook di comando](/docs/it/hooks#command-hook-fields) sono processi separati che vengono eseguiti senza vincoli sull'host.86* I server [MCP](/docs/it/mcp), gli [hook di comando](/docs/it/hooks#command-hook-fields) e i [monitor dei plugin](/docs/it/plugins/components#monitors) sono processi separati che vengono eseguiti senza vincoli sull'host. Per altri processi che vengono eseguiti in questo modo, consulta [Cosa viene eseguito al di fuori della sandbox](/docs/it/sandboxing#what-runs-outside-the-sandbox).

87 87 

88Per mettere gli strumenti integrati, i server MCP e gli hook tutti dietro un unico limite del sistema operativo, eseguire l'intero processo Claude Code all'interno del [runtime sandbox](#sandbox-runtime), del [dev container](#dev-containers) o di un [container personalizzato](#custom-container).88Per mettere gli strumenti integrati, i server MCP e gli hook tutti dietro un unico limite del sistema operativo, eseguire l'intero processo Claude Code all'interno del [runtime sandbox](#sandbox-runtime), del [dev container](#dev-containers) o di un [container personalizzato](#custom-container).

89 89 

sandboxing.md +1 −1

Details

698Le regole di autorizzazione e il sandboxing controllano cose diverse:698Le regole di autorizzazione e il sandboxing controllano cose diverse:

699 699 

700* **Le regole di autorizzazione** controllano quali strumenti Claude Code può utilizzare e vengono valutate prima che qualsiasi strumento venga eseguito. Si applicano a ogni strumento: Bash, Read, Edit, WebFetch, MCP e altri, tranne per il fatto che una regola di negazione o richiesta non può bloccare [`EndConversation`](/docs/it/tools-reference#endconversation-tool-behavior) mentre rimane qualsiasi altro strumento.700* **Le regole di autorizzazione** controllano quali strumenti Claude Code può utilizzare e vengono valutate prima che qualsiasi strumento venga eseguito. Si applicano a ogni strumento: Bash, Read, Edit, WebFetch, MCP e altri, tranne per il fatto che una regola di negazione o richiesta non può bloccare [`EndConversation`](/docs/it/tools-reference#endconversation-tool-behavior) mentre rimane qualsiasi altro strumento.

701* **Il sandboxing** fornisce l'applicazione a livello del sistema operativo che limita ciò a cui i comandi della shell possono accedere a livello di filesystem e di rete. Si applica solo ai comandi Bash, PowerShell e [Monitor](/docs/it/tools-reference#monitor-tool) e ai loro processi figlio.701* **Il sandboxing** fornisce un'applicazione a livello del sistema operativo che limita ciò a cui i comandi della shell possono accedere a livello di filesystem e di rete. Si applica ai comandi degli strumenti Bash, PowerShell e [Monitor](/docs/it/tools-reference#monitor-tool) e ai loro processi figlio.

702 702 

703I due livelli differiscono anche nel modo in cui vengono applicati. Claude Code valuta le decisioni di autorizzazione prima che un comando venga eseguito, in base alla stringa di comando e, in modalità automatica, al giudizio di un classificatore separato su se il comando è sicuro. Il sistema operativo applica il limite della sandbox al processo in esecuzione, quindi rimane indipendentemente da ciò che il modello ha scelto di eseguire e anche se un comando consentito fa più di quanto il suo nome suggerisca.703I due livelli differiscono anche nel modo in cui vengono applicati. Claude Code valuta le decisioni di autorizzazione prima che un comando venga eseguito, in base alla stringa di comando e, in modalità automatica, al giudizio di un classificatore separato su se il comando è sicuro. Il sistema operativo applica il limite della sandbox al processo in esecuzione, quindi rimane indipendentemente da ciò che il modello ha scelto di eseguire e anche se un comando consentito fa più di quanto il suo nome suggerisca.

704 704 

Details

348 348 

349Né le chiavi restituite da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) né le credenziali di [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) attivano il recupero delle impostazioni.349Né le chiavi restituite da uno script [`apiKeyHelper`](/docs/it/settings-reference#apikeyhelper) né le credenziali di [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) attivano il recupero delle impostazioni.

350 350 

351Una sessione riceve le impostazioni gestite dell'organizzazione a cui appartengono le credenziali con cui si autentica. Una chiave API della [Claude Console](https://platform.claude.com) appartiene all'organizzazione Console in cui è stata creata, che è un'organizzazione separata dalla tua organizzazione Team o Enterprise di claude.ai. Le impostazioni che configuri in Admin Settings di claude.ai quindi non raggiungono una sessione che si autentica con quella chiave, come un job CI che usa la chiave API Console della tua azienda. Per applicarle a quel job, usa una di queste opzioni. L'opzione del token OAuth non si applica a un job eseguito con [`--bare`](/docs/it/headless#start-faster-with-bare-mode), perché la modalità bare non legge `CLAUDE_CODE_OAUTH_TOKEN`.

352 

353* **Token OAuth**: genera un token con [`claude setup-token`](/docs/it/authentication#generate-a-long-lived-token), autorizzalo per la tua organizzazione Team o Enterprise e impostalo come `CLAUDE_CODE_OAUTH_TOKEN` nell'ambiente del job. Rimuovi da quell'ambiente qualsiasi credenziale che [ha la precedenza](/docs/it/authentication#authentication-precedence) sul token, come `ANTHROPIC_API_KEY`.

354* **Impostazioni gestite dall'endpoint**: distribuisci un [file di impostazioni gestite](/docs/it/managed-settings#delivery-mechanisms) sulla macchina che esegue il job.

355 

351In una sessione [Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop, Claude Code non recupera le impostazioni gestite dal server dalla console di amministrazione claude.ai, anche quando l'utente accede con un account Team o Enterprise. [Dove e quando si applica una policy](/docs/it/managed-settings#where-and-when-a-policy-applies) copre quale policy raggiunge le sessioni Cowork sulla macchina dell'utente e le sessioni Cowork remote. claude.ai applica comunque i vostri elenchi [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) e [`blockedMarketplaces`](/docs/it/settings-reference#blockedmarketplaces) quando un utente Cowork aggiunge un marketplace da un repository git su claude.ai o da **Customize** nella scheda Cowork. [Come funzionano le restrizioni](/docs/it/plugins/org#restrict-what-users-can-install) descrive quel controllo.356In una sessione [Cowork](https://claude.com/docs/cowork/overview) nell'app Claude Desktop, Claude Code non recupera le impostazioni gestite dal server dalla console di amministrazione claude.ai, anche quando l'utente accede con un account Team o Enterprise. [Dove e quando si applica una policy](/docs/it/managed-settings#where-and-when-a-policy-applies) copre quale policy raggiunge le sessioni Cowork sulla macchina dell'utente e le sessioni Cowork remote. claude.ai applica comunque i vostri elenchi [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) e [`blockedMarketplaces`](/docs/it/settings-reference#blockedmarketplaces) quando un utente Cowork aggiunge un marketplace da un repository git su claude.ai o da **Customize** nella scheda Cowork. [Come funzionano le restrizioni](/docs/it/plugins/org#restrict-what-users-can-install) descrive quel controllo.

352 357 

353Se esportate una variabile provider `CLAUDE_CODE_USE_*` o un `ANTHROPIC_BASE_URL` non predefinito nella vostra shell, Claude Code salta il recupero delle impostazioni per le vostre sessioni. [`claude doctor` e `/status` segnalano il recupero saltato e la sua causa](#verify-settings-delivery).358Se esportate una variabile provider `CLAUDE_CODE_USE_*` o un `ANTHROPIC_BASE_URL` non predefinito nella vostra shell, Claude Code salta il recupero delle impostazioni per le vostre sessioni. [`claude doctor` e `/status` segnalano il recupero saltato e la sua causa](#verify-settings-delivery).


379| L'utente esegue un binario Claude Code modificato | Un utente che può eseguire un client modificato può aggirare qualsiasi controllo lato client |384| L'utente esegue un binario Claude Code modificato | Un utente che può eseguire un client modificato può aggirare qualsiasi controllo lato client |

380| L'utente esegue una versione precedente di Claude Code | Le versioni precedenti alle impostazioni gestite dal server non le recuperano o non le applicano |385| L'utente esegue una versione precedente di Claude Code | Le versioni precedenti alle impostazioni gestite dal server non le recuperano o non le applicano |

381| L'API non è disponibile | Le impostazioni memorizzate nella cache si applicano se disponibili, ad eccezione dei [valori che Claude Code trattiene](#fetch-and-caching-behavior) fino a quando un recupero ha successo. Senza una cache, Claude Code non applica alcuna impostazione gestita dal server fino al prossimo recupero riuscito e applica comunque qualsiasi [impostazione gestita dall'endpoint](/docs/it/managed-settings#delivery-mechanisms) sul dispositivo. Con `forceRemoteSettingsRefresh: true`, la CLI esce invece di continuare, ad eccezione dei [`claude auth` subcomandi](#enforce-fail-closed-startup). I client che hanno effettuato l'accesso tramite un [gateway di app Claude](#platform-availability) escono all'avvio senza questa impostazione, con la stessa eccezione `claude auth` |386| L'API non è disponibile | Le impostazioni memorizzate nella cache si applicano se disponibili, ad eccezione dei [valori che Claude Code trattiene](#fetch-and-caching-behavior) fino a quando un recupero ha successo. Senza una cache, Claude Code non applica alcuna impostazione gestita dal server fino al prossimo recupero riuscito e applica comunque qualsiasi [impostazione gestita dall'endpoint](/docs/it/managed-settings#delivery-mechanisms) sul dispositivo. Con `forceRemoteSettingsRefresh: true`, la CLI esce invece di continuare, ad eccezione dei [`claude auth` subcomandi](#enforce-fail-closed-startup). I client che hanno effettuato l'accesso tramite un [gateway di app Claude](#platform-availability) escono all'avvio senza questa impostazione, con la stessa eccezione `claude auth` |

382| L'utente si autentica con un'organizzazione diversa | Le impostazioni non vengono consegnate per gli account al di fuori dell'organizzazione gestita |387| L'utente si autentica con un'organizzazione diversa | Le impostazioni non vengono consegnate per gli account al di fuori dell'organizzazione gestita, inclusa una sessione che si autentica con una [chiave API della Console](#platform-availability) |

383| L'utente configura un [provider di modelli di terze parti](#platform-availability) | Le impostazioni gestite dal server vengono ignorate. Questo include l'impostazione di `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS`, o un `ANTHROPIC_BASE_URL` non predefinito |388| L'utente configura un [provider di modelli di terze parti](#platform-availability) | Le impostazioni gestite dal server vengono ignorate. Questo include l'impostazione di `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_MANTLE`, `CLAUDE_CODE_USE_VERTEX`, `CLAUDE_CODE_USE_FOUNDRY`, `CLAUDE_CODE_USE_ANTHROPIC_AWS`, o un `ANTHROPIC_BASE_URL` non predefinito |

384| Il traffico di rete viene intercettato o reindirizzato | La convalida TLS disabilitata o il traffico intercettato può alterare le impostazioni che il client riceve |389| Il traffico di rete viene intercettato o reindirizzato | La convalida TLS disabilitata o il traffico intercettato può alterare le impostazioni che il client riceve |

385 390 

Details

1399 1399 

1400Scegli cosa succede quando un [classificatore di sicurezza contrassegna una richiesta](/docs/it/model-config#automatic-model-fallback): passa al modello di fallback e continua, o pausa così puoi scegliere tra passare e modificare il prompt.1400Scegli cosa succede quando un [classificatore di sicurezza contrassegna una richiesta](/docs/it/model-config#automatic-model-fallback): passa al modello di fallback e continua, o pausa così puoi scegliere tra passare e modificare il prompt.

1401 1401 

1402* **Scope**: [`Any file`](#scopes). Appare in `/config` come **Switch models when a message is flagged**.1402* **Scope**: [`Any file`](#scopes). Appare in `/config` come **Switch models when a message is flagged**, con le opzioni **Switch automatically** e **Ask each time**.

1403* **Type**: Boolean1403* **Type**: Boolean

1404 * `true`: Claude Code passa al modello di fallback e continua1404 * `true`: Claude Code passa al modello di fallback e continua

1405 * `false`: in una sessione interattiva Claude Code pausa così puoi scegliere tra passare e modificare il prompt; dove nessuna finestra di dialogo può mostrare, come un'esecuzione `-p`, la richiesta contrassegnata termina come errore1405 * `false`: in una sessione interattiva Claude Code pausa così puoi scegliere tra passare e modificare il prompt; dove nessuna finestra di dialogo può mostrare, come un'esecuzione `-p`, la richiesta contrassegnata termina come errore

1406* **Default**: `true`, passa automaticamente1406* **Default**: non impostato. Claude Code cambia modello automaticamente, anche se in una sessione interattiva potrebbe [chiedere prima](/docs/it/model-config#ask-before-switching)

1407 1407 

1408```json settings.json theme={null}1408```json settings.json theme={null}

1409{1409{


3164 `plansDirectory`3164 `plansDirectory`

3165</h3>3165</h3>

3166 3166 

3167Scegli dove Claude Code archivia i file di piano che scrive in [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode). Claude Code risolve il percorso relativamente alla radice del progetto e mantiene il valore predefinito quando il percorso si risolve al di fuori di essa.3167Scegli dove Claude Code archivia i file di piano che scrive in [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode). Claude Code risolve il percorso relativamente alla radice del progetto.

3168 3168 

3169* **Ambito**: [`Any file`](#scopes)3169* **Ambito**: [`Any file`](#scopes)

3170* **Tipo**: stringa, un percorso relativo alla radice del progetto3170* **Tipo**: stringa, un percorso relativo alla radice del progetto


3176}3176}

3177```3177```

3178 3178 

3179Claude Code archivia i piani in `~/.claude/plans` invece che nella directory che hai impostato in casi come questi:

3180 

3181* **Al di fuori della radice del progetto**: il percorso si risolve al di fuori della radice del progetto, come fa `"../plans"`.

3182* **Barra rovesciata su macOS, Linux e WSL**: il percorso risolto contiene una barra rovesciata, come fa `"docs\\plans"` in stile Windows. Scrivi `"docs/plans"`, che funziona anche su Windows.

3183 

3179<h3 id="skilllistingbudgetfraction">3184<h3 id="skilllistingbudgetfraction">

3180 `skillListingBudgetFraction`3185 `skillListingBudgetFraction`

3181</h3>3186</h3>


5768 5773 

5769Disattiva le sessioni Code che vengono eseguite sul dispositivo nell'[app desktop](/docs/it/desktop#local-sessions-on-managed-devices), per distribuzioni in cui gli sviluppatori dovrebbero lavorare su macchine remote tramite SSH. Nella scheda Code, l'ambiente **Local** rimane nel menu a discesa dell'ambiente ma è disattivato e non può essere selezionato, con un tooltip che dice che la tua organizzazione lo ha disattivato; su Windows la voce WSL è disattivata allo stesso modo, anche se se le sessioni WSL vengono eseguite su un dispositivo gestito è [governato separatamente](/docs/it/admin-setup#wsl-sessions-in-claude-code-desktop). Le nuove sessioni predefinite alla prima [connessione SSH](/docs/it/desktop#ssh-sessions) se ne è configurata una, e l'app rifiuta di avviare o riprendere una sessione sul dispositivo, inclusa una connessione SSH allo stesso computer. Le sessioni SSH ad altri host e le sessioni cloud non sono interessate. L'app desktop legge questa chiave; il CLI del terminale la ignora. Richiede Claude Desktop v1.37937.0 o successivo.5774Disattiva le sessioni Code che vengono eseguite sul dispositivo nell'[app desktop](/docs/it/desktop#local-sessions-on-managed-devices), per distribuzioni in cui gli sviluppatori dovrebbero lavorare su macchine remote tramite SSH. Nella scheda Code, l'ambiente **Local** rimane nel menu a discesa dell'ambiente ma è disattivato e non può essere selezionato, con un tooltip che dice che la tua organizzazione lo ha disattivato; su Windows la voce WSL è disattivata allo stesso modo, anche se se le sessioni WSL vengono eseguite su un dispositivo gestito è [governato separatamente](/docs/it/admin-setup#wsl-sessions-in-claude-code-desktop). Le nuove sessioni predefinite alla prima [connessione SSH](/docs/it/desktop#ssh-sessions) se ne è configurata una, e l'app rifiuta di avviare o riprendere una sessione sul dispositivo, inclusa una connessione SSH allo stesso computer. Le sessioni SSH ad altri host e le sessioni cloud non sono interessate. L'app desktop legge questa chiave; il CLI del terminale la ignora. Richiede Claude Desktop v1.37937.0 o successivo.

5770 5775 

5771* **Scope**: [`Managed`](#scopes)5776* **Scope**: [`Managed`](#scopes). Per impostazione predefinita, l'app desktop legge la chiave da [una sola origine gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources).

5772* **Type**: Boolean; solo il Boolean JSON `true` ha effetto5777* **Type**: Boolean; solo il Boolean JSON `true` ha effetto

5773 * `true`: l'app desktop non offre sessioni Code on-device; le sessioni locali esistenti rimangono elencate ma non possono continuare5778 * `true`: l'app desktop non offre sessioni Code on-device; le sessioni locali esistenti rimangono elencate ma non possono continuare

5774 * `false`: le sessioni locali rimangono disponibili5779 * `false`: le sessioni locali rimangono disponibili


5915 5920 

5916Aggiungi connessioni SSH al menu a discesa dell'ambiente [Desktop](/docs/it/desktop#pre-configure-ssh-connections-for-your-team). Gli amministratori lo usano per distribuire connessioni condivise a un team. Le connessioni che definisci nelle impostazioni gestite vengono mostrate come gestite, quindi gli utenti possono selezionarle ma non possono modificarle o eliminarle nell'app.5921Aggiungi connessioni SSH al menu a discesa dell'ambiente [Desktop](/docs/it/desktop#pre-configure-ssh-connections-for-your-team). Gli amministratori lo usano per distribuire connessioni condivise a un team. Le connessioni che definisci nelle impostazioni gestite vengono mostrate come gestite, quindi gli utenti possono selezionarle ma non possono modificarle o eliminarle nell'app.

5917 5922 

5918* **Scope**: [`User or managed`](#scopes). L'app desktop legge questa chiave.5923* **Scope**: [`User or managed`](#scopes). L'app desktop legge questa chiave. Per impostazione predefinita, legge le connessioni gestite da [una sola origine gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources).

5919* **Type**: array di oggetti, ognuno con `id`, `name` e `sshHost` obbligatori e `sshPort` e `sshIdentityFile` opzionali5924* **Type**: array di oggetti, ognuno con `id`, `name` e `sshHost` obbligatori e `sshPort` e `sshIdentityFile` opzionali

5920* **Default**: non impostato5925* **Default**: non impostato

5921 5926 


5939 5944 

5940Limita gli host a cui una [sessione SSH Desktop](/docs/it/desktop#restrict-which-ssh-hosts-users-can-connect-to) può connettersi. Solo l'app Desktop legge questa chiave; il CLI non lo fa. I pattern sono case-insensitive: `*` corrisponde a qualsiasi host, `*.example.com` corrisponde a `example.com` e a ogni sottodominio e qualsiasi altra cosa è una corrispondenza esatta rispetto al nome host dopo la risoluzione di `~/.ssh/config`. Un array vuoto disattiva le sessioni SSH.5945Limita gli host a cui una [sessione SSH Desktop](/docs/it/desktop#restrict-which-ssh-hosts-users-can-connect-to) può connettersi. Solo l'app Desktop legge questa chiave; il CLI non lo fa. I pattern sono case-insensitive: `*` corrisponde a qualsiasi host, `*.example.com` corrisponde a `example.com` e a ogni sottodominio e qualsiasi altra cosa è una corrispondenza esatta rispetto al nome host dopo la risoluzione di `~/.ssh/config`. Un array vuoto disattiva le sessioni SSH.

5941 5946 

5942* **Scope**: [`Managed`](#scopes)5947* **Scope**: [`Managed`](#scopes). Per impostazione predefinita, Desktop legge la chiave da [una sola origine gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources).

5943* **Type**: array di pattern di nome host5948* **Type**: array di pattern di nome host

5944* **Default**: non impostato, quindi qualsiasi host è consentito5949* **Default**: non impostato, quindi qualsiasi host è consentito

5945 5950 


5951}5956}

5952```5957```

5953 5958 

5959Un valore che Desktop non riesce a leggere come elenco di host, come `true` o un oggetto, viene considerato un array vuoto finché non lo correggi, tranne `null`, che viene considerato non impostato. Richiede Claude Desktop v2.26454.0 o successivo.

5960 

5961Se imposti [`managedSourcesBehavior`](#managedsourcesbehavior) su `"merge"` nella tua origine con la priorità più alta, Desktop combina gli elenchi di ogni [origine di amministrazione](/docs/it/managed-settings#how-claude-code-combines-managed-sources) e consente un host che corrisponde a uno qualsiasi di essi. Se imposti un array vuoto in un'origine, le sessioni SSH restano attive per gli host elencati da un'altra origine.

5962 

5954<span id="authentication-and-login" />5963<span id="authentication-and-login" />

5955 5964 

5956<h2 id="authentication-and-providers">5965<h2 id="authentication-and-providers">

setup.md +12 −8

Details

63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd63 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

64 ```64 ```

65 65 

66 Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).66 Il comando di installazione non mostra alcun avanzamento mentre scarica Claude Code. Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui `claude --version`. Un'installazione funzionante stampa un numero di versione. Se la tua shell dice che `claude` non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi [Correggi il tuo PATH](/docs/it/troubleshoot-install#command-not-found-claude-after-installation).

67 67 

68 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.68 Se vedi `The token '&&' is not a valid statement separator`, sei in PowerShell, non in CMD. Se vedi `'irm' is not recognized as an internal or external command`, sei in CMD, non in PowerShell.

69 69 


119 119 

120| Opzione | Richiede | [Sandboxing](/docs/it/sandboxing) | Quando utilizzare |120| Opzione | Richiede | [Sandboxing](/docs/it/sandboxing) | Quando utilizzare |

121| - | - | - | - |121| - | - | - | - |

122| Windows nativo | Nessuno; [Git for Windows](https://git-scm.com/downloads/win) è facoltativo | Non supportato | Progetti e strumenti nativi di Windows |122| [Windows nativo](#install-on-native-windows) | Nessuno; [Git for Windows](https://git-scm.com/downloads/win) è facoltativo | Non supportato | Progetti e strumenti nativi di Windows |

123| WSL 2 | WSL 2 abilitato | Supportato | Toolchain Linux o esecuzione di comandi in sandbox |123| [WSL 2](#install-in-wsl) | WSL 2 abilitato | Supportato | Toolchain Linux o esecuzione di comandi in sandbox |

124| WSL 1 | WSL 1 abilitato | Non supportato | Se WSL 2 non è disponibile |124| [WSL 1](#install-in-wsl) | WSL 1 abilitato | Non supportato | Se WSL 2 non è disponibile |

125 125 

126**Opzione 1: Windows nativo**126<h4 id="install-on-native-windows">

127 Installare su Windows nativo

128</h4>

127 129 

128Esegui il comando di installazione da PowerShell o CMD. Non è necessario eseguire come Amministratore. L'installazione di [Git for Windows](https://git-scm.com/downloads/win) è facoltativa. Fornisce Git Bash, necessario per lo [strumento Bash](/docs/it/tools-reference#bash-tool-behavior) e lo [strumento Monitor](/docs/it/tools-reference#monitor-tool).130Esegui il [comando di installazione](#install-claude-code) da PowerShell o CMD. Non è necessario eseguire come Amministratore. L'installazione di [Git for Windows](https://git-scm.com/downloads/win) è facoltativa. Fornisce Git Bash, necessario per lo [strumento Bash](/docs/it/tools-reference#bash-tool-behavior) e lo [strumento Monitor](/docs/it/tools-reference#monitor-tool).

129 131 

130Se eseguite l'installazione da PowerShell o CMD influisce solo su quale comando di installazione eseguite. Il vostro prompt mostra `PS C:\Users\YourName>` in PowerShell e `C:\Users\YourName>` senza il `PS` in CMD. Se siete nuovi al terminale, la [guida del terminale](/docs/it/terminal-guide#windows) vi guida attraverso ogni passaggio.132Se eseguite l'installazione da PowerShell o CMD influisce solo su quale comando di installazione eseguite. Il vostro prompt mostra `PS C:\Users\YourName>` in PowerShell e `C:\Users\YourName>` senza il `PS` in CMD. Se siete nuovi al terminale, la [guida del terminale](/docs/it/terminal-guide#windows) vi guida attraverso ogni passaggio.

131 133 


144 146 

145Quando Git for Windows è installato, lo strumento PowerShell è disponibile insieme a Bash: attivato per impostazione predefinita per gli account claude.ai e Console, e abilitato con `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Impostatelo a `0` per disattivare lo strumento. Consultate [PowerShell tool](/docs/it/tools-reference#powershell-tool) per la configurazione e le limitazioni.147Quando Git for Windows è installato, lo strumento PowerShell è disponibile insieme a Bash: attivato per impostazione predefinita per gli account claude.ai e Console, e abilitato con `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` nelle sessioni Amazon Bedrock, Google Cloud's Agent Platform e Microsoft Foundry. Impostatelo a `0` per disattivare lo strumento. Consultate [PowerShell tool](/docs/it/tools-reference#powershell-tool) per la configurazione e le limitazioni.

146 148 

147**Opzione 2: WSL**149<h4 id="install-in-wsl">

150 Installare in WSL

151</h4>

148 152 

149Aprite la vostra distribuzione WSL ed eseguite l'installer Linux dalle [istruzioni di installazione](#install-claude-code) sopra. Installate e avviate `claude` all'interno del terminale WSL, non da PowerShell o CMD.153Apri la tua distribuzione WSL ed esegui l'installer Linux dalle [istruzioni di installazione](#install-claude-code). Installi e avvii `claude` all'interno del terminale WSL, non da PowerShell o CMD.

150 154 

151<h3 id="alpine-linux-and-musl-based-distributions">155<h3 id="alpine-linux-and-musl-based-distributions">

152 Alpine Linux e distribuzioni basate su musl156 Alpine Linux e distribuzioni basate su musl

skills.md +15 −0

Details

36 36 

37Gli skill raggruppati sono elencati insieme ai comandi built-in nel [riferimento dei comandi](/docs/it/commands), contrassegnati come **Skill** nella colonna Purpose.37Gli skill raggruppati sono elencati insieme ai comandi built-in nel [riferimento dei comandi](/docs/it/commands), contrassegnati come **Skill** nella colonna Purpose.

38 38 

39<h3 id="check-your-setup-with-/doctor">

40 Controlla la tua configurazione con `/doctor`

41</h3>

42 

43Esegui `/doctor` al prompt di Claude Code per un controllo della configurazione che diagnostica i problemi e può risolverli. Claude riporta prima i risultati e chiede conferma prima di modificare qualsiasi cosa. Il controllo copre queste aree:

44 

45* **Stato dell'installazione**: installazioni duplicate o residue, problemi di `PATH`, file di impostazioni non analizzabili e se è disponibile una versione più recente sul tuo [canale di rilascio](/docs/it/setup#configure-release-channel)

46* **Estensioni**: skill, server MCP e plugin inutilizzati confrontati con il loro costo in termini di contesto, e [hook](/docs/it/hooks) lenti

47* **File `CLAUDE.md`**: file `CLAUDE.md` locali che duplicano quelli archiviati nel repository, [contenuto di `CLAUDE.md` archiviato che Claude potrebbe ricavare dal codebase](/docs/it/memory#my-claude-md-is-too-large) e le indicazioni sempre caricate che rimangono, che Claude propone di migrare in skill e in file `CLAUDE.md` annidati caricati su richiesta

48* **Permessi**: una proposta per rendere la [modalità auto](/docs/it/permissions#permission-modes) la tua modalità di permesso predefinita e per [pre-approvare](/docs/it/permissions) i comandi di sola lettura che neghi frequentemente

49 

50Per una diagnostica dell'installazione di sola lettura senza avviare una sessione, esegui invece `claude doctor` nel terminale.

51 

52Per verificare le tue istruzioni anziché la tua configurazione, esegui `/doctor prompt-audit` al prompt di Claude Code. Invece di eseguire il controllo, Claude [esamina i tuoi file `CLAUDE.md`, le skill e altre configurazioni](/docs/it/memory#audit-your-instruction-files) alla ricerca di istruzioni obsolete o in conflitto. Il sottocomando `prompt-audit` richiede Claude Code v2.1.283 o versioni successive.

53 

39<h3 id="run-and-verify-your-app">54<h3 id="run-and-verify-your-app">

40 Eseguire e verificare la vostra app55 Eseguire e verificare la vostra app

41</h3>56</h3>

statusline.md +92 −43

Details

143</Steps>143</Steps>

144 144 

145<h2 id="how-status-lines-work">145<h2 id="how-status-lines-work">

146 Come funzionano le barre di stato146 Come funzionano le righe di stato

147</h2>147</h2>

148 148 

149Claude Code esegue il tuo script con [dati di sessione JSON](#available-data) su stdin e visualizza tutto ciò che lo script stampa su stdout.149Claude Code esegue il tuo script con [dati di sessione JSON](#available-data) su stdin e visualizza tutto ciò che lo script stampa su stdout.

150 150 

151**Quando si aggiorna**151<Note>La riga di stato viene eseguita localmente e non consuma token API. Si nasconde temporaneamente durante determinate interazioni dell'interfaccia utente, inclusi il menu della guida e le richieste di permesso.</Note>

152 

153<h3 id="when-the-status-line-updates">

154 Quando si aggiorna la riga di stato

155</h3>

152 156 

153Il tuo script viene eseguito una volta quando una sessione inizia, incluso quando ne riprendi una. Dopo di che, viene eseguito di nuovo quando:157Il tuo script viene eseguito una volta quando una sessione inizia, incluso quando ne riprendi una. Dopo di che, viene eseguito di nuovo quando:

154 158 

155* Arriva un nuovo messaggio dell'assistente159* Arriva un nuovo messaggio dell'assistente

156* `/compact` termina160* `/compact` termina

157* La modalità di autorizzazione cambia161* La modalità di permesso cambia

158* La modalità Vim si attiva/disattiva162* La modalità Vim si attiva/disattiva

159* Cambi il `command` nelle tue impostazioni `statusLine`163* Cambi il `command` nelle tue impostazioni `statusLine`

160* Un timer [`refreshInterval`](#manually-configure-a-status-line) scade, se ne hai impostato uno164* Un timer [`refreshInterval`](#manually-configure-a-status-line) scade, se ne hai impostato uno

161* Una finestra di [rate-limit](#rate-limit-usage) nei dati che il tuo script ha ricevuto per ultimo raggiunge il suo tempo `resets_at`165* Una [finestra di rate limit](#rate-limit-usage) nei dati che il tuo script ha ricevuto per ultimo raggiunge il suo tempo `resets_at`

162* Una [prompt cache](#prompt-cache-fields) calda nei dati che il tuo script ha ricevuto per ultimo raggiunge il suo tempo `expires_at`166* Una [prompt cache](#prompt-cache-fields) calda nei dati che il tuo script ha ricevuto per ultimo raggiunge il suo tempo `expires_at`

163 167 

164Claude Code debounce gli aggiornamenti a 300ms, quindi i cambiamenti rapidi si raggruppano insieme e il tuo script viene eseguito una volta che i cambiamenti si fermano. Un cambio al `command` stesso salta il debounce: Claude Code esegue il nuovo comando subito. Se un nuovo aggiornamento si attiva mentre il tuo script è ancora in esecuzione, Claude Code annulla lo script in corso. Se modifichi il tuo script, le modifiche appariranno la prossima volta che un trigger di aggiornamento lo riesegue.168Claude Code debounce gli aggiornamenti a 300ms, quindi i cambiamenti rapidi si raggruppano insieme e il tuo script viene eseguito una volta che i cambiamenti si fermano. Un cambio al `command` stesso salta il debounce: Claude Code esegue il nuovo comando subito. Se un nuovo aggiornamento si attiva mentre il tuo script è ancora in esecuzione, Claude Code annulla lo script in corso. Se modifichi il tuo script, le modifiche appariranno la prossima volta che un trigger di aggiornamento lo riesegue.

165 169 

166I trigger guidati dagli eventi possono diventare silenziosi quando la sessione principale è inattiva, ad esempio mentre un coordinatore attende i subagent in background. Per mantenere i segmenti basati sul tempo o provenienti da fonti esterne aggiornati durante i periodi di inattività, imposta [`refreshInterval`](#manually-configure-a-status-line) per eseguire nuovamente il comando anche su un timer fisso.170I trigger guidati dagli eventi possono diventare silenziosi quando la sessione principale è inattiva, ad esempio mentre un coordinatore attende i subagent in background. Per mantenere i segmenti basati sul tempo o provenienti da fonti esterne aggiornati durante i periodi di inattività, imposta [`refreshInterval`](#manually-configure-a-status-line) per eseguire nuovamente il comando anche su un timer fisso.

167 171 

168**Cosa può produrre il tuo script**172<h3 id="what-your-script-can-output">

173 Cosa può produrre il tuo script

174</h3>

175 

176Il tuo script può stampare più di una singola riga di testo semplice:

169 177 

170* **Più righe**: ogni istruzione `echo` o `print` viene visualizzata come una riga separata. Vedi l'[esempio multi-riga](#display-multiple-lines).178* **Più righe**: ogni istruzione `echo` o `print` viene visualizzata come una riga separata. Vedi l'[esempio multi-riga](#display-multiple-lines).

171* **Colori**: usa [codici di escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) come `\033[32m` per il verde (il terminale deve supportarli). Vedi l'[esempio di stato git](#git-status-with-colors).179* **Colori**: usa [codici di escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) come `\033[32m` per il verde (il terminale deve supportarli). Vedi l'[esempio di stato git](#git-status-with-colors).

172* **Link**: usa [sequenze di escape OSC 8](https://en.wikipedia.org/wiki/ANSI_escape_code#OSC) per rendere il testo cliccabile (Cmd+clic su macOS, Ctrl+clic su Windows/Linux). Richiede un terminale che supporti i hyperlink come iTerm2, Kitty o WezTerm. Vedi l'[esempio di link cliccabili](#clickable-links).180* **Link**: usa [sequenze di escape OSC 8](https://en.wikipedia.org/wiki/ANSI_escape_code#OSC) per rendere il testo cliccabile (Cmd+clic su macOS, Ctrl+clic su Windows/Linux). Richiede un terminale che supporti gli hyperlink come iTerm2, Kitty o WezTerm. Vedi l'[esempio di link cliccabili](#clickable-links).

173 181 

174**Ridimensionamento dell'output al terminale**182<h3 id="size-output-to-the-terminal">

175 183 Ridimensionare l'output al terminale

176Claude Code acquisisce l'output del tuo script invece di collegarlo direttamente al terminale, quindi `tput cols` e il rilevamento della larghezza a livello di linguaggio non possono leggere la dimensione del terminale dall'interno dello script. Leggi invece le variabili di ambiente `COLUMNS` e `LINES`. Claude Code imposta queste variabili alle dimensioni attuali del terminale prima di eseguire il tuo script.184</h3>

177 185 

178<Note>La barra di stato viene eseguita localmente e non consuma token API. Si nasconde temporaneamente durante determinate interazioni dell'interfaccia utente, inclusi il menu della guida e i prompt di autorizzazione.</Note>186Claude Code acquisisce l'output del tuo script invece di collegarlo direttamente al terminale, quindi `tput cols` e il rilevamento della larghezza a livello di linguaggio non possono leggere la dimensione del terminale dall'interno dello script. Leggi invece le variabili d'ambiente `COLUMNS` e `LINES`. Claude Code imposta queste variabili alle dimensioni attuali del terminale prima di eseguire il tuo script.

179 187 

180<h2 id="available-data">188<h2 id="available-data">

181 Dati disponibili189 Dati disponibili


1168}1176}

1169```1177```

1170 1178 

1171Il comando viene eseguito una volta per tick di aggiornamento con tutte le righe dei subagent visibili passate come un singolo oggetto JSON su stdin. L'input include i [campi hook comuni](/docs/it/hooks#common-input-fields), un campo `columns` con la larghezza di riga utilizzabile, e un array `tasks`. Ogni task ha `id`, `name`, `type`, `status`, `description`, `label`, `startTime`, `model`, `effort`, `contextWindowSize`, `tokenCount`, `tokenSamples` e `cwd`.1179Il comando viene eseguito una volta per tick di aggiornamento e riceve tutte le righe dei subagent visibili come un singolo oggetto JSON su stdin. L'input include i [campi hook di base](/docs/it/hooks#common-input-fields), un campo `columns` con la larghezza di riga utilizzabile e un array `tasks` con una voce per riga, descritti in [Campi dei task](#task-fields).

1172 

1173Il campo `model` per-task è l'ID del modello risolto su cui viene eseguito il task. `contextWindowSize` è la finestra di contesto di quel modello in token, calcolata nello stesso modo della barra di stato principale `context_window.context_window_size`, quindi puoi renderizzare una percentuale per-riga da `tokenCount`. Entrambi i campi richiedono Claude Code v2.1.205 o successivo e vengono omessi per un task il cui modello non è ancora risolto.

1174 

1175Il campo `effort` per-task è lo sforzo di ragionamento impostato per quel subagent, nel suo [frontmatter di definizione](/docs/it/sub-agents#supported-frontmatter-fields) o nell'invocazione individuale. Il valore è una delle stringhe di livello di sforzo `low`, `medium`, `high`, `xhigh` o `max`, oppure un budget di token numerico. Il campo riporta il valore configurato così come scritto: se il modello non supporta quel livello, lo sforzo che Claude Code applica effettivamente potrebbe essere diverso. Il campo richiede Claude Code v2.1.214 o successivo ed è assente quando non è impostato alcun livello per il subagent.

1176 1180 

1177Scrivi una riga JSON su stdout per ogni riga che vuoi sovrascrivere, nella forma `{"id": "<task id>", "content": "<row body>"}`. La stringa `content` viene renderizzata così com'è, inclusi i colori ANSI e i hyperlink OSC 8. Ometti l'`id` di un task per mantenere il rendering predefinito per quella riga; emetti una stringa `content` vuota per nasconderla.1181Scrivi una riga JSON su stdout per ogni riga che vuoi sovrascrivere, nella forma `{"id": "<task id>", "content": "<row body>"}`. La stringa `content` viene renderizzata così com'è, inclusi i colori ANSI e i hyperlink OSC 8. Ometti l'`id` di un task per mantenere il rendering predefinito per quella riga; emetti una stringa `content` vuota per nasconderla.

1178 1182 

1179Gli stessi gate di fiducia, `disableAllHooks` e [`allowManagedHooksOnly`](/docs/it/settings-reference#allowmanagedhooksonly) che si applicano a `statusLine` si applicano qui. I plugin possono fornire un `subagentStatusLine` predefinito nel loro [`settings.json`](/docs/it/plugins/manifest-reference#standard-layout), ma a differenza dei hooks, i valori dei plugin non vengono eseguiti sotto `allowManagedHooksOnly` anche quando il plugin è forzato abilitato nelle impostazioni gestite `enabledPlugins`.1183Gli stessi gate di fiducia, `disableAllHooks` e [`allowManagedHooksOnly`](/docs/it/settings-reference#allowmanagedhooksonly) che si applicano a `statusLine` si applicano qui. I plugin possono fornire un `subagentStatusLine` predefinito nel loro [`settings.json`](/docs/it/plugins/manifest-reference#standard-layout), ma a differenza dei hooks, i valori dei plugin non vengono eseguiti sotto `allowManagedHooksOnly` anche quando il plugin è forzato abilitato nelle impostazioni gestite `enabledPlugins`.

1180 1184 

1185<h3 id="task-fields">

1186 Campi dei task

1187</h3>

1188 

1189Ogni voce dell'array `tasks` descrive una riga di subagent con i campi seguenti. I campi contrassegnati come opzionali vengono omessi quando non hanno un valore, quindi gestisci la loro assenza nel tuo script.

1190 

1191| Campo | Tipo | Descrizione |

1192| :- | :- | :- |

1193| `id` | string | Identificatore del task. Riportalo come `id` nella riga che scrivi in risposta per questa riga |

1194| `name` | string, opzionale | Nome con cui il subagent viene [indirizzato](/docs/it/sub-agents#subagent-names), quando ne ha uno |

1195| `type` | string | Tipo di task: `local_agent` |

1196| `agentType` | string | Tipo di subagent con cui viene eseguito il task, come il [`Explore`](/docs/it/sub-agents#built-in-subagents) integrato o un `code-reviewer` personalizzato. Contiene lo stesso valore che gli hook ricevono come [`agent_type`](/docs/it/hooks#subagentstart). Richiede Claude Code v2.1.293 o successivo |

1197| `status` | string | Stato del task, come `running`, `completed`, `failed` o `killed` |

1198| `description` | string | Breve descrizione del task, come quella fornita da Claude quando ha avviato il subagent |

1199| `label` | string | Breve riepilogo dell'avanzamento del task quando Claude Code ne ha uno, altrimenti lo stesso testo di `description` |

1200| `startTime` | number | Momento di avvio del task, in millisecondi dall'epoch Unix |

1201| `model` | string, opzionale | ID del modello risolto su cui viene eseguito il task. Omesso finché il modello non viene risolto. Richiede Claude Code v2.1.205 o successivo |

1202| `effort` | string o number, opzionale | Sforzo di ragionamento impostato per il subagent nel suo [frontmatter di definizione](/docs/it/sub-agents#supported-frontmatter-fields) o nell'invocazione individuale: `low`, `medium`, `high`, `xhigh`, `max` oppure un budget di token numerico. Questo è il valore configurato, e lo sforzo che Claude Code applica può essere diverso quando il modello non supporta quel livello. Omesso quando non è impostato alcuno sforzo. Richiede Claude Code v2.1.213 o successivo |

1203| `contextWindowSize` | number, opzionale | Finestra di contesto di `model` in token, calcolata nello stesso modo di [`context_window.context_window_size`](#context-window-fields) della riga di stato principale, quindi puoi renderizzare una percentuale per riga da `tokenCount`. Omesso quando lo è `model`. Richiede Claude Code v2.1.205 o successivo |

1204| `tokenCount` | number | Conteggio corrente dei token del subagent, il valore mostrato dalla riga predefinita |

1205| `tokenSamples` | array di number | Fino alle ultime 16 letture di `tokenCount`, una per tick di aggiornamento, dalla più vecchia alla più recente e terminando con quella corrente |

1206| `cwd` | string | Directory di lavoro del subagent: la sua directory quando viene eseguito in una propria, come un worktree isolato, altrimenti la directory di lavoro della sessione |

1207 

1181<h2 id="tips">1208<h2 id="tips">

1182 Suggerimenti1209 Suggerimenti

1183</h2>1210</h2>


1192 Risoluzione dei problemi1219 Risoluzione dei problemi

1193</h2>1220</h2>

1194 1221 

1195**La barra di stato non appare**1222Se la riga di stato è vuota, inizia da [La riga di stato non appare](#status-line-not-appearing). Anche una cartella di cui non hai accettato la fiducia e uno script che fallisce la lasciano vuota, come descritto in [Fiducia nel workspace richiesta](#workspace-trust-required) e [Errori di script o blocchi](#script-errors-or-hangs).

1223 

1224<h3 id="status-line-not-appearing">

1225 La riga di stato non appare

1226</h3>

1227 

1228Se hai configurato una riga di stato e non compare nulla nella parte inferiore dell'interfaccia, esegui questi controlli:

1196 1229 

1197* Verifica che il tuo script sia eseguibile: `chmod +x ~/.claude/statusline.sh`1230* Verifica che il tuo script sia eseguibile: `chmod +x ~/.claude/statusline.sh`

1198* Controlla che il tuo script stampi su stdout, non su stderr1231* Controlla che il tuo script stampi su stdout, non su stderr

1199* Esegui il tuo script manualmente per verificare che produca output1232* Esegui il tuo script manualmente per verificare che produca output

1200* Su Windows con Git Bash installato, i backslash nel percorso `command` vengono probabilmente consumati come caratteri di escape prima che lo script venga eseguito. Usa barre oblique nel percorso. Vedi [Configurazione Windows](#windows-configuration).1233* Su Windows con Git Bash installato, i backslash nel percorso `command` vengono probabilmente consumati come caratteri di escape prima che lo script venga eseguito. Usa barre oblique nel percorso. Vedi [Configurazione Windows](#windows-configuration).

1201* Se `disableAllHooks` è `true` al di fuori delle impostazioni gestite dopo che la [precedenza delle impostazioni](/docs/it/hooks#disable-or-remove-hooks) si applica, Claude Code esegue solo uno `statusLine` dalle impostazioni gestite, e senza uno `statusLine` gestito la barra di stato è disabilitata. Rimuovi l'impostazione, o impostala su `false` nel file che la imposta, per riabilitarla. Vedi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).1234* Se `disableAllHooks` è `true` al di fuori delle impostazioni gestite dopo che la [precedenza delle impostazioni](/docs/it/hooks#disable-or-remove-hooks) si applica, Claude Code esegue solo uno `statusLine` dalle impostazioni gestite, e senza uno `statusLine` gestito la riga di stato è disabilitata. Rimuovi l'impostazione, o impostala su `false` nel file che la imposta, per riabilitarla. Vedi [`disableAllHooks`](/docs/it/settings-reference#disableallhooks).

1202* Se la tua organizzazione imposta `allowManagedHooksOnly` nelle impostazioni gestite, la tua barra di stato personalizzata scompare senza avviso: puoi ottenere una barra di stato solo da un valore `statusLine` in quelle impostazioni gestite. Vedi [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per il comportamento completo, e chiedi al tuo amministratore se questa impostazione si applica a te.1235* Se la tua organizzazione imposta `allowManagedHooksOnly` nelle impostazioni gestite, la tua riga di stato personalizzata scompare senza avviso: puoi ottenere una riga di stato solo da un valore `statusLine` in quelle impostazioni gestite. Vedi [cosa viene eseguito sotto `allowManagedHooksOnly`](/docs/it/settings-reference#what-runs-under-allowmanagedhooksonly) per il comportamento completo, e chiedi al tuo amministratore se questa impostazione si applica a te.

1203* Esegui `claude --debug` per registrare lo stderr del tuo script su ogni invocazione della barra di stato, e il suo codice di uscita sulla prima invocazione in una sessione1236* Esegui `claude --debug` per registrare lo stderr del tuo script su ogni invocazione della riga di stato, e il suo codice di uscita sulla prima invocazione in una sessione

1204* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori1237* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori

1205 1238 

1206**La barra di stato mostra `--` o valori vuoti**1239<h3 id="status-line-shows-or-empty-values">

1240 La riga di stato mostra `--` o valori vuoti

1241</h3>

1242 

1243I campi potrebbero essere `null` prima che la prima risposta API si completi, quindi gestisci i valori null nel tuo script con fallback come `// 0` in jq. Riavvia Claude Code se i valori rimangono vuoti dopo più messaggi.

1207 1244 

1208* I campi potrebbero essere `null` prima che la prima risposta API si completi1245<h3 id="context-percentage-shows-unexpected-values">

1209* Gestisci i valori null nel tuo script con fallback come `// 0` in jq1246 La percentuale di contesto mostra valori inaspettati

1210* Riavvia Claude Code se i valori rimangono vuoti dopo più messaggi1247</h3>

1211 1248 

1212**La percentuale di contesto mostra valori inaspettati**1249La riga di stato riporta i conteggi dall'ultima risposta API, mentre `/context` aggiunge una stima per i messaggi aggiunti da quella risposta, quindi `/context` può leggere più alto fino alla risposta successiva. Usa `used_percentage` per lo stato di contesto più semplice e accurato. Per la formula alla base di `used_percentage`, vedi [Campi della finestra di contesto](#context-window-fields).

1213 1250 

1214* Usa `used_percentage` per lo stato di contesto più semplice e accurato1251<h3 id="osc-8-links-not-clickable">

1215* La barra di stato riporta i conteggi dall'ultima risposta API, mentre `/context` aggiunge una stima per i messaggi aggiunti da quella risposta, quindi `/context` può leggere più alto fino alla risposta successiva1252 I link OSC 8 non sono cliccabili

1253</h3>

1216 1254 

1217**I link OSC 8 non sono cliccabili**1255Se un link sia cliccabile dipende dal tuo terminale, dal fatto che Claude Code rilevi il supporto dei hyperlink in esso, dal fatto che SSH o tmux eliminino la sequenza di escape, e da come il tuo script la stampa:

1218 1256 

1219* Verifica che il tuo terminale supporti i hyperlink OSC 8 (iTerm2, Kitty, WezTerm)1257* Verifica che il tuo terminale supporti i hyperlink OSC 8 (iTerm2, Kitty, WezTerm)

1220 1258 

1221* Terminal.app non supporta i link cliccabili1259* Terminal.app non supporta i link cliccabili

1222 1260 

1223* Se il testo del link appare ma non è cliccabile, Claude Code potrebbe non aver rilevato il supporto dei hyperlink nel tuo terminale. Imposta la variabile di ambiente `FORCE_HYPERLINK` per sovrascrivere il rilevamento prima di avviare Claude Code:1261* Se il testo del link appare ma non è cliccabile, Claude Code potrebbe non aver rilevato il supporto dei hyperlink nel tuo terminale. Imposta la variabile d'ambiente `FORCE_HYPERLINK` per sovrascrivere il rilevamento prima di avviare Claude Code:

1224 1262 

1225 ```bash theme={null}1263 ```bash theme={null}

1226 FORCE_HYPERLINK=1 claude1264 FORCE_HYPERLINK=1 claude


1236 1274 

1237* Se le sequenze di escape appaiono come testo letterale come `\e]8;;`, usa `printf '%b'` invece di `echo -e` per una gestione più affidabile degli escape1275* Se le sequenze di escape appaiono come testo letterale come `\e]8;;`, usa `printf '%b'` invece di `echo -e` per una gestione più affidabile degli escape

1238 1276 

1239**Glitch di visualizzazione con sequenze di escape**1277<h3 id="display-glitches-with-escape-sequences">

1278 Glitch di visualizzazione con sequenze di escape

1279</h3>

1280 

1281Le sequenze di escape complesse (colori ANSI, link OSC 8) possono occasionalmente causare output corrotto se si sovrappongono ad altri aggiornamenti dell'interfaccia utente. Le righe di stato multi-riga con codici di escape sono più soggette a problemi di rendering rispetto al testo semplice su una sola riga.

1282 

1283Se vedi testo corrotto, prova a semplificare il tuo script in output di testo semplice.

1284 

1285<h3 id="workspace-trust-required">

1286 Fiducia nel workspace richiesta

1287</h3>

1240 1288 

1241* Le sequenze di escape complesse (colori ANSI, link OSC 8) possono occasionalmente causare output corrotto se si sovrappongono ad altri aggiornamenti dell'interfaccia utente1289Finché non accetti la finestra di dialogo di fiducia del workspace, la riga di stato rimane vuota. Poiché `statusLine` esegue un comando di shell, Claude Code lo esegue secondo la stessa [regola di fiducia del workspace degli hook nei file di impostazioni](/docs/it/permissions#what-runs-before-you-trust-a-folder). Accettare la finestra di dialogo per la cartella, o per una directory padre la cui fiducia si estende ad essa, è sufficiente.

1242* Se vedi testo corrotto, prova a semplificare il tuo script in output di testo semplice

1243* Le barre di stato multi-riga con codici di escape sono più soggette a problemi di rendering rispetto al testo semplice su una sola riga

1244 1290 

1245**Fiducia nell'area di lavoro richiesta**1291Fino ad allora, `claude --debug` registra `Status line command skipped: workspace trust not accepted`. Riavvia Claude Code e accetta la finestra di dialogo di fiducia per abilitarla.

1246 1292 

1247* Poiché `statusLine` esegue un comando di shell, Claude Code lo esegue secondo la stessa [regola di fiducia dell'area di lavoro degli hook nei file di impostazioni](/docs/it/permissions#what-runs-before-you-trust-a-folder). Accettare la finestra di dialogo per la cartella, o per una directory padre la cui fiducia si estende ad essa, è sufficiente.1293<h3 id="script-errors-or-hangs">

1248* Fino ad allora, la barra di stato rimane vuota, e `claude --debug` registra `Status line command skipped: workspace trust not accepted`. Riavvia Claude Code e accetta la finestra di dialogo di fiducia per abilitarla.1294 Errori di script o blocchi

1295</h3>

1249 1296 

1250**Errori di script o blocchi**1297Claude Code visualizza l'output del tuo script solo dopo che lo script è terminato con codice 0:

1251 1298 

1252* Gli script che escono con codici diversi da zero o non producono output causano il vuoto della barra di stato1299* Gli script che escono con codici diversi da zero o non producono output lasciano vuota la riga di stato

1253* Gli script lenti bloccano l'aggiornamento della barra di stato fino al completamento. Mantieni gli script veloci per evitare output obsoleto.1300* Gli script lenti bloccano l'aggiornamento della riga di stato fino al completamento. Mantieni gli script veloci per evitare output obsoleto.

1254* Se un nuovo aggiornamento si attiva mentre uno script lento è in esecuzione, lo script in corso viene annullato1301* Se un nuovo aggiornamento si attiva mentre uno script lento è in esecuzione, lo script in corso viene annullato

1255* Testa il tuo script indipendentemente con input simulato prima di configurarlo1302* Testa il tuo script indipendentemente con input simulato prima di configurarlo

1256 1303 

1257**Le notifiche condividono la riga della barra di stato**1304<h3 id="notifications-share-the-status-line-row">

1305 Le notifiche condividono la riga della riga di stato

1306</h3>

1258 1307 

1259Al di fuori del [rendering a schermo intero](/docs/it/fullscreen), Claude Code mostra le notifiche sulla stessa riga della tua barra di stato. Nel rendering a schermo intero, Claude Code assegna alle notifiche una riga propria.1308Al di fuori del [rendering a schermo intero](/docs/it/fullscreen), Claude Code mostra le notifiche sulla stessa riga della tua riga di stato. Nel rendering a schermo intero, Claude Code assegna alle notifiche una riga propria.

1260 1309 

1261* Le notifiche di sistema come errori del server MCP e aggiornamenti automatici vengono visualizzate sul lato destro della riga. Le notifiche transitorie come l'avviso di contesto basso si cicla anche attraverso questa area.1310* Le notifiche di sistema come errori del server MCP e aggiornamenti automatici vengono visualizzate sul lato destro della riga. Anche le notifiche transitorie come l'avviso di contesto basso si alternano in quest'area.

1262* L'abilitazione della modalità verbose aggiunge un contatore di token a questa area1311* L'abilitazione della modalità verbose aggiunge un contatore di token a quest'area

1263* Su terminali stretti, queste notifiche potrebbero troncare l'output della tua barra di stato1312* Su terminali stretti, queste notifiche potrebbero troncare l'output della tua riga di stato

sub-agents.md +2 −0

Details

3793. La variabile di ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando la imposta su un alias modello o ID modello3793. La variabile di ambiente [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/it/model-config#environment-variables), quando la imposta su un alias modello o ID modello

3804. Il modello della conversazione principale3804. Il modello della conversazione principale

381 381 

382Se un [mod](/docs/it/plugins/mods/overview) installato imposta un modello nel suo hook [`agent.spawn`](/docs/it/plugins/mods/reference#subagents), Claude Code utilizza quel modello al posto del parametro della singola invocazione.

383 

382In due casi, un alias di famiglia come `opus` nel parametro per invocazione o nel frontmatter si risolve al modello della conversazione principale invece della [versione a cui l'alias punta](/docs/it/model-config#model-aliases):384In due casi, un alias di famiglia come `opus` nel parametro per invocazione o nel frontmatter si risolve al modello della conversazione principale invece della [versione a cui l'alias punta](/docs/it/model-config#model-aliases):

383 385 

384* **Il modello della conversazione principale appartiene a quella famiglia**: il subagent viene eseguito sul modello esatto della conversazione principale, incluso qualsiasi suffisso `[1m]`, quindi ottiene la stessa finestra di [contesto esteso](/docs/it/model-config#extended-context) della conversazione principale.386* **Il modello della conversazione principale appartiene a quella famiglia**: il subagent viene eseguito sul modello esatto della conversazione principale, incluso qualsiasi suffisso `[1m]`, quindi ottiene la stessa finestra di [contesto esteso](/docs/it/model-config#extended-context) della conversazione principale.

tools-reference.md +23 −13

Details

158 * Le sessioni di subagent non mantengono mai i cambiamenti della directory di lavoro.158 * Le sessioni di subagent non mantengono mai i cambiamenti della directory di lavoro.

159 * Se `cd` finisce al di fuori di quelle directory, Claude Code ripristina la directory del progetto e aggiunge `Shell cwd was reset to <dir>` al risultato dello strumento.159 * Se `cd` finisce al di fuori di quelle directory, Claude Code ripristina la directory del progetto e aggiunge `Shell cwd was reset to <dir>` al risultato dello strumento.

160 * Per disabilitare questo mantenimento in modo che ogni comando Bash inizi nella directory del progetto, imposta `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.160 * Per disabilitare questo mantenimento in modo che ogni comando Bash inizi nella directory del progetto, imposta `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1`.

161* Le variabili di ambiente non persistono. Un `export` in un comando non sarà disponibile nel successivo.161* Le variabili d'ambiente non persistono. Un `export` in un comando non sarà disponibile nel successivo.

162* Gli alias e le funzioni shell definiti nel tuo file di avvio della shell sono disponibili. All'inizio della sessione, Claude Code esegue `~/.zshrc`, `~/.bashrc`, o `~/.profile` a seconda della tua shell, acquisisce gli alias, le funzioni e le opzioni della shell risultanti, e le applica a ogni comando Bash.162* Gli alias e le funzioni shell definiti nel tuo file di avvio della shell sono disponibili. All'inizio della sessione, Claude Code esegue `~/.zshrc`, `~/.bashrc`, o `~/.profile` a seconda della tua shell, acquisisce gli alias, le funzioni e le opzioni della shell risultanti, e le applica a ogni comando Bash.

163 163 

164Attiva il tuo virtualenv o ambiente conda prima di avviare Claude Code. Per fare in modo che le variabili di ambiente persistano tra i comandi Bash, imposta [`CLAUDE_ENV_FILE`](/docs/it/env-vars) su uno script shell prima di avviare Claude Code, o usa un [hook SessionStart](/docs/it/hooks#persist-environment-variables) per popolarlo dinamicamente.164Attiva il tuo virtualenv o ambiente conda prima di avviare Claude Code. Per fare in modo che le variabili d'ambiente persistano tra i comandi Bash, imposta [`CLAUDE_ENV_FILE`](/docs/it/env-vars) su uno script shell prima di avviare Claude Code, o usa un [hook SessionStart](/docs/it/hooks#persist-environment-variables) per popolarlo dinamicamente.

165 165 

166<h3 id="timeout-and-output-limits">166<h3 id="timeout-and-output-limits">

167 Limiti di timeout e output167 Limiti di timeout e output


169 169 

170Ogni comando viene eseguito con un timeout, e Claude lo gestisce: quando ha bisogno di più tempo del valore predefinito per un comando, passa il parametro `timeout` con quella chiamata. Non imposti mai un timeout per singolo comando.170Ogni comando viene eseguito con un timeout, e Claude lo gestisce: quando ha bisogno di più tempo del valore predefinito per un comando, passa il parametro `timeout` con quella chiamata. Non imposti mai un timeout per singolo comando.

171 171 

172Due [variabili di ambiente](/docs/it/env-vars) controllano cosa Claude ottiene per un comando che viene eseguito in primo piano:172Due [variabili d'ambiente](/docs/it/env-vars) controllano cosa Claude ottiene per un comando che viene eseguito in primo piano:

173 173 

174* `BASH_DEFAULT_TIMEOUT_MS` — il valore predefinito quando Claude non passa alcun timeout; due minuti per impostazione predefinita174* `BASH_DEFAULT_TIMEOUT_MS` — il valore predefinito quando Claude non passa alcun timeout; due minuti per impostazione predefinita

175* `BASH_MAX_TIMEOUT_MS` — con il valore predefinito, imposta il limite massimo che limita tutto ciò che Claude richiede: il limite massimo effettivo è il maggiore dei due, dieci minuti per impostazione predefinita175* `BASH_MAX_TIMEOUT_MS` — con il valore predefinito, imposta il limite massimo che limita tutto ciò che Claude richiede: il limite massimo effettivo è il maggiore dei due, dieci minuti per impostazione predefinita


203 Quando un comando in background si ferma203 Quando un comando in background si ferma

204</h4>204</h4>

205 205 

206Un comando che un [subagent in primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ha avviato si ferma quando la corsa di quel subagent termina, sia che sia finita, non riuscita o interrotta. Un comando che la conversazione principale o un subagent in background ha avviato continua a essere eseguito dopo una risposta finale, finché non esce, non viene fermato, o raggiunge il suo [limite di tempo](#time-limit-for-background-commands). In modalità non interattiva con il flag `-p`, i [comandi in background terminano poco dopo il risultato finale della corsa](/docs/it/headless#background-tasks-at-exit).206Un comando che un [subagent in primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background) ha avviato si ferma quando la corsa di quel subagent termina, sia che sia finita, non riuscita o interrotta. Un comando che la conversazione principale o un subagent in background ha avviato continua a essere eseguito dopo una risposta finale, finché non esce, non viene fermato, o raggiunge il suo [limite di tempo](#time-limit-for-background-commands).

207 

208Mentre un comando avviato dalla conversazione principale è ancora in esecuzione, un'esecuzione in modalità non interattiva con il flag `-p` [rimane aperta dopo il suo risultato](/docs/it/headless#background-tasks-at-exit) finché quel comando non esce o non raggiunge il suo limite di tempo. Un comando avviato da un subagent in background viene fermato quando l'esecuzione termina.

207 209 

208<h4 id="time-limit-for-background-commands">210<h4 id="time-limit-for-background-commands">

209 Limite di tempo per i comandi in background211 Limite di tempo per i comandi in background


218* Un comando che Claude avvia in background ottiene 30 minuti, o il `timeout` che Claude passa con `run_in_background`, fino a un massimo di 2 ore220* Un comando che Claude avvia in background ottiene 30 minuti, o il `timeout` che Claude passa con `run_in_background`, fino a un massimo di 2 ore

219* Un comando che inizia in primo piano e poi si sposta in background, ad esempio al suo timeout, ottiene 30 minuti dalla mossa221* Un comando che inizia in primo piano e poi si sposta in background, ad esempio al suo timeout, ottiene 30 minuti dalla mossa

220 222 

223In un'esecuzione con il flag `-p` il cui prompt passi come testo anziché con `--input-format stream-json`, entrambi i valori predefiniti sono 10 minuti anziché 30, perché l'esecuzione [attende i comandi in background dopo il suo risultato](/docs/it/headless#background-tasks-at-exit).

224 

221Quando un comando in background raggiunge il suo limite di tempo, Claude Code lo ferma e dice a Claude perché, e Claude può avviare di nuovo il comando con un `timeout` più lungo se il lavoro ne ha ancora bisogno. L'avviso di arresto recita `Background command "<description>" was stopped after reaching its background time limit`.225Quando un comando in background raggiunge il suo limite di tempo, Claude Code lo ferma e dice a Claude perché, e Claude può avviare di nuovo il comando con un `timeout` più lungo se il lavoro ne ha ancora bisogno. L'avviso di arresto recita `Background command "<description>" was stopped after reaching its background time limit`.

222 226 

223<h4 id="raise-the-time-limit-for-background-commands">227<h4 id="raise-the-time-limit-for-background-commands">

224 Aumenta il limite di tempo per i comandi in background228 Aumenta il limite di tempo per i comandi in background

225</h4>229</h4>

226 230 

227Due [variabili di ambiente](/docs/it/env-vars) aumentano questi limiti, per i comandi Bash e PowerShell allo stesso modo. Entrambe prendono millisecondi, e nessuna può accorciare un limite: un valore inferiore lascia il valore predefinito di 30 minuti e il massimo di 2 ore in vigore.231Due [variabili d'ambiente](/docs/it/env-vars) aumentano questi limiti, per i comandi Bash e PowerShell allo stesso modo. Entrambe prendono millisecondi, e nessuna può accorciare un limite: un valore inferiore lascia in vigore i valori predefiniti e il massimo di 2 ore.

228 232 

229* Imposta `BASH_DEFAULT_TIMEOUT_MS` sopra `1800000` per sostituire il valore predefinito di 30 minuti con quel valore, sia per i comandi che Claude avvia senza un `timeout` che per i comandi spostati233* Imposta `BASH_DEFAULT_TIMEOUT_MS` sopra `1800000` per sostituire il valore predefinito di 30 minuti con quel valore, sia per i comandi che Claude avvia senza un `timeout` che per i comandi spostati. In un'esecuzione `-p` il cui prompt passi come testo, qualsiasi valore sopra `600000` sostituisce il suo valore predefinito di 10 minuti

230* Imposta `BASH_MAX_TIMEOUT_MS` sopra `7200000` per aumentare il massimo di 2 ore a quel valore. Impostare `BASH_DEFAULT_TIMEOUT_MS` sopra `7200000` aumenta il massimo allo stesso modo234* Imposta `BASH_MAX_TIMEOUT_MS` sopra `7200000` per aumentare il massimo di 2 ore a quel valore. Impostare `BASH_DEFAULT_TIMEOUT_MS` sopra `7200000` aumenta il massimo allo stesso modo

231 235 

232<h4 id="foreground-commands-that-move-to-the-background">236<h4 id="foreground-commands-that-move-to-the-background">


256 260 

257Claude Code può anche contare altri tipi di processi che avvia rispetto allo stesso limite. Imposta [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/it/env-vars#variables) su un elenco separato da virgole dei tipi da esentare dal limite; Claude Code applica il limite a ogni tipo non nel tuo elenco. Impostalo su `none` per limitare ogni tipo, o su `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Richiede Claude Code v2.1.246 o successivo. I tipi che puoi nominare:261Claude Code può anche contare altri tipi di processi che avvia rispetto allo stesso limite. Imposta [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/it/env-vars#variables) su un elenco separato da virgole dei tipi da esentare dal limite; Claude Code applica il limite a ogni tipo non nel tuo elenco. Impostalo su `none` per limitare ogni tipo, o su `all-new` per limitare solo i comandi degli strumenti Bash, PowerShell e Monitor. Richiede Claude Code v2.1.246 o successivo. I tipi che puoi nominare:

258 262 

259* `mcp`: server [MCP](/docs/it/mcp) locali263* `mcp`: [server MCP](/docs/it/mcp) locali

260* `lsp`: [language server](#lsp-tool-behavior)264* `lsp`: [language server](#lsp-tool-behavior)

261* `hooks`: comandi [hook](/docs/it/hooks)265* `hooks`: comandi [hook](/docs/it/hooks)

262* `plugin`: comandi che i [plugin](/docs/it/plugins/overview) eseguono266* `plugin`: comandi che i [plugin](/docs/it/plugins/overview) eseguono

263* `helper`: i comandi helper di Claude Code, come `git`267* `helper`: i comandi helper di Claude Code, come `git`

264* `agent`: processi Claude Code figlio, come [agent teammate](/docs/it/agent-teams)268* `agent`: processi Claude Code figlio, come i membri di un [team di agenti](/docs/it/agent-teams)

265 269 

266Qualunque cosa tu elenchi, queste regole si applicano:270Qualunque cosa tu elenchi, queste regole si applicano:

267 271 

268* **Nomi sconosciuti**: Claude Code ignora i nomi che non riconosce272* **Nomi sconosciuti**: Claude Code ignora i nomi che non riconosce

269* **Variabile non impostata**: Claude Code prende l'insieme di altri tipi limitati dalla configurazione che Anthropic fornisce dal server, e quell'insieme può cambiare nel tempo, quindi imposta la variabile quando hai bisogno di un insieme che non cambia273* **Variabile non impostata**: Claude Code prende l'insieme di altri tipi limitati dalla configurazione che Anthropic fornisce dal server, e quell'insieme può cambiare nel tempo, quindi imposta la variabile quando hai bisogno di un insieme che non cambia

270* **Hook con gating delle autorizzazioni**: anche con ogni tipo limitato, Claude Code esclude dal limite un hook che può bloccare o modificare l'esito di un'azione, e qualsiasi server MCP che tale hook chiama, quindi il kernel che uccide un hook con gating delle autorizzazioni non può consentire l'azione che stava bloccando274* **Hook con gating dei permessi**: anche con ogni tipo limitato, Claude Code esclude dal limite un hook che può bloccare o modificare l'esito di un'azione, e qualsiasi server MCP che tale hook chiama, quindi il kernel che uccide un hook con gating dei permessi non può consentire l'azione che stava bloccando

271 275 

272<h2 id="edit-tool-behavior">276<h2 id="edit-tool-behavior">

273 Comportamento dello strumento Edit277 Comportamento dello strumento Edit


285 289 

286La visualizzazione di un file con Bash soddisfa il requisito read-before-edit quando il comando è `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep`, o `rg` su un singolo file senza pipe o reindirizzamenti. L'output tramite pipe e altri comandi Bash non contano verso il controllo read-before-edit.290La visualizzazione di un file con Bash soddisfa il requisito read-before-edit quando il comando è `cat`, `nl`, `bat`, `batcat`, `head`, `tail`, `sed -n 'X,Yp'`, `grep`, `egrep`, `fgrep`, o `rg` su un singolo file senza pipe o reindirizzamenti. L'output tramite pipe e altri comandi Bash non contano verso il controllo read-before-edit.

287 291 

288La visualizzazione di un file con Bash influisce solo sull'idoneità alla modifica, non sulle autorizzazioni. Vedere [Regole di autorizzazione Read e Edit](/docs/it/permissions#read-and-edit) per quali comandi Bash le vostre regole di negazione `Read` e `Edit` coprono.292Quando Claude visualizza un file in questo modo, Claude Code carica anche gli eventuali [`CLAUDE.md` delle sottodirectory](/docs/it/memory#how-claude-md-files-load) e le [regole con ambito di percorso](/docs/it/memory#path-specific-rules) che si applicano a quel file. Consulta [Regole di permesso Read e Edit](/docs/it/permissions#read-and-edit) per sapere quali comandi Bash sono coperti dalle tue regole di negazione `Read` e `Edit`.

289 293 

290<h2 id="endconversation-tool-behavior">294<h2 id="endconversation-tool-behavior">

291 Comportamento dello strumento EndConversation295 Comportamento dello strumento EndConversation


709Il backend di ricerca non è configurabile. Per cercare con un provider diverso, aggiungi un [server MCP](/docs/it/mcp) che espone uno strumento di ricerca.713Il backend di ricerca non è configurabile. Per cercare con un provider diverso, aggiungi un [server MCP](/docs/it/mcp) che espone uno strumento di ricerca.

710 714 

711<Note>715<Note>

712 WebSearch è disponibile sull'API Claude e su [Claude Platform on AWS](/docs/it/claude-platform-on-aws). Su Microsoft Foundry richiede una [distribuzione ospitata su Anthropic](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options): le distribuzioni ospitate su Azure non supportano strumenti lato server, quindi la chiamata WebSearch fallisce. Su Google Cloud's Agent Platform funziona con Claude 4 e modelli successivi, inclusi Opus, Sonnet e Haiku. Amazon Bedrock non espone lo strumento di web search lato server.716 WebSearch è disponibile sull'API Claude, su [Claude Platform on AWS](/docs/it/claude-platform-on-aws) e su Microsoft Foundry. Su Google Cloud's Agent Platform funziona con Claude 4 e modelli successivi, inclusi Opus, Sonnet e Haiku. Amazon Bedrock non espone lo strumento di web search lato server.

713</Note>717</Note>

714 718 

715<h3 id="session-search-limit">719<h3 id="session-search-limit">

716 Limite di ricerca della sessione720 Limite di ricerca della sessione

717</h3>721</h3>

718 722 

719Una sessione può effettuare al massimo 200 chiamate WebSearch, conteggiate nella conversazione principale e in ogni [subagent](/docs/it/sub-agents) che genera, quindi le ricerche effettuate da fan-out di ricerca paralleli contano rispetto allo stesso limite. Il limite richiede Claude Code v2.1.212 o successivo. Quando Claude raggiunge il limite, le ulteriori chiamate restituiscono un avviso che dice a Claude di continuare con le informazioni già raccolte, piuttosto che un errore che inviterebbe a un nuovo tentativo. Non vedi l'avviso: una chiamata limitata appare nella conversazione come una ricerca che non ha fatto nulla, e se Claude ha bisogno di più ricerche, l'avviso le dice di chiederti di aumentare il limite.723Una sessione interattiva nel terminale ha un limite di 200 chiamate WebSearch. Le ricerche dalla conversazione principale e dai [subagent](/docs/it/sub-agents), come un fan-out di ricerca parallelo, contano rispetto allo stesso limite. Il limite richiede Claude Code v2.1.212 o successivo.

724 

725Mentre una sessione è al limite, le ricerche appaiono nella conversazione come chiamate che non hanno fatto nulla. Claude riceve un avviso che gli dice di continuare con le informazioni già raccolte e, se ha bisogno di più ricerche, di chiederti di aumentare il limite.

726 

727Per ottenere più ricerche, aumenta il limite, attendi che il limite si ricarichi o avvia una nuova conversazione:

720 728 

721Imposta la variabile di ambiente [`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/it/env-vars) per modificare il limite; accetta un numero intero positivo, quindi il limite può essere aumentato ma non disattivato. L'esecuzione di [`/clear`](/docs/it/commands#all-commands) ripristina il conteggio. Se il lavoro che può ancora generare [subagents](/docs/it/sub-agents) sopravvive alla cancellazione, come un flusso di lavoro in esecuzione, il conteggio viene trasferito.729* **Aumenta il limite**: imposta la variabile d'ambiente [`CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`](/docs/it/env-vars#variables) su un numero intero positivo, come `500`. Il limite può essere aumentato ma non disattivato.

730* **Attendi la ricarica**: su Claude Code v2.1.290 o successivo, il limite di una sessione interattiva nel terminale si ricarica di circa 100 chiamate all'ora. Per modificare la velocità, imposta [`CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR`](/docs/it/env-vars#variables) su un numero di chiamate all'ora, come `50`.

731* **Avvia una nuova conversazione**: anche l'esecuzione di [`/clear`](/docs/it/commands#all-commands) nel prompt di Claude Code ripristina il conteggio. Se il lavoro che può ancora generare subagent sopravvive alla cancellazione, come un workflow in esecuzione, il conteggio viene invece trasferito.

722 732 

723<h2 id="write-tool-behavior">733<h2 id="write-tool-behavior">

724 Comportamento dello strumento Write734 Comportamento dello strumento Write

vs-code.md +1 −0

Details

623* **Risposte di Claude**: l'estensione annuncia ogni risposta una sola volta, quando è completa, e rimane silenziosa mentre il testo viene trasmesso. Il lettore di schermo legge i blocchi di codice come un riepilogo del conteggio delle righe, legge i link in base alla loro etichetta e legge le tabelle cella per cella; la risposta completa rimane leggibile nella trascrizione.623* **Risposte di Claude**: l'estensione annuncia ogni risposta una sola volta, quando è completa, e rimane silenziosa mentre il testo viene trasmesso. Il lettore di schermo legge i blocchi di codice come un riepilogo del conteggio delle righe, legge i link in base alla loro etichetta e legge le tabelle cella per cella; la risposta completa rimane leggibile nella trascrizione.

624* **Richieste di autorizzazione e domande**: l'estensione annuncia una richiesta quando appare il suo prompt di autorizzazione, indicando lo strumento che Claude vuole utilizzare. Annuncia allo stesso modo quando Claude ti pone una domanda e quando Claude termina un piano e attende la tua revisione.624* **Richieste di autorizzazione e domande**: l'estensione annuncia una richiesta quando appare il suo prompt di autorizzazione, indicando lo strumento che Claude vuole utilizzare. Annuncia allo stesso modo quando Claude ti pone una domanda e quando Claude termina un piano e attende la tua revisione.

625* **Cambiamenti di stato**: l'estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.625* **Cambiamenti di stato**: l'estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.

626* **Messaggi in coda**: quando invii un messaggio mentre Claude sta lavorando, l'estensione annuncia "Message queued." per quel messaggio.

626* **Errori e prompt del modello**: l'estensione annuncia gli errori nella conversazione e annuncia quando appare il [prompt di consenso per i crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits) o il [prompt di richiesta contrassegnata](/docs/it/model-config#ask-before-switching).627* **Errori e prompt del modello**: l'estensione annuncia gli errori nella conversazione e annuncia quando appare il [prompt di consenso per i crediti di utilizzo](/docs/it/model-config#fable-and-usage-credits) o il [prompt di richiesta contrassegnata](/docs/it/model-config#ask-before-switching).

627 628 

628Mentre Claude lavora, il lettore di schermo legge un'etichetta di testo al posto dell'animazione dello spinner di avanzamento.629Mentre Claude lavora, il lettore di schermo legge un'etichetta di testo al posto dell'animazione dello spinner di avanzamento.

Details

12 12 

13Una sessione cloud esegue Claude Code su un'infrastruttura cloud invece che sulla tua macchina, gestita da Anthropic per impostazione predefinita. Questo quickstart ne avvia una da [claude.ai/code](https://claude.ai/code) nel tuo browser. Puoi anche avviarne una dall'app mobile Claude, dall'app Desktop o dal tuo terminale con `claude --cloud`.13Una sessione cloud esegue Claude Code su un'infrastruttura cloud invece che sulla tua macchina, gestita da Anthropic per impostazione predefinita. Questo quickstart ne avvia una da [claude.ai/code](https://claude.ai/code) nel tuo browser. Puoi anche avviarne una dall'app mobile Claude, dall'app Desktop o dal tuo terminale con `claude --cloud`.

14 14 

15Avrai bisogno di un repository GitHub per [iniziare](#connect-github). Claude lo clona in una macchina virtuale isolata, apporta modifiche e spinge un ramo per te da rivedere. Le sessioni persistono tra i dispositivi, quindi un'attività che inizi sul tuo laptop è pronta per essere rivista dal tuo telefono in seguito.15Avrai bisogno di un repository GitHub per [iniziare](#connect-github). Claude lo clona in una macchina virtuale isolata, apporta modifiche ed esegue il push di un branch che potrai rivedere. Le sessioni persistono tra i dispositivi, quindi un'attività che inizi sul tuo laptop è pronta per essere rivista dal tuo telefono in seguito. Ogni sessione viene conteggiata nei limiti di utilizzo del tuo piano insieme al resto del tuo utilizzo di Claude e Claude Code, e non è previsto alcun costo separato per la VM cloud.

16 16 

17Le sessioni cloud funzionano bene per:17Le sessioni cloud funzionano bene per:

18 18