Documentation 2026-05-14 17:02 UTC to 2026-05-15 22:58 UTC

46 46 

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

48 import asyncio48 import asyncio

49 from claude_agent_sdk import query49 from claude_agent_sdk import query, ClaudeAgentOptions

50 50 

51 51 

52 async def main():52 async def main():

53 async for message in query(53 async for message in query(

54 prompt="Hello",54 prompt="Hello",

55 options={55 options=ClaudeAgentOptions(

56 "plugins": [56 plugins=[

57 {"type": "local", "path": "./my-plugin"},57 {"type": "local", "path": "./my-plugin"},

58 {"type": "local", "path": "/absolute/path/to/another-plugin"},58 {"type": "local", "path": "/absolute/path/to/another-plugin"},

59 ]59 ]

60 },60 ),

61 ):61 ):

62 # Plugin commands, agents, and other features are now available62 # Plugin commands, agents, and other features are now available

63 pass63 pass

106 106 

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

108 import asyncio108 import asyncio

109 from claude_agent_sdk import query109 from claude_agent_sdk import query, ClaudeAgentOptions, SystemMessage

110 110 

111 111 

112 async def main():112 async def main():

113 async for message in query(113 async for message in query(

114 prompt="Hello", options={"plugins": [{"type": "local", "path": "./my-plugin"}]}114 prompt="Hello",

115 options=ClaudeAgentOptions(

116 plugins=[{"type": "local", "path": "./my-plugin"}]

117 ),

115 ):118 ):

116 if message.type == "system" and message.subtype == "init":119 if isinstance(message, SystemMessage) and message.subtype == "init":

117 # Check loaded plugins120 # Check loaded plugins

118 print("Plugins:", message.data.get("plugins"))121 print("Plugins:", message.data.get("plugins"))

119 # Example: [{"name": "my-plugin", "path": "./my-plugin"}]122 # Example: [{"name": "my-plugin", "path": "./my-plugin"}]

151 154 

152 ```python Python theme={null}155 ```python Python theme={null}

153 import asyncio156 import asyncio

154 from claude_agent_sdk import query, AssistantMessage, TextBlock157 from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, TextBlock

155 158 

156 159 

157 async def main():160 async def main():

158 # Load a plugin with a custom /greet skill161 # Load a plugin with a custom /greet skill

159 async for message in query(162 async for message in query(

160 prompt="/demo-plugin:greet", # Use plugin skill with namespace163 prompt="/demo-plugin:greet", # Use plugin skill with namespace

161 options={"plugins": [{"type": "local", "path": "./plugins/demo-plugin"}]},164 options=ClaudeAgentOptions(

165 plugins=[{"type": "local", "path": "./plugins/demo-plugin"}]

166 ),

162 ):167 ):

163 # Claude executes the custom greeting skill from the plugin168 # Claude executes the custom greeting skill from the plugin

164 if isinstance(message, AssistantMessage):169 if isinstance(message, AssistantMessage):

219 from claude_agent_sdk import (224 from claude_agent_sdk import (

220 AssistantMessage,225 AssistantMessage,

221 ClaudeAgentOptions,226 ClaudeAgentOptions,

227 SystemMessage,

222 TextBlock,228 TextBlock,

223 query,229 query,

224 )230 )

238 async for message in query(244 async for message in query(

239 prompt="What custom commands do you have available?", options=options245 prompt="What custom commands do you have available?", options=options

240 ):246 ):

241 if message.type == "system" and message.subtype == "init":247 if isinstance(message, SystemMessage) and message.subtype == "init":

242 print(f"Loaded plugins: {message.data.get('plugins')}")248 print(f"Loaded plugins: {message.data.get('plugins')}")

243 print(f"Available commands: {message.data.get('slash_commands')}")249 print(f"Available commands: {message.data.get('slash_commands')}")

244 250 

56 prompt: "/compact",56 prompt: "/compact",

57 options: { maxTurns: 1 }57 options: { maxTurns: 1 }

58 })) {58 })) {

59 if (message.type === "result") {59 if (message.type === "result" && message.subtype === "success") {

60 console.log("Command executed:", message.result);60 console.log("Command executed:", message.result);

61 }61 }

62 }62 }

261 options: { maxTurns: 5 }261 options: { maxTurns: 5 }

262 })) {262 })) {

263 // Command will process with $1="123" and $2="high"263 // Command will process with $1="123" and $2="high"

264 if (message.type === "result") {264 if (message.type === "result" && message.subtype === "success") {

265 console.log("Issue fixed:", message.result);265 console.log("Issue fixed:", message.result);

266 }266 }

267 }267 }

1> ## Documentation Index

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

4 

5# Streaming Input

6 

7> Comprensione delle due modalità di input per Claude Agent SDK e quando utilizzare ciascuna

8 

9## Panoramica

10 

11Claude Agent SDK supporta due modalità di input distinte per interagire con gli agenti:

12 

13* **Modalità Streaming Input** (Predefinita e Consigliata) - Una sessione persistente e interattiva

14* **Single Message Input** - Query una tantum che utilizzano lo stato della sessione e la ripresa

15 

16Questa guida spiega le differenze, i vantaggi e i casi d'uso per ciascuna modalità per aiutarvi a scegliere l'approccio giusto per la vostra applicazione.

17 

18## Modalità Streaming Input (Consigliata)

19 

20La modalità streaming input è il modo **preferito** per utilizzare Claude Agent SDK. Fornisce accesso completo alle capacità dell'agente e consente esperienze ricche e interattive.

21 

22Consente all'agente di operare come un processo di lunga durata che accetta input dell'utente, gestisce interruzioni, visualizza richieste di autorizzazione e gestisce la gestione della sessione.

23 

24### Come Funziona

25 

26```mermaid theme={null}

27sequenceDiagram

28 participant App as Your Application

29 participant Agent as Claude Agent

30 participant Tools as Tools/Hooks

31 participant FS as Environment/<br/>File System

32 

33 App->>Agent: Initialize with AsyncGenerator

34 activate Agent

35 

36 App->>Agent: Yield Message 1

37 Agent->>Tools: Execute tools

38 Tools->>FS: Read files

39 FS-->>Tools: File contents

40 Tools->>FS: Write/Edit files

41 FS-->>Tools: Success/Error

42 Agent-->>App: Stream partial response

43 Agent-->>App: Stream more content...

44 Agent->>App: Complete Message 1

45 

46 App->>Agent: Yield Message 2 + Image

47 Agent->>Tools: Process image & execute

48 Tools->>FS: Access filesystem

49 FS-->>Tools: Operation results

50 Agent-->>App: Stream response 2

51 

52 App->>Agent: Queue Message 3

53 App->>Agent: Interrupt/Cancel

54 Agent->>App: Handle interruption

55 

56 Note over App,Agent: Session stays alive

57 Note over Tools,FS: Persistent file system<br/>state maintained

58 

59 deactivate Agent

60```

61 

62### Vantaggi

63 

64<CardGroup cols={2}>

65 <Card title="Caricamenti di Immagini" icon="image">

66 Allegate immagini direttamente ai messaggi per l'analisi visiva e la comprensione

67 </Card>

68 

69 <Card title="Messaggi in Coda" icon="stack">

70 Inviate più messaggi che vengono elaborati sequenzialmente, con la possibilità di interrompere

71 </Card>

72 

73 <Card title="Integrazione Tool" icon="wrench">

74 Accesso completo a tutti i tool e ai server MCP personalizzati durante la sessione

75 </Card>

76 

77 <Card title="Supporto Hooks" icon="link">

78 Utilizzate gli hook del ciclo di vita per personalizzare il comportamento in vari punti

79 </Card>

80 

81 <Card title="Feedback in Tempo Reale" icon="lightning">

82 Vedete le risposte mentre vengono generate, non solo i risultati finali

83 </Card>

84 

85 <Card title="Persistenza del Contesto" icon="database">

86 Mantenete il contesto della conversazione su più turni naturalmente

87 </Card>

88</CardGroup>

89 

90### Esempio di Implementazione

91 

92<CodeGroup>

93 ```typescript TypeScript theme={null}

94 import { query, type SDKUserMessage } from "@anthropic-ai/claude-agent-sdk";

95 import { readFile } from "fs/promises";

96 

97 async function* generateMessages(): AsyncGenerator<SDKUserMessage> {

98 // First message

99 yield {

100 type: "user",

101 message: {

102 role: "user",

103 content: "Analyze this codebase for security issues"

104 },

105 parent_tool_use_id: null

106 };

107 

108 // Wait for conditions or user input

109 await new Promise((resolve) => setTimeout(resolve, 2000));

110 

111 // Follow-up with image

112 yield {

113 type: "user",

114 message: {

115 role: "user",

116 content: [

117 {

118 type: "text",

119 text: "Review this architecture diagram"

120 },

121 {

122 type: "image",

123 source: {

124 type: "base64",

125 media_type: "image/png",

126 data: await readFile("diagram.png", "base64")

127 }

128 }

129 ]

130 },

131 parent_tool_use_id: null

132 };

133 }

134 

135 // Process streaming responses

136 for await (const message of query({

137 prompt: generateMessages(),

138 options: {

139 maxTurns: 10,

140 allowedTools: ["Read", "Grep"]

141 }

142 })) {

143 if (message.type === "result" && message.subtype === "success") {

144 console.log(message.result);

145 }

146 }

147 ```

148 

149 ```python Python theme={null}

150 from claude_agent_sdk import (

151 ClaudeSDKClient,

152 ClaudeAgentOptions,

153 AssistantMessage,

154 TextBlock,

155 )

156 import asyncio

157 import base64

158 

159 

160 async def streaming_analysis():

161 async def message_generator():

162 # First message

163 yield {

164 "type": "user",

165 "message": {

166 "role": "user",

167 "content": "Analyze this codebase for security issues",

168 },

169 }

170 

171 # Wait for conditions

172 await asyncio.sleep(2)

173 

174 # Follow-up with image

175 with open("diagram.png", "rb") as f:

176 image_data = base64.b64encode(f.read()).decode()

177 

178 yield {

179 "type": "user",

180 "message": {

181 "role": "user",

182 "content": [

183 {"type": "text", "text": "Review this architecture diagram"},

184 {

185 "type": "image",

186 "source": {

187 "type": "base64",

188 "media_type": "image/png",

189 "data": image_data,

190 },

191 },

192 ],

193 },

194 }

195 

196 # Use ClaudeSDKClient for streaming input

197 options = ClaudeAgentOptions(max_turns=10, allowed_tools=["Read", "Grep"])

198 

199 async with ClaudeSDKClient(options) as client:

200 # Send streaming input

201 await client.query(message_generator())

202 

203 # Process responses

204 async for message in client.receive_response():

205 if isinstance(message, AssistantMessage):

206 for block in message.content:

207 if isinstance(block, TextBlock):

208 print(block.text)

209 

210 

211 asyncio.run(streaming_analysis())

212 ```

213</CodeGroup>

214 

215## Single Message Input

216 

217Single message input è più semplice ma più limitato.

218 

219### Quando Utilizzare Single Message Input

220 

221Utilizzate single message input quando:

222 

223* Avete bisogno di una risposta una tantum

224* Non avete bisogno di allegati di immagini, hook, ecc.

225* Dovete operare in un ambiente senza stato, come una funzione lambda

226 

227### Limitazioni

228 

229<Warning>

230 La modalità single message input **non** supporta:

231 

232 * Allegati di immagini diretti nei messaggi

233 * Accodamento dinamico dei messaggi

234 * Interruzione in tempo reale

235 * Integrazione degli hook

236 * Conversazioni multi-turno naturali

237</Warning>

238 

239### Esempio di Implementazione

240 

241<CodeGroup>

242 ```typescript TypeScript theme={null}

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

244 

245 // Simple one-shot query

246 for await (const message of query({

247 prompt: "Explain the authentication flow",

248 options: {

249 maxTurns: 1,

250 allowedTools: ["Read", "Grep"]

251 }

252 })) {

253 if (message.type === "result" && message.subtype === "success") {

254 console.log(message.result);

255 }

256 }

257 

258 // Continue conversation with session management

259 for await (const message of query({

260 prompt: "Now explain the authorization process",

261 options: {

262 continue: true,

263 maxTurns: 1

264 }

265 })) {

266 if (message.type === "result" && message.subtype === "success") {

267 console.log(message.result);

268 }

269 }

270 ```

271 

272 ```python Python theme={null}

273 from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

274 import asyncio

275 

276 

277 async def single_message_example():

278 # Simple one-shot query using query() function

279 async for message in query(

280 prompt="Explain the authentication flow",

281 options=ClaudeAgentOptions(max_turns=1, allowed_tools=["Read", "Grep"]),

282 ):

283 if isinstance(message, ResultMessage):

284 print(message.result)

285 

286 # Continue conversation with session management

287 async for message in query(

288 prompt="Now explain the authorization process",

289 options=ClaudeAgentOptions(continue_conversation=True, max_turns=1),

290 ):

291 if isinstance(message, ResultMessage):

292 print(message.result)

293 

294 

295 asyncio.run(single_message_example())

296 ```

297</CodeGroup>

313<CodeGroup>313<CodeGroup>

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

315 import asyncio315 import asyncio

316 from claude_agent_sdk import query, ClaudeAgentOptions, AgentDefinition316 from claude_agent_sdk import query, ClaudeAgentOptions, AgentDefinition, ToolUseBlock

317 317 

318 318 

319 async def main():319 async def main():

334 # versions emitted "Task", current versions emit "Agent".334 # versions emitted "Task", current versions emit "Agent".

335 if hasattr(message, "content") and message.content:335 if hasattr(message, "content") and message.content:

336 for block in message.content:336 for block in message.content:

337 if getattr(block, "type", None) == "tool_use" and block.name in (337 if isinstance(block, ToolUseBlock) and block.name in (

338 "Task",338 "Task",

339 "Agent",339 "Agent",

340 ):340 ):

414 // Helper to extract agentId from message content414 // Helper to extract agentId from message content

415 // Stringify to avoid traversing different block types (TextBlock, ToolResultBlock, etc.)415 // Stringify to avoid traversing different block types (TextBlock, ToolResultBlock, etc.)

416 function extractAgentId(message: SDKMessage): string | undefined {416 function extractAgentId(message: SDKMessage): string | undefined {

417 if (!("message" in message)) return undefined;417 if (message.type !== "assistant" && message.type !== "user") return undefined;

418 // Stringify the content so we can search it without traversing nested blocks418 // Stringify the content so we can search it without traversing nested blocks

419 const content = JSON.stringify(message.message.content);419 const content = JSON.stringify(message.message.content);

420 const match = content.match(/agentId:\s*([a-f0-9-]+)/);420 const match = content.match(/agentId:\s*([a-f0-9-]+)/);

1> ## Documentation Index

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

4 

5# Scalare a molti strumenti con la ricerca di strumenti

6 

7> Scalare il vostro agente a migliaia di strumenti scoprendo e caricando solo ciò che è necessario, su richiesta.

8 

9La ricerca di strumenti consente al vostro agente di lavorare con centinaia o migliaia di strumenti scoprendo e caricando dinamicamente solo quelli di cui ha bisogno. Invece di caricare tutte le definizioni degli strumenti nella finestra di contesto in anticipo, l'agente cerca nel vostro catalogo di strumenti e carica solo gli strumenti di cui ha bisogno.

10 

11Questo approccio risolve due sfide man mano che le librerie di strumenti si scalano:

12 

13* **Efficienza del contesto:** Le definizioni degli strumenti possono consumare grandi porzioni della finestra di contesto (50 strumenti possono utilizzare 10-20K token), lasciando meno spazio per il lavoro effettivo.

14* **Accuratezza della selezione degli strumenti:** L'accuratezza della selezione degli strumenti si degrada con più di 30-50 strumenti caricati contemporaneamente.

15 

16La ricerca di strumenti è abilitata per impostazione predefinita. Questa pagina copre [come funziona](#how-tool-search-works), come [configurarla](#configure-tool-search) e come [ottimizzare la scoperta degli strumenti](#optimize-tool-discovery).

17 

18## Come funziona la ricerca di strumenti

19 

20Quando la ricerca di strumenti è attiva, le definizioni degli strumenti vengono trattenute dalla finestra di contesto. L'agente riceve un riepilogo degli strumenti disponibili e cerca quelli rilevanti quando l'attività richiede una capacità non già caricata. I 3-5 strumenti più rilevanti vengono caricati nel contesto, dove rimangono disponibili per i turni successivi. Se la conversazione è abbastanza lunga da far sì che l'SDK compatti i messaggi precedenti per liberare spazio, gli strumenti precedentemente scoperti possono essere rimossi e l'agente ricerca di nuovo secondo le necessità.

21 

22La ricerca di strumenti aggiunge un extra round-trip la prima volta che Claude scopre uno strumento (il passaggio di ricerca), ma per grandi set di strumenti questo è compensato da un contesto più piccolo ad ogni turno. Con meno di \~10 strumenti, il caricamento di tutto in anticipo è generalmente più veloce.

23 

24Per i dettagli sul meccanismo API sottostante, vedere [Ricerca di strumenti nell'API](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool).

25 

26<Note>

27 La ricerca di strumenti richiede Claude Sonnet 4 o successivo, o Claude Opus 4 o successivo. I modelli Haiku non supportano la ricerca di strumenti.

28</Note>

29 

30## Configurare la ricerca di strumenti

31 

32La ricerca di strumenti è attiva per impostazione predefinita. È disabilitata per impostazione predefinita su Vertex AI, dove è supportata per Claude Sonnet 4.5 e successivo e Claude Opus 4.5 e successivo. È anche disabilitata quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte, poiché la maggior parte dei proxy non inoltrano i blocchi `tool_reference`. Potete ignorare uno qualsiasi dei valori predefiniti con la variabile di ambiente `ENABLE_TOOL_SEARCH`:

33 

34| Valore | Comportamento |

35| :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

36| (non impostato) | La ricerca di strumenti è attiva. Le definizioni degli strumenti vengono differite e scoperte su richiesta. Ritorna al caricamento in anticipo su Vertex AI o su un `ANTHROPIC_BASE_URL` non di prima parte. |

37| `true` | La ricerca di strumenti è sempre attiva. L'SDK invia l'intestazione beta anche su Vertex AI e attraverso i proxy. Le richieste falliscono sui modelli Vertex AI precedenti a Sonnet 4.5 o Opus 4.5, o sui proxy che non supportano i blocchi `tool_reference`. |

38| `auto` | Controlla il conteggio dei token combinato di tutte le definizioni degli strumenti rispetto alla finestra di contesto del modello. Se superano il 10%, la ricerca di strumenti si attiva. Se sono sotto il 10%, tutti gli strumenti vengono caricati nel contesto normalmente. |

39| `auto:N` | Come `auto` con una percentuale personalizzata. `auto:5` si attiva quando le definizioni degli strumenti superano il 5% della finestra di contesto. Valori più bassi si attivano prima. |

40| `false` | La ricerca di strumenti è disattivata. Tutte le definizioni degli strumenti vengono caricate nel contesto ad ogni turno. |

41 

42La ricerca di strumenti si applica a tutti gli strumenti registrati, che provengano da server MCP remoti o da [server MCP SDK personalizzati](/it/agent-sdk/custom-tools). Quando si utilizza `auto`, la soglia si basa sulla dimensione combinata di tutte le definizioni degli strumenti su tutti i server.

43 

44Impostare il valore nell'opzione `env` su `query()`. Questo esempio si connette a un server MCP remoto che espone molti strumenti, pre-approva tutti loro con un carattere jolly e utilizza `auto:5` in modo che la ricerca di strumenti si attivi quando le loro definizioni superano il 5% della finestra di contesto:

45 

46<CodeGroup>

47 ```typescript TypeScript theme={null}

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

49 

50 for await (const message of query({

51 prompt: "Find and run the appropriate database query",

52 options: {

53 mcpServers: {

54 "enterprise-tools": {

55 // Connect to a remote MCP server

56 type: "http",

57 url: "https://tools.example.com/mcp"

58 }

59 },

60 allowedTools: ["mcp__enterprise-tools__*"], // Wildcard pre-approves all tools from this server

61 env: {

62 ENABLE_TOOL_SEARCH: "auto:5" // Activate tool search when tools exceed 5% of context

63 }

64 }

65 })) {

66 if (message.type === "result" && message.subtype === "success") {

67 console.log(message.result);

68 }

69 }

70 ```

71 

72 ```python Python theme={null}

73 import asyncio

74 from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

75 

76 

77 async def main():

78 options = ClaudeAgentOptions(

79 mcp_servers={

80 "enterprise-tools": {

81 "type": "http",

82 "url": "https://tools.example.com/mcp",

83 }

84 },

85 allowed_tools=[

86 "mcp__enterprise-tools__*"

87 ], # Wildcard pre-approves all tools from this server

88 env={

89 "ENABLE_TOOL_SEARCH": "auto:5" # Activate tool search when tools exceed 5% of context

90 },

91 )

92 

93 async for message in query(

94 prompt="Find and run the appropriate database query",

95 options=options,

96 ):

97 if isinstance(message, ResultMessage) and message.subtype == "success":

98 print(message.result)

99 

100 

101 asyncio.run(main())

102 ```

103</CodeGroup>

104 

105Impostare `ENABLE_TOOL_SEARCH` su `"false"` disabilita la ricerca di strumenti e carica tutte le definizioni degli strumenti nel contesto ad ogni turno. Questo rimuove il round-trip di ricerca, che può essere più veloce quando il set di strumenti è piccolo (meno di \~10 strumenti) e le definizioni si adattano comodamente nella finestra di contesto.

106 

107## Ottimizzare la scoperta degli strumenti

108 

109Il meccanismo di ricerca abbina le query ai nomi e alle descrizioni degli strumenti. Nomi come `search_slack_messages` emergono per una gamma più ampia di richieste rispetto a `query_slack`. Le descrizioni con parole chiave specifiche ("Cerca messaggi Slack per parola chiave, canale o intervallo di date") corrispondono a più query rispetto a quelle generiche ("Query Slack").

110 

111Potete anche aggiungere una sezione di prompt di sistema che elenca le categorie di strumenti disponibili. Questo dà all'agente il contesto su quali tipi di strumenti sono disponibili per la ricerca:

112 

113```text theme={null}

114You can search for tools to interact with Slack, GitHub, and Jira.

115```

116 

117## Limiti

118 

119* **Strumenti massimi:** 10.000 strumenti nel vostro catalogo

120* **Risultati di ricerca:** Restituisce i 3-5 strumenti più rilevanti per ricerca

121* **Supporto del modello:** Claude Sonnet 4 e successivo, Claude Opus 4 e successivo (nessun Haiku)

122 

123## Documentazione correlata

124 

125* [Ricerca di strumenti nell'API](https://platform.claude.com/docs/it/agents-and-tools/tool-use/tool-search-tool): Documentazione API completa per la ricerca di strumenti, incluse implementazioni personalizzate

126* [Connettere server MCP](/it/agent-sdk/mcp): Connettere a strumenti esterni tramite server MCP

127* [Strumenti personalizzati](/it/agent-sdk/custom-tools): Creare i vostri strumenti con server MCP SDK

128* [Riferimento SDK TypeScript](/it/agent-sdk/typescript): Riferimento API completo

129* [Riferimento SDK Python](/it/agent-sdk/python): Riferimento API completo

948type SDKUserMessage = {948type SDKUserMessage = {

949 type: "user";949 type: "user";

950 uuid?: UUID;950 uuid?: UUID;

951 session_id: string;951 session_id?: string;

952 message: MessageParam; // Dall'SDK Anthropic952 message: MessageParam; // Dall'SDK Anthropic

953 parent_tool_use_id: string | null;953 parent_tool_use_id: string | null;

954 isSynthetic?: boolean;954 isSynthetic?: boolean;

265claude --agent code-reviewer --bg "address review comments on PR 1234"265claude --agent code-reviewer --bg "address review comments on PR 1234"

266```266```

267 267 

268Passa `--name` per impostare il nome di visualizzazione della sessione in agent view invece di quello generato automaticamente:

269 

270```bash theme={null}

271claude --bg --name "flaky-test-fix" "investigate the flaky SettingsChangeDetector test"

272```

273 

268Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla:274Dopo aver messo in background, Claude stampa l'ID breve della sessione e i comandi per gestirla:

269 275 

270```text theme={null}276```text theme={null}

211export CLAUDE_CODE_USE_BEDROCK=1211export CLAUDE_CODE_USE_BEDROCK=1

212export AWS_REGION=us-east-1 # o la tua regione preferita212export AWS_REGION=us-east-1 # o la tua regione preferita

213 213 

214# Facoltativo: Sovrascrivi la regione per il modello piccolo/veloce (Haiku).214# Facoltativo: Sovrascrivi la regione AWS per il modello piccolo/veloce (Bedrock e Mantle).

215# Si applica anche a Bedrock Mantle.215# Su Bedrock, non ha effetto senza ANTHROPIC_DEFAULT_HAIKU_MODEL

216# o il deprecato ANTHROPIC_SMALL_FAST_MODEL impostato.

216export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2217export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

217 218 

218# Facoltativo: Sovrascrivi l'URL dell'endpoint Bedrock per endpoint personalizzati o gateway219# Facoltativo: Sovrascrivi l'URL dell'endpoint Bedrock per endpoint personalizzati o gateway

248| Tipo di modello | Valore predefinito |249| Tipo di modello | Valore predefinito |

249| :--------------------- | :--------------------------------------------- |250| :--------------------- | :--------------------------------------------- |

250| Modello primario | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |251| Modello primario | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

251| Modello piccolo/veloce | `us.anthropic.claude-haiku-4-5-20251001-v1:0` |252| Modello piccolo/veloce | Uguale al modello primario |

253 

254Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Bedrock, Claude Code imposta per impostazione predefinita questo al modello primario perché Haiku potrebbe non essere abilitato in ogni account o regione. Per utilizzare Haiku per le attività in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su un ID di modello disponibile nel tuo account.

252 255 

253Per personalizzare ulteriormente i modelli, utilizza uno di questi metodi:256Per personalizzare ulteriormente i modelli, utilizza uno di questi metodi:

254 257 

271 274 

272#### Mappa ogni versione del modello a un profilo di inferenza275#### Mappa ogni versione del modello a un profilo di inferenza

273 276 

274Le variabili di ambiente `ANTHROPIC_DEFAULT_*_MODEL` configurano un profilo di inferenza per famiglia di modelli. Se la tua organizzazione ha bisogno di esporre diverse versioni della stessa famiglia nel selettore `/model`, ciascuna instradato al suo ARN del profilo di inferenza dell'applicazione, utilizza invece l'impostazione `modelOverrides` nel tuo [file di impostazioni](/it/settings#settings-files).277Le variabili di ambiente `ANTHROPIC_DEFAULT_*_MODEL` configurano un profilo di inferenza per famiglia di modelli. Se la tua organizzazione ha bisogno di esporre diverse versioni della stessa famiglia nel selettore `/model`, ciascuna instradata al suo ARN del profilo di inferenza dell'applicazione, utilizza invece l'impostazione `modelOverrides` nel tuo [file di impostazioni](/it/settings#settings-files).

275 278 

276Questo esempio mappa quattro versioni di Opus a ARN distinti in modo che gli utenti possano passare da uno all'altro senza aggirare i profili di inferenza della tua organizzazione:279Questo esempio mappa quattro versioni di Opus a ARN distinti in modo che gli utenti possano passare da uno all'altro senza aggirare i profili di inferenza della tua organizzazione:

277 280 

1507| `tasks/` | Elenchi di attività per sessione scritti dagli strumenti di attività |1507| `tasks/` | Elenchi di attività per sessione scritti dagli strumenti di attività |

1508| `shell-snapshots/` | Ambiente shell acquisito utilizzato dallo strumento Bash. Rimosso all'uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo. |1508| `shell-snapshots/` | Ambiente shell acquisito utilizzato dallo strumento Bash. Rimosso all'uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo. |

1509| `backups/` | Copie con timestamp di `~/.claude.json` prese prima delle migrazioni di configurazione |1509| `backups/` | Copie con timestamp di `~/.claude.json` prese prima delle migrazioni di configurazione |

1510| `feedback-bundles/` | Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti, per l'invio al tuo team di account Anthropic |

1510 1511 

1511### Mantenuti fino a quando non li elimini1512### Mantenuti fino a quando non li elimini

1512 1513 

99 99 

100Claude Code si connette dalle macchine degli utenti a Sentry per la registrazione degli errori operativi. I dati vengono crittografati in transito utilizzando TLS e a riposo utilizzando la crittografia AES a 256 bit. Scopri di più nella [documentazione sulla sicurezza di Sentry](https://sentry.io/security/). Per rinunciare alla registrazione degli errori, impostate la variabile di ambiente `DISABLE_ERROR_REPORTING`.100Claude Code si connette dalle macchine degli utenti a Sentry per la registrazione degli errori operativi. I dati vengono crittografati in transito utilizzando TLS e a riposo utilizzando la crittografia AES a 256 bit. Scopri di più nella [documentazione sulla sicurezza di Sentry](https://sentry.io/security/). Per rinunciare alla registrazione degli errori, impostate la variabile di ambiente `DISABLE_ERROR_REPORTING`.

101 101 

102Quando gli utenti eseguono il comando `/feedback`, una copia della loro cronologia completa della conversazione incluso il codice viene inviata ad Anthropic. I dati vengono crittografati in transito via TLS. Facoltativamente, viene creato un problema GitHub nel repository pubblico. Per rinunciare, impostate la variabile di ambiente `DISABLE_FEEDBACK_COMMAND` su `1`.102Quando eseguite il comando `/feedback`, una copia della cronologia della conversazione incluso il codice viene inviata ad Anthropic. Prima di inviare, scegliete quanta cronologia includere: la sessione corrente soltanto, che è l'impostazione predefinita, oppure anche altre sessioni dello stesso progetto negli ultimi 24 ore o 7 giorni. I dati vengono crittografati in transito via TLS. Facoltativamente, viene creato un problema GitHub nel repository pubblico. Per rinunciare, impostate la variabile di ambiente `DISABLE_FEEDBACK_COMMAND` su `1`.

103 

104Quando utilizzate un provider di terze parti come Bedrock o Vertex, oppure non avete credenziali Anthropic configurate, `/feedback` scrive il rapporto in un archivio locale sotto `~/.claude/feedback-bundles/` invece di inviarlo ad Anthropic. I modelli di chiave API e token noti vengono oscurati prima che l'archivio venga scritto. Nulla lascia la vostra macchina finché non inviate quel file al vostro rappresentante dell'account Anthropic o lo allegate a una richiesta di supporto.

103 105 

104## Comportamenti predefiniti per provider API106## Comportamenti predefiniti per provider API

105 107 

6 6 

7> Riferimento completo per le variabili d'ambiente che controllano il comportamento di Claude Code.7> Riferimento completo per le variabili d'ambiente che controllano il comportamento di Claude Code.

8 8 

9Claude Code supporta le seguenti variabili d'ambiente per controllare il suo comportamento. Impostale nella tua shell prima di avviare `claude`, oppure configurale in [`settings.json`](/it/settings#available-settings) sotto la chiave `env` per applicarle a ogni sessione o distribuirle nel tuo team.9Claude Code supporta le seguenti variabili d'ambiente per controllare il suo comportamento. Impostatele nella vostra shell prima di avviare `claude`, oppure configuratele in [`settings.json`](/it/settings#available-settings) sotto la chiave `env` per applicarle a ogni sessione o distribuirle nel vostro team.

10 10 

11| Variable | Purpose |11| Variable | Purpose |

12| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |12| :------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

13| `ANTHROPIC_API_KEY` | Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del tuo abbonamento Claude Pro, Max, Team o Enterprise anche se sei connesso. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, ti viene chiesto di approvare la chiave una volta prima che sostituisca il tuo abbonamento. Per utilizzare il tuo abbonamento, esegui `unset ANTHROPIC_API_KEY` |13| `ANTHROPIC_API_KEY` | Chiave API inviata come intestazione `X-Api-Key`. Quando impostata, questa chiave viene utilizzata al posto del vostro abbonamento Claude Pro, Max, Team o Enterprise anche se siete connessi. In modalità non interattiva (`-p`), la chiave viene sempre utilizzata quando presente. In modalità interattiva, vi viene chiesto di approvare la chiave una volta prima che sostituisca il vostro abbonamento. Per utilizzare il vostro abbonamento, eseguite `unset ANTHROPIC_API_KEY` |

14| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'intestazione `Authorization` (il valore che imposti qui sarà preceduto da `Bearer `) |14| `ANTHROPIC_AUTH_TOKEN` | Valore personalizzato per l'intestazione `Authorization` (il valore che impostate qui sarà preceduto da `Bearer `) |

15| `ANTHROPIC_AWS_API_KEY` | Chiave API dell'area di lavoro per [Claude Platform on AWS](/it/claude-platform-on-aws), generata nella Console AWS. Inviata come `x-api-key` e ha la precedenza su AWS SigV4 |15| `ANTHROPIC_AWS_API_KEY` | Chiave API dell'area di lavoro per [Claude Platform on AWS](/it/claude-platform-on-aws), generata nella Console AWS. Inviata come `x-api-key` e ha la precedenza su AWS SigV4 |

16| `ANTHROPIC_AWS_BASE_URL` | Sovrascrivi l'URL dell'endpoint [Claude Platform on AWS](/it/claude-platform-on-aws). Utilizza per regioni personalizzate o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Per impostazione predefinita `https://aws-external-anthropic.{AWS_REGION}.api.aws` |16| `ANTHROPIC_AWS_BASE_URL` | Sovrascrivi l'URL dell'endpoint [Claude Platform on AWS](/it/claude-platform-on-aws). Utilizza per regioni personalizzate o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Per impostazione predefinita `https://aws-external-anthropic.{AWS_REGION}.api.aws` |

17| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatorio per [Claude Platform on AWS](/it/claude-platform-on-aws). Inviato su ogni richiesta come intestazione `anthropic-workspace-id` |17| `ANTHROPIC_AWS_WORKSPACE_ID` | Obbligatorio per [Claude Platform on AWS](/it/claude-platform-on-aws). Inviato su ogni richiesta come intestazione `anthropic-workspace-id` |

18| `ANTHROPIC_BASE_URL` | Sovrascrivi l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, la [ricerca degli strumenti MCP](/it/mcp#scale-with-mcp-tool-search) è disabilitata per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il tuo proxy inoltra i blocchi `tool_reference` |18| `ANTHROPIC_BASE_URL` | Sovrascrivi l'endpoint API per instradare le richieste attraverso un proxy o gateway. Quando impostato su un host non di prima parte, la [ricerca degli strumenti MCP](/it/mcp#scale-with-mcp-tool-search) è disabilitata per impostazione predefinita. Imposta `ENABLE_TOOL_SEARCH=true` se il vostro proxy inoltra i blocchi `tool_reference` |

19| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrivi l'URL dell'endpoint Bedrock. Utilizza per endpoint Bedrock personalizzati o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Vedi [Amazon Bedrock](/it/amazon-bedrock) |19| `ANTHROPIC_BEDROCK_BASE_URL` | Sovrascrivi l'URL dell'endpoint Bedrock. Utilizza per endpoint Bedrock personalizzati o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Vedi [Amazon Bedrock](/it/amazon-bedrock) |

20| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrivi l'URL dell'endpoint Bedrock Mantle. Vedi [Endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) |20| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Sovrascrivi l'URL dell'endpoint Bedrock Mantle. Vedi [Endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) |

21| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [service tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedi [Amazon Bedrock](/it/amazon-bedrock#service-tiers) |21| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Bedrock [service tier](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html) (`default`, `flex` o `priority`). Inviato come intestazione `X-Amzn-Bedrock-Service-Tier`. Vedi [Amazon Bedrock](/it/amazon-bedrock#service-tiers) |

42| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedi [Microsoft Foundry](/it/microsoft-foundry)) |42| `ANTHROPIC_FOUNDRY_RESOURCE` | Nome della risorsa Foundry (ad esempio, `my-resource`). Obbligatorio se `ANTHROPIC_FOUNDRY_BASE_URL` non è impostato (vedi [Microsoft Foundry](/it/microsoft-foundry)) |

43| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da utilizzare (vedi [Configurazione del modello](/it/model-config#environment-variables)) |43| `ANTHROPIC_MODEL` | Nome dell'impostazione del modello da utilizzare (vedi [Configurazione del modello](/it/model-config#environment-variables)) |

44| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATO] Nome del [modello di classe Haiku per attività in background](/it/costs) |44| `ANTHROPIC_SMALL_FAST_MODEL` | \[DEPRECATO] Nome del [modello di classe Haiku per attività in background](/it/costs) |

45| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrivi la regione AWS per il modello di classe Haiku quando utilizzi Bedrock o Bedrock Mantle |45| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Sovrascrivi la regione AWS per il modello di classe Haiku quando utilizzate Bedrock o Bedrock Mantle. Su Bedrock, questo ha effetto solo quando `ANTHROPIC_DEFAULT_HAIKU_MODEL` o il deprecato `ANTHROPIC_SMALL_FAST_MODEL` è anche impostato, poiché Bedrock altrimenti utilizza il modello primario per le attività in background |

46| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrivi l'URL dell'endpoint Vertex AI. Utilizza per endpoint Vertex personalizzati o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Vedi [Google Vertex AI](/it/google-vertex-ai) |46| `ANTHROPIC_VERTEX_BASE_URL` | Sovrascrivi l'URL dell'endpoint Vertex AI. Utilizza per endpoint Vertex personalizzati o quando instrada attraverso un [gateway LLM](/it/llm-gateway). Vedi [Google Vertex AI](/it/google-vertex-ai) |

47| `ANTHROPIC_VERTEX_PROJECT_ID` | ID progetto GCP per le richieste Vertex AI. Sovrascritto da `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` o dal progetto nel tuo file di credenziali `GOOGLE_APPLICATION_CREDENTIALS`. Vedi [Google Vertex AI](/it/google-vertex-ai) |47| `ANTHROPIC_VERTEX_PROJECT_ID` | ID progetto GCP per le richieste Vertex AI. Sovrascritto da `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` o dal progetto nel vostro file di credenziali `GOOGLE_APPLICATION_CREDENTIALS`. Vedi [Google Vertex AI](/it/google-vertex-ai) |

48| `ANTHROPIC_WORKSPACE_ID` | ID area di lavoro per la [federazione dell'identità del carico di lavoro](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Imposta questo quando la tua regola di federazione è limitata a più di un'area di lavoro in modo che lo scambio di token sappia quale area di lavoro indirizzare |48| `ANTHROPIC_WORKSPACE_ID` | ID area di lavoro per la [federazione dell'identità del carico di lavoro](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation). Impostate questo quando la vostra regola di federazione è limitata a più di un'area di lavoro in modo che lo scambio di token sappia quale area di lavoro indirizzare |

49| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumenta questo valore quando le richieste scadono su reti lente o quando instrada attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste |49| `API_TIMEOUT_MS` | Timeout per le richieste API in millisecondi (predefinito: 600000, o 10 minuti; massimo: 2147483647). Aumentate questo valore quando le richieste scadono su reti lente o quando instradate attraverso un proxy. I valori superiori al massimo causano un overflow del timer sottostante e causano il fallimento immediato delle richieste |

50| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API Bedrock per l'autenticazione (vedi [Chiavi API Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |50| `AWS_BEARER_TOKEN_BEDROCK` | Chiave API Bedrock per l'autenticazione (vedi [Chiavi API Bedrock](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)) |

51| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti) |51| `BASH_DEFAULT_TIMEOUT_MS` | Timeout predefinito per i comandi bash a lunga esecuzione (predefinito: 120000, o 2 minuti) |

52| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri negli output bash prima che l'output completo venga salvato in un file e Claude riceva il percorso più un'anteprima breve. Vedi [Comportamento dello strumento Bash](/it/tools-reference#bash-tool-behavior) |52| `BASH_MAX_OUTPUT_LENGTH` | Numero massimo di caratteri negli output bash prima che l'output completo venga salvato in un file e Claude riceva il percorso più un'anteprima breve. Vedi [Comportamento dello strumento Bash](/it/tools-reference#bash-tool-behavior) |

53| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti) |53| `BASH_MAX_TIMEOUT_MS` | Timeout massimo che il modello può impostare per i comandi bash a lunga esecuzione (predefinito: 600000, o 10 minuti) |

54| `CCR_FORCE_BUNDLE` | Imposta su `1` per forzare [`claude --remote`](/it/claude-code-on-the-web#send-local-repositories-without-github) a raggruppare e caricare il tuo repository locale anche quando l'accesso a GitHub è disponibile |54| `CCR_FORCE_BUNDLE` | Imposta su `1` per forzare [`claude --remote`](/it/claude-code-on-the-web#send-local-repositories-without-github) a raggruppare e caricare il vostro repository locale anche quando l'accesso a GitHub è disponibile |

55| `CLAUDECODE` | Imposta su `1` negli ambienti shell che Claude Code genera (strumento Bash, sessioni tmux). Non impostato negli [hook](/it/hooks) o nei comandi della [linea di stato](/it/statusline). Utilizza per rilevare quando uno script è in esecuzione all'interno di una shell generata da Claude Code |55| `CLAUDECODE` | Imposta su `1` negli ambienti shell che Claude Code genera (strumento Bash, sessioni tmux). Non impostato negli [hook](/it/hooks) o nei comandi della [linea di stato](/it/statusline). Utilizza per rilevare quando uno script è in esecuzione all'interno di una shell generata da Claude Code |

56| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta su `1` per disabilitare tutti i tipi di [subagent](/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita |56| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | Imposta su `1` per disabilitare tutti i tipi di [subagent](/it/sub-agents) integrati come Explore e Plan. Si applica solo in modalità non interattiva (il flag `-p`). Utile per gli utenti SDK che desiderano una lavagna pulita |

57| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta su `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK |57| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | Imposta su `1` per saltare il prefisso `mcp__<server>__` sui nomi degli strumenti dai server MCP creati da SDK. Gli strumenti utilizzano i loro nomi originali. Solo utilizzo SDK |

58| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent in background. Predefinito `600000` (10 minuti). Il timer si ripristina su ogni evento di progresso dello streaming; se nessun progresso arriva entro la finestra, il subagent viene interrotto e l'attività viene contrassegnata come non riuscita, mostrando qualsiasi risultato parziale al genitore |58| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | Timeout di stallo in millisecondi per i subagent in background. Predefinito `600000` (10 minuti). Il timer si ripristina su ogni evento di progresso dello streaming; se nessun progresso arriva entro la finestra, il subagent viene interrotto e l'attività viene contrassegnata come non riuscita, mostrando qualsiasi risultato parziale al genitore |

59| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale della capacità del contesto (1-100) a cui viene attivata la compattazione automatica. Per impostazione predefinita, la compattazione automatica si attiva a circa il 95% della capacità. Utilizza valori inferiori come `50` per compattare prima. I valori superiori alla soglia predefinita non hanno effetto. Si applica sia alle conversazioni principali che ai subagent. Questa percentuale si allinea con il campo `context_window.used_percentage` disponibile nella [linea di stato](/it/statusline) |59| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale della capacità del contesto (1-100) a cui viene attivata la compattazione automatica. Per impostazione predefinita, la compattazione automatica si attiva a circa il 95% della capacità. Utilizzate valori inferiori come `50` per compattare prima. I valori superiori alla soglia predefinita non hanno effetto. Si applica sia alle conversazioni principali che ai subagent. Questa percentuale si allinea con il campo `context_window.used_percentage` disponibile nella [linea di stato](/it/statusline) |

60| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta su `1` per forzare l'abilitazione dello sfondo automatico delle attività di agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l'esecuzione per circa due minuti |60| `CLAUDE_AUTO_BACKGROUND_TASKS` | Imposta su `1` per forzare l'abilitazione dello sfondo automatico delle attività di agenti a lunga esecuzione. Quando abilitato, i subagent vengono spostati in background dopo l'esecuzione per circa due minuti |

61| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Ritorna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |61| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | Ritorna alla directory di lavoro originale dopo ogni comando Bash o PowerShell nella sessione principale |

62| `CLAUDE_CODE_ACCESSIBILITY` | Imposta su `1` per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore |62| `CLAUDE_CODE_ACCESSIBILITY` | Imposta su `1` per mantenere visibile il cursore del terminale nativo e disabilitare l'indicatore del cursore con testo invertito. Consente ai magnifier dello schermo come macOS Zoom di tracciare la posizione del cursore |

63| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |63| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | Imposta su `1` per caricare i file di memoria dalle directory specificate con `--add-dir`. Carica `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/*.md` e `CLAUDE.local.md`. Per impostazione predefinita, le directory aggiuntive non caricano i file di memoria |

64| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi a cui le credenziali devono essere aggiornate (quando si utilizza [`apiKeyHelper`](/it/settings#available-settings)) |64| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Intervallo in millisecondi a cui le credenziali devono essere aggiornate (quando si utilizza [`apiKeyHelper`](/it/settings#available-settings)) |

65| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta su `0` per omettere il blocco di attribuzione (versione client e impronta digitale del prompt) dall'inizio del prompt di sistema. Disabilitarlo migliora i tassi di hit della cache dei prompt quando si instrada attraverso un [gateway LLM](/it/llm-gateway). Il caching dell'API Anthropic non è interessato |65| `CLAUDE_CODE_ATTRIBUTION_HEADER` | Imposta su `0` per omettere il blocco di attribuzione (versione client e impronta digitale del prompt) dall'inizio del prompt di sistema. Disabilitarlo migliora i tassi di hit della cache dei prompt quando si instrada attraverso un [gateway LLM](/it/llm-gateway). Il caching dell'API Anthropic non è interessato |

66| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la capacità del contesto in token utilizzata per i calcoli di compattazione automatica. Per impostazione predefinita, la finestra del contesto del modello: 200K per i modelli standard o 1M per i modelli con [contesto esteso](/it/model-config#extended-context). Utilizza un valore inferiore come `500000` su un modello 1M per trattare la finestra come 500K ai fini della compattazione. Il valore è limitato alla finestra del contesto effettiva del modello. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` viene applicato come percentuale di questo valore. L'impostazione di questa variabile disaccoppia la soglia di compattazione dalla `used_percentage` della linea di stato, che utilizza sempre la finestra del contesto completa del modello |66| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | Imposta la capacità del contesto in token utilizzata per i calcoli di compattazione automatica. Per impostazione predefinita, la finestra del contesto del modello: 200K per i modelli standard o 1M per i modelli con [contesto esteso](/it/model-config#extended-context). Utilizzate un valore inferiore come `500000` su un modello 1M per trattare la finestra come 500K ai fini della compattazione. Il valore è limitato alla finestra del contesto effettiva del modello. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` viene applicato come percentuale di questo valore. L'impostazione di questa variabile disaccoppia la soglia di compattazione dalla `used_percentage` della linea di stato, che utilizza sempre la finestra del contesto completa del modello |

67| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrivi la [connessione IDE](/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Imposta su `false` per impedire questo. Imposta su `true` per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale padre. Ha la precedenza sull'impostazione globale [`autoConnectIde`](/it/settings#global-config-settings) |67| `CLAUDE_CODE_AUTO_CONNECT_IDE` | Sovrascrivi la [connessione IDE](/it/vs-code) automatica. Per impostazione predefinita, Claude Code si connette automaticamente quando avviato all'interno del terminale integrato di un IDE supportato. Imposta su `false` per impedire questo. Imposta su `true` per forzare un tentativo di connessione quando l'auto-rilevamento fallisce, ad esempio quando tmux oscura il terminale padre. Ha la precedenza sull'impostazione globale [`autoConnectIde`](/it/settings#global-config-settings) |

68| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. `bundled` è il set Mozilla CA fornito con Claude Code. `system` è l'archivio di fiducia del sistema operativo. Per impostazione predefinita è `bundled,system` |68| `CLAUDE_CODE_CERT_STORE` | Elenco separato da virgole di fonti di certificati CA per le connessioni TLS. `bundled` è il set Mozilla CA fornito con Claude Code. `system` è l'archivio di fiducia del sistema operativo. Per impostazione predefinita è `bundled,system` |

69| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |69| `CLAUDE_CODE_CLIENT_CERT` | Percorso del file del certificato client per l'autenticazione mTLS |

70| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata client per l'autenticazione mTLS |70| `CLAUDE_CODE_CLIENT_KEY` | Percorso del file della chiave privata client per l'autenticazione mTLS |

71| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per CLAUDE\_CODE\_CLIENT\_KEY crittografato (facoltativo) |71| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase per CLAUDE\_CODE\_CLIENT\_KEY crittografato (facoltativo) |

72| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrivi il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite `--debug` o `/debug`: l'impostazione di questa variabile da sola non abilita la registrazione. Il flag [`--debug-file`](/it/cli-reference#cli-flags) fa entrambi contemporaneamente. Per impostazione predefinita `~/.claude/debug/<session-id>.txt` |72| `CLAUDE_CODE_DEBUG_LOGS_DIR` | Sovrascrivi il percorso del file di log di debug. Nonostante il nome, questo è un percorso di file, non una directory. Richiede che la modalità debug sia abilitata separatamente tramite `--debug`, `/debug` o la variabile d'ambiente `DEBUG`: l'impostazione di questa variabile da sola non abilita la registrazione. Il flag [`--debug-file`](/it/cli-reference#cli-flags) fa entrambi contemporaneamente. Per impostazione predefinita `~/.claude/debug/<session-id>.txt` |

73| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della linea di stato, o aumenta a `error` per ridurre il rumore |73| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | Livello di log minimo scritto nel file di log di debug. Valori: `verbose`, `debug` (predefinito), `info`, `warn`, `error`. Imposta su `verbose` per includere diagnostica ad alto volume come l'output completo del comando della linea di stato, o aumenta a `error` per ridurre il rumore |

74| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta su `1` per disabilitare il supporto della [finestra del contesto 1M](/it/model-config#extended-context). Se impostato, le varianti del modello 1M non sono disponibili nel selettore di modelli. Utile per ambienti aziendali con requisiti di conformità |74| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | Imposta su `1` per disabilitare il supporto della [finestra del contesto 1M](/it/model-config#extended-context). Se impostato, le varianti del modello 1M non sono disponibili nel selettore di modelli. Utile per ambienti aziendali con requisiti di conformità |

75| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta su `1` per disabilitare il [ragionamento adattivo](/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e tornare al budget di thinking fisso controllato da `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}Non ha effetto su Opus 4.7, che utilizza sempre il ragionamento adattivo |75| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Imposta su `1` per disabilitare il [ragionamento adattivo](/it/model-config#adjust-effort-level) su Opus 4.6 e Sonnet 4.6 e tornare al budget di thinking fisso controllato da `MAX_THINKING_TOKENS`. {/* min-version: 2.1.111 */}Non ha effetto su Opus 4.7, che utilizza sempre il ragionamento adattivo |

76| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta su `1` per disattivare gli [agenti in background e la visualizzazione degli agenti](/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione [`disableAgentView`](/it/settings#available-settings) |76| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | Imposta su `1` per disattivare gli [agenti in background e la visualizzazione degli agenti](/it/agent-view): `claude agents`, `--bg`, `/background` e il supervisore su richiesta. Equivalente all'impostazione [`disableAgentView`](/it/settings#available-settings) |

77| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del tuo terminale in modo che `Cmd+f` e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/it/settings#available-settings). Puoi anche passare con `/tui default` |77| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che `Cmd+f` e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/it/settings#available-settings). Potete anche passare con `/tui default` |

78| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file |78| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | Imposta su `1` per disabilitare l'elaborazione degli allegati. Le menzioni di file con la sintassi `@` vengono inviate come testo semplice invece di essere espanse nel contenuto del file |

79| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta su `1` per disabilitare la [memoria automatica](/it/memory#auto-memory). Imposta su `0` per forzare la memoria automatica anche quando [`autoMemoryEnabled: false`](/it/settings#available-settings) altrimenti la disabiliterebbe. Quando disabilitato, Claude non crea o carica i file di memoria automatica |79| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Imposta su `1` per disabilitare la [memoria automatica](/it/memory#auto-memory). Imposta su `0` per forzare la memoria automatica anche quando la modalità [`--bare`](/it/headless#start-faster-with-bare-mode) o [`autoMemoryEnabled: false`](/it/settings#available-settings) altrimenti la disabiliterebbe. Quando disabilitato, Claude non crea o carica i file di memoria automatica |

80| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disabilitare tutta la funzionalità di attività in background, incluso il parametro `run_in_background` su strumenti Bash e subagent, auto-backgrounding e la scorciatoia Ctrl+B |80| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disabilitare tutta la funzionalità di attività in background, incluso il parametro `run_in_background` su strumenti Bash e subagent, auto-backgrounding e la scorciatoia Ctrl+B |

81| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di utente, progetto e memoria automatica |81| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | Imposta su `1` per impedire il caricamento di qualsiasi file di memoria CLAUDE.md nel contesto, inclusi i file di utente, progetto e memoria automatica |

82| `CLAUDE_CODE_DISABLE_CRON` | Imposta su `1` per disabilitare le [attività pianificate](/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse le attività già in esecuzione a metà sessione |82| `CLAUDE_CODE_DISABLE_CRON` | Imposta su `1` per disabilitare le [attività pianificate](/it/scheduled-tasks). La skill `/loop` e gli strumenti cron diventano non disponibili e tutte le attività già pianificate smettono di attivarsi, incluse le attività già in esecuzione a metà sessione |

83| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema degli strumenti beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizza questo quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. |83| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Imposta su `1` per rimuovere le intestazioni di richiesta `anthropic-beta` specifiche di Anthropic e i campi dello schema degli strumenti beta (come `defer_loading` e `eager_input_streaming`) dalle richieste API. Utilizza questo quando un gateway proxy rifiuta le richieste con errori come "Unexpected value(s) for the `anthropic-beta` header" o "Extra inputs are not permitted". I campi standard (`name`, `description`, `input_schema`, `cache_control`) vengono preservati. |

84| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disabilitare la [modalità veloce](/it/fast-mode) |84| `CLAUDE_CODE_DISABLE_FAST_MODE` | Imposta su `1` per disabilitare la [modalità veloce](/it/fast-mode) |

85| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non opti di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizza l'impostazione [`feedbackSurveyRate`](/it/settings#available-settings). Vedi [Sondaggi sulla qualità della sessione](/it/data-usage#session-quality-surveys) |85| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Imposta su `1` per disabilitare i sondaggi sulla qualità della sessione "Come sta andando Claude?". I sondaggi sono anche disabilitati quando `DISABLE_TELEMETRY`, `DO_NOT_TRACK` o `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` è impostato, a meno che `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` non opti di nuovo. Per impostare una frequenza di campionamento invece di disabilitare completamente, utilizzate l'impostazione [`feedbackSurveyRate`](/it/settings#available-settings). Vedi [Sondaggi sulla qualità della sessione](/it/data-usage#session-quality-surveys) |

86| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disabilitare il [checkpointing](/it/checkpointing) dei file. Il comando `/rewind` non sarà in grado di ripristinare le modifiche al codice |86| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | Imposta su `1` per disabilitare il [checkpointing](/it/checkpointing) dei file. Il comando `/rewind` non sarà in grado di ripristinare le modifiche al codice |

87| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta su `1` per rimuovere le istruzioni di workflow commit e PR integrate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di workflow git. Ha la precedenza sull'impostazione [`includeGitInstructions`](/it/settings#available-settings) se impostato |87| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Imposta su `1` per rimuovere le istruzioni di workflow commit e PR integrate e lo snapshot dello stato git dal prompt di sistema di Claude. Utile quando si utilizzano le proprie skill di workflow git. Ha la precedenza sull'impostazione [`includeGitInstructions`](/it/settings#available-settings) se impostato |

88| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta su `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizza quando desideri intenzionalmente fissare un modello più vecchio. Il remapping non viene eseguito su Bedrock, Vertex o Foundry |88| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Imposta su `1` per impedire il remapping automatico di Opus 4.0 e 4.1 alla versione Opus corrente sull'API Anthropic. Utilizza quando desiderate intenzionalmente fissare un modello più vecchio. Il remapping non viene eseguito su Bedrock, Vertex o Foundry |

89| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` funziona ancora. Utilizza questo per mantenere il comportamento nativo di copia al passaggio del mouse del tuo terminale |89| `CLAUDE_CODE_DISABLE_MOUSE` | Imposta su `1` per disabilitare il tracciamento del mouse nel [rendering a schermo intero](/it/fullscreen). Lo scorrimento da tastiera con `PgUp` e `PgDn` funziona ancora. Utilizza questo per mantenere il comportamento nativo di copia al passaggio del mouse del vostro terminale |

90| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Equivalente all'impostazione di `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY` |90| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Equivalente all'impostazione di `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` e `DISABLE_TELEMETRY` |

91| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta su `1` per disabilitare il fallback non-streaming quando una richiesta di streaming fallisce a metà stream. Gli errori di streaming si propagano al livello di retry. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione duplicata dello strumento |91| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | Imposta su `1` per disabilitare il fallback non-streaming quando una richiesta di streaming fallisce a metà stream. Gli errori di streaming si propagano al livello di retry. Utile quando un proxy o gateway causa il fallback per produrre l'esecuzione duplicata dello strumento |

92| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta su `1` per saltare l'aggiunta automatica del marketplace ufficiale dei plugin al primo avvio |92| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | Imposta su `1` per saltare l'aggiunta automatica del marketplace ufficiale dei plugin al primo avvio |

97| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` o `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `/effort` e sull'impostazione `effortLevel`. Vedi [Regola il livello di sforzo](/it/model-config#adjust-effort-level) |97| `CLAUDE_CODE_EFFORT_LEVEL` | Imposta il livello di sforzo per i modelli supportati. Valori: `low`, `medium`, `high`, `xhigh`, `max` o `auto` per usare il valore predefinito del modello. I livelli disponibili dipendono dal modello. Ha la precedenza su `/effort` e sull'impostazione `effortLevel`. Vedi [Regola il livello di sforzo](/it/model-config#adjust-effort-level) |

98| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrivi la disponibilità del [riepilogo della sessione](/it/interactive-mode#session-recap). Imposta su `0` per forzare i riepiloghi disattivati indipendentemente dall'interruttore `/config`. Imposta su `1` per forzare i riepiloghi attivati quando [`awaySummaryEnabled`](/it/settings#available-settings) è `false`. Ha la precedenza sull'impostazione e sull'interruttore `/config` |98| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | Sovrascrivi la disponibilità del [riepilogo della sessione](/it/interactive-mode#session-recap). Imposta su `0` per forzare i riepiloghi disattivati indipendentemente dall'interruttore `/config`. Imposta su `1` per forzare i riepiloghi attivati quando [`awaySummaryEnabled`](/it/settings#available-settings) è `false`. Ha la precedenza sull'impostazione e sull'interruttore `/config` |

99| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta su `1` per aggiornare lo stato del plugin ai confini dei turni in [modalità non interattiva](/it/headless) dopo il completamento di un'installazione in background. Disattivato per impostazione predefinita perché l'aggiornamento cambia il prompt di sistema a metà sessione, il che invalida il [caching dei prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) per quel turno |99| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | Imposta su `1` per aggiornare lo stato del plugin ai confini dei turni in [modalità non interattiva](/it/headless) dopo il completamento di un'installazione in background. Disattivato per impostazione predefinita perché l'aggiornamento cambia il prompt di sistema a metà sessione, il che invalida il [caching dei prompt](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) per quel turno |

100| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Imposta su `1` per instradare il sondaggio sulla qualità della sessione "Come sta andando Claude?" al tuo [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 tuo 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 tuo 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` | 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 |

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 tuo 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` | 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) |

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 |

109| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente |109| `CLAUDE_CODE_EXTRA_BODY` | Oggetto JSON da unire al livello superiore di ogni corpo di richiesta API. Utile per passare parametri specifici del provider che Claude Code non espone direttamente |

110| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrivi il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero |110| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | Sovrascrivi il limite di token predefinito per le letture di file. Utile quando è necessario leggere file più grandi per intero |

111| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta su `1` per forzare l'abilitazione della modalità privata DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando il tuo terminale la supporta ma non viene rilevato automaticamente. Utile per emulatori come Emacs `eat` che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux |111| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Imposta su `1` per forzare l'abilitazione della modalità privata DEC 2026 [synchronized output](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) quando il vostro terminale la supporta ma non viene rilevato automaticamente. Utile per emulatori come Emacs `eat` che implementano BSU/ESU ma non rispondono al probe di capacità. Non ha effetto sotto tmux |

112| `CLAUDE_CODE_FORK_SUBAGENT` | Imposta su `1` per abilitare i [subagent biforcati](/it/sub-agents#fork-the-current-conversation). Un subagent biforcato eredita il contesto della conversazione completa dalla sessione principale invece di iniziare da zero. Quando abilitato, `/fork` genera un subagent biforcato piuttosto che agire come alias per [`/branch`](/it/commands), e tutti gli spawn di subagent vengono eseguiti in background. Funziona in modalità interattiva e tramite SDK o `claude -p` |112| `CLAUDE_CODE_FORK_SUBAGENT` | Imposta su `1` per abilitare i [subagent biforcati](/it/sub-agents#fork-the-current-conversation). Un subagent biforcato eredita il contesto della conversazione completa dalla sessione principale invece di iniziare da zero. Quando abilitato, `/fork` genera un subagent biforcato piuttosto che agire come alias per [`/branch`](/it/commands), e tutti gli spawn di subagent vengono eseguiti in background. Funziona in modalità interattiva e tramite SDK o `claude -p` |

113| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile Git Bash (`bash.exe`). Utilizza quando Git Bash è installato ma non nel tuo PATH. Vedi [Configurazione di Windows](/it/setup#set-up-on-windows) |113| `CLAUDE_CODE_GIT_BASH_PATH` | Solo Windows: percorso dell'eseguibile Git Bash (`bash.exe`). Utilizza quando Git Bash è installato ma non nel vostro PATH. Vedi [Configurazione di Windows](/it/setup#set-up-on-windows) |

114| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta su `false` per escludere i dotfile dai risultati quando Claude richiama lo [strumento Glob](/it/tools-reference#glob-tool-behavior). Incluso per impostazione predefinita. Non influisce su `@` file autocomplete, `ls`, Grep o Read |114| `CLAUDE_CODE_GLOB_HIDDEN` | Imposta su `false` per escludere i dotfile dai risultati quando Claude richiama lo [strumento Glob](/it/tools-reference#glob-tool-behavior). Incluso per impostazione predefinita. Non influisce su `@` file autocomplete, `ls`, Grep o Read |

115| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta su `false` per fare in modo che lo [strumento Glob](/it/tools-reference#glob-tool-behavior) rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su `@` file autocomplete, che ha la sua propria impostazione [`respectGitignore`](/it/settings#available-settings) |115| `CLAUDE_CODE_GLOB_NO_IGNORE` | Imposta su `false` per fare in modo che lo [strumento Glob](/it/tools-reference#glob-tool-behavior) rispetti i modelli `.gitignore`. Per impostazione predefinita, Glob restituisce tutti i file corrispondenti inclusi quelli gitignored. Non influisce su `@` file autocomplete, che ha la sua propria impostazione [`respectGitignore`](/it/settings#available-settings) |

116| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per la scoperta dei file dello strumento Glob. Per impostazione predefinita 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |116| `CLAUDE_CODE_GLOB_TIMEOUT_SECONDS` | Timeout in secondi per la scoperta dei file dello strumento Glob. Per impostazione predefinita 20 secondi sulla maggior parte delle piattaforme e 60 secondi su WSL |

117| `CLAUDE_CODE_HIDE_CWD` | Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni in cui il percorso espone il tuo nome utente del sistema operativo |117| `CLAUDE_CODE_HIDE_CWD` | Imposta su `1` per nascondere la directory di lavoro nel logo di avvio. Utile per screenshare o registrazioni in cui il percorso espone il vostro nome utente del sistema operativo |

118| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrivi l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso il routing WSL-to-Windows |118| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | Sovrascrivi l'indirizzo host utilizzato per connettersi all'estensione IDE. Per impostazione predefinita Claude Code rileva automaticamente l'indirizzo corretto, incluso il routing WSL-to-Windows |

119| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Salta l'installazione automatica delle estensioni IDE. Equivalente all'impostazione di [`autoInstallIdeExtension`](/it/settings#global-config-settings) su `false` |119| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Salta l'installazione automatica delle estensioni IDE. Equivalente all'impostazione di [`autoInstallIdeExtension`](/it/settings#global-config-settings) su `false` |

120| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta su `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizza quando l'auto-connessione non riesce a trovare il tuo IDE nonostante sia in esecuzione |120| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | Imposta su `1` per saltare la convalida delle voci del file di blocco IDE durante la connessione. Utilizza quando l'auto-connessione non riesce a trovare il vostro IDE nonostante sia in esecuzione |

121| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrivi la dimensione della finestra del contesto che Claude Code assume per il modello attivo. Ha effetto solo quando `DISABLE_COMPACT` è anche impostato. Utilizza questo quando instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra del contesto non corrisponde alla dimensione integrata per il suo nome |121| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Sovrascrivi la dimensione della finestra del contesto che Claude Code assume per il modello attivo. Ha effetto solo quando `DISABLE_COMPACT` è anche impostato. Utilizza questo quando instrada a un modello attraverso `ANTHROPIC_BASE_URL` la cui finestra del contesto non corrisponde alla dimensione integrata per il suo nome |

122| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e massimi variano in base al modello; vedi [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). L'aumento di questo valore riduce la finestra del contesto effettiva disponibile prima che venga attivata la [compattazione automatica](/it/costs#reduce-token-usage). |122| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Imposta il numero massimo di token di output per la maggior parte delle richieste. I valori predefiniti e massimi variano in base al modello; vedi [max output tokens](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison). L'aumento di questo valore riduce la finestra del contesto effettiva disponibile prima che venga attivata la [compattazione automatica](/it/costs#reduce-token-usage). |

123| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10) |123| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10) |

124| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |124| `CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` | Numero massimo di strumenti di sola lettura e subagent che possono essere eseguiti in parallelo (predefinito: 10). Valori più alti aumentano il parallelismo ma consumano più risorse |

125| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivalente a passare [`--max-turns`](/it/cli-reference#cli-flags), che ha la precedenza quando entrambi sono impostati. Un valore che non è un intero positivo viene rifiutato all'avvio con un errore piuttosto che trattato come nessun limite |125| `CLAUDE_CODE_MAX_TURNS` | Limita il numero di turni agentici quando non viene passato un limite esplicito. Equivalente a passare [`--max-turns`](/it/cli-reference#cli-flags), che ha la precedenza quando entrambi sono impostati. Un valore che non è un intero positivo viene rifiutato all'avvio con un errore piuttosto che trattato come nessun limite |

126| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta su `1` per generare server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l'ambiente della tua shell |126| `CLAUDE_CODE_MCP_ALLOWLIST_ENV` | Imposta su `1` per generare server MCP stdio con solo un ambiente di base sicuro più il `env` configurato del server, invece di ereditare l'ambiente della vostra shell |

127| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta su `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale |127| `CLAUDE_CODE_NATIVE_CURSOR` | Imposta su `1` per mostrare il cursore proprio del terminale al cursore di input invece di un blocco disegnato. Il cursore rispetta le impostazioni di lampeggio, forma e focus del terminale |

128| `CLAUDE_CODE_NEW_INIT` | Imposta su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere. |128| `CLAUDE_CODE_NEW_INIT` | Imposta su `1` per fare in modo che `/init` esegua un flusso di configurazione interattivo. Il flusso chiede quali file generare, inclusi CLAUDE.md, skill e hook, prima di esplorare la base di codice e scriverli. Senza questa variabile, `/init` genera un CLAUDE.md automaticamente senza chiedere. |

129| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per abilitare il [rendering a schermo intero](/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Equivalente all'impostazione [`tui`](/it/settings#available-settings); puoi anche passare con `/tui fullscreen` |129| `CLAUDE_CODE_NO_FLICKER` | Imposta su `1` per abilitare il [rendering a schermo intero](/it/fullscreen), un'anteprima di ricerca che riduce lo sfarfallio e mantiene la memoria piatta nelle conversazioni lunghe. Equivalente all'impostazione [`tui`](/it/settings#available-settings); potete anche passare con `/tui fullscreen` |

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. Generane 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 imposta questo se hai 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. 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 |

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). Aumenta 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) |

137| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del tuo gestore di pacchetti in background quando una nuova versione è disponibile. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi [Aggiornamenti automatici](/it/setup#auto-updates) |137| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Imposta su `1` per consentire a Claude Code di eseguire il comando di aggiornamento del vostro gestore di pacchetti in background quando una nuova versione è disponibile. Si applica alle installazioni Homebrew e WinGet. Gli altri gestori di pacchetti continuano a mostrare il comando di aggiornamento senza eseguirlo. Vedi [Aggiornamenti automatici](/it/setup#auto-updates) |

138| `CLAUDE_CODE_PERFORCE_MODE` | Imposta su `1` per abilitare la protezione da scrittura consapevole di Perforce. Se impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca del bit di scrittura del proprietario, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |138| `CLAUDE_CODE_PERFORCE_MODE` | Imposta su `1` per abilitare la protezione da scrittura consapevole di Perforce. Se impostato, Edit, Write e NotebookEdit falliscono con un suggerimento `p4 edit <file>` se il file di destinazione manca del bit di scrittura del proprietario, che Perforce cancella sui file sincronizzati fino a quando `p4 edit` non li apre. Questo impedisce a Claude Code di aggirare il tracciamento dei cambiamenti di Perforce |

139| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrivi la directory radice dei plugin. Nonostante il nome, questo imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory sotto questo percorso. Per impostazione predefinita `~/.claude/plugins` |139| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | Sovrascrivi la directory radice dei plugin. Nonostante il nome, questo imposta la directory padre, non la cache stessa: i marketplace e la cache dei plugin si trovano in sottodirectory sotto questo percorso. Per impostazione predefinita `~/.claude/plugins` |

140| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumenta questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi [Le operazioni Git scadono](/it/plugin-marketplaces#git-operations-time-out) |140| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Timeout in millisecondi per le operazioni git durante l'installazione o l'aggiornamento dei plugin (predefinito: 120000). Aumentate questo valore per repository di grandi dimensioni o connessioni di rete lente. Vedi [Le operazioni Git scadono](/it/plugin-marketplaces#git-operations-time-out) |

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_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) |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_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 |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_REMOTE` | Impostato automaticamente su `true` quando Claude Code è in esecuzione come una [sessione cloud](/it/claude-code-on-the-web). Leggi questo da un hook o script di configurazione per rilevare se sei in un ambiente cloud |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_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/it/claude-code-on-the-web) all'ID della sessione corrente. Leggi questo per costruire un collegamento alla trascrizione della sessione. Vedi [Collegare gli artefatti alla sessione](/it/claude-code-on-the-web#link-artifacts-back-to-the-session) |147| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/it/claude-code-on-the-web) all'ID della sessione corrente. Leggete questo per costruire un collegamento alla trascrizione della sessione. Vedi [Collegare gli artefatti alla sessione](/it/claude-code-on-the-web#link-artifacts-back-to-the-session) |

148| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di reinviare il prompt |148| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | Imposta su `1` per riprendere automaticamente se la sessione precedente è terminata a metà turno. Utilizzato in modalità SDK in modo che il modello continui senza richiedere all'SDK di reinviare il prompt |

149| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrivi il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Per impostazione predefinita `Continue from where you left off.`. Gli script di spawn per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il valore predefinito |149| `CLAUDE_CODE_RESUME_PROMPT` | Sovrascrivi il messaggio di continuazione iniettato quando si riprende una sessione che è terminata a metà turno. Per impostazione predefinita `Continue from where you left off.`. Gli script di spawn per agenti a lunga esecuzione possono impostare questo su un messaggio di avvio più direttivo. Una stringa vuota utilizza il valore predefinito |

150| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere richiamati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di chiamate intere. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contano comunque rispetto al limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |150| `CLAUDE_CODE_SCRIPT_CAPS` | Oggetto JSON che limita quante volte script specifici possono essere richiamati per sessione quando `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` è impostato. Le chiavi sono sottostringhe abbinate al testo del comando; i valori sono limiti di chiamate intere. Ad esempio, `{"deploy.sh": 2}` consente a `deploy.sh` di essere chiamato al massimo due volte. L'abbinamento è basato su sottostringhe quindi trucchi di espansione della shell come `./scripts/deploy.sh $(evil)` contano comunque rispetto al limite. Il fan-out di runtime tramite `xargs` o `find -exec` non viene rilevato; questo è un controllo di difesa in profondità |

151| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/it/fullscreen#mouse-wheel-scrolling). Accetta valori da 1 a 20. Imposta su `3` per corrispondere a `vim` se il tuo terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento |151| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/it/fullscreen#mouse-wheel-scrolling). Accetta valori da 1 a 20. Imposta su `3` per corrispondere a `vim` se il vostro terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento |

152| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrivi il budget di tempo in millisecondi per gli hook [SessionEnd](/it/hooks#sessionend). Si applica all'uscita della sessione, `/clear` e al cambio di sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al massimo `timeout` per hook configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget |152| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | Sovrascrivi il budget di tempo in millisecondi per gli hook [SessionEnd](/it/hooks#sessionend). Si applica all'uscita della sessione, `/clear` e al cambio di sessioni tramite `/resume` interattivo. Per impostazione predefinita il budget è 1,5 secondi, aumentato automaticamente al massimo `timeout` per hook configurato nei file di impostazioni, fino a 60 secondi. I timeout sugli hook forniti dai plugin non aumentano il budget |

153| `CLAUDE_CODE_SESSION_ID` | Impostato automaticamente nei sottoprocessi dello strumento Bash e PowerShell all'ID della sessione corrente. Corrisponde al campo `session_id` passato agli [hook](/it/hooks). Aggiornato su `/clear`. Utilizza per correlare script e strumenti esterni con la sessione Claude Code che li ha avviati |153| `CLAUDE_CODE_SESSION_ID` | Impostato automaticamente nei sottoprocessi dello strumento Bash e PowerShell all'ID della sessione corrente. Corrisponde al campo `session_id` passato agli [hook](/it/hooks). Aggiornato su `/clear`. Utilizza per correlare script e strumenti esterni con la sessione Claude Code che li ha avviati |

154| `CLAUDE_CODE_SHELL` | Sovrascrivi il rilevamento automatico della shell. Utile quando la tua shell di login differisce dalla tua shell di lavoro preferita (ad esempio, `bash` vs `zsh`) |154| `CLAUDE_CODE_SHELL` | Sovrascrivi il rilevamento automatico della shell. Utile quando la vostra shell di login differisce dalla vostra shell di lavoro preferita (ad esempio, `bash` vs `zsh`) |

155| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso del comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi [hook](/it/hooks) e comandi di avvio del server MCP stdio. Utile per logging o auditing. Esempio: impostando `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh <command>` |155| `CLAUDE_CODE_SHELL_PREFIX` | Prefisso del comando che avvolge i comandi shell che Claude Code genera: chiamate dello strumento Bash, comandi [hook](/it/hooks) e comandi di avvio del server MCP stdio. Utile per logging o auditing. Esempio: impostando `/path/to/logger.sh` esegue ogni comando come `/path/to/logger.sh <command>` |

156| `CLAUDE_CODE_SIMPLE` | Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da `--mcp-config` sono ancora disponibili. Disabilita l'auto-discovery di hook, skill, plugin, server MCP, memoria automatica e CLAUDE.md. Il flag CLI [`--bare`](/it/headless#start-faster-with-bare-mode) imposta questo |156| `CLAUDE_CODE_SIMPLE` | Imposta su `1` per eseguire con un prompt di sistema minimo e solo gli strumenti Bash, lettura file e modifica file. Gli strumenti MCP da `--mcp-config` sono ancora disponibili. Disabilita l'auto-discovery di hook, skill, plugin, server MCP, memoria automatica e CLAUDE.md. Il flag CLI [`--bare`](/it/headless#start-faster-with-bare-mode) imposta questo |

157| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Imposta su `1` per utilizzare il prompt di sistema minimo e le descrizioni degli strumenti compresse su Opus 4.7. Non ha effetto su altri modelli. Il set di strumenti completo, hook, server MCP e scoperta CLAUDE.md rimangono abilitati |157| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | Imposta su `1` per utilizzare il prompt di sistema minimo e le descrizioni degli strumenti compresse su qualsiasi modello. Imposta su `0`, `false`, `no` o `off` per rinunciare anche su modelli dove l'esperimento o la configurazione del server altrimenti lo abiliterebbero. Il set di strumenti completo, hook, server MCP e scoperta CLAUDE.md rimangono abilitati |

158| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/it/claude-platform-on-aws), per gateway che firmano le richieste stessi |158| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | Salta l'autenticazione lato client per [Claude Platform on AWS](/it/claude-platform-on-aws), per gateway che firmano le richieste stessi |

159| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Bedrock (ad esempio, quando si utilizza un gateway LLM) |159| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Salta l'autenticazione AWS per Bedrock (ad esempio, quando si utilizza un gateway LLM) |

160| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry (ad esempio, quando si utilizza un gateway LLM) |160| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Salta l'autenticazione Azure per Microsoft Foundry (ad esempio, quando si utilizza un gateway LLM) |

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

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

167| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona del plugin. Se superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |167| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | Timeout in millisecondi per l'installazione sincrona del plugin. Se superato, Claude Code procede senza plugin e registra un errore. Nessun predefinito: senza questa variabile, l'installazione sincrona attende fino al completamento |

168| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta su `false` per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del tuo terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizza l'impostazione [`syntaxHighlightingDisabled`](/it/settings) |168| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Imposta su `false` per disabilitare l'evidenziazione della sintassi nell'output diff. Utile quando i colori interferiscono con la configurazione del vostro terminale. Per disabilitare anche l'evidenziazione nei blocchi di codice e nelle anteprime di file, utilizzate l'impostazione [`syntaxHighlightingDisabled`](/it/settings) |

169| `CLAUDE_CODE_TASK_LIST_ID` | Condividi un elenco di attività tra le sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso. Vedi [Elenco attività](/it/interactive-mode#task-list) |169| `CLAUDE_CODE_TASK_LIST_ID` | Condividi un elenco di attività tra le sessioni. Imposta lo stesso ID in più istanze di Claude Code per coordinare un elenco di attività condiviso. Vedi [Elenco attività](/it/interactive-mode#task-list) |

170| `CLAUDE_CODE_TEAM_NAME` | Nome del team di agenti a cui appartiene questo compagno di squadra. Impostato automaticamente sui membri del [team di agenti](/it/agent-teams) |170| `CLAUDE_CODE_TEAM_NAME` | Nome del team di agenti a cui appartiene questo compagno di squadra. Impostato automaticamente sui membri del [team di agenti](/it/agent-teams) |

171| `CLAUDE_CODE_TMPDIR` | Sovrascrivi la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` (Unix) o `/claude/` (Windows) a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux/Windows |171| `CLAUDE_CODE_TMPDIR` | Sovrascrivi la directory temporanea utilizzata per i file temporanei interni. Claude Code aggiunge `/claude-{uid}/` (Unix) o `/claude/` (Windows) a questo percorso. Predefinito: `/tmp` su macOS, `os.tmpdir()` su Linux/Windows |

172| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta su `1` per consentire l'output truecolor a 24 bit all'interno di tmux. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato per farlo. Imposta questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al tuo `~/.tmux.conf`. Vedi [Configurazione del terminale](/it/terminal-config) per altre impostazioni di tmux |172| `CLAUDE_CODE_TMUX_TRUECOLOR` | Imposta su `1` per consentire l'output truecolor a 24 bit all'interno di tmux. Per impostazione predefinita, Claude Code si limita a 256 colori quando `$TMUX` è impostato perché tmux non passa attraverso le sequenze di escape truecolor a meno che non sia configurato per farlo. Imposta questo dopo aver aggiunto `set -ga terminal-overrides ',*:Tc'` al vostro `~/.tmux.conf`. Vedi [Configurazione del terminale](/it/terminal-config) per altre impostazioni di tmux |

173| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utilizza [Claude Platform on AWS](/it/claude-platform-on-aws) |173| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | Utilizza [Claude Platform on AWS](/it/claude-platform-on-aws) |

174| `CLAUDE_CODE_USE_BEDROCK` | Utilizza [Bedrock](/it/amazon-bedrock) |174| `CLAUDE_CODE_USE_BEDROCK` | Utilizza [Bedrock](/it/amazon-bedrock) |

175| `CLAUDE_CODE_USE_FOUNDRY` | Utilizza [Microsoft Foundry](/it/microsoft-foundry) |175| `CLAUDE_CODE_USE_FOUNDRY` | Utilizza [Microsoft Foundry](/it/microsoft-foundry) |

176| `CLAUDE_CODE_USE_MANTLE` | Utilizza l'[endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) di Bedrock |176| `CLAUDE_CODE_USE_MANTLE` | Utilizza l'[endpoint Mantle](/it/amazon-bedrock#use-the-mantle-endpoint) di Bedrock |

177| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta su `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Imposta questo se il binario ripgrep raggruppato non è disponibile o bloccato nel tuo ambiente. Non influisce su Grep o strumenti di ricerca file |177| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Imposta su `1` per scoprire comandi personalizzati, subagent e stili di output utilizzando le API di file Node.js invece di ripgrep. Imposta questo se il binario ripgrep raggruppato non è disponibile o bloccato nel vostro ambiente. Non influisce su Grep o strumenti di ricerca file |

178| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta su `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è in rollout progressivo: imposta su `1` per aderire o `0` per rinunciare. Su Linux, macOS e WSL, imposta su `1` per abilitarlo, che richiede `pwsh` nel tuo `PATH`. Se abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedi [Strumento PowerShell](/it/tools-reference#powershell-tool) |178| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | Controlla lo strumento PowerShell. Su Windows senza Git Bash, lo strumento è abilitato automaticamente; imposta su `0` per disabilitarlo. Su Windows con Git Bash installato, lo strumento è in rollout progressivo: imposta su `1` per aderire o `0` per rinunciare. Su Linux, macOS e WSL, imposta su `1` per abilitarlo, che richiede `pwsh` nel vostro `PATH`. Se abilitato su Windows, Claude può eseguire i comandi PowerShell nativamente invece di instradare attraverso Git Bash. Vedi [Strumento PowerShell](/it/tools-reference#powershell-tool) |

179| `CLAUDE_CODE_USE_VERTEX` | Utilizza [Vertex](/it/google-vertex-ai) |179| `CLAUDE_CODE_USE_VERTEX` | Utilizza [Vertex](/it/google-vertex-ai) |

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

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

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

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. Configura il timeout con `CLAUDE_STREAM_IDLE_TIMEOUT_MS` |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` |

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

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 tua macchina, producendo nomi come `myhost-graceful-unicorn`. Il flag CLI `--remote-control-session-name-prefix` imposta lo stesso valore per una singola invocazione |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 |

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

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 |

187| `DISABLE_AUTOUPDATER` | Imposta su `1` per disabilitare gli aggiornamenti automatici in background. Il manuale `claude update` funziona ancora. Utilizza `DISABLE_UPDATES` per bloccare entrambi |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 |

188| `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 desideri un controllo esplicito su quando si verifica la compattazione |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 |

189| `DISABLE_COMPACT` | Imposta su `1` per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale `/compact` |190| `DISABLE_COMPACT` | Imposta su `1` per disabilitare tutta la compattazione: sia la compattazione automatica che il comando manuale `/compact` |

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

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

193| `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à |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à |

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

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

196| `DISABLE_INSTALLATION_CHECKS` | Imposta su `1` per disabilitare gli avvisi di installazione. Utilizza solo quando gestisci manualmente la posizione di installazione, poiché questo può mascherare i problemi con le installazioni standard |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 |

197| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta su `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Bedrock, Vertex o Foundry) |198| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | Imposta su `1` per nascondere il comando `/install-github-app`. Già nascosto quando si utilizzano provider di terze parti (Bedrock, Vertex o Foundry) |

198| `DISABLE_INTERLEAVED_THINKING` | Imposta su `1` per impedire l'invio dell'intestazione beta interleaved-thinking. Utile quando il tuo gateway LLM o provider non supporta il [thinking interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |199| `DISABLE_INTERLEAVED_THINKING` | Imposta su `1` per impedire l'invio dell'intestazione beta interleaved-thinking. Utile quando il vostro gateway LLM o provider non supporta il [thinking interleaved](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) |

199| `DISABLE_LOGIN_COMMAND` | Imposta su `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |200| `DISABLE_LOGIN_COMMAND` | Imposta su `1` per nascondere il comando `/login`. Utile quando l'autenticazione è gestita esternamente tramite chiavi API o `apiKeyHelper` |

200| `DISABLE_LOGOUT_COMMAND` | Imposta su `1` per nascondere il comando `/logout` |201| `DISABLE_LOGOUT_COMMAND` | Imposta su `1` per nascondere il comando `/logout` |

201| `DISABLE_PROMPT_CACHING` | Imposta su `1` per disabilitare il caching dei prompt per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello) |202| `DISABLE_PROMPT_CACHING` | Imposta su `1` per disabilitare il caching dei prompt per tutti i modelli (ha la precedenza sulle impostazioni per singolo modello) |

203| `DISABLE_PROMPT_CACHING_OPUS` | Imposta su `1` per disabilitare il caching dei prompt per i modelli Opus |204| `DISABLE_PROMPT_CACHING_OPUS` | Imposta su `1` per disabilitare il caching dei prompt per i modelli Opus |

204| `DISABLE_PROMPT_CACHING_SONNET` | Imposta su `1` per disabilitare il caching dei prompt per i modelli Sonnet |205| `DISABLE_PROMPT_CACHING_SONNET` | Imposta su `1` per disabilitare il caching dei prompt per i modelli Sonnet |

205| `DISABLE_TELEMETRY` | Imposta su `1` per rinunciare alla telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche i flag di funzionalità, quindi alcune funzionalità ancora in rollout potrebbero non essere disponibili |206| `DISABLE_TELEMETRY` | Imposta su `1` per rinunciare alla telemetria. Gli eventi di telemetria non includono dati utente come codice, percorsi di file o comandi bash. Disabilita anche i flag di funzionalità, quindi alcune funzionalità ancora in rollout potrebbero non essere disponibili |

206| `DISABLE_UPDATES` | Imposta su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizza quando distribuisci Claude Code attraverso i tuoi canali e gli utenti non dovrebbero auto-aggiornarsi |207| `DISABLE_UPDATES` | Imposta su `1` per bloccare tutti gli aggiornamenti incluso il manuale `claude update` e `claude install`. Più rigoroso di `DISABLE_AUTOUPDATER`. Utilizza quando distribuite Claude Code attraverso i vostri canali e gli utenti non dovrebbero auto-aggiornarsi |

207| `DISABLE_UPGRADE_COMMAND` | Imposta su `1` per nascondere il comando `/upgrade` |208| `DISABLE_UPGRADE_COMMAND` | Imposta su `1` per nascondere il comando `/upgrade` |

208| `DO_NOT_TRACK` | Imposta su `1` per rinunciare alla telemetria. Equivalente all'impostazione di `DISABLE_TELEMETRY`. Onorato come la [convenzione standard tra strumenti](https://consoledonottrack.com/) |209| `DO_NOT_TRACK` | Imposta su `1` per rinunciare alla telemetria. Equivalente all'impostazione di `DISABLE_TELEMETRY`. Onorato come la [convenzione standard tra strumenti](https://consoledonottrack.com/) |

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

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

216| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |217| `HTTP_PROXY` | Specifica il server proxy HTTP per le connessioni di rete |

217| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |218| `HTTPS_PROXY` | Specifica il server proxy HTTPS per le connessioni di rete |

218| `IS_DEMO` | Imposta su `1` per abilitare la modalità demo: nasconde la tua email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. Utile quando si trasmette in streaming o si registra una sessione |219| `IS_DEMO` | Imposta su `1` per abilitare la modalità demo: nasconde la vostra email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. Utile quando si trasmette in streaming o si registra una sessione |

219| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da questi strumenti è ancora soggetto a questa variabile (predefinito: 25000) |220| `MAX_MCP_OUTPUT_TOKENS` | Numero massimo di token consentiti nelle risposte degli strumenti MCP. Claude Code visualizza un avviso quando l'output supera 10.000 token. Gli strumenti che dichiarano [`anthropic/maxResultSizeChars`](/it/mcp#raise-the-limit-for-a-specific-tool) utilizzano quel limite di caratteri per il contenuto di testo, ma il contenuto dell'immagine da questi strumenti è ancora soggetto a questa variabile (predefinito: 25000) |

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

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

81 81 

82* Controlla [status.claude.com](https://status.claude.com) per gli incidenti attivi82* Controlla [status.claude.com](https://status.claude.com) per gli incidenti attivi

83* Attendi un minuto, quindi invia di nuovo il tuo messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare `try again` invece di incollare l'intera cosa.83* Attendi un minuto, quindi invia di nuovo il tuo messaggio. Il tuo messaggio originale è ancora nella conversazione, quindi per un prompt lungo puoi digitare `try again` invece di incollare l'intera cosa.

84* Se l'errore persiste senza un incidente pubblicato, esegui `/feedback` in modo che Anthropic possa indagare con i dettagli della tua richiesta. Vedi [Segnala un errore](#report-an-error) se `/feedback` non è disponibile sul tuo provider.84* Se l'errore persiste senza un incidente pubblicato, esegui `/feedback` in modo che Anthropic possa indagare con i dettagli della tua richiesta. Vedi [Segnala un errore](#report-an-error) se `/feedback` non è disponibile nel tuo ambiente.

85 85 

86### API Error: Repeated 529 Overloaded errors86### API Error: Repeated 529 Overloaded errors

87 87 

573 573 

574## Le risposte sembrano di qualità inferiore al solito574## Le risposte sembrano di qualità inferiore al solito

575 575 

576Se le risposte di Claude sembrano meno capaci di quanto ti aspetti ma nessun errore è mostrato, la causa è solitamente lo stato della conversazione piuttosto che il modello stesso. Claude Code non cambia silenziosamente le versioni del modello. Può passare a un modello di fallback in casi specifici come una quota Opus raggiunta o una regione Bedrock o Vertex AI che manca il tuo modello; il controllo Model selection sottostante cattura entrambi, e [Model configuration](/it/model-config) spiega quando si applica il fallback.576Se le risposte di Claude sembrano meno capaci di quanto vi aspettiate ma nessun errore è mostrato, la causa è solitamente lo stato della conversazione piuttosto che il modello stesso. Claude Code non cambia silenziosamente le versioni del modello. Può passare a un modello di fallback in casi specifici come una quota Opus raggiunta o una regione Bedrock o Vertex AI che manca il vostro modello; il controllo Model selection sottostante cattura entrambi, e [Model configuration](/it/model-config) spiega quando si applica il fallback.

577 577 

578Controlla questi prima:578Controllate questi prima:

579 579 

580* **Model selection**: esegui `/model` per confermare che sei sul modello che ti aspetti. Una scelta `/model` precedente o una variabile di ambiente `ANTHROPIC_MODEL` potrebbe averti su un modello più piccolo di quello che intendevi.580* **Model selection**: eseguite `/model` per confermare che siete sul modello che vi aspettate. Una scelta `/model` precedente o una variabile di ambiente `ANTHROPIC_MODEL` potrebbe avervi su un modello più piccolo di quello che intendavate.

581* **Effort level**: esegui `/effort` per controllare il livello di ragionamento attuale e aumentalo per il debug difficile o il lavoro di progettazione. I valori predefiniti variano per modello, quindi controlla prima di assumere che sei sotto il massimo. Vedi [Adjust effort level](/it/model-config#adjust-effort-level) per i valori predefiniti per modello e il collegamento `ultrathink`.581* **Effort level**: eseguite `/effort` per controllare il livello di ragionamento attuale e aumentatelo per il debug difficile o il lavoro di progettazione. I valori predefiniti variano per modello, quindi controllate prima di assumere che siete sotto il massimo. Vedete [Adjust effort level](/it/model-config#adjust-effort-level) per i valori predefiniti per modello e il collegamento `ultrathink`.

582* **Context pressure**: esegui `/context` per vedere quanto è piena la finestra. Se è vicina alla capacità, esegui `/compact` a un punto naturale o `/clear` per ricominciare da capo. Vedi [Explore the context window](/it/context-window) per come auto-compact influisce sui turni precedenti.582* **Context pressure**: eseguite `/context` per vedere quanto è piena la finestra. Se è vicina alla capacità, eseguite `/compact` a un punto naturale o `/clear` per ricominciare da capo. Vedete [Explore the context window](/it/context-window) per come auto-compact influisce sui turni precedenti.

583* **Stale instructions**: i file `CLAUDE.md` grandi o obsoleti e le definizioni di strumenti MCP consumano contesto e possono dirigere le risposte. `/doctor` contrassegna i file di memoria di dimensioni eccessive e le definizioni di subagent; `/context` mostra l'utilizzo di token dello strumento MCP.583* **Stale instructions**: i file `CLAUDE.md` grandi o obsoleti e le definizioni di strumenti MCP consumano contesto e possono dirigere le risposte. `/doctor` contrassegna i file di memoria di dimensioni eccessive e le definizioni di subagent; `/context` mostra l'utilizzo di token dello strumento MCP.

584 584 

585Quando una risposta va male, il rewind di solito funziona meglio che rispondere con correzioni. Premi Esc due volte o esegui `/rewind` per tornare indietro a prima del turno cattivo, quindi riformula il prompt con più specifiche. Correggere nel thread mantiene il tentativo sbagliato nel contesto, che può ancorare le risposte successive ad esso. Vedi [Checkpointing](/it/checkpointing).585Quando una risposta va male, il rewind di solito funziona meglio che rispondere con correzioni. Premete Esc due volte o eseguite `/rewind` per tornare indietro a prima del turno cattivo, quindi riformulate il prompt con più specifiche. Correggere nel thread mantiene il tentativo sbagliato nel contesto, che può ancorare le risposte successive ad esso. Vedete [Checkpointing](/it/checkpointing).

586 586 

587Se la qualità sembra ancora non corretta dopo aver controllato quanto sopra, esegui `/feedback` e descrivi cosa ti aspettavi rispetto a quello che hai ottenuto. Il feedback inviato in questo modo include la trascrizione della conversazione, che è il modo più veloce per Anthropic per diagnosticare una regressione reale. Vedi [Report an error](#report-an-error) se `/feedback` non è disponibile sul tuo provider.587Se la qualità sembra ancora non corretta dopo aver controllato quanto sopra, eseguite `/feedback` e descrivete cosa vi aspettavate rispetto a quello che avete ottenuto. Il feedback inviato in questo modo include la trascrizione della conversazione, che è il modo più veloce per Anthropic per diagnosticare una regressione reale. Vedete [Report an error](#report-an-error) se `/feedback` non è disponibile nel vostro ambiente.

588 588 

589## Segnalare un errore589## Segnalare un errore

590 590 

596 596 

597Se un errore non è elencato qui o la correzione suggerita non aiuta:597Se un errore non è elencato qui o la correzione suggerita non aiuta:

598 598 

599* Esegui `/feedback` all'interno di Claude Code per inviare la trascrizione e una descrizione ad Anthropic. Il comando offre anche di aprire un problema GitHub precompilato. Il feedback non è disponibile su Bedrock, Vertex AI e distribuzioni Foundry.599* Esegui `/feedback` all'interno di Claude Code per inviare la trascrizione e una descrizione ad Anthropic. Il comando offre anche di aprire un problema GitHub precompilato. Su Bedrock, Vertex AI, Foundry e altri provider di terze parti, `/feedback` salva un archivio locale che puoi inviare al tuo rappresentante dell'account Anthropic.

600* Esegui `/doctor` per controllare i problemi di configurazione locale600* Esegui `/doctor` per controllare i problemi di configurazione locale

601* Controlla [status.claude.com](https://status.claude.com) per gli incidenti attivi601* Controlla [status.claude.com](https://status.claude.com) per gli incidenti attivi

602* Cerca i [problemi esistenti](https://github.com/anthropics/claude-code/issues) su GitHub602* Cerca i [problemi esistenti](https://github.com/anthropics/claude-code/issues) su GitHub

6 6 

7> Imposta una condizione di completamento con /goal e Claude continua a lavorare tra i turni finché la condizione non è soddisfatta.7> Imposta una condizione di completamento con /goal e Claude continua a lavorare tra i turni finché la condizione non è soddisfatta.

8 8 

9<Note>

10 `/goal` richiede Claude Code v2.1.139 o successivo.

11</Note>

12 

9Il comando `/goal` imposta una condizione di completamento e Claude continua a lavorare verso di essa senza che tu debba richiedere ogni passaggio. Dopo ogni turno, un piccolo modello veloce verifica se la condizione è soddisfatta. Se non lo è, Claude inizia un altro turno invece di restituire il controllo a te. L'obiettivo si cancella automaticamente una volta che la condizione è soddisfatta.13Il comando `/goal` imposta una condizione di completamento e Claude continua a lavorare verso di essa senza che tu debba richiedere ogni passaggio. Dopo ogni turno, un piccolo modello veloce verifica se la condizione è soddisfatta. Se non lo è, Claude inizia un altro turno invece di restituire il controllo a te. L'obiettivo si cancella automaticamente una volta che la condizione è soddisfatta.

10 14 

11Usa un obiettivo per lavori sostanziali con uno stato finale verificabile:15Usa un obiettivo per lavori sostanziali con uno stato finale verificabile:

202 202 

203[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per disabilitarlo, imposta `DISABLE_PROMPT_CACHING=1`. Per richiedere un TTL cache di 1 ora invece del valore predefinito di 5 minuti, imposta `ENABLE_PROMPT_CACHING_1H=1`; le scritture della cache con TTL di 1 ora vengono fatturate a una tariffa più elevata. Per limiti di velocità aumentati, contatta il supporto di Google Cloud. Quando utilizzi Vertex AI, i comandi `/login` e `/logout` sono disabilitati poiché l'autenticazione è gestita tramite le credenziali di Google Cloud.203[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per disabilitarlo, imposta `DISABLE_PROMPT_CACHING=1`. Per richiedere un TTL cache di 1 ora invece del valore predefinito di 5 minuti, imposta `ENABLE_PROMPT_CACHING_1H=1`; le scritture della cache con TTL di 1 ora vengono fatturate a una tariffa più elevata. Per limiti di velocità aumentati, contatta il supporto di Google Cloud. Quando utilizzi Vertex AI, i comandi `/login` e `/logout` sono disabilitati poiché l'autenticazione è gestita tramite le credenziali di Google Cloud.

204 204 

205[MCP tool search](/it/mcp#scale-with-mcp-tool-search) è disabilitato per impostazione predefinita su Vertex AI perché l'endpoint non accetta l'intestazione beta richiesta. Tutte le definizioni degli strumenti MCP vengono caricate in anticipo. Per acconsentire, imposta `ENABLE_TOOL_SEARCH=true`.205Claude Code disabilita [MCP tool search](/it/mcp#scale-with-mcp-tool-search) per impostazione predefinita su Vertex AI, quindi le definizioni degli strumenti MCP vengono caricate in anticipo. Vertex AI supporta la ricerca degli strumenti per Claude Sonnet 4.5 e versioni successive e Claude Opus 4.5 e versioni successive. Imposta `ENABLE_TOOL_SEARCH=true` per abilitarla su questi modelli. I modelli precedenti su Vertex AI non accettano l'intestazione beta richiesta e le richieste non riescono se abiliti la ricerca degli strumenti con essi.

206 206 

207### 5. Fissa le versioni del modello207### 5. Fissa le versioni del modello

208 208 

227| Tipo di modello | Valore predefinito |227| Tipo di modello | Valore predefinito |

228| :--------------------- | :--------------------------- |228| :--------------------- | :--------------------------- |

229| Modello primario | `claude-sonnet-4-5@20250929` |229| Modello primario | `claude-sonnet-4-5@20250929` |

230| Modello piccolo/veloce | `claude-haiku-4-5@20251001` |230| Modello piccolo/veloce | Uguale al modello primario |

231 

232Le attività in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Vertex AI, Claude Code imposta per impostazione predefinita questo al modello primario perché Haiku potrebbe non essere abilitato in ogni progetto o regione. Per utilizzare Haiku per le attività in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su un ID modello disponibile nel tuo progetto.

231 233 

232Per personalizzare ulteriormente i modelli:234Per personalizzare ulteriormente i modelli:

233 235 

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

1230| `subagent_type` | string | `"Explore"` | Tipo di agente specializzato da utilizzare |1230| `subagent_type` | string | `"Explore"` | Tipo di agente specializzato da utilizzare |

1231| `model` | string | `"sonnet"` | Alias del modello facoltativo per sovrascrivere l'impostazione predefinita |1231| `model` | string | `"sonnet"` | Alias del modello facoltativo per sovrascrivere l'impostazione predefinita |

1232 1232 

1233In `PostToolUse`, `tool_response` per una chiamata Agent completata contiene il testo finale del subagent insieme alla telemetria di utilizzo. Leggere questi campi per registrare il costo per subagent da un hook:

1234 

1235| Campo | Tipo | Esempio | Descrizione |

1236| :------------------ | :----- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |

1237| `status` | string | `"completed"` | `"completed"` per le chiamate sincrone, `"async_launched"` per `run_in_background: true` |

1238| `agentId` | string | `"a4d2c8f1e0b3a297"` | Identificatore per l'esecuzione del subagent |

1239| `content` | array | `[{"type": "text", "text": "Found 12 endpoints..."}]` | I blocchi di testo finali del subagent |

1240| `totalTokens` | number | `12450` | Token totali fatturati nei turni del subagent |

1241| `totalDurationMs` | number | `48211` | Durata wall-clock dell'esecuzione del subagent |

1242| `totalToolUseCount` | number | `7` | Conteggio delle chiamate dello strumento effettuate dal subagent |

1243| `usage` | object | `{"input_tokens": 8320, ...}` | Suddivisione dei token per tipo: `input_tokens`, `output_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |

1244 

1245Per le chiamate `run_in_background: true`, lo strumento ritorna immediatamente dopo il lancio del subagent, quindi `tool_response` non contiene campi di utilizzo. Ha `status: "async_launched"`, `agentId`, `description`, `prompt` e `outputFile` invece.

1246 

1233##### AskUserQuestion1247##### AskUserQuestion

1234 1248 

1235Chiede all'utente da una a quattro domande a scelta multipla.1249Chiede all'utente da una a quattro domande a scelta multipla.

953 953 

954### Configura tool search954### Configura tool search

955 955 

956Tool search è abilitato per impostazione predefinita: gli strumenti MCP vengono rimandati e scoperti su richiesta. È disabilitato per impostazione predefinita su Vertex AI, che non accetta l'intestazione beta tool search, e quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte, poiché la maggior parte dei proxy non inoltrano blocchi `tool_reference`. Se il tuo proxy inoltra blocchi `tool_reference`, imposta `ENABLE_TOOL_SEARCH` esplicitamente per ignorare il fallback. Questa funzionalità richiede modelli che supportano blocchi `tool_reference`: Sonnet 4 e successivi, oppure Opus 4 e successivi. I modelli Haiku non supportano tool search.956Tool search è abilitato per impostazione predefinita: gli strumenti MCP vengono rimandati e scoperti su richiesta. Claude Code lo disabilita per impostazione predefinita su Vertex AI. È anche disabilitato quando `ANTHROPIC_BASE_URL` punta a un host non di prima parte, poiché la maggior parte dei proxy non inoltrano blocchi `tool_reference`. Imposta `ENABLE_TOOL_SEARCH` esplicitamente per ignorare uno qualsiasi dei fallback.

957 

958Tool search richiede un modello che supporta blocchi `tool_reference`: Sonnet 4 e successivi, oppure Opus 4 e successivi. I modelli Haiku non lo supportano. Su Vertex AI, tool search è supportato per Claude Sonnet 4.5 e successivi e Claude Opus 4.5 e successivi.

957 959 

958Controlla il comportamento di tool search con la variabile di ambiente `ENABLE_TOOL_SEARCH`:960Controlla il comportamento di tool search con la variabile di ambiente `ENABLE_TOOL_SEARCH`:

959 961 

960| Valore | Comportamento |962| Valore | Comportamento |

961| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |963| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

962| (non impostato) | Tutti gli strumenti MCP rimandati e caricati su richiesta. Ricade al caricamento in anticipo su Vertex AI o quando `ANTHROPIC_BASE_URL` è un host non di prima parte |964| (non impostato) | Tutti gli strumenti MCP rimandati e caricati su richiesta. Ricade al caricamento in anticipo su Vertex AI o quando `ANTHROPIC_BASE_URL` è un host non di prima parte |

963| `true` | Tutti gli strumenti MCP rimandati. Claude Code invia l'intestazione beta anche su Vertex AI e attraverso i proxy. Le richieste non riescono se il backend non supporta blocchi `tool_reference` |965| `true` | Tutti gli strumenti MCP rimandati. Claude Code invia l'intestazione beta anche su Vertex AI e attraverso i proxy. Le richieste non riescono su modelli Vertex AI precedenti a Sonnet 4.5 o Opus 4.5, o su proxy che non supportano blocchi `tool_reference` |

964| `auto` | Modalità soglia: gli strumenti vengono caricati in anticipo se si adattano entro il 10% della finestra di contesto, rimandati altrimenti |966| `auto` | Modalità soglia: gli strumenti vengono caricati in anticipo se si adattano entro il 10% della finestra di contesto, rimandati altrimenti |

965| `auto:<N>` | Modalità soglia con una percentuale personalizzata, dove `<N>` è 0-100 (ad es. `auto:5` per il 5%) |967| `auto:N` | Modalità soglia con una percentuale personalizzata, dove `N` è 0-100. Ad esempio, `auto:5` per il 5% |

966| `false` | Tutti gli strumenti MCP caricati in anticipo, nessun rinvio |968| `false` | Tutti gli strumenti MCP caricati in anticipo, nessun rinvio |

967 969 

968```bash theme={null}970```bash theme={null}

163export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'163export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

164```164```

165 165 

166I compiti in background come la generazione del titolo della sessione utilizzano il modello piccolo/veloce, normalmente un modello della classe Haiku. Su Foundry, Claude Code utilizza per impostazione predefinita il modello primario perché non tutti gli account hanno una distribuzione Haiku. Per utilizzare Haiku per i compiti in background, imposta `ANTHROPIC_DEFAULT_HAIKU_MODEL` su una distribuzione Haiku disponibile nel tuo account, come mostrato sopra.

167 

166Per gli ID dei modelli attuali e legacy, vedi [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Configurazione del modello](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.168Per gli ID dei modelli attuali e legacy, vedi [Panoramica dei modelli](https://platform.claude.com/docs/en/about-claude/models/overview). Vedi [Configurazione del modello](/it/model-config#pin-models-for-third-party-deployments) per l'elenco completo delle variabili di ambiente.

167 169 

168[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata:170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) è abilitato automaticamente. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, imposta la seguente variabile; le scritture della cache con un TTL di 1 ora vengono fatturate a una tariffa più elevata:

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 (modalità cone). Solo i percorsi elencati 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 272 

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

274 274 

533 533 

534### Verifica le impostazioni attive534### Verifica le impostazioni attive

535 535 

536Esegui `/status` all'interno di Claude Code per vedere quali fonti di impostazioni sono attive e da dove provengono. L'output mostra ogni livello di configurazione (gestito, utente, progetto) insieme alla sua origine, come `Enterprise managed settings (remote)`, `Enterprise managed settings (plist)`, `Enterprise managed settings (HKLM)`, `Enterprise managed settings (HKCU)`, o `Enterprise managed settings (file)`. Se un file di impostazioni contiene errori, `/status` segnala il problema in modo che tu possa risolverlo.536Esegui `/status` all'interno di Claude Code per vedere quali fonti di impostazioni sono attive. La scheda Status include una riga `Setting sources` che elenca ogni livello di configurazione che Claude Code ha caricato per la sessione corrente, come `User settings` o `Project local settings`. Quando le [impostazioni gestite](/it/managed-settings) sono in vigore, la voce mostra il canale di distribuzione tra parentesi, ad esempio `Enterprise managed settings (remote)`, `(plist)`, `(HKLM)`, `(HKCU)`, o `(file)`. Un livello appare nell'elenco solo quando quella fonte viene caricata con almeno una chiave, quindi un elenco vuoto significa che non sono state trovate fonti di impostazioni.

537 

538La riga `Setting sources` conferma quali fonti vengono lette. Non mostra quale livello ha fornito ogni singola chiave. La scheda Config nello stesso dialogo è un editor per un insieme fisso di interruttori come tema e output dettagliato, non una visualizzazione dei contenuti del tuo `settings.json`. Se un file di impostazioni contiene errori, come JSON non valido o un valore che non supera la convalida, `/status` segnala il problema in modo che tu possa risolverlo.

537 539 

538### Punti chiave sul sistema di configurazione540### Punti chiave sul sistema di configurazione

539 541