SpyBara
Go Premium

Documentation 2026-05-17 01:01 UTC to 2026-05-18 23:59 UTC

34 files changed +365 −173. View all changes and history on the product overview
2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19
Details

111L'SDK include gli stessi strumenti che alimentano Claude Code:111L'SDK include gli stessi strumenti che alimentano Claude Code:

112 112 

113| Categoria | Strumenti | Cosa fanno |113| Categoria | Strumenti | Cosa fanno |

114| :--------------------- | :----------------------------------------------- | :--------------------------------------------------------------------------------------- |114| :--------------------- | :-------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |

115| **Operazioni su file** | `Read`, `Edit`, `Write` | Leggere, modificare e creare file |115| **Operazioni su file** | `Read`, `Edit`, `Write` | Leggere, modificare e creare file |

116| **Ricerca** | `Glob`, `Grep` | Trovare file per pattern, cercare contenuto con regex |116| **Ricerca** | `Glob`, `Grep` | Trovare file per pattern, cercare contenuto con regex |

117| **Esecuzione** | `Bash` | Eseguire comandi shell, script, operazioni git |117| **Esecuzione** | `Bash` | Eseguire comandi shell, script, operazioni git |

118| **Web** | `WebSearch`, `WebFetch` | Cercare il web, recuperare e analizzare pagine |118| **Web** | `WebSearch`, `WebFetch` | Cercare il web, recuperare e analizzare pagine |

119| **Scoperta** | `ToolSearch` | Trovare e caricare dinamicamente gli strumenti su richiesta invece di precaricarli tutti |119| **Scoperta** | `ToolSearch` | Trovare e caricare dinamicamente gli strumenti su richiesta invece di precaricarli tutti |

120| **Orchestrazione** | `Agent`, `Skill`, `AskUserQuestion`, `TodoWrite` | Generare subagenti, invocare skills, chiedere all'utente, tracciare attività |120| **Orchestrazione** | `Agent`, `Skill`, `AskUserQuestion`, `TaskCreate`, `TaskUpdate` | Generare subagenti, invocare skills, chiedere all'utente, tracciare attività |

121 121 

122Oltre agli strumenti integrati, potete:122Oltre agli strumenti integrati, potete:

123 123 


197 197 

198## La finestra di contesto198## La finestra di contesto

199 199 

200La finestra di contesto è la quantità totale di informazioni disponibili a Claude durante una sessione. Non si ripristina tra i turni all'interno di una sessione. Tutto si accumula: il prompt di sistema, le definizioni degli strumenti, la cronologia della conversazione, gli input degli strumenti e gli output degli strumenti. Il contenuto che rimane lo stesso tra i turni (prompt di sistema, definizioni degli strumenti, CLAUDE.md) viene automaticamente [prompt cached](https://platform.claude.com/docs/en/build-with-claude/prompt-caching), il che riduce il costo e la latenza per i prefissi ripetuti.200La finestra di contesto è la quantità totale di informazioni disponibili a Claude durante una sessione. Non si ripristina tra i turni all'interno di una sessione. Tutto si accumula: il prompt di sistema, le definizioni degli strumenti, la cronologia della conversazione, gli input degli strumenti e gli output degli strumenti. Il contenuto che rimane lo stesso tra i turni (prompt di sistema, definizioni degli strumenti, CLAUDE.md) viene automaticamente [prompt cached](https://platform.claude.com/docs/it/build-with-claude/prompt-caching), il che riduce il costo e la latenza per i prefissi ripetuti.

201 201 

202### Cosa consuma il contesto202### Cosa consuma il contesto

203 203 

204Ecco come ogni componente influisce sul contesto nell'SDK:204Ecco come ogni componente influisce sul contesto nell'SDK:

205 205 

206| Fonte | Quando viene caricato | Impatto |206| Fonte | Quando viene caricato | Impatto |

207| :--------------------------------- | :------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |207| :--------------------------------- | :------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

208| **Prompt di sistema** | Ogni richiesta | Costo fisso piccolo, sempre presente |208| **Prompt di sistema** | Ogni richiesta | Costo fisso piccolo, sempre presente |

209| **File CLAUDE.md** | Inizio della sessione, tramite [`settingSources`](/it/agent-sdk/claude-code-features) | Contenuto completo in ogni richiesta (ma prompt-cached, quindi solo la prima richiesta paga il costo completo) |209| **File CLAUDE.md** | Inizio della sessione, tramite [`settingSources`](/it/agent-sdk/claude-code-features) | Contenuto completo in ogni richiesta (ma prompt-cached, quindi solo la prima richiesta paga il costo completo) |

210| **Definizioni degli strumenti** | Ogni richiesta | Ogni strumento aggiunge il suo schema; utilizzare [ricerca di strumenti MCP](/it/agent-sdk/mcp#mcp-tool-search) per caricare gli strumenti su richiesta invece di tutti in una volta |210| **Definizioni degli strumenti** | Ogni richiesta; schemi MCP differiti per impostazione predefinita | Gli schemi degli strumenti integrati vengono caricati ad ogni richiesta. [Tool search](/it/agent-sdk/mcp#mcp-tool-search) differisce gli schemi degli strumenti MCP per impostazione predefinita, ricadendo nel caricamento anticipato su Vertex AI o su un `ANTHROPIC_BASE_URL` non di prima parte. Vedere [Configurare la ricerca degli strumenti](/it/agent-sdk/tool-search#configure-tool-search) per la matrice completa |

211| **Cronologia della conversazione** | Si accumula nel corso dei turni | Cresce con ogni turno: prompt, risposte, input degli strumenti, output degli strumenti |211| **Cronologia della conversazione** | Si accumula nel corso dei turni | Cresce con ogni turno: prompt, risposte, input degli strumenti, output degli strumenti |

212| **Descrizioni delle skills** | Inizio della sessione, tramite setting sources | Brevi riassunti; il contenuto completo viene caricato solo quando invocato |212| **Descrizioni delle skills** | Inizio della sessione, tramite setting sources | Brevi riassunti; il contenuto completo viene caricato solo quando invocato |

213 213 


244Alcune strategie per gli agenti a lunga durata:244Alcune strategie per gli agenti a lunga durata:

245 245 

246* **Utilizzare subagenti per sottoattività.** Ogni subagente inizia con una conversazione fresca (nessuna cronologia di messaggi precedenti, anche se carica il suo prompt di sistema e il contesto a livello di progetto come CLAUDE.md). Non vede i turni del genitore e solo la sua risposta finale ritorna al genitore come risultato dello strumento. Il contesto dell'agente principale cresce per quel riassunto, non per la trascrizione completa della sottoattività. Vedere [Cosa ereditano i subagenti](/it/agent-sdk/subagents#what-subagents-inherit) per i dettagli.246* **Utilizzare subagenti per sottoattività.** Ogni subagente inizia con una conversazione fresca (nessuna cronologia di messaggi precedenti, anche se carica il suo prompt di sistema e il contesto a livello di progetto come CLAUDE.md). Non vede i turni del genitore e solo la sua risposta finale ritorna al genitore come risultato dello strumento. Il contesto dell'agente principale cresce per quel riassunto, non per la trascrizione completa della sottoattività. Vedere [Cosa ereditano i subagenti](/it/agent-sdk/subagents#what-subagents-inherit) per i dettagli.

247* **Essere selettivi con gli strumenti.** Ogni definizione di strumento occupa spazio di contesto. Utilizzate il campo `tools` su [`AgentDefinition`](/it/agent-sdk/subagents#agentdefinition-configuration) per limitare i subagenti al set minimo di cui hanno bisogno, e utilizzate [ricerca di strumenti MCP](/it/agent-sdk/mcp#mcp-tool-search) per caricare gli strumenti su richiesta invece di precaricarli tutti.247* **Essere selettivi con gli strumenti.** Ogni definizione di strumento occupa spazio di contesto. Utilizzate il campo `tools` su [`AgentDefinition`](/it/agent-sdk/subagents#agentdefinition-configuration) per limitare i subagenti al set minimo di cui hanno bisogno.

248* **Controllare i costi dei server MCP.** Ogni server MCP aggiunge tutti i suoi schemi di strumenti a ogni richiesta. Pochi server con molti strumenti possono consumare un contesto significativo prima che l'agente faccia qualsiasi lavoro. Lo strumento `ToolSearch` può aiutare caricando gli strumenti su richiesta invece di precaricarli tutti. Vedere [ricerca di strumenti MCP](/it/agent-sdk/mcp#mcp-tool-search) per la configurazione.248* **Controllare i costi dei server MCP.** [MCP tool search](/it/agent-sdk/mcp#mcp-tool-search) differisce gli schemi degli strumenti MCP per impostazione predefinita e li carica su richiesta. Quando la ricerca degli strumenti è disattivata, su Vertex AI, o dietro un `ANTHROPIC_BASE_URL` non di prima parte, ogni server MCP aggiunge tutti i suoi schemi di strumenti ad ogni richiesta, quindi pochi server con molti strumenti possono consumare un contesto significativo prima che l'agente faccia qualsiasi lavoro.

249* **Utilizzare uno sforzo inferiore per attività di routine.** Impostare [effort](#effort-level) a `"low"` per gli agenti che hanno solo bisogno di leggere file o elencare directory. Questo riduce l'utilizzo dei token e il costo.249* **Utilizzare uno sforzo inferiore per attività di routine.** Impostare [effort](#effort-level) a `"low"` per gli agenti che hanno solo bisogno di leggere file o elencare directory. Questo riduce l'utilizzo dei token e il costo.

250 250 

251Per una ripartizione dettagliata dei costi di contesto per funzione, vedere [Comprendere i costi di contesto](/it/features-overview#understand-context-costs).251Per una ripartizione dettagliata dei costi di contesto per funzione, vedere [Comprendere i costi di contesto](/it/features-overview#understand-context-costs).

Details

19### Confronto rapido19### Confronto rapido

20 20 

21| Funzionalità | `query()` | `ClaudeSDKClient` |21| Funzionalità | `query()` | `ClaudeSDKClient` |

22| :--------------------------- | :--------------------------------- | :------------------------------- |22| :--------------------------- | :--------------------------------------------------- | :------------------------------- |

23| **Sessione** | Crea una nuova sessione ogni volta | Riutilizza la stessa sessione |23| **Sessione** | Crea una nuova sessione per impostazione predefinita | Riutilizza la stessa sessione |

24| **Conversazione** | Singolo scambio | Più scambi nello stesso contesto |24| **Conversazione** | Singolo scambio | Più scambi nello stesso contesto |

25| **Connessione** | Gestita automaticamente | Controllo manuale |25| **Connessione** | Gestita automaticamente | Controllo manuale |

26| **Input Streaming** | ✅ Supportato | ✅ Supportato |26| **Input Streaming** | ✅ Supportato | ✅ Supportato |

27| **Interruzioni** | ❌ Non supportato | ✅ Supportato |27| **Interruzioni** | ❌ Non supportato | ✅ Supportato |

28| **Hooks** | ✅ Supportato | ✅ Supportato |28| **Hooks** | ✅ Supportato | ✅ Supportato |

29| **Strumenti personalizzati** | ✅ Supportato | ✅ Supportato |29| **Strumenti personalizzati** | ✅ Supportato | ✅ Supportato |

30| **Continua chat** | Nuova sessione ogni volta | ✅ Mantiene la conversazione |30| **Continua chat** | Manuale tramite `continue_conversation` o `resume` | ✅ Automatico |

31| **Caso d'uso** | Attività una tantum | Conversazioni continue |31| **Caso d'uso** | Attività una tantum | Conversazioni continue |

32 32 

33### Quando usare `query()` (nuova sessione ogni volta)33### Quando usare `query()` (attività una tantum)

34 34 

35**Migliore per:**35**Migliore per:**

36 36 


53 53 

54### `query()`54### `query()`

55 55 

56Crea una nuova sessione per ogni interazione con Claude Code. Restituisce un iteratore asincrono che produce messaggi man mano che arrivano. Ogni chiamata a `query()` inizia da zero senza memoria di interazioni precedenti.56Crea una nuova sessione per ogni interazione con Claude Code per impostazione predefinita. Restituisce un iteratore asincrono che produce messaggi man mano che arrivano. Ogni chiamata a `query()` inizia da zero senza memoria di interazioni precedenti a meno che non passiate `continue_conversation=True` o `resume` in [`ClaudeAgentOptions`](#claudeagentoptions). Vedi [Sessions](/it/agent-sdk/sessions).

57 57 

58```python theme={null}58```python theme={null}

59async def query(59async def query(


790 plugins: list[SdkPluginConfig] = field(default_factory=list)790 plugins: list[SdkPluginConfig] = field(default_factory=list)

791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead791 max_thinking_tokens: int | None = None # Deprecated: use thinking instead

792 thinking: ThinkingConfig | None = None792 thinking: ThinkingConfig | None = None

793 effort: Literal["low", "medium", "high", "xhigh", "max"] | None = None793 effort: EffortLevel | None = None

794 enable_file_checkpointing: bool = False794 enable_file_checkpointing: bool = False

795 session_store: SessionStore | None = None795 session_store: SessionStore | None = None

796 session_store_flush: SessionStoreFlushMode = "batched"796 session_store_flush: SessionStoreFlushMode = "batched"


837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponibili per la sessione. Passa `"all"` per abilitare ogni skill scoperta, o un elenco di nomi di skill. Quando impostato, l'SDK abilita lo strumento Skill automaticamente senza elencarlo in `allowed_tools`. Vedi [Skills](/it/agent-sdk/skills) |837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | Skills disponibili per la sessione. Passa `"all"` per abilitare ogni skill scoperta, o un elenco di nomi di skill. Quando impostato, l'SDK abilita lo strumento Skill automaticamente senza elencarlo in `allowed_tools`. Vedi [Skills](/it/agent-sdk/skills) |

838| `max_thinking_tokens` | `int \| None` | `None` | *Deprecato* - Token massimi per i blocchi di pensiero. Usa `thinking` invece |838| `max_thinking_tokens` | `int \| None` | `None` | *Deprecato* - Token massimi per i blocchi di pensiero. Usa `thinking` invece |

839| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Controlla il comportamento del pensiero esteso. Ha la precedenza su `max_thinking_tokens` |839| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | Controlla il comportamento del pensiero esteso. Ha la precedenza su `max_thinking_tokens` |

840| `effort` | `Literal["low", "medium", "high", "xhigh", "max"] \| None` | `None` | Livello di sforzo per la profondità del pensiero |840| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | Livello di sforzo per la profondità del pensiero |

841| `session_store` | [`SessionStore`](/it/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Specchia i trascritti di sessione in un backend esterno in modo che qualsiasi host possa riprenderli. Vedi [Persisti le sessioni nell'archiviazione esterna](/it/agent-sdk/session-storage) |841| `session_store` | [`SessionStore`](/it/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | Specchia i trascritti di sessione in un backend esterno in modo che qualsiasi host possa riprenderli. Vedi [Persisti le sessioni nell'archiviazione esterna](/it/agent-sdk/session-storage) |

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quando eseguire il flush delle voci di trascritto mirrorato a `session_store`. `"batched"` esegue il flush una volta per turno o quando il buffer si riempie; `"eager"` attiva un flush in background dopo ogni frame. Ignorato quando `session_store` è `None` |842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | Quando eseguire il flush delle voci di trascritto mirrorato a `session_store`. `"batched"` esegue il flush una volta per turno o quando il buffer si riempie; `"eager"` attiva un flush in background dopo ogni frame. Ignorato quando `session_store` è `None` |

843 843 


1039 initialPrompt: str | None = None1039 initialPrompt: str | None = None

1040 maxTurns: int | None = None1040 maxTurns: int | None = None

1041 background: bool | None = None1041 background: bool | None = None

1042 effort: Literal["low", "medium", "high", "xhigh", "max"] | int | None = None1042 effort: EffortLevel | int | None = None

1043 permissionMode: PermissionMode | None = None1043 permissionMode: PermissionMode | None = None

1044```1044```

1045 1045 


1056| `initialPrompt` | No | Auto-inviato come il primo turno utente quando questo agente viene eseguito come agente del thread principale |1056| `initialPrompt` | No | Auto-inviato come il primo turno utente quando questo agente viene eseguito come agente del thread principale |

1057| `maxTurns` | No | Numero massimo di turni agentici prima che l'agente si fermi |1057| `maxTurns` | No | Numero massimo di turni agentici prima che l'agente si fermi |

1058| `background` | No | Esegui questo agente come attività in background non bloccante quando invocato |1058| `background` | No | Esegui questo agente come attività in background non bloccante quando invocato |

1059| `effort` | No | Livello di sforzo di ragionamento per questo agente. Accetta un livello denominato o un numero intero |1059| `effort` | No | Livello di sforzo di ragionamento per questo agente. Accetta un livello denominato o un numero intero. Vedi [`EffortLevel`](#effortlevel) |

1060| `permissionMode` | No | Modalità di autorizzazione per l'esecuzione dello strumento all'interno di questo agente. Vedi [`PermissionMode`](#permissionmode) |1060| `permissionMode` | No | Modalità di autorizzazione per l'esecuzione dello strumento all'interno di questo agente. Vedi [`PermissionMode`](#permissionmode) |

1061 1061 

1062<Note>1062<Note>


1077]1077]

1078```1078```

1079 1079 

1080### `EffortLevel`

1081 

1082Livelli di sforzo per guidare la profondità del pensiero.

1083 

1084```python theme={null}

1085EffortLevel = Literal[

1086 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking

1088 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)

1090 "max", # Maximum effort

1091]

1092```

1093 

1080### `CanUseTool`1094### `CanUseTool`

1081 1095 

1082Alias di tipo per le funzioni di callback di autorizzazione dello strumento.1096Alias di tipo per le funzioni di callback di autorizzazione dello strumento.


1224Controlla il comportamento del pensiero esteso. Un'unione di tre configurazioni:1238Controlla il comportamento del pensiero esteso. Un'unione di tre configurazioni:

1225 1239 

1226```python theme={null}1240```python theme={null}

1241ThinkingDisplay = Literal["summarized", "omitted"]

1242 

1243 

1227class ThinkingConfigAdaptive(TypedDict):1244class ThinkingConfigAdaptive(TypedDict):

1228 type: Literal["adaptive"]1245 type: Literal["adaptive"]

1246 display: NotRequired[ThinkingDisplay]

1229 1247 

1230 1248 

1231class ThinkingConfigEnabled(TypedDict):1249class ThinkingConfigEnabled(TypedDict):

1232 type: Literal["enabled"]1250 type: Literal["enabled"]

1233 budget_tokens: int1251 budget_tokens: int

1252 display: NotRequired[ThinkingDisplay]

1234 1253 

1235 1254 

1236class ThinkingConfigDisabled(TypedDict):1255class ThinkingConfigDisabled(TypedDict):


1241```1260```

1242 1261 

1243| Variante | Campi | Descrizione |1262| Variante | Campi | Descrizione |

1244| :--------- | :---------------------- | :--------------------------------------------------- |1263| :--------- | :--------------------------------- | :--------------------------------------------------- |

1245| `adaptive` | `type` | Claude decide adattivamente quando pensare |1264| `adaptive` | `type`, `display` | Claude decide adattivamente quando pensare |

1246| `enabled` | `type`, `budget_tokens` | Abilita il pensiero con un budget di token specifico |1265| `enabled` | `type`, `budget_tokens`, `display` | Abilita il pensiero con un budget di token specifico |

1247| `disabled` | `type` | Disabilita il pensiero |1266| `disabled` | `type` | Disabilita il pensiero |

1248 1267 

1268Il campo opzionale `display` controlla se il testo di pensiero viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, l'impostazione predefinita dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto di pensiero negli output [`ThinkingBlock`](#thinkingblock).

1269 

1249Poiché queste sono classi `TypedDict`, sono dicts semplici in fase di esecuzione. Costruiscile come letterali dict o chiama la classe come costruttore; entrambi producono un `dict`. Accedi ai campi con `config["budget_tokens"]`, non `config.budget_tokens`:1270Poiché queste sono classi `TypedDict`, sono dicts semplici in fase di esecuzione. Costruiscile come letterali dict o chiama la classe come costruttore; entrambi producono un `dict`. Accedi ai campi con `config["budget_tokens"]`, non `config.budget_tokens`:

1250 1271 

1251```python theme={null}1272```python theme={null}


2177 hookEventName: Literal["PostToolUse"]2198 hookEventName: Literal["PostToolUse"]

2178 additionalContext: NotRequired[str]2199 additionalContext: NotRequired[str]

2179 updatedToolOutput: NotRequired[Any]2200 updatedToolOutput: NotRequired[Any]

2180 updatedMCPToolOutput: NotRequired[Any]2201 updatedMCPToolOutput: NotRequired[Any] # Deprecated: use updatedToolOutput, which works for all tools

2181 2202 

2182 2203 

2183class PostToolUseFailureHookSpecificOutput(TypedDict):2204class PostToolUseFailureHookSpecificOutput(TypedDict):


2646**Nome dello strumento:** `TodoWrite`2667**Nome dello strumento:** `TodoWrite`

2647 2668 

2648<Note>2669<Note>

2649 `TodoWrite` è deprecato e verrà rimosso in una versione futura. Utilizza invece `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList`. Imposta `CLAUDE_CODE_ENABLE_TASKS=1` per aderire. Vedi [Migra agli strumenti Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per come monitorare i cambiamenti del codice.2670 A partire da Claude Code v2.1.142, `TodoWrite` è disabilitato per impostazione predefinita. Utilizza invece `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList`. Vedi [Migra agli strumenti Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per aggiornare il tuo codice di monitoraggio, oppure imposta `CLAUDE_CODE_ENABLE_TASKS=0` per ripristinare `TodoWrite`.

2650</Note>2671</Note>

2651 2672 

2652**Input:**2673**Input:**

Details

100 100 

101### TypeScript: `continue: true`101### TypeScript: `continue: true`

102 102 

103L'SDK TypeScript stabile (la funzione `query()` utilizzata in tutta questa documentazione, a volte chiamata V1) non ha un oggetto client che tiene la sessione come il `ClaudeSDKClient` di Python. Invece, passa `continue: true` su ogni successiva chiamata `query()` e l'SDK raccoglie la sessione più recente nella directory corrente. Nessun tracciamento degli ID richiesto.103L'SDK TypeScript non ha un oggetto client che tiene la sessione come il `ClaudeSDKClient` di Python. Invece, passa `continue: true` su ogni successiva chiamata `query()` e l'SDK raccoglie la sessione più recente nella directory corrente. Nessun tracciamento degli ID richiesto.

104 104 

105Questo esempio effettua due separate chiamate `query()`. La prima crea una sessione nuova; la seconda imposta `continue: true`, che dice all'SDK di trovare e riprendere la sessione più recente su disco. L'agente ha il contesto completo dalla prima chiamata:105Questo esempio effettua due separate chiamate `query()`. La prima crea una sessione nuova; la seconda imposta `continue: true`, che dice all'SDK di trovare e riprendere la sessione più recente su disco. L'agente ha il contesto completo dalla prima chiamata:

106 106 


132```132```

133 133 

134<Note>134<Note>

135 L'API di sessione sperimentale [V2](/it/agent-sdk/typescript-v2-preview), che forniva `createSession()` con un pattern `send` / `stream`, è deprecata. Usa la funzione V1 `query()` e le opzioni di sessione descritte in questa pagina.135 L'API di sessione sperimentale [V2](/it/agent-sdk/typescript-v2-preview), che forniva `createSession()` con un pattern `send` / `stream`, è stata rimossa in TypeScript Agent SDK 0.3.142. Usa la funzione `query()` e le opzioni di sessione descritte in questa pagina.

136</Note>136</Note>

137 137 

138## Usa le opzioni di sessione con `query()`138## Usa le opzioni di sessione con `query()`

Details

8 8 

9Il tracciamento dei todo fornisce un modo strutturato per gestire le attività e visualizzare i progressi agli utenti. Claude Agent SDK include funzionalità todo integrate che aiutano a organizzare flussi di lavoro complessi e mantengono gli utenti informati sulla progressione delle attività.9Il tracciamento dei todo fornisce un modo strutturato per gestire le attività e visualizzare i progressi agli utenti. Claude Agent SDK include funzionalità todo integrate che aiutano a organizzare flussi di lavoro complessi e mantengono gli utenti informati sulla progressione delle attività.

10 10 

11<Note>

12 A partire da TypeScript Agent SDK 0.3.142 e Claude Code v2.1.142, le sessioni utilizzano i tool Task strutturati `TaskCreate`, `TaskUpdate`, `TaskGet` e `TaskList` al posto di `TodoWrite`. Vedere [Migrazione ai tool Task](#migrate-to-task-tools) per come monitorare i cambiamenti del codice. Gli esempi in questa pagina impostano `CLAUDE_CODE_ENABLE_TASKS=0` per continuare a mostrare `TodoWrite` per le sessioni che non hanno ancora eseguito la migrazione.

13</Note>

14 

11### Ciclo di vita dei Todo15### Ciclo di vita dei Todo

12 16 

13I todo seguono un ciclo di vita prevedibile:17I todo seguono un ciclo di vita prevedibile:


36 40 

37 for await (const message of query({41 for await (const message of query({

38 prompt: "Optimize my React app performance and track progress with todos",42 prompt: "Optimize my React app performance and track progress with todos",

39 options: { maxTurns: 15 }43 // Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

44 // Task tools instead and these tool_use blocks never appear.

45 options: { maxTurns: 15, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

40 })) {46 })) {

41 // Todo updates are reflected in the message stream47 // Todo updates are reflected in the message stream

42 if (message.type === "assistant") {48 if (message.type === "assistant") {


61 67 

62 async for message in query(68 async for message in query(

63 prompt="Optimize my React app performance and track progress with todos",69 prompt="Optimize my React app performance and track progress with todos",

64 options=ClaudeAgentOptions(max_turns=15),70 # Re-enable TodoWrite, which this example monitors. Without it, the SDK uses

71 # Task tools instead and these tool_use blocks never appear.

72 options=ClaudeAgentOptions(max_turns=15, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

65 ):73 ):

66 # Todo updates are reflected in the message stream74 # Todo updates are reflected in the message stream

67 if isinstance(message, AssistantMessage):75 if isinstance(message, AssistantMessage):


112 async trackQuery(prompt: string) {120 async trackQuery(prompt: string) {

113 for await (const message of query({121 for await (const message of query({

114 prompt,122 prompt,

115 options: { maxTurns: 20 }123 // Re-enable TodoWrite, which this tracker watches for.

124 options: { maxTurns: 20, env: { ...process.env, CLAUDE_CODE_ENABLE_TASKS: "0" } }

116 })) {125 })) {

117 if (message.type === "assistant") {126 if (message.type === "assistant") {

118 for (const block of message.message.content) {127 for (const block of message.message.content) {


167 print(f"{i + 1}. {icon} {text}")176 print(f"{i + 1}. {icon} {text}")

168 177 

169 async def track_query(self, prompt: str):178 async def track_query(self, prompt: str):

170 async for message in query(prompt=prompt, options=ClaudeAgentOptions(max_turns=20)):179 async for message in query(

180 prompt=prompt,

181 # Re-enable TodoWrite, which this tracker watches for.

182 options=ClaudeAgentOptions(max_turns=20, env={"CLAUDE_CODE_ENABLE_TASKS": "0"}),

183 ):

171 if isinstance(message, AssistantMessage):184 if isinstance(message, AssistantMessage):

172 for block in message.content:185 for block in message.content:

173 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":186 if isinstance(block, ToolUseBlock) and block.name == "TodoWrite":


181 ```194 ```

182</CodeGroup>195</CodeGroup>

183 196 

197## Migrazione ai tool Task

198 

199I tool Task dividono la singola chiamata `TodoWrite` in `TaskCreate` per ogni nuovo elemento e `TaskUpdate` per ogni cambio di stato, con `TaskList` e `TaskGet` disponibili affinché il modello possa leggere di nuovo l'elenco corrente. Il codice di monitoraggio continua a ispezionare i blocchi `tool_use` nel flusso dell'assistente, ma mantiene una mappa con chiave dell'ID attività invece di sostituire l'intero elenco ad ogni chiamata. {/* min-version: 2.1.142 */}I tool Task sono l'impostazione predefinita a partire da TypeScript Agent SDK 0.3.142 e Claude Code v2.1.142, quindi non è necessario alcun cambio `options.env`.

200 

201| Con `TodoWrite` | Con tool Task |

202| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| Una chiamata di tool riscrive l'intero array `todos` | `TaskCreate` aggiunge un elemento, `TaskUpdate` modifica un elemento per `taskId` |

204| Corrisponde a `block.name === "TodoWrite"` | Corrisponde a `block.name === "TaskCreate"` o `"TaskUpdate"` |

205| Forma dell'elemento: `{ content, status, activeForm }` | Input `TaskCreate`: `{ subject, description, activeForm?, metadata? }`. Input `TaskUpdate`: `{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`. `status` è `"pending"`, `"in_progress"` o `"completed"`; impostare `status: "deleted"` per eliminare |

206| Renderizza `block.input.todos` direttamente | Accumula elementi tra le chiamate, o leggi uno snapshot da un risultato dello strumento `TaskList` |

207 

208L'ID attività assegnato non è nell'input `TaskCreate`. Ritorna nel `tool_result` corrispondente come `{ task: { id, subject } }`, quindi acquisiscilo dal blocco del risultato per inserire la chiave nella mappa. L'esempio seguente mostra il cambio minimo al ciclo [Monitoraggio dei cambiamenti dei Todo](#monitoring-todo-changes). Per renderizzare un elenco completo, guarda un risultato dello strumento `TaskList` nel flusso o accumula i risultati `TaskCreate` e gli input `TaskUpdate` in una mappa:

209 

210<CodeGroup>

211 ```typescript TypeScript theme={null}

212 import { query } from "@anthropic-ai/claude-agent-sdk";

213 

214 for await (const message of query({

215 prompt: "Optimize my React app performance",

216 })) {

217 if (message.type !== "assistant") continue;

218 for (const block of message.message.content) {

219 if (block.type !== "tool_use") continue;

220 if (block.name === "TaskCreate") {

221 const input = block.input as { subject: string };

222 console.log(`+ ${input.subject}`);

223 } else if (block.name === "TaskUpdate") {

224 const input = block.input as { taskId: string; status?: string };

225 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);

226 }

227 }

228 }

229 ```

230 

231 ```python Python theme={null}

232 from claude_agent_sdk import query, AssistantMessage, ToolUseBlock

233 

234 async for message in query(

235 prompt="Optimize my React app performance",

236 ):

237 if not isinstance(message, AssistantMessage):

238 continue

239 for block in message.content:

240 if not isinstance(block, ToolUseBlock):

241 continue

242 if block.name == "TaskCreate":

243 print(f"+ {block.input['subject']}")

244 elif block.name == "TaskUpdate" and block.input.get("status"):

245 print(f" {block.input['taskId']} -> {block.input['status']}")

246 ```

247</CodeGroup>

248 

184## Documentazione correlata249## Documentazione correlata

185 250 

186* [Riferimento TypeScript SDK](/it/agent-sdk/typescript)251* [Riferimento TypeScript SDK](/it/agent-sdk/typescript)

Details

414| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibili per la sessione. Passa `'all'` per abilitare ogni skill scoperta, o un elenco di nomi di skill. Quando impostato, l'SDK abilita automaticamente lo strumento Skill senza elencarlo in `allowedTools`. Vedi [Skills](/it/agent-sdk/skills) |414| `skills` | `string[] \| 'all'` | `undefined` | Skills disponibili per la sessione. Passa `'all'` per abilitare ogni skill scoperta, o un elenco di nomi di skill. Quando impostato, l'SDK abilita automaticamente lo strumento Skill senza elencarlo in `allowedTools`. Vedi [Skills](/it/agent-sdk/skills) |

415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Funzione personalizzata per generare il processo Claude Code. Usa per eseguire Claude Code in VM, container o ambienti remoti |415| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Funzione personalizzata per generare il processo Claude Code. Usa per eseguire Claude Code in VM, container o ambienti remoti |

416| `stderr` | `(data: string) => void` | `undefined` | Callback per l'output stderr |416| `stderr` | `(data: string) => void` | `undefined` | Callback per l'output stderr |

417| `strictMcpConfig` | `boolean` | `false` | Applica la convalida MCP rigorosa |417| `strictMcpConfig` | `boolean` | `false` | Usa solo i server passati in `mcpServers` e ignora il progetto `.mcp.json`, le impostazioni utente e i server MCP forniti dai plugin |

418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (prompt minimo) | Configurazione del prompt di sistema. Passa una stringa per un prompt personalizzato, o `{ type: 'preset', preset: 'claude_code' }` per usare il prompt di sistema di Claude Code. Quando si usa la forma dell'oggetto preset, aggiungi `append` per estenderlo con istruzioni aggiuntive, e imposta `excludeDynamicSections: true` per spostare il contesto per sessione nel primo messaggio utente per un [migliore riutilizzo della cache dei prompt tra le macchine](/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |418| `systemPrompt` | `string \| { type: 'preset'; preset: 'claude_code'; append?: string; excludeDynamicSections?: boolean }` | `undefined` (prompt minimo) | Configurazione del prompt di sistema. Passa una stringa per un prompt personalizzato, o `{ type: 'preset', preset: 'claude_code' }` per usare il prompt di sistema di Claude Code. Quando si usa la forma dell'oggetto preset, aggiungi `append` per estenderlo con istruzioni aggiuntive, e imposta `excludeDynamicSections: true` per spostare il contesto per sessione nel primo messaggio utente per un [migliore riutilizzo della cache dei prompt tra le macchine](/it/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) |

419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` per i modelli supportati | Controlla il comportamento di pensiero/ragionamento di Claude. Vedi [`ThinkingConfig`](#thinkingconfig) per le opzioni |419| `thinking` | [`ThinkingConfig`](#thinkingconfig) | `{ type: 'adaptive' }` per i modelli supportati | Controlla il comportamento di pensiero/ragionamento di Claude. Vedi [`ThinkingConfig`](#thinkingconfig) per le opzioni |

420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Configurazione per il comportamento dei tool incorporati. Vedi [`ToolConfig`](#toolconfig) per i dettagli |420| `toolConfig` | [`ToolConfig`](#toolconfig) | `undefined` | Configurazione per il comportamento dei tool incorporati. Vedi [`ToolConfig`](#toolconfig) per i dettagli |


1847Crea e gestisce un elenco di attività strutturato per il tracciamento del progresso.1847Crea e gestisce un elenco di attività strutturato per il tracciamento del progresso.

1848 1848 

1849<Note>1849<Note>

1850 `TodoWrite` è deprecato e verrà rimosso in una versione futura. Usa `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` invece. Imposta `CLAUDE_CODE_ENABLE_TASKS=1` per aderire. Vedi [Migra ai tool Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per come monitorare i cambiamenti del codice.1850 A partire da TypeScript Agent SDK 0.3.142, `TodoWrite` è disabilitato per impostazione predefinita. Usa `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList` invece. Vedi [Migra ai tool Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per aggiornare il tuo codice di monitoraggio, oppure imposta `CLAUDE_CODE_ENABLE_TASKS=0` per ripristinare `TodoWrite`.

1851</Note>1851</Note>

1852 1852 

1853### TaskCreate1853### TaskCreate


2344Restituisce gli elenchi di attività precedenti e aggiornati.2344Restituisce gli elenchi di attività precedenti e aggiornati.

2345 2345 

2346<Note>2346<Note>

2347 `TodoWrite` è deprecato e verrà rimosso in una versione futura. Usa invece `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList`. Imposta `CLAUDE_CODE_ENABLE_TASKS=1` per aderire. Vedi [Migrazione ai tool Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per come monitorare i cambiamenti del codice.2347 A partire da TypeScript Agent SDK 0.3.142, `TodoWrite` è disabilitato per impostazione predefinita. Usa invece `TaskCreate`, `TaskGet`, `TaskUpdate` e `TaskList`. Vedi [Migrazione ai tool Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) per aggiornare il tuo codice di monitoraggio, oppure imposta `CLAUDE_CODE_ENABLE_TASKS=0` per ripristinare `TodoWrite`.

2348</Note>2348</Note>

2349 2349 

2350### TaskCreate2350### TaskCreate


2739Controlla il comportamento di pensiero/ragionamento di Claude. Ha precedenza sul deprecato `maxThinkingTokens`.2739Controlla il comportamento di pensiero/ragionamento di Claude. Ha precedenza sul deprecato `maxThinkingTokens`.

2740 2740 

2741```typescript theme={null}2741```typescript theme={null}

2742type ThinkingDisplay = "summarized" | "omitted";

2743 

2742type ThinkingConfig =2744type ThinkingConfig =

2743 | { type: "adaptive" } // Il modello determina quando e quanto ragionare (Opus 4.6+)2745 | { type: "adaptive"; display?: ThinkingDisplay } // Il modello determina quando e quanto ragionare (Opus 4.6+)

2744 | { type: "enabled"; budgetTokens?: number } // Budget di token di pensiero fisso2746 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Budget di token di pensiero fisso

2745 | { type: "disabled" }; // Nessun pensiero esteso2747 | { type: "disabled" }; // Nessun pensiero esteso

2746```2748```

2747 2749 

2750Il campo opzionale `display` controlla se il testo di pensiero viene restituito `"summarized"` o `"omitted"`. Su Claude Opus 4.7 e versioni successive, l'impostazione predefinita dell'API è `"omitted"`, quindi imposta `"summarized"` per ricevere il contenuto di pensiero nei blocchi `thinking`.

2751 

2748### `SpawnedProcess`2752### `SpawnedProcess`

2749 2753 

2750Interfaccia per la generazione di processi personalizzati (usata con l'opzione `spawnClaudeCodeProcess`). `ChildProcess` soddisfa già questa interfaccia.2754Interfaccia per la generazione di processi personalizzati (usata con l'opzione `spawnClaudeCodeProcess`). `ChildProcess` soddisfa già questa interfaccia.


3158```3162```

3159 3163 

3160| Proprietà | Tipo | Predefinito | Descrizione |3164| Proprietà | Tipo | Predefinito | Descrizione |

3161| :------------------------ | :--------- | :---------- | :----------------------------------------------------------------------------------------------------- |3165| :------------------------ | :--------- | :---------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3162| `allowedDomains` | `string[]` | `[]` | Nomi di dominio a cui i processi in sandbox possono accedere |3166| `allowedDomains` | `string[]` | `[]` | Nomi di dominio a cui i processi in sandbox possono accedere |

3163| `deniedDomains` | `string[]` | `[]` | Nomi di dominio a cui i processi in sandbox non possono accedere. Ha la precedenza su `allowedDomains` |3167| `deniedDomains` | `string[]` | `[]` | Nomi di dominio a cui i processi in sandbox non possono accedere. Ha la precedenza su `allowedDomains` |

3164| `allowManagedDomainsOnly` | `boolean` | `false` | Limita l'accesso di rete solo ai domini in `allowedDomains` |3168| `allowManagedDomainsOnly` | `boolean` | `false` | Solo impostazioni gestite. Quando impostato nelle [impostazioni gestite](/it/permissions#managed-settings), solo le voci `allowedDomains` dalle impostazioni gestite vengono rispettate e le voci dalle impostazioni utente, progetto o locali vengono ignorate. Non ha effetto quando impostato tramite le opzioni SDK |

3165| `allowLocalBinding` | `boolean` | `false` | Consenti ai processi di associarsi alle porte locali (ad esempio, per i server di sviluppo) |3169| `allowLocalBinding` | `boolean` | `false` | Consenti ai processi di associarsi alle porte locali (ad esempio, per i server di sviluppo) |

3166| `allowUnixSockets` | `string[]` | `[]` | Percorsi dei socket Unix a cui i processi possono accedere (ad esempio, socket Docker) |3170| `allowUnixSockets` | `string[]` | `[]` | Percorsi dei socket Unix a cui i processi possono accedere (ad esempio, socket Docker) |

3167| `allowAllUnixSockets` | `boolean` | `false` | Consenti l'accesso a tutti i socket Unix |3171| `allowAllUnixSockets` | `boolean` | `false` | Consenti l'accesso a tutti i socket Unix |

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# API sessione TypeScript SDK V2 (deprecato)5# API sessione TypeScript SDK V2 (rimosso)

6 6 

7> Riferimento per l'API sessione deprecato V2 TypeScript Agent SDK, con pattern send/stream basati su sessione per conversazioni multi-turno.7> Riferimento per l'API sessione rimosso V2 TypeScript Agent SDK, con pattern send/stream basati su sessione per conversazioni multi-turno.

8 8 

9<Warning>9<Warning>

10 Le funzioni API V2 session `unstable_v2_createSession`, `unstable_v2_resumeSession` e `unstable_v2_prompt` sono deprecate e verranno rimosse in una versione futura. Utilizzare invece l'[API V1 `query()`](/it/agent-sdk/typescript).10 L'API sessione V2 non è più supportata. TypeScript Agent SDK 0.3.142 rimuove `unstable_v2_createSession`, `unstable_v2_resumeSession`, `unstable_v2_prompt` e i tipi `SDKSession` e `SDKSessionOptions`.

11 

12 Per eseguire la migrazione, utilizzare l'[API `query()`](/it/agent-sdk/typescript) e le [opzioni sessione](/it/agent-sdk/sessions) che accetta. Passare un `AsyncIterable<SDKUserMessage>` per conversazioni multi-turno, oppure `options.resume` per continuare una sessione salvata. Questa pagina viene mantenuta come riferimento se si mantiene il codice su Agent SDK 0.2.x o versioni precedenti.

11</Warning>13</Warning>

12 14 

13V2 era un'API sessione sperimentale che eliminava la necessità di generatori asincroni e coordinamento yield. Invece di gestire lo stato del generatore tra i turni, ogni turno era un ciclo `send()`/`stream()` separato. La superficie API si riduceva a tre concetti:15V2 era un'API sessione sperimentale che eliminava la necessità di generatori asincroni e coordinamento yield. Invece di gestire lo stato del generatore tra i turni, ogni turno era un ciclo `send()`/`stream()` separato. La superficie API si riduceva a tre concetti:


18 20 

19## Installazione21## Installazione

20 22 

21L'interfaccia V2 è inclusa nel pacchetto SDK esistente:23Agent SDK 0.2.x è l'ultima versione che include l'interfaccia V2. La versione del pacchetto è passata da 0.2.x direttamente a 0.3.142, quindi la versione di rimozione sopra e il pin di installazione sottostante descrivono lo stesso limite. Per installare l'ultima versione compatibile con V2, fissare la versione principale e secondaria:

22 24 

23```bash theme={null}25```bash theme={null}

24npm install @anthropic-ai/claude-agent-sdk26npm install @anthropic-ai/claude-agent-sdk@0.2

25```27```

26 28 

27<Note>29<Note>

agent-view.md +82 −31

Details

72 72 

73Esegui `claude agents` per aprire agent view. Prende il controllo del terminale completo ed elenca ogni sessione raggruppata per stato, con sessioni fissate e quelle che hanno bisogno di te in cima. Ogni riga mostra il nome della sessione, l'attività corrente e quanto tempo fa è cambiata l'ultima volta.73Esegui `claude agents` per aprire agent view. Prende il controllo del terminale completo ed elenca ogni sessione raggruppata per stato, con sessioni fissate e quelle che hanno bisogno di te in cima. Ogni riga mostra il nome della sessione, l'attività corrente e quanto tempo fa è cambiata l'ultima volta.

74 74 

75L'elenco mostra ogni sessione in background che hai avviato, in tutti i tuoi progetti. Una sessione che lavora in un repository e un'altra in un worktree diverso appaiono entrambe qui, indipendentemente da quale directory hai aperto agent view. Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le [metti in background](#from-inside-a-session). I [subagents](/it/sub-agents) e i [teammates](/it/agent-teams) che una sessione genera non sono elencati come righe separate.75Per impostazione predefinita, l'elenco mostra ogni sessione in background che hai avviato, in tutti i tuoi progetti. Una sessione che lavora in un repository e un'altra in un worktree diverso appaiono entrambe qui, indipendentemente da quale directory hai aperto agent view. Per limitare l'elenco a un progetto, passa `--cwd` (richiede Claude Code v2.1.141 o successivo):

76 76 

77Per limitare la visualizzazione a un progetto, avvia con `claude agents --cwd <path>`. Solo le sessioni avviate in quella directory appaiono, incluse quelle in esecuzione in un [worktree](/it/worktrees) inviato da essa.77```bash theme={null}

78claude agents --cwd ~/projects/my-app

79```

80 

81Questo mostra solo le sessioni avviate in quella directory. Una sessione che si è [spostata in un worktree](#how-file-edits-are-isolated) sotto `~/projects/my-app/.claude/worktrees/` conta ancora come appartenente a `~/projects/my-app`.

82 

83Le sessioni interattive che hai aperto in altri terminali non appaiono finché non le [metti in background](#from-inside-a-session). I [subagents](/it/sub-agents) e i [teammates](/it/agent-teams) che una sessione genera non sono elencati come righe separate.

78 84 

79```text theme={null}85```text theme={null}

80Pinned86Pinned


117| `∙` | Il processo è uscito. Puoi ancora fare peek, rispondere o collegarti, e Claude riavvia da dove l'ha lasciato |123| `∙` | Il processo è uscito. Puoi ancora fare peek, rispondere o collegarti, e Claude riavvia da dove l'ha lasciato |

118| `✢` | Una sessione [`/loop`](/it/scheduled-tasks) che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia |124| `✢` | Una sessione [`/loop`](/it/scheduled-tasks) che dorme tra le iterazioni. La riga mostra il conteggio delle esecuzioni e un conto alla rovescia |

119 125 

126Il `●` che può apparire al bordo destro di una riga è l'indicatore di [stato della pull request](#pull-request-status), non parte dell'icona di stato. Un numero prima di esso è il conteggio delle pull request che la sessione ha aperto.

127 

120Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un [processo supervisor](#the-supervisor-process) separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.128Le sessioni in background non hanno bisogno di alcun terminale aperto per continuare a lavorare. Un [processo supervisor](#the-supervisor-process) separato le esegue, quindi puoi chiudere agent view, chiudere la tua shell, o avviare una nuova sessione interattiva e il tuo lavoro inviato continua.

121 129 

122Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Se la tua macchina dorme o si spegne, le sessioni in esecuzione si fermano; riavviale con `claude respawn --all`.130Lo stato della sessione persiste su disco attraverso gli auto-update e i riavvii del supervisor. Le sessioni sono anche preservate quando la tua macchina dorme. I loro processi riprendono al risveglio e il supervisor si ricollega a loro invece di trattare il gap di tempo come inattività. Lo spegnimento ferma comunque le sessioni in esecuzione; vedi [Sessions show as failed after shutdown](#sessions-show-as-failed-after-shutdown) per come recuperarle.

123 131 

124### Riassunti delle righe132### Riassunti delle righe

125 133 


158 166 

159Scollegar non ferma mai una sessione in background: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z`, e `/exit` la lasciano tutte in esecuzione. Per terminare una sessione da dentro di essa, esegui `/stop`.167Scollegar non ferma mai una sessione in background: `←`, `Ctrl+C`, `Ctrl+D`, `Ctrl+Z`, e `/exit` la lasciano tutte in esecuzione. Per terminare una sessione da dentro di essa, esegui `/stop`.

160 168 

161Dopo che hai inviato o messo in background una sessione, premere `←` su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato da agent view. Mette in background la sessione corrente e apre agent view con quella sessione pre-selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. Puoi disattivare questa scorciatoia in `/config`.169Dopo che hai inviato o messo in background una sessione, premere `←` su un prompt vuoto funziona da qualsiasi sessione di Claude Code, non solo quelle a cui ti sei collegato da agent view. Mette in background la sessione corrente e apre agent view con quella riga selezionata, quindi puoi cambiare sessioni senza lasciare il terminale. La riga viene creata anche da una sessione nuova senza cronologia di conversazione, quindi `→` vi ritorna. Quando quella riga è l'unica, agent view mostra un suggerimento di onboarding sotto di essa. Puoi disattivare questa scorciatoia in `/config` (l'impostazione `leftArrowOpensAgents`).

162 170 

163### Organizzare l'elenco171### Organizzare l'elenco

164 172 


173 181 

174Per rimuovere una sessione dall'elenco, premi `Ctrl+X` per fermarla e `Ctrl+X` di nuovo entro due secondi per eliminarla. Premere `Ctrl+X` su un'intestazione di gruppo elimina ogni sessione in quel gruppo dopo conferma.182Per rimuovere una sessione dall'elenco, premi `Ctrl+X` per fermarla e `Ctrl+X` di nuovo entro due secondi per eliminarla. Premere `Ctrl+X` su un'intestazione di gruppo elimina ogni sessione in quel gruppo dopo conferma.

175 183 

176L'eliminazione rimuove la sessione da agent view e pulisce il suo [worktree](#how-file-edits-are-isolated), inclusi eventuali cambiamenti non committati in esso, quindi esegui il push o il commit del lavoro che vuoi mantenere prima di eliminare. Il transcript della conversazione rimane su disco e rimane disponibile attraverso `claude --resume`.184L'eliminazione rimuove la sessione da agent view e rimuove il suo transcript di conversazione. Se Claude ha [creato un worktree](#how-file-edits-are-isolated) per la sessione, l'eliminazione rimuove anche quel worktree, inclusi eventuali cambiamenti non committati in esso, quindi esegui il push o il commit del lavoro che vuoi mantenere prima. Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posto.

177 185 

178Le sessioni completate più vecchie si ripiegano in una riga `… N more` per mantenere l'elenco breve. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili.186Le sessioni completate più vecchie si ripiegano in una riga `… N more` per mantenere l'elenco breve. I fallimenti e le sessioni con una pull request aperta rimangono sempre visibili.

179 187 


198| `Space` | Apri o chiudi il pannello peek per la sessione selezionata |206| `Space` | Apri o chiudi il pannello peek per la sessione selezionata |

199| `Shift+Enter` | Invia e collegati immediatamente |207| `Shift+Enter` | Invia e collegati immediatamente |

200| `→` | Collegati alla sessione selezionata |208| `→` | Collegati alla sessione selezionata |

201| `Alt+1`..`Alt+9` | Collegati alla sessione 1–9 nel gruppo corrente |209| `Alt+1`..`Alt+9` | Collegati alla sessione 1–9 nella directory della sessione focalizzata |

202| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |210| `Tab` | Su un input vuoto, sfoglia tutti i subagents. Altrimenti applica il suggerimento evidenziato |

203| `Ctrl+S` | Cambia raggruppamento tra stato e directory |211| `Ctrl+S` | Cambia raggruppamento tra stato e directory |

204| `Ctrl+T` | Fissa o scollega la sessione selezionata |212| `Ctrl+T` | Fissa o scollega la sessione selezionata |

205| `Ctrl+R` | Rinomina la sessione selezionata |213| `Ctrl+R` | Rinomina la sessione selezionata |

206| `Ctrl+G` | Apri il prompt di dispatch nel tuo `$EDITOR` |214| `Ctrl+G` | Apri il prompt di dispatch nel tuo `$VISUAL` o `$EDITOR` |

207| `Ctrl+X` | Ferma la sessione; premi di nuovo entro due secondi per eliminarla |215| `Ctrl+X` | Ferma la sessione; premi di nuovo entro due secondi per eliminarla |

208| `Shift+↑` / `Shift+↓` | Riordina la sessione selezionata |216| `Shift+↑` / `Shift+↓` | Riordina la sessione selezionata |

209| `Esc` | Chiudi il pannello peek, cancella l'input, o esci |217| `Esc` | Chiudi il pannello peek, cancella l'input, o esci |


251 259 

252Lo spostamento in background da una sessione interattiva avvia un nuovo processo che riprende dalla conversazione salvata, quindi l'esecuzione di subagent, [monitor](/it/tools-reference#monitor-tool), e comandi in background non si trasferiscono ad esso. Claude ti chiede di confermare prima di spostare in background quando uno qualsiasi di essi è in esecuzione. Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.260Lo spostamento in background da una sessione interattiva avvia un nuovo processo che riprende dalla conversazione salvata, quindi l'esecuzione di subagent, [monitor](/it/tools-reference#monitor-tool), e comandi in background non si trasferiscono ad esso. Claude ti chiede di confermare prima di spostare in background quando uno qualsiasi di essi è in esecuzione. Una volta in background, la sessione può avviare nuovi subagent, monitor, e comandi in background, e questi continuano a essere eseguiti durante successivi distacchi e ricollegamenti.

253 261 

262I flag di configurazione dal lancio originale si trasferiscono alla sessione messa in background, quindi i suoi server MCP, le impostazioni e il modello di fallback rimangono in vigore:

263 

264* `--mcp-config` e `--strict-mcp-config`

265* `--settings`

266* `--add-dir`

267* `--plugin-dir`

268* `--fallback-model`

269* `--allow-dangerously-skip-permissions`

270 

271Il trasferimento di `--allow-dangerously-skip-permissions` mantiene `bypassPermissions` raggiungibile nella sessione messa in background, ma non concede nulla di nuovo. La modalità richiede comunque la stessa accettazione interattiva una tantum descritta in [Permission mode, model, and effort](#permission-mode-model-and-effort) prima che qualsiasi sessione possa utilizzarla.

272 

254### From your shell273### From your shell

255 274 

256Passa `--bg` per avviare una sessione che va direttamente in background:275Passa `--bg` per avviare una sessione che va direttamente in background:


283 302 

284### How file edits are isolated303### How file edits are isolated

285 304 

286Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo. Claude salta questo quando la sessione è già sotto `.claude/worktrees/`, quando la directory di lavoro non è un repository git, o per le scritture al di fuori della directory di lavoro.305Ogni sessione in background, che sia avviata da agent view, `/bg`, o `claude --bg`, inizia nella tua directory di lavoro. Prima di modificare i file, Claude sposta la sessione in un [git worktree](/it/worktrees) isolato sotto `.claude/worktrees/`, quindi le sessioni parallele possono leggere lo stesso checkout ma ognuna scrive nel suo.

306 

307Claude salta il worktree quando:

308 

309* La sessione è già all'interno di un git worktree collegato, che Claude l'abbia creato sotto `.claude/worktrees/` o tu l'abbia creato con `git worktree add` da qualche altra parte

310* La directory di lavoro non è un repository git

311* La scrittura è al di fuori della directory di lavoro

312 

313Per disattivare l'isolamento del worktree per un repository dove i git worktree sono impraticabili, imposta [`worktree.bgIsolation`](/it/settings#worktree-settings) su `"none"`. Le sessioni in background modificheranno quindi la tua copia di lavoro direttamente senza spostarsi prima in un worktree. Aggiungi l'impostazione al file `.claude/settings.json` del progetto:

314 

315```json theme={null}

316{

317 "worktree": {

318 "bgIsolation": "none"

319 }

320}

321```

322 

323<Note>

324 L'impostazione `worktree.bgIsolation` richiede Claude Code v2.1.143 o successivo.

325</Note>

287 326 

288Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file.327Al di fuori di un repository git, le sessioni scrivono direttamente nella directory di lavoro e non sono isolate l'una dall'altra, quindi evita di inviare sessioni parallele che modificano gli stessi file.

289 328 

290Il worktree viene rimosso quando elimini la sessione, quindi unisci o spingi i cambiamenti che vuoi mantenere prima di eliminare. Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.329L'eliminazione di una sessione in agent view (`Ctrl+X` due volte) rimuove un worktree che Claude ha creato per essa, inclusi eventuali cambiamenti non committati, quindi unisci o spingi i cambiamenti che vuoi mantenere prima. L'eliminazione dalla shell con [`claude rm`](#manage-sessions-from-the-shell) mantiene un worktree che ha cambiamenti non committati e stampa il suo percorso in modo che tu possa pulirlo da solo. Un worktree che hai creato tu stesso e in cui hai avviato la sessione viene lasciato in posizione in entrambi i casi.

330 

331Per trovare il percorso del worktree di una sessione, visualizza l'anteprima della sessione o collegati e controlla la sua directory di lavoro.

291 332 

292Per fare in modo che un subagent venga sempre eseguito nel suo proprio worktree indipendentemente da come è stato avviato, imposta [`isolation: worktree`](/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter.333Per fare in modo che un subagent venga sempre eseguito nel suo proprio worktree indipendentemente da come è stato avviato, imposta [`isolation: worktree`](/it/sub-agents#supported-frontmatter-fields) nel suo frontmatter.

293 334 


307 348 

308Il [permission mode](/it/permissions) dipende da come hai avviato la sessione. Lo spostamento in background di una sessione esistente con `/bg` o `←` mantiene il permission mode corrente, quindi una sessione che hai cambiato in `acceptEdits` o `auto` rimane in quella modalità dopo il distacco. L'invio da agent view input o l'esecuzione di `claude --bg` dalla tua shell utilizza il `defaultMode` dai settings di quella directory, o il `permissionMode` dal frontmatter del [subagent inviato](/it/sub-agents#supported-frontmatter-fields).349Il [permission mode](/it/permissions) dipende da come hai avviato la sessione. Lo spostamento in background di una sessione esistente con `/bg` o `←` mantiene il permission mode corrente, quindi una sessione che hai cambiato in `acceptEdits` o `auto` rimane in quella modalità dopo il distacco. L'invio da agent view input o l'esecuzione di `claude --bg` dalla tua shell utilizza il `defaultMode` dai settings di quella directory, o il `permissionMode` dal frontmatter del [subagent inviato](/it/sub-agents#supported-frontmatter-fields).

309 350 

351Il permission mode con cui avvii una sessione in background persiste quando il supervisore successivamente [arresta e riavvia](#the-supervisor-process) il processo della sessione. Una sessione che hai lanciato con `claude --bg --dangerously-skip-permissions` o `claude --bg --permission-mode bypassPermissions` rimane in `bypassPermissions` dopo quel riavvio invece di tornare al `defaultMode` della directory.

352 

310Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di `--permission-mode`, `--model`, o `--effort` quando lo apri:353Per impostare i default per ogni sessione che invii da agent view, passa uno qualsiasi di `--permission-mode`, `--model`, o `--effort` quando lo apri:

311 354 

312```bash theme={null}355```bash theme={null}

313claude agents --permission-mode plan --model opus --effort high356claude agents --permission-mode plan --model opus --effort high

314```357```

315 358 

359`claude agents` accetta anche `--dangerously-skip-permissions` come abbreviazione per `--permission-mode bypassPermissions`, e `--allow-dangerously-skip-permissions` per rendere `bypassPermissions` disponibile nel ciclo `Shift+Tab` di ogni sessione inviata senza avviare in quella modalità. Entrambi corrispondono ai [flag CLI di livello superiore](/it/cli-reference).

360 

316<Note>361<Note>

317 Passare `--permission-mode`, `--model`, o `--effort` a `claude agents` richiede Claude Code v2.1.142 o successivo. Le versioni precedenti rifiutano questi flag con un errore di opzione sconosciuta.362 Passare `--permission-mode`, `--model`, `--effort`, o `--dangerously-skip-permissions` a `claude agents` richiede Claude Code v2.1.142 o successivo. {/* min-version: 2.1.143 */}`--allow-dangerously-skip-permissions` su `claude agents` richiede v2.1.143 o successivo. Le versioni precedenti rifiutano questi flag con un errore di opzione sconosciuta.

318</Note>363</Note>

319 364 

320I default attivi appaiono nel footer sotto l'input di dispatch.365I default attivi appaiono nel footer sotto l'input di dispatch.


325 370 

326### Settings, plugins, and MCP servers371### Settings, plugins, and MCP servers

327 372 

328Agent view accetta gli stessi flag di configurazione di `claude` per caricare settings, plugins, MCP servers, e directory aggiuntive. Ogni flag si applica a agent view stesso e viene passato a ogni sessione che invii da esso, quindi un plugin o MCP server che carichi in questo modo è disponibile anche in quelle sessioni.373Agent view accetta gli stessi flag di configurazione di `claude` per caricare settings, plugins, server MCP, e directory aggiuntive. Questi flag richiedono Claude Code v2.1.142 o successivo. Ogni flag si applica a agent view stesso e viene passato a ogni sessione che invii da esso, quindi un plugin o server MCP che carichi in questo modo è disponibile anche in quelle sessioni.

329 374 

330| Flag | Effect |375| Flag | Effect |

331| :----------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------- |376| :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------- |

332| [`--settings <file-or-json>`](/it/settings) | Sovrascrivi settings per agent view e sessioni inviate |377| [`--settings <file-or-json>`](/it/settings) | Sovrascrivi settings per agent view e sessioni inviate |

333| [`--add-dir <path>`](/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |378| [`--add-dir <path>`](/it/permissions#additional-directories-grant-file-access-not-configuration) | Concedi accesso ai file a una directory aggiuntiva |

334| [`--plugin-dir <path>`](/it/plugins) | Carica un plugin da una directory locale |379| [`--plugin-dir <path>`](/it/plugins) | Carica un plugin da una directory locale |

335| [`--mcp-config <file-or-json>`](/it/mcp) | Carica MCP servers da un file di configurazione o stringa JSON |380| [`--mcp-config <file-or-json>`](/it/mcp) | Carica server MCP da un file di configurazione o stringa JSON |

336| `--strict-mcp-config` | Usa solo i MCP servers da `--mcp-config`, ignorando altre configurazioni MCP |381| `--strict-mcp-config` | Usa solo i server MCP da `--mcp-config`, ignorando altre configurazioni MCP |

337 382 

338Ripeti `--add-dir`, `--plugin-dir`, o `--mcp-config` una volta per valore. La forma separata da spazi, come `--add-dir a b c`, non è supportata con `claude agents`.383Ripeti `--add-dir`, `--plugin-dir`, o `--mcp-config` una volta per valore. La forma separata da spazi, come `--add-dir a b c`, non è supportata con `claude agents`.

339 384 


348Ogni sessione in background ha un ID breve che puoi usare dalla shell. L'ID viene stampato quando avvii una sessione con `claude --bg`, e l'ID di ogni sessione è il nome della sua directory sotto `~/.claude/jobs/`. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.393Ogni sessione in background ha un ID breve che puoi usare dalla shell. L'ID viene stampato quando avvii una sessione con `claude --bg`, e l'ID di ogni sessione è il nome della sua directory sotto `~/.claude/jobs/`. Questi comandi sono utili per lo scripting o quando non vuoi aprire agent view.

349 394 

350| Command | Purpose |395| Command | Purpose |

351| :--------------------- | :--------------------------------------------------------------------------------------------------------- |396| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

352| `claude agents` | Apri agent view. Passa `--cwd <path>` per elencare solo le sessioni avviate in quella directory |397| `claude agents` | Apri agent view |

398| `claude agents --cwd <path>` | Apri agent view limitato alle sessioni avviate sotto `<path>` |

353| `claude attach <id>` | Collegati a una sessione in questo terminale |399| `claude attach <id>` | Collegati a una sessione in questo terminale |

354| `claude logs <id>` | Stampa l'output recente della sessione |400| `claude logs <id>` | Stampa l'output recente della sessione |

355| `claude stop <id>` | Ferma una sessione. Accetta anche `claude kill` |401| `claude stop <id>` | Ferma una sessione. Accetta anche `claude kill` |

356| `claude respawn <id>` | Riavvia una sessione fermata con la sua conversazione intatta |402| `claude respawn <id>` | Riavvia una sessione, in esecuzione o fermata, con la sua conversazione intatta, ad esempio per utilizzare un binario Claude Code aggiornato |

357| `claude respawn --all` | Riavvia ogni sessione fermata |403| `claude respawn --all` | Riavvia ogni sessione in esecuzione, ad esempio per spostare tutte le sessioni su un binario Claude Code aggiornato contemporaneamente |

358| `claude rm <id>` | Rimuovi una sessione dall'elenco. Pulisce il suo worktree se non ci sono modifiche non sottoposte a commit |404| `claude rm <id>` | Rimuovi una sessione e la sua trascrizione. Rimuove un worktree creato da Claude per la sessione se non ha modifiche non sottoposte a commit; altrimenti stampa il percorso del worktree in modo che tu possa pulirlo. Lascia in posizione un worktree che hai creato tu stesso |

405| `claude daemon status` | Stampa lo stato del [supervisore](#the-supervisor-process), la versione, la directory socket e il numero di worker |

359 406 

360## Come sono ospitate le sessioni in background407## Come sono ospitate le sessioni in background

361 408 


383| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |430| `~/.claude/daemon/roster.json` | Elenco delle sessioni in background in esecuzione, usato per ricollegarsi dopo un riavvio |

384| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |431| `~/.claude/jobs/<id>/state.json` | Stato per sessione mostrato in agent view |

385 432 

433Per ispezionare questo stato senza leggere direttamente i file, esegui `claude daemon status`. Riporta se il supervisor è raggiungibile, il suo ID processo e versione, la directory socket, e quante sessioni in background sono attive. `/doctor` include un riepilogo dello stesso controllo. Su Windows, `claude daemon status` espone l'errore di file sottostante quando il file della chiave pipe del daemon è bloccato o illeggibile invece di segnalare un errore di connessione generico.

434 

386### Disattiva agent view435### Disattiva agent view

387 436 

388Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/it/permissions#managed-settings).437Per disattivare completamente gli agenti in background e agent view, imposta l'[impostazione](/it/settings) `disableAgentView` su `true` o imposta la variabile di ambiente `CLAUDE_CODE_DISABLE_AGENT_VIEW`. Gli amministratori possono applicare questo attraverso [impostazioni gestite](/it/permissions#managed-settings).


395 444 

396Se la visualizzazione agente ancora non si apre dopo l'aggiornamento, verifica se è stata [disattivata](#turn-off-agent-view) da un'impostazione o da una variabile di ambiente.445Se la visualizzazione agente ancora non si apre dopo l'aggiornamento, verifica se è stata [disattivata](#turn-off-agent-view) da un'impostazione o da una variabile di ambiente.

397 446 

398### Agent view opens with no sessions447### Agent view si apre senza sessioni

399 448 

400Agent view è vuoto finché non invii la tua prima sessione. Digita un prompt nell'input in basso e premi `Enter`.449Prima di inviare la tua prima sessione, agent view mostra un breve suggerimento di onboarding con prompt di esempio al posto dell'elenco delle sessioni. Digita un prompt nell'input in basso e premi `Enter` per inviare la tua prima sessione.

401 450 

402### Cannot open agents because background tasks are running451### Impossibile aprire agenti perché sono in esecuzione attività in background

403 452 

404Se premere `←` per mettere in background la sessione corrente mostra `Cannot open agents — N background task(s) running`, la sessione ha lavoro in corso come un subagente, un workflow o un comando shell in background, e la scorciatoia non lo abbandonerà silenziosamente. Esegui `/tasks` per vedere cosa è in esecuzione, quindi `/bg` per confermare l'abbandono. Vedi [From inside a session](#from-inside-a-session) per sapere cosa viene e cosa non viene trasferito quando metti in background.453Se premere `←` per mettere in background la sessione corrente mostra `Cannot open agents — N background task(s) running`, la sessione ha lavoro in corso come un subagente, un workflow o un comando shell in background, e la scorciatoia non lo abbandonerà silenziosamente. Esegui `/tasks` per vedere cosa è in esecuzione, quindi `/bg` per confermare l'abbandono. Vedi [From inside a session](#from-inside-a-session) per sapere cosa viene e cosa non viene trasferito quando metti in background.

405 454 

406### Prompt rejected as too short455### Prompt rifiutato come troppo breve

407 456 

408L'input di dispatch si aspetta una descrizione del compito, non un'apertura conversazionale. Un prompt più corto di quattro caratteri viene rifiutato con un suggerimento `Too short` in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come `investigate the flaky checkout test`.457L'input di dispatch si aspetta una descrizione del compito, non un'apertura conversazionale. Un prompt più corto di quattro caratteri viene rifiutato con un suggerimento `Too short` in modo che una pressione accidentale non avvii una sessione. Descrivi cosa vuoi che la sessione faccia, come `investigate the flaky checkout test`.

409 458 

410### Sessions show as failed after waking your machine459### Le sessioni mostrano come non riuscite dopo lo spegnimento

460 

461Lo spegnimento o il riavvio della tua macchina interrompe le sessioni in background in esecuzione, quindi mostrano come non riuscite quando apri di nuovo agent view. Collegati, fai peek, o rispondi a qualsiasi sessione e la sessione si riavvia da dove l'ha lasciata.

411 462 

412Le sessioni in background non sopravvivono al sonno o allo spegnimento, quindi le sessioni che erano in esecuzione mostrano come non riuscite dopo il risveglio. Collegati, fai peek, o rispondi a qualsiasi sessione e la sessione si riavvia da dove l'ha lasciata. Per riavviarle tutte contemporaneamente, esegui `claude respawn --all`.463Il sonno da solo non causa questo. Le sessioni vengono preservate durante il sonno e il supervisor si ricollega ad esse al risveglio.

413 464 

414### A session is slow to respond after attaching465### Una sessione è lenta a rispondere dopo il collegamento

415 466 

416Una volta che una sessione è finita e rimane scollega per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Collegarsi avvia un processo fresco da dove l'ha lasciato, il che richiede un momento. Le sessioni che stanno lavorando o aspettando te non sono mai fermate in questo modo.467Una volta che una sessione è finita e rimane scollegata per circa un'ora, il supervisor ferma il suo processo per liberare risorse. Il collegamento avvia un processo fresco da dove l'ha lasciato, il che richiede un momento. Le sessioni che stanno lavorando o aspettando te non sono mai fermate in questo modo.

417 468 

418### `.claude/worktrees/` is filling up469### `.claude/worktrees/` si sta riempiendo

419 470 

420I worktrees sono rimossi quando elimini la sessione che li ha creati. Se una sessione è terminata senza pulire, elenca le voci rimaste con `git worktree list` nella directory del progetto e rimuovi ognuna con `git worktree remove <path>`. Vedi [Clean up worktrees](/it/worktrees#clean-up-worktrees).471Eliminare una sessione in agent view rimuove il worktree che Claude ha creato per essa. `claude rm` mantiene un worktree che ha modifiche non committate e stampa il suo percorso. Elenca le voci rimaste con `git worktree list` nella directory del progetto e rimuovi ognuna con `git worktree remove <path>`. Vedi [Clean up worktrees](/it/worktrees#clean-up-worktrees).

421 472 

422## Limitazioni473## Limitazioni

423 474 

424Agent view è un'anteprima di ricerca con le seguenti limitazioni:475Agent view è un'anteprima di ricerca con le seguenti limitazioni:

425 476 

426* **I limiti di velocità si applicano**: le sessioni in background consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, quindi eseguire dieci agenti in parallelo utilizza la quota approssimativamente dieci volte più velocemente rispetto all'esecuzione di uno.477* **I limiti di velocità si applicano**: le sessioni in background consumano l'utilizzo dell'abbonamento allo stesso modo delle sessioni interattive, quindi eseguire dieci agenti in parallelo utilizza la quota approssimativamente dieci volte più velocemente rispetto all'esecuzione di uno.

427* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina e si fermano se entra in modalità sospensione o si spegne.478* **Le sessioni sono locali**: le sessioni in background vengono eseguite sulla vostra macchina. Vengono preservate durante la sospensione ma si fermano se la macchina si spegne.

428* **I worktrees vengono eliminati con la sessione**: unite o inviate i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree.479* **I worktrees creati da Claude vengono eliminati con la sessione in agent view**: unite o inviate i cambiamenti prima di eliminare una sessione che ha modificato file nel suo proprio worktree. `claude rm` mantiene un worktree che ha modifiche non sottoposte a commit; un worktree che avete creato voi stessi viene lasciato in posizione.

429 480 

430## Risorse correlate481## Risorse correlate

431 482 

Details

24| `claude auth login` | Accedi al tuo account Anthropic. Usa `--email` per pre-compilare il tuo indirizzo email, `--sso` per forzare l'autenticazione SSO e `--console` per accedere con Anthropic Console per la fatturazione dell'utilizzo dell'API invece di un abbonamento Claude | `claude auth login --console` |24| `claude auth login` | Accedi al tuo account Anthropic. Usa `--email` per pre-compilare il tuo indirizzo email, `--sso` per forzare l'autenticazione SSO e `--console` per accedere con Anthropic Console per la fatturazione dell'utilizzo dell'API invece di un abbonamento Claude | `claude auth login --console` |

25| `claude auth logout` | Esci dal tuo account Anthropic | `claude auth logout` |25| `claude auth logout` | Esci dal tuo account Anthropic | `claude auth logout` |

26| `claude auth status` | Mostra lo stato di autenticazione come JSON. Usa `--text` per output leggibile dall'uomo. Esce con codice 0 se connesso, 1 se no | `claude auth status` |26| `claude auth status` | Mostra lo stato di autenticazione come JSON. Usa `--text` per output leggibile dall'uomo. Esce con codice 0 se connesso, 1 se no | `claude auth status` |

27| `claude agents` | Apri la [visualizzazione agente](/it/agent-view) per monitorare e inviare sessioni parallele in background. Usa `--cwd <path>` per mostrare solo le sessioni avviate in quella directory | `claude agents` |27| `claude agents` | Apri la [visualizzazione agente](/it/agent-view) per monitorare e inviare sessioni parallele in background. Usa `--cwd <path>` per mostrare solo le sessioni avviate in quella directory. Passa `--permission-mode`, `--model` o `--effort` per impostare i [valori predefiniti per le sessioni inviate](/it/agent-view#permission-mode-model-and-effort). Accetta `--settings`, `--add-dir`, `--plugin-dir` e `--mcp-config` come il comando `claude` di livello superiore. Richiede un terminale interattivo | `claude agents --cwd ~/projects/my-app` |

28| `claude attach <id>` | Collegati a una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) in questo terminale | `claude attach 7c5dcf5d` |28| `claude attach <id>` | Collegati a una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) in questo terminale | `claude attach 7c5dcf5d` |

29| `claude auto-mode defaults` | Stampa le regole del classificatore [auto mode](/it/permission-modes#eliminate-prompts-with-auto-mode) integrate come JSON. Usa `claude auto-mode config` per visualizzare la tua configurazione effettiva con le impostazioni applicate | `claude auto-mode defaults > rules.json` |29| `claude auto-mode defaults` | Stampa le regole del classificatore [auto mode](/it/permission-modes#eliminate-prompts-with-auto-mode) integrate come JSON. Usa `claude auto-mode config` per visualizzare la tua configurazione effettiva con le impostazioni applicate | `claude auto-mode defaults > rules.json` |

30| `claude daemon status` | Stampa lo stato del [supervisore](/it/agent-view#the-supervisor-process) della sessione in background, versione, directory socket e numero di worker per la diagnostica. Esce con 1 se il supervisore non è in esecuzione | `claude daemon status` |

30| `claude logs <id>` | Stampa l'output recente da una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |31| `claude logs <id>` | Stampa l'output recente da una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |

31| `claude mcp` | Configura server Model Context Protocol (MCP) | Vedi la [documentazione MCP di Claude Code](/it/mcp). |32| `claude mcp` | Configura server Model Context Protocol (MCP) | Vedi la [documentazione MCP di Claude Code](/it/mcp). |

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

33| `claude project 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](/it/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |34| `claude project 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](/it/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |

34| `claude remote-control` | Avvia un server [Remote Control](/it/remote-control) per controllare Claude Code da Claude.ai o dall'app Claude. Viene eseguito in modalità server (nessuna sessione interattiva locale). Vedi [Flag modalità server](/it/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |35| `claude remote-control` | Avvia un server [Remote Control](/it/remote-control) per controllare Claude Code da Claude.ai o dall'app Claude. Viene eseguito in modalità server (nessuna sessione interattiva locale). Vedi [Flag modalità server](/it/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |

35| `claude respawn <id>` | Riavvia una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) interrotta mantenendo la sua conversazione intatta. Usa `--all` per riavviare ogni sessione interrotta | `claude respawn 7c5dcf5d` |36| `claude respawn <id>` | Riavvia una [sessione in background](/it/agent-view#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` |

36| `claude rm <id>` | Rimuovi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) dall'elenco | `claude rm 7c5dcf5d` |37| `claude rm <id>` | Rimuovi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) dall'elenco | `claude rm 7c5dcf5d` |

37| `claude setup-token` | Genera un token OAuth di lunga durata per CI e script. Stampa il token nel terminale senza salvarlo. Richiede un abbonamento Claude. Vedi [Genera un token di lunga durata](/it/authentication#generate-a-long-lived-token) | `claude setup-token` |38| `claude setup-token` | Genera un token OAuth di lunga durata per CI e script. Stampa il token nel terminale senza salvarlo. Richiede un abbonamento Claude. Vedi [Genera un token di lunga durata](/it/authentication#generate-a-long-lived-token) | `claude setup-token` |

38| `claude stop <id>` | Interrompi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell). Accetta anche `claude kill` | `claude stop 7c5dcf5d` |39| `claude stop <id>` | Interrompi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell). Accetta anche `claude kill` | `claude stop 7c5dcf5d` |


68| `--effort` | Imposta il [livello di sforzo](/it/model-config#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`; i livelli disponibili dipendono dal modello. Sostituisce l'impostazione [`effortLevel`](/it/settings#available-settings) per questa sessione e non persiste | `claude --effort high` |69| `--effort` | Imposta il [livello di sforzo](/it/model-config#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`; i livelli disponibili dipendono dal modello. Sostituisce l'impostazione [`effortLevel`](/it/settings#available-settings) per questa sessione e non persiste | `claude --effort high` |

69| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Rimosso in v2.1.111. Auto mode è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in esso | `claude --permission-mode auto` |70| `--enable-auto-mode` | {/* max-version: 2.1.110 */}Rimosso in v2.1.111. Auto mode è ora nel ciclo `Shift+Tab` per impostazione predefinita; usa `--permission-mode auto` per iniziare in esso | `claude --permission-mode auto` |

70| `--exclude-dynamic-system-prompt-sections` | Sposta le sezioni per macchina dal prompt di sistema (directory di lavoro, informazioni sull'ambiente, percorsi di memoria, stato git) nel primo messaggio dell'utente. Migliora il riutilizzo della prompt-cache tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script e multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |71| `--exclude-dynamic-system-prompt-sections` | Sposta le sezioni per macchina dal prompt di sistema (directory di lavoro, informazioni sull'ambiente, percorsi di memoria, stato git) nel primo messaggio dell'utente. Migliora il riutilizzo della prompt-cache tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando `--system-prompt` o `--system-prompt-file` è impostato. Usa con `-p` per carichi di lavoro con script e multi-utente | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

71| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello predefinito è sovraccarico (solo modalità print) | `claude -p --fallback-model sonnet "query"` |72| `--fallback-model` | Abilita il fallback automatico al modello specificato quando il modello predefinito è sovraccarico. Ha effetto in modalità print (`-p`) e in [sessioni in background](/it/agent-view), che vengono eseguite in modo non interattivo; ignorato in una sessione interattiva | `claude -p --fallback-model sonnet "query"` |

72| `--fork-session` | Quando riprendi, crea un nuovo ID di sessione invece di riutilizzare l'originale (usa con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |73| `--fork-session` | Quando riprendi, crea un nuovo ID di sessione invece di riutilizzare l'originale (usa con `--resume` o `--continue`) | `claude --resume abc123 --fork-session` |

73| `--from-pr` | Riprendi sessioni collegate a una specifica pull request. Accetta un numero di PR, un URL di GitHub o GitHub Enterprise PR, un URL di merge request di GitLab o un URL di pull request di Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la pull request | `claude --from-pr 123` |74| `--from-pr` | Riprendi sessioni collegate a una specifica pull request. Accetta un numero di PR, un URL di GitHub o GitHub Enterprise PR, un URL di merge request di GitLab o un URL di pull request di Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la pull request | `claude --from-pr 123` |

74| `--ide` | Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile | `claude --ide` |75| `--ide` | Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile | `claude --ide` |

code-review.md +2 −2

Details

29 29 

30Una volta che un amministratore [abilita Code Review](#set-up-code-review) per la tua organizzazione, le revisioni si attivano quando un PR si apre, ad ogni push, o quando richiesto manualmente, a seconda del comportamento configurato del repository. Commentando `@claude review` [avvia le revisioni su un PR](#manually-trigger-reviews) in qualsiasi modalità.30Una volta che un amministratore [abilita Code Review](#set-up-code-review) per la tua organizzazione, le revisioni si attivano quando un PR si apre, ad ogni push, o quando richiesto manualmente, a seconda del comportamento configurato del repository. Commentando `@claude review` [avvia le revisioni su un PR](#manually-trigger-reviews) in qualsiasi modalità.

31 31 

32Quando una revisione viene eseguita, più agenti analizzano il diff e il codice circostante in parallelo sull'infrastruttura Anthropic. Ogni agente cerca una classe diversa di problema, quindi un passaggio di verifica controlla i candidati rispetto al comportamento effettivo del codice per filtrare i falsi positivi. I risultati vengono deduplicati, classificati per gravità e pubblicati come commenti inline sulle righe specifiche dove sono stati trovati i problemi, con un riepilogo nel corpo della revisione. Se non vengono trovati problemi, Claude pubblica un breve commento di conferma sul PR.32Quando una revisione viene eseguita, più agenti analizzano il diff e il codice circostante in parallelo sull'infrastruttura Anthropic. Ogni agente cerca una classe diversa di problema, quindi un passaggio di verifica controlla i candidati rispetto al comportamento effettivo del codice per filtrare i falsi positivi. I risultati vengono deduplicati, classificati per gravità e pubblicati come commenti inline sulle righe specifiche dove sono stati trovati i problemi, con un riepilogo nel corpo della revisione. Se non vengono trovati problemi, Code Review aggiorna il check run di GitHub per mostrare che non sono stati rilevati problemi. Claude può anche pubblicare un breve commento di conferma sul PR.

33 33 

34Le revisioni si scalano in costo con la dimensione e la complessità del PR, completandosi in media in 20 minuti. Gli amministratori possono monitorare l'attività di revisione e la spesa tramite il [dashboard di analisi](#view-usage).34Le revisioni si scalano in costo con la dimensione e la complessità del PR, completandosi in media in 20 minuti. Gli amministratori possono monitorare l'attività di revisione e la spesa tramite il [dashboard di analisi](#view-usage).

35 35 


230 230 

231## Prezzi231## Prezzi

232 232 

233Code Review viene fatturato in base all'utilizzo dei token. Ogni revisione costa in media \$15-25, scalando con la dimensione del PR, la complessità del codebase e quanti problemi richiedono verifica. L'utilizzo di Code Review viene fatturato separatamente tramite [extra usage](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) e non conta rispetto all'utilizzo incluso nel tuo piano.233Code Review viene fatturato in base all'utilizzo dei token. Ogni revisione costa in media \$15-25, scalando con la dimensione del PR, la complessità del codebase e quanti problemi richiedono verifica. L'utilizzo di Code Review viene fatturato separatamente tramite [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) e non conta rispetto all'utilizzo incluso nel tuo piano.

234 234 

235Il trigger di revisione che scegli influisce sul costo totale:235Il trigger di revisione che scegli influisce sul costo totale:

236 236 

commands.md +1 −1

Details

63| `/effort [level\|auto]` | Imposta il [livello di sforzo](/it/model-config#adjust-effort-level) del modello. Accetta `low`, `medium`, `high`, `xhigh` o `max`; i livelli disponibili dipendono dal modello e `max` è solo per la sessione. `auto` ripristina il valore predefinito del modello. Senza un argomento, apre un cursore interattivo; usa le frecce sinistra e destra per scegliere un livello e `Enter` per applicare. Ha effetto immediato senza aspettare il completamento della risposta corrente |63| `/effort [level\|auto]` | Imposta il [livello di sforzo](/it/model-config#adjust-effort-level) del modello. Accetta `low`, `medium`, `high`, `xhigh` o `max`; i livelli disponibili dipendono dal modello e `max` è solo per la sessione. `auto` ripristina il valore predefinito del modello. Senza un argomento, apre un cursore interattivo; usa le frecce sinistra e destra per scegliere un livello e `Enter` per applicare. Ha effetto immediato senza aspettare il completamento della risposta corrente |

64| `/exit` | Esci dalla CLI. In una [sessione in background](/it/agent-view#attach-to-a-session) collegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |64| `/exit` | Esci dalla CLI. In una [sessione in background](/it/agent-view#attach-to-a-session) collegata, questo stacca e la sessione continua a funzionare. Alias: `/quit` |

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

66| `/extra-usage` | Configura l'utilizzo extra per continuare a lavorare quando vengono raggiunti i limiti di velocità |

67| `/fast [on\|off]` | Attiva o disattiva la [modalità veloce](/it/fast-mode) |66| `/fast [on\|off]` | Attiva o disattiva la [modalità veloce](/it/fast-mode) |

68| `/feedback [report]` | Invia feedback su Claude Code. Alias: `/bug` |67| `/feedback [report]` | Invia feedback su Claude Code. Alias: `/bug` |

69| `/fewer-permission-prompts` | **[Skill](/it/skills#bundled-skills).** Scansiona i tuoi trascritti per le comuni chiamate Bash e MCP tool di sola lettura, quindi aggiungi una lista di autorizzazione prioritaria al progetto `.claude/settings.json` per ridurre i prompt di permesso |68| `/fewer-permission-prompts` | **[Skill](/it/skills#bundled-skills).** Scansiona i tuoi trascritti per le comuni chiamate Bash e MCP tool di sola lettura, quindi aggiungi una lista di autorizzazione prioritaria al progetto `.claude/settings.json` per ridurre i prompt di permesso |


125| `/ultrareview [PR]` | Esegui una revisione del codice profonda e multi-agente in una sandbox cloud con [ultrareview](/it/ultrareview). Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [utilizzo extra](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |124| `/ultrareview [PR]` | Esegui una revisione del codice profonda e multi-agente in una sandbox cloud con [ultrareview](/it/ultrareview). Include 3 esecuzioni gratuite su Pro e Max, quindi richiede [utilizzo extra](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

126| `/upgrade` | Apri la pagina di upgrade per passare a un livello di piano superiore |125| `/upgrade` | Apri la pagina di upgrade per passare a un livello di piano superiore |

127| `/usage` | Mostra il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Vedi la [guida al tracciamento dei costi](/it/costs#using-the-%2Fusage-command) per i dettagli specifici dell'abbonamento. `/cost` e `/stats` sono alias |126| `/usage` | Mostra il costo della sessione, i limiti di utilizzo del piano e le statistiche di attività. Vedi la [guida al tracciamento dei costi](/it/costs#using-the-%2Fusage-command) per i dettagli specifici dell'abbonamento. `/cost` e `/stats` sono alias |

127| `/usage-credits` | Configura i crediti di utilizzo per continuare a lavorare quando raggiungi un limite. Precedentemente `/extra-usage` |

128| `/vim` | {/* max-version: 2.1.91 */}Rimosso in v2.1.92. Per alternare tra le modalità di modifica Vim e Normale, usa `/config` → Editor mode |128| `/vim` | {/* max-version: 2.1.91 */}Rimosso in v2.1.92. Per alternare tra le modalità di modifica Vim e Normale, usa `/config` → Editor mode |

129| `/voice [hold\|tap\|off]` | Attiva/disattiva la [dettatura vocale](/it/voice-dictation), o abilitala in una modalità specifica. Richiede un account Claude.ai |129| `/voice [hold\|tap\|off]` | Attiva/disattiva la [dettatura vocale](/it/voice-dictation), o abilitala in una modalità specifica. Richiede un account Claude.ai |

130| `/web-setup` | Connetti il tuo account GitHub a [Claude Code sul web](/it/web-quickstart#connect-from-your-terminal) utilizzando le credenziali della CLI `gh` locale. `/schedule` richiede questo automaticamente se GitHub non è connesso |130| `/web-setup` | Connetti il tuo account GitHub a [Claude Code sul web](/it/web-quickstart#connect-from-your-terminal) utilizzando le credenziali della CLI `gh` locale. `/schedule` richiede questo automaticamente se GitHub non è connesso |

Details

87La maggior parte delle sorprese di configurazione risale a un piccolo insieme di regole di posizione e sintassi. Controlla questi prima di assumere un bug:87La maggior parte delle sorprese di configurazione risale a un piccolo insieme di regole di posizione e sintassi. Controlla questi prima di assumere un bug:

88 88 

89| Sintomo | Causa | Soluzione |89| Sintomo | Causa | Soluzione |

90| :------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |90| :------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

91| Hook non si attiva mai | `matcher` è un array JSON invece di una stringa | Usa una singola stringa con `\|` per corrispondere a più strumenti, ad esempio `"Edit\|Write"`. Vedi [matcher patterns](/it/hooks#matcher-patterns). |91| Hook non si attiva mai | `matcher` è un array JSON invece di una stringa | Usa una singola stringa con `\|` per corrispondere a più strumenti, ad esempio `"Edit\|Write"`. Vedi [matcher patterns](/it/hooks#matcher-patterns). |

92| Hook non si attiva mai | Il valore di `matcher` è minuscolo, ad esempio `"bash"` | La corrispondenza è sensibile alle maiuscole. I nomi degli strumenti sono capitalizzati: `Bash`, `Edit`, `Write`, `Read`. |92| Hook non si attiva mai | Il valore di `matcher` è minuscolo, ad esempio `"bash"` | La corrispondenza è sensibile alle maiuscole. I nomi degli strumenti sono capitalizzati: `Bash`, `Edit`, `Write`, `Read`. |

93| Hook non si attiva mai | Gli hooks sono in un file `.claude/hooks.json` autonomo | Non esiste un file di hooks autonomo. Definisci gli hooks sotto la chiave `"hooks"` in `settings.json`. Vedi [hook configuration](/it/hooks). |93| Hook non si attiva mai | Gli hooks sono definiti in un file autonomo invece di `settings.json` | Non esiste un file di hooks autonomo per la configurazione del progetto o dell'utente. Definisci gli hooks sotto la chiave `"hooks"` in `settings.json`. Solo i [plugins](/it/plugins-reference#hooks) caricano un file separato `hooks/hooks.json`. Vedi [hook configuration](/it/hooks). |

94| Permissions, hooks o env impostati globalmente vengono ignorati | La configurazione è stata aggiunta a `~/.claude.json` | `~/.claude.json` contiene lo stato dell'app e gli interruttori dell'interfaccia utente. `permissions`, `hooks` e `env` appartengono a `~/.claude/settings.json`. Questi sono due file diversi. |94| Permissions, hooks o env impostati globalmente vengono ignorati | La configurazione è stata aggiunta a `~/.claude.json` | `~/.claude.json` contiene lo stato dell'app e gli interruttori dell'interfaccia utente. `permissions`, `hooks` e `env` appartengono a `~/.claude/settings.json`. Questi sono due file diversi. |

95| Un valore di `settings.json` sembra ignorato | La stessa chiave è impostata in `settings.local.json` | `settings.local.json` sostituisce `settings.json`, e entrambi sostituiscono `~/.claude/settings.json`. Vedi [settings precedence](/it/settings#how-scopes-interact). |95| Un valore di `settings.json` sembra ignorato | La stessa chiave è impostata in `settings.local.json` | `settings.local.json` sostituisce `settings.json`, e entrambi sostituiscono `~/.claude/settings.json`. Vedi [settings precedence](/it/settings#how-scopes-interact). |

96| Skill non appare in `/skills` | Il file di skill è in `.claude/skills/name.md` invece che in una cartella | Usa una cartella con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |96| Skill non appare in `/skills` | Il file di skill è in `.claude/skills/name.md` invece che in una cartella | Usa una cartella con `SKILL.md` dentro: `.claude/skills/name/SKILL.md`. |

97| Skill appare in `/skills` ma Claude non la invoca mai | Skill ha `disable-model-invocation: true` nel suo frontmatter, o la sua descrizione non corrisponde a come formuli la richiesta | Controlla il badge in `/skills`: un'etichetta "user-only" significa che Claude non la attiverà da sola. Vedi [skill invocation](/it/skills). |97| Skill appare in `/skills` ma Claude non la invoca mai | Skill ha `disable-model-invocation: true` nel suo frontmatter, o la sua descrizione non corrisponde a come formuli la richiesta | Controlla il badge in `/skills`: un'etichetta "user-only" significa che Claude non la attiverà da sola. Vedi [skill invocation](/it/skills). |

98| Le istruzioni di `CLAUDE.md` della sottodirectory sembrano ignorate | I file della sottodirectory si caricano su richiesta, non all'inizio della sessione | Si caricano quando Claude legge un file in quella directory con lo strumento Read, non al lancio e non quando scrive o crea file lì. Vedi [come i file CLAUDE.md si caricano](/it/memory#how-claude-md-files-load). |98| Le istruzioni di `CLAUDE.md` della sottodirectory sembrano ignorate | I file della sottodirectory si caricano su richiesta, non all'inizio della sessione | Si caricano quando Claude legge un file in quella directory con lo strumento Read, non al lancio e non quando scrive o crea file lì. Vedi [come i file CLAUDE.md si caricano](/it/memory#how-claude-md-files-load). |

99| Subagent ignora le istruzioni di `CLAUDE.md` | I subagenti non sempre ereditano la memoria del progetto | Metti le regole critiche nel corpo del file dell'agente, che diventa il prompt di sistema del subagente. Vedi [subagent configuration](/it/sub-agents). |99| Subagent ignora le istruzioni di `CLAUDE.md` | Gli agenti Explore e Plan incorporati saltano `CLAUDE.md`. I subagenti personalizzati lo caricano nello stesso modo in cui la conversazione principale lo fa | Per Explore o Plan, ripeti l'istruzione nel tuo prompt di delega. Per un subagente personalizzato, metti le istruzioni critiche nel corpo del file dell'agente, che diventa il prompt di sistema dell'agente. Vedi [cosa si carica all'avvio](/it/sub-agents#what-loads-at-startup). |

100| La logica di pulizia non viene mai eseguita alla fine della sessione | Nessun hook `SessionEnd` configurato | Aggiungi un hook `SessionEnd` in `settings.json`. Vedi l'[elenco degli eventi di hook](/it/hooks#hook-events). |100| La logica di pulizia non viene mai eseguita alla fine della sessione | Nessun hook `SessionEnd` configurato | Aggiungi un hook `SessionEnd` in `settings.json`. Vedi l'[elenco degli eventi di hook](/it/hooks#hook-events). |

101| I server MCP in `.mcp.json` non si caricano mai | Il file è sotto `.claude/` o utilizza il formato di configurazione di Claude Desktop | La configurazione MCP del progetto va alla radice del repository come `.mcp.json`, non dentro `.claude/`. Vedi [MCP configuration](/it/mcp). |101| I server MCP in `.mcp.json` non si caricano mai | Il file è sotto `.claude/` o utilizza il formato di configurazione di Claude Desktop | La configurazione MCP del progetto va alla radice del repository come `.mcp.json`, non dentro `.claude/`. Vedi [MCP configuration](/it/mcp). |

102| Server MCP aggiunti sotto `mcpServers` in `settings.json` non appaiono mai | `settings.json` non legge una chiave `mcpServers` | Definisci i server del progetto in `.mcp.json` alla radice del repository, o esegui `claude mcp add --scope user` per i server con ambito utente. Vedi [MCP configuration](/it/mcp). |102| Server MCP aggiunti sotto `mcpServers` in `settings.json` non appaiono mai | `settings.json` non legge una chiave `mcpServers` | Definisci i server del progetto in `.mcp.json` alla radice del repository, o esegui `claude mcp add --scope user` per i server con ambito utente. Vedi [MCP configuration](/it/mcp). |

desktop.md +2 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Usa Claude Code Desktop5# Applicazione desktop

6 6 

7> Sfrutta al massimo Claude Code Desktop: sessioni parallele con isolamento Git, layout dei pannelli drag-and-drop, terminale integrato e editor di file, chat laterali, utilizzo del computer, Dispatch sessioni dal tuo telefono, revisione visiva dei diff, anteprime delle app, monitoraggio dei PR, connettori e configurazione aziendale.7> Sfrutta al massimo Claude Code Desktop: sessioni parallele con isolamento Git, layout dei pannelli drag-and-drop, terminale integrato e editor di file, chat laterali, utilizzo del computer, Dispatch sessioni dal tuo telefono, revisione visiva dei diff, anteprime delle app, monitoraggio dei PR, connettori e configurazione aziendale.

8 8 


707* **Linux**: l'app desktop è disponibile solo su macOS e Windows. Su Linux, usa la [CLI](/it/quickstart).707* **Linux**: l'app desktop è disponibile solo su macOS e Windows. Su Linux, usa la [CLI](/it/quickstart).

708* **Suggerimenti di codice inline**: Desktop non fornisce suggerimenti in stile autocomplete. Funziona tramite prompt conversazionali e modifiche di codice esplicite.708* **Suggerimenti di codice inline**: Desktop non fornisce suggerimenti in stile autocomplete. Funziona tramite prompt conversazionali e modifiche di codice esplicite.

709* **Team di agent**: l'orchestrazione multi-agent è disponibile tramite la [CLI](/it/agent-teams) e [Agent SDK](/it/headless), non in Desktop.709* **Team di agent**: l'orchestrazione multi-agent è disponibile tramite la [CLI](/it/agent-teams) e [Agent SDK](/it/headless), non in Desktop.

710* **Comandi terminal-dialog**: i comandi integrati che aprono un pannello interattivo nel terminale, come `/permissions`, `/config`, `/agents` e `/doctor`, non sono disponibili nella scheda Code e rispondono con `isn't available in this environment`. Modifica direttamente i [file di impostazioni](/it/settings) per gestire le regole di autorizzazione e la configurazione, oppure esegui il comando dalla CLI standalone.

710 711 

711## Troubleshooting712## Troubleshooting

712 713 

Details

138 </Step>138 </Step>

139 139 

140 <Step title="Installare un plugin">140 <Step title="Installare un plugin">

141 Selezionate un plugin per visualizzare i suoi dettagli, quindi scegliete un ambito di installazione:141 Selezionate un plugin per visualizzare i suoi dettagli. {/* min-version: 2.1.143 */}Su Claude Code v2.1.143 e versioni successive, il riquadro dei dettagli include una stima di **Context cost** in modo da poter vedere quanti token il plugin aggiungerà alla vostra [finestra di contesto](/it/features-overview#understand-context-costs) ad ogni turno prima di installarlo.

142 

143 Scegliete un ambito di installazione:

142 144 

143 * **User scope**: installate per voi stessi in tutti i progetti145 * **User scope**: installate per voi stessi in tutti i progetti

144 * **Project scope**: installate per tutti i collaboratori su questo repository146 * **Project scope**: installate per tutti i collaboratori su questo repository

env-vars.md +12 −9

Details

100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al vostro [collettore OpenTelemetry](/it/monitoring-usage) quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro collettore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell'organizzazione hanno la precedenza |100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al vostro [collettore OpenTelemetry](/it/monitoring-usage) quando il traffico non essenziale legato ad Anthropic è bloccato. I rating del sondaggio vengono emessi solo come eventi OTEL al vostro collettore configurato. Nessun dato del sondaggio viene inviato ad Anthropic in questa modalità. Si applica quando `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` o `DO_NOT_TRACK` è impostato, e non ha effetto altrimenti. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` e la politica di feedback del prodotto dell'organizzazione hanno la precedenza |

101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Bedrock e Vertex, abilitato per modello dove il container distribuito lo supporta. Imposta su `0` per rinunciare. Imposta su `1` per forzare l'abilitazione quando instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Foundry e connessioni [gateway](/it/llm-gateway) |101| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | Controlla se gli input delle chiamate di strumento vengono trasmessi dall'API mentre Claude li genera. Con questo disattivato, un input di strumento grande come una lunga scrittura di file arriva solo dopo che Claude finisce di generarlo, il che può sembrare che sia bloccato. Abilitato per impostazione predefinita sull'API Anthropic. Su Bedrock e Vertex, abilitato per modello dove il container distribuito lo supporta. Imposta su `0` per rinunciare. Imposta su `1` per forzare l'abilitazione quando instrada attraverso un proxy tramite `ANTHROPIC_BASE_URL`, `ANTHROPIC_VERTEX_BASE_URL` o `ANTHROPIC_BEDROCK_BASE_URL`. Disattivato per impostazione predefinita su Foundry e connessioni [gateway](/it/llm-gateway) |

102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del vostro gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati dall'allowlist [`availableModels`](/it/settings#available-settings) |102| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Imposta su `1` per popolare il selettore `/model` dall'endpoint `/v1/models` del vostro gateway quando `ANTHROPIC_BASE_URL` punta a un gateway compatibile con Anthropic come LiteLLM, Kong o un proxy interno. Disattivato per impostazione predefinita perché i gateway supportati da una chiave API condivisa mostrerebbero altrimenti a ogni utente ogni modello a cui la chiave può accedere. I modelli scoperti vengono comunque filtrati dall'allowlist [`availableModels`](/it/settings#available-settings) |

103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | Imposta su `1` per eseguire la [modalità veloce](/it/fast-mode) su Claude Opus 4.7 invece di Opus 4.6. Con la variabile impostata, `/fast` passa a Opus 4.7; senza di essa, `/fast` continua a usare Opus 4.6 |103| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | {/* max-version: 2.1.141 */}Rimosso in v2.1.142. La [modalità veloce](/it/fast-mode) per impostazione predefinita è Opus 4.7. Imposta `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` per mantenere Opus 4.6 |

104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta su `false` per disabilitare i suggerimenti di prompt (l'interruttore "Prompt suggestions" in `/config`). Questi sono i suggerimenti predetti in grigio che appaiono nel vostro input di prompt dopo che Claude risponde. Vedi [Suggerimenti di prompt](/it/interactive-mode#prompt-suggestions) |104| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | Imposta su `false` per disabilitare i suggerimenti di prompt (l'interruttore "Prompt suggestions" in `/config`). Questi sono i suggerimenti predetti in grigio che appaiono nel vostro input di prompt dopo che Claude risponde. Vedi [Suggerimenti di prompt](/it/interactive-mode#prompt-suggestions) |

105| `CLAUDE_CODE_ENABLE_TASKS` | Imposta su `1` per abilitare il sistema di tracciamento delle attività in modalità non interattiva (il flag `-p`). Le attività sono abilitate per impostazione predefinita in modalità interattiva. Vedi [Elenco attività](/it/interactive-mode#task-list) |105| `CLAUDE_CODE_ENABLE_TASKS` | Controlla se le sessioni utilizzano gli strumenti Task strutturati (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) o lo strumento legacy `TodoWrite`. {/* min-version: 2.1.142 */}A partire da Claude Code v2.1.142, gli strumenti Task sono il valore predefinito in tutte le modalità. Imposta su `0` per tornare a `TodoWrite`. Vedi [Elenco attività](/it/interactive-mode#task-list) e [Migra agli strumenti Task](/it/agent-sdk/todo-tracking#migrate-to-task-tools) |

106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Obbligatorio prima di configurare gli esportatori OTel. Vedi [Monitoraggio](/it/monitoring-usage) |106| `CLAUDE_CODE_ENABLE_TELEMETRY` | Imposta su `1` per abilitare la raccolta di dati OpenTelemetry per metriche e logging. Obbligatorio prima di configurare gli esportatori OTel. Vedi [Monitoraggio](/it/monitoring-usage) |

107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il loop di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |107| `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` | Tempo in millisecondi da attendere dopo che il loop di query diventa inattivo prima di uscire automaticamente. Utile per flussi di lavoro automatizzati e script che utilizzano la modalità SDK |

108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta su `1` per abilitare i [team di agenti](/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |108| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Imposta su `1` per abilitare i [team di agenti](/it/agent-teams). I team di agenti sono sperimentali e disabilitati per impostazione predefinita |


130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione Claude.ai. Se impostato, `claude auth login` scambia questo token direttamente invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati |130| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Token di aggiornamento OAuth per l'autenticazione Claude.ai. Se impostato, `claude auth login` scambia questo token direttamente invece di aprire un browser. Richiede `CLAUDE_CODE_OAUTH_SCOPES`. Utile per il provisioning dell'autenticazione in ambienti automatizzati |

131| `CLAUDE_CODE_OAUTH_SCOPES` | Ambiti OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato |131| `CLAUDE_CODE_OAUTH_SCOPES` | Ambiti OAuth separati da spazi con cui è stato emesso il token di aggiornamento, come `"user:profile user:inference user:sessions:claude_code"`. Obbligatorio quando `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` è impostato |

132| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione Claude.ai. Alternativa a `/login` per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generatene uno con [`claude setup-token`](/it/authentication#generate-a-long-lived-token) |132| `CLAUDE_CODE_OAUTH_TOKEN` | Token di accesso OAuth per l'autenticazione Claude.ai. Alternativa a `/login` per SDK e ambienti automatizzati. Ha la precedenza sulle credenziali archiviate nel portachiavi. Generatene uno con [`claude setup-token`](/it/authentication#generate-a-long-lived-token) |

133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Imposta su `1` per mantenere la [modalità veloce](/it/fast-mode) su Claude Opus 4.6. Ha la precedenza su `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`, quindi impostate questo se avete bisogno di fissare Opus 4.6 indipendentemente da come cambia il valore predefinito |133| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | Imposta su `1` per mantenere la [modalità veloce](/it/fast-mode) su Claude Opus 4.6 invece del valore predefinito Opus 4.7. Con la variabile impostata, `/fast` viene eseguito su Opus 4.6. Senza di essa, `/fast` viene eseguito su Opus 4.7 |

134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo scaricamento dei span OpenTelemetry in sospeso (predefinito: 5000). Vedi [Monitoraggio](/it/monitoring-usage) |134| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | Timeout in millisecondi per lo scaricamento dei span OpenTelemetry in sospeso (predefinito: 5000). Vedi [Monitoraggio](/it/monitoring-usage) |

135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedi [Intestazioni dinamiche](/it/monitoring-usage#dynamic-headers) |135| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Intervallo per l'aggiornamento delle intestazioni OpenTelemetry dinamiche in millisecondi (predefinito: 1740000 / 29 minuti). Vedi [Intestazioni dinamiche](/it/monitoring-usage#dynamic-headers) |

136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi per l'esportatore OpenTelemetry per terminare all'arresto (predefinito: 2000). Aumentate se le metriche vengono eliminate all'uscita. Vedi [Monitoraggio](/it/monitoring-usage) |136| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | Timeout in millisecondi per l'esportatore OpenTelemetry per terminare all'arresto (predefinito: 2000). Aumentate se le metriche vengono eliminate all'uscita. Vedi [Monitoraggio](/it/monitoring-usage) |


141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta su `1` per mantenere la cache del marketplace esistente quando un `git pull` fallisce invece di cancellare e ri-clonare. Utile in ambienti offline o airgapped dove il ri-cloning fallirebbe allo stesso modo. Vedi [Gli aggiornamenti del marketplace falliscono in ambienti offline](/it/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |141| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | Imposta su `1` per mantenere la cache del marketplace esistente quando un `git pull` fallisce invece di cancellare e ri-clonare. Utile in ambienti offline o airgapped dove il ri-cloning fallirebbe allo stesso modo. Vedi [Gli aggiornamenti del marketplace falliscono in ambienti offline](/it/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) |

142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le fonti plugin GitHub `owner/repo` su HTTPS invece di SSH. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |142| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le fonti plugin GitHub `owner/repo` su HTTPS invece di SSH. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory di seed plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizza questo per raggruppare una directory plugin pre-popolata in un'immagine container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati nella cache senza ri-clonare. Vedi [Pre-popola i plugin per i container](/it/plugin-marketplaces#pre-populate-plugins-for-containers) |143| `CLAUDE_CODE_PLUGIN_SEED_DIR` | Percorso di una o più directory di seed plugin di sola lettura, separate da `:` su Unix o `;` su Windows. Utilizza questo per raggruppare una directory plugin pre-popolata in un'immagine container. Claude Code registra i marketplace da queste directory all'avvio e utilizza i plugin pre-memorizzati nella cache senza ri-clonare. Vedi [Pre-popola i plugin per i container](/it/plugin-marketplaces#pre-populate-plugins-for-containers) |

144| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | Imposta su `1` per impedire a Claude Code di passare `-ExecutionPolicy Bypass` quando genera PowerShell per le chiamate di strumento, gli hook e i comandi della linea di stato, e rispettare la politica di esecuzione effettiva della macchina. Per impostazione predefinita Claude Code bypassa la politica di esecuzione a livello di processo in modo che gli script `.ps1` e gli import di moduli funzionino su installazioni Windows predefinite con Restricted. Il bypass a livello di processo non sostituisce mai la Politica di gruppo `MachinePolicy` o `UserPolicy` indipendentemente da questa impostazione |

144| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Se impostato, la selezione del provider, l'endpoint e le variabili di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni vengono ignorate in modo che le impostazioni dell'utente non possono sovrascrivere l'instradamento dell'host. Anche l'opt-out automatico della telemetria per Bedrock, Vertex e Foundry viene saltato, quindi la telemetria segue l'opt-out standard `DISABLE_TELEMETRY`. Vedi [Comportamenti predefiniti per provider API](/it/data-usage#default-behaviors-by-api-provider) |145| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Impostato da piattaforme host che incorporano Claude Code e gestiscono l'instradamento del provider di modelli per suo conto. Se impostato, la selezione del provider, l'endpoint e le variabili di autenticazione come `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` e `ANTHROPIC_API_KEY` nei file di impostazioni vengono ignorate in modo che le impostazioni dell'utente non possono sovrascrivere l'instradamento dell'host. Anche l'opt-out automatico della telemetria per Bedrock, Vertex e Foundry viene saltato, quindi la telemetria segue l'opt-out standard `DISABLE_TELEMETRY`. Vedi [Comportamenti predefiniti per provider API](/it/data-usage#default-behaviors-by-api-provider) |

145| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy deve gestire la risoluzione del nome host |146| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Imposta su `1` per consentire al proxy di eseguire la risoluzione DNS invece del chiamante. Opt-in per ambienti in cui il proxy deve gestire la risoluzione del nome host |

146| `CLAUDE_CODE_REMOTE` | Impostato automaticamente su `true` quando Claude Code è in esecuzione come una [sessione cloud](/it/claude-code-on-the-web). Leggete questo da un hook o script di configurazione per rilevare se siete in un ambiente cloud |147| `CLAUDE_CODE_REMOTE` | Impostato automaticamente su `true` quando Claude Code è in esecuzione come una [sessione cloud](/it/claude-code-on-the-web). Leggete questo da un hook o script di configurazione per rilevare se siete in un ambiente cloud |


161| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM) |162| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Salta l'autenticazione AWS per Bedrock Mantle (ad esempio, quando si utilizza un gateway LLM) |

162| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta su `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue` o nella cronologia della freccia su. Utile per sessioni di script effimere |163| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | Imposta su `1` per saltare la scrittura della cronologia dei prompt e delle trascrizioni della sessione su disco. Le sessioni avviate con questa variabile impostata non appaiono in `--resume`, `--continue` o nella cronologia della freccia su. Utile per sessioni di script effimere |

163| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Vertex (ad esempio, quando si utilizza un gateway LLM) |164| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Salta l'autenticazione Google per Vertex (ad esempio, quando si utilizza un gateway LLM) |

165| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | Numero massimo di volte consecutive che un hook [Stop](/it/hooks#stop) o [SubagentStop](/it/hooks#subagentstop) può bloccare il turno dal terminare prima che Claude Code lo sostituisca e termini il turno comunque (predefinito: 8). Imposta su `0` per disabilitare il limite. Aumentate questo se il vostro hook ha legittimamente bisogno di più iterazioni per risolvere |

164| `CLAUDE_CODE_SUBAGENT_MODEL` | Vedi [Configurazione del modello](/it/model-config) |166| `CLAUDE_CODE_SUBAGENT_MODEL` | Vedi [Configurazione del modello](/it/model-config) |

165| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta su `1` per rimuovere le credenziali Anthropic e del provider cloud dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio). Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di prompt injection che tentano di esfiltare i segreti tramite l'espansione della shell. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato |167| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | Imposta su `1` per rimuovere le credenziali Anthropic e del provider cloud dagli ambienti dei sottoprocessi (strumento Bash, hook, server MCP stdio). Il processo Claude padre mantiene queste credenziali per le chiamate API, ma i processi figlio non possono leggerle, riducendo l'esposizione agli attacchi di prompt injection che tentano di esfiltare i segreti tramite l'espansione della shell. Su Linux, questo esegue anche i sottoprocessi Bash in uno spazio dei nomi PID isolato in modo che non possano leggere gli ambienti dei processi host tramite `/proc`; come effetto collaterale, `ps`, `pgrep` e `kill` non possono vedere o segnalare i processi host. `claude-code-action` imposta questo automaticamente quando `allowed_non_write_users` è configurato |

166| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combina con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |168| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | Imposta su `1` in modalità non interattiva (il flag `-p`) per attendere il completamento dell'installazione del plugin prima della prima query. Senza questo, i plugin si installano in background e potrebbero non essere disponibili al primo turno. Combina con `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` per limitare l'attesa |


180| `CLAUDE_CONFIG_DIR` | Sovrascrivi la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, le credenziali, la cronologia della sessione e i plugin sono archiviati sotto questo percorso. Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |182| `CLAUDE_CONFIG_DIR` | Sovrascrivi la directory di configurazione (predefinito: `~/.claude`). Tutte le impostazioni, le credenziali, la cronologia della sessione e i plugin sono archiviati sotto questo percorso. Utile per eseguire più account affiancati: ad esempio, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

181| `CLAUDE_EFFORT` | Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al [livello di sforzo](/it/model-config#adjust-effort-level) attivo per il turno: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/it/hooks). Impostato solo quando il modello corrente supporta il parametro effort |183| `CLAUDE_EFFORT` | Impostato automaticamente nei sottoprocessi dello strumento Bash e nei comandi hook al [livello di sforzo](/it/model-config#adjust-effort-level) attivo per il turno: `low`, `medium`, `high`, `xhigh` o `max`. Corrisponde al campo `effort.level` passato agli [hook](/it/hooks). Impostato solo quando il modello corrente supporta il parametro effort |

182| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta su `1` per forzare l'abilitazione del watchdog di inattività a livello di byte, o imposta su `0` per forzare la disabilitazione. Se non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic. Il byte watchdog interrompe una connessione quando nessun byte arriva sul filo per la durata impostata da `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, con un minimo di 5 minuti, indipendente dal watchdog a livello di evento |184| `CLAUDE_ENABLE_BYTE_WATCHDOG` | Imposta su `1` per forzare l'abilitazione del watchdog di inattività a livello di byte, o imposta su `0` per forzare la disabilitazione. Se non impostato, il watchdog è abilitato per impostazione predefinita per le connessioni API Anthropic. Il byte watchdog interrompe una connessione quando nessun byte arriva sul filo per la durata impostata da `CLAUDE_STREAM_IDLE_TIMEOUT_MS`, con un minimo di 5 minuti, indipendente dal watchdog a livello di evento |

183| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta su `1` per abilitare il watchdog di inattività dello streaming a livello di evento. Disattivato per impostazione predefinita. Per Bedrock, Vertex e Foundry, questo è l'unico watchdog di inattività disponibile. Configurate il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |185| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Imposta su `1` per abilitare il watchdog di inattività a livello di byte su risposte Amazon Bedrock `vnd.amazon.eventstream`. Disattivato per impostazione predefinita. Configurate il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

186| `CLAUDE_ENABLE_STREAM_WATCHDOG` | Imposta su `1` per abilitare il watchdog di inattività dello streaming a livello di evento. Disattivato per impostazione predefinita. Si applica a tutti i provider, incluso Bedrock. Per Vertex e Foundry, questo è l'unico watchdog di inattività disponibile. Su Bedrock, potete anche abilitare il watchdog indipendente a livello di byte con `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`; i due vengono eseguiti insieme quando entrambi sono impostati. Configurate il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |

184| `CLAUDE_ENV_FILE` | Percorso di uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizza per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente dagli hook [SessionStart](/it/hooks#persist-environment-variables), [Setup](/it/hooks#setup), [CwdChanged](/it/hooks#cwdchanged) e [FileChanged](/it/hooks#filechanged) |187| `CLAUDE_ENV_FILE` | Percorso di uno script di shell i cui contenuti Claude Code esegue prima di ogni comando Bash nello stesso processo di shell, in modo che gli export nel file siano visibili al comando. Utilizza per persistere l'attivazione di virtualenv o conda tra i comandi. Anche popolato dinamicamente dagli hook [SessionStart](/it/hooks#persist-environment-variables), [Setup](/it/hooks#setup), [CwdChanged](/it/hooks#cwdchanged) e [FileChanged](/it/hooks#filechanged) |

185| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Per impostazione predefinita il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |188| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | Prefisso per i nomi delle sessioni [Remote Control](/it/remote-control) generati automaticamente quando non viene fornito un nome esplicito. Per impostazione predefinita il nome host della vostra macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |

186| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che il watchdog di inattività dello streaming chiuda una connessione bloccata. Predefinito e minimo `300000` (5 minuti) per il watchdog a livello di byte e il watchdog a livello di evento; i valori inferiori vengono silenziosamente limitati per assorbire le pause di thinking esteso e il buffering del proxy. Per i provider di terze parti, richiede `CLAUDE_ENABLE_STREAM_WATCHDOG=1` |189| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in millisecondi prima che il watchdog di inattività dello streaming chiuda una connessione bloccata. Predefinito e minimo `300000` (5 minuti) per il watchdog a livello di byte e il watchdog a livello di evento; i valori inferiori vengono silenziosamente limitati per assorbire le pause di thinking esteso e il buffering del proxy. Per i provider di terze parti, richiede `CLAUDE_ENABLE_STREAM_WATCHDOG=1`. Su Bedrock, si applica anche quando `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` |

187| `DEBUG` | Imposta su `1` per abilitare la modalità debug, equivalente al lancio con [`--debug`](/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, o nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non lo attivano |190| `DEBUG` | Imposta su `1` per abilitare la modalità debug, equivalente al lancio con [`--debug`](/it/cli-reference#cli-flags). I log di debug vengono scritti in `~/.claude/debug/<session-id>.txt`, o nel percorso impostato da `CLAUDE_CODE_DEBUG_LOGS_DIR`. Solo i valori truthy `1`, `true`, `yes` e `on` abilitano la modalità debug, quindi i modelli di namespace come `DEBUG=express:*` impostati per altri strumenti non lo attivano |

188| `DISABLE_AUTOUPDATER` | Imposta su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` funziona ancora. Utilizza `DISABLE_UPDATES` per bloccare entrambi |191| `DISABLE_AUTOUPDATER` | Imposta su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` funziona ancora. Utilizza `DISABLE_UPDATES` per bloccare entrambi |

189| `DISABLE_AUTO_COMPACT` | Imposta su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale `/compact` rimane disponibile. Utilizza quando desiderate un controllo esplicito su quando si verifica la compattazione |192| `DISABLE_AUTO_COMPACT` | Imposta su `1` per disabilitare la compattazione automatica quando ci si avvicina al limite del contesto. Il comando manuale `/compact` rimane disponibile. Utilizza quando desiderate un controllo esplicito su quando si verifica la compattazione |


191| `DISABLE_COST_WARNINGS` | Imposta su `1` per disabilitare i messaggi di avviso sui costi |194| `DISABLE_COST_WARNINGS` | Imposta su `1` per disabilitare i messaggi di avviso sui costi |

192| `DISABLE_DOCTOR_COMMAND` | Imposta su `1` per nascondere il comando `/doctor`. Utile per distribuzioni gestite in cui gli utenti non dovrebbero eseguire diagnostiche di installazione |195| `DISABLE_DOCTOR_COMMAND` | Imposta su `1` per nascondere il comando `/doctor`. Utile per distribuzioni gestite in cui gli utenti non dovrebbero eseguire diagnostiche di installazione |

193| `DISABLE_ERROR_REPORTING` | Imposta su `1` per rinunciare alla segnalazione degli errori di Sentry |196| `DISABLE_ERROR_REPORTING` | Imposta su `1` per rinunciare alla segnalazione degli errori di Sentry |

194| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta su `1` per nascondere il comando `/extra-usage` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità |197| `DISABLE_EXTRA_USAGE_COMMAND` | Imposta su `1` per nascondere il comando `/usage-credits` che consente agli utenti di acquistare utilizzo aggiuntivo oltre i limiti di velocità |

195| `DISABLE_FEEDBACK_COMMAND` | Imposta su `1` per disabilitare il comando `/feedback`. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato |198| `DISABLE_FEEDBACK_COMMAND` | Imposta su `1` per disabilitare il comando `/feedback`. Il nome più vecchio `DISABLE_BUG_COMMAND` è anche accettato |

196| `DISABLE_GROWTHBOOK` | Imposta su `1` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato |199| `DISABLE_GROWTHBOOK` | Imposta su `1` per disabilitare il recupero dei flag di funzionalità GrowthBook e utilizzare i valori predefiniti del codice per ogni flag. La registrazione degli eventi di telemetria rimane attiva a meno che `DISABLE_TELEMETRY` non sia anche impostato |

197| `DISABLE_INSTALLATION_CHECKS` | Imposta su `1` per disabilitare gli avvisi di installazione. Utilizza solo quando gestite manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard |200| `DISABLE_INSTALLATION_CHECKS` | Imposta su `1` per disabilitare gli avvisi di installazione. Utilizza solo quando gestite manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard |


210| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta su `false` per disabilitare i [server MCP claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi |213| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta su `false` per disabilitare i [server MCP claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi |

211| `ENABLE_PROMPT_CACHING_1H` | Imposta su `1` per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, [Bedrock](/it/amazon-bedrock), [Vertex](/it/google-vertex-ai), [Foundry](/it/microsoft-foundry) e [Claude Platform on AWS](/it/claude-platform-on-aws). Gli utenti di abbonamento ricevono automaticamente il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più elevata |214| `ENABLE_PROMPT_CACHING_1H` | Imposta su `1` per richiedere un TTL della cache dei prompt di 1 ora invece dei 5 minuti predefiniti. Destinato agli utenti di chiave API, [Bedrock](/it/amazon-bedrock), [Vertex](/it/google-vertex-ai), [Foundry](/it/microsoft-foundry) e [Claude Platform on AWS](/it/claude-platform-on-aws). Gli utenti di abbonamento ricevono automaticamente il TTL di 1 ora. Le scritture della cache di 1 ora vengono fatturate a una tariffa più elevata |

212| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecato. Utilizza `ENABLE_PROMPT_CACHING_1H` invece |215| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecato. Utilizza `ENABLE_PROMPT_CACHING_1H` invece |

213| `ENABLE_TOOL_SEARCH` | Controlla la [ricerca degli strumenti MCP](/it/mcp#scale-with-mcp-tool-search). Non impostato: tutti gli strumenti MCP differiti per impostazione predefinita, ma caricati in primo piano su Vertex AI o quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. Valori: `true` (sempre differire e inviare l'intestazione beta, le richieste falliscono su Vertex AI o proxy che non supportano `tool_reference`), `auto` (modalità soglia: carica in primo piano se gli strumenti si adattano entro il 10% del contesto), `auto:N` (soglia personalizzata, ad es. `auto:5` per il 5%), `false` (carica tutto in primo piano) |216| `ENABLE_TOOL_SEARCH` | Controlla la [ricerca degli strumenti MCP](/it/mcp#scale-with-mcp-tool-search). Non impostato: tutti gli strumenti MCP differiti per impostazione predefinita, ma caricati in primo piano su Vertex AI o quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte. Valori: `true` (sempre differire e inviare l'intestazione beta, le richieste falliscono su modelli Vertex AI precedenti a Sonnet 4.5 o Opus 4.5, o su proxy che non supportano `tool_reference`), `auto` (modalità soglia: carica in primo piano se gli strumenti si adattano entro il 10% del contesto), `auto:N` (soglia personalizzata, ad es. `auto:5` per il 5%), `false` (carica tutto in primo piano) |

214| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta su qualsiasi valore non vuoto per attivare il fallback a [`--fallback-model`](/it/cli-reference#cli-flags) dopo errori di sovraccarico ripetuti su qualsiasi modello primario. Per impostazione predefinita, solo i modelli Opus attivano il fallback |217| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Imposta su qualsiasi valore non vuoto per attivare il fallback a [`--fallback-model`](/it/cli-reference#cli-flags) dopo errori di sovraccarico ripetuti su qualsiasi modello primario. Per impostazione predefinita, solo i modelli Opus attivano il fallback |

215| `FORCE_AUTOUPDATE_PLUGINS` | Imposta su `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER` |218| `FORCE_AUTOUPDATE_PLUGINS` | Imposta su `1` per forzare gli aggiornamenti automatici dei plugin anche quando l'auto-updater principale è disabilitato tramite `DISABLE_AUTOUPDATER` |

216| `FORCE_PROMPT_CACHING_5M` | Imposta su `1` per forzare il TTL della cache dei prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `ENABLE_PROMPT_CACHING_1H` |219| `FORCE_PROMPT_CACHING_5M` | Imposta su `1` per forzare il TTL della cache dei prompt di 5 minuti anche quando il TTL di 1 ora si applicherebbe altrimenti. Sostituisce `ENABLE_PROMPT_CACHING_1H` |


221| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di volte per riprovare quando la risposta del modello non supera la convalida rispetto a [`--json-schema`](/it/cli-reference#cli-flags) in modalità non interattiva (il flag `-p`). Per impostazione predefinita 5 |224| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di volte per riprovare quando la risposta del modello non supera la convalida rispetto a [`--json-schema`](/it/cli-reference#cli-flags) in modalità non interattiva (il flag `-p`). Per impostazione predefinita 5 |

222| `MAX_THINKING_TOKENS` | Sovrascrivi il budget del token di [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Il massimale è il [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) del modello meno uno. Imposta su `0` per disabilitare completamente il thinking. Sui modelli con [ragionamento adattivo](/it/model-config#adjust-effort-level), il budget viene ignorato a meno che il ragionamento adattivo non sia disabilitato tramite `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |225| `MAX_THINKING_TOKENS` | Sovrascrivi il budget del token di [extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Il massimale è il [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) del modello meno uno. Imposta su `0` per disabilitare completamente il thinking. Sui modelli con [ragionamento adattivo](/it/model-config#adjust-effort-level), il budget viene ignorato a meno che il ragionamento adattivo non sia disabilitato tramite `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` |

223| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali preconfigurate](/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |226| `MCP_CLIENT_SECRET` | Segreto client OAuth per i server MCP che richiedono [credenziali preconfigurate](/it/mcp#use-pre-configured-oauth-credentials). Evita il prompt interattivo quando si aggiunge un server con `--client-secret` |

224| `MCP_CONNECTION_NONBLOCKING` | Imposta su `true` in modalità non interattiva (`-p`) per saltare completamente l'attesa della connessione MCP. Utile per pipeline con script in cui gli strumenti MCP non sono necessari. Senza questa variabile, la prima query attende fino a 5 secondi per le connessioni del server `--mcp-config`. I server configurati con [`alwaysLoad: true`](/it/mcp#exempt-a-server-from-deferral) bloccano sempre l'avvio indipendentemente da questa variabile, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt |227| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio attende che i server MCP si connettano prima della prima query. {/* min-version: 2.1.142 */}A partire da Claude Code v2.1.142, l'avvio MCP è non-bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Imposta su `0` per ripristinare l'attesa di connessione bloccante di 5 secondi. I server configurati con [`alwaysLoad: true`](/it/mcp#exempt-a-server-from-deferral) bloccano comunque l'avvio indipendentemente, poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt |

225| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo la prima query attende, in millisecondi, per il batch di connessione MCP prima di acquisire uno snapshot dell'elenco degli strumenti (predefinito: 5000). I server ancora in sospeso alla scadenza continuano a connettersi in background ma non appariranno fino alla query successiva. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server. Più rilevante per le sessioni non interattive che emettono una singola query e hanno bisogno che i server a connessione lenta siano visibili |228| `MCP_CONNECT_TIMEOUT_MS` | Quanto tempo l'avvio bloccante attende, in millisecondi, per il batch di connessione prima di acquisire uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati [`alwaysLoad: true`](/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background ma non appariranno fino alla query successiva. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |

226| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con [credenziali preconfigurate](/it/mcp#use-pre-configured-oauth-credentials) |229| `MCP_OAUTH_CALLBACK_PORT` | Porta fissa per il callback di reindirizzamento OAuth, come alternativa a `--callback-port` quando si aggiunge un server MCP con [credenziali preconfigurate](/it/mcp#use-pre-configured-oauth-credentials) |

227| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |230| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP remoti (HTTP/SSE) da connettere in parallelo durante l'avvio (predefinito: 20) |

228| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |231| `MCP_SERVER_CONNECTION_BATCH_SIZE` | Numero massimo di server MCP locali (stdio) da connettere in parallelo durante l'avvio (predefinito: 3) |

errors.md +4 −2

Details

178 178 

179* Attendi l'ora di ripristino mostrata nell'errore179* Attendi l'ora di ripristino mostrata nell'errore

180* Esegui `/usage` per vedere i limiti del tuo piano e quando si ripristinano180* Esegui `/usage` per vedere i limiti del tuo piano e quando si ripristinano

181* Esegui `/extra-usage` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al tuo amministratore su Team ed Enterprise. Vedi [Extra usage for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per come viene fatturato.181* Esegui `/usage-credits` per acquistare utilizzo aggiuntivo su Pro e Max, o per richiederlo al tuo amministratore su Team ed Enterprise. Vedi [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) per come viene fatturato.

182* Per aggiornare il tuo piano per limiti di base più elevati, vedi [claude.com/pricing](https://claude.com/pricing)182* Per aggiornare il tuo piano per limiti di base più elevati, vedi [claude.com/pricing](https://claude.com/pricing)

183 183 

184Per controllare la tua indennità rimanente prima di raggiungere il limite, aggiungi i campi `rate_limits` a una [linea di stato personalizzata](/it/statusline#rate-limit-usage), o nell'app Desktop fai clic sull'[anello di utilizzo](/it/desktop#check-usage) accanto al selettore di modello.184Per controllare la tua indennità rimanente prima di raggiungere il limite, aggiungi i campi `rate_limits` a una [linea di stato personalizzata](/it/statusline#rate-limit-usage), o nell'app Desktop fai clic sull'[anello di utilizzo](/it/desktop#check-usage) accanto al selettore di modello.


203Hai raggiunto il limite di velocità configurato per la tua chiave API, il progetto Amazon Bedrock o il progetto Google Vertex AI.203Hai raggiunto il limite di velocità configurato per la tua chiave API, il progetto Amazon Bedrock o il progetto Google Vertex AI.

204 204 

205```text theme={null}205```text theme={null}

206API Error: Request rejected (429) · this may be a temporary capacity issue206API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

207```207```

208 208 

209La frase finale indica dove controllare l'integrità del servizio e varia in base al provider. Le configurazioni Bedrock e Vertex AI indicano lo stato del servizio di quel provider invece della pagina di stato Anthropic.

210 

209**Cosa fare:**211**Cosa fare:**

210 212 

211* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` casuale nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.213* Esegui `/status` e conferma che la credenziale attiva è quella che ti aspetti. Un `ANTHROPIC_API_KEY` casuale nel tuo ambiente può instradare le richieste attraverso una chiave di livello inferiore invece del tuo abbonamento.

fast-mode.md +14 −48

Details

12 12 

13La modalità veloce è una configurazione ad alta velocità per Claude Opus, che rende il modello 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 Claude Opus, che rende il modello 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à, solo risposte più veloci. La modalità veloce è supportata su Opus 4.6 e Opus 4.7. Non è disponibile su Sonnet, Haiku o altri modelli.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 4.7 e Opus 4.6. Non è disponibile su Sonnet, Haiku o altri modelli.

16 16 

17<Note>17<Note>

18 La modalità veloce richiede Claude Code v2.1.36 o successivo. Controlla la tua versione con `claude --version`.18 La modalità veloce richiede Claude Code v2.1.36 o successivo. Controlla la tua versione con `claude --version`.


21Cosa sapere:21Cosa sapere:

22 22 

23* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. Disponibile anche tramite `/fast` nell'estensione Claude Code VS Code.23* Usa `/fast` per attivare/disattivare la modalità veloce in Claude Code CLI. Disponibile anche tramite `/fast` nell'estensione Claude Code VS Code.

24* Per impostazione predefinita, `/fast` viene eseguito su Opus 4.6. Per eseguire la modalità veloce su Opus 4.7, imposta la variabile di ambiente [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7).24* I prezzi della modalità veloce sono $30/$150 MTok sia su Opus 4.7 che su Opus 4.6.

25* I prezzi della modalità veloce sono \$30/150 MTok sia su Opus 4.6 che su Opus 4.7.

26* Disponibile per tutti gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise) e Claude Console.25* Disponibile per tutti gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise) e Claude Console.

27* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise), la modalità veloce è disponibile solo tramite utilizzo aggiuntivo e non è inclusa nei limiti di velocità dell'abbonamento.26* Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei limiti di velocità dell'abbonamento.

28 27 

29Questa pagina copre come [attivare/disattivare la modalità veloce](#toggle-fast-mode), [usare la modalità veloce su Opus 4.7](#use-fast-mode-on-opus-4-7), il [compromesso di costo](#understand-the-cost-tradeoff), [quando usarla](#decide-when-to-use-fast-mode), [requisiti](#requirements), [opt-in per sessione](#require-per-session-opt-in), e [comportamento dei limiti di velocità](#handle-rate-limits).28Questa pagina copre come [attivare/disattivare la modalità veloce](#toggle-fast-mode), il suo [compromesso di costo](#understand-the-cost-tradeoff), [quando usarla](#decide-when-to-use-fast-mode), [requisiti](#requirements), [opt-in per sessione](#require-per-session-opt-in), e [comportamento dei limiti di velocità](#handle-rate-limits).

30 29 

31## Attiva/disattiva la modalità veloce30## Attiva/disattiva la modalità veloce

32 31 


41 40 

42Quando abiliti la modalità veloce:41Quando abiliti la modalità veloce:

43 42 

44* Se sei su un modello diverso, Claude Code passa automaticamente al modello della modalità veloce: Opus 4.6 per impostazione predefinita, oppure Opus 4.7 quando [`CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE`](#use-fast-mode-on-opus-4-7) è impostato.43* Se sei su un modello diverso, Claude Code passa automaticamente a Opus

45* Vedrai un messaggio di conferma: "Fast mode ON"44* Vedrai un messaggio di conferma: "Fast mode ON"

46* Un piccolo icona `↯` appare accanto al prompt mentre la modalità veloce è attiva45* Un piccolo icona `↯` appare accanto al prompt mentre la modalità veloce è attiva

47* Esegui `/fast` di nuovo in qualsiasi momento per verificare se la modalità veloce è attiva o disattiva46* Esegui `/fast` di nuovo in qualsiasi momento per verificare se la modalità veloce è attiva o disattiva

48 47 

49Quando disabiliti la modalità veloce con `/fast` di nuovo, rimani sulla stessa versione di Opus su cui era in esecuzione la modalità veloce. Il modello non torna al tuo modello precedente. Per passare a un modello diverso, usa `/model`.48Quando disabiliti la modalità veloce con `/fast` di nuovo, rimani su Opus. Il modello non torna al tuo modello precedente. Per passare a un modello diverso, usa `/model`.

50 49 

51## Usa la modalità veloce su Opus 4.750Opus 4.7 è il valore predefinito della modalità veloce in Claude Code v2.1.142 e successivo. Per fissare la modalità veloce a Opus 4.6, imposta `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`.

52 

53<Note>

54 La modalità veloce su Opus 4.7 richiede Claude Code v2.1.139 o successivo.

55</Note>

56 

57La modalità veloce per Claude Opus 4.7 è in anteprima di ricerca. Viene eseguita alla stessa velocità 2,5x e allo stesso prezzo della modalità veloce per Opus 4.6, senza altri cambiamenti di comportamento.

58 

59<Note>

60 Il 14 maggio 2026, Opus 4.7 diventa il modello predefinito della modalità veloce. Fino ad allora, accedi impostando `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1`.

61</Note>

62 

63Per accedere, imposta `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1` prima di avviare Claude Code. Con la variabile impostata, `/fast` viene eseguito su Opus 4.7. Senza di essa, `/fast` continua a essere eseguito su Opus 4.6.

64 

65Puoi impostare la variabile come esportazione shell:

66 

67```bash theme={null}

68export CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE=1

69```

70 

71Oppure in qualsiasi [file di impostazioni](/it/settings#settings-files) di Claude Code, incluse le impostazioni utente, progetto e gestite, per limitare l'accesso:

72 

73```json theme={null}

74{

75 "env": {

76 "CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE": "1"

77 }

78}

79```

80 

81La modalità veloce per Opus 4.6 rimane disponibile insieme a Opus 4.7. I due condividono lo stesso pool di limiti di velocità della modalità veloce: l'utilizzo su entrambi i modelli attinge dagli stessi limiti.

82 

83Per fissare la modalità veloce su Opus 4.6 in modo esplicito, imposta `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1`. Questa variabile ha la precedenza, quindi la modalità veloce viene eseguita su Opus 4.6 indipendentemente dal fatto che `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` sia impostata.

84 51 

85## Comprendi il compromesso di costo52## Comprendi il compromesso di costo

86 53 

87La modalità veloce ha un prezzo per token più elevato rispetto a Opus standard:54La modalità veloce ha un prezzo per token più elevato rispetto a Opus standard:

88 55 

89| Modalità | Input (MTok) | Output (MTok) |56| Modalità | Input (MTok) | Output (MTok) |

90| --------------------------- | ------------ | ------------- |57| --------------- | ------------ | ------------- |

91| Modalità veloce su Opus 4.6 | \$30 | \$150 |58| Modalità veloce | \$30 | \$150 |

92| Modalità veloce su Opus 4.7 | \$30 | \$150 |

93 59 

94I prezzi della modalità veloce sono fissi su tutta la finestra di contesto di 1M token.60I prezzi della modalità veloce sono fissi su tutta la finestra di contesto di 1M token.

95 61 


124 90 

125La modalità veloce richiede tutti i seguenti elementi:91La modalità veloce richiede tutti i seguenti elementi:

126 92 

127* **Non disponibile su provider cloud di terze parti**: la modalità veloce non è disponibile su Amazon Bedrock, Google Vertex AI o Microsoft Azure Foundry. La modalità veloce è disponibile tramite l'API Anthropic Console e per i piani di abbonamento Claude utilizzando l'utilizzo aggiuntivo.93* **Non disponibile su provider cloud di terze parti**: la modalità veloce non è disponibile su Amazon Bedrock, Google Vertex AI o Microsoft Azure Foundry. La modalità veloce è disponibile tramite l'API Anthropic Console e per i piani di abbonamento Claude utilizzando i crediti di utilizzo.

128* **Utilizzo aggiuntivo abilitato**: il tuo account deve avere l'utilizzo aggiuntivo abilitato, che consente la fatturazione oltre l'utilizzo incluso nel tuo piano. Per gli account individuali, abilita questo nelle tue [impostazioni di fatturazione della Console](https://platform.claude.com/settings/organization/billing). Per Team e Enterprise, un amministratore deve abilitare l'utilizzo aggiuntivo per l'organizzazione.94* **Crediti di utilizzo abilitati**: il tuo account deve avere i crediti di utilizzo abilitati, che consente la fatturazione oltre l'utilizzo incluso nel tuo piano. Per gli account individuali, abilita questo nelle tue [impostazioni di fatturazione della Console](https://platform.claude.com/settings/organization/billing). Per Team e Enterprise, un amministratore deve abilitare i crediti di utilizzo per l'organizzazione.

129 95 

130<Note>96<Note>

131 L'utilizzo della modalità veloce viene fatturato direttamente all'utilizzo aggiuntivo, anche se hai un utilizzo rimanente nel tuo piano. Ciò significa che i token della modalità veloce non contano rispetto all'utilizzo incluso nel tuo piano e vengono addebitati alla tariffa della modalità veloce dal primo token.97 L'utilizzo della modalità veloce viene fatturato direttamente dai crediti di utilizzo, anche se hai un utilizzo rimanente nel tuo piano. Ciò significa che i token della modalità veloce non contano rispetto all'utilizzo incluso nel tuo piano e vengono addebitati alla tariffa della modalità veloce dal primo token.

132</Note>98</Note>

133 99 

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


160 126 

161## Gestisci i limiti di velocità127## Gestisci i limiti di velocità

162 128 

163La modalità veloce ha limiti di velocità separati da Opus standard. La modalità veloce per Opus 4.6 e Opus 4.7 condividono lo stesso pool di limiti di velocità: l'utilizzo su entrambi i modelli attinge dagli stessi limiti. Quando raggiungi il limite di velocità della modalità veloce o esaurisci l'utilizzo aggiuntivo:129La modalità veloce ha limiti di velocità separati da Opus standard. La modalità veloce per Opus 4.7 e Opus 4.6 condividono lo stesso pool di limiti di velocità: l'utilizzo su entrambi i modelli attinge dagli stessi limiti. Quando raggiungi il limite di velocità della modalità veloce o esaurisci i crediti di utilizzo:

164 130 

1651. La modalità veloce torna automaticamente alla velocità standard sulla stessa versione di Opus1311. La modalità veloce torna automaticamente alla velocità standard

1662. L'icona `↯` diventa grigia per indicare il raffreddamento1322. L'icona `↯` diventa grigia per indicare il raffreddamento

1673. Continui a lavorare a velocità e prezzi standard1333. Continui a lavorare a velocità e prezzi standard

1684. Quando il raffreddamento scade, la modalità veloce si riabilita automaticamente1344. Quando il raffreddamento scade, la modalità veloce si riabilita automaticamente

Details

271 271 

272 **Cosa si carica:** Contesto fresco e isolato contenente:272 **Cosa si carica:** Contesto fresco e isolato contenente:

273 273 

274 * Il prompt di sistema (condiviso con il genitore per l'efficienza della cache)274 * Il prompt di sistema dell'agente, non il prompt di sistema completo di Claude Code

275 * Contenuto completo delle skills elencate nel campo `skills:` dell'agente275 * Contenuto completo delle skills elencate nel campo `skills:` dell'agente

276 * CLAUDE.md e stato git (ereditati dal genitore)276 * CLAUDE.md e stato git, eccetto gli agenti Explore e Plan integrati [che omettono entrambi](/it/sub-agents#what-loads-at-startup)

277 * Qualsiasi contesto che l'agente principale passa nel prompt277 * Qualsiasi contesto che l'agente principale passa nel prompt

278 278 

279 **Costo del contesto:** Isolato dalla sessione principale. I subagents non ereditano la vostra cronologia di conversazione o le skills invocate.279 **Costo del contesto:** Isolato dalla sessione principale. I subagents non ereditano la vostra cronologia di conversazione o le skills invocate.

hooks.md +1 −1

Details

732# Hook di notifica: avvisa il desktop quando Claude Code ha bisogno di attenzione.732# Hook di notifica: avvisa il desktop quando Claude Code ha bisogno di attenzione.

733input=$(cat)733input=$(cat)

734title="Claude Code'734title="Claude Code'

735body=$(jq -r '.message // 'Needs your attention"' <<<"$input")735body=$(jq -r '.message // 'Needs your attention'' <<<"$input")

736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")736seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'737jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

738```738```

hooks-guide.md +5 −3

Details

910* Verificate che il vostro JSON sia valido (le virgole finali e i commenti non sono consentiti)910* Verificate che il vostro JSON sia valido (le virgole finali e i commenti non sono consentiti)

911* Confermate che il file di impostazioni è nella posizione corretta: `.claude/settings.json` per gli hook del progetto, `~/.claude/settings.json` per gli hook globali911* Confermate che il file di impostazioni è nella posizione corretta: `.claude/settings.json` per gli hook del progetto, `~/.claude/settings.json` per gli hook globali

912 912 

913### L'hook Stop si esegue per sempre913### L'hook Stop colpisce il limite di blocco

914 914 

915Claude continua a lavorare in un ciclo infinito invece di fermarsi.915Claude continua a lavorare invece di fermarsi, quindi termina il turno con un avviso che l'hook Stop ha bloccato troppe volte consecutive.

916 916 

917Il vostro script di hook Stop deve controllare se ha già attivato una continuazione. Analizzate il campo `stop_hook_active` dall'input JSON e uscite presto se è `true`:917Claude Code ignora un hook Stop dopo che ha bloccato 8 volte di fila senza progresso. Il vostro script di hook deve controllare se ha già attivato una continuazione. Analizzate il campo `stop_hook_active` dall'input JSON e uscite presto se è `true`:

918 918 

919```bash theme={null}919```bash theme={null}

920#!/bin/bash920#!/bin/bash


925# ... rest of your hook logic925# ... rest of your hook logic

926```926```

927 927 

928Se il vostro hook ha legittimamente bisogno di più di otto iterazioni per convergere, aumentate il limite con [`CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`](/it/env-vars).

929 

928### Convalida JSON non riuscita930### Convalida JSON non riuscita

929 931 

930Claude Code mostra un errore di analisi JSON anche se il vostro script di hook produce JSON valido.932Claude Code mostra un errore di analisi JSON anche se il vostro script di hook produce JSON valido.

mcp.md +3 −1

Details

143 143 

144Il pannello `/mcp` mostra il conteggio degli strumenti accanto a ogni server connesso e contrassegna i server che pubblicizzano la capacità degli strumenti ma non espongono alcuno strumento.144Il pannello `/mcp` mostra il conteggio degli strumenti accanto a ogni server connesso e contrassegna i server che pubblicizzano la capacità degli strumenti ma non espongono alcuno strumento.

145 145 

146Se la vostra richiesta ha bisogno di strumenti da un server che è ancora in fase di connessione in background, Claude attende quel server prima di continuare. Con la [ricerca degli strumenti](#scale-with-mcp-tool-search) abilitata, che è l'impostazione predefinita, l'attesa avviene all'interno della chiamata `ToolSearch`. Nelle configurazioni senza ricerca degli strumenti, come Vertex AI, un `ANTHROPIC_BASE_URL` personalizzato, o `ENABLE_TOOL_SEARCH=false`, Claude utilizza lo strumento `WaitForMcpServers` invece.

147 

146Il nome del server `workspace` è riservato per uso interno. Se la vostra configurazione definisce un server con quel nome, Claude Code lo salta al momento del caricamento e mostra un avviso chiedendovi di rinominarlo.148Il nome del server `workspace` è riservato per uso interno. Se la vostra configurazione definisce un server con quel nome, Claude Code lo salta al momento del caricamento e mostra un avviso chiedendovi di rinominarlo.

147 149 

148### Aggiornamenti dinamici degli strumenti150### Aggiornamenti dinamici degli strumenti


1007 1009 

1008Il campo `alwaysLoad` è disponibile su tutti i tipi di server e richiede Claude Code v2.1.121 o successivo. Un server MCP può anche contrassegnare singoli strumenti come sempre caricati includendo `"anthropic/alwaysLoad": true` nell'oggetto `_meta` dello strumento, che ha lo stesso effetto solo per quello strumento.1010Il campo `alwaysLoad` è disponibile su tutti i tipi di server e richiede Claude Code v2.1.121 o successivo. Un server MCP può anche contrassegnare singoli strumenti come sempre caricati includendo `"anthropic/alwaysLoad": true` nell'oggetto `_meta` dello strumento, che ha lo stesso effetto solo per quello strumento.

1009 1011 

1010L'impostazione di `alwaysLoad: true` blocca anche l'avvio fino a quando il server non si connette, limitato al timeout di connessione standard di 5 secondi. Questo si applica anche quando [`MCP_CONNECTION_NONBLOCKING=1`](/it/env-vars) è impostato, poiché gli strumenti devono essere presenti quando viene costruito il primo prompt. Gli altri server si connettono ancora in background quando il nonblocking è abilitato.1012L'impostazione di `alwaysLoad: true` blocca anche l'avvio fino a quando il server non si connette, limitato al timeout di connessione standard di 5 secondi. Questo si applica anche se MCP startup è altrimenti [non-blocking per impostazione predefinita](/it/env-vars), poiché gli strumenti devono essere presenti quando viene costruito il primo prompt. Gli altri server continuano a connettersi in background.

1011 1013 

1012## Utilizza i prompt MCP come comandi1014## Utilizza i prompt MCP come comandi

1013 1015 

model-config.md +2 −2

Details

284È possibile utilizzare le seguenti variabili di ambiente, che devono essere **nomi di modelli** completi (o equivalenti per il provider API), per controllare i nomi dei modelli a cui gli alias si mappano.284È possibile utilizzare le seguenti variabili di ambiente, che devono essere **nomi di modelli** completi (o equivalenti per il provider API), per controllare i nomi dei modelli a cui gli alias si mappano.

285 285 

286| Variabile di ambiente | Descrizione |286| Variabile di ambiente | Descrizione |

287| -------------------------------- | ------------------------------------------------------------------------------------------------------ |287| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Il modello da utilizzare per `opus`, o per `opusplan` quando Plan Mode è attivo. |288| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Il modello da utilizzare per `opus`, o per `opusplan` quando Plan Mode è attivo. |

289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Il modello da utilizzare per `sonnet`, o per `opusplan` quando Plan Mode non è attivo. |289| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Il modello da utilizzare per `sonnet`, o per `opusplan` quando Plan Mode non è attivo. |

290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da utilizzare per `haiku`, o [funzionalità in background](/it/costs#background-token-usage) |290| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Il modello da utilizzare per `haiku`, o [funzionalità in background](/it/costs#background-token-usage) |

291| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello da utilizzare per [subagents](/it/sub-agents) |291| `CLAUDE_CODE_SUBAGENT_MODEL` | Il modello da utilizzare per tutti i [subagents](/it/sub-agents#choose-a-model). Sostituisce sia il parametro `model` per invocazione che il frontmatter `model` della definizione del subagent |

292 292 

293Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di `ANTHROPIC_DEFAULT_HAIKU_MODEL`.293Nota: `ANTHROPIC_SMALL_FAST_MODEL` è deprecato a favore di `ANTHROPIC_DEFAULT_HAIKU_MODEL`.

294 294 

overview.md +1 −1

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Panoramica di Claude Code5# Panoramica

6 6 

7> Claude Code è uno strumento di codifica agentivo che legge la tua base di codice, modifica i file, esegue comandi e si integra con i tuoi strumenti di sviluppo. Disponibile nel tuo terminale, IDE, app desktop e browser.7> Claude Code è uno strumento di codifica agentivo che legge la tua base di codice, modifica i file, esegue comandi e si integra con i tuoi strumenti di sviluppo. Disponibile nel tuo terminale, IDE, app desktop e browser.

8 8 

Details

73 | Auto mode | `auto` |73 | Auto mode | `auto` |

74 | Bypass permissions | `bypassPermissions` |74 | Bypass permissions | `bypassPermissions` |

75 75 

76 Auto mode appare nell'indicatore di modalità dopo che hai abilitato **Allow dangerously skip permissions** nelle impostazioni dell'estensione, ma rimane non disponibile fino a quando il tuo account non soddisfa ogni requisito elencato nella [sezione della modalità auto](#eliminate-prompts-with-auto-mode). L'impostazione `claudeCode.initialPermissionMode` non accetta `auto`; per avviare in modalità auto per impostazione predefinita, imposta `defaultMode` nel tuo [`settings.json`](/it/settings#settings-files) di Claude Code.76 Auto mode appare nell'indicatore di modalità dopo che hai abilitato **Allow dangerously skip permissions** nelle impostazioni dell'estensione, ma rimane non disponibile fino a quando il tuo account non soddisfa ogni requisito elencato nella [sezione della modalità auto](#eliminate-prompts-with-auto-mode). L'impostazione `claudeCode.initialPermissionMode` non accetta `auto`. Per avviare in modalità auto per impostazione predefinita, imposta `defaultMode` nelle tue [impostazioni utente](/it/settings#settings-files). Claude Code ignora `defaultMode: "auto"` nelle impostazioni di progetto e locali.

77 77 

78 Bypass permissions richiede anche l'interruttore **Allow dangerously skip permissions** prima che appaia nell'indicatore di modalità.78 Bypass permissions richiede anche l'interruttore **Allow dangerously skip permissions** prima che appaia nell'indicatore di modalità.

79 79 


179 179 

180Se Claude Code segnala auto mode come non disponibile, uno di questi requisiti non è soddisfatto; questo non è un'interruzione transitoria. Un messaggio separato che nomina un modello e dice che auto mode "non può determinare la sicurezza" di un'azione è un'interruzione transitoria del classificatore; vedi il [riferimento degli errori](/it/errors#auto-mode-cannot-determine-the-safety-of-an-action).180Se Claude Code segnala auto mode come non disponibile, uno di questi requisiti non è soddisfatto; questo non è un'interruzione transitoria. Un messaggio separato che nomina un modello e dice che auto mode "non può determinare la sicurezza" di un'azione è un'interruzione transitoria del classificatore; vedi il [riferimento degli errori](/it/errors#auto-mode-cannot-determine-the-safety-of-an-action).

181 181 

182Se imposti `defaultMode: "auto"` nelle [impostazioni](/it/settings#available-settings) e la sessione inizia in modalità `default` senza errore, l'impostazione è probabilmente in `.claude/settings.json` o `.claude/settings.local.json`. Claude Code ignora `auto` da questi file quindi un repository non può concedere a se stesso auto mode. Spostalo in `~/.claude/settings.json`.

183 

182### Cosa blocca il classificatore per impostazione predefinita184### Cosa blocca il classificatore per impostazione predefinita

183 185 

184Il classificatore si fida della tua directory di lavoro e dei remoti configurati del tuo repo. Tutto il resto è trattato come esterno fino a quando non [configuri l'infrastruttura attendibile](/it/auto-mode-config).186Il classificatore si fida della tua directory di lavoro e dei remoti configurati del tuo repo. Tutto il resto è trattato come esterno fino a quando non [configuri l'infrastruttura attendibile](/it/auto-mode-config).


231 233 

232 All'ingresso in auto mode, le regole allow ampie che concedono l'esecuzione arbitraria di codice vengono eliminate:234 All'ingresso in auto mode, le regole allow ampie che concedono l'esecuzione arbitraria di codice vengono eliminate:

233 235 

234 * Blanket `Bash(*)`236 * Blanket `Bash(*)` o `PowerShell(*)`

235 * Interpreti con wildcard come `Bash(python*)`237 * Interpreti con wildcard come `Bash(python*)`

236 * Comandi di esecuzione del gestore di pacchetti238 * Comandi di esecuzione del gestore di pacchetti

237 * Regole `Agent` allow239 * Regole `Agent` allow

Details

114 114 

115Quando disinstalli l'ultimo plugin che vincola una dipendenza, la dipendenza non viene più mantenuta e riprende a tracciare la sua voce del marketplace al prossimo aggiornamento.115Quando disinstalli l'ultimo plugin che vincola una dipendenza, la dipendenza non viene più mantenuta e riprende a tracciare la sua voce del marketplace al prossimo aggiornamento.

116 116 

117## Abilita o disabilita un plugin con dipendenze

118 

119L'abilitazione di un plugin abilita anche i plugin da cui dipende, e la disabilitazione di un plugin è bloccata se un altro plugin abilitato ne ha ancora bisogno. Entrambi i comportamenti richiedono Claude Code v2.1.143 o successivo. Le versioni precedenti abilitano o disabilitano solo il plugin denominato e visualizzano un errore `dependency-unsatisfied` al prossimo caricamento.

120 

121Quando abiliti un plugin, Claude Code abilita anche le sue dipendenze nello stesso ambito. Se una dipendenza ha le sue dipendenze, Claude Code abilita anche quelle. Il messaggio di successo elenca cos'altro è stato abilitato insieme al plugin che hai denominato. Se una dipendenza non può essere abilitata, il comando rifiuta e ti dice cosa sta bloccando e come risolvere:

122 

123| Condizione | Risultato |

124| :---------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

125| Una dipendenza non è installata | L'abilitazione fallisce e stampa il comando `claude plugin install` per ogni dipendenza mancante. |

126| Una dipendenza è bloccata dalla politica dei plugin della tua organizzazione | L'abilitazione fallisce e nomina la dipendenza bloccata. |

127| Una dipendenza è impostata su `false` a un ambito con precedenza più alta dell'ambito di destinazione | L'abilitazione fallisce. Abilita la dipendenza a quell'ambito, o passa `--scope` per scrivere lì. |

128| Tutte le dipendenze sono installate e consentite | L'abilitazione ha successo e scrive `true` per il plugin e ogni dipendenza che non era già abilitata all'ambito di destinazione. |

129 

130Quando disabiliti un plugin, Claude Code rifiuta se un altro plugin abilitato ne dipende ancora. L'errore nomina i plugin che ne dipendono e ti fornisce un comando concatenato che li disabilita nell'ordine corretto, terminando con quello che hai richiesto.

131 

132Ad esempio, se `deploy-kit` dipende da `secrets-vault`, la disabilitazione di `secrets-vault` da sola fallisce con un output simile al seguente:

133 

134```text theme={null}

135secrets-vault is still required by deploy-kit. Disable that plugin first, or

136disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

137```

138 

139Copia il comando concatenato dall'errore per disabilitare l'intero set in un unico passaggio.

140 

117## Rimuovi le dipendenze auto-installate orfane141## Rimuovi le dipendenze auto-installate orfane

118 142 

119Le dipendenze auto-installate rimangono su disco dopo che i plugin che le hanno installate vengono disinstallati, nel caso in cui tu voglia reinstallare un plugin dipendente o desideri continuare a utilizzare la dipendenza direttamente. Per pulirle, esegui `claude plugin prune` per elencare le dipendenze auto-installate che non hanno più alcun plugin installato che le richiede e rimuoverle dopo un prompt di conferma. Questo richiede Claude Code v2.1.121 o successivo.143Le dipendenze auto-installate rimangono su disco dopo che i plugin che le hanno installate vengono disinstallati, nel caso in cui tu voglia reinstallare un plugin dipendente o desideri continuare a utilizzare la dipendenza direttamente. Per pulirle, esegui `claude plugin prune` per elencare le dipendenze auto-installate che non hanno più alcun plugin installato che le richiede e rimuoverle dopo un prompt di conferma. Questo richiede Claude Code v2.1.121 o successivo.

Details

161| `plugins` | array | Elenco dei plugin disponibili | Vedi di seguito |161| `plugins` | array | Elenco dei plugin disponibili | Vedi di seguito |

162 162 

163<Note>163<Note>

164 **Nomi riservati**: I seguenti nomi di marketplace sono riservati per uso ufficiale di Anthropic e non possono essere utilizzati da marketplace di terze parti: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `knowledge-work-plugins`, `life-sciences`. Anche i nomi che impersonano marketplace ufficiali (come `official-claude-plugins` o `anthropic-tools-v2`) sono bloccati.164 **Nomi riservati**: I seguenti nomi di marketplace sono riservati per uso ufficiale di Anthropic e non possono essere utilizzati da marketplace di terze parti: `claude-code-marketplace`, `claude-code-plugins`, `claude-plugins-official`, `anthropic-marketplace`, `anthropic-plugins`, `agent-skills`, `anthropic-agent-skills`, `knowledge-work-plugins`, `life-sciences`. Anche i nomi che impersonano marketplace ufficiali, come `official-claude-plugins` o `anthropic-tools-v2`, sono bloccati.

165</Note>165</Note>

166 166 

167### Campi del proprietario167### Campi del proprietario


199**Campi di metadati standard:**199**Campi di metadati standard:**

200 200 

201| Campo | Tipo | Descrizione |201| Campo | Tipo | Descrizione |

202| :------------ | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |202| :------------ | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

203| `displayName` | string | {/* min-version: 2.1.143 */}Nome leggibile mostrato nelle superfici dell'interfaccia utente. Ritorna a `name` quando omesso. Può contenere spazi e qualsiasi maiuscola/minuscola. Non utilizzato per il namespacing o la ricerca. Richiede Claude Code v2.1.143 o successivo. |

203| `description` | string | Breve descrizione del plugin |204| `description` | string | Breve descrizione del plugin |

204| `version` | string | Versione del plugin. Se impostato (qui o in `plugin.json`), il plugin è bloccato a questa stringa e gli utenti ricevono aggiornamenti solo quando cambia. Ometti per tornare al SHA del commit git. Vedi [Version resolution](#version-resolution-and-release-channels). |205| `version` | string | Versione del plugin. Se impostato (qui o in `plugin.json`), il plugin è bloccato a questa stringa e gli utenti ricevono aggiornamenti solo quando cambia. Ometti per tornare allo SHA del commit git. Vedi [Version resolution](#version-resolution-and-release-channels). |

205| `author` | object | Informazioni sull'autore del plugin (`name` obbligatorio, `email` opzionale) |206| `author` | object | Informazioni sull'autore del plugin (`name` obbligatorio, `email` opzionale) |

206| `homepage` | string | URL della homepage o della documentazione del plugin |207| `homepage` | string | URL della homepage o della documentazione del plugin |

207| `repository` | string | URL del repository del codice sorgente |208| `repository` | string | URL del repository del codice sorgente |

Details

20 20 

21I plugin aggiungono skills a Claude Code, creando scorciatoie `/name` che Lei o Claude potete invocare.21I plugin aggiungono skills a Claude Code, creando scorciatoie `/name` che Lei o Claude potete invocare.

22 22 

23**Posizione**: Directory `skills/` o `commands/` nella radice del plugin23**Posizione**: Directory `skills/` o `commands/` nella radice del plugin, o un singolo file `SKILL.md` nella radice del plugin

24 24 

25**Formato file**: Le skills sono directory con `SKILL.md`; i comandi sono semplici file markdown25**Formato file**: Le skills sono directory con `SKILL.md`; i comandi sono semplici file markdown

26 26 


367```json theme={null}367```json theme={null}

368{368{

369 "name": "plugin-name",369 "name": "plugin-name",

370 "displayName": "Plugin Name",

370 "version": "1.2.0",371 "version": "1.2.0",

371 "description": "Brief plugin description",372 "description": "Brief plugin description",

372 "author": {373 "author": {


411| Campo | Tipo | Descrizione | Esempio |412| Campo | Tipo | Descrizione | Esempio |

412| :------------ | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |413| :------------ | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |

413| `$schema` | string | URL dello schema JSON per l'autocompletamento dell'editor e la convalida. Claude Code ignora questo campo al momento del caricamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |414| `$schema` | string | URL dello schema JSON per l'autocompletamento dell'editor e la convalida. Claude Code ignora questo campo al momento del caricamento. | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

415| `displayName` | string | {/* min-version: 2.1.143 */}Nome leggibile mostrato nel selettore `/plugin` e in altre superfici dell'interfaccia utente. Ricade su `name` quando omesso. A differenza di `name`, può contenere spazi e qualsiasi maiuscola/minuscola. Non utilizzato per lo spazio dei nomi o la ricerca. Richiede Claude Code v2.1.143 o successivo. | `"Deployment Tools"` |

414| `version` | string | Opzionale. Versione semantica. L'impostazione di questo valore fissa il plugin a quella stringa di versione, quindi gli utenti ricevono aggiornamenti solo quando la modifichi. Se omesso, Claude Code ricade sulla SHA del commit git, quindi ogni commit viene trattato come una nuova versione. Se impostato anche nella voce del marketplace, `plugin.json` ha priorità. Vedi [Gestione delle versioni](#version-management). | `"2.1.0"` |416| `version` | string | Opzionale. Versione semantica. L'impostazione di questo valore fissa il plugin a quella stringa di versione, quindi gli utenti ricevono aggiornamenti solo quando la modifichi. Se omesso, Claude Code ricade sulla SHA del commit git, quindi ogni commit viene trattato come una nuova versione. Se impostato anche nella voce del marketplace, `plugin.json` ha priorità. Vedi [Gestione delle versioni](#version-management). | `"2.1.0"` |

415| `description` | string | Breve spiegazione dello scopo del plugin | `"Deployment automation tools"` |417| `description` | string | Breve spiegazione dello scopo del plugin | `"Deployment automation tools"` |

416| `author` | object | Informazioni sull'autore | `{"name": "Dev Team", "email": "dev@company.com"}` |418| `author` | object | Informazioni sull'autore | `{"name": "Dev Team", "email": "dev@company.com"}` |


525* È possibile specificare più percorsi come array527* È possibile specificare più percorsi come array

526* Quando un percorso di skill punta a una directory che contiene direttamente un `SKILL.md`, ad esempio `"skills": ["./"]` che punta alla radice del plugin, il campo frontmatter `name` in `SKILL.md` determina il nome di invocazione della skill. Questo fornisce un nome stabile indipendentemente dalla directory di installazione. Se `name` non è impostato nel frontmatter, il nome della directory viene utilizzato come fallback.528* Quando un percorso di skill punta a una directory che contiene direttamente un `SKILL.md`, ad esempio `"skills": ["./"]` che punta alla radice del plugin, il campo frontmatter `name` in `SKILL.md` determina il nome di invocazione della skill. Questo fornisce un nome stabile indipendentemente dalla directory di installazione. Se `name` non è impostato nel frontmatter, il nome della directory viene utilizzato come fallback.

527 529 

530Un plugin che ha un `SKILL.md` alla sua radice, nessuna sottodirectory `skills/`, e nessun campo manifest `skills` viene caricato automaticamente come plugin a singola skill in Claude Code v2.1.142 e versioni successive. Non è necessario impostare `"skills": ["./"]` in `plugin.json` per questo layout. Il nome di invocazione della skill segue la stessa regola di cui sopra: il campo frontmatter `name`, o il nome della directory come fallback.

531 

528**Esempi di percorso**:532**Esempi di percorso**:

529 533 

530```json theme={null}534```json theme={null}


814 818 

815### plugin enable819### plugin enable

816 820 

817Abilita un plugin disabilitato.821Abilita un plugin disabilitato. Se il plugin dichiara [dipendenze](/it/plugin-dependencies), Claude Code le abilita transitivamente nello stesso ambito, e il comando fallisce quando una dipendenza non è installata.

818 822 

819```bash theme={null}823```bash theme={null}

820claude plugin enable <plugin> [options]824claude plugin enable <plugin> [options]


833 837 

834### plugin disable838### plugin disable

835 839 

836Disabilita un plugin senza disinstallarlo.840Disabilita un plugin senza disinstallarlo. Fallisce quando un altro plugin abilitato [dipende da](/it/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies) il target. Il messaggio di errore include un comando concatenato che disabilita prima ogni dipendente.

837 841 

838```bash theme={null}842```bash theme={null}

839claude plugin disable <plugin> [options]843claude plugin disable <plugin> [options]


889 893 

890### plugin details894### plugin details

891 895 

892Mostra l'inventario dei componenti di un plugin e il costo dei token previsto. L'output elenca tutti i componenti che il plugin contribuisce, raggruppati come Skills (skills e comandi), Agents, Hooks e server MCP, insieme a una stima di quanti token aggiunge a ogni sessione.896Mostra l'inventario dei componenti di un plugin e il costo dei token previsto. L'output elenca tutti i componenti che il plugin contribuisce, raggruppati come Skills, Agents, Hooks, server MCP e server LSP, insieme a una stima di quanti token aggiunge a ogni sessione. Il gruppo Skills include sia le voci `skills/` che `commands/`.

893 897 

894```bash theme={null}898```bash theme={null}

895claude plugin details <name>899claude plugin details <name>


922 Agents (0)926 Agents (0)

923 Hooks (1) (harness-only — no model context cost)927 Hooks (1) (harness-only — no model context cost)

924 MCP servers (0)928 MCP servers (0)

929 LSP servers (0)

925 930 

926Projected token cost931Projected token cost

927 Always-on: ~180 tok added to every session932 Always-on: ~180 tok added to every session

Details

188* **Il processo locale deve continuare a funzionare**: Remote Control viene eseguito come processo locale. Se chiudi il terminale, esci da VS Code, o altrimenti interrompi il processo `claude`, la sessione termina.188* **Il processo locale deve continuare a funzionare**: Remote Control viene eseguito come processo locale. Se chiudi il terminale, esci da VS Code, o altrimenti interrompi il processo `claude`, la sessione termina.

189* **Interruzione di rete prolungata**: se la tua macchina è accesa ma non riesce a raggiungere la rete per più di circa 10 minuti, la sessione scade e il processo esce. Esegui di nuovo `claude remote-control` per avviare una nuova sessione.189* **Interruzione di rete prolungata**: se la tua macchina è accesa ma non riesce a raggiungere la rete per più di circa 10 minuti, la sessione scade e il processo esce. Esegui di nuovo `claude remote-control` per avviare una nuova sessione.

190* **Ultraplan disconnette Remote Control**: avviare una sessione [ultraplan](/it/ultraplan) disconnette qualsiasi sessione Remote Control attiva perché entrambe le funzioni occupano l'interfaccia claude.ai/code e solo una può essere connessa alla volta.190* **Ultraplan disconnette Remote Control**: avviare una sessione [ultraplan](/it/ultraplan) disconnette qualsiasi sessione Remote Control attiva perché entrambe le funzioni occupano l'interfaccia claude.ai/code e solo una può essere connessa alla volta.

191* **Alcuni comandi sono solo locali**: i comandi che aprono un selettore interattivo nel terminale, come `/mcp`, `/plugin`, o `/resume`, funzionano solo dalla CLI locale. I comandi che producono output di testo, inclusi `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/extra-usage`, `/recap`, e `/reload-plugins`, funzionano da mobile e web.191* **Alcuni comandi sono solo locali**: i comandi che aprono un selettore interattivo nel terminale, come `/mcp`, `/plugin`, o `/resume`, funzionano solo dalla CLI locale. I comandi che producono output di testo, inclusi `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, e `/reload-plugins`, funzionano da mobile e web.

192 192 

193## Risoluzione dei problemi193## Risoluzione dei problemi

194 194 

Details

12 12 

13Le attività pianificate consentono a Claude di rieseguire automaticamente un prompt a intervalli regolari. Utilizzarle per eseguire il polling di una distribuzione, monitorare una PR, controllare una compilazione a lunga esecuzione o ricordarsi di fare qualcosa più tardi nella sessione. Per reagire agli eventi man mano che si verificano invece di eseguire il polling, vedere [Channels](/it/channels): il vostro CI può inviare il fallimento direttamente nella sessione. Per mantenere la sessione in funzione turno dopo turno fino al raggiungimento di una condizione piuttosto che a intervalli, vedere [`/goal`](/it/goal).13Le attività pianificate consentono a Claude di rieseguire automaticamente un prompt a intervalli regolari. Utilizzarle per eseguire il polling di una distribuzione, monitorare una PR, controllare una compilazione a lunga esecuzione o ricordarsi di fare qualcosa più tardi nella sessione. Per reagire agli eventi man mano che si verificano invece di eseguire il polling, vedere [Channels](/it/channels): il vostro CI può inviare il fallimento direttamente nella sessione. Per mantenere la sessione in funzione turno dopo turno fino al raggiungimento di una condizione piuttosto che a intervalli, vedere [`/goal`](/it/goal).

14 14 

15Le attività hanno ambito di sessione: vivono nella conversazione corrente e si interrompono quando si avvia una nuova. La ripresa con `--resume` o `--continue` ripristina qualsiasi attività che non sia [scaduta](#seven-day-expiry): un'attività ricorrente creata negli ultimi 7 giorni, oppure una singola la cui ora pianificata non è ancora passata. Per la pianificazione che sopravvive indipendentemente da qualsiasi sessione, utilizzare [Routines](/it/routines), [Attività pianificate Desktop](/it/desktop-scheduled-tasks) o [GitHub Actions](/it/github-actions).15Le attività hanno ambito di sessione: vivono nella conversazione corrente e si interrompono quando si avvia una nuova. La ripresa con `--resume` o `--continue` ripristina qualsiasi attività che non sia [scaduta](#seven-day-expiry): un'attività ricorrente creata negli ultimi 7 giorni, oppure una singola la cui ora pianificata non è ancora passata. Per la pianificazione che sopravvive indipendentemente da qualsiasi sessione, utilizzare [Routines](/it/routines) per creare una routine su infrastruttura gestita da Anthropic, configurare un'[Attività pianificata Desktop](/it/desktop-scheduled-tasks) o utilizzare [GitHub Actions](/it/github-actions).

16 16 

17## Confrontare le opzioni di pianificazione17## Confrontare le opzioni di pianificazione

18 18 

settings.md +6 −4

Details

224| `prUrlTemplate` | Modello di URL per il badge PR mostrato nel footer e nei riassunti dei risultati degli strumenti. Sostituisce `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` dall'URL PR segnalato da `gh`. Usa per puntare i link PR a uno strumento di revisione del codice interno invece di `github.com`. Non influisce sui link automatici `#123` nella prosa di Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |224| `prUrlTemplate` | Modello di URL per il badge PR mostrato nel footer e nei riassunti dei risultati degli strumenti. Sostituisce `{host}`, `{owner}`, `{repo}`, `{number}`, e `{url}` dall'URL PR segnalato da `gh`. Usa per puntare i link PR a uno strumento di revisione del codice interno invece di `github.com`. Non influisce sui link automatici `#123` nella prosa di Claude | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

225| `respectGitignore` | Controlla se il selettore di file `@` rispetta i modelli `.gitignore`. Quando `true` (predefinito), i file che corrispondono ai modelli `.gitignore` sono esclusi dai suggerimenti | `false` |225| `respectGitignore` | Controlla se il selettore di file `@` rispetta i modelli `.gitignore`. Quando `true` (predefinito), i file che corrispondono ai modelli `.gitignore` sono esclusi dai suggerimenti | `false` |

226| `showClearContextOnPlanAccept` | Mostra l'opzione "cancella contesto" nella schermata di accettazione del piano. Predefinito: `false`. Imposta a `true` per ripristinare l'opzione | `true` |226| `showClearContextOnPlanAccept` | Mostra l'opzione "cancella contesto" nella schermata di accettazione del piano. Predefinito: `false`. Imposta a `true` per ripristinare l'opzione | `true` |

227| `showThinkingSummaries` | Mostra i riassunti del [pensiero esteso](/it/model-config#extended-thinking) nelle sessioni interattive. Quando non impostato o `false` (predefinito in modalità interattiva), i blocchi di pensiero vengono redatti dall'API e mostrati come uno stub compresso. La redazione cambia solo quello che vedi, non quello che il modello genera: per ridurre la spesa di pensiero, [abbassa il budget o disabilita il pensiero](/it/model-config#extended-thinking) invece. La modalità non interattiva (`-p`) e i chiamanti SDK ricevono sempre i riassunti indipendentemente da questa impostazione | `true` |227| `showThinkingSummaries` | Mostra i riassunti del [pensiero esteso](/it/model-config#extended-thinking) nelle sessioni interattive. Quando non impostato o `false` (predefinito in modalità interattiva), i blocchi di pensiero vengono redatti dall'API e mostrati come uno stub compresso. La redazione cambia solo quello che vedi, non quello che il modello genera: per ridurre la spesa di pensiero, [abbassa il budget o disabilita il pensiero](/it/model-config#extended-thinking) invece. Questa impostazione non ha effetto in modalità non interattiva (`-p`), l'Agent SDK, o le estensioni IDE come VS Code | `true` |

228| `showTurnDuration` | Mostra i messaggi di durata del turno dopo le risposte, ad es. "Cooked for 1m 6s". Predefinito: `true`. Appare in `/config` come **Show turn duration** | `false` |228| `showTurnDuration` | Mostra i messaggi di durata del turno dopo le risposte, ad es. "Cooked for 1m 6s". Predefinito: `true`. Appare in `/config` come **Show turn duration** | `false` |

229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Frazione della finestra di contesto del modello riservata all'[elenco di skills](/it/skills#skill-descriptions-are-cut-short) che Claude vede ogni turno (predefinito: `0.01` = 1%). Quando l'elenco supera il budget, le descrizioni per gli skills meno utilizzati vengono compresse a soli nomi in modo che Claude possa comunque invocarli ma non vedrà il motivo. Aumenta per mantenere più descrizioni visibili al costo di più contesto per turno. `/doctor` mostra il conteggio di troncamento corrente e quali skills sono interessati. Richiede Claude Code v2.1.105 o successivo | `0.02` |229| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}Frazione della finestra di contesto del modello riservata all'[elenco di skills](/it/skills#skill-descriptions-are-cut-short) che Claude vede ogni turno (predefinito: `0.01` = 1%). Quando l'elenco supera il budget, le descrizioni per gli skills meno utilizzati vengono compresse a soli nomi in modo che Claude possa comunque invocarli ma non vedrà il motivo. Aumenta per mantenere più descrizioni visibili al costo di più contesto per turno. `/doctor` mostra il conteggio di troncamento corrente e quali skills sono interessati. Richiede Claude Code v2.1.105 o successivo | `0.02` |

230| `skillOverrides` | {/* min-version: 2.1.129 */}Override di visibilità per skill, con chiave il nome dello skill. Il valore è `"on"`, `"name-only"`, `"user-invocable-only"`, o `"off"`. Ti consente di nascondere o comprimere uno skill senza modificare il suo SKILL.md. Non si applica ai plugin skills, che vengono gestiti tramite `/plugin`. Il menu `/skills` scrive questi in `.claude/settings.local.json`. Vedi [Override della visibilità dello skill dalle impostazioni](/it/skills#override-skill-visibility-from-settings). Richiede Claude Code v2.1.129 o successivo | `{"legacy-context": "name-only", "deploy": "off"}` |230| `skillOverrides` | {/* min-version: 2.1.129 */}Override di visibilità per skill, con chiave il nome dello skill. Il valore è `"on"`, `"name-only"`, `"user-invocable-only"`, o `"off"`. Ti consente di nascondere o comprimere uno skill senza modificare il suo SKILL.md. Non si applica ai plugin skills, che vengono gestiti tramite `/plugin`. Il menu `/skills` scrive questi in `.claude/settings.local.json`. Vedi [Override della visibilità dello skill dalle impostazioni](/it/skills#override-skill-visibility-from-settings). Richiede Claude Code v2.1.129 o successivo | `{"legacy-context": "name-only", "deploy": "off"}` |


265Configura come `--worktree` crea e gestisce i git worktrees.265Configura come `--worktree` crea e gestisce i git worktrees.

266 266 

267| Chiave | Descrizione | Esempio |267| Chiave | Descrizione | Esempio |

268| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |268| :---------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

269| `worktree.baseRef` | Quale ref i nuovi worktrees si diramano da. `"fresh"` (predefinito) si dirama da `origin/<default-branch>` per un albero pulito che corrisponde al remoto. `"head"` si dirama dal tuo `HEAD` locale corrente, quindi i commit non spinti e lo stato del ramo di funzionalità sono presenti nel worktree. Si applica a `--worktree`, lo strumento `EnterWorktree`, e l'isolamento del subagent | `"head"` |269| `worktree.baseRef` | Quale ref i nuovi worktrees si diramano da. `"fresh"` (predefinito) si dirama da `origin/<default-branch>` per un albero pulito che corrisponde al remoto. `"head"` si dirama dal tuo `HEAD` locale corrente, quindi i commit non spinti e lo stato del ramo di funzionalità sono presenti nel worktree. Si applica a `--worktree`, lo strumento `EnterWorktree`, e l'isolamento del subagent | `"head"` |

270| `worktree.symlinkDirectories` | Directory da collegare simbolicamente dal repository principale in ogni worktree per evitare di duplicare grandi directory su disco. Nessuna directory viene collegata simbolicamente per impostazione predefinita | `["node_modules", ".cache"]` |270| `worktree.symlinkDirectories` | Directory da collegare simbolicamente dal repository principale in ogni worktree per evitare di duplicare grandi directory su disco. Nessuna directory viene collegata simbolicamente per impostazione predefinita | `["node_modules", ".cache"]` |

271| `worktree.sparsePaths` | Directory da estrarre in ogni worktree tramite git sparse-checkout. Solo i percorsi elencati più i file a livello di radice vengono scritti su disco, il che è più veloce nei grandi monorepo | `["packages/my-app", "shared/utils"]` |271| `worktree.sparsePaths` | Directory da estrarre in ogni worktree tramite git sparse-checkout. Solo i percorsi elencati più i file a livello di radice vengono scritti su disco, il che è più veloce nei grandi monorepo | `["packages/my-app", "shared/utils"]` |

272| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}Modalità di isolamento per le [sessioni in background](/it/agent-view#how-file-edits-are-isolated). `"worktree"` (predefinito) blocca `Edit`/`Write` nel checkout principale fino a quando non viene chiamato `EnterWorktree`. `"none"` consente ai lavori in background di modificare direttamente la copia di lavoro. Richiede Claude Code v2.1.143 o successivo | `"none"` |

272 273 

273Per copiare file gitignored come `.env` nei nuovi worktrees, usa un file [`.worktreeinclude`](/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto invece di un'impostazione.274Per copiare file gitignored come `.env` nei nuovi worktrees, usa un file [`.worktreeinclude`](/it/worktrees#copy-gitignored-files-into-worktrees) nella radice del tuo progetto invece di un'impostazione.

274 275 

275### Impostazioni di permesso276### Impostazioni di permesso

276 277 

277| Chiavi | Descrizione | Esempio |278| Chiavi | Descrizione | Esempio |

278| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |279| :---------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |

279| `allow` | Array di regole di permesso per consentire l'uso dello strumento. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) sottostante per i dettagli della corrispondenza dei modelli | `[ "Bash(git diff *)" ]` |280| `allow` | Array di regole di permesso per consentire l'uso dello strumento. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) sottostante per i dettagli della corrispondenza dei modelli | `[ "Bash(git diff *)" ]` |

280| `ask` | Array di regole di permesso per chiedere conferma all'uso dello strumento. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) sottostante | `[ "Bash(git push *)" ]` |281| `ask` | Array di regole di permesso per chiedere conferma all'uso dello strumento. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) sottostante | `[ "Bash(git push *)" ]` |

281| `deny` | Array di regole di permesso per negare l'uso dello strumento. Usa questo per escludere file sensibili dall'accesso di Claude Code. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) e [Limitazioni dei permessi Bash](/it/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |282| `deny` | Array di regole di permesso per negare l'uso dello strumento. Usa questo per escludere file sensibili dall'accesso di Claude Code. Vedi [Sintassi della regola di permesso](#permission-rule-syntax) e [Limitazioni dei permessi Bash](/it/permissions#tool-specific-permission-rules) | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

282| `additionalDirectories` | [Directory di lavoro](/it/permissions#working-directories) aggiuntive per l'accesso ai file. La maggior parte della configurazione `.claude/` [non viene scoperta](/it/permissions#additional-directories-grant-file-access-not-configuration) da queste directory | `[ "../docs/" ]` |283| `additionalDirectories` | [Directory di lavoro](/it/permissions#working-directories) aggiuntive per l'accesso ai file. La maggior parte della configurazione `.claude/` [non viene scoperta](/it/permissions#additional-directories-grant-file-access-not-configuration) da queste directory | `[ "../docs/" ]` |

283| `defaultMode` | [Modalità di permesso](/it/permission-modes) predefinita quando si apre Claude Code. Valori validi: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. Il flag CLI `--permission-mode` ignora questa impostazione per una singola sessione | `"acceptEdits"` |284| `defaultMode` | [Modalità di permesso](/it/permission-modes) predefinita quando si apre Claude Code. Valori validi: `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`. {/* min-version: 2.1.142 */}A partire da Claude Code v2.1.142, `auto` viene ignorato quando impostato nelle impostazioni di progetto o locale (`.claude/settings.json`, `.claude/settings.local.json`) in modo che un repository non possa concedere a se stesso la modalità auto. Impostalo invece in `~/.claude/settings.json`. Il flag CLI `--permission-mode` ignora questa impostazione per una singola sessione | `"acceptEdits"` |

284| `disableBypassPermissionsMode` | Imposta a `"disable"` per prevenire l'attivazione della modalità `bypassPermissions`. Disabilita il flag della riga di comando `--dangerously-skip-permissions`. Molto utile nelle [impostazioni gestite](/it/permissions#managed-settings) per applicare la politica organizzativa, ma funziona da qualsiasi ambito | `"disable"` |285| `disableBypassPermissionsMode` | Imposta a `"disable"` per prevenire l'attivazione della modalità `bypassPermissions`. Disabilita il flag della riga di comando `--dangerously-skip-permissions`. Molto utile nelle [impostazioni gestite](/it/permissions#managed-settings) per applicare la politica organizzativa, ma funziona da qualsiasi ambito | `"disable"` |

285| `skipDangerousModePermissionPrompt` | Salta il prompt di conferma mostrato prima di entrare nella modalità bypass dei permessi tramite `--dangerously-skip-permissions` o `defaultMode: "bypassPermissions"`. Ignorato quando impostato nelle impostazioni di progetto (`.claude/settings.json`) per prevenire che i repository non attendibili ignorino automaticamente il prompt | `true` |286| `skipDangerousModePermissionPrompt` | Salta il prompt di conferma mostrato prima di entrare nella modalità bypass dei permessi tramite `--dangerously-skip-permissions` o `defaultMode: "bypassPermissions"`. Ignorato quando impostato nelle impostazioni di progetto (`.claude/settings.json`) per prevenire che i repository non attendibili ignorino automaticamente il prompt | `true` |

286 287 


510 * Politiche distribuite da IT tramite consegna dal server, profili di configurazione MDM, politiche di registro, o file di impostazioni gestite511 * Politiche distribuite da IT tramite consegna dal server, profili di configurazione MDM, politiche di registro, o file di impostazioni gestite

511 * Non possono essere ignorate da nessun altro livello, inclusi gli argomenti della riga di comando512 * Non possono essere ignorate da nessun altro livello, inclusi gli argomenti della riga di comando

512 * All'interno del livello gestito, la precedenza è: gestite dal server > politiche MDM/a livello di sistema operativo > file-based (`managed-settings.d/*.json` + `managed-settings.json`) > registro HKCU (solo Windows). Viene utilizzata una sola fonte gestita; le fonti non si uniscono tra i livelli. All'interno del livello file-based, i file drop-in e il file base vengono uniti insieme.513 * All'interno del livello gestito, la precedenza è: gestite dal server > politiche MDM/a livello di sistema operativo > file-based (`managed-settings.d/*.json` + `managed-settings.json`) > registro HKCU (solo Windows). Viene utilizzata una sola fonte gestita; le fonti non si uniscono tra i livelli. All'interno del livello file-based, i file drop-in e il file base vengono uniti insieme.

514 * Gli host di incorporamento come Claude Desktop possono fornire politica tramite l'opzione SDK `managedSettings`. Per impostazione predefinita, questo viene ignorato quando è presente un livello gestito. Gli amministratori possono acconsentire impostando [`parentSettingsBehavior`](#available-settings) a `"merge"`. I valori dell'embedder vengono filtrati in modo che possano stringere la politica gestita ma non allentarla.

513 515 

5142. **Argomenti della riga di comando**5162. **Argomenti della riga di comando**

515 * Override temporanei per una sessione specifica. JSON passato tramite `--settings <file-or-json>` si unisce con le impostazioni basate su file utilizzando le stesse regole degli altri livelli: una chiave impostata qui ignora la stessa chiave nelle impostazioni locale, di progetto o utente, e omettere una chiave lascia il valore del livello inferiore in posizione517 * Override temporanei per una sessione specifica. JSON passato tramite `--settings <file-or-json>` si unisce con le impostazioni basate su file utilizzando le stesse regole degli altri livelli: una chiave impostata qui ignora la stessa chiave nelle impostazioni locale, di progetto o utente, e omettere una chiave lascia il valore del livello inferiore in posizione

skills.md +3 −3

Details

437Le skills e i [subagents](/it/sub-agents) funzionano insieme in due direzioni:437Le skills e i [subagents](/it/sub-agents) funzionano insieme in due direzioni:

438 438 

439| Approccio | System prompt | Attività | Carica anche |439| Approccio | System prompt | Attività | Carica anche |

440| :-------------------------- | :------------------------------------------ | :---------------------------- | :----------------------------- |440| :-------------------------- | :-------------------------- | :---------------------------- | :------------------------------------------------- |

441| Skill con `context: fork` | Dal tipo di agent (`Explore`, `Plan`, ecc.) | Contenuto di SKILL.md | CLAUDE.md |441| Skill con `context: fork` | Dal tipo di agent | Contenuto di SKILL.md | CLAUDE.md, eccetto quando l'agent è Explore o Plan |

442| Subagent con campo `skills` | Corpo markdown del subagent | Messaggio di delega di Claude | Skills precaricate + CLAUDE.md |442| Subagent con campo `skills` | Corpo markdown del subagent | Messaggio di delega di Claude | Skills precaricate + CLAUDE.md |

443 443 

444Con `context: fork`, scrivi l'attività nella tua skill e scegli un tipo di agent per eseguirla. Per l'inverso (definire un subagent personalizzato che usa le skills come materiale di riferimento), vedi [Subagents](/it/sub-agents#preload-skills-into-subagents).444Con `context: fork`, scrivi l'attività nella tua skill e scegli un tipo di agent per eseguirla. Gli agent integrati Explore e Plan [saltano CLAUDE.md e git status](/it/sub-agents#what-loads-at-startup) per mantenere il loro contesto piccolo, quindi una skill con fork che utilizza `agent: Explore` vede solo il contenuto di SKILL.md e il system prompt dell'agent stesso. Per l'inverso, dove definisci un subagent personalizzato che usa le skills come materiale di riferimento, vedi [Subagents](/it/sub-agents#preload-skills-into-subagents).

445 445 

446#### Esempio: Skill di ricerca usando l'agent Explore446#### Esempio: Skill di ricerca usando l'agent Explore

447 447 

statusline.md +6 −1

Details

916 916 

917### Configurazione Windows917### Configurazione Windows

918 918 

919Su Windows, Claude Code esegue i comandi della barra di stato tramite Git Bash quando Git Bash è installato, o tramite PowerShell quando Git Bash è assente. Per eseguire uno script PowerShell come barra di stato, invocalo tramite `powershell`; questo funziona da entrambi i shell:919Su Windows, Claude Code esegue i comandi della barra di stato tramite Git Bash quando Git Bash è installato, o tramite PowerShell quando Git Bash è assente.

920 

921Git Bash tratta i backslash non quotati come caratteri di escape, quindi un percorso in stile Windows come `C:\Users\username\script.mjs` raggiunge lo script runner con i suoi separatori rimossi e il comando fallisce senza un errore visibile. Scrivi i percorsi dei file nella stringa `command` con barre oblique, come mostrato negli esempi seguenti. La scorciatoia `~` funziona anche e si espande alla tua directory home di Windows.

922 

923Per eseguire uno script PowerShell come barra di stato, invocalo tramite `powershell`. Questo funziona indipendentemente dal fatto che Claude Code instrada il comando tramite Git Bash o PowerShell:

920 924 

921<CodeGroup>925<CodeGroup>

922 ```json settings.json theme={null}926 ```json settings.json theme={null}


999* Verifica che il tuo script sia eseguibile: `chmod +x ~/.claude/statusline.sh`1003* Verifica che il tuo script sia eseguibile: `chmod +x ~/.claude/statusline.sh`

1000* Controlla che il tuo script stampi su stdout, non su stderr1004* Controlla che il tuo script stampi su stdout, non su stderr

1001* Esegui il tuo script manualmente per verificare che produca output1005* Esegui il tuo script manualmente per verificare che produca output

1006* Su Windows con Git Bash installato, i backslash nel percorso `command` vengono probabilmente consumati come caratteri di escape prima che lo script venga eseguito. Usa barre oblique nel percorso. Vedi [Configurazione Windows](#windows-configuration).

1002* Se `disableAllHooks` è impostato su `true` nelle tue impostazioni, anche la barra di stato è disabilitata. Rimuovi questa impostazione o impostala su `false` per riabilitarla.1007* Se `disableAllHooks` è impostato su `true` nelle tue impostazioni, anche la barra di stato è disabilitata. Rimuovi questa impostazione o impostala su `false` per riabilitarla.

1003* Esegui `claude --debug` per registrare il codice di uscita e stderr dalla prima invocazione della barra di stato in una sessione1008* Esegui `claude --debug` per registrare il codice di uscita e stderr dalla prima invocazione della barra di stato in una sessione

1004* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori1009* Chiedi a Claude di leggere il tuo file di impostazioni ed eseguire il comando `statusLine` direttamente per far emergere gli errori

sub-agents.md +32 −2

Details

37 37 

38Claude Code include subagent integrati che Claude utilizza automaticamente quando appropriato. Ognuno eredita le autorizzazioni della conversazione principale con restrizioni di strumenti aggiuntive.38Claude Code include subagent integrati che Claude utilizza automaticamente quando appropriato. Ognuno eredita le autorizzazioni della conversazione principale con restrizioni di strumenti aggiuntive.

39 39 

40Explore e Plan saltano i vostri file CLAUDE.md e lo stato git della sessione principale per mantenere la ricerca veloce ed economica. Ogni altro subagent integrato e [subagent personalizzato](#configure-subagents) carica entrambi. Per la suddivisione completa di ciò che raggiunge un subagent, consultate [cosa si carica all'avvio](#what-loads-at-startup).

41 

40<Tabs>42<Tabs>

41 <Tab title="Explore">43 <Tab title="Explore">

42 Un agente veloce e di sola lettura ottimizzato per la ricerca e l'analisi delle basi di codice.44 Un agente veloce e di sola lettura ottimizzato per la ricerca e l'analisi delle basi di codice.


80 </Tab>82 </Tab>

81</Tabs>83</Tabs>

82 84 

83Oltre a questi subagent integrati, può creare i suoi con prompt personalizzati, restrizioni di strumenti, modalità di autorizzazione, hooks e skills. Le sezioni seguenti mostrano come iniziare e personalizzare i subagent.85Oltre a questi subagent integrati, potete creare i vostri con prompt personalizzati, restrizioni di strumenti, modalità di autorizzazione, hooks e skills. Le sezioni seguenti mostrano come iniziare e personalizzare i subagent.

84 86 

85## Quickstart: crea il suo primo subagent87## Quickstart: crea il suo primo subagent

86 88 


652 654 

653Questo funziona con i subagent integrati e personalizzati, e la scelta persiste quando riprende la sessione.655Questo funziona con i subagent integrati e personalizzati, e la scelta persiste quando riprende la sessione.

654 656 

655Per un subagent fornito da un plugin, passi il nome con ambito: `claude --agent <plugin-name>:<agent-name>`. Se il plugin posiziona l'agente in una sottocartella della sua directory `agents/`, includa la sottocartella nel nome con ambito, ad esempio `claude --agent my-plugin:review:security`.657Per un subagent fornito da un plugin, può passare solo il nome dell'agente e Claude Code lo troverà:

658 

659```bash theme={null}

660claude --agent security-reviewer

661```

662 

663Se più plugin forniscono agenti con lo stesso nome, passi il nome con ambito per disambiguare:

664 

665```bash theme={null}

666claude --agent my-plugin:security-reviewer

667```

668 

669Se il plugin posiziona l'agente in una sottocartella della sua directory `agents/`, includa la sottocartella nel nome con ambito, ad esempio `claude --agent my-plugin:review:security`.

656 670 

657Per renderlo il predefinito per ogni sessione in un progetto, imposti `agent` in `.claude/settings.json`:671Per renderlo il predefinito per ogni sessione in un progetto, imposti `agent` in `.claude/settings.json`:

658 672 


741 755 

742### Gestisca il contesto del subagent756### Gestisca il contesto del subagent

743 757 

758#### Cosa si carica all'avvio

759 

760Ogni subagent inizia con una finestra di contesto fresca e isolata. Non vede la cronologia della sua conversazione, le skills che ha già invocato, o i file che Claude ha già letto. Claude compone un messaggio di delegazione che riassume l'attività, e il subagent lavora da lì. L'eccezione è una [fork](#fork-the-current-conversation), che eredita la conversazione genitore invece di iniziare da zero.

761 

762Il contesto iniziale di un subagent non-fork contiene:

763 

764* **System prompt**: il prompt dell'agente stesso più i dettagli dell'ambiente che Claude Code aggiunge, non il prompt di sistema completo di Claude Code. I subagent personalizzati definiscono il loro nel [corpo markdown](#write-subagent-files) o nel campo `prompt`. Gli agenti integrati hanno prompt predefiniti.

765* **Task message**: il prompt di delegazione che Claude scrive quando consegna il lavoro.

766* **CLAUDE.md e memory**: ogni livello della [gerarchia di memoria](/it/memory#how-claude-md-files-load) che la conversazione principale carica, inclusi `~/.claude/CLAUDE.md`, regole del progetto, `CLAUDE.local.md` e file di policy gestiti. Gli agenti Explore e Plan integrati saltano questo.

767* **Git status**: uno snapshot preso all'inizio della sessione genitore. Assente quando la directory di lavoro non è un repository Git o quando [`includeGitInstructions`](/it/settings#available-settings) è `false`. Explore e Plan lo saltano comunque.

768* **Preloaded skills**: contenuto completo di qualsiasi skill denominata nel campo [`skills`](#preload-skills-into-subagents) dell'agente. Gli agenti integrati non precaricano skills.

769 

770Explore e Plan sono gli unici subagent che omettono CLAUDE.md e git status. Non c'è un campo frontmatter o un'impostazione per-agente per cambiare quali agenti li saltano.

771 

772La conversazione principale legge i risultati di Explore e Plan con il contesto completo di CLAUDE.md, quindi la maggior parte delle regole non ha bisogno di raggiungere il subagent stesso. Se una regola deve, come "ignora la directory `vendor/`", la rienunci nel prompt che dà a Claude quando delega.

773 

744#### Riprenda i subagent774#### Riprenda i subagent

745 775 

746Ogni invocazione di subagent crea una nuova istanza con contesto fresco. Per continuare il lavoro di un subagent esistente invece di ricominciare, chieda a Claude di riprendere.776Ogni invocazione di subagent crea una nuova istanza con contesto fresco. Per continuare il lavoro di un subagent esistente invece di ricominciare, chieda a Claude di riprendere.

Details

45| `TaskUpdate` | Aggiorna lo stato dell'attività, le dipendenze, i dettagli, o elimina le attività | No |45| `TaskUpdate` | Aggiorna lo stato dell'attività, le dipendenze, i dettagli, o elimina le attività | No |

46| `TeamCreate` | Crea un [team di agenti](/it/agent-teams) con più compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato | No |46| `TeamCreate` | Crea un [team di agenti](/it/agent-teams) con più compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato | No |

47| `TeamDelete` | Scioglie un team di agenti e pulisce i processi dei compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato | No |47| `TeamDelete` | Scioglie un team di agenti e pulisce i processi dei compagni. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato | No |

48| `TodoWrite` | Gestisce l'elenco di controllo delle attività della sessione. Disponibile in modalità non interattiva e in [Agent SDK](/it/headless); le sessioni interattive utilizzano TaskCreate, TaskGet, TaskList, e TaskUpdate | No |48| `TodoWrite` | {/* min-version: 2.1.142 */}Gestisce l'elenco di controllo delle attività della sessione. Disabilitato per impostazione predefinita a partire da v2.1.142 a favore di `TaskCreate`, `TaskGet`, `TaskList`, e `TaskUpdate`. Imposta `CLAUDE_CODE_ENABLE_TASKS=0` per riabilitare | No |

49| `ToolSearch` | Cerca e carica strumenti differiti quando [tool search](/it/mcp#scale-with-mcp-tool-search) è abilitato | No |49| `ToolSearch` | Cerca e carica strumenti differiti quando [tool search](/it/mcp#scale-with-mcp-tool-search) è abilitato | No |

50| `WaitForMcpServers` | {/* min-version: 2.1.142 */}Attende uno o più [server MCP](/it/mcp) che sono ancora in fase di connessione in background, in modo che una richiesta possa utilizzare i loro strumenti senza riavviare la sessione. Claude lo chiama quando un server necessario non è ancora connesso. Appare solo quando [tool search](/it/mcp#scale-with-mcp-tool-search) è disabilitato, poiché `ToolSearch` gestisce l'attesa quando è abilitato | No |

50| `WebFetch` | Recupera il contenuto da un URL specificato. Vedi [comportamento dello strumento WebFetch](#webfetch-tool-behavior) | Sì |51| `WebFetch` | Recupera il contenuto da un URL specificato. Vedi [comportamento dello strumento WebFetch](#webfetch-tool-behavior) | Sì |

51| `WebSearch` | Esegue ricerche web. Vedi [comportamento dello strumento WebSearch](#websearch-tool-behavior) | Sì |52| `WebSearch` | Esegue ricerche web. Vedi [comportamento dello strumento WebSearch](#websearch-tool-behavior) | Sì |

52| `Write` | Crea o sovrascrivi file. Vedi [comportamento dello strumento Write](#write-tool-behavior) | Sì |53| `Write` | Crea o sovrascrivi file. Vedi [comportamento dello strumento Write](#write-tool-behavior) | Sì |

ultrareview.md +1 −1

Details

56 56 

57I sottoscrittori Pro e Max ricevono tre run ultrareview gratuiti per provare la funzione. Questi tre run sono un'allocazione una tantum per account e non si rinnovano. Dopo averli utilizzati tutti, o dopo la scadenza del periodo di run gratuiti, ogni revisione viene fatturata all'utilizzo extra e in genere costa da \$5 a \$20 a seconda della dimensione della modifica. Un run viene conteggiato una volta che la sessione remota inizia, quindi una revisione che interrompete anticipatamente o che non riesce a completarsi utilizza comunque un run gratuito. Per una revisione a pagamento, l'utilizzo extra viene fatturato solo per la parte che è stata eseguita.57I sottoscrittori Pro e Max ricevono tre run ultrareview gratuiti per provare la funzione. Questi tre run sono un'allocazione una tantum per account e non si rinnovano. Dopo averli utilizzati tutti, o dopo la scadenza del periodo di run gratuiti, ogni revisione viene fatturata all'utilizzo extra e in genere costa da \$5 a \$20 a seconda della dimensione della modifica. Un run viene conteggiato una volta che la sessione remota inizia, quindi una revisione che interrompete anticipatamente o che non riesce a completarsi utilizza comunque un run gratuito. Per una revisione a pagamento, l'utilizzo extra viene fatturato solo per la parte che è stata eseguita.

58 58 

59Poiché ultrareview viene sempre fatturato come utilizzo extra al di fuori dei run gratuiti, il vostro account o la vostra organizzazione deve avere l'utilizzo extra abilitato prima di poter avviare una revisione a pagamento. Se l'utilizzo extra non è abilitato, Claude Code blocca l'avvio e vi collega alle impostazioni di fatturazione dove potete attivarlo. Potete anche eseguire `/extra-usage` per controllare o modificare l'impostazione attuale.59Poiché ultrareview viene sempre fatturato come utilizzo extra al di fuori dei run gratuiti, il vostro account o la vostra organizzazione deve avere l'utilizzo extra abilitato prima di poter avviare una revisione a pagamento. Se l'utilizzo extra non è abilitato, Claude Code blocca l'avvio e vi collega alle impostazioni di fatturazione dove potete attivarlo. Potete anche eseguire `/usage-credits` per controllare o modificare l'impostazione attuale.

60 60 

61## Traccia una revisione in esecuzione61## Traccia una revisione in esecuzione

62 62