Documentation 2026-10-10 23:01 UTC to 2026-10-11 23:57 UTC

2386 kind: "task-notification";2386 kind: "task-notification";

2387 subkind?: "scheduled-trigger" | "peer-send-message";2387 subkind?: "scheduled-trigger" | "peer-send-message";

2388 fireReason?: string;2388 fireReason?: string;

2389 runId?: string;

2389 }2390 }

2390 | { kind: "coordinator" }2391 | { kind: "coordinator" }

2391 | { kind: "auto-continuation" }2392 | { kind: "auto-continuation" }

2415 2416 

2416`fireReason` indica perché è scattata una notifica `scheduled-trigger`, come breve token in minuscolo quale `scheduled`, `manual`, `retry`, `catch_up` o `api`. I server Anthropic lo impostano sulle consegne di una [routine](/docs/it/routines), e la tua applicazione lo imposta quando dichiara un'esecuzione pianificata. È assente quando nessuno dei due ne ha inviato uno. Richiede TypeScript Agent SDK v0.3.280 o successivo.2417`fireReason` indica perché è scattata una notifica `scheduled-trigger`, come breve token in minuscolo quale `scheduled`, `manual`, `retry`, `catch_up` o `api`. I server Anthropic lo impostano sulle consegne di una [routine](/docs/it/routines), e la tua applicazione lo imposta quando dichiara un'esecuzione pianificata. È assente quando nessuno dei due ne ha inviato uno. Richiede TypeScript Agent SDK v0.3.280 o successivo.

2417 2418 

2419Un'attività in background può essere eseguita più di una volta con lo stesso `task_id`, ad esempio quando Claude [riprende un subagent](/docs/it/agent-sdk/subagents#resume-subagents). Ogni esecuzione ha il proprio [`run_id`](#sdktaskstartedmessage). Quando la notifica di un'esecuzione raggiunge la tua sessione come messaggio utente, `runId` sull'origine `task-notification` di quel messaggio contiene lo stesso valore. Una notifica può arrivare dopo che l'esecuzione successiva dell'attività è iniziata, e riporta comunque l'ID dell'esecuzione precedente. Per capire a quale esecuzione appartiene un turno, confronta `runId`, non `task_id`. Richiede TypeScript Agent SDK v0.3.292 o versioni successive.

2420 

2418<h4 id="declare-a-scheduled-run">2421<h4 id="declare-a-scheduled-run">

2419 Dichiarare un'esecuzione pianificata2422 Dichiarare un'esecuzione pianificata

2420</h4>2423</h4>

3263 Tipi di input dei tool3266 Tipi di input dei tool

3264</h2>3267</h2>

3265 3268 

3266Documentazione degli schemi di input per tutti i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e possono essere usati per le interazioni dei tool type-safe.3269Documentazione degli schemi di input per i tool Claude Code incorporati. Questi tipi vengono esportati da `@anthropic-ai/claude-agent-sdk/sdk-tools` e possono essere usati per le interazioni dei tool type-safe.

3267 3270 

3268<h3 id="toolinputschemas">3271<h3 id="toolinputschemas">

3269 `ToolInputSchemas`3272 `ToolInputSchemas`

4079 Tipi di output degli strumenti4082 Tipi di output degli strumenti

4080</h2>4083</h2>

4081 4084 

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

4083 4086 

4084<h3 id="tooloutputschemas">4087<h3 id="tooloutputschemas">

4085 `ToolOutputSchemas`4088 `ToolOutputSchemas`

5732 `SDKTaskNotificationMessage`5735 `SDKTaskNotificationMessage`

5733</h3>5736</h3>

5734 5737 

5735Notifica inviata quando un'attività in background viene completata, fallisce o viene arrestata. Le attività in background includono i comandi Bash `run_in_background`, le osservazioni [Monitor](#monitor) e i subagent in background. Per il campo `ambient`, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che lo definisce insieme al relativo requisito di versione.5738Notifica inviata quando un'attività in background viene completata, fallisce o viene arrestata. Le attività in background includono i comandi Bash `run_in_background`, le osservazioni [Monitor](#monitor) e i subagent in background. Per i campi `run_id` e `ambient`, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che li definisce insieme ai relativi requisiti di versione.

5736 5739 

5737```typescript theme={null}5740```typescript theme={null}

5738type SDKTaskNotificationMessage = {5741type SDKTaskNotificationMessage = {

5739 type: "system";5742 type: "system";

5740 subtype: "task_notification";5743 subtype: "task_notification";

5741 task_id: string;5744 task_id: string;

5745 run_id?: string;

5742 tool_use_id?: string;5746 tool_use_id?: string;

5743 status: "completed" | "failed" | "stopped";5747 status: "completed" | "failed" | "stopped";

5744 reason?: "worker_restart";5748 reason?: "worker_restart";

5911 type: "system";5915 type: "system";

5912 subtype: "task_started";5916 subtype: "task_started";

5913 task_id: string;5917 task_id: string;

5918 run_id?: string;

5914 tool_use_id?: string;5919 tool_use_id?: string;

5915 description: string;5920 description: string;

5916 task_type?: string;5921 task_type?: string;

5923};5928};

5924```5929```

5925 5930 

5931`run_id` identifica una singola esecuzione dell'attività. Quando un'attività viene eseguita di nuovo con lo stesso `task_id`, come un [subagent che Claude riprende](/docs/it/agent-sdk/subagents#resume-subagents), la nuova esecuzione riceve un nuovo `run_id`. Il campo richiede Agent SDK v0.3.292 o versioni successive. Usalo per tenere distinte le esecuzioni di una stessa attività:

5932 

5933* **Associare i messaggi a un'esecuzione**: i messaggi `task_started`, [`task_progress`](#sdktaskprogressmessage), [`task_updated`](#sdktaskupdatedmessage) e [`task_notification`](#sdktasknotificationmessage) di una stessa esecuzione riportano lo stesso `run_id`. Lo riporta anche la voce dell'esecuzione in ogni [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage), così come il [`runId`](#task-notification-subkinds) nell'origine del messaggio dell'utente che consegna la notifica dell'esecuzione.

5934* **Rilevare un messaggio in ritardo**: confrontati come semplici stringhe, gli ID di esecuzione di un'attività si ordinano nell'ordine in cui le esecuzioni sono iniziate, quindi un messaggio il cui `run_id` viene ordinato prima dell'esecuzione che stai mostrando proviene da un'esecuzione precedente. A parte questo confronto, tratta il valore come opaco.

5935* **Ricorrere a `task_id`**: quando un messaggio non riporta alcun `run_id`, come il `task_notification` che una sessione ripresa emette per chiudere un'attività avviata dal processo precedente, attribuiscilo tramite `task_id`.

5936 

5937Ad esempio, questi tre messaggi, ridotti ai loro campi identificativi, provengono da un subagent in background che Claude ha ripreso una volta. I due messaggi `task_started` condividono un `task_id`, e la notifica che ha terminato la prima esecuzione riporta l'ID della prima esecuzione:

5938 

5939```json theme={null}

5940{"subtype": "task_started", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubbs7i8-6f0c2d41"}

5941{"subtype": "task_notification", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubbs7i8-6f0c2d41", "status": "completed"}

5942{"subtype": "task_started", "task_id": "a5c2e8f41b09d7a36", "run_id": "0mubc18m1-b7719e05"}

5943```

5944 

5926`ambient` è `true` per le attività che non fanno parte del lavoro della sessione, come le attività che Claude Code esegue per il proprio funzionamento. Anche gli osservatori di aggiornamenti in tempo reale sono ambient, compresi quelli richiesti dall'utente. Escludi le attività ambient dagli indicatori di attività. Il campo richiede Agent SDK v0.3.247 o versioni successive.5945`ambient` è `true` per le attività che non fanno parte del lavoro della sessione, come le attività che Claude Code esegue per il proprio funzionamento. Anche gli osservatori di aggiornamenti in tempo reale sono ambient, compresi quelli richiesti dall'utente. Escludi le attività ambient dagli indicatori di attività. Il campo richiede Agent SDK v0.3.247 o versioni successive.

5927 5946 

5928`ambient` compare anche in [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) e nelle voci di [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage).5947`ambient` compare anche in [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) e nelle voci di [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage).

5946 `SDKTaskProgressMessage`5965 `SDKTaskProgressMessage`

5947</h3>5966</h3>

5948 5967 

5949Emesso periodicamente mentre un subagent o un'attività in background è in esecuzione.5968Emesso periodicamente mentre un subagent o un'attività in background è in esecuzione. Per il campo `run_id`, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che lo definisce insieme al relativo requisito di versione.

5950 5969 

5951Per un'attività di subagent, il campo `summary` contiene un riepilogo dell'avanzamento generato dal modello ed è popolato solo quando [`agentProgressSummaries`](#options) è abilitato. Per una [chiamata a uno strumento MCP spostata in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls), `summary` contiene l'ultimo avanzamento riportato dal server MCP e non dipende da tale opzione.5970Per un'attività di subagent, il campo `summary` contiene un riepilogo dell'avanzamento generato dal modello ed è popolato solo quando [`agentProgressSummaries`](#options) è abilitato. Per una [chiamata a uno strumento MCP spostata in background](/docs/it/mcp#automatic-backgrounding-of-long-tool-calls), `summary` contiene l'ultimo avanzamento riportato dal server MCP e non dipende da tale opzione.

5952 5971 

5955 type: "system";5974 type: "system";

5956 subtype: "task_progress";5975 subtype: "task_progress";

5957 task_id: string;5976 task_id: string;

5977 run_id?: string;

5958 tool_use_id?: string;5978 tool_use_id?: string;

5959 description: string;5979 description: string;

5960 subagent_type?: string;5980 subagent_type?: string;

5974 `SDKTaskUpdatedMessage`5994 `SDKTaskUpdatedMessage`

5975</h3>5995</h3>

5976 5996 

5977Emesso quando lo stato di un'attività in background cambia, ad esempio quando passa da `running` a `completed`. Fai il merge di `patch` nella tua mappa locale delle attività con chiave `task_id`. Il campo `end_time` è un timestamp Unix epoch in millisecondi, confrontabile con `Date.now()`.5997Emesso quando lo stato di un'attività in background cambia, ad esempio quando passa da `running` a `completed`. Fai il merge di `patch` nella tua mappa locale delle attività con chiave `task_id`. Il campo `end_time` è un timestamp Unix epoch in millisecondi, confrontabile con `Date.now()`. Per il campo `run_id`, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che lo definisce insieme al relativo requisito di versione.

5978 5998 

5979```typescript theme={null}5999```typescript theme={null}

5980type SDKTaskUpdatedMessage = {6000type SDKTaskUpdatedMessage = {

5981 type: "system";6001 type: "system";

5982 subtype: "task_updated";6002 subtype: "task_updated";

5983 task_id: string;6003 task_id: string;

6004 run_id?: string;

5984 patch: {6005 patch: {

5985 status?: "pending" | "running" | "completed" | "failed" | "killed";6006 status?: "pending" | "running" | "completed" | "failed" | "killed";

5986 description?: string;6007 description?: string;

5998 `SDKBackgroundTasksChangedMessage`6019 `SDKBackgroundTasksChangedMessage`

5999</h3>6020</h3>

6000 6021 

6001Emesso ogni volta che l'insieme delle attività in background attive cambia: un'attività inizia, viene completata o viene terminata; un agente in primo piano passa in background; oppure cambia il campo `description`, `ambient` o `parent_task_id` di un'attività. Per il campo `parent_task_id` di ciascuna voce, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che lo definisce insieme al relativo requisito di versione.6022Emesso ogni volta che l'insieme delle attività in background attive cambia: un'attività inizia, viene completata o viene terminata; un agente in primo piano passa in background; oppure cambia il campo `description`, `ambient` o `parent_task_id` di un'attività. Per i campi `run_id` e `parent_task_id` di ciascuna voce, consulta [`SDKTaskStartedMessage`](#sdktaskstartedmessage), che li definisce insieme ai relativi requisiti di versione.

6002 6023 

6003L'array `tasks` è l'intero insieme attivo. Sostituisci qualsiasi insieme memorizzato nella cache con ogni payload invece di abbinare gli eventi `task_started` e `task_notification`, in modo che la successiva modifica dell'insieme corregga qualsiasi evento che ti sei perso.6024L'array `tasks` è l'intero insieme attivo. Sostituisci qualsiasi insieme memorizzato nella cache con ogni payload invece di abbinare gli eventi `task_started` e `task_notification`, in modo che la successiva modifica dell'insieme corregga qualsiasi evento che ti sei perso.

6004 6025 

6016 subtype: "background_tasks_changed";6037 subtype: "background_tasks_changed";

6017 tasks: {6038 tasks: {

6018 task_id: string;6039 task_id: string;

6040 run_id?: string;

6019 task_type: string;6041 task_type: string;

6020 subagent_type?: string;6042 subagent_type?: string;

6021 description: string;6043 description: string;

300* **Fermi il turno**: Claude Code annulla il cambio e mostra `Backgrounding cancelled — the turn was stopped.` Ad esempio, il turno si ferma quando [interrompi Claude con `Esc`](/docs/it/interactive-mode#general-controls) o selezioni **No** [senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) su una richiesta di permesso della conversazione principale, oppure premi `Esc` su una domanda che Claude pone lì. Premi di nuovo `←` per mettere la sessione in background.300* **Fermi il turno**: Claude Code annulla il cambio e mostra `Backgrounding cancelled — the turn was stopped.` Ad esempio, il turno si ferma quando [interrompi Claude con `Esc`](/docs/it/interactive-mode#general-controls) o selezioni **No** [senza un commento](/docs/it/permissions#add-a-comment-when-you-answer-a-permission-prompt) su una richiesta di permesso della conversazione principale, oppure premi `Esc` su una domanda che Claude pone lì. Premi di nuovo `←` per mettere la sessione in background.

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

302 302 

303Quando Claude Code mette la sessione in background, dopo circa dieci secondi oppure dopo che premi di nuovo `←`, ferma un comando shell che Claude sta ancora eseguendo in primo piano. Claude Code non mostra la finestra di dialogo `Background this session?` per quel comando. Nella sessione in background, Claude non ha traccia dell'avvio del comando, quindi potrebbe eseguirlo di nuovo. Per mantenere il comando in esecuzione quando la sessione viene spostata, premi `Ctrl+B` per [trasformarlo in un comando in background](/docs/it/interactive-mode#background-bash-commands) mentre Claude Code sta ancora attendendo.

304 

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

304 306 

305Puoi disattivare questa scorciatoia per le sessioni in primo piano con l'impostazione [`leftArrowOpensAgents`](/docs/it/settings-reference#leftarrowopensagents) in `/config`.307Puoi disattivare questa scorciatoia per le sessioni in primo piano con l'impostazione [`leftArrowOpensAgents`](/docs/it/settings-reference#leftarrowopensagents) in `/config`.

126* **Accedete con il vostro account Console**, etichettato `(recommended)`: Claude Code mantiene il token OAuth da quell'accesso e lo memorizza come un [profilo Anthropic](#anthropic-profiles-and-federation-credentials). Non crea alcuna chiave API126* **Accedete con il vostro account Console**, etichettato `(recommended)`: Claude Code mantiene il token OAuth da quell'accesso e lo memorizza come un [profilo Anthropic](#anthropic-profiles-and-federation-credentials). Non crea alcuna chiave API

127* **Creare una chiave API**, etichettato `(legacy)`: Claude Code crea una chiave API Console per voi e la memorizza con le vostre altre credenziali127* **Creare una chiave API**, etichettato `(legacy)`: Claude Code crea una chiave API Console per voi e la memorizza con le vostre altre credenziali

128 128 

129In pratica, il profilo memorizza un accesso OAuth mentre una chiave API è una credenziale statica: Claude Code aggiorna automaticamente l'accesso del profilo e, quando l'aggiornamento non riesce, le richieste non riescono con [Anthropic profile login expired](/docs/it/errors#anthropic-profile-login-expired) finché non accedete di nuovo.129In pratica, il profilo memorizza un accesso OAuth mentre una chiave API è una credenziale statica. Claude Code aggiorna automaticamente l'accesso del profilo e, quando l'aggiornamento non riesce, le richieste falliscono con un [errore di accesso del profilo scaduto](/docs/it/errors#anthropic-profile-login-expired) finché non accedi di nuovo.

130 130 

131Non avete la scelta su ogni macchina. Claude Code crea una chiave API senza chiedere in questi casi:131Non avete la scelta su ogni macchina. Claude Code crea una chiave API senza chiedere in questi casi:

132 132 

292 292 

293Per confermare quale fonte Claude Code ha scelto, eseguite `/status`. Una riga `Profile` nomina la fonte al posto della riga `Login method`, e quando il profilo è la credenziale in uso, le righe `Organization` e `Email` mostrano il suo account.293Per confermare quale fonte Claude Code ha scelto, eseguite `/status`. Una riga `Profile` nomina la fonte al posto della riga `Login method`, e quando il profilo è la credenziale in uso, le righe `Organization` e `Email` mostrano il suo account.

294 294 

295Quando l'accesso di un profilo `user_oauth` è scaduto e Claude Code non può rinnovarlo, le richieste falliscono con [Anthropic profile login expired](/docs/it/errors#anthropic-profile-login-expired).295Quando l'accesso di un profilo `user_oauth` è scaduto e Claude Code non riesce a rinnovarlo, le richieste falliscono con un [errore di accesso al profilo scaduto](/docs/it/errors#anthropic-profile-login-expired).

296 296 

297Le funzionalità che necessitano del Vostro accesso claude.ai, come i [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) e [`/schedule`](/docs/it/routines), non sono disponibili mentre una di queste fonti è selezionata. Per impedire a Claude Code di selezionare una fonte:297Le funzionalità che necessitano del Vostro accesso claude.ai, come i [connettori claude.ai](/docs/it/mcp#use-mcp-servers-from-claude-ai) e [`/schedule`](/docs/it/routines), non sono disponibili mentre una di queste fonti è selezionata. Per impedire a Claude Code di selezionare una fonte:

298 298 

90 90 

91Quando la richiesta per i limiti del tuo piano non riesce, il più delle volte perché l'endpoint di utilizzo è limitato dalla frequenza, `/usage` mostra le ultime barre di utilizzo caricate su questa macchina negli ultimi 60 minuti, insieme a una nota `Showing last-known usage` che indica quanto tempo fa sono stati recuperati i dati. Premi `r` per riprovare; un nuovo tentativo riuscito sostituisce le ultime barre conosciute con dati freschi. Senza uno snapshot degli ultimi 60 minuti, `/usage` segnala che l'endpoint di utilizzo è limitato dalla frequenza e offre lo stesso collegamento di riprovazione. Prima della v2.1.208, una richiesta limitata dalla frequenza in una sessione che non aveva ancora caricato l'utilizzo mostrava sempre l'errore senza barre.91Quando la richiesta per i limiti del tuo piano non riesce, il più delle volte perché l'endpoint di utilizzo è limitato dalla frequenza, `/usage` mostra le ultime barre di utilizzo caricate su questa macchina negli ultimi 60 minuti, insieme a una nota `Showing last-known usage` che indica quanto tempo fa sono stati recuperati i dati. Premi `r` per riprovare; un nuovo tentativo riuscito sostituisce le ultime barre conosciute con dati freschi. Senza uno snapshot degli ultimi 60 minuti, `/usage` segnala che l'endpoint di utilizzo è limitato dalla frequenza e offre lo stesso collegamento di riprovazione. Prima della v2.1.208, una richiesta limitata dalla frequenza in una sessione che non aveva ancora caricato l'utilizzo mostrava sempre l'errore senza barre.

92 92 

93<h3 id="read-the-token-count-beside-the-spinner">

94 Leggi il conteggio dei token accanto allo spinner

95</h3>

96 

97Mentre Claude lavora nella conversazione principale, la riga accanto allo spinner può terminare con un tempo trascorso e un conteggio dei token, come in `Deciphering… (10m 27s · ↓ 5.5k tokens)`. È un conteggio approssimativo e in tempo reale dell'output che il turno corrente ha prodotto finora. La freccia accanto al conteggio punta verso il basso mentre arriva l'output o mentre gli strumenti sono in esecuzione.

98 

99* **Cosa copre**: l'output generato dal turno, come il testo e le chiamate agli strumenti che Claude trasmette in streaming, il suo ragionamento e l'output dei subagent eseguiti in [primo piano](/docs/it/sub-agents#run-subagents-in-foreground-or-background)

100* **Cosa esclude**: ciò che Claude Code invia al modello, quindi il tuo prompt, la cronologia della conversazione e il resto del tuo contesto non lo modificano

101* **Quando si azzera**: all'inizio di ogni turno e quando Claude Code [compatta la conversazione](/docs/it/prompt-caching#compacting-the-conversation)

102* **Quando resta nascosto**: finché l'output non inizia ad arrivare, quando la riga è troppo stretta per contenerlo e in [modalità screen reader](/docs/it/accessibility)

103 

104Non corrisponderà alle cifre di output di `Usage by model` nel blocco Session di `/usage`, che sommano l'intera sessione anziché un singolo turno. Differisce anche dal conteggio dei token [aggiunto dalla modalità verbose](/docs/it/statusline#notifications-share-the-status-line-row), perché quel conteggio misura la dimensione del tuo contesto anziché l'output di un turno.

105 

93<h3 id="analyze-your-usage-patterns">106<h3 id="analyze-your-usage-patterns">

94 Analizza i tuoi modelli di utilizzo107 Analizza i tuoi modelli di utilizzo

95</h3>108</h3>

98 98 

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

100 100 

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

102 102 

103```bash theme={null}103<Steps>

104cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude104 <Step title="Crea una directory vuota e spostati al suo interno">

105```105 Nella tua shell, senza alcuna sessione di Claude Code in esecuzione, crea la directory e spostati al suo interno:

106 106 

107La sessione pulita non ha impostazioni utente o progetto, hooks, server MCP, plugin o memoria. Al primo avvio, aspettati le schermate di configurazione iniziale, a partire dalla selezione del tema. Se le vedi, la directory di configurazione pulita è in vigore. Gli avvii successivi con la stessa directory saltano queste schermate perché Claude Code salva lo stato dell'onboarding lì.107 <Tabs>

108 108 <Tab title="Bash o Zsh">

109* Le impostazioni gestite si applicano comunque se la tua organizzazione le distribuisce. Claude Code legge i profili MDM, la policy del registro e `managed-settings.json` da posizioni al di fuori della directory di configurazione, e [recupera le impostazioni gestite dal server](/docs/it/server-managed-settings#fetch-and-caching-behavior) di nuovo per la sessione pulita una volta che ha le credenziali109 ```bash theme={null}

110* Ti verrà chiesto di accedere di nuovo110 mkdir -p ~/claude-clean/empty && cd ~/claude-clean/empty

111 111 ```

112Se il problema scompare qui, la causa è da qualche parte nei tuoi veri file `~/.claude` o progetto `.claude`. Reintroducili uno alla volta, copiando i file nella directory temporanea o avviando dal tuo progetto, per trovare quale. Se persiste nella sessione pulita, la causa è al di fuori della tua configurazione utente e progetto. Esegui `/status` per verificare se le impostazioni gestite sono in vigore, cerca [variabili di ambiente](/docs/it/env-vars) che influenzano Claude Code, quindi vedi [Risoluzione dei problemi](/docs/it/troubleshooting).112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force "$HOME/claude-clean/empty" | Out-Null

117 Set-Location "$HOME/claude-clean/empty"

118 ```

119 </Tab>

120 </Tabs>

121 </Step>

122 

123 <Step title="Avvia Claude Code con una directory di configurazione pulita">

124 Dalla stessa shell, imposta [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars) su una nuova directory al posto di `~/.claude` e passa [`--setting-sources user`](/docs/it/cli-reference#cli-flags) per disattivare la configurazione del progetto, come `.claude/settings.json`, `CLAUDE.md` e `.mcp.json`:

125 

126 <Tabs>

127 <Tab title="Bash o Zsh">

128 La variabile si applica solo a questo avvio.

129 

130 ```bash theme={null}

131 CLAUDE_CONFIG_DIR=~/claude-clean/config claude --setting-sources user

132 ```

133 </Tab>

134 

135 <Tab title="PowerShell">

136 La variabile resta impostata per il resto di questa sessione di PowerShell, quindi i successivi avvii di `claude` nella stessa finestra continuano a usare la directory pulita. Per tornare alla tua directory abituale, esegui `Remove-Item Env:CLAUDE_CONFIG_DIR` prima dell'avvio successivo.

137 

138 ```powershell theme={null}

139 $env:CLAUDE_CONFIG_DIR = "$HOME/claude-clean/config"

140 claude --setting-sources user

141 ```

142 </Tab>

143 </Tabs>

144 

145 Al primo avvio, ripercorri le schermate di configurazione iniziale, segno che la directory di configurazione pulita è in vigore. Le impostazioni gestite si applicano comunque, e i [connettori](/docs/it/mcp#use-mcp-servers-from-claude-ai) vengono comunque caricati se accedi con un account claude.ai.

146 </Step>

147 

148 <Step title="Riproduci il problema">

149 Ripeti nella sessione pulita ciò che ha causato il problema:

150 

151 * **Il problema scompare**: la causa è nella tua configurazione utente o di progetto. Copia `~/.claude.json` e i file in `~/.claude` in `~/claude-clean/config` uno alla volta. Se nessuno fa ricomparire il problema, vai nella directory del tuo progetto nella stessa shell e avvia Claude Code senza `--setting-sources user`. In Bash o Zsh, esegui `CLAUDE_CONFIG_DIR=~/claude-clean/config claude`. In PowerShell, la variabile è ancora impostata, quindi esegui `claude`.

152 * **Il problema persiste**: la causa è al di fuori della tua configurazione utente e di progetto. Esegui `/status` nella sessione per verificare la presenza di impostazioni gestite, controlla le [variabili d'ambiente](/docs/it/env-vars) nella tua shell, quindi consulta [Risoluzione dei problemi](/docs/it/troubleshooting).

153 </Step>

154</Steps>

113 155 

114<h2 id="check-common-causes">156<h2 id="check-common-causes">

115 Controlla le cause comuni157 Controlla le cause comuni

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

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

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

130| Le istruzioni di `CLAUDE.md` della sottodirectory sembrano ignorate | I file della sottodirectory si caricano su richiesta, non all'inizio della sessione | Vedi [quando si caricano i file delle sottodirectory](/docs/it/memory#how-claude-md-files-load). Prima della v2.1.288, solo lo strumento Read li caricava. |172| Le istruzioni di `CLAUDE.md` della sottodirectory sembrano ignorate | I file della sottodirectory si caricano su richiesta, non all'inizio della sessione | Per caricare il `CLAUDE.md` di una sottodirectory, chiedi a Claude di leggere un altro file in quella sottodirectory. Vedi [quando si caricano i file delle sottodirectory](/docs/it/memory#how-claude-md-files-load). |

131| Subagent ignora le istruzioni di `CLAUDE.md` | Gli agenti Explore e Plan incorporati saltano `CLAUDE.md`. I subagenti personalizzati lo caricano nello stesso modo in cui la conversazione principale lo fa, a meno che la sua definizione non imposti [`omitClaudeMd`](/docs/it/sub-agents#supported-frontmatter-fields) | Per Explore o Plan, ripeti l'istruzione nel tuo prompt di delega. Per un subagente che imposta `omitClaudeMd`, rimuovi il campo. Per qualsiasi altro subagente personalizzato, metti le istruzioni critiche nel corpo del file dell'agente, che diventa il prompt di sistema dell'agente. Vedi [cosa si carica all'avvio](/docs/it/sub-agents#what-loads-at-startup). |173| Subagent ignora le istruzioni di `CLAUDE.md` | Gli agenti Explore e Plan incorporati saltano `CLAUDE.md`. I subagenti personalizzati lo caricano nello stesso modo in cui la conversazione principale lo fa, a meno che la sua definizione non imposti [`omitClaudeMd`](/docs/it/sub-agents#supported-frontmatter-fields) | Per Explore o Plan, ripeti l'istruzione nel tuo prompt di delega. Per un subagente che imposta `omitClaudeMd`, rimuovi il campo. Per qualsiasi altro subagente personalizzato, metti le istruzioni critiche nel corpo del file dell'agente, che diventa il prompt di sistema dell'agente. Vedi [cosa si carica all'avvio](/docs/it/sub-agents#what-loads-at-startup). |

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

133| I server MCP in `.mcp.json` non si caricano mai | Il file è sotto `.claude/`, o i suoi server si trovano sotto una chiave `servers` di livello superiore, come nel file `mcp.json` di VS Code, invece di `mcpServers` | La configurazione MCP del progetto va alla radice del repository come `.mcp.json`, non dentro `.claude/`, con server sotto la chiave `mcpServers`. Vedi [MCP configuration](/docs/it/mcp). |175| I server MCP in `.mcp.json` non si caricano mai | Il file è sotto `.claude/`, o i suoi server si trovano sotto una chiave `servers` di livello superiore, come nel file `mcp.json` di VS Code, invece di `mcpServers` | La configurazione MCP del progetto va alla radice del repository come `.mcp.json`, non dentro `.claude/`, con server sotto la chiave `mcpServers`. Vedi [MCP configuration](/docs/it/mcp). |

913 913 

914Ogni voce richiede `id`, `name` e `sshHost`. I campi `sshPort` e `sshIdentityFile` sono facoltativi. Gli utenti possono anche aggiungere `sshConfigs` al proprio `~/.claude/settings.json`.914Ogni voce richiede `id`, `name` e `sshHost`. I campi `sshPort` e `sshIdentityFile` sono facoltativi. Gli utenti possono anche aggiungere `sshConfigs` al proprio `~/.claude/settings.json`.

915 915 

916Se ometti `user@` da `sshHost`, Desktop si connette come lo `User` che il file `~/.ssh/config` di ciascuno sviluppatore imposta per l'host, oppure, in mancanza di questo, con il nome utente dello sviluppatore sul proprio computer.

917 

916<h4 id="restrict-which-ssh-hosts-users-can-connect-to">918<h4 id="restrict-which-ssh-hosts-users-can-connect-to">

917 Restrict which SSH hosts users can connect to919 Restrict which SSH hosts users can connect to

918</h4>920</h4>

937 939 

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

939 941 

942<h4 id="turn-off-local-sessions-and-distribute-ssh-connections">

943 Disattivare le sessioni locali e distribuire connessioni SSH

944</h4>

945 

946Per disattivare le sessioni locali e limitare le sessioni SSH agli host che scegli, distribuisci insieme [`disableDesktopLocalSessions`](/docs/it/settings-reference#disabledesktoplocalsessions), [`sshConfigs`](#pre-configure-ssh-connections-for-your-team) e [`sshHostAllowlist`](#restrict-which-ssh-hosts-users-can-connect-to).

947 

948<Note>

949 Questa configurazione è pensata per gli utenti che accedono con un account Claude. Con un [provider di terze parti](/docs/it/third-party-integrations), le sessioni SSH sono disattivate per impostazione predefinita e impostare `sshHostAllowlist` può attivarle. Leggi [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) prima di distribuire queste chiavi.

950</Note>

951 

952L'esempio seguente disattiva le sessioni locali, aggiunge una connessione e limita le sessioni SSH all'host di quella connessione:

953 

954```json managed-settings.json theme={null}

955{

956 "disableDesktopLocalSessions": true,

957 "sshConfigs": [

958 {

959 "id": "shared-dev-vm",

960 "name": "Shared Dev VM",

961 "sshHost": "dev.example.com"

962 }

963 ],

964 "sshHostAllowlist": ["dev.example.com"]

965}

966```

967 

968Le chiavi si applicano all'app desktop. Lasciano invariati gli altri modi di eseguire Claude Code, come la CLI, Cowork e le sessioni cloud:

969 

970* **La CLI**: nessuna delle chiavi impedisce a uno sviluppatore di eseguire la CLI di Claude Code sul proprio computer

971* **Cowork**: nessuna delle chiavi si applica alle sessioni [Cowork](https://claude.com/docs/cowork/overview) o alle attività pianificate di Cowork

972* **Sessioni cloud**: nessuna delle chiavi cambia la disponibilità delle [sessioni cloud](#cloud-sessions). Per disattivarle, usa l'impostazione **Cloud sessions** in [Admin console controls](#admin-console-controls).

973 

974Quando adatti l'esempio, controlla i nomi host e la versione di Desktop:

975 

976* **Nomi host**: assicurati che un modello in `sshHostAllowlist` corrisponda al nome host di ciascuna voce di `sshConfigs`, senza `user@`, altrimenti gli sviluppatori non potranno connettersi. Per sapere come Desktop confronta un nome host, consulta [Restrict which SSH hosts users can connect to](#restrict-which-ssh-hosts-users-can-connect-to).

977* **Versione**: `disableDesktopLocalSessions` richiede Claude Desktop v1.37937.0 o versioni successive

978 

979Inserisci le tre chiavi in un'unica [fonte gestita](/docs/it/managed-settings#how-claude-code-combines-managed-sources), quella con priorità più alta tra quelle che distribuisci. Se distribuisci [impostazioni gestite dal server](/docs/it/server-managed-settings), mantieni anche una copia delle tre chiavi nella policy MDM o nel file di impostazioni gestite con priorità più alta su ciascun computer. Desktop recupera le impostazioni gestite dal server all'avvio e la copia sul computer si applica finché un recupero non riesce.

980 

981Per verificare che le impostazioni vengano applicate, controlla il computer di uno sviluppatore:

982 

983<Steps>

984 <Step title="Controlla il menu a discesa dell'ambiente">

985 Chiudi e riapri Desktop, quindi apri il menu a discesa dell'ambiente nella casella del prompt. **Local** è disattivato e **Shared Dev VM** appare sotto **SSH**. Se **Local** è ancora disponibile, controlla la versione di Desktop, che il file sia JSON valido e quale fonte gestita legge il computer.

986 </Step>

987 

988 <Step title="Aggiungi un host che non è nell'allowlist">

989 [Aggiungi una connessione SSH](#ssh-sessions) con un nome host che non è nell'allowlist, come `other.example.com`. Desktop salva la connessione ma si rifiuta di connettersi e indica che le impostazioni della tua organizzazione non consentono la connessione.

990 </Step>

991</Steps>

992 

940<h2 id="enterprise-configuration">993<h2 id="enterprise-configuration">

941 Configurazione aziendale994 Configurazione aziendale

942</h2>995</h2>

256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disattivare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` negli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |256| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Imposta su `1` per disattivare tutte le funzionalità delle attività in background, incluso il parametro `run_in_background` negli strumenti Bash e subagent, lo spostamento automatico in background e la scorciatoia Ctrl+B |

257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come event stream binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia rimosso l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge allora il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o versioni successive |257| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Imposta su `1` per impedire a Claude Code di trattare una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) con un header `Content-Type` mancante o vuoto come event stream binario di Amazon Bedrock. Per impostazione predefinita, Claude Code presume che un gateway abbia rimosso l'header da una risposta altrimenti non modificata, quindi decodifica il corpo e lo streaming continua a funzionare. Impostala solo per un gateway che riemette anche lo stream come server-sent events; Claude Code legge allora il corpo senza header come server-sent events. Richiede Claude Code v2.1.239 o versioni successive |

258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta su `1` per saltare il controllo che verifica che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway in modo che inoltri l'header `Content-Type` e il corpo senza modifiche invece di impostare questa variabile. Richiede Claude Code v2.1.208 o versioni successive |258| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | Imposta su `1` per saltare il controllo che verifica che una risposta in streaming di [Amazon Bedrock](/docs/it/amazon-bedrock) abbia il content-type `application/vnd.amazon.eventstream`. Senza questa variabile, quando una risposta ha un content-type diverso, Claude Code fa fallire la richiesta con un errore che indica quel tipo, il che significa che un [gateway o un proxy sta trasformando la risposta](/docs/it/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy). Configura il gateway in modo che inoltri l'header `Content-Type` e il corpo senza modifiche invece di impostare questa variabile. Richiede Claude Code v2.1.208 o versioni successive |

259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta su `1` per arrestare i comandi shell in background in esecuzione, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background di una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Influisce solo su quel passaggio: spostare una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o versioni successive |259| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | Imposta su `1` per arrestare i comandi shell in background in esecuzione, i workflow dinamici e, a partire dalla v2.1.198, i subagent in background di una [sessione in background](/docs/it/agent-view) quando il [supervisore](/docs/it/agent-view#the-supervisor-process) arresta, riavvia o aggiorna il processo di quella sessione, invece di passarli al processo successivo della sessione. Influisce solo su quel passaggio: mandare una sessione in background con `←` o [`/background`](/docs/it/agent-view#from-inside-a-session) trasferisce comunque il lavoro in background in corso, e `CLAUDE_DISABLE_ADOPT` disattiva entrambi. Richiede Claude Code v2.1.196 o successiva |

260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o versioni successive |260| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Imposta su `1` per impedire a Claude Code di terminare i [comandi shell in background](/docs/it/interactive-mode#background-bash-commands) in caso di pressione sulla memoria. Per impostazione predefinita, su macOS e Linux, Claude Code termina le shell in background quando il sistema operativo segnala una pressione critica sulla memoria e la sessione è rimasta inattiva per 30 minuti senza turni o subagent in esecuzione. Windows non ha un segnale di pressione sulla memoria, quindi lì questa variabile non ha effetto. Richiede Claude Code v2.1.193 o versioni successive |

261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disattivare le [skill](/docs/it/skills) e i workflow inclusi in Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma sono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivale all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |261| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Imposta su `1` per disattivare le [skill](/docs/it/skills) e i workflow inclusi in Claude Code: le skill e i workflow inclusi vengono rimossi completamente, mentre i comandi integrati come `/init` restano digitabili ma sono nascosti al modello. `/doctor` resta digitabile come i comandi integrati; nascondilo invece con `DISABLE_DOCTOR_COMMAND`. Le skill provenienti dai plugin, da `.claude/skills/` e da `.claude/commands/` non sono interessate. Equivale all'impostazione [`disableBundledSkills`](/docs/it/settings-reference#disablebundledskills) |

262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta su `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Pensata per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o versioni successive |262| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | Imposta su `1` per mantenere disponibili gli strumenti del browser di [Claude in Chrome](/docs/it/chrome) omettendo la sezione Chrome del prompt di sistema e la [skill inclusa](/docs/it/skills#bundled-skills) `/claude-in-chrome`. Pensata per gli host che incorporano Claude Code e forniscono le proprie indicazioni per il browser. Richiede Claude Code v2.1.257 o versioni successive |

94| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |94| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |

95| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |95| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Autenticazione](#your-account-is-on-hold) |

96| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticazione](#anthropic-profile-login-expired) |96| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Autenticazione](#anthropic-profile-login-expired) |

97| `Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile` | [Autenticazione](#anthropic-profile-login-expired) |

97| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Autenticazione](#anthropic-profile-login-expired) |98| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Autenticazione](#anthropic-profile-login-expired) |

98| `does not meet scope requirement user:profile` | [Autenticazione](#oauth-scope-requirement) |99| `does not meet scope requirement user:profile` | [Autenticazione](#oauth-scope-requirement) |

99| `claude.ai rejected the session token` / `session token rejected` | [Autenticazione](#claude-ai-rejected-the-session-token) |100| `claude.ai rejected the session token` / `session token rejected` | [Autenticazione](#claude-ai-rejected-the-session-token) |

1303Failed to authenticate: OAuth session expired and could not be refreshed1304Failed to authenticate: OAuth session expired and could not be refreshed

1304```1305```

1305 1306 

1307Per un messaggio `Login expired` che termina con `or re-authenticate your Anthropic profile`, consulta [Anthropic profile login expired](#anthropic-profile-login-expired).

1308 

1306Questo stato non è lo stesso di [Token OAuth revocato o scaduto](#oauth-token-revoked-or-expired). Quei messaggi riportano un rifiuto restituito dall'API. Claude Code stesso produce `Login expired` per un accesso che non è già riuscito a rinnovare, quindi non invia alcuna richiesta. Quando il rinnovo fallisce perché è l'account stesso a essere sospeso e non l'accesso a essere obsoleto, Claude Code mostra invece [Il tuo account è sospeso](#your-account-is-on-hold).1309Questo stato non è lo stesso di [Token OAuth revocato o scaduto](#oauth-token-revoked-or-expired). Quei messaggi riportano un rifiuto restituito dall'API. Claude Code stesso produce `Login expired` per un accesso che non è già riuscito a rinnovare, quindi non invia alcuna richiesta. Quando il rinnovo fallisce perché è l'account stesso a essere sospeso e non l'accesso a essere obsoleto, Claude Code mostra invece [Il tuo account è sospeso](#your-account-is-on-hold).

1307 1310 

1308Le sessioni autenticate con una chiave API, con [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o con un provider di terze parti non usano l'accesso salvato e non vedono mai questo messaggio.1311Le sessioni autenticate con una chiave API, con [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/it/env-vars) o con un provider di terze parti non usano l'accesso salvato e non vedono mai questo messaggio.

1468 Accesso del profilo Anthropic scaduto1471 Accesso del profilo Anthropic scaduto

1469</h3>1472</h3>

1470 1473 

1471Claude Code si sta autenticando tramite un profilo di credenziali Anthropic la cui credenziale di accesso salvata è scaduta, e il profilo non contiene alcuna credenziale di aggiornamento che Claude Code possa usare per rinnovarla. Claude Code interrompe ogni richiesta localmente senza riprovare, perché un nuovo tentativo leggerebbe la stessa credenziale scaduta.1474Claude Code si sta autenticando tramite un profilo di credenziali Anthropic la cui credenziale di login salvata è scaduta, e il profilo non contiene alcuna credenziale di aggiornamento che Claude Code possa usare per rinnovarla. Claude Code interrompe ogni richiesta localmente senza riprovare.

1472 1475 

1473```text theme={null}1476```text theme={null}

1474Anthropic profile login expired · Re-authenticate your Anthropic profile1477Anthropic profile login expired · Re-authenticate your Anthropic profile

1475Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1478Login expired · Run /login to sign in again, or re-authenticate your Anthropic profile

1476```1479```

1477 1480 

1478Questo messaggio compare solo quando la credenziale attiva proviene da un profilo di credenziali Anthropic: uno che selezioni con la variabile d'ambiente `ANTHROPIC_PROFILE`, uno che Claude Code individua come profilo attivo nella tua directory di configurazione Anthropic, o uno che Claude Code ha scritto quando hai [effettuato l'accesso senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Le sessioni che si autenticano con una chiave API, un bearer token come `ANTHROPIC_AUTH_TOKEN` o un provider di terze parti non vedono mai questo messaggio.

1479 

1480Su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), esegui `/login`, scegli l'account Anthropic Console e accedi di nuovo per rinnovare un profilo scritto dall'accesso Console senza chiave o da `ant auth login` della Claude Platform CLI. Claude Code sostituisce la credenziale scaduta in quel profilo. Per un profilo di federazione o uno creato da un altro strumento, `/login` non rinnova la credenziale. La forma che vedi dipende dal fatto che tu abbia selezionato il profilo o che Claude Code lo abbia individuato:

1481 

1482* Quando imposti `ANTHROPIC_PROFILE` esplicitamente, il messaggio termina con `Re-authenticate your Anthropic profile`.

1483* Quando Claude Code ha individuato il profilo dalla tua directory di configurazione, il messaggio propone `/login`, perché Claude Code dà a un `/login` funzionante la precedenza sul profilo individuato e poi si autentica invece con il tuo account claude.ai o Console. Prima della v2.1.234, Claude Code mostrava anche in questo caso la forma `Re-authenticate your Anthropic profile`.

1484 

1485**Cosa fare:**1481**Cosa fare:**

1486 1482 

1487* Accedi di nuovo al profilo, poi riprova: su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key), esegui `/login` e scegli l'account Anthropic Console per un profilo scritto dall'accesso Console senza chiave o da `ant auth login` della Claude Platform CLI; per gli altri profili, usa lo strumento che li ha creati1483* Se il messaggio inizia con `Login expired`, esegui `/login` per accedere di nuovo

1484* Per rinnovare un profilo scritto dall'accesso alla Console senza chiave o da `ant auth login` della CLI di Claude Platform, esegui `/login` su una macchina che [offre l'accesso senza chiave](/docs/it/authentication#sign-in-without-an-api-key). Scegli l'account Anthropic Console, poi **Sign in with your Console account**. Claude Code sostituisce la credenziale scaduta in quel profilo

1485* Per rinnovare un profilo creato da un altro strumento, accedi di nuovo con quello strumento. Se invece scegli **Sign in with your Console account** in `/login`, Claude Code lascia il profilo così com'è e crea una chiave API

1488* Se la credenziale del profilo è stata fornita da un amministratore, chiedigli di emetterne una nuova1486* Se la credenziale del profilo è stata fornita da un amministratore, chiedigli di emetterne una nuova

1489* Esegui `/status` per verificare l'origine delle credenziali attiva e il nome del profilo1487* Esegui `/status` per verificare l'origine delle credenziali attiva e il nome del profilo

1490* Per smettere di usare il profilo, rimuovi `ANTHROPIC_PROFILE` se l'hai impostata, poi autenticati in un altro modo, ad esempio con `/login` o `ANTHROPIC_API_KEY`1488* Per smettere di usare il profilo, rimuovi `ANTHROPIC_PROFILE` se l'hai impostata, poi autenticati in un altro modo, ad esempio con `/login` o `ANTHROPIC_API_KEY`

1491 1489 

1490L'inizio del messaggio ti indica come Claude Code ha trovato il profilo:

1491 

1492* Quando Claude Code ha rilevato il profilo dalla tua directory di configurazione e la sua modalità di autenticazione è `user_oauth`, il messaggio inizia con `Login expired` e propone prima `/login`. Claude Code dà a un `/login` funzionante la precedenza sul profilo rilevato e si autentica quindi con il tuo account claude.ai. Dalla v2.1.234 fino alla v2.1.277, questa forma era `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile`. Prima della v2.1.234, anche in questo caso Claude Code mostrava la forma `Re-authenticate your Anthropic profile`.

1493* Quando hai selezionato il profilo con `ANTHROPIC_PROFILE`, il messaggio inizia con `Anthropic profile login expired`.

1494 

1495Questo messaggio compare solo quando la credenziale attiva proviene da un profilo di credenziali Anthropic, che tu selezioni con la variabile d'ambiente `ANTHROPIC_PROFILE`, che Claude Code rileva come profilo attivo nella tua directory di configurazione Anthropic, o che Claude Code ha scritto quando hai [effettuato l'accesso senza una chiave API](/docs/it/authentication#sign-in-without-an-api-key). Le sessioni che si autenticano con una chiave API, con un bearer token come `ANTHROPIC_AUTH_TOKEN` o con un provider di terze parti non vedono mai questo messaggio.

1496 

1492<h3 id="oauth-scope-requirement">1497<h3 id="oauth-scope-requirement">

1493 Requisito di scope OAuth1498 Requisito di scope OAuth

1494</h3>1499</h3>

4039 4044 

4040**Cosa fare:**4045**Cosa fare:**

4041 4046 

4042* Esegui `claude plugin marketplace remove <name>`. Questo disinstalla anche i plugin installati dal marketplace e cancella i loro dati salvati4047* Per mantenere un marketplace che un file di impostazioni dichiara inline con `"source": "settings"`, rinominalo prima di rimuovere il vecchio nome, perché la rimozione del marketplace elimina anche la sua voce dai tuoi file di impostazioni. Claude Code v2.1.292 o successivo elenca questi passaggi nel messaggio:

4043* Per mantenere il marketplace invece, attendi fino a quando il suo manutentore lo rinomina, quindi esegui `claude plugin marketplace update <name>`4048 1. In ogni file di impostazioni che elenca il marketplace sotto `extraKnownMarketplaces`, assegna alla chiave della voce e al suo `source.name` un unico nuovo nome in ASCII semplice che non sembri uno ufficiale. Se un amministratore aggiunge il marketplace tramite le impostazioni gestite della tua organizzazione, è l'amministratore a eseguire questo passaggio

4049 2. Esegui `claude plugin marketplace remove <old-name>`, oppure rimuovi il vecchio nome nella scheda **Marketplaces** di `/plugin`. Questo disinstalla anche i suoi plugin ed elimina i loro dati, opzioni e segreti

4050 3. Avvia di nuovo Claude Code, nella cartella del progetto se il file è un file di impostazioni di progetto. Quindi installa i plugin dal marketplace rinominato

4051* Per mantenere qualsiasi altro marketplace, attendi fino a quando il suo manutentore lo rinomina, quindi esegui `claude plugin marketplace update <name>`

4052* Per rimuovere il marketplace, esegui `claude plugin marketplace remove <name>`. Questo disinstalla anche i plugin installati dal marketplace ed elimina i loro dati, opzioni e segreti

4044* Se pubblichi il marketplace, rinominalo nel tuo `marketplace.json`; gli utenti aggiornano il marketplace invece di rimuoverlo4053* Se pubblichi il marketplace, rinominalo nel tuo `marketplace.json`; gli utenti aggiornano il marketplace invece di rimuoverlo

4045 4054 

4046<h3 id="marketplace-is-already-added-from-a-different-source">4055<h3 id="marketplace-is-already-added-from-a-different-source">

3321 WorktreeCreate3321 WorktreeCreate

3322</h3>3322</h3>

3323 3323 

3324Viene eseguito quando viene creato un worktree, sia da `claude --worktree`, sia da un [subagent che usa `isolation: "worktree"`](/docs/it/sub-agents#choose-the-subagent-scope), sia per una [sessione in background](/docs/it/agent-view#how-file-edits-are-isolated) che Claude Code isola nel proprio worktree. Per impostazione predefinita Claude Code crea la copia di lavoro isolata con `git worktree`. Configurare un hook WorktreeCreate sostituisce questo comportamento git predefinito, permettendoti di usare un sistema di controllo versione diverso come SVN, Perforce o Mercurial.3324Viene eseguito quando Claude Code crea un worktree in casi come questi:

3325 

3326* Avvii una sessione con `claude --worktree`

3327* Claude crea un worktree durante una sessione e vi si sposta con lo strumento [`EnterWorktree`](/docs/it/tools-reference)

3328* Un [subagent usa `isolation: "worktree"`](/docs/it/sub-agents#choose-the-subagent-scope)

3329* Un [workflow](/docs/it/workflows#migrate-many-files-in-parallel) esegue un agente nel proprio worktree

3330* Claude Code isola una [sessione in background](/docs/it/agent-view#how-file-edits-are-isolated) nel proprio worktree

3331* [`claude remote-control`](/docs/it/remote-control#start-a-remote-control-session) in modalità `worktree` avvia una sessione nel proprio worktree

3332 

3333Quando Claude esegue `git worktree add` tramite lo strumento Bash invece di chiamare `EnterWorktree`, il tuo hook WorktreeCreate non viene eseguito. Per ispezionare o bloccare quel comando, aggiungi un hook [`PreToolUse`](#pretooluse) con il matcher `Bash`.

3334 

3335Per impostazione predefinita Claude Code crea la copia di lavoro isolata con `git worktree`. Configurare un hook WorktreeCreate sostituisce quel comportamento Git predefinito, permettendoti di usare un sistema di controllo versione diverso come SVN, Perforce o Mercurial.

3325 3336 

3326Poiché l'hook sostituisce interamente il comportamento predefinito, [`.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) non viene elaborato. Se devi copiare file di configurazione locali come `.env` nel nuovo worktree, fallo all'interno del tuo script hook.3337Poiché l'hook sostituisce interamente il comportamento predefinito, [`.worktreeinclude`](/docs/it/worktrees#copy-gitignored-files-into-worktrees) non viene elaborato. Se devi copiare file di configurazione locali come `.env` nel nuovo worktree, fallo all'interno del tuo script hook.

3327 3338 

3390* Esci da una [sessione worktree](/docs/it/worktrees#start-claude-in-a-worktree) interattiva e scegli di rimuovere il worktree quando Claude Code te lo chiede3401* Esci da una [sessione worktree](/docs/it/worktrees#start-claude-in-a-worktree) interattiva e scegli di rimuovere il worktree quando Claude Code te lo chiede

3391* Esci da una sessione worktree interattiva a cui non hai [dato un nome](/docs/it/sessions#name-your-sessions), Claude Code non trova file modificati o non tracciati e rimuove il worktree senza chiedertelo3402* Esci da una sessione worktree interattiva a cui non hai [dato un nome](/docs/it/sessions#name-your-sessions), Claude Code non trova file modificati o non tracciati e rimuove il worktree senza chiedertelo

3392* Elimini una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) che viene eseguita nel worktree3403* Elimini una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) che viene eseguita nel worktree

3404* Chiedi a Claude di uscire e rimuovere il worktree durante una sessione, e Claude lo rimuove con lo strumento [`ExitWorktree`](/docs/it/tools-reference)

3405* Una sessione che [`claude remote-control`](/docs/it/remote-control#start-a-remote-control-session) ha avviato in modalità `worktree` termina senza arresti anomali, e Claude Code non trova file modificati o non tracciati né nuovi commit nel suo worktree

3406* Arresti `claude remote-control` mentre le sessioni che ha avviato in modalità `worktree` sono ancora in esecuzione, e Claude Code non trova file modificati o non tracciati né nuovi commit nei loro worktree

3407 

3408Quando un subagent o un agente di un workflow termina, Claude Code mantiene il worktree che il tuo hook WorktreeCreate ha creato per esso e non esegue il tuo hook WorktreeRemove. Rimuovi tu stesso quei worktree quando il lavoro è terminato.

3409 

3410Claude Code non ti chiede conferma prima che il tuo hook venga eseguito per una chiamata a `ExitWorktree` o per una pulizia di `claude remote-control`. `ExitWorktree` si rifiuta di rimuovere un worktree creato da un hook a meno che la chiamata non passi [`discard_changes: true`](/docs/it/agent-sdk/typescript#exitworktree), il che rende il tuo hook l'ultimo controllo su quel percorso.

3393 3411 

3394Claude Code usa git per cercare file modificati o non tracciati, quindi non ne trova nessuno in un worktree che non è un checkout git né si trova all'interno di uno, anche quando la directory contiene lavoro non sottoposto a commit. Controlla la presenza di tale lavoro nel tuo hook WorktreeRemove prima che elimini qualsiasi cosa.3412Claude Code usa git per cercare file modificati o non tracciati, quindi non ne trova nessuno in un worktree che non è un checkout git né si trova all'interno di uno, anche quando la directory contiene lavoro non sottoposto a commit. Controlla la presenza di tale lavoro nel tuo hook WorktreeRemove prima che elimini qualsiasi cosa.

3395 3413 

3396Per i worktree basati su git, Claude Code gestisce la pulizia automaticamente con `git worktree remove`. Se hai configurato un hook WorktreeCreate, abbinalo a un hook WorktreeRemove per controllare la pulizia dei worktree che crea:3414Per i worktree basati su Git, Claude Code gestisce la pulizia automaticamente con `git worktree remove`. Se hai configurato un hook WorktreeCreate, abbinalo a un hook WorktreeRemove per controllare la pulizia:

3397 3415 

3398* **Nessun hook WorktreeRemove**: quando Claude Code rimuove il worktree mentre esci da una sessione worktree, ripiega su `git worktree remove --force` sul percorso restituito dal tuo hook WorktreeCreate, quindi un worktree riconosciuto da git viene rimosso. Un worktree che git non riconosce, ad esempio uno creato dal tuo hook con un sistema di controllo versione non git, rimane su disco. Per sapere cosa comporta l'eliminazione di una [sessione in background](/docs/it/agent-view#what-deleting-a-session-removes) per un worktree creato da un hook, consulta le regole di eliminazione della vista agente.3416* **Nessun hook WorktreeRemove**: Claude Code ripiega su Git per una rimozione all'uscita o tramite `ExitWorktree`, e mantiene il worktree quando è `claude remote-control` a eseguire la pulizia:

3417 * **Esci da una sessione in un worktree, oppure Claude chiama `ExitWorktree`**: Claude Code rimuove il percorso restituito dal tuo hook WorktreeCreate come farebbe `git worktree remove --force`, quindi un worktree riconosciuto da Git viene rimosso. Un worktree che Git non riconosce, ad esempio uno che il tuo hook ha creato con un sistema di controllo versione diverso da Git, rimane su disco.

3418 * **`claude remote-control` rimuove il worktree di una sessione**: il worktree rimane su disco e il terminale in cui è in esecuzione `claude remote-control` mostra `worktree removal failed, kept: <path>`.

3419 * **Elimini una sessione in background**: consulta [Cosa rimuove l'eliminazione di una sessione](/docs/it/agent-view#what-deleting-a-session-removes).

3399* **L'hook esce con 0**: il worktree viene considerato rimosso. Claude Code non legge nient'altro dall'hook, quindi assicurati che il tuo hook abbia eliminato la directory.3420* **L'hook esce con 0**: il worktree viene considerato rimosso. Claude Code non legge nient'altro dall'hook, quindi assicurati che il tuo hook abbia eliminato la directory.

3400* **L'hook esce con un codice diverso da zero**: la rimozione fallisce se la directory in `worktree_path` esiste ancora in seguito, e il worktree rimane su disco senza fallback git. Un hook che ha eliminato la directory prima di uscire con un codice diverso da zero viene considerato come rimosso. Per sapere come viene segnalato il fallimento, consulta [Input di WorktreeRemove](#worktreeremove-input).3421* **L'hook esce con un codice diverso da zero**: la rimozione fallisce se la directory in `worktree_path` esiste ancora in seguito, e il worktree rimane su disco senza fallback git. Un hook che ha eliminato la directory prima di uscire con un codice diverso da zero viene considerato come rimosso. Per sapere come viene segnalato il fallimento, consulta [Input di WorktreeRemove](#worktreeremove-input).

3401 3422 

3403 3424 

3404Claude Code scarta i [campi di output JSON](#json-output) di un hook WorktreeRemove, come `systemMessage` e `continue`.3425Claude Code scarta i [campi di output JSON](#json-output) di un hook WorktreeRemove, come `systemMessage` e `continue`.

3405 3426 

3406Per l'eliminazione di una sessione in background, Claude Code verifica il percorso del worktree memorizzato prima di eseguire l'hook e rifiuta un percorso che è un collegamento simbolico o che ne attraversa uno sotto la radice del repository. L'hook viene eseguito per un worktree che contiene ancora file solo quando confermi l'eliminazione nella [vista agente](/docs/it/agent-view#what-deleting-a-session-removes); per un worktree di questo tipo, [`claude rm`](/docs/it/agent-view#manage-sessions-from-the-shell) mantiene invece la sessione e il worktree. Prima della v2.1.216, l'hook veniva eseguito sul percorso memorizzato senza questi controlli.3427Per l'eliminazione di una sessione in background, Claude Code verifica il percorso del worktree memorizzato prima di eseguire l'hook e rifiuta un percorso che è un collegamento simbolico o che ne attraversa uno sotto la root del repository. In quel caso, l'hook viene eseguito per un worktree che contiene ancora file solo quando confermi l'eliminazione nella [vista degli agenti](/docs/it/agent-view#what-deleting-a-session-removes); per un worktree di questo tipo, [`claude rm`](/docs/it/agent-view#manage-sessions-from-the-shell) mantiene invece la sessione e il worktree. Prima della v2.1.216, l'hook veniva eseguito sul percorso memorizzato senza questi controlli.

3407 3428 

3408Claude Code passa il percorso restituito da WorktreeCreate come `worktree_path` nell'input dell'hook. Questo esempio legge quel percorso e rimuove la directory:3429Claude Code passa il percorso restituito da WorktreeCreate come `worktree_path` nell'input dell'hook. Questo esempio legge quel percorso e rimuove la directory:

3409 3430 

3444 3465 

3445* Il worktree rimane su disco, e il comando e lo stderr dell'hook finiscono nel [log di debug](#debug-hooks).3466* Il worktree rimane su disco, e il comando e lo stderr dell'hook finiscono nel [log di debug](#debug-hooks).

3446* Se stavi eliminando una sessione in background, anche la sessione rimane. Il messaggio di rifiuto nella [vista agente](/docs/it/agent-view#what-deleting-a-session-removes) riporta come è terminato l'hook, ad esempio `exited 1`, cita l'inizio del suo stderr e indica se eliminare di nuovo la sessione rimuove comunque la directory.3467* Se stavi eliminando una sessione in background, anche la sessione rimane. Il messaggio di rifiuto nella [vista agente](/docs/it/agent-view#what-deleting-a-session-removes) riporta come è terminato l'hook, ad esempio `exited 1`, cita l'inizio del suo stderr e indica se eliminare di nuovo la sessione rimuove comunque la directory.

3468* Se `claude remote-control` stava rimuovendo il worktree di una sessione, il terminale in cui è in esecuzione mostra `worktree removal failed, kept: <path>`.

3447 3469 

3448<h3 id="precompact">3470<h3 id="precompact">

3449 PreCompact3471 PreCompact

55| Vuoi | Inizia con | Isolamento necessario | Note |55| Vuoi | Inizia con | Isolamento necessario | Note |

56| :- | :- | :- | :- |56| :- | :- | :- | :- |

57| Revisionare ogni azione tu stesso | Modalità Manual: `claude --permission-mode default` | Nessuno | Lavoro sensibile, codice non familiare |57| Revisionare ogni azione tu stesso | Modalità Manual: `claude --permission-mode default` | Nessuno | Lavoro sensibile, codice non familiare |

58| Iterare localmente con meno prompt, senza un classificatore | Modalità Manual più la sandbox Bash in [modalità auto-allow](/docs/it/sandboxing#sandbox-modes): `claude --permission-mode default`, quindi esegui `/sandbox` e seleziona auto-allow | La sandbox Bash integrata, su macOS, Linux e WSL2 | Le regole di negazione si applicano comunque, e le regole di richiesta che nominano un comando, come `Bash(git push *)`, richiedono comunque un prompt. Per attivare la sandbox da un file di impostazioni, imposta [`sandbox.enabled`](/docs/it/settings-reference#sandbox-enabled) su `true` |58| Iterare localmente con meno prompt, senza un classificatore | Modalità Manual più la sandbox Bash in [modalità auto-allow](/docs/it/sandboxing#sandbox-modes): `claude --permission-mode default`, quindi esegui `/sandbox` e seleziona auto-allow | La sandbox Bash integrata, su macOS, Linux e WSL2 | Le regole di negazione si applicano comunque, e le regole di richiesta che nominano un comando, come `Bash(git push *)`, richiedono comunque un prompt. La [modalità auto-allow](/docs/it/sandboxing#auto-allow-mode) copre altri comandi che possono chiedere conferma. Per attivare la sandbox da un file di impostazioni, imposta [`sandbox.enabled`](/docs/it/settings-reference#sandbox-enabled) su `true` |

59| Esplorare prima di modificare qualsiasi cosa | `claude --permission-mode plan` | Nessuno | Claude Code blocca le modifiche finché non [approvi un piano](#review-and-approve-a-plan) |59| Esplorare prima di modificare qualsiasi cosa | `claude --permission-mode plan` | Nessuno | Claude Code blocca le modifiche finché non [approvi un piano](#review-and-approve-a-plan) |

60| Lavorare senza intervento in modalità auto | `claude --permission-mode auto`, la [modalità di autorizzazione iniziale integrata](#which-mode-a-session-starts-in) con v2.1.283 o successivo | Nessuno; una sandbox o un container aggiunge difesa in profondità | Richiede un [modello supportato](#eliminate-prompts-with-auto-mode), e la tua organizzazione può [disattivare la modalità auto](#eliminate-prompts-with-auto-mode) |60| Lavorare senza intervento in modalità auto | `claude --permission-mode auto`, la [modalità di autorizzazione iniziale integrata](#which-mode-a-session-starts-in) con v2.1.283 o successivo | Nessuno; una sandbox o un container aggiunge difesa in profondità | Richiede un [modello supportato](#eliminate-prompts-with-auto-mode), e la tua organizzazione può [disattivare la modalità auto](#eliminate-prompts-with-auto-mode) |

61| Eseguire in CI con una lista di autorizzazione esatta | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nessuno oltre a quello che il tuo runner CI fornisce | [Cloud sessions](/docs/it/claude-code-on-the-web) ignora `dontAsk` dai file di impostazioni |61| Eseguire in CI con una lista di autorizzazione esatta | `claude -p "run the test suite" --permission-mode dontAsk --allowedTools "Bash(npm test)" "Read"` | Nessuno oltre a quello che il tuo runner CI fornisce | [Cloud sessions](/docs/it/claude-code-on-the-web) ignora `dontAsk` dai file di impostazioni |

744* Le regole ask con ambito di contenuto come `Bash(git push *)` forzano comunque un prompt744* Le regole ask con ambito di contenuto come `Bash(git push *)` forzano comunque un prompt

745* Le regole deny esplicite si applicano ancora745* Le regole deny esplicite si applicano ancora

746* I comandi `rm` o `rmdir` che hanno come destinazione un [percorso critico](/docs/it/permission-modes#critical-paths) passano comunque attraverso il flusso di autorizzazione regolare746* I comandi `rm` o `rmdir` che hanno come destinazione un [percorso critico](/docs/it/permission-modes#critical-paths) passano comunque attraverso il flusso di autorizzazione regolare

747* Anche altri comandi in sandbox possono passare attraverso il normale flusso dei permessi, come descritto in [Modalità auto-allow](/docs/it/sandboxing#auto-allow-mode)

747 748 

748I comandi che non verranno eseguiti in sandbox, come i comandi esclusi, rispettano la regola ask bare `Bash` come al solito. Consultate [modalità sandbox](/docs/it/sandboxing#sandbox-modes) per modificare questo comportamento.749I comandi che non verranno eseguiti in sandbox, come i comandi esclusi, rispettano la regola ask bare `Bash` come al solito. Consultate [modalità sandbox](/docs/it/sandboxing#sandbox-modes) per modificare questo comportamento.

749 750 

55* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.55* **Nomi che iniziano con `claudeai-`**: riservati per i marketplace ospitati su claude.ai. `claude plugin marketplace add` rifiuta qualsiasi altro marketplace che ne utilizzi uno con `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai`.

56* **La cartella di download di un marketplace GitHub registrato, `<owner>-<repo>`**: Claude Code scarica un marketplace aggiunto da una sorgente `github` come `acme/x-tools` tramite una cartella denominata `acme-x-tools`, qualunque sia il `name` di quel marketplace. Finché quel marketplace è registrato con un nome diverso da `acme-x-tools`, `claude plugin marketplace add` rifiuta un marketplace diverso chiamato `acme-x-tools` dopo averlo scaricato e segnala `Can't use the marketplace name "acme-x-tools"`. Questo controllo richiede Claude Code v2.1.290 o successivo.56* **La cartella di download di un marketplace GitHub registrato, `<owner>-<repo>`**: Claude Code scarica un marketplace aggiunto da una sorgente `github` come `acme/x-tools` tramite una cartella denominata `acme-x-tools`, qualunque sia il `name` di quel marketplace. Finché quel marketplace è registrato con un nome diverso da `acme-x-tools`, `claude plugin marketplace add` rifiuta un marketplace diverso chiamato `acme-x-tools` dopo averlo scaricato e segnala `Can't use the marketplace name "acme-x-tools"`. Questo controllo richiede Claude Code v2.1.290 o successivo.

57 57 

58Quando un marketplace registrato smette di caricarsi perché il suo nome imita uno ufficiale, `claude plugin list` e `/plugin` segnalano `Claude Code refuses the marketplace name "<name>"`. Il messaggio indica di rimuovere il marketplace. La rimozione disinstalla anche i suoi plugin e cancella i loro dati salvati. Questo messaggio di rifiuto denominato richiede Claude Code v2.1.282 o successivo.58Quando un marketplace registrato smette di caricarsi perché il suo nome imita uno ufficiale, `claude plugin list` e `/plugin` segnalano `Claude Code refuses the marketplace name "<name>"`. Il messaggio ti indica di rimuovere il marketplace. La rimozione disinstalla anche i suoi plugin e ne cancella dati, opzioni e segreti. Questo messaggio di rifiuto con il nome richiede Claude Code v2.1.282 o successivo.

59 

60Se un file di impostazioni dichiara il marketplace inline, il messaggio ti indica di rinominare la sua voce prima di rimuovere il vecchio nome. Per i passaggi, consulta [Claude Code rifiuta il nome del marketplace](/docs/it/errors#claude-code-refuses-the-marketplace-name). Il messaggio li elenca in Claude Code v2.1.292 o successivo.

59 61 

60<h2 id="top-level-fields">62<h2 id="top-level-fields">

61 Top-level fields63 Top-level fields

88| [`prompt.submit`](/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Viene inviato un prompt | `next({ ...e, text })`, `next({ ...e, context })` oppure `{ drop: reason }` |88| [`prompt.submit`](/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Viene inviato un prompt | `next({ ...e, text })`, `next({ ...e, context })` oppure `{ drop: reason }` |

89| `prompt.fill`, `prompt.suggest` | Del testo sta per essere inserito nella casella del prompt come bozza o come suggerimento attenuato | `next(e)` con il testo modificato |89| `prompt.fill`, `prompt.suggest` | Del testo sta per essere inserito nella casella del prompt come bozza o come suggerimento attenuato | `next(e)` con il testo modificato |

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

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

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

92| [`prompt.section`](/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni sezione con nome del prompt di sistema. `e.name` è l'`id` della sezione in `prompt.compose`. | `{ text }` oppure `{ text: null }` per omettere la sezione |93| [`prompt.section`](/docs/it/plugins/mods/events#rewrite-or-add-to-a-prompt) | Una volta per ogni sezione con nome del prompt di sistema. `e.name` è l'`id` della sezione in `prompt.compose`. | `{ text }` oppure `{ text: null }` per omettere la sezione |

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

64 | `--remote-control-session-name-prefix <prefix>` | Prefisso per i nomi di sessione generati automaticamente quando non è impostato un nome esplicito. Per impostazione predefinita, il nome host della macchina, producendo nomi come `myhost-graceful-unicorn`. Impostare `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` per lo stesso effetto. |64 | `--remote-control-session-name-prefix <prefix>` | Prefisso per i nomi di sessione generati automaticamente quando non è impostato un nome esplicito. Per impostazione predefinita, il nome host della macchina, producendo nomi come `myhost-graceful-unicorn`. Impostare `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` per lo stesso effetto. |

65 | `-c`, `--continue` | Ripristina la sessione che l'ultimo server in questa directory ha avviato, invece di crearne una nuova. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--session-id`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |65 | `-c`, `--continue` | Ripristina la sessione che l'ultimo server in questa directory ha avviato, invece di crearne una nuova. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--session-id`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |

66 | `--session-id <id>` | Ripristina una sessione in base al suo ID. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--continue`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |66 | `--session-id <id>` | Ripristina una sessione in base al suo ID. Vedere [Riprendere le sessioni dopo l'arresto del server](#resume-sessions-after-stopping-the-server). Non può essere combinato con `--continue`, `--spawn`, `--capacity` o `--create-session-in-dir`. Richiede Claude Code v2.1.200 o successivo. |

67 | `--spawn <mode>` | Come il server crea le sessioni.<br />• `same-dir` (predefinito): tutte le sessioni condividono la directory di lavoro corrente, quindi possono entrare in conflitto se modificano gli stessi file.<br />• `worktree`: ogni sessione su richiesta ottiene il proprio [git worktree](/docs/it/worktrees). Richiede un repository git.<br />• `session`: modalità a sessione singola. Serve esattamente una sessione e rifiuta connessioni aggiuntive. Impostato solo all'avvio.<br />Premere `w` durante l'esecuzione per alternare tra `same-dir` e `worktree`. |67 | `--spawn <mode>` | Come il server crea le sessioni.<br />• `same-dir` (predefinito): tutte le sessioni condividono la directory di lavoro corrente, quindi possono entrare in conflitto se modificano gli stessi file.<br />• `worktree`: ogni sessione su richiesta ottiene il proprio [git worktree](/docs/it/worktrees). Richiede un repository git o un [hook `WorktreeCreate`](/docs/it/hooks#worktreecreate).<br />• `session`: modalità a sessione singola. Serve esattamente una sessione e rifiuta connessioni aggiuntive. Impostato solo all'avvio.<br />Premi `w` durante l'esecuzione per alternare tra `same-dir` e `worktree`. |

68 | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |68 | `--capacity <N>` | Numero massimo di sessioni simultanee. Il valore predefinito è 32. Non può essere utilizzato con `--spawn=session`. |

69 | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa `--no-create-session-in-dir` per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |69 | `--[no-]create-session-in-dir` | Pre-crea una sessione nella directory corrente quando il server si avvia, in modo da avere un posto dove digitare immediatamente. In modalità `worktree` questa sessione rimane nella directory corrente mentre le sessioni su richiesta ottengono worktree isolati. Attivato per impostazione predefinita. Se si passa `--no-create-session-in-dir` per iniziare senza nessuno, Claude Code archivia le sessioni del server quando lo si arresta, quindi non c'è nulla da [riprendere](#resume-sessions-after-stopping-the-server). |

70 | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](/docs/it/permission-modes) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide. |70 | `--permission-mode <mode>` | Imposta la [modalità di autorizzazione](/docs/it/permission-modes) iniziale per le sessioni del server, come `acceptEdits`. Accetta `manual` come alias per `default`; una modalità non riconosciuta arresta il server all'avvio ed elenca le modalità valide. |

202* Le [regole di negazione](/docs/it/permissions) esplicite vengono sempre rispettate202* Le [regole di negazione](/docs/it/permissions) esplicite vengono sempre rispettate

203* I comandi `rm` o `rmdir` che hanno come destinazione un [percorso critico](/docs/it/permission-modes#critical-paths) seguono comunque il normale flusso dei permessi203* I comandi `rm` o `rmdir` che hanno come destinazione un [percorso critico](/docs/it/permission-modes#critical-paths) seguono comunque il normale flusso dei permessi

204* Le [regole ask](/docs/it/permissions) limitate a un contenuto, come `Bash(git push *)`, forzano comunque una richiesta di conferma anche per i comandi in sandbox204* Le [regole ask](/docs/it/permissions) limitate a un contenuto, come `Bash(git push *)`, forzano comunque una richiesta di conferma anche per i comandi in sandbox

205* Una regola ask `Bash` semplice, o la forma equivalente `Bash(*)`, viene ignorata per i comandi eseguiti in sandbox; si applica comunque ai comandi che ricadono nel normale flusso dei permessi. Nel [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode), la regola non viene ignorata: chiede conferma anche per i comandi in sandbox, compresi quelli di sola lettura205* Una regola ask `Bash` semplice, o la forma equivalente `Bash(*)`, viene ignorata per i comandi eseguiti in sandbox; si applica comunque ai comandi eseguiti fuori dalla sandbox. Nel [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode), la regola non viene ignorata: chiede conferma anche per i comandi in sandbox, compresi quelli di sola lettura

206* I comandi dello [strumento Monitor](/docs/it/tools-reference#monitor-tool) non vengono approvati automaticamente, anche se vengono comunque eseguiti nella sandbox. Per evitare la richiesta di conferma, aggiungi una [regola allow](/docs/it/permissions#bash) che corrisponda al comando, come `Bash(npm run *)`206* I comandi dello [strumento Monitor](/docs/it/tools-reference#monitor-tool) non vengono approvati automaticamente, anche se vengono comunque eseguiti nella sandbox. Per evitare la richiesta di conferma, aggiungi una [regola allow](/docs/it/permissions#bash) che corrisponda al comando, come `Bash(npm run *)`

207 207 

208Alcuni comandi in sandbox seguono inoltre il normale [flusso dei permessi](/docs/it/permissions) invece di essere approvati automaticamente. Questo accade con comandi come `FOO=bar npm test`, in cui una variabile impostata davanti a un comando può cambiare quale programma viene eseguito, e con `make CC=clang` o `eval "ls"`. Sono quindi le tue regole allow e la tua modalità di permesso a decidere se vedi una richiesta di conferma, e il comando viene comunque eseguito all'interno della sandbox.

209 

210Per questi tre comandi, una [regola allow](/docs/it/permissions#bash) che corrisponde al comando elimina una richiesta di conferma ricorrente. Queste regole mostrano lo schema:

211 

212* `Bash(make *)` approva `make CC=clang`

213* `Bash(FOO=bar npm *)` approva `FOO=bar npm test`. Quando il comando inizia con un'assegnazione di variabile, includi l'assegnazione nella regola

214* `Bash(eval "ls")` approva `eval "ls"`. Una regola con caratteri jolly come `Bash(eval *)` non elimina questa richiesta di conferma, quindi scrivi una regola che corrisponda all'intero comando

215 

216Una regola allow che corrisponde a un comando approva anche un suo [nuovo tentativo fuori dalla sandbox](#the-unsandboxed-retry-escape-hatch), quindi il comando può essere eseguito fuori dalla sandbox senza richiesta di conferma.

217 

208<Info>218<Info>

209 La modalità auto-allow funziona indipendentemente dall'impostazione della modalità di permesso, con tre eccezioni: il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode), un comando in modalità auto che include [domini consentiti per comando](#per-command-allowed-domains-in-auto-mode) e la [revisione lato server da parte del classificatore](/docs/it/permission-modes#how-the-classifier-evaluates-actions) dei comandi in sandbox in modalità auto. Anche se non sei in modalità "accept edits", i comandi Bash in sandbox vengono eseguiti automaticamente quando auto-allow è abilitato. Ciò significa che i comandi Bash che modificano file entro i confini della sandbox vengono eseguiti senza chiedere, anche in modalità Manual, in cui gli strumenti di modifica dei file chiederebbero conferma.219 La modalità auto-allow funziona indipendentemente dall'impostazione della modalità di permesso, con tre eccezioni: il [plan mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode), un comando in modalità auto che include [domini consentiti per comando](#per-command-allowed-domains-in-auto-mode) e la [revisione lato server da parte del classificatore](/docs/it/permission-modes#how-the-classifier-evaluates-actions) dei comandi in sandbox in modalità auto. Anche se non sei in modalità "accept edits", i comandi Bash in sandbox vengono eseguiti automaticamente quando auto-allow è abilitato. Ciò significa che i comandi Bash che modificano file entro i confini della sandbox vengono eseguiti senza chiedere, anche in modalità Manual, in cui gli strumenti di modifica dei file chiederebbero conferma.

210 220 

191 Jitter191 Jitter

192</h3>192</h3>

193 193 

194Un'attività pianificata può essere eseguita in un orario diverso da quello indicato dalla sua pianificazione. Se le attività di ogni sessione venissero eseguite esattamente come pianificato, molte di esse chiamerebbero l'API nello stesso momento, quindi Claude Code sposta l'orario di esecuzione di ogni attività. Le attività ricorrenti vengono eseguite in ritardo, mentre le attività una tantum pianificate allo scoccare dell'ora o della mezz'ora vengono eseguite un po' in anticipo.194Un'attività pianificata può essere eseguita in un orario diverso da quello indicato dalla sua pianificazione. Se le attività di ogni sessione venissero eseguite esattamente come pianificato, molte di esse chiamerebbero l'API nello stesso momento, quindi Claude Code sposta l'orario di esecuzione di ogni attività. Le attività ricorrenti vengono eseguite in ritardo, tranne un'attività eseguita ogni cinque minuti, scritta `*/5 * * * *`. Le attività una tantum pianificate allo scoccare dell'ora o della mezz'ora vengono eseguite un po' in anticipo.

195 195 

196<h4 id="how-late-a-recurring-task-runs">196<h4 id="how-late-a-recurring-task-runs">

197 Quanto in ritardo viene eseguita un'attività ricorrente197 Quanto in ritardo viene eseguita un'attività ricorrente

198</h4>198</h4>

199 199 

200Quando crei un'attività ricorrente, Claude Code le assegna un ritardo fisso e lo aggiunge a ogni esecuzione. Il ritardo viene calcolato a partire dall'ID dell'attività, quindi la stessa attività viene eseguita ogni volta con lo stesso numero di minuti di ritardo, anche quando la sessione è inattiva e non c'è nient'altro in esecuzione.200A meno che non venga eseguita ogni cinque minuti, un'attività ricorrente avvia ogni esecuzione in ritardo fino alla metà dell'intervallo che la separa dall'esecuzione successiva, e al massimo di 30 minuti. La tua attività rientra in uno di questi tre casi:

201 201 

202Le attività eseguite più spesso ottengono ritardi più brevi, e 30 minuti è il ritardo massimo che un'attività può ottenere. Questi sono gli intervalli di ritardo per alcune pianificazioni comuni:202* **Esecuzioni a intervalli regolari**: un'attività con intervalli uguali, ad esempio ogni ora, ogni giorno o ogni 10 minuti, viene eseguita ogni volta con lo stesso numero di minuti di ritardo, anche quando la sessione è inattiva.

203* **Esecuzioni a intervalli irregolari**: un'attività con intervalli diversi, ad esempio una pianificata per `:00` e `:15` ogni ora, può essere eseguita con un numero di minuti di ritardo diverso in ciascuna esecuzione.

204* **Ogni cinque minuti**: un'attività scritta `*/5 * * * *` non viene ritardata. Un'esecuzione esattamente cinque minuti dopo l'ultima partirebbe dopo la scadenza di una [cache del prompt](/docs/it/prompt-caching#which-ttl-each-request-gets) di cinque minuti, quindi ogni esecuzione parte 15 secondi prima.

203 205 

204| L'attività viene eseguita | Il ritardo è compreso tra |206Trova la tua pianificazione nella prima colonna di questa tabella per vedere quando parte ciascuna delle sue esecuzioni.

207 

208| Pianificazione | Quando parte ogni esecuzione |

205| :- | :- |209| :- | :- |

206| Ogni 10 minuti | 0 e 5 minuti |210| Ogni 5 minuti, scritta `*/5 * * * *`, che è ciò che crea `/loop 5m` | 4 minuti e 45 secondi dopo l'esecuzione precedente |

207| Ogni 30 minuti | 0 e 15 minuti |211| Ogni 10 minuti | Da 0 a 5 minuti in ritardo |

208| Ogni ora, o meno spesso, ad esempio ogni giorno | 0 e 30 minuti |212| Ogni 30 minuti | Da 0 a 15 minuti in ritardo |

213| Ogni ora, o meno spesso, ad esempio ogni giorno | Da 0 a 30 minuti in ritardo |

209 214 

210Ad esempio, `7,37 * * * *` pianifica un'attività per `:07` e `:37`, che distano 30 minuti, quindi il suo ritardo è compreso tra 0 e 15 minuti. Se il ritardo di questa attività è di 14 minuti, viene eseguita a `:21` e `:51` ogni ora. Cambiare la pianificazione a un minuto diverso sposta l'orario di esecuzione, e il ritardo viene comunque aggiunto.215Ad esempio, `7,37 * * * *` pianifica un'attività per `:07` e `:37`, che distano 30 minuti, quindi il suo ritardo è compreso tra 0 e 15 minuti. Se il ritardo di questa attività è di 14 minuti, viene eseguita a `:21` e `:51` ogni ora. Cambiare la pianificazione a un minuto diverso sposta l'orario di esecuzione, e il ritardo viene comunque aggiunto.

211 216 

1931 1931 

1932* **Scope**: [`Any file`](#scopes)1932* **Scope**: [`Any file`](#scopes)

1933* **Type**: Boolean1933* **Type**: Boolean

1934 * `true`: Claude Code esegue i comandi Bash in sandbox senza una richiesta di permesso, soggetto alle regole `deny` e alle regole `ask` con ambito di contenuto; `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` disattiva l'auto-consentimento1934 * `true`: Claude Code esegue i comandi Bash in sandbox senza una richiesta di permesso, tranne nei casi descritti in [Auto-allow mode](/docs/it/sandboxing#auto-allow-mode); `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` disattiva l'auto-consentimento

1935 * `false`: i comandi in sandbox seguono il flusso di permessi regolare, quindi decidono le tue regole allow e la modalità di permesso. La scheda **Mode** di `/sandbox` chiama questa modalità di permessi regolari1935 * `false`: i comandi in sandbox seguono il flusso di permessi regolare, quindi decidono le tue regole allow e la modalità di permesso. La scheda **Mode** di `/sandbox` chiama questa modalità di permessi regolari

1936* **Default**: `true`1936* **Default**: `true`

1937 1937 

1946}1946}

1947```1947```

1948 1948 

1949Vedi [Sandbox modes](/docs/it/sandboxing#sandbox-modes) per ciò per cui la modalità auto-consentimento chiede ancora conferma e come si comporta in plan mode.1949Vedi [Auto-allow mode](/docs/it/sandboxing#auto-allow-mode) per ciò per cui la modalità auto-consentimento chiede ancora conferma e come si comporta in plan mode.

1950 1950 

1951<h3 id="sandbox-excludedcommands">1951<h3 id="sandbox-excludedcommands">

1952 `sandbox.excludedCommands`1952 `sandbox.excludedCommands`

1308Al di fuori del [rendering a schermo intero](/docs/it/fullscreen), Claude Code mostra le notifiche sulla stessa riga della tua riga di stato. Nel rendering a schermo intero, Claude Code assegna alle notifiche una riga propria.1308Al di fuori del [rendering a schermo intero](/docs/it/fullscreen), Claude Code mostra le notifiche sulla stessa riga della tua riga di stato. Nel rendering a schermo intero, Claude Code assegna alle notifiche una riga propria.

1309 1309 

1310* Le notifiche di sistema come errori del server MCP e aggiornamenti automatici vengono visualizzate sul lato destro della riga. Anche le notifiche transitorie come l'avviso di contesto basso si alternano in quest'area.1310* Le notifiche di sistema come errori del server MCP e aggiornamenti automatici vengono visualizzate sul lato destro della riga. Anche le notifiche transitorie come l'avviso di contesto basso si alternano in quest'area.

1311* L'abilitazione della modalità verbose aggiunge un contatore di token a quest'area1311* L'abilitazione della modalità verbose aggiunge un contatore di token a quest'area, che mostra la dimensione del tuo contesto come riportata dall'ultima risposta API, non il [conteggio per turno accanto allo spinner](/docs/it/costs#read-the-token-count-beside-the-spinner)

1312* Su terminali stretti, queste notifiche potrebbero troncare l'output della tua riga di stato1312* Su terminali stretti, queste notifiche potrebbero troncare l'output della tua riga di stato

431 431 

432Riprendi un'esecuzione in pausa da `/workflows` selezionandola e premendo `p`. Per un'esecuzione che hai interrotto, chiedi a Claude di riavviare il workflow con lo stesso script. Se gli agenti dell'esecuzione interrotta non sono ancora usciti, Claude Code rifiuta il riavvio finché non lo fanno, in modo che una seconda copia di quegli agenti non possa essere eseguita insieme a loro.432Riprendi un'esecuzione in pausa da `/workflows` selezionandola e premendo `p`. Per un'esecuzione che hai interrotto, chiedi a Claude di riavviare il workflow con lo stesso script. Se gli agenti dell'esecuzione interrotta non sono ancora usciti, Claude Code rifiuta il riavvio finché non lo fanno, in modo che una seconda copia di quegli agenti non possa essere eseguita insieme a loro.

433 433 

434<h4 id="which-agents-run-again">

435 Quali agenti vengono eseguiti di nuovo

436</h4>

437 

434Claude Code riproduce l'esecuzione nell'ordine in cui gli agenti sono stati avviati, e ogni agente restituisce il suo risultato salvato oppure viene eseguito di nuovo:438Claude Code riproduce l'esecuzione nell'ordine in cui gli agenti sono stati avviati, e ogni agente restituisce il suo risultato salvato oppure viene eseguito di nuovo:

435 439 

436* **Completato**: restituisce il suo risultato salvato. Il primo agente il cui prompt differisce dall'esecuzione precedente, perché hai modificato lo script o un agente precedente ha restituito qualcosa di diverso, viene eseguito di nuovo, così come ogni agente dopo di esso, anche quelli che erano completati.440* **Completato**: restituisce il suo risultato salvato. Il primo agente il cui prompt differisce dall'esecuzione precedente, perché hai modificato lo script o un agente precedente ha restituito qualcosa di diverso, viene eseguito di nuovo, così come ogni agente dopo di esso, anche quelli che erano completati.

439 443 

440Quest'ultimo caso significa che un errore nel mezzo di un fan-out riesegue il lavoro che era già terminato. Se uno script avvia A, B, C e D in quell'ordine e B non riesce, il riavvio restituisce A dalla cache ed esegue di nuovo B, C e D.444Quest'ultimo caso significa che un errore nel mezzo di un fan-out riesegue il lavoro che era già terminato. Se uno script avvia A, B, C e D in quell'ordine e B non riesce, il riavvio restituisce A dalla cache ed esegue di nuovo B, C e D.

441 445 

446Se modifichi uno script che avviava A, B, C e D in modo che avvii A, C, B e D, il secondo agente ad avviarsi è ora C, mentre l'esecuzione precedente avviava B. Il riavvio restituisce A dalla cache ed esegue di nuovo C, B e D.

447 

448<h4 id="resume-after-you-leave-the-session">

449 Riprendere dopo aver lasciato la sessione

450</h4>

451 

442Puoi riprendere un'esecuzione all'interno della stessa sessione di Claude Code. Quello che accade a un workflow in esecuzione quando lasci la sessione dipende da come la lasci:452Puoi riprendere un'esecuzione all'interno della stessa sessione di Claude Code. Quello che accade a un workflow in esecuzione quando lasci la sessione dipende da come la lasci:

443 453 

444* Se [metti la sessione in background](/docs/it/agent-view#what-carries-over-when-you-background), Claude Code riproduce l'esecuzione allo stesso modo nella sessione in background e la continua.454* Se [metti la sessione in background](/docs/it/agent-view#what-carries-over-when-you-background), Claude Code riproduce l'esecuzione allo stesso modo nella sessione in background e la continua.

129and report the results.129and report the results.

130```130```

131 131 

132Ogni subagent ottiene un worktree temporaneo che Claude Code rimuove automaticamente quando il subagent finisce senza modifiche; un worktree con modifiche rimane su disco fino a quando la [scansione periodica di seguito](#clean-up-subagent-and-background-session-worktrees) può rimuoverlo senza perdere lavoro.132Ogni subagent ottiene un worktree temporaneo che Claude Code rimuove automaticamente quando il subagent finisce senza modifiche; un worktree con modifiche rimane su disco fino a quando la [scansione periodica di seguito](#clean-up-subagent-and-background-session-worktrees) può rimuoverlo senza perdere lavoro. Per un worktree creato dal tuo [hook WorktreeCreate](/docs/it/hooks#worktreecreate), consulta invece [WorktreeRemove](/docs/it/hooks#worktreeremove).

133 133 

134I worktree dei subagent utilizzano lo stesso [branch di base](#choose-the-base-branch) di `--worktree`, quindi si diramano dal branch predefinito del vostro repository a meno che `worktree.baseRef` non sia impostato su `"head"`.134I worktree dei subagent utilizzano lo stesso [branch di base](#choose-the-base-branch) di `--worktree`, quindi si diramano dal branch predefinito del vostro repository a meno che `worktree.baseRef` non sia impostato su `"head"`.

135 135