SpyBara
Go Premium

Documentation 2026-11-08 22:58 UTC to 2026-11-09 23:02 UTC

35 files changed +453 −121. View all changes and history on the product overview
2026
Thu 12 21:00 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57

advisor.md +4 −3

Details

98| Opus 4.7 o Opus 4.8 | Fable, Opus 4.7 o successivo, Sonnet 5.5 |98| Opus 4.7 o Opus 4.8 | Fable, Opus 4.7 o successivo, Sonnet 5.5 |

99| Sonnet 5.5 | Fable, Opus 5 o successivo, Sonnet 5.5 |99| Sonnet 5.5 | Fable, Opus 5 o successivo, Sonnet 5.5 |

100| Opus 5 o Opus 5.5 | Fable, Opus 5 o successivo |100| Opus 5 o Opus 5.5 | Fable, Opus 5 o successivo |

101| Fable 5 | Fable 5.1 o Fable 5 |101| Fable 5 | Fable 5.2, Fable 5.1 o Fable 5 |

102| Fable 5.1 | Fable 5.1 |102| Fable 5.1 | Fable 5.2 o Fable 5.1 |

103| Fable 5.2 | Fable 5.2 |

103 104 

104Fable 5.1 richiede Claude Code v2.1.257 o successivo. I modelli Fable richiedono [accesso a Fable](https://code.claude.com/docs/it/model-config.md#work-with-fable). Sonnet 5.5 come advisor per un modello principale Opus 4.7 o Opus 4.8 richiede Claude Code v2.1.287 o successivo. Haiku 5.5 come modello principale o come advisor richiede Claude Code v2.1.293 o successivo.105Fable 5.2 richiede Claude Code v2.1.321 o successivo e Fable 5.1 richiede v2.1.257 o successivo. I modelli Fable richiedono [accesso a Fable](https://code.claude.com/docs/it/model-config.md#work-with-fable). Sonnet 5.5 come advisor per un modello principale Opus 4.7 o Opus 4.8 richiede Claude Code v2.1.287 o successivo. Haiku 5.5 come modello principale o come advisor richiede Claude Code v2.1.293 o successivo.

105 106 

106Imposta l'advisor come `fable`, `opus`, o `sonnet`. Questi alias si risolvono nella [versione predefinita integrata](https://code.claude.com/docs/it/model-config.md#model-aliases) di Claude Code per ogni famiglia di modelli, che avanza con le nuove versioni di Claude Code. Puoi anche passare un ID modello completo come `claude-opus-5-5` o `claude-haiku-5-5`. Haiku 4.5 può chiamare l'advisor ma non può agire come tale.107Imposta l'advisor come `fable`, `opus`, o `sonnet`. Questi alias si risolvono nella [versione predefinita integrata](https://code.claude.com/docs/it/model-config.md#model-aliases) di Claude Code per ogni famiglia di modelli, che avanza con le nuove versioni di Claude Code. Puoi anche passare un ID modello completo come `claude-opus-5-5` o `claude-haiku-5-5`. Haiku 4.5 può chiamare l'advisor ma non può agire come tale.

107 108 

Details

56 56 

57### Esempio di strumento meteo57### Esempio di strumento meteo

58 58 

59Questo esempio definisce uno strumento `get_temperature` e lo avvolge in un server MCP, senza passare il server a `query`. Per eseguire lo strumento, consulta [Chiamare uno strumento personalizzato](#call-a-custom-tool) di seguito.59Questo esempio definisce uno strumento `get_temperature` e lo avvolge in un server MCP, senza passare il server a `query`. Per eseguire lo strumento, consulta [Chiamare uno strumento personalizzato](#call-a-custom-tool).

60 60 

61```python Python theme={null}61```python Python theme={null}

62from typing import Annotated, Any62from typing import Annotated, Any


148* **TypeScript**: aggiungi `.optional()` al campo Zod.148* **TypeScript**: aggiungi `.optional()` al campo Zod.

149* **Python**: lo schema dict richiede ogni chiave. Usa la forma JSON Schema, lascia il parametro fuori da `required` e leggilo con `args.get()`. Per uno schema tipizzato con chiavi opzionali, consulta [classe TypedDict](https://code.claude.com/docs/it/agent-sdk/python.md#input-schema-options).149* **Python**: lo schema dict richiede ogni chiave. Usa la forma JSON Schema, lascia il parametro fuori da `required` e leggilo con `args.get()`. Per uno schema tipizzato con chiavi opzionali, consulta [classe TypedDict](https://code.claude.com/docs/it/agent-sdk/python.md#input-schema-options).

150 150 

151Lo strumento [`get_precipitation_chance` di seguito](#add-more-tools) mostra entrambi i modelli.151Lo [strumento `get_precipitation_chance`](#add-more-tools) mostra entrambi i modelli.

152 152 

153### Chiamare uno strumento personalizzato153### Chiamare uno strumento personalizzato

154 154 

155Passa il server MCP che hai creato a `query` tramite l'opzione `mcpServers` ed elenca il [nome completamente qualificato](https://code.claude.com/docs/it/agent-sdk/mcp.md#tool-naming-convention) di ogni strumento in `allowedTools`, in modo che lo strumento venga eseguito senza una richiesta di permesso. Quel nome è `mcp__{server_name}__{tool_name}`, dove `{server_name}` è la chiave che assegni al server in `mcpServers`. Se la chiave contiene caratteri come `.` o spazi, sostituiscili con `_` quando scrivi `{server_name}`.155Per chiamare uno strumento personalizzato, segui questi passaggi:

156 

1571. Passa il server MCP che hai creato a `query` tramite l'opzione `mcpServers`.

1582. Elenca il [nome completamente qualificato](https://code.claude.com/docs/it/agent-sdk/mcp.md#tool-naming-convention) dello strumento in `allowedTools` per [pre-approvare](https://code.claude.com/docs/it/agent-sdk/permissions.md#allow-and-deny-rules) le sue chiamate. Quel nome segue la convenzione `mcp__{server_name}__{tool_name}`, dove `{server_name}` è la chiave che assegni al server in `mcpServers`. Se la chiave contiene caratteri come `.` o spazi, sostituiscili con `_` quando scrivi `{server_name}`.

156 159 

157Questi snippet riutilizzano il `weatherServer` dall'[esempio di strumento meteo](#weather-tool-example) per chiedere a Claude qual è il meteo in una posizione specifica.160Questi snippet riutilizzano il `weatherServer` dall'[esempio di strumento meteo](#weather-tool-example) per chiedere a Claude qual è il meteo in una posizione specifica.

158 161 


329| :- | :- | :- |332| :- | :- | :- |

330| `readOnlyHint` | `false` | Lo strumento non modifica il suo ambiente. Controlla se lo strumento può essere chiamato in parallelo con altri strumenti di sola lettura. |333| `readOnlyHint` | `false` | Lo strumento non modifica il suo ambiente. Controlla se lo strumento può essere chiamato in parallelo con altri strumenti di sola lettura. |

331| `destructiveHint` | `true` | Lo strumento può eseguire aggiornamenti distruttivi. Impostalo esplicitamente su `true` per qualsiasi strumento che [contrassegni come `always_ask`](#require-approval-for-specific-tools). |334| `destructiveHint` | `true` | Lo strumento può eseguire aggiornamenti distruttivi. Impostalo esplicitamente su `true` per qualsiasi strumento che [contrassegni come `always_ask`](#require-approval-for-specific-tools). |

332| `idempotentHint` | `false` | Le chiamate ripetute con gli stessi argomenti non hanno effetti aggiuntivi. Solo informativo. |335| `idempotentHint` | `false` | Le chiamate ripetute con gli stessi argomenti non hanno effetti aggiuntivi. |

333| `openWorldHint` | `true` | Lo strumento raggiunge sistemi al di fuori del vostro processo. Solo informativo. |336| `openWorldHint` | `true` | Lo strumento raggiunge sistemi al di fuori del tuo processo. |

334 337 

335Le annotazioni sono metadati, non applicazione. Uno strumento contrassegnato con `readOnlyHint: true` può comunque scrivere su disco se è quello che fa il handler. Mantenete l'annotazione accurata rispetto al handler.338Le annotazioni sono metadati, non applicazione. Uno strumento contrassegnato con `readOnlyHint: true` può comunque scrivere su disco se è quello che fa il handler. Mantenete l'annotazione accurata rispetto al handler.

336 339 


373 376 

374### Configurare i tool consentiti377### Configurare i tool consentiti

375 378 

376L'opzione `tools` e gli elenchi consentiti/non consentiti influiscono su due livelli: la disponibilità, che controlla se un tool appare nel contesto di Claude, e il permesso, che controlla se una chiamata viene approvata una volta che Claude la tenta. `tools` e le voci `disallowedTools` con nome semplice modificano la disponibilità. `allowedTools` e le regole `disallowedTools` con ambito modificano il permesso. Se si nomina uno dei [tool di tracciamento delle attività](https://code.claude.com/docs/it/agent-sdk/todo-tracking.md#model-availability) in `allowedTools`, Claude Code abilita anche quei tool per la sessione.379Con le opzioni `tools`, `allowedTools` e `disallowedTools` controlli due livelli:

380 

381* **Disponibilità**: se uno strumento appare nel contesto di Claude. Per modificarla, usa l'opzione `tools` oppure elenca in `disallowedTools` il nome semplice di uno strumento integrato, come `"Bash"`.

382* **Permesso**: se Claude Code approva una chiamata quando Claude la effettua. Per modificarlo, usa `allowedTools` oppure una regola `disallowedTools` con ambito, come `"Bash(rm *)"`.

377 383 

378| Opzione | Livello | Effetto |384| Opzione | Livello | Effetto |

379| :- | :- | :- |385| :- | :- | :- |

380| `tools: ["Read", "Grep"]` | Disponibilità | Solo i tool integrati elencati sono nel contesto di Claude. I tool integrati non elencati vengono rimossi. I tool MCP non sono interessati. |386| `tools: ["Read", "Grep"]` | Disponibilità | Solo i tool integrati elencati sono nel contesto di Claude. I tool integrati non elencati vengono rimossi. I tool MCP non sono interessati. |

381| `tools: []` | Disponibilità | Tutti i tool integrati vengono rimossi. Claude può utilizzare solo i vostri tool MCP. |387| `tools: []` | Disponibilità | Tutti i tool integrati vengono rimossi. Claude può utilizzare solo i vostri tool MCP. |

382| tool consentiti | Permesso | I tool elencati vengono eseguiti senza un prompt di permesso. Gli altri tool non elencati rimangono disponibili; le chiamate passano attraverso il [flusso di permesso](https://code.claude.com/docs/it/agent-sdk/permissions.md). |388| strumenti consentiti | Permesso | Gli strumenti elencati sono pre-approvati, a eccezione delle [chiamate che nessuna regola di autorizzazione approva](https://code.claude.com/docs/it/agent-sdk/permissions.md#calls-an-allow-rule-never-approves). Le chiamate agli strumenti che lasci fuori dall'elenco passano attraverso il [flusso di permesso](https://code.claude.com/docs/it/agent-sdk/permissions.md). |

383| tool non consentiti | Entrambi | Un nome di tool semplice come `"Bash"` rimuove il tool dal contesto di Claude, come se lo ometteste da `tools`. Una regola con ambito come `"Bash(rm *)"` lascia il tool nel contesto e nega solo le chiamate corrispondenti [come scritto](https://code.claude.com/docs/it/permissions.md#bash-rule-limits). |389| strumenti non consentiti | Entrambi | Un nome semplice di uno strumento integrato come `"Bash"` rimuove lo strumento dal contesto di Claude. Una regola con ambito come `"Bash(rm *)"` lascia lo strumento nel contesto e nega le chiamate che le corrispondono [come scritta](https://code.claude.com/docs/it/permissions.md#bash-rule-limits). |

384 390 

385Per rimuovere completamente un tool integrato, omettetelo da `tools` o elencate il suo nome semplice in `disallowedTools` (Python: `disallowed_tools`); entrambi mantengono il tool fuori dal contesto in modo che Claude non lo tenti mai. Una regola `disallowedTools` con ambito blocca le chiamate corrispondenti ma lascia il tool visibile, quindi Claude potrebbe sprecare un turno tentandolo. Vedere [Configurare i permessi](https://code.claude.com/docs/it/agent-sdk/permissions.md) per l'ordine di valutazione completo.391Per rimuovere uno strumento integrato dal contesto di Claude, omettilo da `tools` oppure elenca il suo nome semplice in `disallowedTools` (TypeScript) o `disallowed_tools` (Python). Per l'ordine di valutazione completo, consulta [Configurare i permessi](https://code.claude.com/docs/it/agent-sdk/permissions.md#how-permissions-are-evaluated).

386 392 

387### Richiedere l'approvazione per strumenti specifici393### Richiedere l'approvazione per strumenti specifici

388 394 


637 643 

638## Restituire dati strutturati644## Restituire dati strutturati

639 645 

640`structuredContent` è un oggetto JSON opzionale sul risultato, separato dall'array `content`. Utilizzarlo per restituire valori grezzi che Claude può leggere come campi esatti invece di analizzarli da una stringa di testo o da un'immagine.646`structuredContent` è un oggetto JSON opzionale sul risultato, separato dall'array `content`. Usalo per restituire valori grezzi che Claude può leggere come campi esatti invece di analizzarli da una stringa di testo o da un'immagine. Per gli handler Python, consulta [Contenuto strutturato in Python](#structured-content-in-python).

641 647 

642Quando `structuredContent` è impostato, Claude riceve il JSON più eventuali blocchi di immagine o risorsa da `content`. I blocchi di testo in `content` non vengono inoltrati, poiché si presume che duplichino i dati strutturati. L'esempio seguente renderizza un grafico come blocco di immagine e restituisce i punti dati dietro di esso in `structuredContent` dallo stesso handler. Nel frammento, `chartPngBuffer` è un `Buffer` che contiene i byte PNG renderizzati.648Quando un handler TypeScript `tool()` imposta `structuredContent`, Claude riceve il JSON più i blocchi di immagine e di risorsa in `content`, mentre i blocchi di testo in `content` non raggiungono Claude. L'esempio seguente renderizza un grafico come blocco di immagine e restituisce i punti dati dietro di esso in `structuredContent` dallo stesso handler. Nel frammento, `chartPngBuffer` è un `Buffer` che contiene i byte PNG renderizzati.

643 649 

644```typescript TypeScript theme={null}650```typescript TypeScript theme={null}

645return {651return {

Details

205 205 

206### Auto-approvazione con allowedTools206### Auto-approvazione con allowedTools

207 207 

208Utilizzare `allowedTools` per approvare automaticamente strumenti MCP specifici in modo che Claude possa utilizzarli senza un prompt di autorizzazione:208Usa `allowedTools` per approvare automaticamente strumenti MCP specifici:

209 209 

210```typescript TypeScript hidelines={1,-1} theme={null}210```typescript TypeScript hidelines={1,-1} theme={null}

211const _ = {211const _ = {

Details

18 18 

19**1. Hook**19**1. Hook**

20 20 

21Esegue gli [hook](https://code.claude.com/docs/it/agent-sdk/hooks.md). Un hook può negare la chiamata completamente o lasciarla passare. Un hook che restituisce `allow` non salta le regole deny e ask riportate di seguito; quelle vengono valutate indipendentemente dal risultato dell'hook.21Esegue gli [hook](https://code.claude.com/docs/it/agent-sdk/hooks.md). Un hook può negare la chiamata completamente o lasciarla passare. Un hook che restituisce `allow` non salta i passaggi delle regole deny e ask, che vengono valutati indipendentemente dal risultato dell'hook.

22 22 

23Un hook `PreToolUse` che restituisce `allow` inoltre non può approvare un comando `rm` o `rmdir` la cui destinazione Claude Code riconosce come un [percorso critico](https://code.claude.com/docs/it/permission-modes.md#critical-paths), come `rm -rf ~`. Per sapere cosa fa quell'`allow` nel plan mode, consulta [Approvazioni degli hook nel plan mode](https://code.claude.com/docs/it/permissions.md#hook-approvals-in-plan-mode).23Un hook `PreToolUse` che restituisce `allow` inoltre non può approvare un comando `rm` o `rmdir` la cui destinazione Claude Code riconosce come un [percorso critico](https://code.claude.com/docs/it/permission-modes.md#critical-paths), come `rm -rf ~`. Per sapere cosa fa quell'`allow` nel plan mode, consulta [Approvazioni degli hook nel plan mode](https://code.claude.com/docs/it/permissions.md#hook-approvals-in-plan-mode).

24 24 


58 58 

59**6. Callback canUseTool**59**6. Callback canUseTool**

60 60 

61Se la chiamata non è stata risolta da nessuno dei passaggi precedenti, chiamare il tuo [callback `canUseTool`](https://code.claude.com/docs/it/agent-sdk/user-input) per una decisione. In modalità `dontAsk`, questo passaggio viene saltato e lo strumento viene negato, anche se un [mod](https://code.claude.com/docs/it/plugins/mods/overview.md) che hai installato può comunque approvare [alcune di queste chiamate](https://code.claude.com/docs/it/permissions.md#precedence-among-rules-hooks-and-mods).61Se la chiamata non è stata risolta da nessuno dei passaggi precedenti, chiama il tuo [callback `canUseTool`](https://code.claude.com/docs/it/agent-sdk/user-input) per una decisione. In modalità `dontAsk`, questo passaggio viene saltato e lo strumento viene negato, anche se un [mod](https://code.claude.com/docs/it/plugins/mods/overview.md) che hai installato può comunque approvare [alcune di queste chiamate](https://code.claude.com/docs/it/permissions.md#precedence-among-rules-hooks-and-mods).

62 62 

63Nell'SDK TypeScript, se impostate [`permissionPrompts: 'none'`](https://code.claude.com/docs/it/agent-sdk/typescript#options), il vostro callback non viene chiamato in questo passaggio. Un hook [`PermissionRequest`](https://code.claude.com/docs/it/hooks#permissionrequest) ha ancora la possibilità di decidere, e se non lo fa, Claude Code nega la chiamata. L'opzione richiede Claude Code v2.1.259 o successivo.63Nell'SDK TypeScript, se impostate [`permissionPrompts: 'none'`](https://code.claude.com/docs/it/agent-sdk/typescript#options), il vostro callback non viene chiamato in questo passaggio. Un hook [`PermissionRequest`](https://code.claude.com/docs/it/hooks#permissionrequest) ha ancora la possibilità di decidere, e se non lo fa, Claude Code nega la chiamata. L'opzione richiede Claude Code v2.1.259 o successivo.

64 64 


80 80 

81## Regole allow e deny81## Regole allow e deny

82 82 

83`allowed_tools` e `disallowed_tools` (TypeScript: `allowedTools` / `disallowedTools`) aggiungono voci agli elenchi di regole allow e deny nel flusso di valutazione sopra descritto. Se nominate uno degli [strumenti di tracciamento delle attività](https://code.claude.com/docs/it/agent-sdk/todo-tracking.md#model-availability) in `allowed_tools`, Claude Code abilita anche quegli strumenti per la sessione. Qualsiasi altro strumento non elencato in `allowed_tools` è ancora disponibile per Claude, e una chiamata ad esso che necessita di approvazione passa attraverso la modalità di autorizzazione. Le regole deny si comportano diversamente a seconda che nominino uno strumento o limitino un modello all'interno di uno.83Quando imposti `allowedTools` e `disallowedTools` (TypeScript) oppure `allowed_tools` e `disallowed_tools` (Python), Claude Code aggiunge le loro voci agli elenchi di regole allow e deny nel [flusso di valutazione dei permessi](#how-permissions-are-evaluated). Qualsiasi altro strumento non elencato in `allowed_tools` è ancora disponibile per Claude, e una chiamata ad esso che necessita di approvazione passa alla modalità di permesso.

84 84 

85| Opzione | Effetto |85| Opzione | Effetto |

86| :- | :- |86| :- | :- |

87| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` sono approvati automaticamente, a parte le [letture da percorsi di rete](https://code.claude.com/docs/it/permissions.md#network-paths). Gli altri strumenti non elencati qui esistono ancora, e le chiamate ad essi che necessitano di approvazione passano alla modalità di permesso e a `canUseTool`. |87| `allowed_tools=["Read", "Grep"]` | `Read` e `Grep` sono approvati automaticamente, a parte le [letture da percorsi di rete](https://code.claude.com/docs/it/permissions.md#network-paths). Gli altri strumenti non elencati qui esistono ancora, e le chiamate ad essi che necessitano di approvazione passano alla modalità di permesso e a `canUseTool`. |

88| `disallowed_tools=["Bash"]` | La definizione dello strumento `Bash` viene rimossa dalla richiesta. Claude non vede lo strumento e non può tentarlo. |88| `disallowed_tools=["Bash"]` | La definizione dello strumento `Bash` viene rimossa dalla richiesta. |

89| `disallowed_tools=["Bash(rm *)"]` | `Bash` rimane disponibile. Le chiamate che corrispondono a `rm *` [come scritto](https://code.claude.com/docs/it/permissions.md#bash-rule-limits) vengono negate in ogni modalità di autorizzazione, inclusa `bypassPermissions`. Le altre chiamate `Bash`, incluso `/bin/rm`, passano attraverso la modalità di autorizzazione. |89| `disallowed_tools=["Bash(rm *)"]` | `Bash` rimane disponibile. Le chiamate che corrispondono a `rm *` [come scritto](https://code.claude.com/docs/it/permissions.md#bash-rule-limits) vengono negate in ogni modalità di autorizzazione, inclusa `bypassPermissions`. Le altre chiamate `Bash`, incluso `/bin/rm`, passano attraverso la modalità di autorizzazione. |

90| `disallowed_tools=["*"]` | Ogni definizione di strumento viene rimossa dalla richiesta. I glob dei nomi degli strumenti sono supportati nelle regole deny: `"*"` corrisponde a ogni strumento e `"mcp__*"` corrisponde a ogni strumento MCP su tutti i server. |90| `disallowed_tools=["*"]` | I glob dei nomi degli strumenti sono supportati nelle regole deny: `"*"` corrisponde a ogni strumento e `"mcp__*"` corrisponde a ogni strumento MCP su tutti i server. |

91 91 

92Le regole allow accettano glob dei nomi degli strumenti solo dopo un prefisso letterale `mcp__<server>__`. Il segmento del server deve essere privo di glob in modo che la regola nomini un server specifico che hai configurato: `mcp__puppeteer__*` corrisponde a ogni strumento dal server `puppeteer`, e `mcp__github__get_*` corrisponde ai suoi strumenti `get_`. Una voce non ancorata come `allowed_tools=["*"]` o `allowed_tools=["mcp__*"]` viene ignorata e non approva automaticamente nulla.92Le regole allow accettano glob dei nomi degli strumenti solo dopo un prefisso letterale `mcp__<server>__`. Il segmento del server deve essere privo di glob in modo che la regola nomini un server specifico che hai configurato: `mcp__puppeteer__*` corrisponde a ogni strumento dal server `puppeteer`, e `mcp__github__get_*` corrisponde ai suoi strumenti `get_`. Una voce non ancorata come `allowed_tools=["*"]` o `allowed_tools=["mcp__*"]` viene ignorata e non approva automaticamente nulla.

93 93 

Details

2787 2787 

2788Esegue una sorgente in background e fornisce 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 ed emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`.2788Esegue una sorgente in background e fornisce 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 ed emette un evento per frame di testo. Fornisci esattamente uno tra `command` o `ws`.

2789 2789 

2790Quando Monitor esegue un comando, segue le stesse regole di permesso di Bash; un monitoraggio WebSocket richiede l'approvazione separatamente. L'origine `ws` richiede Claude Code v2.1.195 o successivo. Vedi il [riferimento dello strumento Monitor](https://code.claude.com/docs/it/tools-reference.md#monitor-tool) per il comportamento e la disponibilità del provider.2790L'origine `ws` richiede Claude Code v2.1.195 o successivo. Quando Monitor esegue un comando, segue le stesse regole di permesso di Bash. Vedi il [riferimento dello strumento Monitor](https://code.claude.com/docs/it/tools-reference.md#monitor-tool) per i permessi WebSocket, il comportamento e la disponibilità del provider.

2791 2791 

2792**Input:**2792**Input:**

2793 2793 

Details

3389 3389 

3390Esegue 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.3390Esegue 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.

3391 3391 

3392`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.3392`timeout_ms` è la scadenza del watch in millisecondi:

3393 3393 

3394Il tipo esportato contrassegna `timeout_ms` come obbligatorio perché lo schema riempie il valore predefinito; una chiamata che lo omette convalida.3394* **Valore predefinito e limiti**: il valore predefinito è 300000 e accetta valori fino a 3600000. La scadenza effettiva è al massimo 1800000, cioè 30 minuti, quindi un valore accettato più grande viene accorciato a quello

3395* **Alla scadenza**: il watch termina e Claude riceve un avviso in modo che possa avviare un nuovo watch se ne ha ancora bisogno

3396* **Obbligatorio nel tipo**: il tipo esportato contrassegna `timeout_ms` come obbligatorio perché lo schema riempie il valore predefinito; una chiamata che lo omette viene convalidata

3395 3397 

3396Quando Monitor esegue un comando, segue le stesse regole di permesso di Bash; un watch WebSocket richiede l'approvazione separatamente. Vedi il [riferimento del tool Monitor](https://code.claude.com/docs/it/tools-reference.md#monitor-tool) per il comportamento e la disponibilità del provider.3398Quando Monitor esegue un comando, segue le stesse regole di permesso di Bash. Vedi il [riferimento dello strumento Monitor](https://code.claude.com/docs/it/tools-reference.md#monitor-tool) per i permessi WebSocket, il comportamento e la disponibilità del provider.

3397 3399 

3398### TaskOutput3400### TaskOutput

3399 3401 

Details

433 433 

434### Modifica il modello e lo sforzo434### Modifica il modello e lo sforzo

435 435 

436Lo [sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) è il controllo principale su quanto a lungo ragiona Claude, e sostituisce la maggior parte di ciò che in passato si faceva con la formulazione del prompt. Claude Opus 5.5, Sonnet 5.5 e Haiku 5.5 usano `medium` per impostazione predefinita, che è più che sufficiente per il lavoro quotidiano sulle funzionalità con un ambito chiaro. I casi in cui cambiarlo, con `/effort` nella sessione:436Lo [sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) è il controllo principale su quanto a lungo ragiona Claude, e sostituisce la maggior parte di ciò che in passato si faceva con la formulazione del prompt. Claude Fable 5.2, Opus 5.5, Sonnet 5.5 e Haiku 5.5 usano `medium` per impostazione predefinita, che è più che sufficiente per il lavoro quotidiano sulle funzionalità con un ambito chiaro. I casi in cui cambiarlo, con `/effort` nella sessione:

437 437 

438* Alzalo con `/effort high` o `/effort xhigh` quando la riuscita dipende da casi facili da trascurare. Pensa a un bug in codice che non hai scritto tu, a un test instabile o a una modifica dello schema in cui Claude deve trovare ogni lettore della vecchia struttura. Claude allora controlla più casi limite e verifica una parte maggiore del suo lavoro prima di rispondere, ed è lì che vanno il tempo e i token in più.438* Alzalo con `/effort high` o `/effort xhigh` quando la riuscita dipende da casi facili da trascurare. Pensa a un bug in codice che non hai scritto tu, a un test instabile o a una modifica dello schema in cui Claude deve trovare ogni lettore della vecchia struttura. Claude allora controlla più casi limite e verifica una parte maggiore del suo lavoro prima di rispondere, ed è lì che vanno il tempo e i token in più.

439* Abbassalo con `/effort low` quando procedi rapidamente avanti e indietro e rivedi comunque ogni risultato: brainstorming, una prima bozza, una ridenominazione su alcuni file. Claude ti dà un punto di partenza prima e, dato che guidi ogni passaggio, la riflessione aggiuntiva non avrebbe cambiato molto oltre all'attesa.439* Abbassalo con `/effort low` quando procedi rapidamente avanti e indietro e rivedi comunque ogni risultato: brainstorming, una prima bozza, una ridenominazione su alcuni file. Claude ti dà un punto di partenza prima e, dato che guidi ogni passaggio, la riflessione aggiuntiva non avrebbe cambiato molto oltre all'attesa.

440* Riserva `max` a un problema difficile che vuoi che Claude risolva senza di te, come la ricerca di una vulnerabilità di sicurezza. Nelle attività ordinarie tende a ragionare troppo, quindi paghi di più per una risposta che potrebbe non essere migliore di quella che avresti ottenuto con `high`.440* Riserva `max` a un problema difficile che vuoi che Claude risolva senza di te, come la ricerca di una vulnerabilità di sicurezza. Nelle attività ordinarie tende a ragionare troppo, quindi paghi di più per una risposta che potrebbe non essere migliore di quella che avresti ottenuto con `high`.

441* Quando ne ha bisogno solo il messaggio successivo, come una domanda complicata nel mezzo di un lavoro altrimenti di routine, inserisci [`ultrathink`](https://code.claude.com/docs/it/model-config#use-ultrathink-for-one-off-deep-reasoning) in quel prompt invece di cambiare l'impostazione.441* Quando ne ha bisogno solo il messaggio successivo, come una domanda complicata nel mezzo di un lavoro altrimenti di routine, inserisci [`ultrathink`](https://code.claude.com/docs/it/model-config#use-ultrathink-for-one-off-deep-reasoning) in quel prompt invece di cambiare l'impostazione.

442 442 

443Per quanto riguarda il modello, Opus 5.5 predefinito gestisce bene la maggior parte del lavoro di programmazione e Sonnet costa meno per il lavoro di routine. [Claude Fable 5.1](https://code.claude.com/docs/it/model-config.md#work-with-fable) è disponibile quando lo selezioni esplicitamente con `/model fable`, e Haiku è adatto ai subagent che svolgono compiti semplici. [Configurazione del modello](https://code.claude.com/docs/it/model-config.md) contiene l'elenco completo per piano e provider.443Per quanto riguarda il modello, Opus 5.5 predefinito gestisce bene la maggior parte del lavoro di programmazione e Sonnet costa meno per il lavoro di routine. Per usare [Claude Fable 5.2](https://code.claude.com/docs/it/model-config.md#work-with-fable), esegui `/model fable`. Haiku è adatto ai subagent che svolgono compiti semplici. [Configurazione del modello](https://code.claude.com/docs/it/model-config.md) contiene l'elenco completo per piano e provider.

444 444 

445### Sappi quanto costano i subagent445### Sappi quanto costano i subagent

446 446 

Details

172 172 

173Un avvio riuscito non convalida il percorso di inferenza, perché le credenziali di istanza di Amazon Bedrock e di Google Cloud's Agent Platform vengono risolte alla prima richiesta, non all'avvio.173Un avvio riuscito non convalida il percorso di inferenza, perché le credenziali di istanza di Amazon Bedrock e di Google Cloud's Agent Platform vengono risolte alla prima richiesta, non all'avvio.

174 174 

175Controlla stderr per la sequenza di avvio. Le righe di log usano il formato `[gateway] <timestamp> <level> <message>`, gli eventi di audit sono JSON su una singola riga con un campo `evt` e un banner di avvio, omesso qui sotto, viene stampato tra le righe di migrazione e quella di ascolto. Un database nuovo stampa una riga `migration N applied` per ciascuna migrazione dello schema; un database già migrato non ne stampa nessuna. Dovresti vedere, in ordine:175Controlla stderr per la sequenza di avvio. Per impostazione predefinita, le righe di log usano il formato `[gateway] <timestamp> <level> <message>` e un banner di avvio, omesso qui sotto, viene stampato tra le righe di migrazione e quella di ascolto. Gli eventi di audit sono JSON su una singola riga con un campo `evt`. Un database nuovo stampa una riga `migration N applied` per ciascuna migrazione dello schema; un database già migrato non ne stampa nessuna. Dovresti vedere, in ordine:

176 176 

177```text theme={null}177```text theme={null}

178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}

Details

28 28 

29**Sezioni facoltative:**29**Sezioni facoltative:**

30 30 

31* [`login_notice`](#login_notice): un avviso che gli sviluppatori vedono quando accedono

31* [`admin`](#admin): autenticazione dell'API Admin e conservazione dei limiti di spesa32* [`admin`](#admin): autenticazione dell'API Admin e conservazione dei limiti di spesa

32* [`enforcement`](#enforcement): comportamento fail-open o fail-closed dei limiti di spesa33* [`enforcement`](#enforcement): comportamento fail-open o fail-closed dei limiti di spesa

33* [`pricing`](#pricing): tariffe contrattuali e un moltiplicatore per il misuratore di spesa e per le cifre di costo che gli sviluppatori vedono34* [`pricing`](#pricing): tariffe contrattuali e un moltiplicatore per il misuratore di spesa e per le cifre di costo che gli sviluppatori vedono


847 848 

848## Sezioni facoltative849## Sezioni facoltative

849 850 

851### `login_notice`

852 

853Per mostrare agli sviluppatori un avviso quando accedono, imposta la chiave di primo livello `login_notice` sul testo dell'avviso, fino a 500 caratteri. Questo esempio indica a chi è destinato il gateway e dove chiedere l'accesso:

854 

855```yaml theme={null}

856login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

857```

858 

859Gli sviluppatori vedono il testo sotto `Notice from <gateway hostname>` nella pagina di verifica del gateway nel browser e nella schermata di accesso interattiva nel terminale. Le interruzioni di riga nel testo diventano spazi. L'avviso compare prima dell'accesso, quindi chiunque possa raggiungere il gateway può leggerlo.

860 

861Richiede Claude Code v2.1.319 o successiva sul server del gateway e anche sul computer dello sviluppatore per la schermata del terminale. Un gateway precedente si rifiuta di avviarsi quando trova la chiave. Aggiorna ogni replica prima di aggiungere la chiave e rimuovi la chiave prima di tornare a una versione precedente.

862 

850### `admin`863### `admin`

851 864 

852Facoltativo. Abilita `/v1/organizations/spend_limits`, che rispecchia l'API Admin pubblica di Anthropic, e l'applicazione di limiti di spesa per sviluppatore su `/v1/messages`. Vedi [Limiti di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) per come vengono impostati e applicati i cap; questa sezione copre le chiavi `gateway.yaml` che attivano la funzione e la regolano.865Facoltativo. Abilita `/v1/organizations/spend_limits`, che rispecchia l'API Admin pubblica di Anthropic, e l'applicazione di limiti di spesa per sviluppatore su `/v1/messages`. Vedi [Limiti di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) per come vengono impostati e applicati i cap; questa sezione copre le chiavi `gateway.yaml` che attivano la funzione e la regolano.


865 # IdP groups granted full admin via the normal gateway JWT (no API key).878 # IdP groups granted full admin via the normal gateway JWT (no API key).

866 admin_groups: [platform-finops]879 admin_groups: [platform-finops]

867 blocked_message: request an increase at https://go.example.com/claude-limits880 blocked_message: request an increase at https://go.example.com/claude-limits

881 # Try eng-platform's pooled budget first, then eng-all's, then any other group's.

882 pooled_conflict_rule: priority_list

883 pooled_priority_order: [eng-platform, eng-all]

868```884```

869 885 

870| Campo | Obbligatorio | Descrizione |886| Campo | Obbligatorio | Descrizione |


877| `spend_retention_months` | No | Predefinito `13`. Le righe del contatore `spend` più vecchie di questo vengono eliminate. Il valore predefinito mantiene un anno completo più il mese parziale corrente per i rapporti anno su anno. |893| `spend_retention_months` | No | Predefinito `13`. Le righe del contatore `spend` più vecchie di questo vengono eliminate. Il valore predefinito mantiene un anno completo più il mese parziale corrente per i rapporti anno su anno. |

878| `identity_retention_days` | No | Predefinito `90`. TTL dall'ultimo accesso per le righe `principal_emails`, che contengono l'email, il nome visualizzato e i gruppi di ogni sviluppatore (PII). Deliberatamente più breve della conservazione della spesa, in modo che un'identità rimossa scada mentre i suoi contatori di spesa anonimi rimangono. |894| `identity_retention_days` | No | Predefinito `90`. TTL dall'ultimo accesso per le righe `principal_emails`, che contengono l'email, il nome visualizzato e i gruppi di ogni sviluppatore (PII). Deliberatamente più breve della conservazione della spesa, in modo che un'identità rimossa scada mentre i suoi contatori di spesa anonimi rimangono. |

879| `group_limit_mode` | No | `min` (predefinito) o `max`. Quando uno sviluppatore è in diversi gruppi con cap, `min` applica il più restrittivo e `max` il meno restrittivo. Utilizzato sia dall'applicazione che da `/effective`. |895| `group_limit_mode` | No | `min` (predefinito) o `max`. Quando uno sviluppatore è in diversi gruppi con cap, `min` applica il più restrittivo e `max` il meno restrittivo. Utilizzato sia dall'applicazione che da `/effective`. |

896| `pooled_conflict_rule` | No | `default_order` (predefinito) o `priority_list`. L'ordine in cui il gateway prova i budget condivisi di uno sviluppatore. Consulta [Ordine dei budget condivisi](#pooled-budget-order). Richiede v2.1.319 o successiva. |

897| `pooled_priority_order` | Con `priority_list` | Fino a 50 nomi di gruppi, ciascuno elencato una sola volta e scritto come lo invia il tuo IdP. I gruppi i cui budget condivisi il gateway prova per primi. Consulta [Ordine dei budget condivisi](#pooled-budget-order). Richiede v2.1.319 o successiva. |

898 

899#### Ordine dei budget condivisi

900 

901Un budget condiviso è un unico limite mensile su cui spende un intero gruppo. Per impostarne uno, aggiungi `pooled_budget` alla [richiesta che imposta il limite mensile del gruppo](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md#set-a-cap), come in `"pooled_budget": {"amount": "500000"}` per \$5.000. La richiesta accetta anche lo `scope` del gruppo, `"period": "monthly"` e `amount`, che resta il limite personale di ogni membro.

902 

903Per uno sviluppatore che fa parte di più gruppi di questo tipo, ogni richiesta viene conteggiata sul primo budget la cui spesa è inferiore al limite e viene rifiutata quando tutti i budget sono esauriti. `pooled_conflict_rule` imposta l'ordine in cui il gateway prova i budget:

904 

905* **`default_order`**: prima il limite più alto e, a parità di limite, in ordine crescente di nome del gruppo

906* **`priority_list`**: i budget dei gruppi in `pooled_priority_order`, nell'ordine dell'elenco, poi i budget degli altri gruppi per nome del gruppo

907 

908Se elenchi dei gruppi senza `pooled_conflict_rule: priority_list`, il gateway ignora l'elenco e registra un avviso all'avvio.

909 

910Un server del gateway precedente alla v2.1.319 si rifiuta di avviarsi quando trova `pooled_conflict_rule` o `pooled_priority_order`. Aggiorna ogni replica prima di aggiungere una delle due chiavi e rimuovile entrambe prima di tornare a una versione precedente.

880 911 

881### `enforcement`912### `enforcement`

882 913 


1675# environment variable (debug | info | warn | error; default info). debug1706# environment variable (debug | info | warn | error; default info). debug

1676# also logs the claim names in each id_token, for groups_claim diagnosis.1707# also logs the claim names in each id_token, for groups_claim diagnosis.

1677# It does not affect audit events, which are always emitted.1708# It does not affect audit events, which are always emitted.

1709# Set CLAUDE_GATEWAY_LOG_FORMAT=json to write operational log lines as JSON

1710# objects with severity, time, and message.

1678 1711 

1679listen:1712listen:

1680 host: 0.0.0.01713 host: 0.0.0.0


1715 # connect_timeout_seconds: 51748 # connect_timeout_seconds: 5

1716 # readiness_grace_seconds: 300 # keep passing the readiness check through a database failover1749 # readiness_grace_seconds: 300 # keep passing the readiness check through a database failover

1717 1750 

1751# Notice shown at sign-in. Anyone who can reach the gateway can read it.

1752# login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

1753 

1718# Enables /v1/organizations/spend_limits (mirrors the Anthropic Admin API)1754# Enables /v1/organizations/spend_limits (mirrors the Anthropic Admin API)

1719# and per-developer spend enforcement on /v1/messages. Omit to disable.1755# and per-developer spend enforcement on /v1/messages. Omit to disable.

1720# Caps themselves are set via the admin API, not here.1756# Caps themselves are set via the admin API, not here.


1729# # spend_retention_months: 131765# # spend_retention_months: 13

1730# # identity_retention_days: 901766# # identity_retention_days: 90

1731# # group_limit_mode: min1767# # group_limit_mode: min

1768# # pooled_conflict_rule: priority_list

1769# # pooled_priority_order: [eng-platform, eng-all]

1732 1770 

1733# enforcement:1771# enforcement:

1734# fail_closed_on_error: false1772# fail_closed_on_error: false

Details

173 * `admin.denied` registra un tentativo di autenticazione dell'API di amministrazione rifiutato con l'IP client, il metodo, il percorso e un motivo, senza il materiale della chiave presentato: `invalid_key` quando è stato presentato un `x-api-key` ma non ha corrisposto a nessuna chiave configurata, `bearer_rejected` quando è stato presentato solo un header `Authorization` e non si è verificato come una sessione gateway in `admin.admin_groups`, o `no_credentials` quando nessun header è stato presentato173 * `admin.denied` registra un tentativo di autenticazione dell'API di amministrazione rifiutato con l'IP client, il metodo, il percorso e un motivo, senza il materiale della chiave presentato: `invalid_key` quando è stato presentato un `x-api-key` ma non ha corrisposto a nessuna chiave configurata, `bearer_rejected` quando è stato presentato solo un header `Authorization` e non si è verificato come una sessione gateway in `admin.admin_groups`, o `no_credentials` quando nessun header è stato presentato

174* **Log operazionali**: righe leggibili con prefisso `[gateway]` per avvio, avvertimenti e errori upstream. La variabile di ambiente `CLAUDE_GATEWAY_LOG_LEVEL` controlla la verbosità e accetta `debug`, `info`, `warn`, o `error`, con `info` come predefinito. A `debug`, ogni accesso e aggiornamento registra anche i nomi, non i valori, dei claim nell'id\_token, più i nomi dei claim userinfo quando `userinfo_fallback` ha fornito qualcosa, così puoi diagnosticare le impostazioni `email_claim` e `groups_claim` senza registrare PII. Non influisce sugli eventi di audit, che sono sempre emessi.174* **Log operazionali**: righe leggibili con prefisso `[gateway]` per avvio, avvertimenti e errori upstream. La variabile di ambiente `CLAUDE_GATEWAY_LOG_LEVEL` controlla la verbosità e accetta `debug`, `info`, `warn`, o `error`, con `info` come predefinito. A `debug`, ogni accesso e aggiornamento registra anche i nomi, non i valori, dei claim nell'id\_token, più i nomi dei claim userinfo quando `userinfo_fallback` ha fornito qualcosa, così puoi diagnosticare le impostazioni `email_claim` e `groups_claim` senza registrare PII. Non influisce sugli eventi di audit, che sono sempre emessi.

175 175 

176#### Scrivi i log operazionali in JSON

177 

178Se il tuo raccoglitore di log legge il livello di ogni riga da un campo JSON, imposta `CLAUDE_GATEWAY_LOG_FORMAT=json` nell'ambiente del gateway. Richiede Claude Code v2.1.319 o successivo sul server del gateway.

179 

180Ogni riga di log operazionale diventa quindi un oggetto con `severity`, `time` e `message`:

181 

182```json theme={null}

183{"severity":"INFO","time":"2026-11-04T17:03:21.512Z","message":"claude gateway listening on http://0.0.0.0:8080"}

184```

185 

186`severity` è il livello di log in maiuscolo, con `warn` scritto come `WARNING`. Un avvio non riuscito è una riga `ERROR`.

187 

188Gli eventi di audit, che vanno anch'essi su stderr, non cambiano. Portano `ts` e `evt`, e nessun `severity`.

189 

176### Salute190### Salute

177 191 

178Il gateway serve `GET /healthz` come sonda di liveness e `GET /readyz` come sonda di readiness. `/readyz` verifica che lo store sia raggiungibile. Se imposti [`store.readiness_grace_seconds`](https://code.claude.com/docs/it/claude-apps-gateway-config#store), `/readyz` continua a segnalare ready per fino a quel numero di secondi dopo che lo store smette di rispondere.192Il gateway serve `GET /healthz` come sonda di liveness e `GET /readyz` come sonda di readiness. `/readyz` verifica che lo store sia raggiungibile. Se imposti [`store.readiness_grace_seconds`](https://code.claude.com/docs/it/claude-apps-gateway-config#store), `/readyz` continua a segnalare ready per fino a quel numero di secondi dopo che lo store smette di rispondere.

Details

6 6 

7> Limita la spesa di ogni sviluppatore attraverso il gateway delle app Claude per giorno, settimana o mese. Imposta i limiti con un'API Admin e il gateway li applica in tempo reale su ogni richiesta.7> Limita la spesa di ogni sviluppatore attraverso il gateway delle app Claude per giorno, settimana o mese. Imposta i limiti con un'API Admin e il gateway li applica in tempo reale su ogni richiesta.

8 8 

9I limiti di spesa limitano quanto ogni sviluppatore può spendere attraverso il tuo [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway) in un determinato giorno, settimana o mese. Quando uno sviluppatore supera il suo limite, il gateway restituisce `429` alla sua prossima richiesta e lo blocca fino al ripristino del periodo o fino a quando un amministratore non aumenta il limite. Utilizza i limiti di spesa per dare a ogni sviluppatore, gruppo o all'intera organizzazione un tetto massimo su una credenziale che tutti condividono.9I limiti di spesa limitano quanto ogni sviluppatore può spendere attraverso il tuo [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway) in un determinato giorno, settimana o mese. Quando uno sviluppatore supera il suo limite, il gateway restituisce `429` alle sue richieste successive finché un amministratore non aumenta il limite, o finché il limite non si ripristina se è superiore a \$0. Utilizza i limiti di spesa per dare a ogni sviluppatore, gruppo o all'intera organizzazione un tetto massimo su una credenziale che tutti condividono.

10 10 

11Per impostazione predefinita, un gateway delle app Claude inoltra tutta l'inferenza attraverso una credenziale upstream condivisa, quindi la fattura del tuo provider attribuisce tutto a quella credenziale, non ai singoli sviluppatori. Su Amazon Bedrock, l'[attribuzione dei costi AWS per sviluppatore](https://code.claude.com/docs/it/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) cambia questo. Senza limiti per sviluppatore, una flotta di agenti incontrollata può spendere l'intero impegno dell'organizzazione. I limiti di spesa sono la vista per sviluppatore del gateway e il circuito di protezione su quella fattura condivisa.11Per impostazione predefinita, un gateway delle app Claude inoltra tutta l'inferenza attraverso una credenziale upstream condivisa, quindi la fattura del tuo provider attribuisce tutto a quella credenziale, non ai singoli sviluppatori. Su Amazon Bedrock, l'[attribuzione dei costi AWS per sviluppatore](https://code.claude.com/docs/it/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) cambia questo. Senza limiti per sviluppatore, una flotta di agenti incontrollata può spendere l'intero impegno dell'organizzazione. I limiti di spesa sono la vista per sviluppatore del gateway e il circuito di protezione su quella fattura condivisa.

12 12 


51 51 

52Su ogni richiesta `/v1/messages`, il gateway risolve i limiti dello sviluppatore e la spesa da inizio periodo in una query Postgres. Se superano uno qualsiasi dei limiti, la richiesta restituisce `429` con `error.type: billing_error` e l'header `x-should-retry: false`.52Su ogni richiesta `/v1/messages`, il gateway risolve i limiti dello sviluppatore e la spesa da inizio periodo in una query Postgres. Se superano uno qualsiasi dei limiti, la richiesta restituisce `429` con `error.type: billing_error` e l'header `x-should-retry: false`.

53 53 

54Il messaggio nomina il periodo e l'ora di reset, come `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, seguito dal tuo [`admin.blocked_message`](https://code.claude.com/docs/it/claude-apps-gateway-config#admin) se impostato. Quando uno sviluppatore supera diversi limiti contemporaneamente, il messaggio nomina il limite che si ripristina per ultimo. La risposta contiene anche un header `retry-after` con i secondi rimanenti fino a quel reset. Prima della versione v2.1.225 sul server gateway, il messaggio era `spend limit reached` senza periodo, ora di reset o header `retry-after`.54Per un limite superiore a `"0"`, il messaggio indica la data UTC in cui quel limite si ripristina. Se imposti [`admin.blocked_message`](https://code.claude.com/docs/it/claude-apps-gateway-config#admin), il gateway lo aggiunge in coda, come in questo esempio:

55 

56```text theme={null}

57spend limit reached · resets Dec 1 · request an increase at https://go.example.com/claude-limits

58```

59 

60Per un limite pari a `"0"`, che un ripristino non rimuove, il messaggio non contiene alcuna data. Quando uno sviluppatore supera diversi limiti contemporaneamente, il messaggio descrive il limite che si ripristina per ultimo. La risposta contiene anche un header `retry-after` con i secondi rimanenti fino alla fine del periodo di quel limite.

61 

62Prima della v2.1.319 sul server gateway, il messaggio nominava il periodo e l'ora di reset, come `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`. Prima della v2.1.225, il messaggio era `spend limit reached` senza periodo, ora di reset o header `retry-after`.

55 63 

56Su v2.1.227 o successivo, il riferimento del protocollo in `<public_url>/protocol` elenca anche gli header di risposta esatti per il limite di utilizzo e il corpo `429`.64Su v2.1.227 o successivo, il riferimento del protocollo in `<public_url>/protocol` elenca anche gli header di risposta esatti per il limite di utilizzo e il corpo `429`.

57 65 


95| Avvisi di utilizzo al 75% e al 95% | v2.1.225 o successivo | v2.1.225 o successivo |103| Avvisi di utilizzo al 75% e al 95% | v2.1.225 o successivo | v2.1.225 o successivo |

96| Una barra **Spend limit** in `/usage` con la percentuale del limite utilizzata e quando si ripristina, e un oggetto `rate_limits.spend_limit` nell'input della riga di stato | v2.1.251 o successivo | v2.1.225 o successivo |104| Una barra **Spend limit** in `/usage` con la percentuale del limite utilizzata e quando si ripristina, e un oggetto `rate_limits.spend_limit` nell'input della riga di stato | v2.1.251 o successivo | v2.1.225 o successivo |

97| La spesa stimata e il limite in dollari statunitensi nella barra **Spend limit**, come "\$271.40 / \$500.00 spent this month", e gli stessi importi più il periodo del limite nell'input della riga di stato | v2.1.284 o successivo | v2.1.284 o successivo |105| La spesa stimata e il limite in dollari statunitensi nella barra **Spend limit**, come "\$271.40 / \$500.00 spent this month", e gli stessi importi più il periodo del limite nell'input della riga di stato | v2.1.284 o successivo | v2.1.284 o successivo |

106| Su un gateway con un blocco [`admin:`](https://code.claude.com/docs/it/claude-apps-gateway-config#admin), quando nessun limite si applica allo sviluppatore, la sua spesa stimata sotto **Spend (UTC)** in `/usage`, come "\$13.06 today · \$80.76 this week · \$272.06 this month" | v2.1.319 o successivo | v2.1.319 o successivo |

98 107 

99Gli avvisi e la percentuale provengono dagli header `anthropic-ratelimit-unified-*`, che il gateway aggiunge a ogni risposta `/v1/messages` riuscita per uno sviluppatore che ha un limite. Gli header descrivono sempre il limite dello sviluppatore stesso: il gateway elimina gli header di rate limit del provider upstream, che descrivono la tua quota condivisa, e non li inoltra mai.108Gli avvisi e la percentuale provengono dagli header `anthropic-ratelimit-unified-*`, che il gateway aggiunge a ogni risposta `/v1/messages` riuscita per uno sviluppatore che ha un limite. Gli header descrivono sempre il limite dello sviluppatore stesso: il gateway elimina gli header di rate limit del provider upstream, che descrivono la tua quota condivisa, e non li inoltra mai.

100 109 

Details

41| `claude mcp logout <name>` | Cancella le credenziali OAuth archiviate per un server MCP | `claude mcp logout sentry` |41| `claude mcp logout <name>` | Cancella le credenziali OAuth archiviate per un server MCP | `claude mcp logout sentry` |

42| `claude plugin` | Gestisci i [plugin](https://code.claude.com/docs/it/plugins/overview.md) di Claude Code. Alias: `claude plugins`. Vedi il [riferimento plugin](https://code.claude.com/docs/it/plugins/cli-reference.md#claude-plugin-commands) per i sottocomandi | `claude plugin install code-review@claude-plugins-official` |42| `claude plugin` | Gestisci i [plugin](https://code.claude.com/docs/it/plugins/overview.md) di Claude Code. Alias: `claude plugins`. Vedi il [riferimento plugin](https://code.claude.com/docs/it/plugins/cli-reference.md#claude-plugin-commands) per i sottocomandi | `claude plugin install code-review@claude-plugins-official` |

43| `claude purge [path]` | Elimina tutto lo stato locale di Claude Code per un progetto: trascrizioni, elenchi di attività, log di debug, cronologia delle modifiche ai file, righe della cronologia dei prompt e la voce del progetto in `~/.claude.json`. Ometti `[path]` per scegliere da un elenco interattivo. Flag: `--dry-run` per visualizzare un'anteprima, `-y`/`--yes` per saltare la conferma, `-i`/`--interactive` per confermare ogni elemento, `--all` per ogni progetto. Vedi [Cancella dati locali](https://code.claude.com/docs/it/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |43| `claude purge [path]` | Elimina tutto lo stato locale di Claude Code per un progetto: trascrizioni, elenchi di attività, log di debug, cronologia delle modifiche ai file, righe della cronologia dei prompt e la voce del progetto in `~/.claude.json`. Ometti `[path]` per scegliere da un elenco interattivo. Flag: `--dry-run` per visualizzare un'anteprima, `-y`/`--yes` per saltare la conferma, `-i`/`--interactive` per confermare ogni elemento, `--all` per ogni progetto. Vedi [Cancella dati locali](https://code.claude.com/docs/it/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |

44| `claude remote-control` | Avvia un server [Remote Control](https://code.claude.com/docs/it/remote-control.md) per controllare Claude Code da Claude.ai o dall'app Claude. Viene eseguito in modalità server (nessuna sessione interattiva locale). Vedi [Flag modalità server](https://code.claude.com/docs/it/remote-control.md#start-a-remote-control-session). Dopo aver interrotto il server, puoi ripristinare le sessioni che stava servendo. Vedi [Riprendi sessioni dopo aver interrotto il server](https://code.claude.com/docs/it/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |44| `claude remote-control` | Avvia un server [Remote Control](https://code.claude.com/docs/it/remote-control.md) per controllare Claude Code da claude.ai o dall'app Claude. Alias: `claude rc`. Viene eseguito in modalità server (nessuna sessione interattiva locale). Vedi [Flag modalità server](https://code.claude.com/docs/it/remote-control.md#start-a-remote-control-session). Dopo aver interrotto il server, puoi ripristinare le sessioni che stava servendo. Vedi [Riprendi sessioni dopo aver interrotto il server](https://code.claude.com/docs/it/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |

45| `claude respawn <id>` | Riavvia una [sessione in background](https://code.claude.com/docs/it/agent-view.md#manage-sessions-from-the-shell), in esecuzione o interrotta, mantenendo la sua conversazione intatta. Usa `--all` per riavviare ogni sessione in esecuzione, ad esempio per raccogliere un binario Claude Code aggiornato | `claude respawn 7c5dcf5d` |45| `claude respawn <id>` | Riavvia una [sessione in background](https://code.claude.com/docs/it/agent-view.md#manage-sessions-from-the-shell), in esecuzione o interrotta, mantenendo la sua conversazione intatta. Usa `--all` per riavviare ogni sessione in esecuzione, ad esempio per raccogliere un binario Claude Code aggiornato | `claude respawn 7c5dcf5d` |

46| `claude rm <id>` | Rimuovi una [sessione in background](https://code.claude.com/docs/it/agent-view.md#manage-sessions-from-the-shell) dall'elenco. Quando la rimozione viene [rifiutata sul worktree della sessione](https://code.claude.com/docs/it/agent-view.md#what-deleting-a-session-removes) e un secondo `claude rm` può risolverlo, il rifiuto stampa il flag esatto e il valore da passare: `--discard-unpushed <commit>@<worktree-id>` scarta un worktree che ha commit non inviati insieme a quei commit, e `--force-remove-worktree <worktree-id>` elimina una directory worktree che git o l'hook `WorktreeRemove` non potevano rimuovere. `--discard-unpushed` richiede Claude Code v2.1.260 o successivo, e `--force-remove-worktree` richiede v2.1.268 o successivo. La trascrizione della conversazione rimane sul tuo computer locale, disponibile tramite `claude --resume` | `claude rm 7c5dcf5d` |46| `claude rm <id>` | Rimuovi una [sessione in background](https://code.claude.com/docs/it/agent-view.md#manage-sessions-from-the-shell) dall'elenco. Quando la rimozione viene [rifiutata sul worktree della sessione](https://code.claude.com/docs/it/agent-view.md#what-deleting-a-session-removes) e un secondo `claude rm` può risolverlo, il rifiuto stampa il flag esatto e il valore da passare: `--discard-unpushed <commit>@<worktree-id>` scarta un worktree che ha commit non inviati insieme a quei commit, e `--force-remove-worktree <worktree-id>` elimina una directory worktree che git o l'hook `WorktreeRemove` non potevano rimuovere. `--discard-unpushed` richiede Claude Code v2.1.260 o successivo, e `--force-remove-worktree` richiede v2.1.268 o successivo. La trascrizione della conversazione rimane sul tuo computer locale, disponibile tramite `claude --resume` | `claude rm 7c5dcf5d` |

47| `claude self-hosted-runner` | Avvia un processo runner che registra questa macchina o contenitore con un [ambiente auto-ospitato](https://code.claude.com/docs/it/self-hosted-environments) e ospita sessioni cloud di Claude Code sulla tua infrastruttura. Esegui `claude self-hosted-runner setup` per una procedura guidata dell'operatore, `claude self-hosted-runner doctor` per [diagnosticare un runner distribuito](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#troubleshooting) e `claude self-hosted-runner orchestrator` per generare [runner su richiesta](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#on-demand-runners). Richiede Claude Code v2.1.224 o successivo | `claude self-hosted-runner setup` |47| `claude self-hosted-runner` | Avvia un processo runner che registra questa macchina o contenitore con un [ambiente auto-ospitato](https://code.claude.com/docs/it/self-hosted-environments) e ospita sessioni cloud di Claude Code sulla tua infrastruttura. Esegui `claude self-hosted-runner setup` per una procedura guidata dell'operatore, `claude self-hosted-runner doctor` per [diagnosticare un runner distribuito](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#troubleshooting) e `claude self-hosted-runner orchestrator` per generare [runner su richiesta](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#on-demand-runners). Richiede Claude Code v2.1.224 o successivo | `claude self-hosted-runner setup` |


111| `--no-session-persistence` | Disabilita la persistenza della sessione in modo che le sessioni non vengono salvate su disco e non possono essere riprese. Solo modalità print. La variabile di ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/it/env-vars) fa lo stesso in qualsiasi modalità | `claude -p --no-session-persistence "query"` |111| `--no-session-persistence` | Disabilita la persistenza della sessione in modo che le sessioni non vengono salvate su disco e non possono essere riprese. Solo modalità print. La variabile di ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/it/env-vars) fa lo stesso in qualsiasi modalità | `claude -p --no-session-persistence "query"` |

112| `--output-format` | Specifica il formato di output per la modalità print (opzioni: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |112| `--output-format` | Specifica il formato di output per la modalità print (opzioni: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

113| `--permission-mode` | Inizia in una [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md) specificata. Accetta `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, o `manual` come alias per `default`. L'alias `manual` seleziona la modalità di permesso che l'interfaccia utente etichetta Manual e richiede Claude Code v2.1.200 o successivo; `claude --help` la elenca al posto di `default`, e entrambi i valori funzionano. Sostituisce `defaultMode` dai file di impostazioni. Senza questo flag o `--dangerously-skip-permissions`, una nuova sessione inizia nella modalità di permesso descritta in [quale modalità di permesso inizia una sessione](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in), che copre anche cosa inizia una sessione `-p` | `claude --permission-mode plan` |113| `--permission-mode` | Inizia in una [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md) specificata. Accetta `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, o `manual` come alias per `default`. L'alias `manual` seleziona la modalità di permesso che l'interfaccia utente etichetta Manual e richiede Claude Code v2.1.200 o successivo; `claude --help` la elenca al posto di `default`, e entrambi i valori funzionano. Sostituisce `defaultMode` dai file di impostazioni. Senza questo flag o `--dangerously-skip-permissions`, una nuova sessione inizia nella modalità di permesso descritta in [quale modalità di permesso inizia una sessione](https://code.claude.com/docs/it/permission-modes.md#which-mode-a-session-starts-in), che copre anche cosa inizia una sessione `-p` | `claude --permission-mode plan` |

114| `--permission-prompt-tool` | Specifica uno strumento MCP per gestire i prompt di permesso in modalità non interattiva. Passa il nome completo, come `mcp__<server>__<tool>`, di uno strumento su un server MCP che l'esecuzione carica. Claude Code attende che il server MCP di quello strumento si connetta prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](https://code.claude.com/docs/it/env-vars), 30 secondi per impostazione predefinita. Lo strumento di prompt non può approvare uno strumento MCP contrassegnato come [richiedente interazione dell'utente](https://code.claude.com/docs/it/mcp.md#require-approval-for-a-specific-tool): Claude Code converte un risultato `allow` per uno in una negazione. Questa restrizione richiede Claude Code v2.1.199 o successivo | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |114| `--permission-prompt-tool` | Specifica uno strumento MCP per gestire i prompt di permesso in modalità non interattiva. Passa il nome completo, come `mcp__<server>__<tool>`, di uno strumento su un server MCP che l'esecuzione carica. Claude Code attende che il server MCP di quello strumento si connetta prima di eseguire il primo turno, fino al timeout di avvio [`MCP_TIMEOUT`](https://code.claude.com/docs/it/env-vars), 30 secondi per impostazione predefinita. Vedi [cosa deve restituire lo strumento](https://code.claude.com/docs/it/errors.md#permission-prompt-tool-returned-an-invalid-result). Lo strumento di prompt non può approvare uno strumento MCP contrassegnato come [richiedente interazione dell'utente](https://code.claude.com/docs/it/mcp.md#require-approval-for-a-specific-tool): Claude Code converte un risultato `allow` per uno in una negazione. Questa restrizione richiede Claude Code v2.1.199 o successivo | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |

115| `--permission-prompts` | Imposta chi risponde ai prompt di permesso in modalità print. Con l'impostazione predefinita `host`, Claude Code li invia all'host dell'Agent SDK o allo strumento `--permission-prompt-tool`. Passa `none` quando nessuno può rispondere, e Claude Code li nega invece. Vedi [Disattiva i prompt di permesso nelle esecuzioni incustodite](https://code.claude.com/docs/it/headless.md#turn-off-permission-prompts-in-unattended-runs). Richiede Claude Code v2.1.259 o successivo | `claude -p --permission-prompts none "query"` |115| `--permission-prompts` | Imposta chi risponde ai prompt di permesso in modalità print. Con l'impostazione predefinita `host`, Claude Code li invia all'host dell'Agent SDK o allo strumento `--permission-prompt-tool`. Passa `none` quando nessuno può rispondere, e Claude Code li nega invece. Vedi [Disattiva i prompt di permesso nelle esecuzioni incustodite](https://code.claude.com/docs/it/headless.md#turn-off-permission-prompts-in-unattended-runs). Richiede Claude Code v2.1.259 o successivo | `claude -p --permission-prompts none "query"` |

116| `--plugin-dir` | Carica un plugin da una directory o un archivio `.zip`, o diversi da una [cartella di plugin](https://code.claude.com/docs/it/plugins/create.md#load-a-directory-or-archive-for-one-session), solo per questa sessione. Ogni flag accetta un percorso. Ripeti il flag per più percorsi: `--plugin-dir A --plugin-dir B.zip`. Passare una cartella di plugin richiede Claude Code v2.1.265 o successivo | `claude --plugin-dir ./my-plugin` |116| `--plugin-dir` | Carica un plugin da una directory o un archivio `.zip`, o diversi da una [cartella di plugin](https://code.claude.com/docs/it/plugins/create.md#load-a-directory-or-archive-for-one-session), solo per questa sessione. Ogni flag accetta un percorso. Ripeti il flag per più percorsi: `--plugin-dir A --plugin-dir B.zip`. Passare una cartella di plugin richiede Claude Code v2.1.265 o successivo | `claude --plugin-dir ./my-plugin` |

117| `--plugin-url` | Recupera un archivio plugin `.zip` da un URL solo per questa sessione. Ripeti il flag per più plugin, o passa URL separati da spazi in un singolo valore tra virgolette | `claude --plugin-url https://example.com/plugin.zip` |117| `--plugin-url` | Recupera un archivio plugin `.zip` da un URL solo per questa sessione. Ripeti il flag per più plugin, o passa URL separati da spazi in un singolo valore tra virgolette | `claude --plugin-url https://example.com/plugin.zip` |

commands.md +1 −1

Details

162| `/ultrareview [PR or branch]` | Esegue una code review approfondita e multi-agente in una sandbox cloud con [ultrareview](https://code.claude.com/docs/it/ultrareview.md). Passa un riferimento a una PR per esaminare quella pull request, oppure un branch base o un commit per cambiare la base di confronto. L'invocazione preferita è `/code-review ultra`, e `/ultrareview` è un alias. Include 3 esecuzioni gratuite sui piani Pro, Max e Ultra, poi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |162| `/ultrareview [PR or branch]` | Esegue una code review approfondita e multi-agente in una sandbox cloud con [ultrareview](https://code.claude.com/docs/it/ultrareview.md). Passa un riferimento a una PR per esaminare quella pull request, oppure un branch base o un commit per cambiare la base di confronto. L'invocazione preferita è `/code-review ultra`, e `/ultrareview` è un alias. Include 3 esecuzioni gratuite sui piani Pro, Max e Ultra, poi richiede [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Descrivi una modifica alle impostazioni, come consentire un comando, impostare una variabile d'ambiente o aggiungere un [hook](https://code.claude.com/docs/it/hooks.md), e Claude modifica il file [`settings.json`](https://code.claude.com/docs/it/settings) corrispondente. Per opzioni come tema e modello, usa invece `/config` |163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Descrivi una modifica alle impostazioni, come consentire un comando, impostare una variabile d'ambiente o aggiungere un [hook](https://code.claude.com/docs/it/hooks.md), e Claude modifica il file [`settings.json`](https://code.claude.com/docs/it/settings) corrispondente. Per opzioni come tema e modello, usa invece `/config` |

164| `/upgrade` | Apre la pagina di upgrade nel browser per passare a un piano di livello superiore. Quando il browser non si apre, il comando mostra una richiesta di accesso senza stampare l'URL |164| `/upgrade` | Apre la pagina di upgrade nel browser per passare a un piano di livello superiore. Quando il browser non si apre, il comando mostra una richiesta di accesso senza stampare l'URL |

165| `/usage` | Mostra il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Ultra, Team o Enterprise, include un [dettaglio di ciò che conta ai fini dei limiti del piano](https://code.claude.com/docs/it/costs.md#plan-usage-breakdown). `/cost` e `/stats` sono alias |165| `/usage` | Mostra il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Su un piano Pro, Max, Ultra, Team o Enterprise, include un [dettaglio di ciò che conta ai fini dei limiti del piano](https://code.claude.com/docs/it/costs.md#plan-usage-breakdown). Dietro un gateway Claude apps che tiene traccia della spesa, mostra [la tua spesa tramite il gateway](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code). `/cost` e `/stats` sono alias |

166| `/usage-credits` | Configura i crediti di utilizzo, o li richiede al tuo amministratore, quando raggiungi un limite. Apre le [impostazioni di fatturazione dei crediti di utilizzo](https://code.claude.com/docs/it/costs.md#add-usage-credits-to-your-subscription) nel browser, tranne per i membri Team ed Enterprise senza accesso alla fatturazione, che invece inviano dalla CLI una richiesta di crediti di utilizzo al proprio amministratore, dopo aver confermato in una finestra di dialogo che la richiesta invia una notifica ai loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio tramite SSH, il comando stampa invece l'URL da visitare; questo richiede Claude Code v2.1.205 o successiva, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |166| `/usage-credits` | Configura i crediti di utilizzo, o li richiede al tuo amministratore, quando raggiungi un limite. Apre le [impostazioni di fatturazione dei crediti di utilizzo](https://code.claude.com/docs/it/costs.md#add-usage-credits-to-your-subscription) nel browser, tranne per i membri Team ed Enterprise senza accesso alla fatturazione, che invece inviano dalla CLI una richiesta di crediti di utilizzo al proprio amministratore, dopo aver confermato in una finestra di dialogo che la richiesta invia una notifica ai loro amministratori. Quando nessun browser può aprire la pagina di fatturazione, ad esempio tramite SSH, il comando stampa invece l'URL da visitare; questo richiede Claude Code v2.1.205 o successiva, e le versioni precedenti non mostravano nulla in quel caso. In precedenza `/extra-usage` |

167| `/verify` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Conferma che una modifica al codice faccia ciò che deve eseguendo la build dell'app del tuo progetto, avviandola e osservando il risultato, invece di affidarsi a test o controlli dei tipi. Consulta [Eseguire e verificare la tua app](https://code.claude.com/docs/it/skills.md#run-and-verify-your-app) |167| `/verify` | **[Skill](https://code.claude.com/docs/it/skills.md#bundled-skills).** Conferma che una modifica al codice faccia ciò che deve eseguendo la build dell'app del tuo progetto, avviandola e osservando il risultato, invece di affidarsi a test o controlli dei tipi. Consulta [Eseguire e verificare la tua app](https://code.claude.com/docs/it/skills.md#run-and-verify-your-app) |

168| `/vim` | Rimosso nella v2.1.92. Per passare dalla modalità di modifica Vim a quella Normal e viceversa, usa `/config` → Editor mode |168| `/vim` | Rimosso nella v2.1.92. Per passare dalla modalità di modifica Vim a quella Normal e viceversa, usa `/config` → Editor mode |

costs.md +1 −1

Details

236 * Esegui `/usage-credits` per richiedere utilizzo oltre l'indennità, se hai i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) attivati.236 * Esegui `/usage-credits` per richiedere utilizzo oltre l'indennità, se hai i [crediti di utilizzo](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) attivati.

237 * Su Claude Code v2.1.234 o successivo, [attendi e continua il compito interrotto automaticamente dopo il ripristino](https://code.claude.com/docs/it/interactive-mode.md#wait-for-a-usage-limit-to-reset); quella sezione elenca quando Claude Code avvia l'attesa da solo e quando lo sviluppatore lo seleziona da `/rate-limit-options`. Per controllare per la tua flotta se Claude Code avvia quell'attesa da solo, imposta [`autoContinueAtUsageLimit`](https://code.claude.com/docs/it/settings-reference#autocontinueatusagelimit) nelle [impostazioni gestite](https://code.claude.com/docs/it/settings.md#settings-precedence).237 * Su Claude Code v2.1.234 o successivo, [attendi e continua il compito interrotto automaticamente dopo il ripristino](https://code.claude.com/docs/it/interactive-mode.md#wait-for-a-usage-limit-to-reset); quella sezione elenca quando Claude Code avvia l'attesa da solo e quando lo sviluppatore lo seleziona da `/rate-limit-options`. Per controllare per la tua flotta se Claude Code avvia quell'attesa da solo, imposta [`autoContinueAtUsageLimit`](https://code.claude.com/docs/it/settings-reference#autocontinueatusagelimit) nelle [impostazioni gestite](https://code.claude.com/docs/it/settings.md#settings-precedence).

238* **"You've hit your individual spend limit", "org's monthly spend limit" o "team's shared budget"**: la richiesta dello sviluppatore verrebbe fatturata ai crediti di utilizzo, e quei crediti hanno raggiunto un limite di spesa che hai impostato. Per consentire allo sviluppatore di continuare, vai a [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) e aumenta il limite indicato dal messaggio. Quando il messaggio indica anche un'ora di ripristino del piano, lo sviluppatore può invece attendere fino ad allora. Vedi il [riferimento degli errori](https://code.claude.com/docs/it/errors.md#youve-hit-your-monthly-spend-limit) per ogni variante.238* **"You've hit your individual spend limit", "org's monthly spend limit" o "team's shared budget"**: la richiesta dello sviluppatore verrebbe fatturata ai crediti di utilizzo, e quei crediti hanno raggiunto un limite di spesa che hai impostato. Per consentire allo sviluppatore di continuare, vai a [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) e aumenta il limite indicato dal messaggio. Quando il messaggio indica anche un'ora di ripristino del piano, lo sviluppatore può invece attendere fino ad allora. Vedi il [riferimento degli errori](https://code.claude.com/docs/it/errors.md#youve-hit-your-monthly-spend-limit) per ogni variante.

239* **Un messaggio di limite di spesa da un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway)**: lo sviluppatore ha superato un limite di spesa che hai impostato sul tuo gateway self-hosted, e il gateway blocca le sue richieste fino al ripristino del periodo o fino a quando non aumenti il limite. Vedi [limiti di spesa del gateway](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) per i limiti, i programmi di ripristino e il messaggio che lo sviluppatore vede.239* **Un messaggio di limite di spesa da un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway)**: lo sviluppatore ha superato un limite di spesa che hai impostato sul tuo gateway self-hosted. Il gateway blocca le sue richieste finché non aumenti il limite, o finché il limite non si ripristina se è superiore a \$0. Vedi [limiti di spesa del gateway](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) per i limiti, i programmi di ripristino e il messaggio che lo sviluppatore vede.

240* **Un avviso di contesto o auto-compact**: non è un limite di utilizzo. La conversazione è cresciuta vicino alla [finestra auto-compact](https://code.claude.com/docs/it/model-config.md#set-the-auto-compact-window) della sessione, la soglia in cui Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a [riduci l'utilizzo dei token](#reduce-token-usage).240* **Un avviso di contesto o auto-compact**: non è un limite di utilizzo. La conversazione è cresciuta vicino alla [finestra auto-compact](https://code.claude.com/docs/it/model-config.md#set-the-auto-compact-window) della sessione, la soglia in cui Claude Code riassume la cronologia più vecchia per liberare spazio. Indirizza lo sviluppatore a [riduci l'utilizzo dei token](#reduce-token-usage).

241* **Spesa inaspettatamente alta su un piano API o provider cloud**: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in [riduci l'utilizzo dei token](#reduce-token-usage).241* **Spesa inaspettatamente alta su un piano API o provider cloud**: di solito risale a sessioni lunghe che non sono mai state cancellate o a Opus lasciato come modello predefinito. Le abitudini con il maggiore impatto da condividere sono cancellare tra compiti non correlati e abbinare il modello al lavoro, entrambi coperti in [riduci l'utilizzo dei token](#reduce-token-usage).

242 242 

env-vars.md +2 −1

Details

365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](https://code.claude.com/docs/it/prompt-caching.md#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper 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 fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Imposta `5m` o `1h`, gli unici valori accettati da Claude Code, per scegliere il [TTL della cache dei prompt](https://code.claude.com/docs/it/prompt-caching.md#cache-lifetime) per la conversazione principale: i tuoi turni interattivi, `-p` e SDK, più gli helper 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 fattura le scritture nella cache da 1 ora a una tariffa più alta. Richiede Claude Code v2.1.242 o successiva |

366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta su `1` per propagare il contesto di traccia 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 è abilitata solo quando la connessione all'API Anthropic è diretta. Aggiunta nella v2.1.152. Consulta [Tracce (beta)](https://code.claude.com/docs/it/monitoring-usage.md#traces-beta) |366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Imposta su `1` per propagare il contesto di traccia 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 è abilitata solo quando la connessione all'API Anthropic è diretta. Aggiunta nella v2.1.152. Consulta [Tracce (beta)](https://code.claude.com/docs/it/monitoring-usage.md#traces-beta) |

367| `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`, così 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](https://code.claude.com/docs/it/managed-settings.md), qualunque sia l'origine gestita che le fornisce, così che la configurazione dei modelli 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`](https://code.claude.com/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 normale disattivazione tramite `DISABLE_TELEMETRY`. Consulta [Comportamenti predefiniti per provider API](https://code.claude.com/docs/it/data-usage.md#default-behaviors-by-api-provider) |367| `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`, così 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](https://code.claude.com/docs/it/managed-settings.md), qualunque sia l'origine gestita che le fornisce, così che la configurazione dei modelli 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`](https://code.claude.com/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 normale disattivazione tramite `DISABLE_TELEMETRY`. Consulta [Comportamenti predefiniti per provider API](https://code.claude.com/docs/it/data-usage.md#default-behaviors-by-api-provider) |

368| `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 |368| `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. Quando è impostata `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`, impostala nell'ambiente del processo che avvia Claude Code |

369| `CLAUDE_CODE_REMOTE` | Impostata automaticamente su `true` quando Claude Code viene eseguito come [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |369| `CLAUDE_CODE_REMOTE` | Impostata automaticamente su `true` quando Claude Code viene eseguito come [sessione cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md). Leggila da un hook o da uno script di configurazione per rilevare se ti trovi in una sessione cloud |

370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta [Collegare l'output alla sessione](https://code.claude.com/docs/it/cloud-environments.md#link-output-back-to-the-session) |370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostata automaticamente nelle [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md) sull'ID della sessione corrente. Leggila per costruire un link alla trascrizione della sessione. Consulta [Collegare l'output alla sessione](https://code.claude.com/docs/it/cloud-environments.md#link-output-back-to-the-session) |

371| `CLAUDE_CODE_RESTRICTED` | Imposta su `1` per avviare la sessione in modalità con restrizioni, come passando [`--restricted`](https://code.claude.com/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 |371| `CLAUDE_CODE_RESTRICTED` | Imposta su `1` per avviare la sessione in modalità con restrizioni, come passando [`--restricted`](https://code.claude.com/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 |


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 |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 |

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 |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 |

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 |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 |

532| `VERTEX_REGION_CLAUDE_FABLE_5_2` | Sovrascrive la regione per Claude Fable 5.2 quando si usa Google Cloud's Agent Platform. Aggiunta nella v2.1.321 |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando si usa Google Cloud's Agent Platform |533| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Sovrascrive la regione per Claude Haiku 4.5 quando si usa 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 |534| `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 |

534 535 

errors.md +93 −16

Details

52| `Credit balance is too low` | [Limiti di utilizzo](#credit-balance-is-too-low) |52| `Credit balance is too low` | [Limiti di utilizzo](#credit-balance-is-too-low) |

53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Limiti di utilizzo](#youve-hit-your-monthly-spend-limit) |53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Limiti di utilizzo](#youve-hit-your-monthly-spend-limit) |

54| `Could not update your spend limit` | [Limiti di utilizzo](#could-not-update-your-spend-limit) |54| `Could not update your spend limit` | [Limiti di utilizzo](#could-not-update-your-spend-limit) |

55| `spend limit reached` / `spend limit unavailable` | [Limiti di utilizzo](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [Limiti di utilizzo](#spend-limit-reached) |

56| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |56| `Not logged in · Please run /login` | [Autenticazione](#not-logged-in) |

57| `Couldn't save your login` | [Autenticazione](#couldnt-save-your-login) |57| `Couldn't save your login` | [Autenticazione](#couldnt-save-your-login) |

58| `Sign in again to take your previous account or API key off the config file.` | [Autenticazione](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |58| `Sign in again to take your previous account or API key off the config file.` | [Autenticazione](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |


336| `MCP server "<name>" connection closed before the tool call was answered` | [Errori degli strumenti](#connection-closed-before-the-tool-call-was-answered) |336| `MCP server "<name>" connection closed before the tool call was answered` | [Errori degli strumenti](#connection-closed-before-the-tool-call-was-answered) |

337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Errori degli strumenti](#mcp-server-is-disabled) |337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Errori degli strumenti](#mcp-server-is-disabled) |

338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Errori degli strumenti](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Errori degli strumenti](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |

339| `Permission prompt tool returned an invalid result` | [Errori degli strumenti](#permission-prompt-tool-returned-an-invalid-result) |

339| `would be spawned with zero tools — refusing` | [Errori degli strumenti](#agent-would-be-spawned-with-zero-tools) |340| `would be spawned with zero tools — refusing` | [Errori degli strumenti](#agent-would-be-spawned-with-zero-tools) |

340| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |341| `File is covered by a Read deny rule in your permission settings` | [Errori degli strumenti](#file-is-covered-by-a-read-deny-rule) |

341| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Errori degli strumenti](#setting-blocks-writes-outside-the-working-directories) |342| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Errori degli strumenti](#setting-blocks-writes-outside-the-working-directories) |


420| `The Claude Code program for this computer, the <build> build, could not be found` | [Errori di wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |421| `The Claude Code program for this computer, the <build> build, could not be found` | [Errori di wrapper e IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |

421| `Restored the code, but skipped N files` | [Avvisi e errori di Rewind](#restored-the-code-but-skipped-files) |422| `Restored the code, but skipped N files` | [Avvisi e errori di Rewind](#restored-the-code-but-skipped-files) |

422| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Avvisi e errori di Rewind](#no-files-were-restored) |423| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Avvisi e errori di Rewind](#no-files-were-restored) |

424| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Seleziona di nuovo lo stesso punto in [`/rewind`](https://code.claude.com/docs/it/checkpointing). Quando ripristini il codice subito dopo [`/branch`](https://code.claude.com/docs/it/sessions#branch-a-session), Claude Code potrebbe ancora star copiando i backup dei file nella nuova sessione. |

423| `Transcript writes are failing (...)` | [Avvisi di salvataggio della sessione](#transcript-writes-are-failing) |425| `Transcript writes are failing (...)` | [Avvisi di salvataggio della sessione](#transcript-writes-are-failing) |

424| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Avvisi di salvataggio della sessione](#transcript-saving-is-off-skip-prompt-history) |426| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Avvisi di salvataggio della sessione](#transcript-saving-is-off-skip-prompt-history) |

425| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Avvisi di salvataggio della sessione](#transcript-saving-is-off-child-session-marker) |427| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Avvisi di salvataggio della sessione](#transcript-saving-is-off-child-session-marker) |


431| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Avvisi di configurazione](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |433| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Avvisi di configurazione](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

432| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Avvisi di configurazione](#skill-or-command-name-refused) |434| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Avvisi di configurazione](#skill-or-command-name-refused) |

433| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |435| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avvisi di configurazione](#workspace-has-not-been-trusted) |

436| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Avvisi di configurazione](#two-claude-code-config-files-exist) |

434| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avvisi di configurazione](#make-this-change-again-later) |437| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avvisi di configurazione](#make-this-change-again-later) |

435| `is a network path, which cannot be added as a working directory` | [Avvisi di configurazione](#working-directory-is-a-network-path) |438| `is a network path, which cannot be added as a working directory` | [Avvisi di configurazione](#working-directory-is-a-network-path) |

436| `Remote managed settings failed to load (<cause>)` | [Avvisi di configurazione](#remote-managed-settings-failed-to-load) |439| `Remote managed settings failed to load (<cause>)` | [Avvisi di configurazione](#remote-managed-settings-failed-to-load) |


468| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valori e avvisi per `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/it/model-config#claude_code_auto_compact_window-values) |471| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valori e avvisi per `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/it/model-config#claude_code_auto_compact_window-values) |

469| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correggi la finestra per un gateway o un ID modello personalizzato](https://code.claude.com/docs/it/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |472| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correggi la finestra per un gateway o un ID modello personalizzato](https://code.claude.com/docs/it/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

470| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correggi la finestra per un gateway o un ID modello personalizzato](https://code.claude.com/docs/it/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |473| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correggi la finestra per un gateway o un ID modello personalizzato](https://code.claude.com/docs/it/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

474| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Correggere un nome di modello digitato male](https://code.claude.com/docs/it/model-config.md#fix-a-mistyped-model-name) |

471| `[claude-code:unrecognized_model]` | [Avvisi di configurazione](#unrecognized-model-id-on-a-request) |475| `[claude-code:unrecognized_model]` | [Avvisi di configurazione](#unrecognized-model-id-on-a-request) |

472| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Avvisi di configurazione](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |476| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Avvisi di configurazione](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |

473| `Sandbox mask files left behind at write-deny paths` | [Avvisi di configurazione](#stale-sandbox-mask-files-left-by-a-killed-session) |477| `Sandbox mask files left behind at write-deny paths` | [Avvisi di configurazione](#stale-sandbox-mask-files-left-by-a-killed-session) |


909Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change913Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

910```914```

911 915 

912I 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`.916I messaggi nominano il modello Fable della sessione, quindi su Fable 5.2 leggono `continuing on Fable 5.2` e `Fable 5.2 now uses usage credits`. Prima della v2.1.257, il primo messaggio iniziava `Fable 5 limit reached`.

913 917 

914Questo accade nelle sessioni [Remote Control](https://code.claude.com/docs/it/remote-control.md), nelle [sessioni in background](https://code.claude.com/docs/it/agent-view.md), nelle sessioni dei membri di un [team di agenti](https://code.claude.com/docs/it/agent-teams.md) e nelle sessioni che un'altra applicazione ospita tramite Agent SDK. Per quando Claude Code chiude il prompt, vedi [Fable and usage credits](https://code.claude.com/docs/it/model-config.md#fable-and-usage-credits).918Questo accade nelle sessioni [Remote Control](https://code.claude.com/docs/it/remote-control.md), nelle [sessioni in background](https://code.claude.com/docs/it/agent-view.md), nelle sessioni dei membri di un [team di agenti](https://code.claude.com/docs/it/agent-teams.md) e nelle sessioni che un'altra applicazione ospita tramite Agent SDK. Per quando Claude Code chiude il prompt, vedi [Fable and usage credits](https://code.claude.com/docs/it/model-config.md#fable-and-usage-credits).

915 919 


983 987 

984### Spend limit reached988### Spend limit reached

985 989 

986Ti connetti tramite un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway) e hai superato un [limite di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) 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.990Ti connetti tramite un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway) e hai raggiunto un [limite di spesa](https://code.claude.com/docs/it/claude-apps-gateway-spend-limits.md) impostato dall'operatore del gateway. Il gateway blocca le tue richieste finché l'operatore non aumenta il limite, oppure finché il limite non si ripristina se è superiore a \$0. Contrassegna ogni risposta `429` bloccata con `x-should-retry: false`, quindi nel terminale Claude Code mostra questo messaggio senza riprovare.

987 991 

988```text theme={null}992```text theme={null}

989spend limit reached (daily; resets 2026-08-09 00:00 UTC)993spend limit reached · resets Dec 1

990```994```

991 995 

992Il 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.996Controlla se il messaggio contiene una data:

997 

998* **Con una data**: il limite si ripristina alle 00:00 UTC di quella data

999* **Senza data**: il tuo limite è \$0, oppure il tuo gateway esegue una versione precedente alla v2.1.225

1000 

1001Qualsiasi altro testo nel messaggio è una nota dell'operatore del gateway.

1002 

1003Dalla v2.1.225 fino alla v2.1.319 sul server del gateway, il messaggio nominava il periodo del limite e l'ora di ripristino, come in `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`.

993 1004 

994**Cosa fare:**1005**Cosa fare:**

995 1006 

996* Attendi l'ora di ripristino che il messaggio nomina, o segui le istruzioni dell'operatore se il messaggio le contiene1007* Se il messaggio contiene una data, attendi il ripristino, oppure segui la nota dell'operatore se il messaggio ne contiene una

997* Chiedi al tuo operatore del gateway di aumentare il limite se lo raggiungi regolarmente1008* Chiedi al tuo operatore del gateway di aumentare il limite se il messaggio non contiene una data, se sei ancora bloccato dopo la data, o se raggiungi il limite regolarmente

1009 

1010Un secondo messaggio del gateway, `This request exceeds your group's budget`, significa che il [budget in pool](https://code.claude.com/docs/it/claude-apps-gateway-config.md#pooled-budget-order) del tuo gruppo è esaurito. Segui i passaggi che indica:

1011 

1012```text theme={null}

1013This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.

1014```

998 1015 

999Un 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.1016Un 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.

1000 1017 


2287 2304 

2288### Couldn't send feedback2305### Couldn't send feedback

2289 2306 

2290Un messaggio che inizia con `Couldn't send feedback` significa che il servizio di feedback non ha confermato il rapporto che hai inviato dalla [finestra di dialogo `/feedback`, `/bug` o `/share`](https://code.claude.com/docs/it/commands#all-commands), o una [bozza di feedback](https://code.claude.com/docs/it/tools-reference.md#sendfeedback-tool-behavior) in coda. Consideralo come non ricevuto. Quando dopo i due punti segue una frase sulla tua organizzazione, la tua organizzazione rifiuta il feedback e lo stesso rapporto riceverà la stessa risposta.2307Un messaggio che inizia con `Couldn't send feedback` significa che il servizio di feedback non ha confermato il rapporto che hai inviato dalla [finestra di dialogo `/feedback`, `/bug` o `/share`](https://code.claude.com/docs/it/commands#all-commands), o una [bozza di feedback](https://code.claude.com/docs/it/tools-reference.md#sendfeedback-tool-behavior) in coda. Consideralo come non ricevuto. Quando dopo i due punti segue una frase sulla tua organizzazione, la tua organizzazione rifiuta il feedback.

2291 2308 

2292Il secondo di questi due esempi è il rifiuto di un'organizzazione:2309Il secondo esempio è il rifiuto di un'organizzazione:

2293 2310 

2294```text wrap theme={null}2311```text wrap theme={null}

2295Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2312Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.


2300**Cosa fare:**2317**Cosa fare:**

2301 2318 

2302* **Accesso non effettuato**: il messaggio continua con `: not signed in. Run /login, then retry.` Esegui `/login`, quindi invia di nuovo2319* **Accesso non effettuato**: il messaggio continua con `: not signed in. Run /login, then retry.` Esegui `/login`, quindi invia di nuovo

2303* **Rifiuto della tua organizzazione**: ad esempio `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` Se il messaggio aggiunge `To report a bug, open an issue`, fallo su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Una bozza in coda rimane in coda e puoi [scartarla](https://code.claude.com/docs/it/tools-reference.md#discard-or-keep-a-draft)2320* **Rifiuto della tua organizzazione**: ad esempio `: Feedback has not been enabled for your organization.` o `: Feedback collection is not available for organizations with custom data retention policies.` Se il messaggio aggiunge `To report a bug, open an issue`, fallo su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). In seguito `/feedback` può rispondere per sette giorni che è [disabilitato dalla policy della tua organizzazione](#feedback-is-disabled-by-your-organizations-policy). Una bozza in coda rimane in coda e [scade comunque secondo la pianificazione](https://code.claude.com/docs/it/tools-reference.md#discard-or-keep-a-draft)

2304* **Credenziali rifiutate**: il messaggio continua con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Esegui `/status` al prompt di Claude Code per vedere quale login, token o chiave API invia questa sessione2321* **Credenziali rifiutate**: il messaggio continua con `: the sign-in this session uses is not allowed to send feedback` o `: the server did not accept the credentials this session uses`. Esegui `/status` al prompt di Claude Code per vedere quale login, token o chiave API invia questa sessione

2305* **`(request timed out)` o `(couldn't reach the service)` subito dopo `Couldn't send feedback`**: invia di nuovo il rapporto o la bozza in coda. La finestra di dialogo mantiene il tuo testo e il messaggio di una bozza in coda indica `The draft is still queued.` Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api). Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2322* **`(request timed out)` o `(couldn't reach the service)` subito dopo `Couldn't send feedback`**: invia di nuovo il rapporto o la bozza in coda. La finestra di dialogo mantiene il tuo testo e il messaggio di una bozza in coda indica `The draft is still queued.` Se anche altre richieste stanno fallendo, controlla la tua connessione di rete e vedi [Unable to connect to API](#unable-to-connect-to-api). Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2306* **`(server returned <status>)`, o nessun motivo, subito dopo `Couldn't send feedback`**: lo stato è il codice di risposta del servizio. Il messaggio del servizio stesso lo segue quando ne è stato inviato uno, come in `(server returned 403: Access Forbidden)`. Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2323* **`(server returned <status>)`, o nessun motivo, subito dopo `Couldn't send feedback`**: lo stato è il codice di risposta del servizio. Il messaggio del servizio stesso lo segue quando ne è stato inviato uno, come in `(server returned 403: Access Forbidden)`. Se continua a fallire, apri la segnalazione su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)


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

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

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

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

3435 3452 

3436Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.3453Prima della v2.1.309, `claude ultrareview` non accettava `--trust-workspace`.

3437 3454 


3724 3741 

3725Stringhe analoghe compaiono prima ancora che il comando venga eseguito:3742Stringhe analoghe compaiono prima ancora che il comando venga eseguito:

3726 3743 

3727* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Controlli dei permessi sui comandi iniettati](https://code.claude.com/docs/it/skills.md#permission-checks-on-injected-commands) spiega quali risultati causano l'interruzione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`3744* `Shell command permission check failed for pattern "..."`: il controllo dei permessi del comando non lo ha consentito. [Permission checks on injected commands](https://code.claude.com/docs/it/skills.md#permission-checks-on-injected-commands) spiega quali risultati causano l'interruzione in ciascuna modalità di permesso e come pre-approvare un comando con `allowed-tools`

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

3729 3746 

3730**Cosa fare:**3747**Cosa fare:**

3731 3748 


3878 3895 

3879* **Non hai passato un branch di base**: Claude Code ha effettuato il confronto con il branch predefinito del repository e suggerisce di passare esplicitamente il tuo branch di base, come nell'esempio sopra3896* **Non hai passato un branch di base**: Claude Code ha effettuato il confronto con il branch predefinito del repository e suggerisce di passare esplicitamente il tuo branch di base, come nell'esempio sopra

3880* **Hai passato un branch di base già presente nel tuo clone**: il suggerimento è ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3897* **Hai passato un branch di base già presente nel tuo clone**: il suggerimento è ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``

3881* **Hai passato un branch di base non presente nel tuo clone**: Claude Code lo ha recuperato da origin prima del confronto. Il suggerimento recita ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando Claude Code non riesce a determinare se il tuo clone è shallow, suggerisce invece `git fetch --unshallow origin`. Prima della v2.1.221, il suggerimento proponeva `git fetch --unshallow origin` per ogni branch di base recuperato, e su un clone completo quel comando fallisce con `fatal: --unshallow on a complete repository does not make sense`.3898* **Hai passato un branch di base che non era nel tuo clone**: Claude Code lo ha recuperato da origin prima del confronto. Il suggerimento recita ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; quando Claude Code non riesce a stabilire se il tuo clone è shallow, suggerisce invece `git fetch --unshallow origin`. Prima della v2.1.221, il suggerimento proponeva `git fetch --unshallow origin` per ogni branch di base recuperato, e su un clone completo quel comando fallisce con `fatal: --unshallow on a complete repository does not make sense`.

3882 3899 

3883**Cosa fare:**3900**Cosa fare:**

3884 3901 


4227 4244 

4228### /feedback is disabled by your organization's policy4245### /feedback is disabled by your organization's policy

4229 4246 

4230Questo messaggio significa che la policy della tua organizzazione non consente l'invio di feedback sul prodotto da Claude Code, quindi `/feedback`, `/bug` e `/share` non aprono la finestra di dialogo del feedback. Il messaggio indica il comando che hai digitato al prompt di Claude Code:4247Questo messaggio indica che il feedback sul prodotto è disattivato, quindi il comando che hai digitato non apre la finestra di dialogo del feedback. Sia una policy dell'organizzazione sia un rifiuto precedente producono il messaggio:

4248 

4249* **Policy dell'organizzazione**: la policy della tua organizzazione non consente il feedback sul prodotto da Claude Code. `/feedback`, `/bug` e `/share` rispondono tutti con il messaggio.

4250* **Rifiuto precedente**: il servizio di feedback ha rifiutato una segnalazione che hai inviato, ad esempio con [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` e `/bug` possono quindi rispondere con il messaggio. Questo dura sette giorni da quel rifiuto su questa macchina. Vale per ogni piano, inclusi Pro e Max.

4251 

4252Il messaggio indica il comando che hai digitato al prompt di Claude Code:

4231 4253 

4232```text wrap theme={null}4254```text wrap theme={null}

4233/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4255/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.


4238**Cosa fare:**4260**Cosa fare:**

4239 4261 

4240* Per segnalare un bug, apri una issue su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Chiunque può leggere le issue lì, quindi ometti codice, trascrizioni e qualsiasi altra informazione riservata.4262* Per segnalare un bug, apri una issue su [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Chiunque può leggere le issue lì, quindi ometti codice, trascrizioni e qualsiasi altra informazione riservata.

4263* Dopo un rifiuto precedente, attendi che siano trascorsi i sette giorni, quindi invia di nuovo una segnalazione per verificare se il servizio la rifiuta ancora

4264 

4265Prima della v2.1.319, un rifiuto precedente non produceva questo messaggio.

4241 4266 

4242Prima della v2.1.302, il messaggio completo era `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`4267Prima della v2.1.302, il messaggio completo era `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

4243 4268 


4654* Per concedere più tempo a una risposta, imposta un [`timeout`](https://code.claude.com/docs/it/mcp#time-limits-on-mcp-tool-calls) più lungo in millisecondi nella voce di configurazione del server, come `"timeout": 600000` per 10 minuti4679* Per concedere più tempo a una risposta, imposta un [`timeout`](https://code.claude.com/docs/it/mcp#time-limits-on-mcp-tool-calls) più lungo in millisecondi nella voce di configurazione del server, come `"timeout": 600000` per 10 minuti

4655* Esegui invece l'attività in una sessione interattiva e rispondi tu stesso alla [finestra di dialogo](https://code.claude.com/docs/it/mcp.md#respond-to-mcp-elicitation-requests) del server4680* Esegui invece l'attività in una sessione interattiva e rispondi tu stesso alla [finestra di dialogo](https://code.claude.com/docs/it/mcp.md#respond-to-mcp-elicitation-requests) del server

4656 4681 

4682### Permission prompt tool returned an invalid result

4683 

4684Lo strumento che hai passato a [`--permission-prompt-tool`](https://code.claude.com/docs/it/cli-reference#cli-flags) ha restituito una risposta che Claude Code non è riuscito a leggere, quindi la chiamata allo strumento che la attendeva non è stata eseguita, anche se la risposta consentiva la chiamata:

4685 

4686```text wrap theme={null}

4687Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.

4688```

4689 

4690**Cosa fare:**

4691 

4692* Restituisci un solo blocco di testo il cui testo sia `{"behavior": "allow"}` oppure `{"behavior": "deny", "message": "<reason>"}`. Per modificare l'input, aggiungi `updatedInput` all'oggetto `allow`. Dalla v2.1.86 alla v2.1.206, un `allow` richiedeva `"updatedInput": {}` per mantenere l'input.

4693* Non restituire alcun [`structuredContent`](https://code.claude.com/docs/it/agent-sdk/custom-tools#return-structured-data), che il tuo MCP SDK potrebbe aggiungere da solo. Ad esempio, registra lo strumento:

4694 * **`FastMCP` o `MCPServer` da `mcp.server`**: con `structured_output=False`

4695 * **`FastMCP` da `fastmcp`**: con `output_schema=None`, e restituisci una stringa

4696 * **MCP TypeScript SDK**: senza `outputSchema`

4697* Se l'errore si presenta solo con input di circa 40 KB o più, non copiare l'input in `updatedInput` o nel `message` di un deny. Per modificare un input così grande, [aumenta il limite di output del tuo strumento di prompt](https://code.claude.com/docs/it/mcp.md#raise-the-limit-for-a-specific-tool).

4698 

4657### Agent would be spawned with zero tools4699### Agent would be spawned with zero tools

4658 4700 

4659Nessuna voce nell'[elenco `tools`](https://code.claude.com/docs/it/sub-agents#supported-frontmatter-fields) del subagent corrispondeva a uno strumento utilizzabile, quindi Claude Code si è rifiutato di avviare il subagent: senza strumenti, non avrebbe potuto agire. Il messaggio raggruppa le tue voci in base a cosa è andato storto:4701Nessuna voce nell'[elenco `tools`](https://code.claude.com/docs/it/sub-agents#supported-frontmatter-fields) del subagent corrispondeva a uno strumento utilizzabile, quindi Claude Code si è rifiutato di avviare il subagent: senza strumenti, non avrebbe potuto agire. Il messaggio raggruppa le tue voci in base a cosa è andato storto:


6432 6474 

6433Prima della v2.1.257, `claude doctor` non contrassegnava questi file; le versioni precedenti lasciano gli stessi segnaposti dietro quando una sessione viene uccisa.6475Prima della v2.1.257, `claude doctor` non contrassegnava questi file; le versioni precedenti lasciano gli stessi segnaposti dietro quando una sessione viene uccisa.

6434 6476 

6477### Two Claude Code config files exist

6478 

6479Claude Code sta usando il primo file nominato da questo messaggio, quindi il contenuto del secondo file non è in vigore. Il primo è `.config.json`, un nome precedente di [`.claude.json`](https://code.claude.com/docs/it/claude-directory#ce-claude-json). Il messaggio include un controllo per capire quale file contiene la tua configurazione:

6480 

6481```text wrap theme={null}

6482Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.

6483```

6484 

6485Su Windows, `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` sostituisce la frase con il comando `grep`.

6486 

6487**Cosa fare:**

6488 

6489**1. Trova il file che contiene la tua configurazione**

6490 

6491* **Su Windows**: apri entrambi i file e verifica quale contiene `hasCompletedOnboarding` o `mcpServers`

6492* **Sulle altre piattaforme**: nella tua shell, esegui il comando `grep` del messaggio e verifica quale file ha il conteggio più alto

6493 

6494**2. Aggiorna ogni host che condivide la directory home**

6495 

6496Se più host condividono questa directory home, aggiorna prima Claude Code su ogni host alla versione indicata dal messaggio o successiva. Una versione precedente può riscrivere un `.config.json` spostato.

6497 

6498**3. Arresta Claude Code**

6499 

6500Arresta i processi di Claude Code su ogni host.

6501 

6502**4. Sposta il file che non vuoi**

6503 

6504Sposta fuori dalla sua cartella il file che non vuoi. Spostalo anziché eliminarlo, così puoi rimetterlo al suo posto.

6505 

6506**5. Attendi prima di avviare di nuovo Claude Code**

6507 

6508Non avviare Claude Code su alcun host finché nessun host elenca più il file spostato nel suo vecchio percorso.

6509 

6510Il messaggio smette di comparire quando uno dei due file non c'è più.

6511 

6435### Make this change again later: \~/.claude.json could not be updated6512### Make this change again later: \~/.claude.json could not be updated

6436 6513 

6437Questo avviso su stderr significa che una modifica a [`~/.claude.json`](https://code.claude.com/docs/it/claude-directory#ce-claude-json), come un accesso o una risposta a una richiesta di fiducia, non è stata salvata nel file:6514Questo avviso su stderr significa che una modifica a [`~/.claude.json`](https://code.claude.com/docs/it/claude-directory#ce-claude-json), come un accesso o una risposta a una richiesta di fiducia, non è stata salvata nel file:


6450 6527 

6451* Un [`--fallback-model`](https://code.claude.com/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione6528* Un [`--fallback-model`](https://code.claude.com/docs/it/cli-reference#cli-flags) configurato subentra dopo un errore di disponibilità, solo per quel turno, con un avviso nella trascrizione

6452* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile, oppure il tuo account [perde l'accesso ad esso durante la sessione](https://code.claude.com/docs/it/amazon-bedrock.md#when-a-model-is-disabled-mid-session)6529* Un controllo di avvio di Amazon Bedrock o della piattaforma Agent di Google Cloud trova il tuo modello predefinito non disponibile, oppure il tuo account [perde l'accesso ad esso durante la sessione](https://code.claude.com/docs/it/amazon-bedrock.md#when-a-model-is-disabled-mid-session)

6453* Il [fallback automatico del modello](https://code.claude.com/docs/it/model-config.md#automatic-model-fallback) su Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno, e mostra un avviso nella trascrizione6530* Il [fallback automatico del modello](https://code.claude.com/docs/it/model-config.md#automatic-model-fallback) sui modelli Fable, Opus 5.5, Sonnet 5.5 e Opus 5 sposta la sessione al modello di fallback della categoria contrassegnata, quando quella categoria ne ha uno. Nella trascrizione appare un avviso

6454 6531 

6455Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](https://code.claude.com/docs/it/model-config.md) spiega quando si applica ogni fallback.6532Il controllo della selezione del modello di seguito cattura il secondo e il terzo caso; il primo appare come un avviso nella trascrizione piuttosto che come un cambio `/model`. La [configurazione del modello](https://code.claude.com/docs/it/model-config.md) spiega quando si applica ogni fallback.

6456 6533 

fast-mode.md +21 −16

Details

4 4 

5# Accelera le risposte con la modalità veloce5# Accelera le risposte con la modalità veloce

6 6 

7> Ottieni risposte più veloci di Opus in Claude Code attivando la modalità veloce.7> Ottieni risposte più veloci di Opus e Fable in Claude Code attivando la modalità veloce con `/fast`.

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> La modalità veloce per Claude Opus 5.5 è disponibile, mentre la modalità veloce per Claude Opus 5 e Claude Opus 4.8 è in [anteprima di ricerca](#research-preview).11> La modalità veloce per Claude Fable 5.2 e Claude Opus 5.5 è disponibile. La modalità veloce per Claude Opus 5 e Claude Opus 4.8 è in [anteprima di ricerca](#research-preview).

12 12 

13La modalità veloce è una configurazione ad alta velocità per Claude Opus, che rende il modello fino a 2,5 volte più veloce a un costo per token più elevato. Attivala con `/fast` quando hai bisogno di velocità per il lavoro interattivo come l'iterazione rapida o il debug in tempo reale, e disattivala quando il costo è più importante della latenza.13La modalità veloce è una configurazione ad alta velocità per i modelli supportati, che rende il modello fino a 2,5 volte più veloce a un costo per token più elevato. Attivala con `/fast` quando hai bisogno di velocità per il lavoro interattivo come l'iterazione rapida o il debug in tempo reale, e disattivala quando il costo è più importante della latenza.

14 14 

15La modalità veloce non è un modello diverso. Utilizza Claude Opus con una configurazione API diversa che dà priorità alla velocità rispetto all'efficienza dei costi. Ottieni la stessa qualità e capacità con risposte più veloci. La modalità veloce è supportata su Opus 5.5, Opus 5 e Opus 4.8. Non è disponibile su Sonnet, Haiku o altri modelli.15La modalità veloce utilizza lo stesso modello con una configurazione API diversa che dà priorità alla velocità rispetto all'efficienza dei costi, quindi qualità e capacità restano le stesse. La modalità veloce è supportata su Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8. Non è disponibile su Sonnet, Haiku o altri modelli.

16 16 

17> [!WARNING]17> [!WARNING]

18>18>


26Cosa sapere:26Cosa sapere:

27 27 

28* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. L'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md) offre un comando **Toggle fast mode** quando il modello selezionato supporta la modalità veloce. Claude Code salva tale attivazione/disattivazione nella tua impostazione [`fastMode`](#toggle-fast-mode).28* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. L'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md) offre un comando **Toggle fast mode** quando il modello selezionato supporta la modalità veloce. Claude Code salva tale attivazione/disattivazione nella tua impostazione [`fastMode`](#toggle-fast-mode).

29* I prezzi della modalità veloce per MTok input/output sono \$8/\$40 su Opus 5.5 e \$10/\$50 su Opus 5 e Opus 4.8.29* I prezzi della modalità veloce per MTok input/output sono \$16/\$80 su Fable 5.2, \$8/\$40 su Opus 5.5 e \$10/\$50 su Opus 5 e Opus 4.8.

30* Disponibile per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise) e su Claude Console. Le organizzazioni Team ed Enterprise hanno bisogno che un Owner la abiliti prima, e le organizzazioni Console hanno bisogno che l'accesso sia fornito prima di poterla usare con Opus 5 o Opus 4.8. [Requisiti](#requirements) descrive entrambi i casi.30* Disponibile per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise) e su Claude Console. Le organizzazioni Team ed Enterprise hanno bisogno che un Owner la abiliti prima, e le organizzazioni Console hanno bisogno che l'accesso sia fornito prima di poterla usare con Opus 5 o Opus 4.8. [Requisiti](#requirements) descrive entrambi i casi.

31* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei rate limit dell'abbonamento.31* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei rate limit dell'abbonamento.

32 32 


35Nella CLI, attiva o disattiva la modalità veloce in uno di questi modi:35Nella CLI, attiva o disattiva la modalità veloce in uno di questi modi:

36 36 

37* Esegui `/fast`, premi Space per attivarla o disattivarla, quindi premi Enter per confermare37* Esegui `/fast`, premi Space per attivarla o disattivarla, quindi premi Enter per confermare

38* Su un modello che supporta la modalità veloce, imposta `"fastMode": true` nel tuo [file di impostazioni utente](https://code.claude.com/docs/it/settings.md). Se la imposti su qualsiasi altro modello, rimani su quel modello con la modalità veloce disattivata.38* Su un modello che supporta la modalità veloce, imposta `"fastMode": true` nel tuo [file di impostazioni utente](https://code.claude.com/docs/it/settings.md). Se la imposti su qualsiasi altro modello, rimani su quel modello con la modalità veloce disattivata. Su Fable 5.2, quell'impostazione da sola non ha effetto finché non esegui `/fast` mentre usi Fable 5.2.

39 39 

40Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni su un modello supportato. Puoi configurare la modalità veloce in modo che si reimposti a ogni sessione. Consulta [richiedere l'attivazione per sessione](#require-per-session-opt-in) per i dettagli.40Per impostazione predefinita, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni su un modello supportato. Su Fable 5.2, persiste solo se l'hai [attivata mentre usavi Fable 5.2](#switch-models-while-fast-mode-is-on). Puoi configurare la modalità veloce in modo che si reimposti a ogni sessione. Consulta [richiedere l'attivazione per sessione](#require-per-session-opt-in) per i dettagli.

41 41 

42Al di fuori di una [sessione cloud](#use-fast-mode-in-cloud-sessions), in [modalità non interattiva](https://code.claude.com/docs/it/headless.md) con il flag `-p`, `/fast` funziona solo in una sessione avviata con la modalità veloce nel valore di [`--settings`](https://code.claude.com/docs/it/cli-reference#cli-flags), ad esempio `claude -p --settings '{"fastMode": true}'`; l'attivazione o disattivazione si applica quindi solo a quella sessione e non viene salvata come impostazione predefinita. La forma con `-p` richiede Claude Code v2.1.205 o successiva. Altrove in modalità non interattiva, il comando segnala che la modalità veloce non è disponibile.42Al di fuori di una [sessione cloud](#use-fast-mode-in-cloud-sessions), in [modalità non interattiva](https://code.claude.com/docs/it/headless.md) con il flag `-p`, `/fast` funziona solo in una sessione avviata con la modalità veloce nel valore di [`--settings`](https://code.claude.com/docs/it/cli-reference#cli-flags), ad esempio `claude -p --settings '{"fastMode": true}'`; l'attivazione o disattivazione si applica quindi solo a quella sessione e non viene salvata come impostazione predefinita. La forma con `-p` richiede Claude Code v2.1.205 o successiva. Altrove in modalità non interattiva, il comando segnala che la modalità veloce non è disponibile.

43 43 


48Quando attivi la modalità veloce con `/fast`:48Quando attivi la modalità veloce con `/fast`:

49 49 

50* Se il tuo modello attuale non supporta la modalità veloce, Claude Code passa a Opus50* Se il tuo modello attuale non supporta la modalità veloce, Claude Code passa a Opus

51* La modalità veloce su Fable 5.2 richiede Claude Code v2.1.321 o successiva

51* Vedrai un messaggio di conferma: "Fast mode ON"52* Vedrai un messaggio di conferma: "Fast mode ON"

52* Una piccola icona `↯` appare accanto al prompt mentre la modalità veloce è attiva53* Una piccola icona `↯` appare accanto al prompt mentre la modalità veloce è attiva

53* Esegui di nuovo `/fast` in qualsiasi momento per verificare se la modalità veloce è attiva o disattivata54* Esegui di nuovo `/fast` in qualsiasi momento per verificare se la modalità veloce è attiva o disattivata

54 55 

55Opus 5.5 è il modello predefinito della modalità veloce in Claude Code v2.1.280 e successive. Prima della v2.1.280, la modalità veloce usava come predefinito Opus 5 a partire dalla v2.1.219.56Opus 5.5 è il modello predefinito della modalità veloce in Claude Code v2.1.280 e successive. Prima della v2.1.280, la modalità veloce usava come predefinito Opus 5 a partire dalla v2.1.219.

56 57 

57Quando disattivi la modalità veloce eseguendo di nuovo `/fast`, rimani su Opus. Per passare a un modello diverso, usa `/model`.58Quando disattivi la modalità veloce eseguendo di nuovo `/fast`, rimani sul tuo modello attuale. Per passare a un modello diverso, usa `/model`.

58 59 

59### Cambiare modello mentre la modalità veloce è attiva60### Cambiare modello mentre la modalità veloce è attiva

60 61 

61La modalità veloce segue i tuoi cambi di modello in entrambe le direzioni:62La modalità veloce segue i tuoi cambi di modello:

62 63 

63* **Passaggio a un altro modello**: quando passi a un modello che non supporta la modalità veloce, Claude Code disattiva la modalità veloce. Questo include Opus 4.7; prima della v2.1.221, la modalità veloce rimaneva attiva dopo il passaggio a Opus 4.7 e l'API rifiutava le richieste.64* **Passaggio a un altro modello**: quando passi a un modello che non supporta la modalità veloce, Claude Code disattiva la modalità veloce. Questo include Opus 4.7; prima della v2.1.221, la modalità veloce rimaneva attiva dopo il passaggio a Opus 4.7 e l'API rifiutava le richieste.

64* **Ritorno**: tornare a un modello Opus supportato riattiva la modalità veloce quando la tua preferenza salvata per la modalità veloce è attiva, la stessa preferenza da cui parte per impostazione predefinita una nuova sessione. Un cambio di modello non attiva mai la modalità veloce per una sessione la cui preferenza salvata è disattivata, e con l'[attivazione per sessione](#require-per-session-opt-in) configurata, nemmeno il ritorno la attiva; esegui `/fast` per riattivarla.65* **Ritorno**: la modalità veloce si riattiva su un modello Opus supportato quando la tua preferenza salvata è attiva. Con l'[attivazione per sessione](#require-per-session-opt-in), esegui invece `/fast`.

66* **Passaggio a Fable 5.2**: la modalità veloce si disattiva a meno che tu non l'abbia attivata mentre usavi Fable 5.2. Per attivarla, esegui `/fast` su Fable 5.2. A meno che tu non abbia impostato l'[attivazione per sessione](#require-per-session-opt-in), l'attivazione persiste tra le sessioni finché non la disattivi o non la attivi con un altro modello.

65 67 

66Ogni volta che un cambio di modello attiva o disattiva la modalità veloce, Claude Code mostra una conferma `Fast mode ON` o `Fast mode OFF`, e l'icona `↯` appare mentre la modalità veloce è attiva. Questo vale sia che cambi modello con `/model`, con [`/config model=<model>`](https://code.claude.com/docs/it/settings), o da un dispositivo connesso tramite [Remote Control](https://code.claude.com/docs/it/remote-control.md).68Ogni volta che un cambio di modello attiva o disattiva la modalità veloce, Claude Code mostra una conferma `Fast mode ON` o `Fast mode OFF`, e l'icona `↯` appare mentre la modalità veloce è attiva. Questo vale sia che cambi modello con `/model`, con [`/config model=<model>`](https://code.claude.com/docs/it/settings), o da un dispositivo connesso tramite [Remote Control](https://code.claude.com/docs/it/remote-control.md).

67 69 


77 79 

78## Comprendi il compromesso di costo80## Comprendi il compromesso di costo

79 81 

80La modalità veloce ha un prezzo per token più elevato rispetto a Opus standard:82La modalità veloce ha un prezzo per token più elevato rispetto alla velocità standard:

81 83 

82| Modello | Input (MTok) | Output (MTok) |84| Modello | Input (MTok) | Output (MTok) |

83| - | - | - |85| - | - | - |

86| Fable 5.2 | \$16 | \$80 |

84| Opus 5.5 | \$8 | \$40 |87| Opus 5.5 | \$8 | \$40 |

85| Opus 5 | \$10 | \$50 |88| Opus 5 | \$10 | \$50 |

86| Opus 4.8 | \$10 | \$50 |89| Opus 4.8 | \$10 | \$50 |

87 90 

88I prezzi della modalità veloce sono fissi su tutta la finestra di contesto di 1M token. Per il tasso Opus standard da confrontare, consulta il [riferimento sui prezzi di Claude](https://platform.claude.com/docs/it/about-claude/pricing).91I prezzi della modalità veloce sono fissi su tutta la finestra di contesto di 1M token. Per il tasso standard da confrontare, consulta il [riferimento sui prezzi di Claude](https://platform.claude.com/docs/it/about-claude/pricing).

89 92 

90La prima volta che abiliti la modalità veloce in una conversazione, paghi il prezzo completo del token di input non memorizzato nella cache della modalità veloce per l'intero contesto della conversazione. Più avanti sei nella conversazione, più questo costa, quindi l'addebito è minimo quando abiliti la modalità veloce all'inizio. La modalità veloce e la velocità standard mantengono [cache separate](https://code.claude.com/docs/it/prompt-caching.md#turning-on-fast-mode), quindi ogni passaggio successivo rilegge di nuovo una parte o l'intera conversazione senza cache.93La prima volta che abiliti la modalità veloce in una conversazione, paghi il prezzo completo del token di input non memorizzato nella cache della modalità veloce per l'intero contesto della conversazione. Più avanti sei nella conversazione, più questo costa, quindi l'addebito è minimo quando abiliti la modalità veloce all'inizio. La modalità veloce e la velocità standard mantengono [cache separate](https://code.claude.com/docs/it/prompt-caching.md#turning-on-fast-mode), quindi ogni passaggio successivo rilegge di nuovo una parte o l'intera conversazione senza cache.

91 94 


137 140 

138* **Organizzazione Console a pagamento**: gli account Claude Console non utilizzano crediti di utilizzo e la tua organizzazione paga la modalità veloce per token insieme al resto dell'utilizzo dell'API. Nel piano Evaluation gratuito della Console, `/fast` mostra "Fast mode unavailable during evaluation. Please purchase credits." Per cancellarlo, acquista crediti nelle tue [impostazioni di fatturazione della Console](https://platform.claude.com/settings/billing).141* **Organizzazione Console a pagamento**: gli account Claude Console non utilizzano crediti di utilizzo e la tua organizzazione paga la modalità veloce per token insieme al resto dell'utilizzo dell'API. Nel piano Evaluation gratuito della Console, `/fast` mostra "Fast mode unavailable during evaluation. Please purchase credits." Per cancellarlo, acquista crediti nelle tue [impostazioni di fatturazione della Console](https://platform.claude.com/settings/billing).

139 142 

140 La modalità veloce con Opus 5.5 dipende anche dal [livello di utilizzo](https://platform.claude.com/docs/en/api/rate-limits) della tua organizzazione.143 La modalità veloce con Fable 5.2 o Opus 5.5 dipende anche dal [livello di utilizzo](https://platform.claude.com/docs/en/api/rate-limits) della tua organizzazione.

141* **Abilitazione del proprietario per Team e Enterprise**: la modalità veloce è disabilitata per impostazione predefinita per le organizzazioni Team e Enterprise. Un proprietario deve esplicitamente [abilitare la modalità veloce](#enable-fast-mode-for-your-organization) prima che gli utenti possano accedervi.144* **Abilitazione del proprietario per Team e Enterprise**: la modalità veloce è disabilitata per impostazione predefinita per le organizzazioni Team e Enterprise. Un proprietario deve esplicitamente [abilitare la modalità veloce](#enable-fast-mode-for-your-organization) prima che gli utenti possano accedervi.

142 145 

143> [!NOTE]146> [!NOTE]


147> * **Modalità veloce non abilitata**: se la modalità veloce non è stata abilitata per la tua organizzazione, l'attivazione della modalità veloce con `/fast` mostra "Fast mode has been disabled by your organization."150> * **Modalità veloce non abilitata**: se la modalità veloce non è stata abilitata per la tua organizzazione, l'attivazione della modalità veloce con `/fast` mostra "Fast mode has been disabled by your organization."

148> * **Modalità veloce disattivata dalle impostazioni gestite**: se la tua organizzazione distribuisce [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) che impostano [`fastMode: false`](https://code.claude.com/docs/it/settings-reference#fastmode), l'attivazione della modalità veloce con `/fast` mostra lo stesso messaggio "Fast mode has been disabled by your organization".151> * **Modalità veloce disattivata dalle impostazioni gestite**: se la tua organizzazione distribuisce [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) che impostano [`fastMode: false`](https://code.claude.com/docs/it/settings-reference#fastmode), l'attivazione della modalità veloce con `/fast` mostra lo stesso messaggio "Fast mode has been disabled by your organization".

149> * **Opt-in per sessione richiesto**: le impostazioni gestite che impostano [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) rifiutano `/fast on` con lo stesso messaggio ovunque tranne in una sessione di terminale interattiva.152> * **Opt-in per sessione richiesto**: le impostazioni gestite che impostano [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) rifiutano `/fast on` con lo stesso messaggio ovunque tranne in una sessione di terminale interattiva.

150> * **Modello modalità veloce non consentito**: se l'elenco di consentiti [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude il modello Opus della modalità veloce, l'attivazione viene rifiutata con "is not in your organization's allowed models". In una sessione già in esecuzione su un modello Opus consentito che supporta la modalità veloce, `/fast` abilita invece la modalità veloce sul tuo modello attuale senza cambiare modelli.153> * **Modello modalità veloce non consentito**: se l'allowlist [`availableModels`](https://code.claude.com/docs/it/model-config#restrict-model-selection) della tua organizzazione esclude il modello Opus della modalità veloce, l'attivazione viene rifiutata con "is not in your organization's allowed models". In una sessione già in esecuzione su un modello consentito che supporta la modalità veloce, `/fast` abilita invece la modalità veloce sul tuo modello attuale senza cambiare modelli.

151 154 

152### Abilita la modalità veloce per la tua organizzazione155### Abilita la modalità veloce per la tua organizzazione

153 156 


196 199 

197### Richiedi opt-in per sessione200### Richiedi opt-in per sessione

198 201 

199Per impostazione predefinita, la modalità veloce che un utente attiva in una sessione interattiva persiste tra le sessioni su un modello supportato. Per modificare questo, imposta `fastModePerSessionOptIn` a `true` in qualsiasi [file di impostazioni](https://code.claude.com/docs/it/settings.md#where-settings-live), il che fa sì che ogni sessione inizi con la modalità veloce disattivata e richiede agli utenti di abilitarla esplicitamente con `/fast`. Gli Owner sui piani [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) o [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) possono distribuirlo a livello organizzativo tramite [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md).202Per impostazione predefinita, la modalità veloce che un utente attiva in una sessione interattiva persiste tra le sessioni su un modello supportato. Su Fable 5.2, persiste solo se l'utente [l'ha attivata mentre usava Fable 5.2](#switch-models-while-fast-mode-is-on).

203 

204Per fare in modo che ogni sessione inizi con la modalità veloce disattivata, imposta `fastModePerSessionOptIn` a `true` in qualsiasi [file di impostazioni](https://code.claude.com/docs/it/settings.md#where-settings-live). Gli utenti la abilitano quindi con `/fast` in ogni sessione. Gli Owner sui piani [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) o [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) possono distribuirlo a livello organizzativo tramite [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md).

200 205 

201```json theme={null}206```json theme={null}

202{207{


210 215 

211## Gestisci i limiti di velocità216## Gestisci i limiti di velocità

212 217 

213La modalità veloce ha rate limit separati da Opus standard; per le organizzazioni Console, la pagina [rate limit](https://platform.claude.com/docs/en/api/rate-limits) della Claude Platform li descrive. Quando raggiungi il rate limit della modalità veloce:218La modalità veloce ha rate limit separati dalla velocità standard; per le organizzazioni Console, la pagina [rate limit](https://platform.claude.com/docs/en/api/rate-limits) della Claude Platform li descrive. Quando raggiungi il rate limit della modalità veloce:

214 219 

2151. La modalità veloce torna automaticamente alla velocità standard2201. La modalità veloce torna automaticamente alla velocità standard

2162. L'icona `↯` diventa grigia per indicare il raffreddamento2212. L'icona `↯` diventa grigia per indicare il raffreddamento

hooks.md +12 −4

Details

1089 1089 

1090#### Emettere notifiche del terminale1090#### Emettere notifiche del terminale

1091 1091 

1092Gli hook vengono eseguiti senza un terminale di controllo, quindi scrivere sequenze di escape direttamente su `/dev/tty` non funziona. Restituisci invece la sequenza di escape nel campo `terminalSequence` e Claude Code la emette per te attraverso il proprio percorso di scrittura sul terminale. Questo è privo di race condition, funziona all'interno di tmux e GNU screen, e funziona su Windows dove non esiste `/dev/tty`.1092Gli hook vengono eseguiti senza un terminale di controllo, quindi scrivere sequenze di escape direttamente su `/dev/tty` non funziona. Restituisci invece la sequenza di escape nel campo `terminalSequence` e Claude Code la emette per te attraverso il proprio percorso di scrittura sul terminale. Questo è privo di race condition e funziona su Windows dove non esiste `/dev/tty`.

1093 1093 

1094Il campo accetta una stringa di una o più sequenze di escape presenti nell'allowlist:1094Il campo accetta una stringa di una o più sequenze di escape presenti nell'allowlist:

1095 1095 


1101 1101 

1102Le sequenze possono essere terminate con BEL o con ST. Qualsiasi cosa al di fuori dell'allowlist, incluse le sequenze CSI per cursore e colore, le sequenze OSC della tavolozza, i collegamenti ipertestuali OSC 8, le scritture negli appunti OSC 52 e OSC 1337, viene rifiutata e il campo viene ignorato.1102Le sequenze possono essere terminate con BEL o con ST. Qualsiasi cosa al di fuori dell'allowlist, incluse le sequenze CSI per cursore e colore, le sequenze OSC della tavolozza, i collegamenti ipertestuali OSC 8, le scritture negli appunti OSC 52 e OSC 1337, viene rifiutata e il campo viene ignorato.

1103 1103 

1104Claude Code scrive la sequenza autonomamente quando elabora l'output del tuo hook, quindi il campo funziona sugli eventi che scartano `systemMessage` e `continue`, come `Notification` e `StopFailure`. Ha due limiti:1104Claude Code scrive la sequenza autonomamente quando elabora l'output del tuo hook, quindi il campo funziona sugli eventi che scartano `systemMessage` e `continue`, come `Notification` e `StopFailure`. Ha alcuni limiti:

1105 1105 

1106* Claude Code scrive la sequenza solo in una sessione interattiva, e solo mentre la sua interfaccia è sullo schermo. In modalità non interattiva con il flag `-p` e nell'Agent SDK, ignora il campo.1106* Claude Code scrive la sequenza solo in una sessione interattiva, e solo mentre la sua interfaccia è aperta. In modalità non interattiva con il flag `-p` e nell'Agent SDK, ignora il campo.

1107* Il campo funziona solo da un hook che non viene eseguito in [background](#run-hooks-in-the-background), quindi lascia disattivati `async` e `asyncRewake`.

1107* Un command hook `WorktreeCreate` non può restituire JSON, perché Claude Code legge il suo stdout come percorso del worktree. Un HTTP hook `WorktreeCreate` restituisce JSON e può includere il campo.1108* Un command hook `WorktreeCreate` non può restituire JSON, perché Claude Code legge il suo stdout come percorso del worktree. Un HTTP hook `WorktreeCreate` restituisce JSON e può includere il campo.

1108 1109 

1109L'esempio seguente attiva una notifica desktop da un hook `Notification`. La sequenza di escape viene costruita con escape ottali di `printf` in modo che i byte di controllo non compaiano mai sulla riga di comando della shell, e `jq -n --arg` costruisce l'output JSON in modo che virgolette, barre rovesciate e a capo nel messaggio di notifica siano correttamente sottoposti a escape:1110Se usi tmux o GNU screen, completa prima [la configurazione per questi strumenti](#get-terminal-notifications-inside-tmux-or-gnu-screen). L'esempio seguente attiva una notifica desktop da un hook `Notification` in un terminale che legge OSC `777`, come Ghostty o Warp. La chiamata `jq -nc --arg` dello script costruisce l'output JSON e sottopone a escape eventuali virgolette, barre rovesciate e a capo nel messaggio di notifica:

1110 1111 

1111```bash theme={null}1112```bash theme={null}

1112#!/bin/bash1113#!/bin/bash


1120 1121 

1121La forma `{ "terminalSequence": "..." }` è la stessa da qualsiasi shell o linguaggio.1122La forma `{ "terminalSequence": "..." }` è la stessa da qualsiasi shell o linguaggio.

1122 1123 

1124#### Ricevere notifiche del terminale all'interno di tmux o GNU screen

1125 

1126Quando Claude Code viene eseguito all'interno di tmux o GNU screen, le sequenze OSC richiedono quanto segue per raggiungere la tua applicazione di terminale:

1127 

1128* **tmux 3.3 o successivo**: aggiungi `set -g allow-passthrough on` a `~/.tmux.conf`, poi esegui `tmux source-file ~/.tmux.conf` da una shell. L'opzione si applica a ogni programma in quei riquadri, non solo a Claude Code. Con `on`, solo i riquadri che tmux sta mostrando possono inviarle. Per consentire di inviarle anche agli altri riquadri di una sessione a cui sei collegato, usa `all` al posto di `on`, su tmux 3.4 o successivo.

1129* **GNU screen**: mantieni visibile in screen la finestra di Claude Code, perché le sequenze provenienti da una finestra in background non raggiungono la tua applicazione di terminale

1130 

1123#### Aggiungere contesto per Claude1131#### Aggiungere contesto per Claude

1124 1132 

1125Il campo `additionalContext` passa una stringa dal tuo hook nella finestra di contesto di Claude. Claude Code avvolge la stringa in un [promemoria di sistema](https://code.claude.com/docs/it/glossary.md#system-reminder) e la inserisce nella conversazione nel punto in cui l'hook si è attivato. Claude legge il promemoria alla successiva richiesta al modello, ma non appare come messaggio di chat nell'interfaccia.1133Il campo `additionalContext` passa una stringa dal tuo hook nella finestra di contesto di Claude. Claude Code avvolge la stringa in un [promemoria di sistema](https://code.claude.com/docs/it/glossary.md#system-reminder) e la inserisce nella conversazione nel punto in cui l'hook si è attivato. Claude legge il promemoria alla successiva richiesta al modello, ma non appare come messaggio di chat nell'interfaccia.

Details

223| [Campi degli strumenti](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Le intestazioni beta relative agli strumenti si associano ai campi dello schema dello strumento come `strict` e `defer_loading` | `400` che nomina il campo dello schema dello strumento non riconosciuto quando il corpo passa attraverso senza la sua intestazione. Per `defer_loading`, consulta [Riprovare senza la ricerca degli strumenti](#retry-without-tool-search) | Inoltrare entrambi, o [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| [Campi degli strumenti](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) beta | Le intestazioni beta relative agli strumenti si associano ai campi dello schema dello strumento come `strict` e `defer_loading` | `400` che nomina il campo dello schema dello strumento non riconosciuto quando il corpo passa attraverso senza la sua intestazione. Per `defer_loading`, consulta [Riprovare senza la ricerca degli strumenti](#retry-without-tool-search) | Inoltrare entrambi, o [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

224| [Sforzo](https://platform.claude.com/docs/en/build-with-claude/effort) e [output strutturati](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Il campo del corpo `output_config` contiene le impostazioni di sforzo, formato di output strutturato e budget dei compiti; ciascuna si associa alla propria intestazione beta | `400` che nomina `output_config`, spesso `Extra inputs are not permitted`, su upstream Amazon Bedrock e Google Cloud's Agent Platform | Inoltrare il campo e le sue intestazioni insieme, oppure chiedere agli sviluppatori di impostare [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), che rimuove le impostazioni di formato e budget dei compiti ma non lo sforzo. Per rimuovere solo il formato, possono invece impostare [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/it/env-vars), che richiede la v2.1.288 o successiva |224| [Sforzo](https://platform.claude.com/docs/en/build-with-claude/effort) e [output strutturati](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Il campo del corpo `output_config` contiene le impostazioni di sforzo, formato di output strutturato e budget dei compiti; ciascuna si associa alla propria intestazione beta | `400` che nomina `output_config`, spesso `Extra inputs are not permitted`, su upstream Amazon Bedrock e Google Cloud's Agent Platform | Inoltrare il campo e le sue intestazioni insieme, oppure chiedere agli sviluppatori di impostare [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), che rimuove le impostazioni di formato e budget dei compiti ma non lo sforzo. Per rimuovere solo il formato, possono invece impostare [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/it/env-vars), che richiede la v2.1.288 o successiva |

225| Messaggi di sistema a metà conversazione | Nessuna intestazione beta. Claude Code invia parte del testo di promemoria e degli allegati come voci `role: "system"` in `messages` per Claude Opus 4.8, i modelli rilasciati dopo di esso e gli ID di modello non riconosciuti | `400` come `Unexpected role "system"` | Claude Code [riprova senza messaggi di sistema](#automatic-retry-and-error-forwarding). Per interrompere i messaggi di sistema su un alias di un modello rilasciato prima di Claude Opus 4.8, aggiungi una [voce `modelOverrides`](#settings-for-unrecognized-model-ids) alle impostazioni che distribuisci |225| Messaggi di sistema a metà conversazione | Nessuna intestazione beta. Claude Code invia parte del testo di promemoria e degli allegati come voci `role: "system"` in `messages` per Claude Opus 4.8, i modelli rilasciati dopo di esso e gli ID di modello non riconosciuti | `400` come `Unexpected role "system"` | Claude Code [riprova senza messaggi di sistema](#automatic-retry-and-error-forwarding). Per interrompere i messaggi di sistema su un alias di un modello rilasciato prima di Claude Opus 4.8, aggiungi una [voce `modelOverrides`](#settings-for-unrecognized-model-ids) alle impostazioni che distribuisci |

226| [Sforzo impostato per turno](https://code.claude.com/docs/it/prompt-caching.md#changing-effort-level) | Su Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1, un'intestazione beta si associa a `output_config.effort` sulle voci `role: "system"`, che si tratti di un messaggio di sistema o di una voce con contenuto vuoto | `400` con `messages.N: system content must contain at least one block` quando il tuo gateway rimuove il campo da una voce vuota | Inoltrare entrambi, oppure chiedere agli sviluppatori di impostare [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) per interrompere l'invio del campo e delle voci vuote |226| [Sforzo impostato per turno](https://code.claude.com/docs/it/prompt-caching.md#changing-effort-level) | Su Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 e Fable 5.1, un'intestazione beta si associa a `output_config.effort` sulle voci `role: "system"`. Una voce è un messaggio di sistema o una voce con contenuto vuoto | `400` con `messages.N: system content must contain at least one block` quando il tuo gateway rimuove il campo da una voce vuota | Inoltrare entrambi, oppure chiedere agli sviluppatori di impostare [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) per interrompere l'invio del campo e delle voci vuote |

227| [Prompt caching](https://code.claude.com/docs/it/prompt-caching.md) | Nessun accoppiamento beta. Claude Code allega marcatori `cache_control` ai blocchi `system` e alle voci `messages`, incluse le voci `role: "system"` aggiunte a metà conversazione | Nessun errore: la conversazione viene fatturata come input non memorizzato in cache ad ogni turno, visibile come `input_tokens` elevati con poca o nessuna attività di cache in `usage` | Inoltrare `cache_control` invariato ovunque appaia, e non convertire il contenuto del blocco `system` o del messaggio in stringhe semplici |227| [Prompt caching](https://code.claude.com/docs/it/prompt-caching.md) | Nessun accoppiamento beta. Claude Code allega marcatori `cache_control` ai blocchi `system` e alle voci `messages`, incluse le voci `role: "system"` aggiunte a metà conversazione | Nessun errore: la conversazione viene fatturata come input non memorizzato in cache ad ogni turno, visibile come `input_tokens` elevati con poca o nessuna attività di cache in `usage` | Inoltrare `cache_control` invariato ovunque appaia, e non convertire il contenuto del blocco `system` o del messaggio in stringhe semplici |

228| [Conteggio dei token](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Nessun accoppiamento beta; utilizza l'endpoint `count_tokens` | Nessun errore: Claude Code ricade a una stima basata su caratteri, quindi `/context` mostra conteggi approssimativi | Esporre l'endpoint per conteggi di token esatti |228| [Conteggio dei token](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Nessun accoppiamento beta; utilizza l'endpoint `count_tokens` | Nessun errore: Claude Code ricade a una stima basata su caratteri, quindi `/context` mostra conteggi approssimativi | Esporre l'endpoint per conteggi di token esatti |

229 229 

model-config.md +53 −24

Details

30| Alias del modello | Comportamento |30| Alias del modello | Comportamento |

31| - | - |31| - | - |

32| **`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 |32| **`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 |

33| **`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` |33| **`best`** | Usa lo stesso modello di `opus` |

34| **`fable`** | Usa il [modello Fable per il tuo provider](#fable-alias-resolution) per i tuoi compiti più difficili e più lunghi |34| **`fable`** | Usa il [modello Fable per il tuo provider](#fable-alias-resolution) per i tuoi compiti più difficili e più lunghi |

35| **`sonnet`** | Usa il modello Sonnet più recente per i compiti di programmazione quotidiani |35| **`sonnet`** | Usa il modello Sonnet più recente per i compiti di programmazione quotidiani |

36| **`opus`** | Usa il modello Opus più recente per i compiti di ragionamento complesso |36| **`opus`** | Usa il modello Opus più recente per i compiti di ragionamento complesso |


48| Amazon Bedrock, Agent Platform di Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |48| Amazon Bedrock, Agent Platform di Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |

49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |

50 50 

51A 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](https://code.claude.com/docs/it/claude-apps-gateway), dove `fable` e `best` si risolvono in Fable 5.51A meno che tu non imposti `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` si risolve in Fable 5 nelle sessioni del [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway) e in Fable 5.2 in tutti gli altri casi.

52 52 

53Un 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`.53Un gateway non configurato per servire `claude-fable-5-2` rifiuta le richieste per quel modello. Per usare Fable 5.2 attraverso un gateway che lo serve, selezionalo con `/model claude-fable-5-2`.

54 54 

55Dove `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`.55Dove `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`.

56 56 


64 64 

65### Lavorare con Fable65### Lavorare con Fable

66 66 

67[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.67I [modelli Claude Fable](https://platform.claude.com/docs/en/about-claude/models/overview) 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.

68 68 

69Nessuno dei due modelli Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionane uno esplicitamente:69Nessun modello Fable è il valore predefinito del tipo di account su alcun piano o provider. Selezionane uno esplicitamente:

70 70 

71* **Fable 5.1**: esegui `/model fable`, o avvia con `claude --model fable`. Nelle sessioni del [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway), dove l'alias si risolve in Fable 5, esegui invece `/model claude-fable-5-1`.71* **Fable 5.2**: esegui `/model fable`, o avvia con `claude --model fable`. Nelle sessioni del [gateway delle app Claude](https://code.claude.com/docs/it/claude-apps-gateway), esegui invece `/model claude-fable-5-2`.

72* **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`.72* **Fable 5.1 o Fable 5**: selezionalo tramite l'ID del modello. Sull'API Anthropic, esegui `/model claude-fable-5-1` o `/model claude-fable-5`, o avvia con `claude --model claude-fable-5-1`. Su altri provider, usa l'ID del modello del tuo provider o [fissalo](#pin-models-for-third-party-deployments) con `ANTHROPIC_DEFAULT_FABLE_MODEL`.

73 73 

74Se 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.74Sui piani Pro, Max, Team ed Enterprise, un modello `claude-fable-5-1` salvato nelle tue impostazioni utente passa all'alias `fable`:

75 

76* **Piano Pro o Max**: il passaggio avviene la prima volta che esegui la v2.1.321 o successiva. Nel terminale, la riga del modello all'avvio può mostrare `(auto-updated)` una volta.

77* **Piano Team o Enterprise**: il passaggio attende le impostazioni della tua organizzazione, quindi può avvenire a un avvio successivo, oppure non avvenire affatto. Si applica dalla sessione successiva, senza la riga `(auto-updated)`. Per controllare il tuo modello, esegui `/model`.

78 

79Dopo il passaggio, le sessioni si avviano con il livello di sforzo predefinito di Fable 5.2, a meno che tu non abbia [impostato un livello](#adjust-effort-level) per esso. Gli account Console, i provider di terze parti e le impostazioni di progetto, locali o gestite mantengono `claude-fable-5-1`.

75 80 

76Le 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).81Le 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).

77 82 


84 89 

85> [!NOTE]90> [!NOTE]

86>91>

87> 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](https://code.claude.com/docs/it/errors.md#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](https://code.claude.com/docs/it/zero-data-retention.md#model-availability-under-zdr).92> Fable 5.2 richiede Claude Code v2.1.321 o successiva, e Fable 5.1 richiede v2.1.257 o successiva. Se una richiesta per uno di essi da una versione precedente non riesce, consulta [Claude Code non supporta questo modello](https://code.claude.com/docs/it/errors.md#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](https://code.claude.com/docs/it/zero-data-retention.md#model-availability-under-zdr).

88 93 

89Sull'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](https://code.claude.com/docs/it/zero-data-retention.md#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.94Sull'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](https://code.claude.com/docs/it/zero-data-retention.md#model-availability-under-zdr), la riga rimane nel selettore disattivata, con una nota sul motivo.

90 95 


163 168 

164Consulta [Model is not a recognized model id](https://code.claude.com/docs/it/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/it/errors.md#model-not-found) per i messaggi.169Consulta [Model is not a recognized model id](https://code.claude.com/docs/it/errors.md#model-is-not-a-recognized-model-id) e [Model not found](https://code.claude.com/docs/it/errors.md#model-not-found) per i messaggi.

165 170 

166Se 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](https://code.claude.com/docs/it/errors.md#theres-an-issue-with-the-selected-model) alla prima richiesta.171Se imposti il modello con il flag `--model`, la variabile d'ambiente `ANTHROPIC_MODEL` o l'impostazione `model`, Claude Code non rifiuta in anticipo un valore digitato in modo errato. La sessione si avvia e la prima richiesta produce [There's an issue with the selected model](https://code.claude.com/docs/it/errors.md#theres-an-issue-with-the-selected-model). Sull'API Anthropic, un valore che non inizia con `claude-` e corrisponde quasi al nome o all'alias di un modello può produrre anche un [avviso all'avvio che lo suggerisce](#fix-a-mistyped-model-name).

167 172 

168Quando 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](https://code.claude.com/docs/it/headless.md) quando si usa il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter di un subagent](https://code.claude.com/docs/it/sub-agents.md). 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](https://code.claude.com/docs/it/headless.md#get-structured-output).173Quando 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](https://code.claude.com/docs/it/headless.md) quando si usa il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter di un subagent](https://code.claude.com/docs/it/sub-agents.md). 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](https://code.claude.com/docs/it/headless.md#get-structured-output).

169 174 


225 230 

226## Limitare la selezione del modello231## Limitare la selezione del modello

227 232 

228Gli amministratori aziendali possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](https://code.claude.com/docs/it/managed-settings.md) per limitare quali modelli gli utenti possono selezionare. Le voci corrispondono a una famiglia di modelli come `sonnet`, un prefisso di versione come `claude-sonnet-4-5`, o un ID modello completo come `claude-sonnet-4-5-20250929`. Un prefisso di versione corrisponde anche a ID modello successivi che lo estendono con un altro segmento, quindi `claude-fable-5` consente sia Fable 5 che Fable 5.1, mentre `claude-fable-5-1` consente solo Fable 5.1. Per bloccare un modello che l'elenco consente, o per fare in modo che ogni voce di ID modello consenta solo la versione che nomina, vedere [Bloccare modelli o versioni specifici](#block-specific-models-or-versions).233Gli amministratori possono utilizzare `availableModels` nelle [impostazioni gestite o di policy](https://code.claude.com/docs/it/managed-settings.md) per limitare quali modelli gli utenti possono selezionare. Ogni voce corrisponde a uno di questi:

234 

235* Una famiglia di modelli come `sonnet`

236* Un prefisso di versione come `claude-sonnet-4-5`. Corrisponde anche a ID modello successivi che lo estendono con un altro segmento. Ad esempio, `claude-fable-5` consente Fable 5, Fable 5.1 e Fable 5.2, mentre `claude-fable-5-1` consente solo Fable 5.1

237* Un ID modello completo come `claude-sonnet-4-5-20250929`

238 

239Per bloccare un modello che l'elenco consente, o per fare in modo che ogni voce di ID modello consenta solo la versione che nomina, vedi [Bloccare modelli o versioni specifici](#block-specific-models-or-versions).

229 240 

230Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza rispetto alle impostazioni del modello gestito, mentre un allowlist `availableModels` gestito rimane in vigore a meno che l'host non fornisca il proprio; [Eccezioni alla precedenza delle impostazioni gestite](https://code.claude.com/docs/it/settings.md#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sostituisce.241Sulle piattaforme che incorporano Claude Code e impostano [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/it/env-vars), la configurazione del modello dell'host ha la precedenza rispetto alle impostazioni del modello gestito, mentre un allowlist `availableModels` gestito rimane in vigore a meno che l'host non fornisca il proprio; [Eccezioni alla precedenza delle impostazioni gestite](https://code.claude.com/docs/it/settings.md#exceptions-to-managed-settings-precedence) indica quali chiavi e variabili l'host sostituisce.

231 242 


465 476 

466Quando 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.477Quando 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.

467 478 

468I 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).479> [!NOTE]

480>

481> I 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, a parte il [cambio una tantum a una selezione Fable 5.1 salvata](#work-with-fable).

469 482 

470### Impostazione del modello `opusplan`483### Impostazione del modello `opusplan`

471 484 


521 534 

522I 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:535I 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:

523 536 

524* **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.537* **Modelli Fable 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.

525* **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.538* **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.

526* **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.539* **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.

527 540 


582 595 

583Su [Amazon Bedrock](https://code.claude.com/docs/it/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/it/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/it/microsoft-foundry.md), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare ciascun modello coinvolto:596Su [Amazon Bedrock](https://code.claude.com/docs/it/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/it/google-vertex-ai.md) e [Microsoft Foundry](https://code.claude.com/docs/it/microsoft-foundry.md), gli ID modello sono specifici del provider, quindi il fallback automatico funziona solo quando Claude Code può identificare ciascun modello coinvolto:

584 597 

585* 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).598* Claude Code deve riconoscere il modello corrente come fonte di fallback. I modelli Fable 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).

586* 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.599* 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.

587* 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.600* 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.

588 601 


596 609 

597#### Ricerca sulla sicurezza e carichi di lavoro biologici610#### Ricerca sulla sicurezza e carichi di lavoro biologici

598 611 

599I 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.612I 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. Questo è 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.

600 613 

601Questo è 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.614Per un lavoro sostanziale di biologia su un modello Fable o su Opus 5.5, la prima richiesta segnalata che cambia modello sposta la sessione su Opus 5. 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, quei rifiuti iniziano fin dalla prima richiesta segnalata.

602 615 

603### Regola il livello di sforzo616### Regola il livello di sforzo

604 617 


608 621 

609| Modello | Livelli |622| Modello | Livelli |

610| :- | :- |623| :- | :- |

611| Fable 5.1 e Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |624| Modelli Fable | `low`, `medium`, `high`, `xhigh`, `max` |

612| 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` |625| 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` |

613| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |626| Opus 4.6 e Sonnet 4.6 | `low`, `medium`, `high`, `max` |

614 627 


6202. Un livello che scegli nella sessione, ad esempio con `/effort`, il selettore `/model` o [`applyFlagSettings()`](https://code.claude.com/docs/it/agent-sdk/typescript#applyflagsettings)6332. Un livello che scegli nella sessione, ad esempio con `/effort`, il selettore `/model` o [`applyFlagSettings()`](https://code.claude.com/docs/it/agent-sdk/typescript#applyflagsettings)

6213. L'avvio con `--effort`6343. L'avvio con `--effort`

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

6235. Lo sforzo predefinito del modello: `high` su ogni modello che supporta lo sforzo, tranne Opus 5.5, Sonnet 5.5 e Haiku 5.5, il cui predefinito è `medium`, e Opus 4.7, il cui predefinito è `xhigh`. Se la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello.6365. Lo sforzo predefinito del modello: il predefinito di Fable 5.2, Opus 5.5, Sonnet 5.5 e Haiku 5.5 è `medium`, e quello di Opus 4.7 è `xhigh`. Gli altri modelli nella [tabella dei livelli di sforzo](#adjust-effort-level) hanno come predefinito `high`. Se la tua organizzazione imposta un livello di sforzo predefinito per il suo [modello predefinito dell'organizzazione](#organization-default-model), quel livello è il predefinito quando esegui quel modello.

624 637 

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

626 639 


671| Livello | Quando usarlo |684| Livello | Quando usarlo |

672| :- | :- |685| :- | :- |

673| `low` | Scambi rapidi in cui rivedi ogni risultato, come brainstorming, una prima bozza o una piccola modifica come una ridenominazione |686| `low` | Scambi rapidi in cui rivedi ogni risultato, come brainstorming, una prima bozza o una piccola modifica come una ridenominazione |

674| `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 |687| `medium` | Il predefinito sui modelli Fable 5.2, 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 |

675| `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 |688| `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 sugli altri modelli nella tabella dello sforzo |

676| `xhigh` | Ragionamento più profondo a una spesa di token più elevata. Il predefinito su Opus 4.7 |689| `xhigh` | Ragionamento più profondo a una spesa di token più elevata. Il predefinito su Opus 4.7 |

677| `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 |690| `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 |

678| `ultracode` | Un'impostazione di Claude Code piuttosto che un livello: pianifica un [workflow dinamico](https://code.claude.com/docs/it/workflows.md) per ogni attività sostanziale a qualsiasi livello di sforzo |691| `ultracode` | Un'impostazione di Claude Code piuttosto che un livello: pianifica un [workflow dinamico](https://code.claude.com/docs/it/workflows.md) per ogni attività sostanziale a qualsiasi livello di sforzo |


691 704 

692* Riscrivila al di fuori di elementi come virgolette, parentesi, un percorso o un comando, in un prompt che non inizi con `/`705* Riscrivila al di fuori di elementi come virgolette, parentesi, un percorso o un comando, in un prompt che non inizi con `/`

693* Rimuovi `CLAUDE_CODE_EFFORT_LEVEL` se è impostata al di sotto di `xhigh`, alza il tuo [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) a `xhigh` o superiore, oppure chiedi a un amministratore dell'organizzazione di alzare il [limite della tua organizzazione](#organization-effort-limits)706* Rimuovi `CLAUDE_CODE_EFFORT_LEVEL` se è impostata al di sotto di `xhigh`, alza il tuo [`maxEffortLevel`](https://code.claude.com/docs/it/settings-reference#maxeffortlevel) a `xhigh` o superiore, oppure chiedi a un amministratore dell'organizzazione di alzare il [limite della tua organizzazione](#organization-effort-limits)

694* Esegui `/model` nella sessione per passare a un modello Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.1. Dove la parola non può alzare un turno, ad esempio su Amazon Bedrock, [imposta invece il livello di sforzo](#set-the-effort-level)707* Esegui `/model` nella sessione per passare a un modello Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 o Fable 5.1. Dove la parola non può alzare un turno, ad esempio su Amazon Bedrock, [imposta invece il livello di sforzo](#set-the-effort-level)

695 708 

696#### Imposta il livello di sforzo709#### Imposta il livello di sforzo

697 710 


767 780 

768### Contesto esteso781### Contesto esteso

769 782 

770Fable 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.783Le sessioni lunghe con codebase di grandi dimensioni possono utilizzare 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). I modelli Fable, Sonnet 5 e successivi, Haiku 5.5, Opus 4.6 e successivi, e Sonnet 4.6 la supportano.

771 784 

772Fable 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](https://code.claude.com/docs/it/claude-apps-gateway). Per eseguirli invece con una finestra di 200K, consulta [Disattiva il contesto 1M](#turn-off-1m-context).785I modelli Fable, 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](https://code.claude.com/docs/it/claude-apps-gateway). Per eseguirli invece con una finestra di 200K, consulta [Disattiva il contesto 1M](#turn-off-1m-context).

773 786 

774Opus 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, Ultra, 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, inclusi Max e Ultra.787Opus 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, Ultra, 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, inclusi Max e Ultra.

775 788 


798 811 

799#### Finestra di contesto dietro un gateway LLM812#### Finestra di contesto dietro un gateway LLM

800 813 

801Se imposti `ANTHROPIC_BASE_URL` su un [gateway LLM](https://code.claude.com/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`](https://code.claude.com/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).814Se imposti `ANTHROPIC_BASE_URL` su un [gateway LLM](https://code.claude.com/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. I modelli Fable, Sonnet 5 e successivi, Haiku 5.5, e Opus 4.7 e successivi ottengono la finestra 1M senza una variante `[1m]`. Un modello che raggiunge 1M solo tramite la sua variante `[1m]`, come Opus 4.6, viene eseguito a 200K senza di essa.

815 

816Claude 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`](https://code.claude.com/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).

802 817 

803#### Disattiva il contesto 1M818#### Disattiva il contesto 1M

804 819 


885 900 

886Una volta che Claude Code riconosce l'ID o usa la finestra che gli hai fornito, l'avviso non compare più quando avvii una sessione su quell'ID.901Una volta che Claude Code riconosce l'ID o usa la finestra che gli hai fornito, l'avviso non compare più quando avvii una sessione su quell'ID.

887 902 

903#### Correggere un nome di modello digitato male

904 

905Uno qualsiasi di questi avvisi significa che Claude Code non riconosce l'ID modello che hai impostato, e che l'ID corrisponde quasi a un nome o alias di modello che invece riconosce:

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Hai digitato male l'ID**: sostituiscilo con il suggerimento [ovunque imposti il modello](#setting-your-model)

913* **L'ID è intenzionale**: lascialo così com'è. La sessione lo invia come lo hai scritto. Se la finestra di contesto che Claude Code assume per esso è errata, [correggi la finestra](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

888#### A quali ID si applica `CLAUDE_CODE_MAX_CONTEXT_TOKENS`915#### A quali ID si applica `CLAUDE_CODE_MAX_CONTEXT_TOKENS`

889 916 

890Su un [LLM gateway](https://code.claude.com/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`](https://code.claude.com/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.917Su un [LLM gateway](https://code.claude.com/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`](https://code.claude.com/docs/it/env-vars) alla finestra che Claude Code dovrebbe assumere invece.


1100 1127 

1101| Versione | Modifica |1128| Versione | Modifica |

1102| :- | :- |1129| :- | :- |

1130| v2.1.321 | `fable` si risolve a Fable 5.2, tranne nelle sessioni del gateway delle app Claude |

1131| v2.1.321 | `best` si risolve allo stesso modello di `opus`. Le versioni precedenti usano il modello a cui si risolve `fable`, dove Fable è disponibile |

1103| v2.1.293 | `haiku` si risolve a Haiku 5.5 su Anthropic API |1132| v2.1.293 | `haiku` si risolve a Haiku 5.5 su Anthropic API |

1104| v2.1.284 | `sonnet` si risolve a Sonnet 5.5 su Anthropic API |1133| v2.1.284 | `sonnet` si risolve a Sonnet 5.5 su Anthropic API |

1105| v2.1.280 | `opus` si risolve a Opus 5.5 su Anthropic API, Claude Platform su AWS, Amazon Bedrock e Agent Platform di Google Cloud |1134| v2.1.280 | `opus` si risolve a Opus 5.5 su Anthropic API, Claude Platform su AWS, Amazon Bedrock e Agent Platform di Google Cloud |

permissions.md +2 −1

Details

253| :- | :- | :- |253| :- | :- | :- |

254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |

255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |

256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main`, `git 'push' origin main` |256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main` |

257 257 

258Le tue altre regole e la modalità di permesso decidono i comandi nell'ultima colonna.258Le tue altre regole e la modalità di permesso decidono i comandi nell'ultima colonna.

259 259 


273* **`docker` puntato a un altro daemon**: le forme di sola lettura di `docker` chiedono conferma quando il comando contiene un flag che seleziona un daemon diverso, come `-H`, `--context` o `--url` e `--connection` di Podman.273* **`docker` puntato a un altro daemon**: le forme di sola lettura di `docker` chiedono conferma quando il comando contiene un flag che seleziona un daemon diverso, come `-H`, `--context` o `--url` e `--connection` di Podman.

274* **`file` con flag che aprono percorsi**: `file` chiede conferma quando riceve `-m`/`--magic-file` o `-f`/`--files-from`, perché questi flag fanno sì che `file` apra i percorsi indicati nel valore del flag.274* **`file` con flag che aprono percorsi**: `file` chiede conferma quando riceve `-m`/`--magic-file` o `-f`/`--files-from`, perché questi flag fanno sì che `file` apra i percorsi indicati nel valore del flag.

275* **`ps` che potrebbe stampare variabili d'ambiente**: `ps` chiede conferma quando uno dei suoi argomenti potrebbe agire come opzione `e`, come in `ps auxe` o `ps aux -e`, perché quell'opzione stampa le variabili d'ambiente dei processi. `ps aux` e `ps -ef` vengono eseguiti senza richiesta di conferma. Il controllo sulle forme con trattino come `ps aux -e` richiede Claude Code v2.1.290 o successiva.275* **`ps` che potrebbe stampare variabili d'ambiente**: `ps` chiede conferma quando uno dei suoi argomenti potrebbe agire come opzione `e`, come in `ps auxe` o `ps aux -e`, perché quell'opzione stampa le variabili d'ambiente dei processi. `ps aux` e `ps -ef` vengono eseguiti senza richiesta di conferma. Il controllo sulle forme con trattino come `ps aux -e` richiede Claude Code v2.1.290 o successiva.

276* **`which` con flag che vanno oltre la ricerca e la visualizzazione**: `which` chiede conferma quando riceve un flag come `-i`/`--read-alias` o `--read-functions`. `which node` e `which -a node` vengono eseguiti senza richiesta di conferma.

276* **Percorsi di rete su Windows**: un comando i cui argomenti includono un percorso di rete (UNC), come `\\server\share\file`, chiede conferma perché l'accesso a un percorso di rete può inviare le tue credenziali Windows all'host indicato. Lo stesso controllo si applica ai comandi dello [strumento PowerShell](https://code.claude.com/docs/it/tools-reference.md#powershell-tool).277* **Percorsi di rete su Windows**: un comando i cui argomenti includono un percorso di rete (UNC), come `\\server\share\file`, chiede conferma perché l'accesso a un percorso di rete può inviare le tue credenziali Windows all'host indicato. Lo stesso controllo si applica ai comandi dello [strumento PowerShell](https://code.claude.com/docs/it/tools-reference.md#powershell-tool).

277* **Scritture su variabili speciali della shell**: un comando che imposta, rimuove o itera su determinate variabili speciali della shell, come `PATH` o `IFS`, chiede conferma anche quando il resto del comando è di sola lettura.278* **Scritture su variabili speciali della shell**: un comando che imposta, rimuove o itera su determinate variabili speciali della shell, come `PATH` o `IFS`, chiede conferma anche quando il resto del comando è di sola lettura.

278* **Comandi che l'analisi non riesce a interpretare**: quando Claude Code non riesce ad analizzare completamente un comando, chiede l'approvazione invece di trattarlo come di sola lettura. I comandi più lunghi di 10.000 caratteri chiedono sempre conferma perché superano il limite che l'analisi è in grado di interpretare.279* **Comandi che l'analisi non riesce a interpretare**: quando Claude Code non riesce ad analizzare completamente un comando, chiede l'approvazione invece di trattarlo come di sola lettura. I comandi più lunghi di 10.000 caratteri chiedono sempre conferma perché superano il limite che l'analisi è in grado di interpretare.

Details

279* **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`279* **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`

280* **Il tuo hook genera un'eccezione o va in timeout**: Claude Code lo salta e invia il prompt. [Aggiungi un handler `.catch`](#handle-a-hook-that-fails) in modo che un errore non invii un prompt che l'hook avrebbe bloccato.280* **Il tuo hook genera un'eccezione o va in timeout**: Claude Code lo salta e invia il prompt. [Aggiungi un handler `.catch`](#handle-a-hook-that-fails) in modo che un errore non invii un prompt che l'hook avrebbe bloccato.

281 281 

282[Altri eventi](https://code.claude.com/docs/it/plugins/mods/reference.md#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](https://code.claude.com/docs/it/prompt-caching.md). In un hook `skill.prompt` puoi anche leggere [da quale plugin o file proviene la skill](https://code.claude.com/docs/it/plugins/mods/reference.md#skill-prompt-fields).282[Altri eventi](https://code.claude.com/docs/it/plugins/mods/reference.md#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. Per modificare una sezione dopo l'inizio di una conversazione, consulta [Inviare una sezione del prompt di sistema o una descrizione di uno strumento modificata](https://code.claude.com/docs/it/plugins/mods/reference.md#break-prompt-cache). In un hook `skill.prompt` puoi anche leggere [da quale plugin o file proviene la skill](https://code.claude.com/docs/it/plugins/mods/reference.md#skill-prompt-fields).

283 283 

284### Seguire un turno284### Seguire un turno

285 285 

Details

197>197>

198> Per disegnare nella fascia, filtra su `{ component: 'AbovePrompt' }`.198> Per disegnare nella fascia, filtra su `{ component: 'AbovePrompt' }`.

199 199 

200Un mod può anche [inserire una propria riga nella trascrizione](#place-a-row-in-the-transcript).

201 

200### Modifica ciò che Claude Code disegna già202### Modifica ciò che Claude Code disegna già

201 203 

202Claude Code disegna da sé la maggior parte della propria interfaccia: i messaggi, le righe delle chiamate agli strumenti, lo spinner e altro ancora. Anche ciascuna di queste parti è un punto di rendering, quindi un mod può cambiarne lo stile o sostituirla. Per modificarne una, filtra il tuo hook `ui.render` sul suo nome preso da questa tabella:204Claude Code disegna da sé la maggior parte della propria interfaccia: i messaggi, le righe delle chiamate agli strumenti, lo spinner e altro ancora. Anche ciascuna di queste parti è un punto di rendering, quindi un mod può cambiarne lo stile o sostituirla. Per modificarne una, filtra il tuo hook `ui.render` sul suo nome preso da questa tabella:


349* **Suggerimenti per il prompt**: `$.prompt.suggest` si risolve con `isShown: false` e non mostra nulla, perché il pannello riserva il testo di suggerimento attenuato della casella del prompt ai suggerimenti di Claude.351* **Suggerimenti per il prompt**: `$.prompt.suggest` si risolve con `isShown: false` e non mostra nulla, perché il pannello riserva il testo di suggerimento attenuato della casella del prompt ai suggerimenti di Claude.

350* **Limiti del testo**: il pannello tronca una riga di stato a 200 caratteri o due righe, e un toast a 500 caratteri.352* **Limiti del testo**: il pannello tronca una riga di stato a 200 caratteri o due righe, e un toast a 500 caratteri.

351 353 

354### Inserisci una riga nella trascrizione

355 

356Una riga è una linea che il tuo mod aggiunge alla trascrizione nel terminale, dopo l'ultimo messaggio. Resta in quella posizione mentre la conversazione prosegue e Claude non la vede. `$.ui.place` richiede Claude Code v2.1.314 o successiva.

357 

358**1. Inserisci la riga**

359 

360Chiama [`$.ui.place`](https://code.claude.com/docs/it/plugins/mods/reference#mods-api-methods) con un `id`. L'`id` è un nome che inventi tu per la riga, come `build-status`. Può contenere da 1 a 64 lettere, cifre, `_` o `-`, e ogni riga che il tuo mod ha nella trascrizione ne richiede uno proprio.

361 

362**2. Disegna la riga**

363 

364Disegna la riga nel punto di rendering [`Placed`](https://code.claude.com/docs/it/plugins/mods/reference#render-sites).

365 

366Questo esempio aggiunge un comando `/build-status`. Quando l'utente esegue il comando, il mod aggiunge una riga che mostra `Build: passing`. Il testo è fisso per mantenere breve l'esempio, quindi un mod reale disegnerebbe il proprio risultato:

367 

368```javascript theme={null}

369export function register(on) {

370 on('session.start', async ($, e, next) => {

371 await $.command.register({ name: 'build-status', description: 'Show the build status' })

372 return next(e)

373 })

374 

375 on('command.run', { command: 'build-status' }, async ($) => {

376 const placed = await $.ui.place({ id: 'build-status' })

377 // Where nothing draws the row, reply with text instead

378 return placed.isPlaced ? {} : { text: 'Build: passing' }

379 })

380 

381 on('ui.render', { component: 'Placed' }, async ($, e, next) => {

382 // This hook runs for every mod's rows, and another mod can use the same id

383 if (e.props.plugin !== $.plugin.name || e.props.id !== 'build-status') return next(e)

384 const { Text } = $.ui.resolve(e)

385 return Text({ children: ['Build: passing'] })

386 })

387}

388```

389 

390Per provare l'esempio, inserisci questo codice in un [mod](https://code.claude.com/docs/it/plugins/mods/create.md). In una sessione del terminale, esegui `/build-status` al prompt di Claude Code. `Build: passing` appare come riga alla fine della trascrizione.

391 

392La chiamata non mostra sempre una riga e una riga può scomparire in seguito, quindi gestisci questi casi nel tuo mod:

393 

394* **Il risultato**: `{ isPlaced: true, requestId }` quando il terminale disegna la riga. Altrimenti `isPlaced` è `false` e `reason` ne indica il motivo, come in `no attached surface draws placed rows yet`. Uno dei motivi è il [limite di righe](https://code.claude.com/docs/it/plugins/mods/reference.md#limits) che un mod può avere contemporaneamente.

395* **Una seconda chiamata con lo stesso `id`**: finché la prima riga è ancora nella trascrizione, la chiamata non aggiunge alcuna riga e si risolve con il `requestId` di quella riga. Per modificare ciò che la riga mostra, [ridisegna la riga](#redraw-when-something-changes).

396* **Quando la riga scompare**: quando la conversazione termina, quando l'utente torna indietro oltre la riga o, al di fuori del [rendering a schermo intero](https://code.claude.com/docs/it/fullscreen.md), quando la conversazione viene compattata. `--resume` non ripristina la riga. Per mostrare di nuovo la riga, chiama di nuovo `$.ui.place`.

397 

398### Metti uno sfondo dietro la conversazione

399 

400> [!NOTE]

401>

402> `$.theme.set` e `$.theme.clear` sostituiscono `$.ui.backdrop`, che Claude Code v2.1.319 ha rimosso. Cambia `$.ui.backdrop({ id: 'your-backdrop' })` in `$.theme.set({ backdrop: { id: 'your-backdrop' } })` e `$.ui.backdrop(undefined)` in `$.theme.clear()`, che rimuove lo sfondo di qualsiasi mod.

403 

404Per mettere uno sfondo dietro la conversazione nell'app Desktop o nell'app mobile, chiama [`$.theme.set`](https://code.claude.com/docs/it/plugins/mods/reference#mods-api-methods) con un `backdrop`, quindi disegna lo sfondo nel punto di rendering [`Backdrop`](https://code.claude.com/docs/it/plugins/mods/reference#render-sites). Per togliere lo sfondo, chiama `$.theme.clear()`. Il terminale non disegna alcuno sfondo. `$.theme.set` e `$.theme.clear` richiedono Claude Code v2.1.319 o successiva.

405 

406Questo mod imposta uno sfondo all'avvio della sessione, disegna lo sfondo e aggiunge un comando `/plain` che lo toglie:

407 

408```javascript theme={null}

409export function register(on) {

410 // Neither a reload of this mod nor --resume keeps the backdrop, so set it here

411 on('session.start', async ($, e, next) => {

412 await $.theme.set({ backdrop: { id: 'night-sky', colorScheme: 'dark' } })

413 await $.command.register({ name: 'plain', description: 'Take the backdrop off' })

414 return next(e)

415 })

416 

417 on('ui.render', { component: 'Backdrop' }, async ($, e, next) => {

418 // This hook runs for every mod's backdrop, and another mod can use the same id

419 if (e.props.plugin !== $.plugin.name || e.props.id !== 'night-sky') return next(e)

420 const { Box, Text } = $.ui.resolve(e)

421 return Box({ backgroundColor: 'blue', children: [Text({ children: ['Night sky'] })] })

422 })

423 

424 on('command.run', { command: 'plain' }, async ($) => {

425 const cleared = await $.theme.clear()

426 return { text: cleared.reason }

427 })

428}

429```

430 

431Per provare l'esempio, inserisci questo codice in un [mod](https://code.claude.com/docs/it/plugins/mods/create.md) e avvia una sessione nell'app Desktop o nell'app mobile. Per togliere lo sfondo, esegui `/plain` al prompt di Claude Code. La trascrizione mostra `the theme is cleared` dopo il nome del mod, come in `night-sky: the theme is cleared` per un mod chiamato `night-sky`.

432 

433Verifica che cosa accetta `backdrop`, che cosa ti dice il risultato della chiamata e che cosa possono modificare gli altri mod:

434 

435* **I campi di `backdrop`**: `id`, un [nome](https://code.claude.com/docs/it/plugins/mods/reference.md#limits) che scegli tu, è obbligatorio, mentre gli altri campi sono facoltativi. `colorScheme` è `'light'` o `'dark'` e indica se il tuo disegno è chiaro o scuro. Per `glass`, consulta [i tipi per la tua build](https://code.claude.com/docs/it/plugins/mods/create.md#get-the-types-for-your-build).

436* **Se lo sfondo viene disegnato**: `$.theme.set` si risolve con `isDrawn: true` quando un'app Desktop o mobile connessa alla sessione dichiara di disegnare gli sfondi. Altrimenti `isDrawn` è `false` e `reason` ne indica il motivo.

437* **Un solo sfondo per ogni sessione**: una chiamata a `$.theme.set` sostituisce lo sfondo della sessione e `$.theme.clear()` rimuove quello sfondo, indipendentemente da quale mod lo abbia impostato. Chiama `$.theme.clear()` solo quando l'utente lo richiede.

438 

352## Costruire un albero di elementi439## Costruire un albero di elementi

353 440 

354Ciò che un hook `ui.render` restituisce è un albero di elementi: una descrizione di cosa disegnare, composta da box, testo e controlli annidati l'uno dentro l'altro. Tu descrivi il disegno e Claude Code lo esegue nell'app che l'utente ha aperto: il terminale, l'app Desktop o l'estensione VS Code.441Ciò che un hook `ui.render` restituisce è un albero di elementi: una descrizione di cosa disegnare, composta da box, testo e controlli annidati l'uno dentro l'altro. Tu descrivi il disegno e Claude Code lo esegue nell'app che l'utente ha aperto: il terminale, l'app Desktop o l'estensione VS Code.

Details

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](https://code.claude.com/docs/it/plugins/mods/events#guard-or-change-a-tool-call) | Uno strumento sta per essere eseguito | `next(e)`, `{ deny: reason }` oppure `{ result }` |58| [`tool.call`](https://code.claude.com/docs/it/plugins/mods/events#guard-or-change-a-tool-call) | Uno strumento sta per essere eseguito | `next(e)`, `{ deny: reason }` oppure `{ result }` |

59| [`tool.check`](https://code.claude.com/docs/it/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code decide se una chiamata a uno strumento può essere eseguita, dopo gli hook `tool.call` e `PreToolUse`. `next(e)` si risolve nella decisione raggiunta dalle regole, dalla modalità di permesso e da quegli hook. | `next(e)` oppure `{ decision }`, con `decision` impostato su `allow`, `ask` o `deny` e un `reason` facoltativo |59| [`tool.check`](https://code.claude.com/docs/it/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code decide se una chiamata a uno strumento può essere eseguita, dopo gli hook `tool.call` e `PreToolUse`. `next(e)` si risolve nella decisione raggiunta dalle regole, dalla modalità di permesso e da quegli hook. | `next(e)` oppure `{ decision }`, con `decision` impostato su `allow`, `ask` o `deny` e un `reason` facoltativo |

60| `tool.describe` | Una volta per ogni strumento, quando la sua descrizione viene inviata per la prima volta a Claude. Una seconda volta per uno strumento MCP quando Claude lo carica tramite la [ricerca degli strumenti](https://code.claude.com/docs/it/mcp.md#scale-with-mcp-tool-search), con `e.description` impostato sul testo che Claude legge per lo strumento caricato. | `{ description }`, facoltativamente con `isDeferred` impostato su `true` per mettere lo strumento dietro la ricerca degli strumenti o su `false` per caricarlo subito |60| `tool.describe` | Una volta per ogni strumento, quando la sua descrizione viene inviata per la prima volta a Claude. Una seconda volta per uno strumento MCP quando Claude lo carica tramite la [ricerca degli strumenti](https://code.claude.com/docs/it/mcp.md#scale-with-mcp-tool-search), con `e.description` impostato sul testo che Claude legge per lo strumento caricato. | `{ description }`, facoltativamente con `isDeferred` impostato su `true` per mettere lo strumento dietro la ricerca degli strumenti o su `false` per caricarlo subito. Aggiungi [`breakPromptCache: true`](#break-prompt-cache) per inviare una descrizione modificata al turno successivo. |

61 61 

62#### Campi dell'agente e dell'organizzazione su `tool.check`62#### Campi dell'agente e dell'organizzazione su `tool.check`

63 63 


85| `prompt.edit` | L'utente modifica la casella del prompt | `next(e)` |85| `prompt.edit` | L'utente modifica la casella del prompt | `next(e)` |

86| `prompt.autocomplete` | L'utente digita nella casella del prompt e una parola termina in corrispondenza del cursore. `e.token` è quella parola. Claude Code non attende l'hook: le sue righe di completamento automatico vengono mostrate per prime. | `{ suggestions }`, un elenco di righe `{ text, label, description }` mostrate sotto quelle di Claude Code. La scelta di una riga sostituisce la parola con il suo `text`. |86| `prompt.autocomplete` | L'utente digita nella casella del prompt e una parola termina in corrispondenza del cursore. `e.token` è quella parola. Claude Code non attende l'hook: le sue righe di completamento automatico vengono mostrate per prime. | `{ suggestions }`, un elenco di righe `{ text, label, description }` mostrate sotto quelle di Claude Code. La scelta di una riga sostituisce la parola con il suo `text`. |

87| `prompt.compose` | Claude Code genera un prompt di sistema | `{ sections }`, un elenco di `{ id, text, scope }` nell'ordine in cui vengono inviati |87| `prompt.compose` | Claude Code genera un prompt di sistema | `{ sections }`, un elenco di `{ id, text, scope }` nell'ordine in cui vengono inviati |

88| [`prompt.section`](https://code.claude.com/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni sezione con nome del prompt di sistema. `e.name` è l'`id` della sezione in `prompt.compose`. | `{ text }` oppure `{ text: null }` per omettere la sezione |88| [`prompt.section`](https://code.claude.com/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni sezione con nome del prompt di sistema. `e.name` è l'`id` della sezione in `prompt.compose`. | `{ text }` oppure `{ text: null }` per omettere la sezione. Aggiungi [`breakPromptCache: true`](#break-prompt-cache) per inviare una sezione modificata al turno successivo. |

89| [`prompt.context`](https://code.claude.com/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni conversazione, per il contesto inviato con il primo messaggio | `{ blocks }` |89| [`prompt.context`](https://code.claude.com/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni conversazione, per il contesto inviato con il primo messaggio | `{ blocks }` |

90| `prompt.attachment` | Claude Code aggiunge un proprio messaggio per Claude, come un promemoria. `e.type` indica il tipo e, per i tipi dichiarati dalle definizioni dei tipi, `e.detail` contiene i dati a partire dai quali è stato scritto il testo. | `{ text }` oppure `{ text: null }` per ometterlo |90| `prompt.attachment` | Claude Code aggiunge un proprio messaggio per Claude, come un promemoria. `e.type` indica il tipo e, per i tipi dichiarati dalle definizioni dei tipi, `e.detail` contiene i dati a partire dai quali è stato scritto il testo. | `{ text }` oppure `{ text: null }` per ometterlo |

91| `prompt.mention` | Claude Code sta per leggere un file menzionato con @ in un prompt. Richiede Claude Code v2.1.290 o versioni successive. | `next({ ...e, path })` per leggere un file diverso, oppure `{ deny: reason }` |91| `prompt.mention` | Claude Code sta per leggere un file menzionato con @ in un prompt. Richiede Claude Code v2.1.290 o versioni successive. | `next({ ...e, path })` per leggere un file diverso, oppure `{ deny: reason }` |


108 108 

109Su `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` e `e.frontmatterProblem` richiedono Claude Code v2.1.299 o versioni successive.109Su `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` e `e.frontmatterProblem` richiedono Claude Code v2.1.299 o versioni successive.

110 110 

111#### Inviare una sezione del prompt di sistema o una descrizione di uno strumento modificata con `breakPromptCache`

112 

113Per modificare una sezione o la descrizione di uno strumento in una conversazione in corso, chiama `$.ui.invalidate('prompt.section')` o `$.ui.invalidate('tool.describe')` in modo che il tuo hook venga eseguito di nuovo. Restituisci da esso `{ text, breakPromptCache: true }` oppure `{ description, breakPromptCache: true }`. Senza il campo, Claude continua a leggere il testo [salvato con la conversazione](https://code.claude.com/docs/it/cli-reference.md#system-prompt-flags-in-resumed-conversations) per una sezione o per uno strumento caricato subito, fino a una nuova conversazione o a una [compattazione](https://code.claude.com/docs/it/prompt-caching.md#compacting-the-conversation).

114 

115Il testo modificato raggiunge Claude al turno successivo e la [cache del prompt](https://code.claude.com/docs/it/prompt-caching.md) riparte da zero, quindi quel turno è più lento e più costoso. Il campo richiede Claude Code v2.1.321 o versioni successive. Dalla v2.1.299 fino alla v2.1.321, una conversazione in corso riceveva il testo modificato al turno successivo.

116 

111### Comandi e configurazione117### Comandi e configurazione

112 118 

113| Evento | Si attiva quando | Un hook può restituire |119| Evento | Si attiva quando | Un hook può restituire |


212| Namespace | Metodi |218| Namespace | Metodi |

213| :- | :- |219| :- | :- |

214| `$.plugin` | `name`, `root`: il nome e la directory di questo plugin |220| `$.plugin` | `name`, `root`: il nome e la directory di questo plugin |

215| [`$.ui`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |221| [`$.ui`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, [`place`](https://code.claude.com/docs/it/plugins/mods/interface#place-a-row-in-the-transcript), `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit`, `view`. `view` richiede Claude Code v2.1.300 o versioni successive e `place` v2.1.314 o versioni successive. |

222| [`$.theme`](https://code.claude.com/docs/it/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `set`, `clear`: imposta uno sfondo che l'app Desktop o mobile disegna, e rimuove lo sfondo. Richiede Claude Code v2.1.319 o versioni successive. |

216| [`$.command`](https://code.claude.com/docs/it/plugins/mods/api#add-a-command) | `register`, `run`, `list` |223| [`$.command`](https://code.claude.com/docs/it/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

217| [`$.tool`](https://code.claude.com/docs/it/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |224| [`$.tool`](https://code.claude.com/docs/it/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

218| `$.agent` | `register`, `spawn`, `list`. `list()` restituisce i subagent e i compagni di squadra di questa sessione, ciascuno con uno `status` tra `pending`, `running`, `waiting`, `idle`, `completed`, `failed` o `killed`, dove `idle` e `waiting` richiedono Claude Code v2.1.289 o versioni successive. |225| `$.agent` | `register`, `spawn`, `list`. `list()` restituisce i subagent e i compagni di squadra di questa sessione, ciascuno con uno `status` tra `pending`, `running`, `waiting`, `idle`, `completed`, `failed` o `killed`, dove `idle` e `waiting` richiedono Claude Code v2.1.289 o versioni successive. |


243| :- | :- | :- | :- |250| :- | :- | :- | :- |

244| [`Pane`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | L'`id` del pannello | Terminale, Desktop, VS Code |251| [`Pane`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | L'`id` del pannello | Terminale, Desktop, VS Code |

245| [`AbovePrompt`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Una sola istanza | Terminale, Desktop |252| [`AbovePrompt`](https://code.claude.com/docs/it/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Una sola istanza | Terminale, Desktop |

253| [`Placed`](https://code.claude.com/docs/it/plugins/mods/interface#place-a-row-in-the-transcript) | `id`, `plugin`, `onScreen` | Il `requestId` restituito da `$.ui.place` | Terminale |

254| [`Backdrop`](https://code.claude.com/docs/it/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `id`, `plugin`, `glass`, `colorScheme` | `backdrop` | Superfici `desktop` e `mobile`. Il tuo hook viene eseguito quando l'app Desktop o mobile chiede di disegnare uno sfondo. |

246| `UserMessage` | `text`, `origin`, `isExpanded` e `task` o `from` a seconda dell'origine | L'id del messaggio | Terminale, Desktop, VS Code |255| `UserMessage` | `text`, `origin`, `isExpanded` e `task` o `from` a seconda dell'origine | L'id del messaggio | Terminale, Desktop, VS Code |

247| `AssistantMessage` | Il testo della risposta | L'id del messaggio | Terminale, Desktop, VS Code |256| `AssistantMessage` | Il testo della risposta | L'id del messaggio | Terminale, Desktop, VS Code |

248| `ToolUse`, `ToolResult`, `ToolGroup` | Il nome, l'input e il risultato dello strumento | L'id della chiamata allo strumento | Terminale, Desktop, VS Code |257| `ToolUse`, `ToolResult`, `ToolGroup` | Il nome, l'input e il risultato dello strumento | L'id della chiamata allo strumento | Terminale, Desktop, VS Code |


399| 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. |408| 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. |

400| `$.ui.toast` | Mostrato per 4 secondi, a meno che tu non passi `{ timeoutMs }`. Nel [renderer classico](https://code.claude.com/docs/it/fullscreen.md#enable-fullscreen-rendering), un toast più recente di un mod può [prendere il posto di quello precedente](https://code.claude.com/docs/it/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) che è visualizzato o in attesa di essere visualizzato. |409| `$.ui.toast` | Mostrato per 4 secondi, a meno che tu non passi `{ timeoutMs }`. Nel [renderer classico](https://code.claude.com/docs/it/fullscreen.md#enable-fullscreen-rendering), un toast più recente di un mod può [prendere il posto di quello precedente](https://code.claude.com/docs/it/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) che è visualizzato o in attesa di essere visualizzato. |

401| Un riquadro aperto senza che l'utente lo abbia richiesto | Posizionato a partire da 144 colonne del terminale, 110 dopo che l'utente lo ha aperto una volta |410| Un riquadro aperto senza che l'utente lo abbia richiesto | Posizionato a partire da 144 colonne del terminale, 110 dopo che l'utente lo ha aperto una volta |

411| Righe di `$.ui.place` che un singolo mod ha contemporaneamente in una conversazione | 500. Al raggiungimento del limite, una chiamata con un nuovo `id` si risolve in `{ isPlaced: false, reason: 'a plugin holds at most 500 placed rows' }`. |

402| Profondità di annidamento degli argomenti di una chiamata all'API dei mod | 28.000 livelli. Oltre questo limite, la chiamata viene rifiutata con un messaggio che termina con `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |412| Profondità di annidamento degli argomenti di una chiamata all'API dei mod | 28.000 livelli. Oltre questo limite, la chiamata viene rifiutata con un messaggio che termina con `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |

403| Profondità di annidamento di un evento modificato passato a `next`, al di fuori degli [hook generatori asincroni](#events) come uno su `turn.step` | 28.000 livelli. Oltre questo limite, `next` viene rifiutato con un messaggio che termina con `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |413| Profondità di annidamento di un evento modificato passato a `next`, al di fuori degli [hook generatori asincroni](#events) come uno su `turn.step` | 28.000 livelli. Oltre questo limite, `next` viene rifiutato con un messaggio che termina con `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |

404| Profondità di annidamento del valore restituito da un hook, al di fuori di `ui.render`, `ui.resolve` e degli hook generatori asincroni | 28.000 livelli. Oltre questo limite, il risultato dell'hook viene rifiutato e [l'avviso che lo segnala](https://code.claude.com/docs/it/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) include `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |414| Profondità di annidamento del valore restituito da un hook, al di fuori di `ui.render`, `ui.resolve` e degli hook generatori asincroni | 28.000 livelli. Oltre questo limite, il risultato dell'hook viene rifiutato e [l'avviso che lo segnala](https://code.claude.com/docs/it/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) include `nesting deeper than 28000 levels is not supported`. Richiede Claude Code v2.1.299 o versioni successive. |

405| Scope, come funzioni, blocchi e cicli, annidati l'uno dentro l'altro in un singolo file di un modulo degli hook | 2.000 |415| Scope, come funzioni, blocchi e cicli, annidati l'uno dentro l'altro in un singolo file di un modulo degli hook | 2.000 |

406| Nomi di comandi, strumenti, tipi di subagent e riquadri | Lettere, cifre, `_` e `-`, fino a 64 caratteri |416| Nomi di comandi, strumenti, tipi di subagent e riquadri, e l'`id` di una riga posizionata o di uno sfondo | Lettere, cifre, `_` e `-`, fino a 64 caratteri |

407| Un singolo test di `claude plugin test` | 5 secondi, a meno che il test non imposti `timeoutMs` |417| Un singolo test di `claude plugin test` | 5 secondi, a meno che il test non imposti `timeoutMs` |

408 418 

409## Impostazioni e variabili d'ambiente419## Impostazioni e variabili d'ambiente

Details

33Due impostazioni non compaiono nella tabella dei layer ma influiscono comunque su ciò che rimane memorizzato nella cache:33Due impostazioni non compaiono nella tabella dei layer ma influiscono comunque su ciò che rimane memorizzato nella cache:

34 34 

35* **Modello**: ogni modello ha la propria cache. Cambiare modello ricalcola l'intera richiesta anche quando il contenuto è identico. Consulta [Cambiare modello](#switching-models) di seguito.35* **Modello**: ogni modello ha la propria cache. Cambiare modello ricalcola l'intera richiesta anche quando il contenuto è identico. Consulta [Cambiare modello](#switching-models) di seguito.

36* **Livello di sforzo**: sulla maggior parte dei modelli, ogni livello di sforzo ha la propria cache, quindi cambiare lo sforzo a metà sessione ricalcola l'intera richiesta. Su Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, la cache rimane intatta per impostazione predefinita. Consulta [Cambiare il livello di sforzo](#changing-effort-level) di seguito.36* **Livello di sforzo**: sulla maggior parte dei modelli, ogni livello di sforzo ha la propria cache, quindi cambiare lo sforzo a metà sessione ricalcola l'intera richiesta. Con una chiave API o un abbonamento Claude, la cache rimane intatta per impostazione predefinita su Fable 5.1 e versioni successive, Opus 5.5, Sonnet 5.5 e Haiku 5.5. Consulta [Cambiare il livello di sforzo](#changing-effort-level) di seguito.

37 37 

38> [!TIP]38> [!TIP]

39>39>


94 94 

95Sulla maggior parte dei modelli, modificare il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) a metà sessione significa che la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Mentre la cache è ancora calda, Claude Code ti chiede di confermare il cambio prima.95Sulla maggior parte dei modelli, modificare il [livello di sforzo](https://code.claude.com/docs/it/model-config.md#adjust-effort-level) a metà sessione significa che la richiesta successiva legge l'intera cronologia della conversazione senza cache hit. Mentre la cache è ancora calda, Claude Code ti chiede di confermare il cambio prima.

96 96 

97Su Opus 5.5, Sonnet 5.5, Haiku 5.5 e Fable 5.1 con una chiave API o un abbonamento Claude, mantieni la cache quando modifichi lo sforzo. Claude Code [applica il nuovo livello](https://code.claude.com/docs/it/model-config.md#when-a-new-effort-level-starts) senza chiedere. Su Amazon Bedrock, su Google Cloud's Agent Platform o su un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway), oppure quando imposti [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) o la tua organizzazione ha una configurazione HIPAA, il comportamento è lo stesso della maggior parte dei modelli.97Con una chiave API o un abbonamento Claude, modificare lo sforzo mantiene la cache su Fable 5.1 e successivi, Opus 5.5, Sonnet 5.5 e Haiku 5.5. Claude Code [applica il nuovo livello](https://code.claude.com/docs/it/model-config.md#when-a-new-effort-level-starts) senza chiedere. Su Amazon Bedrock, su Google Cloud's Agent Platform o su un [gateway di app Claude](https://code.claude.com/docs/it/claude-apps-gateway), oppure quando imposti [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/it/llm-gateway-protocol#disable-pre-release-capabilities) o la tua organizzazione ha una configurazione HIPAA, il comportamento è lo stesso della maggior parte dei modelli.

98 98 

99Prima della v2.1.260, modificare lo sforzo su Fable 5.1 con una chiave API o un abbonamento Claude invalidava anche la cache.99Prima della v2.1.260, modificare lo sforzo su Fable 5.1 con una chiave API o un abbonamento Claude invalidava anche la cache.

100 100 

Details

49> claude remote-control49> claude remote-control

50> ```50> ```

51>51>

52> `claude rc` è un alias per questo comando.

53>

52> Fino a quando non si accetta la conferma una tantum di Remote Control, `claude remote-control` spiega cosa fa e chiede `Enable Remote Control? (y/n)` prima di avviare il server. Rispondere `y` per accettare e avviare il server. Se si rifiuta, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che si esegue il comando.54> Fino a quando non si accetta la conferma una tantum di Remote Control, `claude remote-control` spiega cosa fa e chiede `Enable Remote Control? (y/n)` prima di avviare il server. Rispondere `y` per accettare e avviare il server. Se si rifiuta, Claude Code esce senza avviare il server e chiede di nuovo la prossima volta che si esegue il comando.

53>55>

54> Il processo rimane in esecuzione nel terminale in modalità server, in attesa di connessioni remote. Visualizza un URL che puoi utilizzare per [connetterti da un altro dispositivo](#connect-from-another-device), e puoi premere la barra spaziatrice per visualizzare un codice QR per un accesso rapido dal telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l'attività degli strumenti.56> Il processo rimane in esecuzione nel terminale in modalità server, in attesa di connessioni remote. Visualizza un URL che puoi utilizzare per [connetterti da un altro dispositivo](#connect-from-another-device), e puoi premere la barra spaziatrice per visualizzare un codice QR per un accesso rapido dal telefono. Mentre una sessione remota è attiva, il terminale mostra lo stato della connessione e l'attività degli strumenti.


462* **Il tuo piano claude.ai è Pro, Max o Ultra**: Claude Code è ancora connesso con un'organizzazione Team o Enterprise da un accesso precedente, quindi controlla la policy Remote Control di quell'organizzazione. Esegui `/status` per vedere quale piano e organizzazione utilizza il tuo accesso. Esegui `claude auth logout` quindi `claude auth login` per accedere di nuovo con il tuo piano attuale.464* **Il tuo piano claude.ai è Pro, Max o Ultra**: Claude Code è ancora connesso con un'organizzazione Team o Enterprise da un accesso precedente, quindi controlla la policy Remote Control di quell'organizzazione. Esegui `/status` per vedere quale piano e organizzazione utilizza il tuo accesso. Esegui `claude auth logout` quindi `claude auth login` per accedere di nuovo con il tuo piano attuale.

463* **Il messaggio non dice di contattare l'amministratore della tua organizzazione**: alla tua organizzazione è applicata la [configurazione HIPAA](https://code.claude.com/docs/it/hipaa-setup.md), che disattiva Remote Control. Per verificarlo, esegui `/status` e cerca `HIPAA` nella riga `Organization configuration`. Un Owner vede l'interruttore **Remote Control** disattivato in grigio nelle [impostazioni di amministrazione](https://claude.ai/admin-settings/claude-code) e non può attivarlo. Se hai domande sulla configurazione, chiedi a un Owner, che può contattare il team account Anthropic della tua organizzazione. Prima della v2.1.267, questo caso mostrava "Remote Control isn't available for your organization due to its compliance policy" invece.465* **Il messaggio non dice di contattare l'amministratore della tua organizzazione**: alla tua organizzazione è applicata la [configurazione HIPAA](https://code.claude.com/docs/it/hipaa-setup.md), che disattiva Remote Control. Per verificarlo, esegui `/status` e cerca `HIPAA` nella riga `Organization configuration`. Un Owner vede l'interruttore **Remote Control** disattivato in grigio nelle [impostazioni di amministrazione](https://claude.ai/admin-settings/claude-code) e non può attivarlo. Se hai domande sulla configurazione, chiedi a un Owner, che può contattare il team account Anthropic della tua organizzazione. Prima della v2.1.267, questo caso mostrava "Remote Control isn't available for your organization due to its compliance policy" invece.

464* **Remote Control funziona per altri membri della tua organizzazione ma non per te**: se la tua organizzazione Enterprise gestisce il tuo accesso con [ruoli personalizzati](https://support.claude.com/en/articles/13930452), la causa possono essere i tuoi ruoli. Remote Control richiede sia il permesso per le sessioni cloud sia il permesso **Claude Code remote control**. Chiedi a un Owner di verificare se i tuoi ruoli includono entrambi e di aggiungere ciò che manca in [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).466* **Remote Control funziona per altri membri della tua organizzazione ma non per te**: se la tua organizzazione Enterprise gestisce il tuo accesso con [ruoli personalizzati](https://support.claude.com/en/articles/13930452), la causa possono essere i tuoi ruoli. Remote Control richiede sia il permesso per le sessioni cloud sia il permesso **Claude Code remote control**. Chiedi a un Owner di verificare se i tuoi ruoli includono entrambi e di aggiungere ciò che manca in [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

467* **Un Owner vede un banner [Zero Data Retention](https://code.claude.com/docs/it/zero-data-retention.md) nelle [impostazioni di amministrazione](https://claude.ai/admin-settings/claude-code)**: Remote Control non è disponibile per la tua organizzazione e un Owner non può attivarlo.

465* **Altrimenti, un Owner non l'ha abilitato per la tua organizzazione**: Remote Control è disattivato per impostazione predefinita sui piani Team e Enterprise. Un Owner può abilitarlo su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) attivando l'interruttore **Remote Control**. Questo interruttore è un'impostazione dell'organizzazione lato server.468* **Altrimenti, un Owner non l'ha abilitato per la tua organizzazione**: Remote Control è disattivato per impostazione predefinita sui piani Team e Enterprise. Un Owner può abilitarlo su [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) attivando l'interruttore **Remote Control**. Questo interruttore è un'impostazione dell'organizzazione lato server.

466 469 

467Prima della v2.1.281, questo messaggio appariva anche quando Claude Code non aveva caricato la policy della tua organizzazione su questa macchina, ad esempio dopo l'avvio offline. Le versioni successive segnalano quello stato come [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) invece.470Prima della v2.1.281, questo messaggio appariva anche quando Claude Code non aveva caricato la policy della tua organizzazione su questa macchina, ad esempio dopo l'avvio offline. Le versioni successive segnalano quello stato come [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) invece.

Details

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

155| `CLAUDE_RUNNER_REPO_URL` | URL del repository da clonare, dopo che `--git-host-rewrite` e `--git-ssh-rewrite` sono stati applicati |155| `CLAUDE_RUNNER_REPO_URL` | URL del repository da clonare, dopo che `--git-host-rewrite` e `--git-ssh-rewrite` sono stati applicati |

156| `CLAUDE_RUNNER_REPO_REF` | Revisione di cui eseguire il checkout, come richiesta dalla sessione: un branch, un tag, un commit SHA o un nome di riferimento completo come `refs/heads/<branch>` o `refs/pull/<number>/head`. Vuoto indica il branch predefinito del repository. |156| `CLAUDE_RUNNER_REPO_REF` | Revisione di cui eseguire il checkout, come richiesta dalla sessione: un branch, un tag, un commit SHA o un nome di riferimento completo come `refs/heads/<branch>` o `refs/pull/<number>/head`. Vuoto indica il branch predefinito del repository. |

157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Percorso assoluto dove l'albero di lavoro deve essere lasciato |157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Percorso assoluto dove l'albero di lavoro deve essere lasciato. Consulta [Nomi delle cartelle di checkout](#checkout-folder-names). |

158| `CLAUDE_RUNNER_SESSION_ID` | ID sessione nel modulo taggato `session_...`, per la registrazione e la correlazione |158| `CLAUDE_RUNNER_SESSION_ID` | ID sessione nel modulo taggato `session_...`, per la registrazione e la correlazione |

159| `CLAUDE_RUNNER_SESSION_UUID` | Lo stesso ID sessione nel modulo UUID canonico |159| `CLAUDE_RUNNER_SESSION_UUID` | Lo stesso ID sessione nel modulo UUID canonico |

160| `CLAUDE_RUNNER_API_BASE_URL` | URL di base dell'API Anthropic per le chiamate limitate alla sessione |160| `CLAUDE_RUNNER_API_BASE_URL` | URL di base dell'API Anthropic per le chiamate limitate alla sessione |


166 166 

167Dopo che il tuo hook termina, il runner verifica che `CLAUDE_RUNNER_CHECKOUT_PATH` contenga un `.git`. Se il tuo hook materializza una sorgente non git come Perforce o un tarball scompattato, imposta `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` nell'ambiente del runner per saltare quel controllo. I flussi basati su git come la creazione del branch di lavoro e il push dei risultati richiedono un checkout git, quindi esporta i risultati da alberi non git con un [hook `post-session`](#post-session).167Dopo che il tuo hook termina, il runner verifica che `CLAUDE_RUNNER_CHECKOUT_PATH` contenga un `.git`. Se il tuo hook materializza una sorgente non git come Perforce o un tarball scompattato, imposta `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` nell'ambiente del runner per saltare quel controllo. I flussi basati su git come la creazione del branch di lavoro e il push dei risultati richiedono un checkout git, quindi esporta i risultati da alberi non git con un [hook `post-session`](#post-session).

168 168 

169#### Nomi delle cartelle di checkout

170 

171`CLAUDE_RUNNER_CHECKOUT_PATH` termina con una cartella chiamata `<repo-owner>-<repo>`, come `acme-api`. Due repository in una sessione non possono condividere una cartella, anche quando i loro nomi differiscono solo per maiuscole e minuscole. Ad esempio, se una sessione elenca `acme/api` e poi `Acme/API`, il primo ottiene `acme-api` e il secondo ottiene `Acme-API-2`.

172 

169#### Ottenere le credenziali git nell'hook173#### Ottenere le credenziali git nell'hook

170 174 

171Il runner non passa una credenziale git all'hook. Nemmeno il sottocomando `decode-token` è disponibile qui, perché `CLAUDE_RUNNER_CLAUDE_BIN` non è impostato nell'ambiente dell'hook di checkout. Genera invece una credenziale di clone per sessione a partire dall'identità della sessione, oppure ricorri all'autenticazione git dell'host stesso:175Il runner non passa una credenziale git all'hook. Nemmeno il sottocomando `decode-token` è disponibile qui, perché `CLAUDE_RUNNER_CLAUDE_BIN` non è impostato nell'ambiente dell'hook di checkout. Genera invece una credenziale di clone per sessione a partire dall'identità della sessione, oppure ricorri all'autenticazione git dell'host stesso:

Details

23 * **Con [git gestito da Anthropic](#use-the-anthropic-git-proxy)**: con una tale credenziale, Claude raggiunge GitHub direttamente invece che tramite git gestito da Anthropic.23 * **Con [git gestito da Anthropic](#use-the-anthropic-git-proxy)**: con una tale credenziale, Claude raggiunge GitHub direttamente invece che tramite git gestito da Anthropic.

24 * **Senza git gestito da Anthropic**: una credenziale di clone può restare nell'immagine se ne limiti l'ambito in modo rigoroso come descritto in [Includi la configurazione git nella tua immagine](#ship-git-config-in-your-image).24 * **Senza git gestito da Anthropic**: una credenziale di clone può restare nell'immagine se ne limiti l'ambito in modo rigoroso come descritto in [Includi la configurazione git nella tua immagine](#ship-git-config-in-your-image).

25* **Mantieni il segreto dell'ambiente lontano dagli host che eseguono sessioni**: il segreto dell'ambiente può registrare runner e raccogliere qualsiasi sessione in coda sull'ambiente. Su una flotta fissa vive su ogni host runner, dove il codice di qualsiasi sessione può leggere il file segreto. Preferisci [runner on-demand](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#on-demand-runners), dove il segreto rimane sull'host dell'orchestrator, che non esegue mai codice utente, e ogni runner riceve un ordine di lavoro monouso che registra esattamente un runner. Su una flotta fissa, tratta il file environment-secret come leggibile da ogni sessione e ruota il segreto dopo qualsiasi sospetto compromesso della sessione.25* **Mantieni il segreto dell'ambiente lontano dagli host che eseguono sessioni**: il segreto dell'ambiente può registrare runner e raccogliere qualsiasi sessione in coda sull'ambiente. Su una flotta fissa vive su ogni host runner, dove il codice di qualsiasi sessione può leggere il file segreto. Preferisci [runner on-demand](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#on-demand-runners), dove il segreto rimane sull'host dell'orchestrator, che non esegue mai codice utente, e ogni runner riceve un ordine di lavoro monouso che registra esattamente un runner. Su una flotta fissa, tratta il file environment-secret come leggibile da ogni sessione e ruota il segreto dopo qualsiasi sospetto compromesso della sessione.

26 * **Dopo un sospetto compromesso**: chiedi a un [Owner](https://code.claude.com/docs/it/cloud-environments.md#organization-shared-environments) di creare un nuovo segreto e di revocare quello vecchio dalla scheda **Configuration** dell'ambiente, quindi distribuisci quello nuovo. Anthropic rifiuta ogni orchestrator e runner che usa il vecchio segreto, inclusi i runner on-demand avviati dai suoi ordini di lavoro. I tuoi runner terminano, interrompendo le loro sessioni.

26* **Egress di rete default-deny**: limita il traffico in uscita del container runner e sessione al tuo confine di rete su ogni ambiente; [Default-deny egress](#default-deny-egress) copre cosa consentire e perché.27* **Egress di rete default-deny**: limita il traffico in uscita del container runner e sessione al tuo confine di rete su ogni ambiente; [Default-deny egress](#default-deny-egress) copre cosa consentire e perché.

27* **IAM host con privilegi minimi**: l'identità di calcolo allegata all'host runner, come un profilo di istanza o un account di servizio del nodo, dovrebbe concedere solo ciò di cui il runner stesso ha bisogno. Le sessioni dovrebbero ottenere le proprie credenziali attraverso il tuo script wrapper piuttosto che ereditare quelle dell'host.28* **IAM host con privilegi minimi**: l'identità di calcolo allegata all'host runner, come un profilo di istanza o un account di servizio del nodo, dovrebbe concedere solo ciò di cui il runner stesso ha bisogno. Le sessioni dovrebbero ottenere le proprie credenziali attraverso il tuo script wrapper piuttosto che ereditare quelle dell'host.

28* **Blocca l'endpoint dei metadati cloud dalle sessioni**: mantenere le sessioni fuori dall'identità dell'host richiede il blocco del loro accesso all'endpoint dei metadati cloud, e le politiche di egress a livello di subnet non intercettano il traffico dei metadati link-local, quindi bloccalo nel container stesso:29* **Blocca l'endpoint dei metadati cloud dalle sessioni**: mantenere le sessioni fuori dall'identità dell'host richiede il blocco del loro accesso all'endpoint dei metadati cloud, e le politiche di egress a livello di subnet non intercettano il traffico dei metadati link-local, quindi bloccalo nel container stesso:


203> [!WARNING]204> [!WARNING]

204>205>

205> Con `--use-anthropic-git-proxy` impostato, il runner elimina e sostituisce la configurazione git globale dell'utente con cui viene eseguito, senza conservarne un backup. Lo fa all'avvio e prima di ogni sessione. Un login o un credential helper che tenevi lì va perso. Le impostazioni scritte da [`--configure-git`](#let-the-runner-configure-git) vengono mantenute. Esegui il runner come utente dedicato o in un container, mai con il tuo utente.206> Con `--use-anthropic-git-proxy` impostato, il runner elimina e sostituisce la configurazione git globale dell'utente con cui viene eseguito, senza conservarne un backup. Lo fa all'avvio e prima di ogni sessione. Un login o un credential helper che tenevi lì va perso. Le impostazioni scritte da [`--configure-git`](#let-the-runner-configure-git) vengono mantenute. Esegui il runner come utente dedicato o in un container, mai con il tuo utente.

207>

208> La configurazione git globale comprende tutti e tre questi elementi: `~/.gitconfig`, il file indicato da `GIT_CONFIG_GLOBAL` se lo imposti, e l'intera directory `$XDG_CONFIG_HOME/git`, per impostazione predefinita `~/.config/git`.

206 209 

207Mantieni le impostazioni git non segrete, come l'identità e `safe.directory`, nella configurazione git di sistema.210Mantieni le impostazioni git non segrete, come l'identità e `safe.directory`, nella configurazione git di sistema.

208 211 


247* **Una riga contenente `remote: access denied by the git proxy`**: una sessione servita da Anthropic può comunque essere rifiutata, ad esempio quando la policy dell'organizzazione nega l'accesso git per la sessione, o la sessione non è autorizzata per il repository. Il log del runner mostra allora una riga contenente `remote: access denied by the git proxy`, e il resto di quella riga ne indica il motivo.250* **Una riga contenente `remote: access denied by the git proxy`**: una sessione servita da Anthropic può comunque essere rifiutata, ad esempio quando la policy dell'organizzazione nega l'accesso git per la sessione, o la sessione non è autorizzata per il repository. Il log del runner mostra allora una riga contenente `remote: access denied by the git proxy`, e il resto di quella riga ne indica il motivo.

248* **`GitHub authentication required`**: compare quando il creatore della sessione non ha una connessione GitHub funzionante su claude.ai. Il clone della sessione fallisce e l'errore git riporta `GitHub authentication required. Please reconnect your GitHub account.` Chiedi a quella persona di collegare o ricollegare GitHub nelle sue impostazioni di claude.ai.251* **`GitHub authentication required`**: compare quando il creatore della sessione non ha una connessione GitHub funzionante su claude.ai. Il clone della sessione fallisce e l'errore git riporta `GitHub authentication required. Please reconnect your GitHub account.` Chiedi a quella persona di collegare o ricollegare GitHub nelle sue impostazioni di claude.ai.

249 252 

250Dopo aver corretto la causa, avvia di nuovo le sessioni non riuscite.253Dopo aver corretto la causa, riavvia i runner su cui le sessioni non sono riuscite, quindi chiedi a ciascun creatore di inviare un messaggio nella propria sessione oppure a un Owner di selezionare **Retry**.

251 254 

252#### Disattiva il proxy git di Anthropic255#### Disattiva il proxy git di Anthropic

253 256 


265 268 

266Fornisci credenziali che funzionino senza un prompt per ogni host git usato dalle sessioni dei runner, github.com compreso. Qualsiasi credenziale presente nella configurazione git globale dell'utente del runner non c'è più, perché il runner ha eliminato quella configurazione mentre `--use-anthropic-git-proxy` era impostato. [Spedisci le credenziali nella tua immagine](#ship-git-config-in-your-image) o usa un [lifecycle hook `checkout`](https://code.claude.com/docs/it/self-hosted-environments-configuration#checkout).269Fornisci credenziali che funzionino senza un prompt per ogni host git usato dalle sessioni dei runner, github.com compreso. Qualsiasi credenziale presente nella configurazione git globale dell'utente del runner non c'è più, perché il runner ha eliminato quella configurazione mentre `--use-anthropic-git-proxy` era impostato. [Spedisci le credenziali nella tua immagine](#ship-git-config-in-your-image) o usa un [lifecycle hook `checkout`](https://code.claude.com/docs/it/self-hosted-environments-configuration#checkout).

267 270 

271Per mantenere invece le credenziali nella [configurazione git globale](#git-proxy-replaces-global-git-config), [arresta prima i runner](#shutdown-timing), perché un runner avviato con il flag la riscrive prima di ogni sessione. Quindi elimina `$XDG_CONFIG_HOME/git`, per impostazione predefinita `~/.config/git`, e sostituisci `~/.gitconfig`, o il file indicato da `GIT_CONFIG_GLOBAL`, con il tuo.

272 

268**3. Apri il percorso di rete**273**3. Apri il percorso di rete**

269 274 

270Consenti al runner di raggiungere ogni host git usato dalle sessioni dei runner sulla porta 443 o 22. Vedi la riga dell'host git in [Requisiti di rete](#network-requirements).275Consenti al runner di raggiungere ogni host git usato dalle sessioni dei runner sulla porta 443 o 22. Vedi la riga dell'host git in [Requisiti di rete](#network-requirements).


507 512 

508## Kubernetes513## Kubernetes

509 514 

510Il runner espone `GET /healthz` sulla porta 8080 per impostazione predefinita, configurabile con `--health-port`, quindi le probe di Kubernetes funzionano senza alcuna configurazione aggiuntiva. L'endpoint restituisce `200` ogni volta che il processo è attivo, quindi le probe seguenti rilevano un processo terminato, non uno bloccato; per individuare un runner che ha smesso di eseguire il polling, imposta un avviso sulla serie `last_poll_age_seconds` da [`/metrics`](https://code.claude.com/docs/it/self-hosted-environments-reference#prometheus-metrics). Il Deployment seguente monta il secret dell'ambiente da un Secret di Kubernetes, punta le probe di liveness e readiness a `/healthz` e imposta un periodo di tolleranza per la terminazione di 90 secondi. Consulta [Tempistiche di arresto](#shutdown-timing) per capire perché il periodo di tolleranza è importante.515Il runner espone `GET /healthz` sulla porta 8080 per impostazione predefinita, configurabile con `--health-port`. Dopo l'avvio, l'endpoint restituisce `200` ogni volta che il processo è attivo, quindi le probe seguenti rilevano un processo terminato, non uno bloccato. Per individuare un runner che ha smesso di eseguire il polling, imposta un avviso sulla serie `last_poll_age_seconds` da [`/metrics`](https://code.claude.com/docs/it/self-hosted-environments-reference#prometheus-metrics).

516 

517Il Deployment seguente monta il secret dell'ambiente da un Secret di Kubernetes, punta le probe di liveness e readiness a `/healthz` e imposta un periodo di tolleranza per la terminazione di 90 secondi. Consulta [Tempistiche di arresto](#shutdown-timing) per capire perché il periodo di tolleranza è importante.

511 518 

512Il manifest non imposta `resources` di CPU o memoria sul container del runner. Aggiungi un blocco dimensionato per la capacità che esegui, come descritto in [Dimensionare CPU e memoria per le sessioni](#size-cpu-and-memory-for-sessions).519Il manifest non imposta `resources` di CPU o memoria sul container del runner. Aggiungi un blocco dimensionato per la capacità che esegui, come descritto in [Dimensionare CPU e memoria per le sessioni](#size-cpu-and-memory-for-sessions).

513 520 


565 secretName: claude-runner-environment-secret572 secretName: claude-runner-environment-secret

566```573```

567 574 

575> [!NOTE]

576>

577> Se gli eventi del pod mostrano che la probe di liveness fallisce durante l'avvio, aumenta il suo `initialDelaySeconds` o aggiungi una `startupProbe`. Nulla risponde sulla porta di health finché il runner non si è registrato e non ha completato i controlli di avvio. Con le impostazioni precedenti, Kubernetes riavvia un runner che non risponde entro circa 90 secondi.

578 

568Il Deployment precedente si trova in un namespace `claude-runners`. Crea prima il namespace:579Il Deployment precedente si trova in un namespace `claude-runners`. Crea prima il namespace:

569 580 

570```bash theme={null}581```bash theme={null}


942 Se ogni chiamata inizia a fallire circa 30 minuti in una sessione, uno script wrapper ha probabilmente reciso lo stdin della sessione, quindi le rotazioni dei token non possono raggiungerlo; vedere [Keep stdin and file descriptor 3 attached](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).953 Se ogni chiamata inizia a fallire circa 30 minuti in una sessione, uno script wrapper ha probabilmente reciso lo stdin della sessione, quindi le rotazioni dei token non possono raggiungerlo; vedere [Keep stdin and file descriptor 3 attached](https://code.claude.com/docs/it/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).

943 954 

944 Prima della v2.1.274, il runner smetteva di riprovare un recupero fallito dopo alcuni tentativi e attendeva il prossimo programmato. Un turno fallito non ha attivato un recupero, quindi ogni turno falliva con un 401 fino al prossimo recupero programmato.955 Prima della v2.1.274, il runner smetteva di riprovare un recupero fallito dopo alcuni tentativi e attendeva il prossimo programmato. Un turno fallito non ha attivato un recupero, quindi ogni turno falliva con un 401 fino al prossimo recupero programmato.

956* **Una sessione mostra `The server has refused to renew this session's access to the model`**: il [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/it/self-hosted-environments-configuration#wrapper-scripts) della sessione è scaduto e il runner ha ricevuto HTTP 400 in risposta alle sue richieste di un nuovo token. Il runner registra `the server has refused to renew the inference_token`. I turni in quella sessione falliscono. Il runner continua a richiedere un nuovo token finché il processo della sessione è in esecuzione:

957 

958 * **Una richiesta riesce**: una sessione che ha mostrato l'avviso mostra poi `The server renewed this session's access to the model`

959 * **I turni continuano a fallire**: il processo alla fine esce e la sessione mostra un errore come `The session process exited with code 1`

960 

961 Per continuare a lavorare senza attendere un nuovo token, avvia una nuova sessione. Se anche una nuova sessione fallisce, verifica se la risposta HTTP 400 è stata data da un tuo proxy o gateway. Se non è così, [contatta il tuo team di account Anthropic](#report-an-issue) con l'ID della prima sessione.

945* **Un turno fallisce in claude.ai/code con `This model needs a newer version of Claude Code`**: la versione di Claude Code con cui i tuoi runner avviano le sessioni è più vecchia di quella richiesta dal modello della sessione, quindi l'API [rifiuta la richiesta](https://code.claude.com/docs/it/errors.md#claude-code-does-not-support-this-model). Aggiorna i runner alla versione indicata dal messaggio, o a una successiva, come descritto in [Fissa la versione](#pin-the-version). Nel frattempo, gli utenti possono scegliere un modello diverso nella sessione.962* **Un turno fallisce in claude.ai/code con `This model needs a newer version of Claude Code`**: la versione di Claude Code con cui i tuoi runner avviano le sessioni è più vecchia di quella richiesta dal modello della sessione, quindi l'API [rifiuta la richiesta](https://code.claude.com/docs/it/errors.md#claude-code-does-not-support-this-model). Aggiorna i runner alla versione indicata dal messaggio, o a una successiva, come descritto in [Fissa la versione](#pin-the-version). Nel frattempo, gli utenti possono scegliere un modello diverso nella sessione.

946* **Il pod viene terminato durante lo scarico**: aumentare `terminationGracePeriodSeconds` ad almeno il valore che il runner registra all'avvio. Vedere [Shutdown timing](#shutdown-timing).963* **Il pod viene terminato durante lo scarico**: aumentare `terminationGracePeriodSeconds` ad almeno il valore che il runner registra all'avvio. Vedere [Shutdown timing](#shutdown-timing).

947* **Il runner registra una riga `[runner:log]` che termina con `was paused or too slow`**: il runner ha continuato a funzionare e non ha bisogno di essere riavviato. Finché il flusso stdout o stderr indicato nella riga non è stato letto di nuovo, il runner ha scartato tutte le righe di quel flusso tranne gli ultimi 256 KiB. Se hai passato [`--log-file`](https://code.claude.com/docs/it/self-hosted-environments-reference#runner-cli-flags), cerca lì le righe scartate.964* **Il runner registra una riga `[runner:log]` che termina con `was paused or too slow`**: il runner ha continuato a funzionare e non ha bisogno di essere riavviato. Finché il flusso stdout o stderr indicato nella riga non è stato letto di nuovo, il runner ha scartato tutte le righe di quel flusso tranne gli ultimi 256 KiB. Se hai passato [`--log-file`](https://code.claude.com/docs/it/self-hosted-environments-reference#runner-cli-flags), cerca lì le righe scartate.

Details

73 73 

74Vai alla [pagina **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) nelle impostazioni di amministrazione. In **Self-hosted environments**, seleziona **New**, assegna un nome all'ambiente e seleziona **Create**. Nel secondo passaggio della procedura guidata, seleziona **Copy environment key** per copiare il secret dell'ambiente, che l'interfaccia di amministrazione chiama environment key. claude.ai mostra il secret una sola volta e non puoi recuperarlo in seguito; scade 365 giorni dopo la creazione. L'ID `ccpool_...` dell'ambiente resta visibile nella sua finestra di dettaglio; ti servirà per il controllo `aud` nella [verifica dei token](https://code.claude.com/docs/it/self-hosted-environments-identity.md) e per inviare [sessioni di test dalla CI](https://code.claude.com/docs/it/self-hosted-environments-testing.md#run-the-test-loop).74Vai alla [pagina **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) nelle impostazioni di amministrazione. In **Self-hosted environments**, seleziona **New**, assegna un nome all'ambiente e seleziona **Create**. Nel secondo passaggio della procedura guidata, seleziona **Copy environment key** per copiare il secret dell'ambiente, che l'interfaccia di amministrazione chiama environment key. claude.ai mostra il secret una sola volta e non puoi recuperarlo in seguito; scade 365 giorni dopo la creazione. L'ID `ccpool_...` dell'ambiente resta visibile nella sua finestra di dettaglio; ti servirà per il controllo `aud` nella [verifica dei token](https://code.claude.com/docs/it/self-hosted-environments-identity.md) e per inviare [sessioni di test dalla CI](https://code.claude.com/docs/it/self-hosted-environments-testing.md#run-the-test-loop).

75 75 

76Se perdi il secret o devi ruotarlo, crea un nuovo secret dalla scheda **Configuration** dell'ambiente, distribuisci il nuovo secret ai tuoi runner, quindi revoca quello vecchio. I runner che usano un secret revocato falliscono il successivo polling autenticato ed escono, registrando `poll auth failed`, e il tuo orchestratore li riavvia con il nuovo secret.76Se il secret potrebbe essere stato divulgato, segui [i passaggi della pagina di distribuzione per una sospetta compromissione](https://code.claude.com/docs/it/self-hosted-environments-deploy.md#after-a-suspected-compromise), non la rotazione descritta qui sotto.

77 

78Se perdi il secret o prevedi di ruotarlo, crea un nuovo secret dalla scheda **Configuration** dell'ambiente. Distribuisci il nuovo secret ai tuoi runner, quindi revoca quello vecchio. I runner che usano un secret revocato falliscono il successivo polling autenticato ed escono, registrando `poll auth failed`, e il tuo orchestratore li riavvia con il nuovo secret.

77 79 

78**2. Avvia un runner**80**2. Avvia un runner**

79 81 

Details

141 141 

142## Endpoint di salute142## Endpoint di salute

143 143 

144Il runner serve `GET /healthz` sulla porta di salute configurata. La risposta è `200 OK` ogni volta che il processo è attivo, qualunque stato sia il ciclo di polling, quindi un probe HTTP su questo endpoint rileva solo un processo morto. Il corpo JSON descrive lo stato attuale:144Il runner serve `GET /healthz` sulla porta di salute configurata una volta che si è registrato e ha completato i controlli di avvio. Da quel momento in poi, la risposta è `200 OK` ogni volta che il processo è attivo, qualunque stato sia il ciclo di polling, quindi un probe HTTP su questo endpoint rileva solo un processo morto. Il corpo JSON descrive lo stato attuale:

145 145 

146```json theme={null}146```json theme={null}

147{147{

settings.md +1 −0

Details

310| [`isolatePeerMachines`](https://code.claude.com/docs/it/settings-reference#isolatepeermachines) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false` |310| [`isolatePeerMachines`](https://code.claude.com/docs/it/settings-reference#isolatepeermachines) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false` |

311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/it/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false`. Richiede Claude Code v2.1.257 o successiva |311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/it/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false`. Richiede Claude Code v2.1.257 o successiva |

312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/it/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false`. Richiede Claude Code v2.1.314 o successiva |312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/it/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` da qualsiasi ambito | Rispettato anche quando una fonte gestita imposta `false`. Richiede Claude Code v2.1.314 o successiva |

313| [`permissions.denyInsteadOfPrompting`](https://code.claude.com/docs/it/settings-reference#permissions-denyinsteadofprompting) | `true` da `~/.claude/settings.json` o `--settings` | Rispettato anche quando una fonte gestita imposta `false`. Richiede Claude Code v2.1.319 o successiva |

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

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

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

Details

448 448 

449Attiva la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) per le sessioni in cui è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo in cui vuoi velocità a un costo per token più alto. Di solito non modifichi questa chiave a mano. Eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, ed eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave.449Attiva la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) per le sessioni in cui è disponibile, per il lavoro interattivo come l'iterazione rapida o il debug dal vivo in cui vuoi velocità a un costo per token più alto. Di solito non modifichi questa chiave a mano. Eseguire `/fast` scrive `fastMode: true` in `~/.claude/settings.json`, ed eseguirlo di nuovo per disattivare la modalità veloce rimuove la chiave.

450 450 

451Solo Opus 5.5, Opus 5 e Opus 4.8 supportano la modalità veloce. Eseguire `/fast` da un altro modello ti fa passare a Opus, e passare a un modello non supportato disattiva la modalità veloce. Consulta [Cambiare modello con la modalità veloce attiva](https://code.claude.com/docs/it/fast-mode.md#switch-models-while-fast-mode-is-on).451Solo Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8 supportano la modalità veloce. Eseguire `/fast` da un altro modello ti fa passare a Opus, e passare a un modello non supportato disattiva la modalità veloce. Consulta [Cambiare modello con la modalità veloce attiva](https://code.claude.com/docs/it/fast-mode.md#switch-models-while-fast-mode-is-on).

452 452 

453* **Ambito**: [`Any file`](#scopes)453* **Ambito**: [`Any file`](#scopes)

454* **Tipo**: Boolean454* **Tipo**: Boolean

455 * `true`: Claude Code attiva la modalità veloce per le sessioni in cui è disponibile455 * `true`: Claude Code attiva la modalità veloce per le sessioni in cui è disponibile. Su Fable 5.2, devi anche [eseguire `/fast` mentre usi Fable 5.2](https://code.claude.com/docs/it/fast-mode#switch-models-while-fast-mode-is-on)

456 * `false`: la modalità veloce resta disattivata456 * `false`: la modalità veloce resta disattivata

457* **Predefinito**: non impostato, quindi la modalità veloce è disattivata457* **Predefinito**: non impostato, quindi la modalità veloce è disattivata

458* **Override per sessione**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/it/env-vars) disattiva la modalità veloce per una sessione, e questa chiave non può riattivarla458* **Override per sessione**: [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/it/env-vars) disattiva la modalità veloce per una sessione, e questa chiave non può riattivarla


465 465 

466### `fastModePerSessionOptIn`466### `fastModePerSessionOptIn`

467 467 

468Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi le nuove sessioni su un modello supportato si avviano con la modalità veloce attiva. Imposta questa chiave su `true` per impedirlo: un `fastMode: true` salvato non attiva più la modalità veloce all'avvio della sessione, e ogni persona deve eseguire `/fast` in ogni sessione in cui la vuole. Claude Code lascia la chiave `fastMode` nel loro file, quindi disattivare questa chiave ripristina il comportamento precedente.468Normalmente, eseguire `/fast` salva [`fastMode`](#fastmode) nelle impostazioni utente di una persona, quindi le nuove sessioni su un modello supportato si avviano con la modalità veloce attiva. Su Fable 5.2, questo avviene solo se la persona [l'ha attivata mentre usava Fable 5.2](https://code.claude.com/docs/it/fast-mode.md#switch-models-while-fast-mode-is-on). Per fare in modo che ogni persona esegua `/fast` in ogni sessione in cui la vuole, imposta questa chiave su `true`. Claude Code lascia la chiave `fastMode` nel loro file, quindi disattivare questa chiave ripristina il comportamento precedente.

469 469 

470Gli Owner dei piani Team o Enterprise possono distribuirla in tutta l'organizzazione tramite le [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Quando le impostazioni gestite impostano la chiave, `/fast on` viene rifiutato al di fuori delle sessioni interattive nel terminale e segnala che la tua organizzazione ha disabilitato la modalità veloce. Questo riguarda la [modalità non interattiva](https://code.claude.com/docs/it/headless.md), l'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md) e le [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md).470Gli Owner dei piani Team o Enterprise possono distribuirla in tutta l'organizzazione tramite le [impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Quando le impostazioni gestite impostano la chiave, `/fast on` viene rifiutato al di fuori delle sessioni interattive nel terminale e segnala che la tua organizzazione ha disabilitato la modalità veloce. Questo riguarda la [modalità non interattiva](https://code.claude.com/docs/it/headless.md), l'[estensione VS Code](https://code.claude.com/docs/it/vs-code.md) e le [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md).

471 471 

472* **Ambito**: [`Any file`](#scopes)472* **Ambito**: [`Any file`](#scopes)

473* **Tipo**: Boolean473* **Tipo**: Boolean

474 * `true`: un `fastMode: true` salvato non attiva più la modalità veloce all'avvio della sessione, quindi ogni persona esegue `/fast` in ogni sessione in cui la vuole; un `fastMode: true` passato con `--settings` vale comunque per quella sessione, a meno che le impostazioni gestite non impostino questa chiave474 * `true`: un `fastMode: true` salvato non attiva più la modalità veloce all'avvio della sessione, quindi ogni persona esegue `/fast` in ogni sessione in cui la vuole; un `fastMode: true` passato con `--settings` vale comunque per quella sessione, a meno che le impostazioni gestite non impostino questa chiave

475 * `false`: un `fastMode: true` salvato attiva la modalità veloce all'inizio di ogni nuova sessione su un modello supportato475 * `false`: un `fastMode: true` salvato funziona come descritto in [`fastMode`](#fastmode)

476* **Predefinito**: `false`476* **Predefinito**: `false`

477 477 

478```json settings.json theme={null}478```json settings.json theme={null}

sub-agents.md +2 −0

Details

592La modalità di autorizzazione della conversazione principale decide se Claude Code utilizza il valore che imposta:592La modalità di autorizzazione della conversazione principale decide se Claude Code utilizza il valore che imposta:

593 593 

594* Quando la conversazione principale è in `bypassPermissions`, `acceptEdits`, o [auto mode](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), il subagent viene eseguito in quella stessa modalità e Claude Code ignora il `permissionMode` che imposta. Sotto auto mode, il classificatore valuta le chiamate di strumenti del subagent con le regole di blocco e consentimento della conversazione principale. Quando il subagent finisce, il classificatore esamina anche il suo lavoro e il suo rapporto finale prima che il rapporto venga consegnato, come [Come auto mode gestisce i subagent](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) descrive.594* Quando la conversazione principale è in `bypassPermissions`, `acceptEdits`, o [auto mode](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode), il subagent viene eseguito in quella stessa modalità e Claude Code ignora il `permissionMode` che imposta. Sotto auto mode, il classificatore valuta le chiamate di strumenti del subagent con le regole di blocco e consentimento della conversazione principale. Quando il subagent finisce, il classificatore esamina anche il suo lavoro e il suo rapporto finale prima che il rapporto venga consegnato, come [Come auto mode gestisce i subagent](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) descrive.

595 

596 Se un subagent chiede un permesso mentre la conversazione principale è in `bypassPermissions`, verifica se la sua chiamata allo strumento rientra tra le [azioni che nessuna modalità approva automaticamente](https://code.claude.com/docs/it/permission-modes.md#actions-no-mode-auto-approves).

595* Quando la conversazione principale è in modalità `plan`, il subagent rimane in plan mode qualunque `permissionMode` tu imposti, a meno che non venga eseguito come [compagno di squadra di un team di agenti](#subagent-names) secondo le [regole dei team di agenti](https://code.claude.com/docs/it/agent-teams.md#have-teammates-plan-before-implementing). Se imposti `dontAsk`, il subagent inoltre non ti chiede nulla: un'azione per cui il plan mode ti chiederebbe l'approvazione viene invece negata.597* Quando la conversazione principale è in modalità `plan`, il subagent rimane in plan mode qualunque `permissionMode` tu imposti, a meno che non venga eseguito come [compagno di squadra di un team di agenti](#subagent-names) secondo le [regole dei team di agenti](https://code.claude.com/docs/it/agent-teams.md#have-teammates-plan-before-implementing). Se imposti `dontAsk`, il subagent inoltre non ti chiede nulla: un'azione per cui il plan mode ti chiederebbe l'approvazione viene invece negata.

596* Quando la conversazione principale è in modalità `default` o `dontAsk`, il subagent viene eseguito nella modalità di permesso che imposti. Mantiene invece la modalità di permesso della conversazione principale in questi casi:598* Quando la conversazione principale è in modalità `default` o `dontAsk`, il subagent viene eseguito nella modalità di permesso che imposti. Mantiene invece la modalità di permesso della conversazione principale in questi casi:

597 * Imposti `bypassPermissions`. L'eccezione per `bypassPermissions` richiede Claude Code v2.1.267 o successivo.599 * Imposti `bypassPermissions`. L'eccezione per `bypassPermissions` richiede Claude Code v2.1.267 o successivo.

Details

26| `CronDelete` | Annulla un'attività pianificata con ambito di sessione per ID | No |26| `CronDelete` | Annulla un'attività pianificata con ambito di sessione per ID | No |

27| `CronList` | Elenca tutte le attività pianificate con ambito di sessione | No |27| `CronList` | Elenca tutte le attività pianificate con ambito di sessione | No |

28| `Edit` | Effettua modifiche mirate a file specifici. Vedi [Comportamento dello strumento Edit](#edit-tool-behavior) | Yes |28| `Edit` | Effettua modifiche mirate a file specifici. Vedi [Comportamento dello strumento Edit](#edit-tool-behavior) | Yes |

29| `EndConversation` | Termina la sessione, in rari casi di input abusivo sostenuto o quando chiedi a Claude di dimostrare lo strumento. Vedi [Comportamento dello strumento EndConversation](#endconversation-tool-behavior) | No |29| `EndConversation` | Termina la sessione, in rari casi di input abusivo sostenuto o quando chiedi a Claude di terminare la sessione e poi confermi. Vedi [Comportamento dello strumento EndConversation](#endconversation-tool-behavior) | No |

30| `EnterPlanMode` | Passa al plan mode per progettare un approccio prima di scrivere codice | No |30| `EnterPlanMode` | Passa al plan mode per progettare un approccio prima di scrivere codice | No |

31| `EnterWorktree` | Crea un [git worktree](https://code.claude.com/docs/it/worktrees.md) isolato e vi entra, oppure entra in un worktree esistente. Vedi [Comportamento dello strumento EnterWorktree](#enterworktree-tool-behavior) | Yes |31| `EnterWorktree` | Crea un [git worktree](https://code.claude.com/docs/it/worktrees.md) isolato e vi entra, oppure entra in un worktree esistente. Vedi [Comportamento dello strumento EnterWorktree](#enterworktree-tool-behavior) | Yes |

32| `ExitPlanMode` | Presenta un piano per l'approvazione ed esce dal plan mode | Yes |32| `ExitPlanMode` | Presenta un piano per l'approvazione ed esce dal plan mode | Yes |


274 274 

275Lo strumento EndConversation termina la sessione corrente. Claude lo utilizza solo in due situazioni:275Lo strumento EndConversation termina la sessione corrente. Claude lo utilizza solo in due situazioni:

276 276 

277* come ultima risorsa contro input abusivi sostenuti, dopo i tentativi di reindirizzare la conversazione hanno fallito e dopo un avvertimento chiaro in un messaggio precedente277* Quando continui a inviare messaggi abusivi dopo che Claude ha dato un avvertimento chiaro e non è riuscito a reindirizzare la conversazione

278* quando Lei esplicitamente chiede di vedere lo strumento dimostrato e conferma che desidera terminare la sessione278* Quando chiedi esplicitamente a Claude di terminare la sessione, poi confermi quando Claude ti chiede se vuoi ancora procedere

279 279 

280La frustrazione generale, il linguaggio scurrile o un'attività che va male non si qualificano, così come le richieste di contenuti dannosi, che Claude rifiuta invece di terminare la sessione. Claude Code segue lo stesso approccio di claude.ai, che può [terminare un sottoinsieme raro di chat](https://www.anthropic.com/research/end-subset-conversations).280La frustrazione generale, il linguaggio scurrile o un'attività che va male non si qualificano, così come le richieste di contenuti dannosi, che Claude rifiuta invece di terminare la sessione. Claude Code segue lo stesso approccio di claude.ai, che può [terminare un sottoinsieme raro di chat](https://www.anthropic.com/research/end-subset-conversations).

281 281 


390 390 

391Quando Monitor esegue un comando, utilizza le stesse [regole di permesso di Bash](https://code.claude.com/docs/it/permissions.md#tool-specific-permission-rules), quindi i pattern `allow` e `deny` che hai impostato per Bash si applicano anche qui. Mentre la [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) è attiva, Claude Code mette da parte le regole allow che nominano `Monitor` stesso, insieme alle altre [regole allow ampie che elimina](https://code.claude.com/docs/it/permission-modes.md#how-the-classifier-evaluates-actions), quindi il classificatore esamina i comandi Monitor nello stesso modo in cui esamina i comandi Bash.391Quando Monitor esegue un comando, utilizza le stesse [regole di permesso di Bash](https://code.claude.com/docs/it/permissions.md#tool-specific-permission-rules), quindi i pattern `allow` e `deny` che hai impostato per Bash si applicano anche qui. Mentre la [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) è attiva, Claude Code mette da parte le regole allow che nominano `Monitor` stesso, insieme alle altre [regole allow ampie che elimina](https://code.claude.com/docs/it/permission-modes.md#how-the-classifier-evaluates-actions), quindi il classificatore esamina i comandi Monitor nello stesso modo in cui esamina i comandi Bash.

392 392 

393La [sorgente WebSocket](#websocket-source) ha il suo prompt di approvazione, che il classificatore decide anche in modalità auto.

394 

395Monitor richiede una versione minima o Git Bash in questi casi:393Monitor richiede una versione minima o Git Bash in questi casi:

396 394 

397* **Versione minima**: su Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform o Microsoft Foundry, oppure con `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` impostato, Monitor richiede Claude Code v2.1.310 o successivo. Il requisito si applica quando il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching) è disattivato395* **Versione minima**: su Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform o Microsoft Foundry, oppure con `DISABLE_TELEMETRY` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` impostato, Monitor richiede Claude Code v2.1.310 o successivo. Il requisito si applica quando il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching) è disattivato


417 415 

418La scadenza `timeout_ms` si applica anche a un monitoraggio WebSocket: il monitoraggio termina alla scadenza, e `TaskStop` lo annulla anticipatamente.416La scadenza `timeout_ms` si applica anche a un monitoraggio WebSocket: il monitoraggio termina alla scadenza, e `TaskStop` lo annulla anticipatamente.

419 417 

420L'apertura di una WebSocket richiede l'approvazione; in [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) il classificatore decide invece. Il prompt non offre un'opzione per saltare i prompt futuri per lo stesso host.418Senza una regola allow per `Monitor`, ti viene chiesta conferma prima che Claude apra una WebSocket; in [modalità auto](https://code.claude.com/docs/it/permission-modes.md#eliminate-prompts-with-auto-mode) decide invece il classificatore, a meno che non si applichi una [regola ask](#bash-rules-that-deny-or-prompt-for-websocket-watches). Il prompt non offre un'opzione per saltare i prompt futuri per lo stesso host.

419 

420#### Indirizzi e host negati ai monitoraggi WebSocket

421 

422Claude Code nega gli URL che puntano a un indirizzo privato, link-local o cloud-metadata, inclusi i nomi host che la tua macchina risolve in uno di questi. Dietro un [proxy](https://code.claude.com/docs/it/network-config.md#proxy-configuration), un monitoraggio può raggiungere un indirizzo privato, link-local o cloud-metadata a meno che il proxy non lo blocchi, perché Claude Code non controlla l'indirizzo individuato dal proxy. Claude Code nega anche gli host in `sandbox.network.deniedDomains` e, quando [`allowManagedDomainsOnly`](https://code.claude.com/docs/it/settings-reference#sandbox-network-allowmanageddomainsonly) è impostato nelle impostazioni gestite, qualsiasi host al di fuori dell'allowlist gestita.

423 

424Se un monitoraggio dietro un proxy non riesce con `could not resolve <host>`, riavvia Claude Code v2.1.319 o successivo con [`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`](https://code.claude.com/docs/it/env-vars#variables) impostato su `1`, in modo che sia il proxy a risolvere il nome host.

425 

426#### Regole Bash che negano o richiedono conferma per i monitoraggi WebSocket

427 

428Se Claude Code rifiuta una chiamata `Monitor` che apre una WebSocket, cerca una [regola deny o ask](https://code.claude.com/docs/it/permissions.md#manage-permissions) scritta come `Bash` o `Bash(*)`. Fai lo stesso se ti chiede conferma per quella chiamata nonostante la tua regola allow per `Monitor`. Una regola su ogni comando Bash copre anche questi monitoraggi WebSocket:

429 

430* **Regola deny**: se la regola è presente all'avvio della sessione, Claude non ha lo strumento Monitor, quindi non può avviare il monitoraggio. Se aggiungi la regola durante una sessione, la successiva chiamata `Monitor` di Claude viene rifiutata. Il rifiuto riporta `Permission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.`

431* **Regola ask**: ti viene chiesto di approvare il monitoraggio. Non puoi far sì che sia una regola allow, un hook `PreToolUse`, la modalità `bypassPermissions` o il classificatore della modalità auto ad approvarlo al posto tuo. Puoi approvarlo da un [hook `PermissionRequest`](https://code.claude.com/docs/it/hooks#permissionrequest). Dove nessuno può rispondere, ad esempio in modalità `dontAsk`, Claude Code nega il monitoraggio.

432 

433Per consentire l'esecuzione di questi monitoraggi, restringi la regola ai comandi che intendi, ad esempio `Bash(rm *)`.

421 434 

422Claude Code nega gli URL che puntano a un indirizzo privato, link-local o cloud-metadata, inclusi i nomi host che si risolvono in uno. Nega anche gli host in `sandbox.network.deniedDomains` e, quando [`allowManagedDomainsOnly`](https://code.claude.com/docs/it/settings-reference#sandbox-network-allowmanageddomainsonly) è impostato nelle impostazioni gestite, qualsiasi host al di fuori dell'allowlist gestita.435La regola ask, e una regola deny aggiunta durante una sessione, coprono questi monitoraggi in Claude Code v2.1.319 o successivo.

423 436 

424## Comportamento dello strumento NotebookEdit437## Comportamento dello strumento NotebookEdit

425 438 


594* Esecuzioni non interattive con `-p` e sessioni dell'[Agent SDK](https://code.claude.com/docs/it/agent-sdk/overview.md), che non hanno una schermata su cui esaminare la coda607* Esecuzioni non interattive con `-p` e sessioni dell'[Agent SDK](https://code.claude.com/docs/it/agent-sdk/overview.md), che non hanno una schermata su cui esaminare la coda

595* [Sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md), che non possono scrivere nella coda sul tuo computer608* [Sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md), che non possono scrivere nella coda sul tuo computer

596* Sessioni su [Amazon Bedrock](https://code.claude.com/docs/it/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md), [Agent Platform di Google Cloud](https://code.claude.com/docs/it/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/it/microsoft-foundry.md)609* Sessioni su [Amazon Bedrock](https://code.claude.com/docs/it/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/it/claude-platform-on-aws.md), [Agent Platform di Google Cloud](https://code.claude.com/docs/it/google-vertex-ai.md) o [Microsoft Foundry](https://code.claude.com/docs/it/microsoft-foundry.md)

610* Sessioni che raggiungono Claude tramite un [LLM gateway](https://code.claude.com/docs/it/llm-gateway) con la chiave o il token del gateway stesso

597* Sessioni in cui hai impostato [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/it/env-vars) o [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/it/env-vars), hai impostato `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` su un qualsiasi valore non vuoto, oppure hai disattivato il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching)611* Sessioni in cui hai impostato [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/it/env-vars) o [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/it/env-vars), hai impostato `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` su un qualsiasi valore non vuoto, oppure hai disattivato il [recupero dei feature flag](https://code.claude.com/docs/it/env-vars.md#features-that-need-feature-flag-fetching)

598* Organizzazioni che hanno disattivato il feedback sul prodotto, [organizzazioni con Zero Data Retention](https://code.claude.com/docs/it/zero-data-retention.md#features-disabled-under-zdr) e organizzazioni a cui è applicata la [configurazione HIPAA](https://code.claude.com/docs/it/hipaa-setup.md)612* Organizzazioni che hanno disattivato il feedback sul prodotto, [organizzazioni con Zero Data Retention](https://code.claude.com/docs/it/zero-data-retention.md#features-disabled-under-zdr) e organizzazioni a cui è applicata la [configurazione HIPAA](https://code.claude.com/docs/it/hipaa-setup.md)

613* Sessioni in cui Claude Code ha [smesso di offrire il feedback dopo una segnalazione rifiutata](https://code.claude.com/docs/it/errors.md#feedback-is-disabled-by-your-organizations-policy)

599 614 

600## Disponibilità dello strumento Task615## Disponibilità dello strumento Task

601 616 

Details

70 70 

71### Disponibilità dei modelli in ZDR71### Disponibilità dei modelli in ZDR

72 72 

73Claude Fable 5.1 e Fable 5 sono [Covered Models](https://support.claude.com/en/articles/15425695-covered-models) che [richiedono la conservazione dei dati](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) per impostazione predefinita, e se un'organizzazione o uno spazio di lavoro ZDR può utilizzarli è governato dalle politiche Covered Models piuttosto che da Claude Code. Laddove l'organizzazione non possa utilizzarli, i modelli sono assenti dal selettore `/model` oppure vengono visualizzati come disabilitati, e il server rifiuta le richieste per essi indipendentemente dalla configurazione del client.73Claude Fable 5.2, Fable 5.1 e Fable 5 sono [Covered Models](https://support.claude.com/en/articles/15425695-covered-models) che [richiedono la conservazione dei dati](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) per impostazione predefinita, e se un'organizzazione o un workspace ZDR può utilizzarli è governato dalle politiche Covered Models piuttosto che da Claude Code. Laddove la tua organizzazione non possa utilizzarli, i modelli sono assenti dal selettore `/model` oppure vengono visualizzati come disabilitati, e il server rifiuta le richieste per essi indipendentemente dalla configurazione del client.

74 74 

75Gli altri modelli rimangono disponibili in ZDR. I modelli Fable non sono il modello predefinito, e l'alias `best`, che si risolve nel modello Fable più recente dove è disponibile, si risolve in Opus per le organizzazioni dove non lo è.75Gli altri modelli rimangono disponibili in ZDR. I modelli Fable non sono il modello predefinito, e l'alias `best` si risolve in Opus.

76 76 

77## Data retention per violazioni delle politiche77## Data retention per violazioni delle politiche

78 78