SpyBara
Go Premium

Documentation 2026-06-22 23:59 UTC to 2026-06-23 22:00 UTC

45 files changed +2,102 −102. View all changes and history on the product overview
2026
Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51
Details

86`settingSources` copre le impostazioni utente, progetto e locali. Alcuni input vengono letti indipendentemente dal suo valore:86`settingSources` copre le impostazioni utente, progetto e locali. Alcuni input vengono letti indipendentemente dal suo valore:

87 87 

88| Input | Comportamento | Per disabilitare |88| Input | Comportamento | Per disabilitare |

89| :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- |89| :-------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

90| Impostazioni dei criteri gestiti | Sempre caricate quando presenti sull'host | Rimuovi il file delle impostazioni gestite |90| Impostazioni dei criteri gestiti | Sempre caricate quando presenti sull'host | Rimuovi il file delle impostazioni gestite |

91| Configurazione globale `~/.claude.json` | Sempre letta | Riposiziona con `CLAUDE_CONFIG_DIR` in `env` |91| Configurazione globale `~/.claude.json` | Sempre letta | Riposiziona con `CLAUDE_CONFIG_DIR` in `env` |

92| Memoria automatica in `~/.claude/projects/<project>/memory/` | Caricata per impostazione predefinita nel prompt di sistema | Imposta `autoMemoryEnabled: false` nelle impostazioni, o `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` in `env` |92| Memoria automatica in `~/.claude/projects/<project>/memory/` | Caricata per impostazione predefinita nel prompt di sistema | Imposta `autoMemoryEnabled: false` nelle impostazioni, o `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` in `env` |

93| [Connettori MCP da claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) | Caricati quando il metodo di autenticazione attivo è un abbonamento a claude.ai. Passare `mcpServers: {}` non li sopprime | Imposta `strictMcpConfig: true`, o `ENABLE_CLAUDEAI_MCP_SERVERS=false` in `env` |93| [Connettori MCP da claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) | Caricati quando il metodo di autenticazione attivo è un abbonamento a claude.ai. Passare `mcpServers: {}` non li sopprime | Imposta `strictMcpConfig: true`, [`disableClaudeAiConnectors: true`](/it/mcp#disable-claude-ai-connectors) nelle impostazioni, o `ENABLE_CLAUDEAI_MCP_SERVERS=false` in `env` |

94 94 

95<Warning>95<Warning>

96 Non fare affidamento sulle opzioni predefinite di `query()` per l'isolamento multi-tenant. Poiché gli input di cui sopra vengono letti indipendentemente da `settingSources`, un processo SDK può raccogliere la configurazione a livello di host e la memoria per directory. Per le distribuzioni multi-tenant, esegui ogni tenant nel suo proprio filesystem e imposta `settingSources: []` più `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` in `env`. Vedi [Distribuzione sicura](/it/agent-sdk/secure-deployment).96 Non fare affidamento sulle opzioni predefinite di `query()` per l'isolamento multi-tenant. Poiché gli input di cui sopra vengono letti indipendentemente da `settingSources`, un processo SDK può raccogliere la configurazione a livello di host e la memoria per directory. Per le distribuzioni multi-tenant, esegui ogni tenant nel suo proprio filesystem e imposta `settingSources: []` più `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` in `env`. Vedi [Distribuzione sicura](/it/agent-sdk/secure-deployment).

Details

958```958```

959 959 

960* `API_TIMEOUT_MS`: timeout per richiesta sul client Anthropic, in millisecondi. Predefinito `600000`. Si applica al ciclo principale e a tutti i subagenti.960* `API_TIMEOUT_MS`: timeout per richiesta sul client Anthropic, in millisecondi. Predefinito `600000`. Si applica al ciclo principale e a tutti i subagenti.

961* `CLAUDE_CODE_MAX_RETRIES`: numero massimo di tentativi API. Predefinito `10`. Ogni tentativo ottiene la propria finestra `API_TIMEOUT_MS`, quindi il tempo di parete nel caso peggiore è approssimativamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` più backoff.961* `CLAUDE_CODE_MAX_RETRIES`: numero massimo di tentativi API. Predefinito `10`, limitato a `15`. Ogni tentativo ottiene la propria finestra `API_TIMEOUT_MS`, quindi il tempo di parete nel caso peggiore è approssimativamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` più backoff. Per esecuzioni incustodite che devono attendere interruzioni più lunghe, imposta `CLAUDE_CODE_RETRY_WATCHDOG=1` per ritentare gli errori di capacità indefinitamente.

962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog di blocco per i subagenti lanciati con `run_in_background`. Predefinito `600000`. Si ripristina su ogni evento di flusso; in caso di blocco interrompe il subagente, contrassegna l'attività come non riuscita e presenta l'errore al genitore con qualsiasi risultato parziale. Non si applica ai subagenti sincroni.962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog di blocco per i subagenti lanciati con `run_in_background`. Predefinito `600000`. Si ripristina su ogni evento di flusso; in caso di blocco interrompe il subagente, contrassegna l'attività come non riuscita e presenta l'errore al genitore con qualsiasi risultato parziale. Non si applica ai subagenti sincroni.

963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: interrompe la richiesta quando le intestazioni sono arrivate ma il corpo della risposta smette di trasmettere. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` non è impostato, l'impostazione predefinita è controllata dal server sull'API Anthropic diretta e disattivata su altri provider. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` predefinito a `300000` e viene bloccato a quel minimo. La richiesta interrotta passa attraverso il percorso di ripetizione normale.963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: interrompe la richiesta quando le intestazioni sono arrivate ma il corpo della risposta smette di trasmettere. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` non è impostato, l'impostazione predefinita è controllata dal server sull'API Anthropic diretta e disattivata su altri provider. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` predefinito a `300000` e viene bloccato a quel minimo. La richiesta interrotta passa attraverso il percorso di ripetizione normale.

964 964 

Details

196Nell'SDK Python, questi nomi di campo utilizzano camelCase per corrispondere al formato wire. Vedi il riferimento [`AgentDefinition`](/it/agent-sdk/python#agentdefinition) per i dettagli.196Nell'SDK Python, questi nomi di campo utilizzano camelCase per corrispondere al formato wire. Vedi il riferimento [`AgentDefinition`](/it/agent-sdk/python#agentdefinition) per i dettagli.

197 197 

198<Note>198<Note>

199 {/* min-version: 2.1.172 */}A partire da Claude Code v2.1.172, i subagenti possono generare i propri subagenti. Un subagente di background cinque livelli al di sotto dell'agente principale non può generare ulteriori subagenti; i subagenti in primo piano possono generare a qualsiasi profondità. Per impedire a un subagente di generare altri, ometti `Agent` dal suo array `tools` o aggiungilo a `disallowedTools`. Vedi [subagenti annidati](/it/sub-agents#spawn-nested-subagents) per le regole di profondità complete.199 {/* min-version: 2.1.172 */}A partire da Claude Code v2.1.172, i subagenti possono generare i propri subagenti. Un subagente cinque livelli al di sotto dell'agente principale non può generare ulteriori subagenti, indipendentemente dal fatto che venga eseguito in primo piano o in background. Per impedire a un subagente di generare altri, ometti `Agent` dal suo array `tools` o aggiungilo a `disallowedTools`. Vedi [subagenti annidati](/it/sub-agents#spawn-nested-subagents) per le regole di profondità complete.

200</Note>200</Note>

201 201 

202<h3 id="filesystem-based-definition-alternative">202<h3 id="filesystem-based-definition-alternative">

Details

551```551```

552 552 

553* `API_TIMEOUT_MS`: timeout per richiesta sul client Anthropic, in millisecondi. Predefinito `600000`. Si applica al loop principale e a tutti i subagenti.553* `API_TIMEOUT_MS`: timeout per richiesta sul client Anthropic, in millisecondi. Predefinito `600000`. Si applica al loop principale e a tutti i subagenti.

554* `CLAUDE_CODE_MAX_RETRIES`: numero massimo di tentativi API. Predefinito `10`. Ogni tentativo ottiene la propria finestra `API_TIMEOUT_MS`, quindi il tempo wall case peggiore è approssimativamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` più backoff.554* `CLAUDE_CODE_MAX_RETRIES`: numero massimo di tentativi API. Predefinito `10`, limitato a `15`. Ogni tentativo ottiene la propria finestra `API_TIMEOUT_MS`, quindi il tempo wall case peggiore è approssimativamente `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` più backoff. Per esecuzioni incustodite che devono attendere attraverso interruzioni più lunghe, imposta `CLAUDE_CODE_RETRY_WATCHDOG=1` per ritentare gli errori di capacità indefinitamente.

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog di blocco per i subagenti lanciati con `run_in_background`. Predefinito `600000`. Si ripristina su ogni evento di stream; al blocco interrompe il subagente, contrassegna l'attività come fallita e presenta l'errore al genitore con qualsiasi risultato parziale. Non si applica ai subagenti sincroni.555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`: watchdog di blocco per i subagenti lanciati con `run_in_background`. Predefinito `600000`. Si ripristina su ogni evento di stream; al blocco interrompe il subagente, contrassegna l'attività come fallita e presenta l'errore al genitore con qualsiasi risultato parziale. Non si applica ai subagenti sincroni.

556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: interrompe la richiesta quando le intestazioni sono arrivate ma il corpo della risposta smette di trasmettere. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` non è impostato, il predefinito è controllato dal server sull'API Anthropic diretto e disattivato su altri provider. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` predefinito a `300000` ed è limitato a quel minimo. La richiesta interrotta passa attraverso il percorso di tentativo normale.556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` con `CLAUDE_STREAM_IDLE_TIMEOUT_MS`: interrompe la richiesta quando le intestazioni sono arrivate ma il corpo della risposta smette di trasmettere. Quando `CLAUDE_ENABLE_STREAM_WATCHDOG` non è impostato, il predefinito è controllato dal server sull'API Anthropic diretto e disattivato su altri provider. `CLAUDE_STREAM_IDLE_TIMEOUT_MS` predefinito a `300000` ed è limitato a quel minimo. La richiesta interrotta passa attraverso il percorso di tentativo normale.

557 557 


1418```1418```

1419 1419 

1420| `kind` | Significato |1420| `kind` | Significato |

1421| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1421| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1422| `human` | Input diretto dall'utente finale. Sui messaggi utente, un `origin` assente significa anche input umano. |1422| `human` | Input diretto dall'utente finale. Sui messaggi utente, un `origin` assente significa anche input umano. |

1423| `channel` | Messaggio in arrivo su un [canale](/it/channels). `server` è il nome del server MCP di origine. |1423| `channel` | Messaggio in arrivo su un [canale](/it/channels). `server` è il nome del server MCP di origine. |

1424| `peer` | Riservato per messaggi da un'altra sessione di agente. `from` è l'indirizzo del mittente e `name` è il nome visualizzato del mittente quando disponibile. `senderTaskId` è l'ID dell'attività del subagente in-process in background che ha inviato il messaggio; assente per i peer tra sessioni. L'Agent SDK non emette questa origine; trattala come un'origine sconosciuta. |1424| `peer` | Messaggio da un altro agente. Per un [collega](/it/agent-teams) in-process che invia a `main` tramite `SendMessage`, `from` è il nome del collega e `senderTaskId` è il suo ID attività. Per un peer tra sessioni come un altro processo Claude Code locale, `from` è l'indirizzo del mittente e `senderTaskId` è assente. Il campo `name` è riservato. |

1425| `task-notification` | Turno sintetico iniettato dopo il completamento di un'attività in background. Vedi [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |1425| `task-notification` | Turno sintetico iniettato dopo il completamento di un'attività in background. Vedi [`SDKTaskNotificationMessage`](#sdktasknotificationmessage). |

1426| `coordinator` | Messaggio da un coordinatore di team in un [team di agenti](/it/agent-teams). |1426| `coordinator` | Messaggio da un coordinatore di team in un [team di agenti](/it/agent-teams). |

1427| `auto-continuation` | Turno sintetico iniettato quando la sessione continua senza input utente fresco, come un risultato di comando che attiva un prompt di follow-up. |1427| `auto-continuation` | Turno sintetico iniettato quando la sessione continua senza input utente fresco, come un risultato di comando che attiva un prompt di follow-up. |


3285 `CallToolResult`3285 `CallToolResult`

3286</h3>3286</h3>

3287 3287 

3288Tipo di risultato del tool MCP (da `@modelcontextprotocol/sdk/types.js`). `structuredContent` è un oggetto JSON che può essere restituito insieme a `content`, inclusi blocchi di immagini e audio. Vedi [Restituisci dati strutturati](/it/agent-sdk/custom-tools#return-structured-data).3288Tipo di risultato del tool MCP (da `@modelcontextprotocol/sdk/types.js`). `structuredContent` è un oggetto JSON che può essere restituito insieme a `content`, inclusi blocchi di immagini. Vedi [Restituisci dati strutturati](/it/agent-sdk/custom-tools#return-structured-data).

3289 3289 

3290```typescript theme={null}3290```typescript theme={null}

3291type CallToolResult = {3291type CallToolResult = {


3654 status: "allowed" | "allowed_warning" | "rejected";3654 status: "allowed" | "allowed_warning" | "rejected";

3655 resetsAt?: number;3655 resetsAt?: number;

3656 utilization?: number;3656 utilization?: number;

3657 errorCode?: "credits_required";

3658 canUserPurchaseCredits?: boolean;

3659 hasChargeableSavedPaymentMethod?: boolean;

3657 };3660 };

3658 uuid: UUID;3661 uuid: UUID;

3659 session_id: string;3662 session_id: string;

3660};3663};

3661```3664```

3662 3665 

3666{/* min-version: 2.1.181 */}Quando `errorCode` è `"credits_required"`, il rifiuto proviene da un abbonamento claude.ai il cui utilizzo incluso è esaurito, e la sessione non può continuare fino a quando l'utente non acquista crediti di utilizzo. `canUserPurchaseCredits` indica se l'utente autenticato può acquistare crediti per l'account, e `hasChargeableSavedPaymentMethod` indica se un metodo di pagamento salvato è registrato. Tutti e tre i campi sono assenti negli eventi di limite di velocità che non sono rifiuti con crediti richiesti. Richiede Claude Code v2.1.181 o successivo.

3667 

3663<h3 id="sdklocalcommandoutputmessage">3668<h3 id="sdklocalcommandoutputmessage">

3664 `SDKLocalCommandOutputMessage`3669 `SDKLocalCommandOutputMessage`

3665</h3>3670</h3>

agent-teams.md +21 −10

Details

90 90 

91Da lì, Claude popola un [elenco di attività condiviso](/it/interactive-mode#task-list), genera compagni di team per ogni prospettiva, li fa esplorare il problema, e sintetizza i risultati al termine.91Da lì, Claude popola un [elenco di attività condiviso](/it/interactive-mode#task-list), genera compagni di team per ogni prospettiva, li fa esplorare il problema, e sintetizza i risultati al termine.

92 92 

93Il terminale del lead elenca tutti i compagni di team e su cosa stanno lavorando. Utilizzate Shift+Down per scorrere i compagni di team e messaggiarli direttamente. Dopo l'ultimo compagno di team, Shift+Down torna al lead.93Il terminale del lead elenca i compagni di team nel pannello dell'agente sotto l'input del prompt. Dal pannello:

94 

95* **Frecce su e giù**: selezionare un compagno di team

96* **Invio**: aprire la trascrizione del compagno di team selezionato e messaggiargli direttamente

97* **Escape**: interrompere il turno corrente del compagno di team selezionato

98 

99{/* min-version: 2.1.181 */}A partire dalla v2.1.181, la riga di un compagno di team inattivo si nasconde dopo 30 secondi e riappare al suo turno successivo. Il compagno di team rimane in esecuzione e indirizzabile mentre nascosto.

94 100 

95Se desiderate che ogni compagno di team sia in un riquadro diviso proprio, consultate [Scegliere una modalità di visualizzazione](#choose-a-display-mode).101Se desiderate che ogni compagno di team sia in un riquadro diviso proprio, consultate [Scegliere una modalità di visualizzazione](#choose-a-display-mode).

96 102 


106 112 

107I team di agenti supportano due modalità di visualizzazione:113I team di agenti supportano due modalità di visualizzazione:

108 114 

109* **In-process**: tutti i compagni di team vengono eseguiti all'interno del vostro terminale principale. Utilizzate Shift+Down per scorrere i compagni di team e digitate per messaggiarli direttamente. Funziona in qualsiasi terminale, nessuna configurazione extra richiesta.115* **In-process**: tutti i compagni di team vengono eseguiti all'interno del vostro terminale principale. Utilizzate i tasti freccia su e giù nel pannello dell'agente per selezionare un compagno di team, quindi premete Invio per visualizzarlo e digitate per messaggiarlo direttamente. Funziona in qualsiasi terminale, nessuna configurazione extra richiesta.

110* **Split panes**: ogni compagno di team ottiene il proprio riquadro. Potete vedere l'output di tutti contemporaneamente e fare clic su un riquadro per interagire direttamente. Richiede tmux o iTerm2.116* **Split panes**: ogni compagno di team ottiene il proprio riquadro. Potete vedere l'output di tutti contemporaneamente e fare clic su un riquadro per interagire direttamente. Richiede tmux o iTerm2.

111 117 

112<Note>118<Note>

113 `tmux` ha limitazioni note su certi sistemi operativi e tradizionalmente funziona meglio su macOS. Utilizzare `tmux -CC` in iTerm2 è il punto di ingresso suggerito in `tmux`.119 `tmux` ha limitazioni note su certi sistemi operativi e tradizionalmente funziona meglio su macOS. Utilizzare `tmux -CC` in iTerm2 è il punto di ingresso suggerito in `tmux`.

114</Note>120</Note>

115 121 

116L'impostazione predefinita è `"auto"`, che utilizza split panes se state già eseguendo all'interno di una sessione tmux o il vostro terminale è iTerm2, e in-process altrimenti. L'impostazione `"tmux"` abilita la modalità split-pane e rileva automaticamente se utilizzare tmux o iTerm2 in base al vostro terminale. Per sovrascrivere, impostate [`teammateMode`](/it/settings#available-settings) in `~/.claude/settings.json`:122L'impostazione predefinita è `"in-process"`. Prima della versione 2.1.179 l'impostazione predefinita era `"auto"`, quindi le sessioni aggiornate che in precedenza aprivano split panes ora rimangono in un terminale a meno che non impostiate esplicitamente la modalità. Impostate `"auto"` per abilitare split panes quando state già eseguendo all'interno di una sessione tmux o il vostro terminale è iTerm2, altrimenti ricadete in in-process. L'impostazione `"tmux"` abilita la modalità split-pane e rileva automaticamente se utilizzare tmux o iTerm2 in base al vostro terminale.

123 

124{/* min-version: 2.1.186 */}A partire dalla versione 2.1.186, impostate `"iterm2"` per utilizzare esplicitamente i split panes nativi di iTerm2. Questa modalità richiede la [CLI `it2`](https://github.com/mkusaka/it2) e mostra un errore con il comando di installazione se `it2` è mancante. Il prompt di configurazione che offre di installare `it2` o passare a tmux appare sotto `"auto"` o `"tmux"` quando il vostro terminale è iTerm2 e tmux è disponibile come fallback.

125 

126Per sovrascrivere l'impostazione predefinita, impostate [`teammateMode`](/it/settings#available-settings) in `~/.claude/settings.json`:

117 127 

118```json theme={null}128```json theme={null}

119{129{

120 "teammateMode": "in-process"130 "teammateMode": "auto"

121}131}

122```132```

123 133 

124Per forzare la modalità in-process per una singola sessione, passatela come flag:134Per impostare la modalità per una singola sessione, passatela come flag:

125 135 

126```bash theme={null}136```bash theme={null}

127claude --teammate-mode in-process137claude --teammate-mode auto

128```138```

129 139 

130La modalità split-pane richiede [tmux](https://github.com/tmux/tmux/wiki) o iTerm2 con la CLI [`it2`](https://github.com/mkusaka/it2). Per installare manualmente:140La modalità split-pane richiede [tmux](https://github.com/tmux/tmux/wiki) o iTerm2 con la CLI [`it2`](https://github.com/mkusaka/it2). Per installare manualmente:


166 176 

167Ogni compagno di team è una sessione Claude Code completa e indipendente. Potete messaggiare qualsiasi compagno di team direttamente per fornire istruzioni aggiuntive, fare domande di follow-up o reindirizzare il loro approccio.177Ogni compagno di team è una sessione Claude Code completa e indipendente. Potete messaggiare qualsiasi compagno di team direttamente per fornire istruzioni aggiuntive, fare domande di follow-up o reindirizzare il loro approccio.

168 178 

169* **Modalità in-process**: utilizzate Shift+Down per scorrere i compagni di team, quindi digitate per inviare loro un messaggio. Premete Invio per visualizzare la sessione di un compagno di team, quindi Escape per interrompere il loro turno attuale. Premete Ctrl+T per attivare/disattivare l'elenco delle attività.179* **Modalità in-process**: utilizzate i tasti freccia su e giù nel pannello dell'agente per selezionare un compagno di team, quindi premete Invio per visualizzare la sua sessione e digitate per inviargli un messaggio. Premete `x` su un compagno di team selezionato per fermarlo. Premete Ctrl+T per attivare/disattivare l'elenco delle attività.

170* **Modalità split-pane**: fate clic nel riquadro di un compagno di team per interagire direttamente con la sua sessione. Ogni compagno di team ha una visualizzazione completa del proprio terminale.180* **Modalità split-pane**: fate clic nel riquadro di un compagno di team per interagire direttamente con la sua sessione. Ogni compagno di team ha una visualizzazione completa del proprio terminale.

171 181 

172<h3 id="assign-and-claim-tasks">182<h3 id="assign-and-claim-tasks">


422 432 

423Se i compagni di team non appaiono dopo aver chiesto a Claude di creare un team:433Se i compagni di team non appaiono dopo aver chiesto a Claude di creare un team:

424 434 

425* In modalità in-process, i compagni di team potrebbero già essere in esecuzione ma non visibili. Premete Shift+Down per scorrere i compagni di team attivi.435* In modalità in-process, i compagni di team appaiono nel pannello agente sotto l'input del prompt. Utilizzate i tasti freccia su e giù per selezionarne uno, quindi premete Invio per visualizzarlo.

426* Controllate che il compito che avete dato a Claude fosse abbastanza complesso da giustificare un team. Claude decide se generare compagni di team in base al compito.436* Una riga di compagno di team che è scomparsa dopo essere rimasta inattiva è stata nascosta, non interrotta. Le righe inattive si nascondono dopo 30 secondi e riappaiono al turno successivo del compagno di team. Inviate un messaggio al compagno di team per nome per riportarlo indietro.

437* Controllate che il compito che avete dato a Claude fosse abbastanza complesso da giustificare un team. Claude decide se creare compagni di team in base al compito.

427* Se avete esplicitamente richiesto split panes, assicuratevi che tmux sia installato e disponibile nel vostro PATH:438* Se avete esplicitamente richiesto split panes, assicuratevi che tmux sia installato e disponibile nel vostro PATH:

428 ```bash theme={null}439 ```bash theme={null}

429 which tmux440 which tmux


440 I compagni di team si fermano su errori451 I compagni di team si fermano su errori

441</h3>452</h3>

442 453 

443I compagni di team possono fermarsi dopo aver incontrato errori invece di recuperare. Controllate il loro output utilizzando Shift+Down in modalità in-process o facendo clic sul riquadro in modalità split, quindi:454I compagni di team possono fermarsi dopo aver incontrato errori invece di recuperare. Controllate il loro output selezionando il compagno di team nel pannello agente e premendo Invio in modalità in-process, o facendo clic sul riquadro in modalità split, quindi:

444 455 

445* Date loro istruzioni aggiuntive direttamente456* Date loro istruzioni aggiuntive direttamente

446* Generate un compagno di team sostitutivo per continuare il lavoro457* Generate un compagno di team sostitutivo per continuare il lavoro

agent-view.md +32 −3

Details

281| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |281| `#<number>` o un URL di pull request | Se una sessione sta già lavorando su quel PR, selezionala invece di inviare |

282| `Shift+Enter` | Invia e collegati immediatamente alla nuova sessione |282| `Shift+Enter` | Invia e collegati immediatamente alla nuova sessione |

283 283 

284Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato: `/exit` e `/quit` chiudono agent view, e `/logout` ti disconnette. Ogni altro comando e skill viene inviato a una nuova sessione in background come suo primo prompt.284Un piccolo insieme di comandi viene eseguito in agent view stesso invece di essere inviato: `/exit` e `/quit` chiudono agent view, `/logout` ti disconnette, e `/model` imposta il [modello di dispatch](#set-the-model). Skills, i tuoi comandi personali, e built-in che espandono il prompt come `/init` vengono inviati a una nuova sessione in background come loro primo prompt. Gli altri comandi built-in mostrano un suggerimento `attach to a session to run it` invece.

285 285 

286Confezionare un compito ricorrente come una [skill](/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.286Confezionare un compito ricorrente come una [skill](/it/skills) ti permette di avviare lo stesso workflow da agent view ripetutamente senza riscrivere il prompt.

287 287 


412 412 

413Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione [`model`](/it/settings#available-settings) nei tuoi settings utente. Impostalo selezionando un modello nel picker [`/model`](/it/model-config), o modifica l'impostazione direttamente. Per sovrascriverlo per l'intera sessione di agent view, passa `--model` quando apri agent view. Vedi [Permission mode, model, and effort](#permission-mode-model-and-effort).413Il nome del modello mostrato nell'intestazione di agent view è il default di dispatch. Le nuove sessioni che avvii dall'input utilizzano questo modello, che proviene dall'impostazione [`model`](/it/settings#available-settings) nei tuoi settings utente. Impostalo selezionando un modello nel picker [`/model`](/it/model-config), o modifica l'impostazione direttamente. Per sovrascriverlo per l'intera sessione di agent view, passa `--model` quando apri agent view. Vedi [Permission mode, model, and effort](#permission-mode-model-and-effort).

414 414 

415Per cambiare il default di dispatch da dentro agent view, digita `/model` seguito da un nome di modello nell'input di dispatch e premi `Enter`. L'intestazione si aggiorna per mostrare quel modello con un marcatore `(session)`, e le sessioni che invii successivamente lo utilizzano. Digita `/model default` per cancellare l'override e tornare al default di dispatch. Questo override dura per il resto della corrente esecuzione di `claude agents`, non scrive nel tuo file di settings, e richiede Claude Code v2.1.172 o successivo. {/* min-version: 2.1.172 */} L'esempio seguente invia una sessione su Opus e la successiva su Sonnet:

416 

417```text theme={null}

418/model opus

419refactor auth

420/model sonnet

421run the test suite

422```

423 

415Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:424Ogni sessione in background può essere eseguita su un modello diverso. Per sovrascriverlo per una sessione:

416 425 

417* Dalla shell, passa `--model` con `claude --bg`.426* Dalla shell, passa `--model` con `claude --bg`.


422 Permission mode, model, and effort431 Permission mode, model, and effort

423</h3>432</h3>

424 433 

425Una sessione in background legge i suoi [settings](/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì.434Una sessione in background legge i suoi [settings](/it/settings) dalla directory in cui viene eseguita, come se avessi avviato `claude` lì. Questo include i valori [`env`](/it/settings#available-settings) nei settings del progetto, quindi un `ANTHROPIC_MODEL` o una variabile del provider impostata lì si applica alle sessioni in background in quella directory.

435 

436La selezione del cloud provider, come `CLAUDE_CODE_USE_BEDROCK` o `CLAUDE_CODE_USE_VERTEX`, e gli alias `ANTHROPIC_DEFAULT_*_MODEL` seguono la shell che ha inviato la sessione. Le variabili dell'endpoint del gateway come `ANTHROPIC_BASE_URL` e il suo `ANTHROPIC_AUTH_TOKEN` associato non lo fanno. Vedi [il processo supervisore](#the-supervisor-process) per come le sessioni in background ottengono le impostazioni del provider e le credenziali.

426 437 

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

428 439 


508 519 

509Le sessioni in background sono ospitate da un processo supervisor per utente, separato dal tuo terminale e da agent view. Il supervisor si avvia automaticamente la prima volta che metti una sessione in background o apri agent view, e non lo gestisci direttamente.520Le sessioni in background sono ospitate da un processo supervisor per utente, separato dal tuo terminale e da agent view. Il supervisor si avvia automaticamente la prima volta che metti una sessione in background o apri agent view, e non lo gestisci direttamente.

510 521 

511Il supervisor e le sue sessioni si autenticano con le stesse credenziali delle tue sessioni interattive e non fanno connessioni di rete aggiuntive oltre l'API del modello.522Il supervisor mantiene un processo worker pre-riscaldato pronto in modo che un dispatch da agent view o `claude --bg` si avvii senza il ritardo di un avvio a freddo. Quando esegui un dispatch, il supervisor assegna il worker pre-riscaldato alla tua sessione, applica la directory, le impostazioni e le credenziali di quella sessione ad esso, e quindi avvia una sostituzione per il prossimo dispatch. Se nessun worker pre-riscaldato sano è disponibile, il supervisor avvia un processo fresco invece.

523 

524Il supervisor e le sue sessioni si autenticano con le stesse credenziali archiviate delle tue sessioni interattive e non fanno connessioni di rete aggiuntive oltre l'API del modello. Le variabili di selezione del provider come `CLAUDE_CODE_USE_BEDROCK` e gli alias `ANTHROPIC_DEFAULT_*_MODEL` vengono letti dalla shell che ha eseguito il dispatch di ogni sessione e vengono applicati al suo worker.

525 

526{/* min-version: 2.1.174 */}Una sessione in background non eredita variabili di endpoint gateway come `ANTHROPIC_BASE_URL`, le variabili di URL base equivalenti di Bedrock, Vertex e Foundry, o un `ANTHROPIC_AUTH_TOKEN` accoppiato dalla shell che ha avviato il supervisor o dalla shell di dispatch. La sessione utilizza le tue credenziali archiviate e qualsiasi valore `env` nella directory del progetto [settings](/it/settings). Per puntare le sessioni in background in un progetto a un [gateway LLM](/it/llm-gateway), imposta `ANTHROPIC_BASE_URL` nel blocco `env` del file `.claude/settings.json` di quel progetto piuttosto che esportarlo nella tua shell. Prima della v2.1.174, una sessione in background ereditava queste variabili dalla shell di avvio del supervisor, quindi poteva utilizzare il gateway che avevi configurato in quella shell invece di quello configurato per la directory del progetto.

512 527 

513Ogni sessione in background è il suo proprio processo Claude Code, gestito dal supervisor piuttosto che legato al tuo terminale. Una sessione che sta attivamente lavorando, aspettando il tuo input, o ha un terminale collegato mantiene il suo processo in esecuzione. Un comando shell in background in esecuzione, un subagente, un workflow dinamico, o un monitor conta come lavoro attivo, quindi un processo a lunga esecuzione come un server di sviluppo mantiene la sessione attiva.528Ogni sessione in background è il suo proprio processo Claude Code, gestito dal supervisor piuttosto che legato al tuo terminale. Una sessione che sta attivamente lavorando, aspettando il tuo input, o ha un terminale collegato mantiene il suo processo in esecuzione. Un comando shell in background in esecuzione, un subagente, un workflow dinamico, o un monitor conta come lavoro attivo, quindi un processo a lunga esecuzione come un server di sviluppo mantiene la sessione attiva.

514 529 


599 614 

600Su Windows, se il supervisor non risponde alla richiesta di arresto, il comando stampa il suo ID di processo. Termina quel processo con `taskkill /PID <pid>` per completare il recupero. Le sessioni in background vengono comunque preservate quando hai passato `--keep-workers`.615Su Windows, se il supervisor non risponde alla richiesta di arresto, il comando stampa il suo ID di processo. Termina quel processo con `taskkill /PID <pid>` per completare il recupero. Le sessioni in background vengono comunque preservate quando hai passato `--keep-workers`.

601 616 

617<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

618 Dispatch non riesce con `Could not resolve authentication method`

619</h3>

620 

621{/* min-version: 2.1.174 */}Se un dispatch in background non riesce con `Could not resolve authentication method` mentre le sessioni interattive si autenticano normalmente, il worker che ha ricevuto il dispatch non ha raccolto le credenziali. Nella versione 2.1.174 e successive il supervisor fornisce uno snapshot di credenziali fresco quando assegna un [worker pre-riscaldato](#the-supervisor-process), quindi questo errore significa che nessuna credenziale memorizzata era disponibile per il processo supervisor stesso. Conferma di aver eseguito `/login` o di aver configurato una chiave API, quindi ferma il supervisor:

622 

623```bash theme={null}

624claude daemon stop --any --keep-workers

625```

626 

627Il prossimo `claude agents` o `claude --bg` avvia un supervisor fresco che legge le tue credenziali memorizzate. Se ti autentichi con una variabile di ambiente come `ANTHROPIC_API_KEY` piuttosto che con `/login`, esegui quel comando successivo da una shell dove la variabile è impostata.

628 

629Vedi il [riferimento degli errori](/it/errors#could-not-resolve-authentication-method) per l'elenco completo delle cause e delle correzioni. Prima della versione 2.1.174, un worker pre-riscaldato che rimane inattivo potrebbe far emergere questo errore quando veniva assegnato a un dispatch anche quando le tue credenziali erano valide. Esegui l'aggiornamento per recuperare.

630 

602<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">631<h3 id="background-sessions-cannot-read-desktop-documents-or-downloads-on-macos">

603 Le sessioni in background non riescono a leggere Desktop, Documents o Downloads su macOS632 Le sessioni in background non riescono a leggere Desktop, Documents o Downloads su macOS

604</h3>633</h3>

Details

219}219}

220```220```

221 221 

222{/* min-version: 2.1.181 */}A partire da Claude Code v2.1.181, l'output flat da `aws configure export-credentials --format process` è accettato anche, con le stesse chiavi al livello superiore invece di annidate sotto `Credentials`.

223 

222`Expiration` è facoltativo. {/* min-version: 2.1.176 */}A partire da Claude Code v2.1.176, quando il comando restituisce un `Expiration` ISO 8601 valido, Claude Code memorizza nella cache le credenziali fino a cinque minuti prima di tale ora. Senza di esso, o nelle versioni precedenti, le credenziali vengono memorizzate nella cache per un'ora.224`Expiration` è facoltativo. {/* min-version: 2.1.176 */}A partire da Claude Code v2.1.176, quando il comando restituisce un `Expiration` ISO 8601 valido, Claude Code memorizza nella cache le credenziali fino a cinque minuti prima di tale ora. Senza di esso, o nelle versioni precedenti, le credenziali vengono memorizzate nella cache per un'ora.

223 225 

224<h3 id="3-configure-claude-code">226<h3 id="3-configure-claude-code">

artifacts.md +270 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Condividere l'output della sessione come artifact

6 

7> Gli artifact trasformano il lavoro di Claude Code in pagine live e interattive a un URL privato che puoi condividere all'interno della tua organizzazione.

8 

9{/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}

10 

11<Note>

12 Gli artifact sono in beta. Richiedono un piano Team o Enterprise e una sessione autenticata con [`/login`](/it/setup#authenticate). Vedi [Disponibilità](#availability) per l'insieme completo dei requisiti.

13</Note>

14 

15Un artifact è una pagina web live e interattiva che Claude Code pubblica dalla tua sessione a un URL privato su claude.ai. Lo apri in un browser e si aggiorna sul posto mentre la sessione continua. Condividilo dall'intestazione della pagina quando vuoi che un collega lo veda. Ad esempio, usa un artifact per guidare un revisore attraverso una pull request con diff annotati, costruire una dashboard dai dati della sessione, o mantenere una timeline di investigazione che si riempie mentre Claude lavora.

16 

17<Frame>

18 <img src="https://mintcdn.com/claude-code/kaHIYYMIYMYPxQg9/images/artifacts-viewer.png?fit=max&auto=format&n=kaHIYYMIYMYPxQg9&q=85&s=dbfd671cdb0d15f49f808b9e89778fe1" alt="Un artifact aperto in un browser su claude.ai/code/artifact. L'intestazione del visualizzatore mostra il titolo dell'artifact acme-funnel-fix, un pulsante Share e l'avatar dell'autore. Il menu Share è aperto con l'interruttore Always share latest version, un selettore di versione che legge Sharing version 2, un selettore di audience Everyone at Acme e un pulsante Copy link. Sotto l'intestazione, la pagina dell'artifact mostra due mockup mobili affiancati, un grafico a imbuto e una riga di schede metriche." width="2511" height="1890" data-path="images/artifacts-viewer.png" />

19</Frame>

20 

21Questa pagina copre come:

22 

23* Decidere [quando usare un artifact](#when-to-use-an-artifact)

24* [Creare](#create-an-artifact), [aggiornare](#update-an-artifact) e [condividere](#share-an-artifact) un artifact

25* Applicare [pattern di prompting](#what-you-can-build) per pagine più ricche

26* [Applicare il tuo sistema di design](#improve-the-visual-design) in modo che gli artifact corrispondano al branding del tuo prodotto

27* Comprendere i [vincoli della pagina](#page-constraints) e i [requisiti di disponibilità](#availability)

28* [Disabilitare](#disable-artifacts) o [gestire gli artifact per la tua organizzazione](#manage-artifacts-for-your-organization)

29 

30<h2 id="when-to-use-an-artifact">

31 When to use an artifact

32</h2>

33 

34Usa un artifact quando il testo del terminale è il mezzo sbagliato per quello che Claude ha prodotto: output che è più facile da guardare e con cui interagire rispetto a leggere riga per riga. Claude costruisce la pagina da qualsiasi cosa la tua sessione possa raggiungere, inclusa la tua codebase e i dati che estrae attraverso i tuoi [strumenti connessi](/it/mcp), quindi la pagina può mostrare cose che richiederebbero paragrafi per descrivere. Ad esempio, chiedi a Claude di:

35 

36* Guidare un revisore attraverso una pull request con diff annotati

37* Renderizzare una dashboard dai dati che la sessione ha già estratto

38* Disporre diverse opzioni di design o implementazione affiancate

39* Mantenere una timeline di investigazione che si riempie mentre un'attività lunga viene eseguita

40* Inviare a un collega un link invece di incollare l'output in Slack

41 

42Vedi [Cosa puoi costruire](#what-you-can-build) per i prompt che corrispondono a ciascuno di questi.

43 

44<h3 id="what-an-artifact-is-not">

45 What an artifact is not

46</h3>

47 

48Un artifact è una cattura del lavoro, non un'applicazione. È una singola pagina autonoma senza backend, quindi non può archiviare l'input del modulo, chiamare un'API al momento della visualizzazione o servire più route. Per uno strumento interno ospitato con un backend, distribuiscilo sulla tua infrastruttura. Vedi [Vincoli della pagina](#page-constraints) per l'insieme completo dei limiti.

49 

50<h2 id="create-an-artifact">

51 Create an artifact

52</h2>

53 

54Claude può pubblicare un artifact da solo quando l'output si adatta a una pagina, oppure puoi chiederne uno direttamente. Per chiedere, nomina la funzione o descrivi l'output visivo che desideri in linguaggio semplice. Un buon candidato è qualsiasi cosa più facile da vedere che da leggere come testo, come un diff annotato, un grafico o un insieme di opzioni da confrontare. I prompt di seguito sono due esempi; vedi [Cosa puoi costruire](#what-you-can-build) per altri pattern.

55 

56```text wrap theme={null}

57Make an artifact that walks through this PR with the diff annotated inline.

58```

59 

60```text wrap theme={null}

61Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.

62```

63 

64Claude scrive la pagina in un file HTML o Markdown nel tuo progetto, quindi la pubblica. Prima di pubblicare un nuovo artifact, Claude Code chiede il permesso; potrebbe dire qualcosa come `Claude wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on claude.ai`. Ripubblicare un artifact che hai già approvato non richiede di nuovo il prompt.

65 

66Seleziona **Yes** per pubblicare. Claude stampa l'URL e il tuo browser si apre sulla nuova pagina. Premi `Ctrl+]` in qualsiasi momento per riaprire l'artifact più recente dal terminale.

67 

68Claude sceglie il titolo dell'artifact e un emoji per l'icona della scheda del browser. Entrambi appaiono nella tua [galleria di artifact](#share-an-artifact) su claude.ai e nei link condivisi, quindi chiedi a Claude di usare un titolo o un'icona specifica se ne vuoi uno.

69 

70Per impedire al browser di aprirsi automaticamente quando viene pubblicato un nuovo artifact, imposta `CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0` nel tuo ambiente.

71 

72Se Claude risponde che non può pubblicare, o scrive un file HTML locale senza un link, lo strumento non è abilitato per la tua sessione. Controlla i requisiti di [Disponibilità](#availability).

73 

74<h2 id="update-an-artifact">

75 Update an artifact

76</h2>

77 

78Chiedi a Claude di revisionare la pagina, o lascia che un'attività di lunga durata ripubblichi mentre fa progressi. Claude modifica il file sottostante e pubblica di nuovo allo stesso URL.

79 

80```text wrap theme={null}

81Add a per-region breakdown below the summary chart and republish.

82```

83 

84Chiunque abbia la pagina aperta vede l'aggiornamento sul posto. Ogni pubblicazione diventa una versione, e dal controllo **Share** nell'intestazione della pagina puoi scegliere quale versione vedono i visualizzatori.

85 

86Per aggiornare un artifact da una sessione diversa, dai a Claude l'URL dell'artifact e chiedigli di revisionarlo. Senza l'URL, una nuova sessione crea sempre un nuovo artifact piuttosto che aggiornarne uno esistente.

87 

88```text wrap theme={null}

89Update https://claude.ai/code/artifact/5fbea6f3-... with today's numbers.

90```

91 

92<h2 id="share-an-artifact">

93 Share an artifact

94</h2>

95 

96Un nuovo artifact è visibile solo a te. Aprilo nel tuo browser e usa il controllo **Share** nell'intestazione della pagina per concedere l'accesso a persone specifiche nella tua organizzazione, o a tutti. L'intestazione ti nomina come autore dell'artifact, quindi chiunque tu lo condivida con può vedere chi ha pubblicato la pagina. Si collega anche alla tua galleria su [claude.ai/code/artifacts](https://claude.ai/code/artifacts), che elenca ogni artifact che hai creato.

97 

98La condivisione si ferma alla tua organizzazione. I visualizzatori devono accedere a claude.ai come membro della stessa organizzazione che ha pubblicato l'artifact, e non c'è opzione per rendere un artifact visibile al di fuori di essa. Per inviare il contenuto sottostante a qualcuno al di fuori della tua organizzazione, chiedi a Claude il file HTML e condividi quel file direttamente.

99 

100Gli artifact sono visualizzabili, non co-modificabili. Le persone con cui lo condividi vedono ogni versione che pubblichi ma non possono modificare la pagina; rimani l'unico scrittore.

101 

102<h2 id="what-you-can-build">

103 What you can build

104</h2>

105 

106Un artifact è una singola pagina HTML, quindi qualsiasi cosa tu possa esprimere in HTML, CSS e JavaScript inline è nell'ambito. I pattern di seguito si presentano più spesso.

107 

108<h3 id="walk-through-a-change">

109 Walk through a change

110</h3>

111 

112Chiedi una pagina che renderizzi un diff o un cambiamento di design con annotazioni accanto alle righe rilevanti, in modo che i revisori possano leggere il tuo ragionamento accanto al codice invece di ricostruirlo da una descrizione.

113 

114```text wrap theme={null}

115Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.

116```

117 

118<h3 id="compare-alternatives">

119 Compare alternatives

120</h3>

121 

122Chiedi diverse varianti su una pagina in modo da poter valutarle l'una contro l'altra. Questo funziona per layout, copy, forme API o piani di implementazione.

123 

124```text wrap theme={null}

125Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.

126```

127 

128<h3 id="tune-with-interactive-controls">

129 Tune with interactive controls

130</h3>

131 

132Chiedi slider, interruttori o campi di input associati a quello che stai regolando, in modo da poter esplorare i valori direttamente invece di descriverli.

133 

134```text wrap theme={null}

135Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.

136```

137 

138<h3 id="bring-the-result-back-to-your-session">

139 Bring the result back to your session

140</h3>

141 

142Un artifact può agire come un editor leggero per una decisione che poi restituisci a Claude. Chiedi un controllo di esportazione che produca testo che puoi incollare nel terminale, in modo che il risultato dell'interazione con la pagina fluisca di nuovo nella sessione invece di rimanere sulla pagina.

143 

144```text wrap theme={null}

145Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.

146```

147 

148<h3 id="track-work-in-progress">

149 Track work in progress

150</h3>

151 

152Chiedi a Claude di mantenere un artifact aggiornato mentre un'attività lunga viene eseguita, in modo che chiunque abbia il link possa seguire senza leggere il terminale.

153 

154```text wrap theme={null}

155Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.

156```

157 

158<h2 id="improve-the-visual-design">

159 Improve the visual design

160</h2>

161 

162Claude applica una skill di design integrata quando costruisce un artifact, quindi le pagine ottengono una tavolozza deliberata, tipografia e layout senza prompt extra. Quella skill cerca anche un sistema di design esistente nel tuo progetto prima di scegliere il suo. Per mantenere gli artifact coerenti con il branding del tuo prodotto, registra i tuoi token di design dove Claude può trovarli, come il [CLAUDE.md](/it/memory) del progetto o un file di tema nel tuo repository:

163 

164```markdown theme={null}

165## Design system

166 

167- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc

168- Typography: Inter for body, JetBrains Mono for code

169- Spacing: 8px scale, 6px border radius

170```

171 

172Claude tratta il tuo sistema di design come priorità più alta rispetto alle sue scelte, e il tuo prompt come priorità più alta rispetto a entrambi. L'intestazione e il formato sopra sono un esempio; qualsiasi elenco chiaro di colori, font e spaziatura funziona.

173 

174<h2 id="page-constraints">

175 Page constraints

176</h2>

177 

178Ogni artifact è una singola pagina autonoma. Claude Code avvolge il file che pubblichi in una shell di documento HTML e lo serve secondo una rigorosa Content Security Policy (CSP), che modella quello che la pagina può fare.

179 

180| Constraint | Effect |

181| :------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

182| No external requests | La CSP blocca script, fogli di stile, font e immagini caricate da qualsiasi altro host, insieme a `fetch`, XHR e chiamate WebSocket. Claude incorpora CSS e JavaScript e incorpora immagini come data URI in modo che la pagina si renderizzi senza alcuna richiesta esterna. |

183| No backend | Un artifact è una pagina statica. Non può archiviare dati inviati tramite un modulo, autenticare i visualizzatori stesso, o chiamare un'API al momento della visualizzazione. |

184| Single page | I link relativi non si risolvono, perché nulla viene distribuito insieme alla pagina. Per contenuti multi-sezione, Claude utilizza ancore in-page piuttosto che file separati. |

185| Source file types | Il file pubblicato deve essere `.html`, `.htm` o `.md`. I file Markdown si renderizzano come HTML stilizzato. |

186| Rendered size | La pagina renderizzata deve essere 16 MiB o più piccola. Le immagini incorporate di grandi dimensioni sono la causa usuale quando una pubblicazione fallisce per dimensione. |

187 

188Generare un artifact utilizza token di output come qualsiasi altra risposta, e una pagina stilizzata è più intensiva di token rispetto allo stesso contenuto come testo di terminale. CSS inline, JavaScript per controlli interattivi e soprattutto immagini incorporate come data URI sono i principali contributori. Per ridurre il costo dei token di un artifact:

189 

190* Preferisci SVG, o HTML e CSS, per i diagrammi rispetto alle immagini raster incorporate

191* Ometti l'interattività che non ti serve

192* Fai in modo che la pagina riassuma grandi set di dati piuttosto che incorporarli completamente

193 

194<h2 id="availability">

195 Availability

196</h2>

197 

198Gli artifact richiedono ogni condizione di seguito. Quando una non è soddisfatta, Claude scrive un file HTML locale o dice che non può pubblicare.

199 

200| Requirement | Available when |

201| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

202| Plan | Team o Enterprise. Sui piani Team, gli artifact sono abilitati per impostazione predefinita. Sui piani Enterprise, un admin li [abilita](#manage-artifacts-for-your-organization) nelle impostazioni admin di claude.ai. |

203| Authentication | Accesso a claude.ai con `/login`. Le sessioni che utilizzano una chiave API, [gateway token](/it/llm-gateway) o credenziale del provider cloud non possono pubblicare. |

204| Model provider | Anthropic API. Non disponibile su [Amazon Bedrock](/it/amazon-bedrock), [Google Cloud Vertex AI](/it/google-vertex-ai) o [Microsoft Foundry](/it/microsoft-foundry). |

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

206| Surface | Claude Code CLI, o l'app desktop Claude versione 1.13576.0 o successiva. Disabilitato per impostazione predefinita in contesti [Agent SDK](/it/agent-sdk/overview), GitHub Action e MCP-server, e quando [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/it/env-vars) è impostato. |

207 

208<h2 id="disable-artifacts">

209 Disable artifacts

210</h2>

211 

212Per disattivare gli artifact per le tue sessioni indipendentemente dall'impostazione della tua organizzazione, usa uno qualsiasi di:

213 

214| Method | Setting |

215| :----------------------------------- | :--------------------------------------- |

216| [Settings file](/it/settings) | `"disableArtifact": true` |

217| [Environment variable](/it/env-vars) | `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

218| [Permission rule](/it/permissions) | Aggiungi `Artifact` a `permissions.deny` |

219 

220<h2 id="manage-artifacts-for-your-organization">

221 Manage artifacts for your organization

222</h2>

223 

224Gli admin sui piani Team e Enterprise controllano gli artifact dalle [impostazioni admin di claude.ai](https://claude.ai/admin-settings/claude-code). Il contenuto dell'artifact è archiviato su infrastruttura gestita da Anthropic ed è visibile solo ai membri autenticati dell'organizzazione che pubblica.

225 

226<h3 id="enable-or-disable-artifacts">

227 Enable or disable artifacts

228</h3>

229 

230Per abilitare o disabilitare gli artifact per l'intera organizzazione, vai a **Settings > Claude Code > Capabilities** e usa l'interruttore **Artifacts**. Sui piani Enterprise con controllo dell'accesso basato su ruoli, puoi inoltre limitare gli artifact a ruoli specifici: vai a **Settings > Roles**, modifica un ruolo e imposta l'autorizzazione **Artifacts** nel gruppo **Claude Code**.

231 

232<h3 id="set-a-retention-policy">

233 Set a retention policy

234</h3>

235 

236Per impostare quanto tempo gli artifact vengono conservati prima dell'eliminazione automatica, vai a **Settings > Data & privacy controls**. Puoi impostare periodi di conservazione separati per gli artifact che sono ancora privati al loro autore e gli artifact che sono stati condivisi.

237 

238<h3 id="review-the-audit-log">

239 Review the audit log

240</h3>

241 

242La pubblicazione, la condivisione e l'eliminazione di un artifact appaiono ciascuna nel registro di audit della tua organizzazione sotto i tipi di evento `claude_artifact_*`, la stessa famiglia utilizzata per gli artifact creati nelle conversazioni di claude.ai.

243 

244<h3 id="allowlist-the-viewer-domain">

245 Allowlist the viewer domain

246</h3>

247 

248Il visualizzatore su claude.ai carica ogni artifact da un'origine sandbox `*.claudeusercontent.com`. Se la tua organizzazione limita l'accesso alla rete in uscita, aggiungi quel dominio alla tua allowlist insieme a `claude.ai`. Vedi [Requisiti di accesso alla rete](/it/network-config#network-access-requirements) per l'elenco completo.

249 

250<h3 id="list-and-delete-artifacts-with-the-compliance-api">

251 List and delete artifacts with the Compliance API

252</h3>

253 

254La [Compliance API](https://docs.claude.com/en/api/compliance) fornisce endpoint per elencare gli artifact di un'organizzazione, recuperare il contenuto di una versione specifica e eliminare un artifact:

255 

256| Method | Endpoint |

257| :------- | :------------------------------------------------------------------ |

258| `GET` | `/v1/compliance/code/artifacts` |

259| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |

260| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |

261 

262Per gli schemi di richiesta e risposta, vedi il [riferimento della Compliance API](https://docs.claude.com/en/api/compliance/code/artifacts).

263 

264<h2 id="related-resources">

265 Related resources

266</h2>

267 

268* Sfoglia [pattern di prompting e workflow](/it/prompt-library) che si abbinano agli artifact

269* Trasforma un prompt di artifact che riutilizzi in una [skill](/it/skills) in modo da poterlo invocare come comando

270* [Connetti server MCP](/it/mcp) in modo che Claude possa estrarre dati live in un artifact

chrome.md +1 −1

Details

198 Estensione non rilevata198 Estensione non rilevata

199</h3>199</h3>

200 200 

201Se la riga setup-issues di Claude Code elenca `chrome`:201Se Claude Code non riesce a rilevare l'estensione Chrome:

202 202 

2031. Verifica che l'estensione Chrome sia installata e abilitata in `chrome://extensions`2031. Verifica che l'estensione Chrome sia installata e abilitata in `chrome://extensions`

2042. Verifica che Claude Code sia aggiornato eseguendo `claude --version`2042. Verifica che Claude Code sia aggiornato eseguendo `claude --version`

Details

124 </Step>124 </Step>

125</Steps>125</Steps>

126 126 

127<h3 id="link-artifacts-back-to-the-session">127<h3 id="link-output-back-to-the-session">

128 Collega gli artefatti di nuovo alla sessione128 Collega l'output di nuovo alla sessione

129</h3>129</h3>

130 130 

131Ogni sessione cloud ha un URL di trascrizione su claude.ai e la sessione può leggere il suo ID dalla variabile di ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Usa questo per mettere un link tracciabile nei corpi PR, nei messaggi di commit, nei post Slack o nei report generati in modo che un revisore possa aprire l'esecuzione che li ha prodotti.131Ogni sessione cloud ha un URL di trascrizione su claude.ai e la sessione può leggere il suo ID dalla variabile di ambiente `CLAUDE_CODE_REMOTE_SESSION_ID`. Usa questo per mettere un link tracciabile nei corpi PR, nei messaggi di commit, nei post Slack o nei report generati in modo che un revisore possa aprire l'esecuzione che li ha prodotti.

132 132 

133Il valore della variabile utilizza un prefisso `cse_`, mentre il percorso dell'URL di trascrizione utilizza lo stesso ID con un prefisso `session_`. Sostituisci il prefisso quando costruisci il link. Il seguente comando stampa l'URL:133A partire dalla v2.1.179, i commit che Claude crea in una sessione web includono un trailer git `Claude-Session: <url>` e i corpi PR includono l'URL della sessione su una riga propria. {/* min-version: 2.1.182 */}Da v2.1.182, imposta [`attribution.sessionUrl`](/it/settings#attribution-settings) su `false` per omettere il trailer e il link nel corpo PR.

134 

135Per includere il link della sessione in qualcosa di diverso da un commit o PR, come un messaggio Slack che Claude pubblica o un file di report che scrive, chiedi a Claude di eseguire il seguente comando e usa il suo output. Il comando converte il prefisso `cse_` nel valore della variabile di ambiente al prefisso `session_` che l'URL di trascrizione si aspetta:

134 136 

135```bash theme={null}137```bash theme={null}

136echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"138echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"


902* [Riferimento delle impostazioni](/it/settings): tutte le opzioni di configurazione904* [Riferimento delle impostazioni](/it/settings): tutte le opzioni di configurazione

903* [Sicurezza](/it/security): garanzie di isolamento e gestione dei dati905* [Sicurezza](/it/security): garanzie di isolamento e gestione dei dati

904* [Utilizzo dei dati](/it/data-usage): cosa Anthropic conserva dalle sessioni cloud906* [Utilizzo dei dati](/it/data-usage): cosa Anthropic conserva dalle sessioni cloud

907* [Claude Tag](https://claude.com/docs/claude-tag/overview): un @Claude gestito dall'organizzazione in Slack che viene eseguito nello stesso ambiente cloud

Details

238}238}

239```239```

240 240 

241Con `awsAuthRefresh` configurato, `/login` mostra un'opzione **Claude Platform on AWS · refresh credentials** in **Using 3rd-party platforms**. Selezionandola si esegue il comando configurato e si rileggono le credenziali AWS senza riavviare Claude Code.

242 

241**Opzione B: Chiave API dell'area di lavoro**243**Opzione B: Chiave API dell'area di lavoro**

242 244 

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


251Trattare le chiavi API dell'area di lavoro come qualsiasi altra credenziale di produzione. Il blocco `env` del [file delle impostazioni utente](/it/settings) è un modo conveniente per limitare la chiave alla propria macchina senza esportarla globalmente.253Trattare le chiavi API dell'area di lavoro come qualsiasi altra credenziale di produzione. Il blocco `env` del [file delle impostazioni utente](/it/settings) è un modo conveniente per limitare la chiave alla propria macchina senza esportarla globalmente.

252 254 

253<Note>255<Note>

254 I comandi `/login` e `/logout` non modificano l'autenticazione di Claude Platform on AWS. L'autenticazione viene eseguita tramite le credenziali AWS o la chiave API dell'area di lavoro, non tramite una sottoscrizione Claude.ai.256 I comandi `/login` e `/logout` non consentono di accedere a un abbonamento Claude.ai per Claude Platform on AWS. L'autenticazione viene eseguita tramite le credenziali AWS o la chiave API dell'area di lavoro. L'eccezione è l'opzione **refresh credentials** che `/login` mostra quando `awsAuthRefresh` è configurato, che rilegge le credenziali AWS come descritto sopra.

255</Note>257</Note>

256 258 

257<h3 id="2-configure-claude-code">259<h3 id="2-configure-claude-code">

Details

33| `claude daemon stop --any` | Interrompi il [supervisore](/it/agent-view#the-supervisor-process) della sessione in background e le sessioni che ospita. Passa `--keep-workers` per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. `--any` conferma l'interruzione di un supervisore su richiesta, che è l'impostazione predefinita. Usa questo per recuperare da un [supervisore che non risponde](/it/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |33| `claude daemon stop --any` | Interrompi il [supervisore](/it/agent-view#the-supervisor-process) della sessione in background e le sessioni che ospita. Passa `--keep-workers` per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. `--any` conferma l'interruzione di un supervisore su richiesta, che è l'impostazione predefinita. Usa questo per recuperare da un [supervisore che non risponde](/it/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |

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

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

36| `claude mcp login <name>` | {/* min-version: 2.1.186 */}Esegui il flusso OAuth di un server MCP configurato senza aprire il pannello interattivo `/mcp`. Funziona per server HTTP, SSE e connettori claude.ai. Aggiungi `--no-browser` su SSH per stampare l'URL di autorizzazione invece di aprire un browser, quindi incolla l'URL di reindirizzamento al prompt. Richiede Claude Code v2.1.186 o successivo. Vedi [Autentica dalla riga di comando](/it/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |

37| `claude mcp logout <name>` | {/* min-version: 2.1.186 */}Cancella le credenziali OAuth archiviate per un server MCP. Richiede Claude Code v2.1.186 o successivo | `claude mcp logout sentry` |

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

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

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


60| `--allowedTools`, `--allowed-tools` | Strumenti che si eseguono senza richiedere l'autorizzazione. Vedi [sintassi delle regole di autorizzazione](/it/settings#permission-rule-syntax) per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa `--tools` invece | `"Bash(git log *)" "Bash(git diff *)" "Read"` |62| `--allowedTools`, `--allowed-tools` | Strumenti che si eseguono senza richiedere l'autorizzazione. Vedi [sintassi delle regole di autorizzazione](/it/settings#permission-rule-syntax) per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa `--tools` invece | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

61| `--append-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema predefinito | `claude --append-system-prompt "Always use TypeScript"` |63| `--append-system-prompt` | Aggiungi testo personalizzato alla fine del prompt di sistema predefinito | `claude --append-system-prompt "Always use TypeScript"` |

62| `--append-system-prompt-file` | Carica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinito | `claude --append-system-prompt-file ./extra-rules.txt` |64| `--append-system-prompt-file` | Carica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinito | `claude --append-system-prompt-file ./extra-rules.txt` |

65| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lettore di schermo: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/it/settings#available-settings) non ha effetto per la sessione. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e l'impostazione [`axScreenReader`](/it/settings#available-settings). Richiede Claude Code v2.1.181 o successivo | `claude --ax-screen-reader` |

63| `--bare` | Modalità minima: salta l'auto-discovery di hooks, skills, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. Claude ha accesso a strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/it/env-vars). Vedi [modalità bare](/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |66| `--bare` | Modalità minima: salta l'auto-discovery di hooks, skills, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. Claude ha accesso a strumenti Bash, lettura file e modifica file. Imposta [`CLAUDE_CODE_SIMPLE`](/it/env-vars). Vedi [modalità bare](/it/headless#start-faster-with-bare-mode) | `claude --bare -p "query"` |

64| `--betas` | Intestazioni beta da includere nelle richieste API (solo utenti con chiave API) | `claude --betas interleaved-thinking` |67| `--betas` | Intestazioni beta da includere nelle richieste API (solo utenti con chiave API) | `claude --betas interleaved-thinking` |

65| `--bg` | Avvia la sessione come un [agent in background](/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come un job in background invece di una sessione Claude, o con `--agent` per eseguire uno specifico subagent | `claude --bg "investigate the flaky test"` |68| `--bg` | Avvia la sessione come un [agent in background](/it/agent-view) e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con `--exec` per eseguire un comando shell come un job in background invece di una sessione Claude, o con `--agent` per eseguire uno specifico subagent | `claude --bg "investigate the flaky test"` |


114| `--system-prompt` | Sostituisci l'intero prompt di sistema con testo personalizzato | `claude --system-prompt "You are a Python expert"` |117| `--system-prompt` | Sostituisci l'intero prompt di sistema con testo personalizzato | `claude --system-prompt "You are a Python expert"` |

115| `--system-prompt-file` | Carica il prompt di sistema da un file, sostituendo il prompt predefinito | `claude --system-prompt-file ./custom-prompt.txt` |118| `--system-prompt-file` | Carica il prompt di sistema da un file, sostituendo il prompt predefinito | `claude --system-prompt-file ./custom-prompt.txt` |

116| `--teleport` | Riprendi una [sessione web](/it/claude-code-on-the-web) nel tuo terminale locale | `claude --teleport` |119| `--teleport` | Riprendi una [sessione web](/it/claude-code-on-the-web) nel tuo terminale locale | `claude --teleport` |

117| `--teammate-mode` | Imposta come i compagni di squadra del [team di agent](/it/agent-teams) vengono visualizzati: `auto` (predefinito), `in-process` o `tmux`. Sostituisce l'impostazione [`teammateMode`](/it/settings#available-settings) per questa sessione. Vedi [Scegli una modalità di visualizzazione](/it/agent-teams#choose-a-display-mode) | `claude --teammate-mode in-process` |120| `--teammate-mode` | Imposta come i compagni di squadra del [team di agent](/it/agent-teams) vengono visualizzati: `in-process` (predefinito), `auto`, `tmux` o {/* min-version: 2.1.186 */}`iterm2` (aggiunto in v2.1.186). L'impostazione predefinita è cambiata da `auto` in v2.1.179. Sostituisce l'impostazione [`teammateMode`](/it/settings#available-settings) per questa sessione. Vedi [Scegli una modalità di visualizzazione](/it/agent-teams#choose-a-display-mode) | `claude --teammate-mode auto` |

118| `--tmux` | Crea una sessione tmux per il worktree. Richiede `--worktree`. Utilizza i riquadri nativi di iTerm2 quando disponibili; passa `--tmux=classic` per tmux tradizionale | `claude -w feature-auth --tmux` |121| `--tmux` | Crea una sessione tmux per il worktree. Richiede `--worktree`. Utilizza i riquadri nativi di iTerm2 quando disponibili; passa `--tmux=classic` per tmux tradizionale | `claude -w feature-auth --tmux` |

119| `--tools` | Limita quali strumenti integrati Claude può utilizzare. Usa `""` per disabilitare tutti, `"default"` per tutti, o nomi di strumenti come `"Bash,Edit,Read"`. Gli strumenti MCP non sono interessati; per negarli anche, usa `--disallowedTools "mcp__*"` o passa `--strict-mcp-config` senza `--mcp-config` in modo che nessun server MCP si carichi | `claude --tools "Bash,Edit,Read"` |122| `--tools` | Limita quali strumenti integrati Claude può utilizzare. Usa `""` per disabilitare tutti, `"default"` per tutti, o nomi di strumenti come `"Bash,Edit,Read"`. Gli strumenti MCP non sono interessati; per negarli anche, usa `--disallowedTools "mcp__*"` o passa `--strict-mcp-config` senza `--mcp-config` in modo che nessun server MCP si carichi | `claude --tools "Bash,Edit,Read"` |

120| `--verbose` | Abilita la registrazione dettagliata, mostra l'output completo turno per turno. Sostituisce l'impostazione [`viewMode`](/it/settings#available-settings) per questa sessione | `claude --verbose` |123| `--verbose` | Abilita la registrazione dettagliata, mostra l'output completo turno per turno. Sostituisce l'impostazione [`viewMode`](/it/settings#available-settings) per questa sessione | `claude --verbose` |

commands.md +3 −3

Details

24 24 

25**Esecuzione del lavoro in parallelo.** `/agents` apre il gestore per i [subagent](/it/sub-agents) a cui Claude può delegare attività secondarie, e `/tasks` elenca cosa è in esecuzione in background della sessione corrente. `/background` scollega l'intera sessione per continuare l'esecuzione come [agente in background](/it/agent-view) e libera il tuo terminale. Per una modifica importante che si estende su tutta la codebase, `/batch` la scompone in unità indipendenti ed esegue ciascuna nel suo proprio [worktree](/it/worktrees). Vedi [Esegui agenti in parallelo](/it/agents) per come questi approcci si relazionano.25**Esecuzione del lavoro in parallelo.** `/agents` apre il gestore per i [subagent](/it/sub-agents) a cui Claude può delegare attività secondarie, e `/tasks` elenca cosa è in esecuzione in background della sessione corrente. `/background` scollega l'intera sessione per continuare l'esecuzione come [agente in background](/it/agent-view) e libera il tuo terminale. Per una modifica importante che si estende su tutta la codebase, `/batch` la scompone in unità indipendenti ed esegue ciascuna nel suo proprio [worktree](/it/worktrees). Vedi [Esegui agenti in parallelo](/it/agents) per come questi approcci si relazionano.

26 26 

27**Prima di inviare.** `/diff` mostra cosa è cambiato, `/code-review` controlla il diff per bug di correttezza e pulizie e può applicare i risultati con `--fix`, e `/review` o `/security-review` forniscono una lettura più profonda in sola lettura. `/code-review ultra` esegue una revisione multi-agente nel cloud.27**Prima di inviare.** `/diff` mostra cosa è cambiato, `/code-review` controlla il diff per bug di correttezza e pulizie e può applicare i risultati con `--fix`, `/review` esegue la stessa revisione in sola lettura su una pull request di GitHub, e `/security-review` fornisce una lettura più profonda in sola lettura. `/code-review ultra` esegue una revisione multi-agente nel cloud.

28 28 

29**Tra le sessioni.** `/clear` inizia da capo su un nuovo compito mantenendo la memoria del progetto. `/resume` e `/branch` ti permettono di tornare a una conversazione precedente o di crearvi un ramo. `/teleport` estrae una sessione web in questo terminale, e `/remote-control` ti permette di continuare questa sessione locale da un altro dispositivo.29**Tra le sessioni.** `/clear` inizia da capo su un nuovo compito mantenendo la memoria del progetto. `/resume` e `/branch` ti permettono di tornare a una conversazione precedente o di crearvi un ramo. `/teleport` estrae una sessione web in questo terminale, e `/remote-control` ti permette di continuare questa sessione locale da un altro dispositivo.

30 30 


64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/it/skills#bundled-skills).** Rivedi il diff corrente per bug di correttezza e per riutilizzo, semplificazione e pulizie di efficienza. Passa `--fix` per applicare i risultati al tuo albero di lavoro, `--comment` per pubblicarli come commenti inline su GitHub PR, o `ultra` per eseguire una profonda [revisione cloud](/it/ultrareview). {/* min-version: 2.1.154 */}Da v2.1.154, `/simplify` esegue una revisione separata solo per la pulizia che applica le correzioni senza cercare bug di correttezza. Vedi [Rivedi un diff localmente](/it/code-review#review-a-diff-locally) per i livelli di sforzo e il targeting |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[Skill](/it/skills#bundled-skills).** Rivedi il diff corrente per bug di correttezza e per riutilizzo, semplificazione e pulizie di efficienza. Passa `--fix` per applicare i risultati al tuo albero di lavoro, `--comment` per pubblicarli come commenti inline su GitHub PR, o `ultra` per eseguire una profonda [revisione cloud](/it/ultrareview). {/* min-version: 2.1.154 */}Da v2.1.154, `/simplify` esegue una revisione separata solo per la pulizia che applica le correzioni senza cercare bug di correttezza. Vedi [Rivedi un diff localmente](/it/code-review#review-a-diff-locally) per i livelli di sforzo e il targeting |

65| `/color [color\|default]` | Imposta il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usa `default` per ripristinare, oppure esegui senza argomento per scegliere un colore casuale. Quando [Remote Control](/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code |65| `/color [color\|default]` | Imposta il colore della barra dei prompt per la sessione corrente. Colori disponibili: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Usa `default` per ripristinare, oppure esegui senza argomento per scegliere un colore casuale. Quando [Remote Control](/it/remote-control) è connesso, il colore si sincronizza con claude.ai/code |

66| `/compact [instructions]` | Libera il contesto riassumendo la conversazione finora. Facoltativamente passa istruzioni di focus per il riassunto. Vedi [come la compattazione gestisce regole, skill e file di memoria](/it/context-window#what-survives-compaction) |66| `/compact [instructions]` | Libera il contesto riassumendo la conversazione finora. Facoltativamente passa istruzioni di focus per il riassunto. Vedi [come la compattazione gestisce regole, skill e file di memoria](/it/context-window#what-survives-compaction) |

67| `/config` | Apri l'interfaccia [Impostazioni](/it/settings) per regolare il tema, il modello, lo [stile di output](/it/output-styles) e altre preferenze. Alias: `/settings` |67| `/config [key=value ...]` | Apri l'interfaccia [Impostazioni](/it/settings) per regolare il tema, il modello, lo [stile di output](/it/output-styles) e altre preferenze. {/* min-version: 2.1.181 */}Da v2.1.181, passa uno o più coppie `key=value` per impostare un'impostazione direttamente senza aprire l'interfaccia, ad esempio `/config thinking=false`. {/* min-version: 2.1.182 */}Da v2.1.182, sono accettate anche chiavi abbreviate con nome, come `/config theme=dark` o `/config model=sonnet`. La forma `key=value` funziona anche in modalità non interattiva (`-p`) e da [Remote Control](/it/remote-control). Esegui `/config --help` per elencare ogni chiave impostabile con le sue opzioni. Alias: `/settings` |

68| `/context [all]` | Visualizza l'utilizzo del contesto corrente come una griglia colorata. Mostra suggerimenti di ottimizzazione per gli strumenti pesanti di contesto, gonfiore della memoria e avvisi di capacità. In [modalità a schermo intero](/it/fullscreen) la ripartizione per elemento è compressa per mantenere la griglia visibile. Passa `all` per espanderla |68| `/context [all]` | Visualizza l'utilizzo del contesto corrente come una griglia colorata. Mostra suggerimenti di ottimizzazione per gli strumenti pesanti di contesto, gonfiore della memoria e avvisi di capacità. In [modalità a schermo intero](/it/fullscreen) la ripartizione per elemento è compressa per mantenere la griglia visibile. Passa `all` per espanderla |

69| `/copy [N]` | Copia l'ultima risposta dell'assistente negli appunti. Passa un numero `N` per copiare la N-esima risposta più recente: `/copy 2` copia la penultima. Quando sono presenti blocchi di codice, mostra un selettore interattivo per selezionare singoli blocchi o la risposta completa. Premi `w` nel selettore per scrivere la selezione in un file invece che negli appunti, il che è utile tramite SSH |69| `/copy [N]` | Copia l'ultima risposta dell'assistente negli appunti. Passa un numero `N` per copiare la N-esima risposta più recente: `/copy 2` copia la penultima. Quando sono presenti blocchi di codice, mostra un selettore interattivo per selezionare singoli blocchi o la risposta completa. Premi `w` nel selettore per scrivere la selezione in un file invece che negli appunti, il che è utile tramite SSH |

70| `/cost` | Alias per `/usage` |70| `/cost` | Alias per `/usage` |


114| `/remote-env` | Scegli l'ambiente predefinito per gli [agenti cloud](/it/claude-code-on-the-web#configure-your-environment) |114| `/remote-env` | Scegli l'ambiente predefinito per gli [agenti cloud](/it/claude-code-on-the-web#configure-your-environment) |

115| `/rename [name]` | Rinomina la sessione corrente e mostra il nome sulla barra dei prompt. Senza un nome, ne genera uno automaticamente dalla cronologia della conversazione |115| `/rename [name]` | Rinomina la sessione corrente e mostra il nome sulla barra dei prompt. Senza un nome, ne genera uno automaticamente dalla cronologia della conversazione |

116| `/resume [session]` | Riprendi una conversazione per ID o nome, oppure apri il selettore di sessione. A partire da v2.1.144, le [sessioni in background](/it/agent-view) appaiono nel selettore contrassegnate con `bg`. Alias: `/continue` |116| `/resume [session]` | Riprendi una conversazione per ID o nome, oppure apri il selettore di sessione. A partire da v2.1.144, le [sessioni in background](/it/agent-view) appaiono nel selettore contrassegnate con `bg`. Alias: `/continue` |

117| `/review [PR]` | Rivedi una pull request localmente nella tua sessione corrente. Per una revisione più profonda basata su cloud, vedi [`/code-review ultra`](/it/ultrareview) |117| `/review [PR]` | Rivedi una pull request di GitHub per numero, utilizzando lo stesso motore di revisione di `/code-review`. Senza argomenti, elenca i PR aperti da cui scegliere. Per una revisione basata su cloud, vedi [`/code-review ultra`](/it/ultrareview) |

118| `/rewind` | Riavvolgi la conversazione e/o il codice a un punto precedente, o riassumi da un messaggio selezionato. Vedi [checkpointing](/it/checkpointing). Alias: `/checkpoint`, `/undo` |118| `/rewind` | Riavvolgi la conversazione e/o il codice a un punto precedente, o riassumi da un messaggio selezionato. Vedi [checkpointing](/it/checkpointing). Alias: `/checkpoint`, `/undo` |

119| `/run` | **[Skill](/it/skills#bundled-skills).** Avvia e guida l'app del tuo progetto per vedere una modifica funzionante nell'app in esecuzione, non solo nei test. Vedi [Esegui e verifica la tua app](/it/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Richiede Claude Code v2.1.145 o successivo |119| `/run` | **[Skill](/it/skills#bundled-skills).** Avvia e guida l'app del tuo progetto per vedere una modifica funzionante nell'app in esecuzione, non solo nei test. Vedi [Esegui e verifica la tua app](/it/skills#run-and-verify-your-app). {/* min-version: 2.1.145 */}Richiede Claude Code v2.1.145 o successivo |

120| `/run-skill-generator` | **[Skill](/it/skills#bundled-skills).** Insegna a `/run` e `/verify` come compilare, avviare e guidare l'app del tuo progetto da un ambiente pulito scrivendo una [skill](/it/skills#run-and-verify-your-app) per progetto. {/* min-version: 2.1.145 */}Richiede Claude Code v2.1.145 o successivo |120| `/run-skill-generator` | **[Skill](/it/skills#bundled-skills).** Insegna a `/run` e `/verify` come compilare, avviare e guidare l'app del tuo progetto da un ambiente pulito scrivendo una [skill](/it/skills#run-and-verify-your-app) per progetto. {/* min-version: 2.1.145 */}Richiede Claude Code v2.1.145 o successivo |

env-vars.md +15 −6

Details

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

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

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

151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica a cui viene attivata la compattazione automatica. Utilizzate valori inferiori come `50` per compattare prima. Questa variabile causa solo una compattazione più precoce quando Claude Code compatta in modo proattivo: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` è impostato, nelle [sessioni cloud](/it/claude-code-on-the-web), nelle sessioni [Remote Control](/it/remote-control) e su Sonnet 4.6 e Opus 4.6 senza [contesto esteso](/it/model-config#extended-context), che compattano al limite di 200K per impostazione predefinita. In altri casi, come una sessione locale su Opus 4.8 o qualsiasi modello con contesto esteso, la compattazione automatica si attiva quando la conversazione raggiunge il limite del contesto del modello. L'override può solo abbassare la soglia, quindi i valori superiori al valore predefinito non hanno effetto. Si applica sia alle conversazioni principali che ai subagent |151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | Imposta la percentuale (1-100) della finestra di compattazione automatica a cui viene attivata la compattazione automatica. Utilizzate valori inferiori come `50` per compattare prima. Questa variabile causa solo una compattazione più precoce quando Claude Code compatta in modo proattivo: quando `CLAUDE_CODE_AUTO_COMPACT_WINDOW` è impostato, nelle [sessioni cloud](/it/claude-code-on-the-web) e su Sonnet 4.6 e Opus 4.6 senza [contesto esteso](/it/model-config#extended-context), che compattano al limite di 200K per impostazione predefinita. In altri casi, come una sessione locale su Opus 4.8 o qualsiasi modello con contesto esteso, la compattazione automatica si attiva quando la conversazione raggiunge il limite del contesto del modello. L'override può solo abbassare la soglia, quindi i valori superiori al valore predefinito non hanno effetto. Si applica sia alle conversazioni principali che ai subagent |

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

153| `CLAUDE_AX_SCREEN_READER` | {/* min-version: 2.1.181 */}Imposta su `1` per renderizzare l'output adatto ai lettori di schermo: testo piatto senza bordi decorativi o animazioni. Imposta su `0` per forzare la disabilitazione della modalità lettore di schermo anche quando [`axScreenReader`](/it/settings#available-settings) è `true`. Il flag [`--ax-screen-reader`](/it/cli-reference#cli-flags) ha la precedenza. Richiede Claude Code v2.1.181 o successivo |

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

155| `CLAUDE_CLIENT_PRESENCE_FILE` | {/* min-version: 2.1.181 */}Percorso a un file che uno strumento esterno, come un listener di blocco dello schermo, crea quando sbloccare lo schermo e cancella quando lo blocca. Mentre il file esiste, Claude Code salta le [notifiche push Remote Control mobile](/it/remote-control#mobile-push-notifications), quindi smettete di ricevere push mentre state utilizzando attivamente il computer. Quando il file è assente o illeggibile, le notifiche vengono inviate normalmente. Claude Code controlla il file una volta per evento di attivazione push piuttosto che eseguire il polling. Richiede Claude Code v2.1.181 o successivo |

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

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

156| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta su `1` per ridisegnare l'intero schermo su ogni frame nel [rendering a schermo intero](/it/fullscreen) invece di inviare aggiornamenti incrementali. Utilizza questo se la modalità a schermo intero mostra frammenti di testo stantii o mal posizionati. Claude Code abilita questo automaticamente per le sessioni in background e la [visualizzazione degli agenti](/it/agent-view) su Windows |158| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | Imposta su `1` per ridisegnare l'intero schermo su ogni frame nel [rendering a schermo intero](/it/fullscreen) invece di inviare aggiornamenti incrementali. Utilizza questo se la modalità a schermo intero mostra frammenti di testo stantii o mal posizionati. Claude Code abilita questo automaticamente per le sessioni in background e la [visualizzazione degli agenti](/it/agent-view) su Windows |

157| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta su `1` per inviare il parametro [effort](/it/model-config#adjust-effort-level) con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come effort-capable. Utilizza questo quando instrada attraverso un [gateway LLM](/it/llm-gateway) o provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all'API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano |159| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Imposta su `1` per inviare il parametro [effort](/it/model-config#adjust-effort-level) con ogni richiesta, anche quando Claude Code non riconosce l'ID del modello come effort-capable. Utilizza questo quando instrada attraverso un [gateway LLM](/it/llm-gateway) o provider di terze parti che serve modelli con identificatori personalizzati. I modelli che rifiutano il parametro effort all'API, inclusi i modelli Claude 3, Sonnet 4.0 e 4.5, Opus 4.0 e 4.1 e Haiku 4.5, sono comunque esclusi in modo che le richieste non falliscano |

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

161| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | Imposta su `0` per impedire a Claude Code di aprire il browser automaticamente quando viene pubblicato un nuovo [artifact](/it/artifacts). La ripubblicazione di un artifact esistente non apre il browser indipendentemente da questa impostazione |

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

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

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


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

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

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

170| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | {/* max-version: 2.1.185 */}Rimosso in v2.1.186 e ora un no-op. In precedenza impostava un timeout separato per la fase di connessione, TLS e intestazione di risposta di una richiesta API di streaming. Utilizza `API_TIMEOUT_MS` per il timeout per richiesta |

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

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

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


171| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}Imposta su `1` per disabilitare lo [strumento advisor](/it/advisor). Il comando `/advisor` e il flag `--advisor` diventano non disponibili e qualsiasi `advisorModel` configurato viene ignorato. Richiede Claude Code v2.1.98 o successivo |175| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}Imposta su `1` per disabilitare lo [strumento advisor](/it/advisor). Il comando `/advisor` e il flag `--advisor` diventano non disponibili e qualsiasi `advisorModel` configurato viene ignorato. Richiede Claude Code v2.1.98 o successivo |

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

173| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che `Cmd+f` e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/it/settings#available-settings). Potete anche passare con `/tui default`. Non si applica alle sessioni in background aperte dalla [visualizzazione degli agenti](/it/agent-view), che utilizzano sempre il rendering a schermo intero |177| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Imposta su `1` per disabilitare il [rendering a schermo intero](/it/fullscreen) e utilizzare il renderer della schermata principale classica. La conversazione rimane nello scrollback nativo del vostro terminale in modo che `Cmd+f` e la modalità di copia di tmux funzionino come al solito. Ha la precedenza su `CLAUDE_CODE_NO_FLICKER` e sull'impostazione [`tui`](/it/settings#available-settings). Potete anche passare con `/tui default`. Non si applica alle sessioni in background aperte dalla [visualizzazione degli agenti](/it/agent-view), che utilizzano sempre il rendering a schermo intero |

178| `CLAUDE_CODE_DISABLE_ARTIFACT` | Imposta su `1` per disabilitare lo strumento [Artifact](/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Equivalente all'impostazione [`disableArtifact`](/it/settings#available-settings) |

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

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

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


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

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

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

210| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione Claude Code. Utilizza quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da un server tmux avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di livello superiore genuina a essere classificata erroneamente come annidata. Anche onorato su v2.1.169 e versioni precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione annidata che sostituisce è stato rimosso |215| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}Imposta su `1` per forzare la persistenza della trascrizione, la cronologia dei prompt e la registrazione di `claude agents` anche quando questo `claude` è stato avviato dall'interno di un'altra sessione Claude Code. Utilizza quando un valore `CLAUDE_CODE_CHILD_SESSION` ereditato, ad esempio da un server tmux avviato per la prima volta dallo strumento Bash di Claude Code, causa una sessione di livello superiore genuina a essere classificata erroneamente come annidata. {/* min-version: 2.1.178 */}A partire da v2.1.178, Claude Code rileva automaticamente il caso tmux e ignora il marcatore ereditato, quindi tmux non ha più bisogno di questa variabile. Anche onorato su v2.1.169 e versioni precedenti; non ha effetto su v2.1.170 e v2.1.171, dove il rilevamento della sessione annidata che sostituisce è stato rimosso |

216| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | {/* min-version: 2.1.186 */}Imposta su `1` per forzare il rendering del barrato per `~~text~~` nelle risposte di Claude quando il vostro terminale lo supporta ma non viene rilevato automaticamente, ad esempio su SSH senza `TERM_PROGRAM` inoltrato. Senza questo, i terminali non rilevati mostrano i marcatori letterali `~~` invece di renderizzare il testo come barrato. Richiede Claude Code v2.1.186 o successivo |

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

212| `CLAUDE_CODE_FORK_SUBAGENT` | Imposta su `1` per consentire a Claude di generare [subagent biforcati](/it/sub-agents#fork-the-current-conversation), o `0` per disabilitarli, sostituendo qualsiasi rollout lato server. Quando abilitato, Claude può richiedere il tipo di subagent `fork` per generare un fork, un subagent che eredita il contesto della conversazione completa invece di iniziare da zero. Gli spawn senza un tipo di subagent utilizzano comunque il subagent di uso generale, e tutti gli spawn di subagent vengono eseguiti in background. Il comando esplicito [`/fork`](/it/commands) funziona senza questa variabile. Funziona in modalità interattiva e tramite SDK o `claude -p` |218| `CLAUDE_CODE_FORK_SUBAGENT` | Imposta su `1` per consentire a Claude di generare [subagent biforcati](/it/sub-agents#fork-the-current-conversation), o `0` per disabilitarli, sostituendo qualsiasi rollout lato server. Quando abilitato, Claude può richiedere il tipo di subagent `fork` per generare un fork, un subagent che eredita il contesto della conversazione completa invece di iniziare da zero. Gli spawn senza un tipo di subagent utilizzano comunque il subagent di uso generale, e tutti gli spawn di subagent vengono eseguiti in background. Il comando esplicito [`/fork`](/it/commands) funziona senza questa variabile. Funziona in modalità interattiva e tramite SDK o `claude -p` |

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


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

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

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

223| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10) |229| `CLAUDE_CODE_MAX_RETRIES` | Sovrascrivi il numero di volte per riprovare le richieste API non riuscite (predefinito: 10). {/* min-version: 2.1.186 */}Limitato a 15 a partire da v2.1.186. Per sessioni non presidiate che devono attendere attraverso interruzioni più lunghe, imposta `CLAUDE_CODE_RETRY_WATCHDOG` |

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

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

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


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

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

233| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Rimosso in v2.1.160 e ora un no-op. In precedenza fissava la [modalità veloce](/it/fast-mode) a Claude Opus 4.6 invece del valore predefinito corrente. Per eseguire la modalità veloce su Opus 4.6 fino al suo ritiro, selezionare prima il modello con `/model`, quindi `/fast on` |239| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | {/* max-version: 2.1.159 */}Rimosso in v2.1.160 e ora un no-op. In precedenza fissava la [modalità veloce](/it/fast-mode) a Claude Opus 4.6 invece del valore predefinito corrente. Per eseguire la modalità veloce su Opus 4.6 fino al suo ritiro, selezionare prima il modello con `/model`, quindi `/fast on` |

240| `CLAUDE_CODE_OTEL_DIAG_STDERR` | {/* min-version: 2.1.179 */}Imposta su `1` per scrivere gli errori diagnostici dell'esportatore OpenTelemetry su stderr. Per impostazione predefinita questi errori appaiono solo con `--debug`, quindi un esportatore non configurato correttamente come una collisione di porta Prometheus altrimenti fallisce silenziosamente. Richiede Claude Code v2.1.179 o successivo. Vedi [Monitoraggio](/it/monitoring-usage) |

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

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

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


242| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le fonti plugin GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |249| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | Imposta su `1` per clonare le fonti plugin GitHub `owner/repo` su HTTPS invece di SSH. Si applica all'installazione e all'aggiornamento dei plugin, e a `/plugin marketplace add` e `update`. Utile nei runner CI, container o in qualsiasi ambiente senza una chiave SSH configurata per `github.com` |

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

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

252| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | {/* min-version: 2.1.182 */}Tempo massimo in millisecondi che la [modalità non interattiva](/it/headless#background-tasks-at-exit) con il flag `-p` attende dopo il turno finale per i subagent in background e i workflow il cui risultato fa parte dell'output. Predefinito: `600000`, o 10 minuti. Quando il limite viene superato, i subagent in background rimanenti vengono terminati e il processo esce. Imposta su `0` per attendere indefinitamente. Questo limite è separato dal periodo di grazia di cinque secondi che si applica ai semplici shell in background |

245| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Imposta su `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'intestazione `traceparent` su richieste di modello e MCP HTTP e la variabile d'ambiente `TRACEPARENT` per sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all'API Anthropic. Aggiunto in v2.1.152. Vedi [Tracce (beta)](/it/monitoring-usage#traces-beta) |253| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | {/* min-version: 2.1.152 */}Imposta su `1` per propagare il contesto di traccia W3C quando `ANTHROPIC_BASE_URL` punta a un proxy personalizzato. La propagazione copre l'intestazione `traceparent` su richieste di modello e MCP HTTP e la variabile d'ambiente `TRACEPARENT` per sottoprocessi Bash, PowerShell e hook. Per impostazione predefinita, la propagazione è abilitata solo quando connessi direttamente all'API Anthropic. Aggiunto in v2.1.152. Vedi [Tracce (beta)](/it/monitoring-usage#traces-beta) |

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

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

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

249| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/it/claude-code-on-the-web) all'ID della sessione corrente. Leggete questo per costruire un collegamento alla trascrizione della sessione. Vedi [Collegare gli artefatti alla sessione](/it/claude-code-on-the-web#link-artifacts-back-to-the-session) |257| `CLAUDE_CODE_REMOTE_SESSION_ID` | Impostato automaticamente nelle [sessioni cloud](/it/claude-code-on-the-web) all'ID della sessione corrente. Leggete questo per costruire un collegamento alla trascrizione della sessione. Vedi [Collegare l'output alla sessione](/it/claude-code-on-the-web#link-output-back-to-the-session) |

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

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

260| `CLAUDE_CODE_RETRY_WATCHDOG` | {/* min-version: 2.1.186 */}Imposta su `1` per sessioni non presidiate come harness di valutazione, lavori CI o worker remoti. Ritenta gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. Il watchdog si ritira fino a 5 minuti tra i tentativi, o fino a quando il limite si ripristina quando la risposta porta un tempo di ripristino del limite di velocità, quindi una sessione che raggiunge un limite di utilizzo attende la finestra rimanente. Richiede Claude Code v2.1.186 o successivo |

252| `CLAUDE_CODE_SAFE_MODE` | Imposta su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi hook, linea di stato e comandi dei suggerimenti di file configurati dalla politica; plugin gestiti, skill gestite, CLAUDE.md gestito e server MCP configurati dalla politica non lo fanno. Equivalente a passare [`--safe-mode`](/it/cli-reference#cli-flags). I processi figlio direttamente generati ereditano la variabile |261| `CLAUDE_CODE_SAFE_MODE` | Imposta su `1` per avviare in modalità sicura: CLAUDE.md, skill, plugin, hook, server MCP, comandi personalizzati e agenti, stili di output, workflow, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della linea di stato e dei suggerimenti di file, server LSP e memoria automatica non vengono caricati, per la risoluzione dei problemi di una configurazione interrotta. La politica delle impostazioni gestite si applica comunque, inclusi hook, linea di stato e comandi dei suggerimenti di file configurati dalla politica; plugin gestiti, skill gestite, CLAUDE.md gestito e server MCP configurati dalla politica non lo fanno. Equivalente a passare [`--safe-mode`](/it/cli-reference#cli-flags). I processi figlio direttamente generati ereditano la variabile |

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

254| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/it/fullscreen#mouse-wheel-scrolling). Accetta valori da 1 a 20 e valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato del trackpad e della rotella nei terminali che già amplificano gli eventi della rotella. Imposta su `3` per corrispondere a `vim` se il vostro terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento |263| `CLAUDE_CODE_SCROLL_SPEED` | Imposta il moltiplicatore di scorrimento della rotella del mouse nel [rendering a schermo intero](/it/fullscreen#mouse-wheel-scrolling). Accetta valori da 1 a 20 e valori frazionari inferiori a 1 come `0.5` per rallentare lo scorrimento accelerato del trackpad e della rotella nei terminali che già amplificano gli eventi della rotella. Imposta su `3` per corrispondere a `vim` se il vostro terminale invia un evento di rotella per tacca senza amplificazione. Ignorato nel terminale IDE JetBrains, dove Claude Code utilizza il proprio gestore di scorrimento |


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

317| `DISABLE_UPGRADE_COMMAND` | Imposta su `1` per nascondere il comando `/upgrade` |326| `DISABLE_UPGRADE_COMMAND` | Imposta su `1` per nascondere il comando `/upgrade` |

318| `DO_NOT_TRACK` | Imposta su `1` per rinunciare alla telemetria. Equivalente all'impostazione di `DISABLE_TELEMETRY`. Claude Code onora questa come la convenzione standard tra strumenti riconosciuta da molti CLI per sviluppatori |327| `DO_NOT_TRACK` | Imposta su `1` per rinunciare alla telemetria. Equivalente all'impostazione di `DISABLE_TELEMETRY`. Claude Code onora questa come la convenzione standard tra strumenti riconosciuta da molti CLI per sviluppatori |

319| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta su `false` per disabilitare i [server MCP claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi |328| `ENABLE_CLAUDEAI_MCP_SERVERS` | Imposta su `false` per disabilitare i [server MCP claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) in Claude Code. Abilitato per impostazione predefinita per gli utenti connessi. Per disabilitare per progetto o per organizzazione, imposta [`disableClaudeAiConnectors`](/it/settings#available-settings) nelle impostazioni |

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

321| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecato. Utilizza `ENABLE_PROMPT_CACHING_1H` invece |330| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | Deprecato. Utilizza `ENABLE_PROMPT_CACHING_1H` invece |

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


340| `NO_PROXY` | Elenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy |349| `NO_PROXY` | Elenco di domini e IP a cui le richieste verranno emesse direttamente, bypassando il proxy |

341| `OTEL_LOG_RAW_API_BODIES` | Emetti il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Imposta su `1` per i corpi inline troncati a 60 KB, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref` invece. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Vedi [Monitoraggio](/it/monitoring-usage#api-request-body-event) |350| `OTEL_LOG_RAW_API_BODIES` | Emetti il JSON della richiesta e della risposta dell'API Anthropic Messages come eventi di log `api_request_body` / `api_response_body`. Imposta su `1` per i corpi inline troncati a 60 KB, o `file:<dir>` per scrivere i corpi non troncati su disco ed emettere un percorso `body_ref` invece. Disabilitato per impostazione predefinita; i corpi includono l'intera cronologia della conversazione. Vedi [Monitoraggio](/it/monitoring-usage#api-request-body-event) |

342| `OTEL_LOG_TOOL_CONTENT` | Imposta su `1` per includere il contenuto di input e output dello strumento negli eventi span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedi [Monitoraggio](/it/monitoring-usage) |351| `OTEL_LOG_TOOL_CONTENT` | Imposta su `1` per includere il contenuto di input e output dello strumento negli eventi span OpenTelemetry. Disabilitato per impostazione predefinita per proteggere i dati sensibili. Vedi [Monitoraggio](/it/monitoring-usage) |

343| `OTEL_LOG_TOOL_DETAILS` | Imposta su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, le stringhe di errore non elaborate sui fallimenti degli strumenti e altri dettagli degli strumenti nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le informazioni personali. Vedi [Monitoraggio](/it/monitoring-usage) |352| `OTEL_LOG_TOOL_DETAILS` | Imposta su `1` per includere gli argomenti di input dello strumento, i nomi dei server MCP, le stringhe di errore non elaborate sui fallimenti degli strumenti, la categoria di rifiuto su eventi `api_refusal` e altri dettagli degli strumenti nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita per proteggere le informazioni personali. Vedi [Monitoraggio](/it/monitoring-usage) |

344| `OTEL_LOG_USER_PROMPTS` | Imposta su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedi [Monitoraggio](/it/monitoring-usage) |353| `OTEL_LOG_USER_PROMPTS` | Imposta su `1` per includere il testo del prompt dell'utente nelle tracce e nei log OpenTelemetry. Disabilitato per impostazione predefinita (i prompt vengono redatti). Vedi [Monitoraggio](/it/monitoring-usage) |

345| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedi [Monitoraggio](/it/monitoring-usage) |354| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | Imposta su `false` per escludere l'UUID dell'account dagli attributi delle metriche (predefinito: incluso). Vedi [Monitoraggio](/it/monitoring-usage) |

346| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Imposta su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto in v2.1.152. Vedi [Monitoraggio](/it/monitoring-usage) |355| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | {/* min-version: 2.1.152 */}Imposta su `true` per includere il punto di ingresso della sessione negli attributi delle metriche (predefinito: escluso). Aggiunto in v2.1.152. Vedi [Monitoraggio](/it/monitoring-usage) |

errors.md +7 −3

Details

43| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |43| `OAuth token revoked` / `OAuth token has expired` | [Autenticazione](#oauth-token-revoked-or-expired) |

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

45| `Unable to connect to API` | [Rete](#unable-to-connect-to-api) |45| `Unable to connect to API` | [Rete](#unable-to-connect-to-api) |

46| `Waiting for API response · will retry in` | [Tentativi automatici](#automatic-retries), o [Rete](#unable-to-connect-to-api) se persiste |

46| `SSL certificate verification failed` | [Rete](#ssl-certificate-errors) |47| `SSL certificate verification failed` | [Rete](#ssl-certificate-errors) |

47| `403` con `x-deny-reason: host_not_allowed` in una sessione cloud o routine | [Rete](#host-not-allowed-in-a-cloud-session) |48| `403` con `x-deny-reason: host_not_allowed` in una sessione cloud o routine | [Rete](#host-not-allowed-in-a-cloud-session) |

48| `Prompt is too long` | [Errori di richiesta](#prompt-is-too-long) |49| `Prompt is too long` | [Errori di richiesta](#prompt-is-too-long) |


66 67 

67Claude Code ritenta i guasti transitori prima di mostrarti un errore. Gli errori del server, le risposte sovraccariche, i timeout delle richieste, i throttle 429 temporanei e le connessioni interrotte vengono tutti ritentati fino a 10 volte con backoff esponenziale. Durante il tentativo, lo spinner mostra un countdown `Retrying in Ns · attempt x/y`.68Claude Code ritenta i guasti transitori prima di mostrarti un errore. Gli errori del server, le risposte sovraccariche, i timeout delle richieste, i throttle 429 temporanei e le connessioni interrotte vengono tutti ritentati fino a 10 volte con backoff esponenziale. Durante il tentativo, lo spinner mostra un countdown `Retrying in Ns · attempt x/y`.

68 69 

69Quando vedi uno degli errori in questa pagina, quei tentativi sono già stati esauriti. Puoi regolare il comportamento con due variabili di ambiente:70{/* min-version: 2.1.185 */}Se nessun dato arriva sul flusso di risposta per 20 secondi mentre una richiesta è ancora in sospeso, lo spinner mostra `Waiting for API response · will retry in … · check your network` prima che qualsiasi tentativo sia iniziato. La richiesta non è ancora fallita: il countdown viene eseguito fino al punto in cui Claude Code interrompe la connessione bloccata e ritenta, quindi il banner si cancella da solo una volta che i dati riprendono o il tentativo ha successo. A partire da v2.1.185 la soglia è di 20 secondi; le versioni precedenti mostrano il banner dopo 10 secondi con una formulazione diversa. Se riappare ad ogni tentativo, trattalo come un [problema di rete](#unable-to-connect-to-api).

71 

72Quando vedi uno degli errori in questa pagina, quei tentativi sono già stati esauriti. Puoi regolare il comportamento con queste variabili di ambiente:

70 73 

71| Variabile | Predefinito | Effetto |74| Variabile | Predefinito | Effetto |

72| :---------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |75| :------------------------------------------- | :------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

73| [`CLAUDE_CODE_MAX_RETRIES`](/it/env-vars) | 10 | Numero di tentativi di ripetizione. Abbassalo per far emergere i guasti più velocemente negli script; aumentalo per attendere attraverso incidenti più lunghi. |76| [`CLAUDE_CODE_MAX_RETRIES`](/it/env-vars) | 10 | Numero di tentativi di ripetizione. {/* min-version: 2.1.186 */}Limitato a 15 a partire da v2.1.186. Abbassalo per far emergere i guasti più velocemente negli script. |

77| [`CLAUDE_CODE_RETRY_WATCHDOG`](/it/env-vars) | non impostato | Impostalo su `1` in sessioni incustodite come i job CI per ritentare gli errori di capacità `429` e `529` indefinitamente invece di fallire dopo i tentativi di `CLAUDE_CODE_MAX_RETRIES`. |

74| [`API_TIMEOUT_MS`](/it/env-vars) | 600000 | Timeout per richiesta in millisecondi. Aumentalo per reti lente o proxy. |78| [`API_TIMEOUT_MS`](/it/env-vars) | 600000 | Timeout per richiesta in millisecondi. Aumentalo per reti lente o proxy. |

75 79 

76<h2 id="server-errors">80<h2 id="server-errors">

Details

38Le funzionalità vanno dal contesto sempre attivo che Claude vede in ogni sessione, alle capacità su richiesta che voi o Claude potete invocare, all'automazione in background che viene eseguita su eventi specifici. La tabella seguente mostra ciò che è disponibile e quando ogni funzionalità ha senso.38Le funzionalità vanno dal contesto sempre attivo che Claude vede in ogni sessione, alle capacità su richiesta che voi o Claude potete invocare, all'automazione in background che viene eseguita su eventi specifici. La tabella seguente mostra ciò che è disponibile e quando ogni funzionalità ha senso.

39 39 

40| Funzionalità | Cosa fa | Quando utilizzarla | Esempio |40| Funzionalità | Cosa fa | Quando utilizzarla | Esempio |

41| -------------------------------------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |41| -------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |

42| **CLAUDE.md** | Contesto persistente caricato in ogni conversazione | Convenzioni del progetto, regole "fai sempre X" | "Usa pnpm, non npm. Esegui i test prima di fare il commit." |42| **CLAUDE.md** | Contesto persistente caricato in ogni conversazione | Convenzioni del progetto, regole "fai sempre X" | "Usa pnpm, non npm. Esegui i test prima di fare il commit." |

43| **Skill** | Istruzioni, conoscenze e flussi di lavoro che Claude può utilizzare | Contenuto riutilizzabile, documenti di riferimento, compiti ripetibili | `/deploy` esegue la vostra checklist di distribuzione; skill di documentazione API con pattern di endpoint |43| **Skill** | Istruzioni, conoscenze e flussi di lavoro che Claude può utilizzare | Contenuto riutilizzabile, documenti di riferimento, compiti ripetibili | `/deploy` esegue la vostra checklist di distribuzione; skill di documentazione API con pattern di endpoint |

44| **Subagent** | Contesto di esecuzione isolato che restituisce risultati riassunti | Isolamento del contesto, compiti paralleli, worker specializzati | Compito di ricerca che legge molti file ma restituisce solo i risultati chiave |44| **Subagent** | Contesto di esecuzione isolato che restituisce risultati riassunti | Isolamento del contesto, compiti paralleli, worker specializzati | Compito di ricerca che legge molti file ma restituisce solo i risultati chiave |


46| **[Code intelligence](/it/tools-reference#lsp-tool-behavior)** | Navigazione e diagnostica del language server | Linguaggi tipizzati, grandi basi di codice dove grep è lento o impreciso | Saltare alla definizione di un simbolo invece di leggere l'intero file |46| **[Code intelligence](/it/tools-reference#lsp-tool-behavior)** | Navigazione e diagnostica del language server | Linguaggi tipizzati, grandi basi di codice dove grep è lento o impreciso | Saltare alla definizione di un simbolo invece di leggere l'intero file |

47| **MCP** | Collegamento a servizi esterni | Dati o azioni esterne | Interrogare il vostro database, inviare a Slack, controllare un browser |47| **MCP** | Collegamento a servizi esterni | Dati o azioni esterne | Interrogare il vostro database, inviare a Slack, controllare un browser |

48| **Hook** | Script, richiesta HTTP, prompt o subagent attivati da eventi | Automazione che deve essere eseguita su ogni evento corrispondente | Eseguire ESLint dopo ogni modifica di file |48| **Hook** | Script, richiesta HTTP, prompt o subagent attivati da eventi | Automazione che deve essere eseguita su ogni evento corrispondente | Eseguire ESLint dopo ogni modifica di file |

49| **[Artifact](/it/artifacts)** | Pubblicare l'output della sessione come pagina web privata e interattiva | Output che desiderate vedere o condividere visivamente piuttosto che come testo di terminale | Una timeline di incidente che si aggiorna mentre Claude indaga |

49 50 

50**[Plugins](/it/plugins)** sono il livello di confezionamento. Un plugin raggruppa skills, hooks, subagents e server MCP in una singola unità installabile. Le skills dei plugin hanno uno spazio dei nomi (come `/my-plugin:review`) in modo che più plugin possano coesistere. Utilizzate i plugin quando desiderate riutilizzare la stessa configurazione su più repository o distribuire ad altri tramite un **[marketplace](/it/plugin-marketplaces)**.51**[Plugins](/it/plugins)** sono il livello di confezionamento. Un plugin raggruppa skills, hooks, subagents e server MCP in una singola unità installabile. Le skills dei plugin hanno uno spazio dei nomi (come `/my-plugin:review`) in modo che più plugin possano coesistere. Utilizzate i plugin quando desiderate riutilizzare la stessa configurazione su più repository o distribuire ad altri tramite un **[marketplace](/it/plugin-marketplaces)**.

51 52 

fullscreen.md +2 −2

Details

44| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |44| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

45| `Cmd+f` o ricerca tmux per trovare testo | `Ctrl+o` per la modalità trascrizione, quindi `/` per cercare o `[` per scrivere nello scrollback | [Cerca e rivedi la conversazione](#search-and-review-the-conversation) |45| `Cmd+f` o ricerca tmux per trovare testo | `Ctrl+o` per la modalità trascrizione, quindi `/` per cercare o `[` per scrivere nello scrollback | [Cerca e rivedi la conversazione](#search-and-review-the-conversation) |

46| Clic e trascinamento nativo del terminale per selezionare e copiare | Selezione in-app, copia automatica al rilascio del mouse | [Usa il mouse](#use-the-mouse) |46| Clic e trascinamento nativo del terminale per selezionare e copiare | Selezione in-app, copia automatica al rilascio del mouse | [Usa il mouse](#use-the-mouse) |

47| `Cmd`-clic per aprire un URL | Fai clic sull'URL | [Usa il mouse](#use-the-mouse) |47| `Cmd`-clic per aprire un URL | `Cmd`-clic su macOS, `Ctrl`-clic altrove | [Usa il mouse](#use-the-mouse) |

48 48 

49Se l'acquisizione del mouse interferisce con il tuo flusso di lavoro, puoi [disattivarla](#keep-native-text-selection) mantenendo il rendering senza sfarfallio.49Se l'acquisizione del mouse interferisce con il tuo flusso di lavoro, puoi [disattivarla](#keep-native-text-selection) mantenendo il rendering senza sfarfallio.

50 50 


57* **Fai clic nella casella di input del prompt** per posizionare il cursore in qualsiasi punto del testo che stai digitando.57* **Fai clic nella casella di input del prompt** per posizionare il cursore in qualsiasi punto del testo che stai digitando.

58* **Fai clic su un suggerimento nel comando `/` o nell'elenco di file `@`** per accettarlo. Passare il mouse evidenzia la riga sotto il cursore.58* **Fai clic su un suggerimento nel comando `/` o nell'elenco di file `@`** per accettarlo. Passare il mouse evidenzia la riga sotto il cursore.

59* **Fai clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fai clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.59* **Fai clic su un risultato dello strumento compresso** per espanderlo e vedere l'output completo. Fai clic di nuovo per comprimerlo. La chiamata dello strumento e il suo risultato si espandono insieme. Solo i messaggi che hanno più da mostrare sono cliccabili.

60* **Fai clic su un URL o un percorso di file** per aprirlo. I percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Gli URL `http://` e `https://` semplici si aprono nel browser. Nella maggior parte dei terminali questo sostituisce il `Cmd`-clic o il `Ctrl`-clic nativo, che l'acquisizione del mouse intercetta. Nel terminale integrato di VS Code e nei terminali basati su xterm.js simili, continua a usare `Cmd`-clic. Claude Code si rimette al gestore di link del terminale per evitare di aprire i link due volte.60* **Tieni premuto `Cmd` su macOS, o `Ctrl` su Linux e Windows, e fai clic su un URL o un percorso di file** per aprirlo. I percorsi di file nell'output dello strumento, come quelli stampati dopo un Edit o Write, si aprono nell'applicazione predefinita. Gli URL `http://` e `https://` semplici si aprono nel browser. A partire dalla v2.1.181, un semplice clic senza tenere premuto `Cmd` o `Ctrl` non apre più i link, corrispondendo al comportamento del terminale nativo. Nel terminale integrato di VS Code e nei terminali basati su xterm.js simili, Claude Code si rimette al gestore di link del terminale, che utilizza lo stesso gesto.

61* **Fai clic e trascinamento** per selezionare il testo in qualsiasi punto della conversazione. Il doppio clic seleziona una parola, corrispondendo ai confini delle parole di iTerm2 in modo che un percorso di file si selezioni come un'unità. Il triplo clic seleziona la riga.61* **Fai clic e trascinamento** per selezionare il testo in qualsiasi punto della conversazione. Il doppio clic seleziona una parola, corrispondendo ai confini delle parole di iTerm2 in modo che un percorso di file si selezioni come un'unità. Il triplo clic seleziona la riga.

62* **Scorri con la rotella del mouse** per muoverti attraverso la conversazione.62* **Scorri con la rotella del mouse** per muoverti attraverso la conversazione.

63 63 

glossary.md +8 −0

Details

44 44 

45Scopri di più: [How Claude Code works](/it/how-claude-code-works#the-agentic-loop)45Scopri di più: [How Claude Code works](/it/how-claude-code-works#the-agentic-loop)

46 46 

47<h3 id="artifact">

48 Artifact

49</h3>

50 

51Una pagina web live e interattiva che Claude Code pubblica dalla tua sessione a un URL privato su claude.ai, così puoi vedere l'output visivamente o condividerlo all'interno della tua organizzazione invece di leggere il testo del terminale. La pagina si aggiorna sul posto quando la sessione viene ripubblicata. Gli artifact che crei da Claude Code appaiono nella stessa galleria degli artifact creati nelle conversazioni di claude.ai, ma la loro condivisione si ferma alla tua organizzazione e non possono essere resi pubblici.

52 

53Scopri di più: [Share session output as artifacts](/it/artifacts)

54 

47<h3 id="auto-memory">55<h3 id="auto-memory">

48 Auto memory56 Auto memory

49</h3>57</h3>

headless.md +3 −1

Details

68 68 

69Se Claude avvia un'[attività Bash in background](/it/tools-reference#bash-tool-behavior) durante un'esecuzione di `claude -p`, ad esempio un server di sviluppo o una build di watch, tale attività viene terminata circa cinque secondi dopo che Claude ha restituito il suo risultato finale e stdin è stato chiuso. Il periodo di grazia consente a un'attività che termina subito dopo il risultato di consegnare comunque il suo output. Prima della v2.1.163, un processo in background che non termina mai avrebbe mantenuto l'invocazione di `claude -p` aperta indefinitamente.69Se Claude avvia un'[attività Bash in background](/it/tools-reference#bash-tool-behavior) durante un'esecuzione di `claude -p`, ad esempio un server di sviluppo o una build di watch, tale attività viene terminata circa cinque secondi dopo che Claude ha restituito il suo risultato finale e stdin è stato chiuso. Il periodo di grazia consente a un'attività che termina subito dopo il risultato di consegnare comunque il suo output. Prima della v2.1.163, un processo in background che non termina mai avrebbe mantenuto l'invocazione di `claude -p` aperta indefinitamente.

70 70 

71I [subagenti](/it/sub-agents) in background e i flussi di lavoro sono esenti dal periodo di grazia di cinque secondi perché il loro risultato fa parte dell'output finale, quindi `claude -p` attende il loro completamento. A partire dalla v2.1.182, tale attesa è limitata a dieci minuti per impostazione predefinita in modo che un agente in background bloccato non possa mantenere il processo aperto indefinitamente. Regola il limite con [`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`](/it/env-vars), oppure impostalo su `0` per attendere senza limite.

72 

71<h2 id="examples">73<h2 id="examples">

72 Esempi74 Esempi

73</h2>75</h2>


232Il flag `--allowedTools` utilizza la [sintassi delle regole di autorizzazione](/it/settings#permission-rule-syntax). Lo spazio finale ` *` abilita la corrispondenza dei prefissi, quindi `Bash(git diff *)` consente qualsiasi comando che inizia con `git diff`. Lo spazio prima di `*` è importante: senza di esso, `Bash(git diff*)` corrisponderebbe anche a `git diff-index`.234Il flag `--allowedTools` utilizza la [sintassi delle regole di autorizzazione](/it/settings#permission-rule-syntax). Lo spazio finale ` *` abilita la corrispondenza dei prefissi, quindi `Bash(git diff *)` consente qualsiasi comando che inizia con `git diff`. Lo spazio prima di `*` è importante: senza di esso, `Bash(git diff*)` corrisponderebbe anche a `git diff-index`.

233 235 

234<Note>236<Note>

235 Le skills richiamate dall'utente e i comandi personalizzati funzionano in modalità `-p`: includi `/skill-name` nella stringa del prompt e Claude Code lo espande prima di eseguire. I comandi incorporati che aprono una finestra di dialogo interattiva, come `/config` e `/login`, non sono disponibili in modalità `-p`.237 Le skills richiamate dall'utente e i comandi personalizzati funzionano in modalità `-p`: includi `/skill-name` nella stringa del prompt e Claude Code lo espande prima di eseguire. I comandi incorporati che aprono una finestra di dialogo interattiva, come `/login`, non sono disponibili in modalità `-p`. {/* min-version: 2.1.181 */}Per modificare un'impostazione da un'invocazione `-p`, passa `key=value` a `/config`, ad esempio `/config thinking=false`.

236</Note>238</Note>

237 239 

238<h3 id="customize-the-system-prompt">240<h3 id="customize-the-system-prompt">

Details

326* Esci con `Escape`, `Backspace` o `Ctrl+U` su un prompt vuoto326* Esci con `Escape`, `Backspace` o `Ctrl+U` su un prompt vuoto

327* Incollare il testo che inizia con `!` in un prompt vuoto entra automaticamente in modalità shell, corrispondendo al comportamento digitato `!`327* Incollare il testo che inizia con `!` in un prompt vuoto entra automaticamente in modalità shell, corrispondendo al comportamento digitato `!`

328 328 

329A partire dalla v2.1.186, Claude risponde automaticamente all'output del comando una volta che arriva nella trascrizione, quindi potete eseguire `! npm test` e ottenere una spiegazione degli errori senza un secondo prompt. La risposta costa lo stesso dell'invio di un prompt normale. Per ripristinare il comportamento precedente in cui l'output viene aggiunto al contesto senza una risposta, impostare [`respondToBashCommands`](/it/settings#available-settings) su `false` in `settings.json`. Prima della v2.1.186, la modalità shell aggiungeva sempre l'output al contesto senza una risposta.

330 

329Questo è utile per le operazioni shell rapide mantenendo il contesto della conversazione.331Questo è utile per le operazioni shell rapide mantenendo il contesto della conversazione.

330 332 

331<h2 id="prompt-suggestions">333<h2 id="prompt-suggestions">

keybindings.md +5 −4

Details

347 Azioni delle impostazioni347 Azioni delle impostazioni

348</h3>348</h3>

349 349 

350Azioni disponibili nel contesto `Settings`:350Azioni disponibili nel contesto `Settings`. Le azioni `select:accept` e `confirm:no` vengono riutilizzate dai contesti [Select](#select-actions) e [Confirmation](#confirmation-actions) con comportamento specifico delle impostazioni: le modifiche si applicano a ogni impostazione non appena la modifichi, quindi Escape chiude il pannello con le modifiche salvate piuttosto che rifiutarle.

351 351 

352| Azione | Predefinito | Descrizione |352| Azione | Predefinito | Descrizione |

353| :---------------- | :---------- | :--------------------------------------------------------------------------------------------- |353| :---------------- | :------------ | :---------------------------------------------------------- |

354| `settings:search` | / | Entra in modalità di ricerca |354| `settings:search` | / | Entra in modalità di ricerca |

355| `settings:retry` | R | Riprova a caricare i dati di utilizzo (in caso di errore) |355| `settings:retry` | R | Riprova a caricare i dati di utilizzo in caso di errore |

356| `settings:close` | Invio | Salva le modifiche e chiudi il pannello di configurazione. Escape scarta le modifiche e chiude |356| `select:accept` | Invio, Spazio | Modifica l'impostazione selezionata o apri il suo sottomenu |

357| `confirm:no` | Escape | Chiudi il pannello. Le modifiche sono già salvate |

357 358 

358<h3 id="doctor-actions">359<h3 id="doctor-actions">

359 Azioni del Doctor360 Azioni del Doctor

managed-mcp.md +8 −1

Details

161| `deniedMcpServers` | Nessun server bloccato | Nessun server bloccato | Server corrispondenti bloccati |161| `deniedMcpServers` | Nessun server bloccato | Nessun server bloccato | Server corrispondenti bloccati |

162 162 

163<Warning>163<Warning>

164 Un allowlist che utilizza solo voci `serverName` non è un controllo di sicurezza. Il nome è l'etichetta che un utente assegna quando esegue `claude mcp add` o modifica un file di configurazione, non il server sottostante, quindi un utente può chiamare qualsiasi server `github`. Per applicare quali server vengono effettivamente eseguiti, aggiungete voci `serverCommand` o `serverUrl`.164 Una voce `serverName`, in entrambi gli elenchi, non è un controllo di sicurezza. Il nome è l'etichetta che un utente assegna quando esegue `claude mcp add` o modifica un file di configurazione, non il server sottostante, quindi un utente può chiamare qualsiasi server `github`. Per i connettori claude.ai il nome è il nome visualizzato restituito da claude.ai, che può cambiare. Per applicare quali server vengono effettivamente eseguiti, aggiungete voci `serverCommand` o `serverUrl`.

165</Warning>165</Warning>

166 166 

167La validazione di `serverName` differisce tra i due elenchi:

168 

169* {/* min-version: 2.1.182 */}In `deniedMcpServers`, `serverName` accetta qualsiasi stringa non vuota, quindi potete bloccare i [connettori claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) per il loro nome visualizzato. Ad esempio, `{ "serverName": "claude.ai Slack" }` blocca il connettore Slack. Preferite una voce `serverUrl` quando avete bisogno che il blocco sia robusto rispetto ai cambi di nome, o quando un nome di connettore collide e guadagna un suffisso ` (N)`.

170* In `allowedMcpServers`, `serverName` è limitato a lettere, numeri, trattini e sottolineature. Utilizzate `serverUrl` per aggiungere un connettore claude.ai all'allowlist.

171 

172Per disattivare tutti i connettori claude.ai, vedere [`disableClaudeAiConnectors`](/it/mcp#disable-claude-ai-connectors).

173 

167<h3 id="how-a-server-is-evaluated">174<h3 id="how-a-server-is-evaluated">

168 Come viene valutato un server175 Come viene valutato un server

169</h3>176</h3>

mcp.md +39 −1

Details

554 * L'autenticazione OAuth funziona con i server HTTP554 * L'autenticazione OAuth funziona con i server HTTP

555</Tip>555</Tip>

556 556 

557<h3 id="authenticate-from-the-command-line">

558 Autenticazione dalla riga di comando

559</h3>

560 

561Da v2.1.186, `claude mcp login <name>` esegue il flusso OAuth di un server configurato direttamente dalla tua shell, quindi non è necessario aprire il pannello `/mcp` all'interno di una sessione.

562 

563```bash theme={null}

564claude mcp login sentry

565```

566 

567Per cancellare le credenziali archiviate in seguito, esegui `claude mcp logout <name>`.

568 

569Quando sei connesso tramite SSH, aggiungi `--no-browser` in modo che il comando stampi l'URL di autorizzazione invece di aprire un browser. Apri l'URL sulla tua macchina locale, quindi incolla l'URL di reindirizzamento completo dalla barra degli indirizzi del tuo browser al prompt. Il comando ha bisogno di un terminale interattivo per il passaggio di incollamento, quindi connettiti con `ssh -t`.

570 

571```bash theme={null}

572claude mcp login sentry --no-browser

573```

574 

557<h3 id="use-a-fixed-oauth-callback-port">575<h3 id="use-a-fixed-oauth-callback-port">

558 Utilizza una porta di callback OAuth fissa576 Utilizza una porta di callback OAuth fissa

559</h3>577</h3>


852 870 

853Alcuni connettori ospitati da Anthropic, come Microsoft 365, Gmail e Google Calendar, non supportano OAuth locale da Claude Code perché il provider di identità upstream accetta solo l'URL di reindirizzamento registrato da claude.ai. A partire dalla v2.1.162, l'autenticazione di uno di questi host in `/mcp` mostra un messaggio che ti indirizza a collegarlo in Impostazioni → Connettori su claude.ai. Una volta collegato lì, il connettore appare in Claude Code automaticamente.871Alcuni connettori ospitati da Anthropic, come Microsoft 365, Gmail e Google Calendar, non supportano OAuth locale da Claude Code perché il provider di identità upstream accetta solo l'URL di reindirizzamento registrato da claude.ai. A partire dalla v2.1.162, l'autenticazione di uno di questi host in `/mcp` mostra un messaggio che ti indirizza a collegarlo in Impostazioni → Connettori su claude.ai. Una volta collegato lì, il connettore appare in Claude Code automaticamente.

854 872 

855Per disabilitare i server MCP di claude.ai in Claude Code, imposta la variabile di ambiente `ENABLE_CLAUDEAI_MCP_SERVERS` su `false`:873<h3 id="disable-claude-ai-connectors">

874 Disabilita connettori claude.ai

875</h3>

876 

877Per disabilitare i server MCP di claude.ai in Claude Code, imposta [`disableClaudeAiConnectors`](/it/settings#available-settings) su `true` in qualsiasi ambito di impostazioni:

878 

879```json theme={null}

880{

881 "disableClaudeAiConnectors": true

882}

883```

884 

885Questa impostazione utilizza la semantica any-source-true: `true` in qualsiasi fonte di impostazioni ha la precedenza. Un file `.claude/settings.json` del progetto archiviato può escludere un repository dai connettori cloud, ma un `false` a livello di progetto non può riabilitare i connettori che un `true` a livello di utente o di policy ha disabilitato. I server passati esplicitamente tramite `--mcp-config` non sono interessati.

886 

887Puoi anche impostare la variabile di ambiente `ENABLE_CLAUDEAI_MCP_SERVERS` su `false`, che ha lo stesso effetto per la sessione shell corrente:

856 888 

857```bash theme={null}889```bash theme={null}

858ENABLE_CLAUDEAI_MCP_SERVERS=false claude890ENABLE_CLAUDEAI_MCP_SERVERS=false claude

859```891```

860 892 

893Per bloccare singoli connettori claude.ai invece di tutti, aggiungili a [`deniedMcpServers`](/it/managed-mcp) per nome o per modello di URL. Ad esempio, una voce `serverName` di `"claude.ai Slack"` blocca il connettore Slack. Per attivare o disattivare un connettore solo per il progetto corrente, utilizza il pannello `/mcp`.

894 

895<Note>

896 Queste impostazioni lato client governano le sessioni locali di Claude Code. Nelle sessioni di [Claude Code sul web](/it/claude-code-on-the-web), i connettori claude.ai sono forniti dall'host remoto e arrivano come voci esplicite `--mcp-config`, quindi `disableClaudeAiConnectors` non si applica lì. Gli URL dei connettori vengono anche riscritti attraverso il proxy della sessione, quindi un modello `serverUrl` di `deniedMcpServers` che punta all'URL del fornitore non corrisponderà. Gestisci quali connettori una sessione cloud può utilizzare dalle impostazioni dell'organizzazione claude.ai.

897</Note>

898 

861<h2 id="use-claude-code-as-an-mcp-server">899<h2 id="use-claude-code-as-an-mcp-server">

862 Utilizza Claude Code come server MCP900 Utilizza Claude Code come server MCP

863</h2>901</h2>

Details

61 Il server appare con un indicatore di stato:61 Il server appare con un indicatore di stato:

62 62 

63 | Stato | Significato |63 | Stato | Significato |

64 | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |64 | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

65 | `✓ Connected` | Pronto all'uso. Questo è quello che dovreste vedere per `claude-code-docs` |65 | `✓ Connected` | Pronto all'uso. Questo è quello che dovreste vedere per `claude-code-docs` |

66 | `! Connected · tools fetch failed` | Il server si è connesso ma non ha potuto elencare i suoi strumenti. Eseguire `claude mcp get <name>` per il dettaglio dell'errore |

66 | `! Needs authentication` | Il server è raggiungibile ma necessita un accesso al browser, o un token passato con `--header`. Vedere [Connettere un server che richiede l'accesso](#connect-a-server-that-requires-sign-in) |67 | `! Needs authentication` | Il server è raggiungibile ma necessita un accesso al browser, o un token passato con `--header`. Vedere [Connettere un server che richiede l'accesso](#connect-a-server-that-requires-sign-in) |

67 | `✗ Failed to connect` | Il server non ha risposto. Vedere [Risoluzione dei problemi](#troubleshooting) |68 | `✗ Failed to connect` | Il server non ha risposto. Vedere [Risoluzione dei problemi](#troubleshooting) |

68 | `✗ Connection error` | Il tentativo di connessione ha generato un errore. Vedere [Risoluzione dei problemi](#troubleshooting) |69 | `✗ Connection error` | Il tentativo di connessione ha generato un errore. Vedere [Risoluzione dei problemi](#troubleshooting) |

model-config.md +2 −0

Details

94 94 

95Quando il modello attivo all'avvio proviene dalle impostazioni del progetto o gestite piuttosto che dalla propria selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per eseguire l'override; l'impostazione del progetto o gestita si riapplica al prossimo avvio.95Quando il modello attivo all'avvio proviene dalle impostazioni del progetto o gestite piuttosto che dalla propria selezione, l'intestazione di avvio mostra quale file di impostazioni lo ha impostato. Eseguire `/model` per eseguire l'override; l'impostazione del progetto o gestita si riapplica al prossimo avvio.

96 96 

97Quando il modello richiesto ha una data di ritiro programmata o viene automaticamente rimappato a una versione più recente, Claude Code mostra un avviso che nomina il modello richiesto. Le sessioni interattive lo mostrano come un avviso di avvio. A partire dalla v2.1.182, lo stesso avviso viene scritto su stderr in [modalità non interattiva](/it/headless) quando si utilizza il formato di output di testo predefinito. Il controllo copre anche un `model` impostato nel [frontmatter del subagent](/it/sub-agents). L'avviso su stderr è soppresso per `--output-format json` e `stream-json`; leggere il modello effettivo dal campo `modelUsage` del [messaggio di risultato](/it/headless#get-structured-output) invece.

98 

97Esempio di utilizzo:99Esempio di utilizzo:

98 100 

99```bash theme={null}101```bash theme={null}

Details

701 Evento di rifiuto API701 Evento di rifiuto API

702</h4>702</h4>

703 703 

704Registrato quando una richiesta API restituisce `stop_reason: "refusal"`. I rifiuti arrivano su un flusso di risposta riuscito piuttosto che come errore HTTP, quindi l'evento `api_error` non si attiva per loro. Questo evento ti consente di tracciare la frequenza dei rifiuti.704Registrato quando una richiesta API restituisce `stop_reason: "refusal"`. I rifiuti arrivano su un flusso di risposta riuscito piuttosto che come errore HTTP, quindi l'evento `api_error` non si attiva per loro. Questo evento ti consente di tracciare la frequenza dei rifiuti e raggruppare i rifiuti per gli stessi attributi di `api_request` e `api_error`.

705 705 

706**Nome evento**: `claude_code.api_refusal`706**Nome evento**: `claude_code.api_refusal`

707 707 


713* `event.sequence`: Contatore monotonicamente crescente per ordinare gli eventi all'interno di una sessione713* `event.sequence`: Contatore monotonicamente crescente per ordinare gli eventi all'interno di una sessione

714* `model`: Identificatore del modello dalla richiesta714* `model`: Identificatore del modello dalla richiesta

715* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.715* `request_id`: ID della richiesta API Anthropic dall'intestazione `request-id` della risposta, come `"req_011..."`. Presente solo quando l'API ne restituisce uno.

716* `query_source`: Sottosistema che ha emesso la richiesta, come `"repl_main_thread"`, `"compact"`, o un nome di subagent. Vedi [`api_request`](#api-request-event) per le definizioni.

717* `speed`: `"fast"` quando [Fast mode](/it/fast-mode) è attivo, o `"normal"`

718* `attempt`: Numero del tentativo di ripetizione. Il primo tentativo è `1`.

719* `effort`: [Livello di sforzo](/it/model-config#adjust-effort-level) applicato alla richiesta. Assente quando il modello non supporta lo sforzo.

720* `server_fallback_hop`: `true` quando il fallback del modello lato server dell'API ha già ritentato questo rifiuto su un modello diverso, quindi l'utente non ha visto questo particolare rifiuto. `false` quando la richiesta è terminata in un rifiuto. Un singolo turno può emettere sia un evento hop `true` che un successivo evento finale `false` quando il modello di fallback rifiuta anche.

721* `has_category`: `true` quando la risposta API ha portato una `stop_details.category` di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. `false` quando la risposta non ha portato alcuna categoria o un valore al di fuori di quel set. Assente quando `server_fallback_hop` è `true`, perché i blocchi hop non portano `stop_details`.

722* `has_explanation`: `true` quando la risposta API ha portato una `stop_details.explanation`, altrimenti `false`. Assente quando `server_fallback_hop` è `true`.

723* `category`: Il valore `stop_details.category` dalla risposta API. Uno di `"cyber"`, `"bio"`, `"frontier_llm"`, o `"reasoning_extraction"`. Presente solo quando `OTEL_LOG_TOOL_DETAILS=1` è impostato e `has_category` è `true`.

724* `agent.name`, `skill.name`, `plugin.name`, `marketplace.name`, `mcp_server.name`, `mcp_tool.name`: Attribuzione di skill, plugin, agente e MCP per la richiesta. Vedi [Contatore di costo](#cost-counter) per le definizioni e il comportamento di redazione.

716 725 

717<h4 id="api-request-body-event">726<h4 id="api-request-body-event">

718 Evento di corpo della richiesta API727 Evento di corpo della richiesta API


1155 1164 

1156Claude Code ritenta internamente le richieste API non riuscite ed emette un singolo evento `claude_code.api_error` solo dopo che rinuncia, quindi l'evento stesso è il segnale terminale per quella richiesta. I tentativi di ripetizione intermedi non vengono registrati come eventi separati.1165Claude Code ritenta internamente le richieste API non riuscite ed emette un singolo evento `claude_code.api_error` solo dopo che rinuncia, quindi l'evento stesso è il segnale terminale per quella richiesta. I tentativi di ripetizione intermedi non vengono registrati come eventi separati.

1157 1166 

1158L'attributo `attempt` sull'evento registra quanti tentativi sono stati effettuati in totale. Un valore maggiore di `CLAUDE_CODE_MAX_RETRIES` (predefinito `10`) indica che la richiesta ha esaurito tutti i tentativi su un errore transitorio. Un valore inferiore indica un errore non ritentabile come una risposta `400`.1167L'attributo `attempt` sull'evento registra quanti tentativi sono stati effettuati in totale. Un valore maggiore di `CLAUDE_CODE_MAX_RETRIES` (predefinito `10`, limitato a `15`) indica che la richiesta ha esaurito tutti i tentativi su un errore transitorio. Un valore inferiore indica un errore non ritentabile come una risposta `400`.

1159 1168 

1160Per distinguere una sessione che si è ripresa da una che si è bloccata, raggruppa gli eventi per `session.id` e verifica se esiste un evento `api_request` successivo dopo l'errore.1169Per distinguere una sessione che si è ripresa da una che si è bloccata, raggruppa gli eventi per `session.id` e verifica se esiste un evento `api_request` successivo dopo l'errore.

1161 1170 

Details

117Claude Code richiede accesso ai seguenti URL. Inserire questi nella whitelist nella configurazione del proxy e nelle regole del firewall, soprattutto in ambienti di rete containerizzati o limitati.117Claude Code richiede accesso ai seguenti URL. Inserire questi nella whitelist nella configurazione del proxy e nelle regole del firewall, soprattutto in ambienti di rete containerizzati o limitati.

118 118 

119| URL | Richiesto per |119| URL | Richiesto per |

120| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |120| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

121| `api.anthropic.com` | Richieste API Claude |121| `api.anthropic.com` | Richieste API Claude |

122| `claude.ai` | Autenticazione account claude.ai |122| `claude.ai` | Autenticazione account claude.ai |

123| `platform.claude.com` | Autenticazione account Anthropic Console |123| `platform.claude.com` | Autenticazione account Anthropic Console |

124| `downloads.claude.ai` | Download eseguibili plugin; installer nativo e auto-updater nativo |124| `downloads.claude.ai` | Download eseguibili plugin; installer nativo e auto-updater nativo |

125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Installer nativo e auto-updater nativo nelle versioni precedenti a 2.1.116 |125| `storage.googleapis.com` | {/* max-version: 2.1.115 */}Installer nativo e auto-updater nativo nelle versioni precedenti a 2.1.116 |

126| `bridge.claudeusercontent.com` | Bridge WebSocket estensione [Claude in Chrome](/it/chrome) |126| `bridge.claudeusercontent.com` | Bridge WebSocket estensione [Claude in Chrome](/it/chrome) |

127| `*.claudeusercontent.com` | Visualizzazione di [artifact](/it/artifacts) su claude.ai. Il visualizzatore carica il contenuto di ogni artifact da un sottodominio sandbox di questa origine. Richiesto nel browser del visualizzatore, non dalla CLI stessa |

127| `raw.githubusercontent.com` | Feed changelog per [`/release-notes`](/it/commands) e le note di rilascio mostrate dopo l'aggiornamento; conteggi delle installazioni del marketplace dei plugin |128| `raw.githubusercontent.com` | Feed changelog per [`/release-notes`](/it/commands) e le note di rilascio mostrate dopo l'aggiornamento; conteggi delle installazioni del marketplace dei plugin |

128 129 

129Se si installa Claude Code tramite npm o si gestisce la propria distribuzione binaria, gli utenti finali potrebbero non avere bisogno di accesso a `downloads.claude.ai` o `storage.googleapis.com`.130Se si installa Claude Code tramite npm o si gestisce la propria distribuzione binaria, gli utenti finali potrebbero non avere bisogno di accesso a `downloads.claude.ai` o `storage.googleapis.com`.

Details

235* Modifica dell'infrastruttura condivisa235* Modifica dell'infrastruttura condivisa

236* Distruzione irreversibile di file che esistevano prima della sessione236* Distruzione irreversibile di file che esistevano prima della sessione

237* Force push o push diretto a `main`237* Force push o push diretto a `main`

238* {/* min-version: 2.1.182 */}`git reset --hard`, `git checkout -- .`, `git restore .`, `git clean -fd`, `git stash drop`, o `git stash clear`, che il classificatore presume scarterebbero le modifiche non sottoposte a commit

239* `git commit --amend` quando il commit in HEAD non è stato creato in questa sessione

240* `terraform destroy`, `pulumi destroy`, `cdk destroy`, o `terragrunt destroy`, e applicare un piano che distrugge risorse

238 241 

239**Consentito per impostazione predefinita**:242**Consentito per impostazione predefinita**:

240 243 

permissions.md +2 −2

Details

400I seguenti tipi di configurazione vengono caricati dalle directory `--add-dir`:400I seguenti tipi di configurazione vengono caricati dalle directory `--add-dir`:

401 401 

402| Configurazione | Caricato da `--add-dir` |402| Configurazione | Caricato da `--add-dir` |

403| :----------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |403| :-------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

404| [Skills](/it/skills) in `.claude/skills/` | Sì, con ricaricamento live |404| [Skills](/it/skills) in `.claude/skills/` | Sì, con ricaricamento live |

405| [Subagents](/it/sub-agents) in `.claude/agents/` | Sì |405| [Subagents](/it/sub-agents) in `.claude/agents/` | Sì |

406| Impostazioni plugin in `.claude/settings.json` | Solo `enabledPlugins` e `extraKnownMarketplaces` |406| [Impostazioni](/it/settings) in `.claude/settings.json` e `.claude/settings.local.json` | Solo le chiavi `enabledPlugins` e `extraKnownMarketplaces` |

407| File [CLAUDE.md](/it/memory), `.claude/rules/` e `CLAUDE.local.md` | Solo quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` è impostato. `CLAUDE.local.md` richiede inoltre l'impostazione `local` source, che è abilitata per impostazione predefinita |407| File [CLAUDE.md](/it/memory), `.claude/rules/` e `CLAUDE.local.md` | Solo quando `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` è impostato. `CLAUDE.local.md` richiede inoltre l'impostazione `local` source, che è abilitata per impostazione predefinita |

408 408 

409I comandi e gli stili di output vengono scoperti dalla directory di lavoro corrente e dai suoi genitori, dalla vostra directory utente in `~/.claude/` e dalle impostazioni gestite. Hooks e altre chiavi `settings.json` vengono caricati dalla cartella `.claude/` della directory di lavoro corrente senza fallback alla directory genitore, insieme al vostro `~/.claude/settings.json` utente e alle impostazioni gestite. Per condividere quella configurazione tra progetti, utilizzate uno di questi approcci:409I comandi e gli stili di output vengono scoperti dalla directory di lavoro corrente e dai suoi genitori, dalla vostra directory utente in `~/.claude/` e dalle impostazioni gestite. Hooks e altre chiavi `settings.json` vengono caricati dalla cartella `.claude/` della directory di lavoro corrente senza fallback alla directory genitore, insieme al vostro `~/.claude/settings.json` utente e alle impostazioni gestite. Per condividere quella configurazione tra progetti, utilizzate uno di questi approcci:

Details

201 Voci di plugin201 Voci di plugin

202</h2>202</h2>

203 203 

204Ogni voce di plugin nell'array `plugins` descrive un plugin e dove trovarlo. Puoi includere qualsiasi campo dallo [schema del manifest del plugin](/it/plugins-reference#plugin-manifest-schema) (come `description`, `version`, `author`, `commands`, `hooks`, ecc.), più questi campi specifici del marketplace: `source`, `category`, `tags` e `strict`.204Ogni voce di plugin nell'array `plugins` descrive un plugin e dove trovarlo. Puoi includere qualsiasi campo dallo [schema del manifest del plugin](/it/plugins-reference#plugin-manifest-schema) (come `description`, `version`, `author`, `commands`, `hooks`, ecc.), più questi campi specifici del marketplace: `source`, `category`, `tags`, `strict` e `relevance`.

205 205 

206<h3 id="required-fields-1">206<h3 id="required-fields-1">

207 Campi obbligatori207 Campi obbligatori


231| `category` | string | Categoria del plugin per l'organizzazione |231| `category` | string | Categoria del plugin per l'organizzazione |

232| `tags` | array | Tag per la ricercabilità |232| `tags` | array | Tag per la ricercabilità |

233| `strict` | boolean | Controlla se `plugin.json` è l'autorità per le definizioni dei componenti (predefinito: true). Vedi [Strict mode](#strict-mode) di seguito. |233| `strict` | boolean | Controlla se `plugin.json` è l'autorità per le definizioni dei componenti (predefinito: true). Vedi [Strict mode](#strict-mode) di seguito. |

234| `relevance` | object | {/* min-version: 2.1.152 */}Segnali che indicano a Claude Code quando suggerire questo plugin agli utenti. Ha effetto solo per i marketplace che un amministratore consente nelle impostazioni gestite. Vedi [Recommend plugins for your org](/it/plugin-relevance). Richiede Claude Code v2.1.152 o successivo. |

234| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se il plugin è abilitato dopo l'installazione (predefinito: true). Impostare su `false` per installare il plugin disabilitato fino a quando l'utente non acconsente. Ha la precedenza sullo stesso campo nel `plugin.json` del plugin. Vedi [Default enablement](/it/plugins-reference#default-enablement). Richiede Claude Code v2.1.154 o successivo. |235| `defaultEnabled` | boolean | {/* min-version: 2.1.154 */}Se il plugin è abilitato dopo l'installazione (predefinito: true). Impostare su `false` per installare il plugin disabilitato fino a quando l'utente non acconsente. Ha la precedenza sullo stesso campo nel `plugin.json` del plugin. Vedi [Default enablement](/it/plugins-reference#default-enablement). Richiede Claude Code v2.1.154 o successivo. |

235 236 

236**Campi di configurazione dei componenti:**237**Campi di configurazione dei componenti:**


269 Ad esempio, un marketplace ospitato in `acme-corp/plugin-catalog` (marketplace source) può elencare un plugin recuperato da `acme-corp/code-formatter` (plugin source). La marketplace source e la plugin source puntano a repository diversi e sono fissate indipendentemente.270 Ad esempio, un marketplace ospitato in `acme-corp/plugin-catalog` (marketplace source) può elencare un plugin recuperato da `acme-corp/code-formatter` (plugin source). La marketplace source e la plugin source puntano a repository diversi e sono fissate indipendentemente.

270</Note>271</Note>

271 272 

272I tipi di source basati su git di seguito sono `github`, `url` e `git-subdir`. Quando sia `ref` che `sha` sono impostati su uno qualsiasi di essi, `sha` è il pin effettivo. Claude Code recupera e controlla il commit fissato direttamente, quindi l'installazione ha successo anche se il branch o il tag denominato da `ref` è stato eliminato a monte, purché il commit sia ancora raggiungibile dal repository.273I tipi di source basati su git di seguito sono `github`, `url` e `git-subdir`. Quando sia `ref` che `sha` sono impostati su uno qualsiasi di essi, `sha` è il pin effettivo. Claude Code recupera e controlla il commit fissato direttamente. Su la maggior parte degli host git, inclusi GitHub, GitLab e Bitbucket, questo significa che l'installazione ha successo anche se il branch o il tag denominato da `ref` è stato eliminato a monte, purché il commit sia ancora raggiungibile dal repository. Alcuni server, come AWS CodeCommit, non supportano il recupero dei commit per SHA. Su quei server il `ref` deve ancora esistere e il commit fissato deve essere raggiungibile da esso.

273 274 

274<h3 id="relative-paths">275<h3 id="relative-paths">

275 Percorsi relativi276 Percorsi relativi


507* **`${CLAUDE_PLUGIN_ROOT}`**: Usa questa variabile nelle configurazioni degli hook e del server MCP per fare riferimento ai file all'interno della directory di installazione del plugin. Questo è necessario perché i plugin vengono copiati in una posizione cache quando installati. Per le dipendenze o lo stato che dovrebbe sopravvivere agli aggiornamenti dei plugin, usa [`${CLAUDE_PLUGIN_DATA}`](/it/plugins-reference#persistent-data-directory) invece.508* **`${CLAUDE_PLUGIN_ROOT}`**: Usa questa variabile nelle configurazioni degli hook e del server MCP per fare riferimento ai file all'interno della directory di installazione del plugin. Questo è necessario perché i plugin vengono copiati in una posizione cache quando installati. Per le dipendenze o lo stato che dovrebbe sopravvivere agli aggiornamenti dei plugin, usa [`${CLAUDE_PLUGIN_DATA}`](/it/plugins-reference#persistent-data-directory) invece.

508* **`strict: false`**: Poiché è impostato su false, il plugin non ha bisogno del suo `plugin.json`. La voce del marketplace definisce tutto. Vedi [Strict mode](#strict-mode) di seguito.509* **`strict: false`**: Poiché è impostato su false, il plugin non ha bisogno del suo `plugin.json`. La voce del marketplace definisce tutto. Vedi [Strict mode](#strict-mode) di seguito.

509 510 

510Per impostazione predefinita, le skills di un plugin vengono caricate dalla directory `skills/` sotto la sua `source`, e tutti i percorsi elencati sotto `skills` si aggiungono a quella scansione. L'eccezione è una source della radice del marketplace come `source: "./"`, dove più voci di plugin condividono una cartella `skills/`. In quel caso, l'elenco di sottodirectory specifiche sotto `skills` rende questo elenco il set completo per la voce, e altre directory sotto `skills/` non vengono caricate. L'elenco della directory `skills/` stessa o della radice del plugin mantiene la scansione completa. Se nessuno dei percorsi elencati esiste, viene eseguita la scansione predefinita.511Per impostazione predefinita, le skills di un plugin vengono caricate dalla directory `skills/` sotto la sua `source`. I percorsi elencati nel campo `skills` si aggiungono a quella scansione:

512 

513```json theme={null}

514"skills": ["./skills/", "./extra-skills/"]

515```

516 

517Quando più voci di plugin condividono una cartella `skills/` alla radice del marketplace (`source: "./"`), elenca invece sottodirectory specifiche in modo che ogni voce carichi solo le sue skills:

518 

519```json theme={null}

520"source": "./",

521"skills": ["./skills/code-review", "./skills/docs"]

522```

523 

524Con una source della radice del marketplace, i percorsi elencati sono il set completo per quella voce, e altre directory nella cartella `skills/` condivisa non vengono caricate. L'elenco di `./skills/` stesso, o della radice del plugin, mantiene la scansione completa. Se nessuno dei percorsi elencati esiste, viene eseguita la scansione predefinita.

511 525 

512<h3 id="strict-mode">526<h3 id="strict-mode">

513 Strict mode527 Strict mode


522 536 

523**Quando usare ogni modalità:**537**Quando usare ogni modalità:**

524 538 

525* **`strict: true`**: il plugin ha il suo `plugin.json` e gestisce i suoi componenti. La voce del marketplace può aggiungere skill o hook extra in cima. Questo è il predefinito e funziona per la maggior parte dei plugin.539* **`strict: true`**: il plugin ha il suo `plugin.json` e gestisce i suoi componenti. La voce del marketplace può aggiungere skills o hooks extra in cima. Questo è il predefinito e funziona per la maggior parte dei plugin.

526* **`strict: false`**: l'operatore del marketplace vuole il controllo completo. Il repository del plugin fornisce file grezzi e la voce del marketplace definisce quali di questi file sono esposti come skill, agenti, hook, ecc. Utile quando il marketplace ristruttura o cura i componenti di un plugin diversamente da quanto previsto dall'autore del plugin.540* **`strict: false`**: l'operatore del marketplace vuole il controllo completo. Il repository del plugin fornisce file grezzi e la voce del marketplace definisce quali di questi file sono esposti come skills, agenti, hooks, ecc. Utile quando il marketplace ristruttura o cura i componenti di un plugin diversamente da quanto previsto dall'autore del plugin.

527 541 

528<h2 id="host-and-distribute-marketplaces">542<h2 id="host-and-distribute-marketplaces">

529 Ospita e distribuisci marketplace543 Ospita e distribuisci marketplace


1078* Controlla che le directory dei plugin contengano i file richiesti1092* Controlla che le directory dei plugin contengano i file richiesti

1079* Per le origini GitHub, assicurati che i repository siano pubblici o che tu abbia accesso1093* Per le origini GitHub, assicurati che i repository siano pubblici o che tu abbia accesso

1080* Testa manualmente le origini dei plugin clonando/scaricando1094* Testa manualmente le origini dei plugin clonando/scaricando

1081* Se l'origine fissa sia `ref` che `sha`, un ramo o un tag upstream eliminato non blocca l'installazione. Se l'installazione continua a non riuscire, conferma che il commit fissato esiste ancora nel repository1095* Se l'origine fissa sia `ref` che `sha`, un ramo o un tag upstream eliminato non blocca l'installazione sulla maggior parte degli host git, inclusi GitHub, GitLab e Bitbucket. Su server che non supportano il recupero dei commit per SHA, come AWS CodeCommit, il `ref` deve ancora esistere e il commit fissato deve essere raggiungibile da esso. Se l'installazione continua a non riuscire, conferma che il commit fissato esiste ancora nel repository

1082 1096 

1083<h3 id="private-repository-authentication-fails">1097<h3 id="private-repository-authentication-fails">

1084 L'autenticazione del repository privato non riesce1098 L'autenticazione del repository privato non riesce

plugin-relevance.md +188 −0 created

Details

1> ## Documentation Index

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

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

4 

5# Consigliare plugin per la vostra organizzazione

6 

7> Aggiungere un blocco di rilevanza alle voci dei plugin del marketplace in modo che Claude Code li suggerisca quando il lavoro di un utente corrisponde.

8 

9Se gestite un marketplace di plugin per la vostra organizzazione, potete fare in modo che Claude Code suggerisca plugin specifici agli utenti in base a ciò su cui stanno lavorando. Aggiungete un blocco `relevance` alla voce di un plugin in `marketplace.json`, quindi inserite il marketplace nella lista consentita delle impostazioni gestite. Quando la sessione di un utente corrisponde a uno dei segnali dichiarati, Claude Code mostra un suggerimento di installazione per quel plugin.

10 

11I suggerimenti dichiarati dal marketplace sono opt-in per ogni marketplace tramite [impostazioni gestite](/it/settings#settings-files). Nessuna dichiarazione `relevance` di un marketplace produce suggerimenti finché un amministratore non la aggiunge alla lista consentita, incluso il marketplace ufficiale di Anthropic. Claude Code include anche un suggerimento integrato che è indipendente da questa lista consentita; questo suggerimento e tutti i suggerimenti dichiarati dal marketplace sono disabilitati quando [`spinnerTipsEnabled`](/it/settings#available-settings) è impostato su `false`.

12 

13{/* min-version: 2.1.152 */}Questa funzione richiede Claude Code v2.1.152 o successivo. I client più vecchi ignorano il campo `relevance`.

14 

15Questa pagina è per gli operatori del marketplace e gli amministratori aziendali. Se state cercando di installare plugin, consultate [Scoprire e installare plugin](/it/discover-plugins).

16 

17<h2 id="how-it-works">

18 Come funziona

19</h2>

20 

21Ogni voce di plugin in `marketplace.json` può contenere un oggetto `relevance`. L'oggetto nomina un argomento e uno o più segnali. Un segnale è un modello che Claude Code testa rispetto alla sessione corrente, come la directory di lavoro o i file che Claude ha letto.

22 

23La corrispondenza dei segnali avviene localmente sulla macchina dell'utente. La corrispondenza non aggiunge traffico di rete e non segnala quali segnali hanno corrisposto, o i loro valori, ad Anthropic o all'operatore del marketplace.

24 

25Quando un segnale corrisponde e il plugin non è già installato, Claude Code mostra il plugin in tre posizioni:

26 

27* **Suggerimento spinner**: un messaggio "Stai lavorando con *argomento*? Installa il plugin *plugin*" con il comando `/plugin install` appare sotto lo spinner mentre Claude sta rispondendo.

28* **Suggerimento all'inizio della sessione**: {/* min-version: 2.1.153 */}se il segnale `cwd` corrisponde alla directory di lavoro, una notifica `plugin suggestion: <name>@<marketplace> · /plugin` su una riga appare prima del primo turno. Questa superficie richiede Claude Code v2.1.153 o successivo.

29* **Scheda Discover di `/plugin`**: {/* min-version: 2.1.154 */}il plugin è fissato in cima all'elenco Discover con un'annotazione come "suggerito per questa directory" o "suggerito per i comandi stripe". Questa superficie richiede Claude Code v2.1.154 o successivo.

30 

31Il suggerimento spinner e la notifica all'inizio della sessione fanno parte del sistema di suggerimenti spinner. Entrambi sono disabilitati quando l'utente o il progetto imposta `spinnerTipsEnabled` su `false`, o quando è configurato un `spinnerTipsOverride` personalizzato con `excludeDefault`. Il pin della scheda Discover è indipendente dalle impostazioni dei suggerimenti.

32 

33Claude Code non installa mai un plugin automaticamente. L'utente conferma sempre.

34 

35<h2 id="add-relevance-to-a-plugin-entry">

36 Aggiungere rilevanza a una voce di plugin

37</h2>

38 

39Aggiungete un oggetto `relevance` alla voce del plugin nel vostro `marketplace.json`. L'esempio seguente dichiara che il plugin `terraform-helpers` è rilevante quando Claude legge un file `.tf` o quando Claude esegue `terraform`:

40 

41```json theme={null}

42{

43 "name": "acme-corp-plugins",

44 "owner": { "name": "Acme Platform Team" },

45 "plugins": [

46 {

47 "name": "terraform-helpers",

48 "source": "./plugins/terraform-helpers",

49 "description": "Acme conventions and helpers for Terraform",

50 "relevance": {

51 "topic": "Terraform",

52 "signals": {

53 "cli": ["terraform"],

54 "filesRead": ["**/*.tf"]

55 }

56 }

57 }

58 ]

59}

60```

61 

62Un plugin con un blocco `relevance` ma senza segnali corrispondenti si comporta come qualsiasi altra voce del marketplace. Appare nell'elenco Discover nella sua posizione normale e non viene mai visualizzato come suggerimento spinner.

63 

64<h2 id="field-reference">

65 Riferimento dei campi

66</h2>

67 

68<h3 id="relevance">

69 `relevance`

70</h3>

71 

72| Campo | Tipo | Descrizione |

73| :-------- | :----- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

74| `topic` | string | Facoltativo. La frase che riempie "Stai lavorando con *argomento*?" nel suggerimento spinner. Spesso il nome del prodotto, ad esempio `Stripe`. Utilizzate un dominio come `design` quando il nome del plugin non si legge naturalmente come argomento. Per impostazione predefinita, il nome del plugin con ogni segmento di trattino maiuscolo. La notifica all'inizio della sessione non utilizza questo valore. Massimo 64 caratteri. |

75| `signals` | object | Corrispondenti che determinano quando il plugin è rilevante. Almeno un segnale è richiesto affinché il plugin sia suggeribile. Consultate la tabella sottostante. |

76 

77<h3 id="relevance-signals">

78 `relevance.signals`

79</h3>

80 

81| Campo | Tipo | Descrizione |

82| :------------- | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | {/* min-version: 2.1.153 */}Modelli Glob abbinati alla directory di lavoro della sessione. Abbinati come percorso assoluto e, quando all'interno di un repository git, come percorso relativo alla radice del repository. Normalizzati con barra in avanti e senza distinzione tra maiuscole e minuscole. Ogni modello corrisponde alla directory stessa e a tutto ciò che contiene, quindi `infra`, `infra/`, e `infra/**` si comportano in modo identico. Questo è l'unico segnale che può corrispondere all'inizio della sessione, prima del primo turno. Massimo 10 modelli di 256 caratteri ciascuno. |

84| `cli` | array of strings | Nomi di comandi da comandi shell che Claude ha eseguito in questa sessione, ad esempio `["stripe"]`. Si applica su ogni piattaforma: i comandi eseguiti su Windows tramite PowerShell o Git Bash vengono registrati allo stesso modo. Claude Code registra un nome di comando per ogni invocazione dello strumento shell: il primo token dopo eventuali assegnazioni di variabili di ambiente iniziali e `sudo`. I comandi composti contribuiscono solo con il loro comando iniziale, quindi `cd infra && terraform plan` registra `cd`, non `terraform`. Corrispondenza esatta. Massimo 10 voci di 64 caratteri ciascuna. |

85| `hosts` | array of strings | Nomi host visti in URL `http://` o `https://` nei comandi Bash di questa sessione, ad esempio `["api.stripe.com"]`. Solo il nome host in minuscolo: nessuno schema, porta o percorso. Corrispondenza esatta senza distinzione tra maiuscole e minuscole. Massimo 20 voci di 128 caratteri ciascuna. |

86| `filesRead` | array of strings | {/* min-version: 2.1.153 */}Modelli Glob abbinati ai percorsi dei file che Claude ha letto in questa sessione, ad esempio `["**/*.tf"]`. Normalizzati con barra in avanti e senza distinzione tra maiuscole e minuscole. Massimo 10 modelli di 256 caratteri ciascuno. |

87| `manifestDeps` | array of objects | Dipendenze dichiarate nei manifesti di pacchetto che Claude ha letto in questa sessione. Ogni voce è `{ "file": "...", "pattern": "..." }`, dove `file` è un'espressione regolare abbinata al percorso del file manifest come registrato nello stato della sessione, tipicamente un percorso assoluto, e `pattern` è un'espressione regolare abbinata al contenuto di quel file. Ancorate `file` alla fine, ad esempio `[/\\\\]package\\.json$` in forma con escape JSON, perché un modello ancorato all'inizio non corrisponde mai a un percorso assoluto. I percorsi non sono normalizzati per il separatore per questo segnale, quindi i percorsi Windows utilizzano barre rovesciate. I file manifest più grandi di 512 KB vengono saltati. Entrambi i valori sono stringhe di origine JavaScript `RegExp` di al massimo 256 caratteri. `file` corrisponde senza distinzione tra maiuscole e minuscole. `pattern` è sensibile alle maiuscole. Massimo 10 voci. |

88 

89I segnali `cli`, `hosts`, `filesRead` e `manifestDeps` necessitano della cronologia della sessione, quindi possono corrispondere solo al suggerimento spinner e alla scheda Discover. Solo `cwd` può corrispondere all'inizio della sessione. I segnali `filesRead` e `manifestDeps` testano lo stato del file registrato della sessione, che include anche i file che Claude ha scritto o modificato e i file di memoria `CLAUDE.md` caricati automaticamente.

90 

91L'esempio seguente utilizza `manifestDeps` per suggerire un plugin Stripe una volta che Claude ha letto un `package.json` che dipende da `stripe`. Il modello `file` utilizza `[/\\\\]` in modo che corrisponda sia ai separatori di percorso con barra in avanti che con barra rovesciata, e `\\.` in modo che il punto sia letterale. In JSON, ogni barra rovesciata nell'espressione regolare è scritta due volte.

92 

93```json theme={null}

94{

95 "name": "stripe-helpers",

96 "source": "./plugins/stripe-helpers",

97 "relevance": {

98 "topic": "Stripe",

99 "signals": {

100 "manifestDeps": [

101 {

102 "file": "[/\\\\]package\\.json$",

103 "pattern": "\"stripe\"\\s*:"

104 }

105 ]

106 }

107 }

108}

109```

110 

111<Note>

112 I campi sconosciuti sotto `relevance` e `relevance.signals` vengono ignorati al momento del caricamento in modo che i client Claude Code più vecchi continuino a caricare il vostro marketplace. Eseguite `claude plugin validate` per visualizzarli come avvisi.

113</Note>

114 

115<h2 id="enable-suggestions-in-managed-settings">

116 Abilitare i suggerimenti nelle impostazioni gestite

117</h2>

118 

119Dichiarare `relevance` in `marketplace.json` non è sufficiente di per sé. Un amministratore deve inserire il marketplace nella lista consentita nelle [impostazioni gestite](/it/settings#settings-files) prima che i suoi suggerimenti vengano visualizzati agli utenti.

120 

121Aggiungete il nome del marketplace a `pluginSuggestionMarketplaces`. Per qualsiasi marketplace diverso dal marketplace ufficiale di Anthropic, dichiarate anche la fonte del marketplace nelle stesse impostazioni gestite, sia come voce di quel nome in `extraKnownMarketplaces` che come voce in `strictKnownMarketplaces`. Il nome inserito nella lista consentita viene ignorato se il marketplace registrato sulla macchina proviene da una fonte diversa. Questo impedisce a una fonte non correlata di registrarsi con un nome inserito nella lista consentita per avere i suoi plugin suggeriti in tutta l'organizzazione.

122 

123Il seguente `managed-settings.json` registra un marketplace dell'organizzazione da un repository GitHub e abilita i suoi suggerimenti:

124 

125```json theme={null}

126{

127 "extraKnownMarketplaces": {

128 "acme-corp-plugins": {

129 "source": {

130 "source": "github",

131 "repo": "acme-corp/claude-plugins"

132 }

133 }

134 },

135 "pluginSuggestionMarketplaces": ["acme-corp-plugins"]

136}

137```

138 

139Il marketplace ufficiale è esente dal requisito di dichiarazione della fonte perché il suo nome può registrarsi solo dalla fonte ufficiale di Anthropic. Inserire il nome nella lista consentita è sufficiente:

140 

141```json theme={null}

142{

143 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

144}

145```

146 

147Consultate il [riferimento delle impostazioni](/it/settings) per `pluginSuggestionMarketplaces` e [`extraKnownMarketplaces`](/it/settings#extraknownmarketplaces) per i dettagli completi della configurazione.

148 

149<h2 id="what-the-user-sees">

150 Cosa vede l'utente

151</h2>

152 

153Quando un segnale corrisponde durante una sessione, il suggerimento spinner recita:

154 

155```text theme={null}

156Stai lavorando con Terraform? Installa il plugin terraform-helpers:

157/plugin install terraform-helpers@acme-corp-plugins

158```

159 

160All'inizio della sessione, un segnale `cwd` corrispondente visualizza la notifica su una riga:

161 

162```text theme={null}

163plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin

164```

165 

166Il suggerimento di un determinato plugin appare al massimo una volta ogni tre sessioni tra il suggerimento spinner e la notifica all'inizio della sessione combinati, e nessuno dei due si ripete una volta che il plugin è installato. La notifica all'inizio della sessione inoltre smette di apparire dopo che il suggerimento è stato mostrato due volte.

167 

168{/* min-version: 2.1.154 */}Nella scheda Discover di `/plugin`, il plugin è fissato sopra gli altri risultati con un'annotazione che nomina il segnale corrispondente, come `suggested for this directory` o `suggested for terraform commands`. La scheda Discover fissa un determinato plugin una volta; le visite successive lo elencano in ordine normale. Il pin della scheda Discover richiede Claude Code v2.1.154 o successivo. Su v2.1.152 appare solo il suggerimento spinner; la notifica all'inizio della sessione viene aggiunta in v2.1.153.

169 

170<h2 id="validate-your-marketplace">

171 Convalidare il vostro marketplace

172</h2>

173 

174Eseguite `claude plugin validate` sulla directory del vostro marketplace per controllare il blocco `relevance` prima della pubblicazione:

175 

176```

177claude plugin validate ./my-marketplace

178```

179 

180Il validatore segnala le chiavi sconosciute sotto `relevance` e `relevance.signals` come avvisi, contrassegna un valore `relevance` che non è un oggetto e rifiuta una voce `signals.hosts` che include uno schema, una porta o un percorso.

181 

182<h2 id="see-also">

183 Vedere anche

184</h2>

185 

186* [Creare e distribuire un marketplace di plugin](/it/plugin-marketplaces): costruire il marketplace che ospita i vostri plugin

187* [Consigliare il vostro plugin dalla vostra CLI](/it/plugin-hints): richiedere agli utenti dalla vostra CLI invece che dai segnali di sessione di Claude Code

188* [Impostazioni](/it/settings): riferimento completo per `pluginSuggestionMarketplaces` e `extraKnownMarketplaces`

Details

632Se un percorso personalizzato sostituisce o estende la directory predefinita del plugin dipende dal campo:632Se un percorso personalizzato sostituisce o estende la directory predefinita del plugin dipende dal campo:

633 633 

634* **Sostituisce il valore predefinito**: `commands`, `agents`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Ad esempio, quando il manifest specifica `commands`, la directory predefinita `commands/` non viene scansionata. Per mantenere il valore predefinito e aggiungerne altri, elencalo esplicitamente: `"commands": ["./commands/", "./extras/"]`634* **Sostituisce il valore predefinito**: `commands`, `agents`, `outputStyles`, `experimental.themes`, `experimental.monitors`. Ad esempio, quando il manifest specifica `commands`, la directory predefinita `commands/` non viene scansionata. Per mantenere il valore predefinito e aggiungerne altri, elencalo esplicitamente: `"commands": ["./commands/", "./extras/"]`

635* **Aggiunge al valore predefinito**: `skills`. La directory predefinita `skills/` viene sempre scansionata, e le directory elencate in `skills` vengono caricate insieme ad essa. Eccezione: per una [voce del marketplace il cui `source` si risolve nella radice del marketplace](/it/plugin-marketplaces#advanced-plugin-entries), dichiarare sottodirectory specifiche sostituisce la scansione635* **Aggiunge al valore predefinito**: `skills`. La directory predefinita `skills/` viene sempre scansionata, e le directory elencate in `skills` vengono caricate insieme ad essa. Eccezione: per una [voce del marketplace il cui `source` si risolve nella radice del marketplace](/it/plugin-marketplaces#advanced-plugin-entries), dichiarare sottodirectory specifiche sostituisce la scansione predefinita `skills/`

636* **Regole di merge proprie**: [hooks](#hooks), [MCP servers](#mcp-servers) e [LSP servers](#lsp-servers). Vedi ogni sezione per come più fonti si combinano636* **Regole di merge proprie**: [hooks](#hooks), [MCP servers](#mcp-servers) e [LSP servers](#lsp-servers). Vedi ogni sezione per come più fonti si combinano

637 637 

638Quando un plugin ha sia una cartella predefinita che la chiave manifest corrispondente, Claude Code v2.1.140 e versioni successive contrassegnano la cartella ignorata in `/doctor`, `claude plugin list` e la vista dettagli `/plugin`. Il plugin continua a caricarsi utilizzando i percorsi del manifest. Nessun avviso viene mostrato quando la chiave manifest punta nella cartella predefinita, ad esempio `"commands": ["./commands/deploy.md"]`, perché la cartella è indirizzata esplicitamente in quel caso.638Quando un plugin ha sia una cartella predefinita che la chiave manifest corrispondente, Claude Code v2.1.140 e versioni successive contrassegnano la cartella ignorata in `/doctor`, `claude plugin list` e la vista dettagli `/plugin`. Il plugin continua a caricarsi utilizzando i percorsi del manifest. Nessun avviso viene mostrato quando la chiave manifest punta nella cartella predefinita, ad esempio `"commands": ["./commands/deploy.md"]`, perché la cartella è indirizzata esplicitamente in quel caso.

prompt-library.md +1319 −0

Details

6 6 

7> Copia e incolla prompt per Claude Code, etichettati per attività e ruolo.7> Copia e incolla prompt per Claude Code, etichettati per attività e ruolo.

8 8 

9export const PromptLibrary = ({text = {}, labels = {}, tagLabels = {}, phaseLabels = {}, sourceLabels = {}, catLabels = {}}) => {

10 const RAW = useMemo(() => [{

11 id: 'get-oriented-in-a',

12 sdlc: 'discover',

13 cat: 'Onboard',

14 startN: 1,

15 roles: [],

16 prompt: 'give me an overview of this codebase: architecture, key directories, and how the pieces connect',

17 nextHref: '/en/memory',

18 src: 'workflows'

19 }, {

20 id: 'explain-unfamiliar-code',

21 sdlc: 'discover',

22 cat: 'Understand',

23 roles: [],

24 prompt: 'explain what {path} does and how data flows through it. write it up as {format}',

25 slots: {

26 path: 'src/scheduler/queue.ts',

27 format: 'an HTML page with a diagram, then open it in my browser'

28 },

29 nextHref: '/en/output-styles',

30 src: 'workflows'

31 }, {

32 id: 'find-where-something-happens',

33 sdlc: 'discover',

34 cat: 'Understand',

35 startN: 2,

36 roles: [],

37 prompt: 'where do we {behavior}?',

38 slots: {

39 behavior: 'validate uploaded file types'

40 },

41 src: 'workflows'

42 }, {

43 id: 'see-what-depends-on',

44 sdlc: 'discover',

45 cat: 'Understand',

46 roles: [],

47 prompt: 'what would break if I deleted {target}?',

48 slots: {

49 target: 'the retryWithBackoff helper'

50 },

51 src: 'workflows'

52 }, {

53 id: 'trace-how-code-evolved',

54 sdlc: 'discover',

55 cat: 'Understand',

56 roles: [],

57 prompt: 'look through the commit history of {path} and summarize how it evolved and why',

58 slots: {

59 path: 'internal/auth/session.go'

60 },

61 src: 'best-practices'

62 }, {

63 id: 'scope-a-change-before',

64 sdlc: 'discover',

65 cat: 'Understand',

66 roles: ['pm', 'design'],

67 prompt: 'which files would I need to touch to {change}?',

68 slots: {

69 change: 'add a dark mode toggle to settings'

70 },

71 src: 'teams'

72 }, {

73 id: 'ask-the-codebase-a',

74 sdlc: 'discover',

75 cat: 'Understand',

76 roles: ['pm'],

77 prompt: 'I am a {role}. walk me through what happens when a user {action}, from the UI down to the result',

78 slots: {

79 role: 'PM',

80 action: 'clicks Export to PDF'

81 },

82 nextHref: '/en/output-styles',

83 src: 'teams'

84 }, {

85 id: 'plan-a-multi-file',

86 sdlc: 'design',

87 cat: 'Plan',

88 roles: ['pm', 'design'],

89 prompt: 'plan how to refactor the {target} to {goal}. list the files you would change, but don\'t edit anything yet',

90 slots: {

91 target: 'payment module',

92 goal: 'support multiple currencies'

93 },

94 src: 'workflows'

95 }, {

96 id: 'draft-a-spec-by',

97 sdlc: 'design',

98 cat: 'Plan',

99 roles: ['pm'],

100 prompt: 'I want to build {feature}. interview me about implementation, UX, edge cases, and tradeoffs until we have covered everything, then write the spec to SPEC.md',

101 slots: {

102 feature: 'per-workspace rate limits'

103 },

104 nextHref: '/en/skills',

105 src: 'best-practices'

106 }, {

107 id: 'turn-a-meeting-into',

108 sdlc: 'design',

109 cat: 'Plan',

110 roles: ['pm'],

111 prompt: 'read {input} and write up the action items, then create a {tracker} ticket for each with acceptance criteria',

112 slots: {

113 input: '@meeting-notes.md',

114 tracker: 'Linear'

115 },

116 needs: 'tracker',

117 nextHref: '/en/skills',

118 src: 'teams'

119 }, {

120 id: 'map-edge-cases-before',

121 sdlc: 'design',

122 cat: 'Plan',

123 roles: ['design', 'pm'],

124 prompt: 'list the error states, empty states, and edge cases for {feature} that the design needs to cover',

125 slots: {

126 feature: 'the file upload flow'

127 },

128 src: 'teams'

129 }, {

130 id: 'turn-a-mockup-into',

131 sdlc: 'design',

132 cat: 'Prototype',

133 roles: ['design', 'pm', 'marketing'],

134 paste: 'mockup',

135 prompt: 'here is a mockup. build a working prototype I can click through, matching the layout and states shown',

136 src: 'teams'

137 }, {

138 id: 'implement-from-a-screenshot',

139 sdlc: 'design',

140 cat: 'Prototype',

141 roles: ['design'],

142 paste: 'design',

143 needs: 'browser',

144 prompt: 'implement this design, then take a screenshot of the result, compare it to the original, and fix any differences',

145 nextHref: '/en/goal',

146 src: 'best-practices'

147 }, {

148 id: 'follow-an-existing-pattern',

149 sdlc: 'build',

150 cat: 'Implement',

151 roles: [],

152 prompt: 'look at how {example} is implemented to understand the pattern, then build {new} the same way',

153 slots: {

154 example: 'the GitHub webhook handler',

155 new: 'a Stripe webhook handler'

156 },

157 nextHref: '/en/memory',

158 src: 'best-practices'

159 }, {

160 id: 'generate-docs-for-code',

161 sdlc: 'build',

162 cat: 'Implement',

163 roles: ['docs'],

164 prompt: 'find {scope} without {format} comments and add them, matching the style already used in the file',

165 slots: {

166 scope: 'the public functions in src/auth/',

167 format: 'JSDoc'

168 },

169 src: 'workflows'

170 }, {

171 id: 'add-a-small-well',

172 sdlc: 'build',

173 cat: 'Implement',

174 roles: [],

175 prompt: 'add a {endpoint} endpoint that returns {payload}',

176 slots: {

177 endpoint: '/health',

178 payload: 'the app version and uptime'

179 },

180 src: 'workflows'

181 }, {

182 id: 'build-a-small-internal',

183 sdlc: 'build',

184 cat: 'Implement',

185 roles: ['pm', 'design', 'marketing', 'docs'],

186 prompt: 'create a {tool} using HTML, CSS, and vanilla JavaScript, then open it in my browser',

187 slots: {

188 tool: 'drag-and-drop Kanban board with three columns'

189 },

190 src: 'teams'

191 }, {

192 id: 'work-an-issue-end',

193 sdlc: 'build',

194 cat: 'Implement',

195 roles: [],

196 prompt: 'read issue #{issue}, implement the fix, and run the tests',

197 slots: {

198 issue: '312'

199 },

200 needs: 'gh',

201 src: 'workflows'

202 }, {

203 id: 'find-and-update-copy',

204 sdlc: 'build',

205 cat: 'Implement',

206 roles: ['design', 'docs', 'marketing'],

207 prompt: 'find every place we say "{copy}" or a close variant, show me each one in context, then update them all to "{new}". leave tests and the changelog alone',

208 slots: {

209 copy: 'Sign up free',

210 new: 'Start free trial'

211 },

212 src: 'teams'

213 }, {

214 id: 'draft-from-past-examples',

215 sdlc: 'build',

216 cat: 'Implement',

217 roles: ['docs', 'marketing', 'pm'],

218 prompt: 'read the {examples} in {folder} to learn the structure and voice, then draft a new one for {topic}',

219 slots: {

220 examples: 'privacy impact assessments',

221 folder: 'legal/pia/',

222 topic: 'the new analytics integration'

223 },

224 nextHref: '/en/skills',

225 src: 'legal'

226 }, {

227 id: 'write-tests-run-them',

228 sdlc: 'build',

229 cat: 'Test',

230 startN: 4,

231 roles: [],

232 prompt: 'write tests for {path}, run them, and fix any failures',

233 slots: {

234 path: 'app/parsers/feed.py'

235 },

236 nextHref: '/en/memory',

237 src: 'workflows'

238 }, {

239 id: 'drive-implementation-from-tests',

240 sdlc: 'build',

241 cat: 'Test',

242 roles: [],

243 prompt: 'write tests for {feature} first, then implement it until they pass',

244 slots: {

245 feature: 'the password reset flow'

246 },

247 src: 'ebook'

248 }, {

249 id: 'fill-gaps-from-a',

250 sdlc: 'build',

251 cat: 'Test',

252 roles: [],

253 prompt: 'read {report} and add tests for the lowest-covered files until each is above {target}%',

254 slots: {

255 report: 'coverage/coverage-summary.json',

256 target: '80'

257 },

258 nextHref: '/en/goal',

259 src: 'workflows'

260 }, {

261 id: 'migrate-a-pattern-across',

262 sdlc: 'build',

263 cat: 'Refactor',

264 roles: [],

265 prompt: 'migrate everything from {from} to {to}: identify every place that needs to change, then make the changes',

266 slots: {

267 from: 'the old logging API',

268 to: 'the structured logger'

269 },

270 src: 'workflows'

271 }, {

272 id: 'port-code-between-languages',

273 sdlc: 'build',

274 cat: 'Refactor',

275 roles: [],

276 prompt: 'port {source} to {target}, keeping the same {keep}',

277 slots: {

278 source: 'this Python module',

279 target: 'Rust',

280 keep: 'public API and test behavior'

281 },

282 src: 'teams'

283 }, {

284 id: 'optimize-against-a-measurable',

285 sdlc: 'build',

286 cat: 'Refactor',

287 roles: ['data'],

288 prompt: 'optimize {target} to bring {metric} from {current} down to under {goal}',

289 slots: {

290 target: 'the search query',

291 metric: 'p95 latency',

292 current: '2s',

293 goal: '500ms'

294 },

295 nextHref: '/en/goal',

296 src: 'ebook'

297 }, {

298 id: 'fix-a-precise-visual',

299 sdlc: 'build',

300 cat: 'Refactor',

301 roles: ['design'],

302 prompt: 'the {element} extends {amount} beyond the {container} on {viewport}. fix it.',

303 slots: {

304 element: 'login button',

305 amount: '20px',

306 container: 'card border',

307 viewport: 'mobile'

308 },

309 nextHref: '/en/desktop#preview-your-app',

310 src: 'ebook'

311 }, {

312 id: 'review-your-changes-before',

313 sdlc: 'build',

314 cat: 'Review',

315 startN: 5,

316 roles: [],

317 prompt: 'review my uncommitted changes and flag anything that looks risky before I commit',

318 nextHref: '/en/commands',

319 src: 'workflows'

320 }, {

321 id: 'review-a-pull-request',

322 sdlc: 'build',

323 cat: 'Review',

324 roles: [],

325 prompt: 'review PR #{pr} and summarize what changed, then list any concerns',

326 slots: {

327 pr: '247'

328 },

329 needs: 'gh',

330 nextHref: '/en/code-review',

331 src: 'workflows'

332 }, {

333 id: 'review-infrastructure-changes-before',

334 sdlc: 'build',

335 cat: 'Review',

336 roles: ['security', 'ops'],

337 paste: 'plan',

338 prompt: 'here is my Terraform plan output. what is this going to do, and is anything here going to cause problems?',

339 src: 'teams'

340 }, {

341 id: 'run-a-security-review',

342 sdlc: 'build',

343 cat: 'Review',

344 roles: ['security'],

345 prompt: 'use a subagent to review {path} for security issues and report what it finds',

346 slots: {

347 path: 'src/api/'

348 },

349 nextHref: '/en/sub-agents',

350 src: 'best-practices'

351 }, {

352 id: 'review-content-before-sending',

353 sdlc: 'build',

354 cat: 'Review',

355 roles: ['marketing', 'docs'],

356 prompt: 'review {file} for {concerns} and list anything I should fix before it goes to {reviewer}',

357 slots: {

358 file: 'launch-post.md',

359 concerns: 'unsupported claims, missing attributions, and brand-guideline issues',

360 reviewer: 'legal'

361 },

362 nextHref: '/en/skills',

363 src: 'legal'

364 }, {

365 id: 'course-correct-a-wrong',

366 sdlc: 'build',

367 cat: 'Steer',

368 roles: [],

369 prompt: 'that is not right: {feedback}. try a different approach',

370 slots: {

371 feedback: 'the function signature needs to stay backward-compatible'

372 },

373 nextHref: '/en/checkpointing',

374 src: 'best-practices'

375 }, {

376 id: 'narrow-the-scope-of',

377 sdlc: 'build',

378 cat: 'Steer',

379 roles: [],

380 prompt: 'that is too much. keep only the changes to {scope} and undo your other edits',

381 slots: {

382 scope: 'the validation logic in src/forms/'

383 },

384 src: 'best-practices'

385 }, {

386 id: 'turn-a-correction-into',

387 sdlc: 'build',

388 cat: 'Steer',

389 roles: [],

390 prompt: 'you keep {mistake}. add a rule to CLAUDE.md so this stops happening',

391 slots: {

392 mistake: 'using default exports when this project uses named exports'

393 },

394 nextHref: '/en/memory',

395 src: 'best-practices'

396 }, {

397 id: 'resolve-merge-conflicts',

398 sdlc: 'ship',

399 cat: 'Git',

400 roles: [],

401 prompt: 'resolve the merge conflicts in this branch and explain what you kept from each side',

402 src: 'workflows'

403 }, {

404 id: 'commit-with-a-generated',

405 sdlc: 'ship',

406 cat: 'Git',

407 roles: [],

408 prompt: 'commit these changes with a message that summarizes what I did',

409 src: 'workflows'

410 }, {

411 id: 'open-a-pull-request',

412 sdlc: 'ship',

413 cat: 'Git',

414 roles: [],

415 prompt: 'find the {tracker} ticket about {topic} and open a PR that implements it',

416 slots: {

417 tracker: 'Linear',

418 topic: 'the login timeout'

419 },

420 needs: 'tracker',

421 src: 'workflows'

422 }, {

423 id: 'draft-release-notes-from',

424 sdlc: 'ship',

425 cat: 'Release',

426 roles: ['pm', 'docs', 'marketing'],

427 prompt: 'compare {from} to {to} and draft release notes grouped by feature, fix, and breaking change',

428 slots: {

429 from: 'v2.3.0',

430 to: 'v2.4.0'

431 },

432 nextHref: '/en/skills',

433 src: 'workflows'

434 }, {

435 id: 'write-a-ci-workflow',

436 sdlc: 'ship',

437 cat: 'Release',

438 roles: ['ops'],

439 prompt: 'write a GitHub Actions workflow that {steps} on every push to {branch}',

440 slots: {

441 steps: 'runs the tests and deploys to staging',

442 branch: 'main'

443 },

444 src: 'workflows'

445 }, {

446 id: 'find-and-fix-a',

447 sdlc: 'operate',

448 cat: 'Debug',

449 startN: 3,

450 roles: [],

451 prompt: 'the {test} test is failing, find out why and fix it',

452 slots: {

453 test: 'UserAuth'

454 },

455 src: 'workflows'

456 }, {

457 id: 'investigate-a-reported-error',

458 sdlc: 'operate',

459 cat: 'Debug',

460 roles: ['ops'],

461 prompt: 'users are seeing {symptom} on {where}. investigate and tell me what is going on',

462 slots: {

463 symptom: '500 errors',

464 where: '/api/settings'

465 },

466 nextHref: '/en/web-quickstart#pre-fill-sessions',

467 src: 'workflows'

468 }, {

469 id: 'fix-a-build-error',

470 sdlc: 'operate',

471 cat: 'Debug',

472 roles: ['ops'],

473 paste: 'error',

474 prompt: 'here is a build error. fix the root cause and verify the build succeeds',

475 src: 'best-practices'

476 }, {

477 id: 'investigate-a-production-incident',

478 sdlc: 'operate',

479 cat: 'Incident',

480 roles: ['ops', 'security'],

481 prompt: '{symptom}. check the logs, recent deploys, and config changes, then tell me the most likely cause',

482 slots: {

483 symptom: 'the checkout endpoint started returning 500s an hour ago'

484 },

485 nextHref: '/en/mcp',

486 src: 'workflows'

487 }, {

488 id: 'diagnose-from-a-console',

489 sdlc: 'operate',

490 cat: 'Incident',

491 roles: ['ops', 'data'],

492 paste: 'screenshot',

493 prompt: 'here is a screenshot of {console}. walk me through why {resource} is failing and give me the exact commands to fix it',

494 slots: {

495 console: 'the GCP Kubernetes dashboard',

496 resource: 'this pod'

497 },

498 src: 'teams'

499 }, {

500 id: 'query-logs-in-plain',

501 sdlc: 'operate',

502 cat: 'Incident',

503 roles: ['security', 'ops', 'data'],

504 prompt: 'show me all {events} for {scope} over {timeframe}. write the query, run it, and tell me what stands out',

505 slots: {

506 events: 'failed logins',

507 scope: 'the auth service',

508 timeframe: 'the past 24 hours'

509 },

510 needs: 'db',

511 src: 'cybersecurity'

512 }, {

513 id: 'analyze-a-data-file',

514 sdlc: 'operate',

515 cat: 'Data',

516 roles: ['data', 'pm', 'marketing'],

517 paste: 'csv',

518 prompt: 'read {file}, summarize the key patterns, and write the results to {output}',

519 slots: {

520 file: '@reports/q1-signups.csv',

521 output: 'an HTML page with charts, then open it in my browser'

522 },

523 nextHref: '/en/mcp',

524 src: 'teams'

525 }, {

526 id: 'generate-variations-from-performance',

527 sdlc: 'operate',

528 cat: 'Data',

529 roles: ['marketing', 'data'],

530 paste: 'csv',

531 prompt: 'read {file}, find the underperforming {items}, and generate {n} new variations that stay under {limit} characters',

532 slots: {

533 file: '@ads-performance.csv',

534 items: 'headlines',

535 n: '20',

536 limit: '90'

537 },

538 nextHref: '/en/mcp',

539 src: 'teams'

540 }, {

541 id: 'turn-a-recurring-task',

542 sdlc: 'operate',

543 cat: 'Automate',

544 roles: [],

545 prompt: 'create a /{name} skill for this project that {steps}',

546 slots: {

547 name: 'ship',

548 steps: 'runs the linter and tests, then drafts a commit message'

549 },

550 src: 'workflows'

551 }, {

552 id: 'add-a-hook-for',

553 sdlc: 'operate',

554 cat: 'Automate',

555 roles: [],

556 prompt: 'write a hook that {action} after every {event}',

557 slots: {

558 action: 'runs prettier',

559 event: 'edit to a .ts or .tsx file'

560 },

561 src: 'best-practices'

562 }, {

563 id: 'connect-a-tool-with',

564 sdlc: 'operate',

565 cat: 'Automate',

566 roles: [],

567 prompt: 'set up the {server} MCP server so you can read my {data} directly',

568 slots: {

569 server: 'Sentry',

570 data: 'error reports'

571 },

572 src: 'workflows'

573 }, {

574 id: 'capture-what-to-remember',

575 sdlc: 'operate',

576 cat: 'Automate',

577 roles: ['pm', 'docs'],

578 prompt: 'summarize what we did this session and suggest what to add to CLAUDE.md',

579 src: 'teams'

580 }], []);

581 const PROMPTS = useMemo(() => {

582 if (typeof window !== 'undefined') {

583 const rawIds = new Set(RAW.map(p => p.id));

584 RAW.forEach(p => {

585 if (!text[p.id]) console.warn('[prompt-library] no text[] entry for id:', p.id);

586 });

587 Object.keys(text).forEach(k => {

588 if (!rawIds.has(k)) console.warn('[prompt-library] orphaned text[] key:', k);

589 });

590 }

591 return RAW.map(p => ({

592 ...p,

593 title: p.id,

594 teaches: '',

595 ...text[p.id] || ({})

596 }));

597 }, [RAW, text]);

598 const L = labels;

599 const TL = k => tagLabels[k] || k;

600 const CAT_TAG = useMemo(() => ({

601 Onboard: 'understand',

602 Understand: 'understand',

603 Plan: 'plan',

604 Prototype: 'prototype',

605 Implement: 'build',

606 Test: 'test',

607 Refactor: 'refactor',

608 Review: 'review',

609 Steer: 'steer',

610 Git: 'git',

611 Release: 'release',

612 Debug: 'debug',

613 Incident: 'debug',

614 Data: 'data',

615 Automate: 'automate'

616 }), []);

617 const TAGS = useMemo(() => ['understand', 'plan', 'prototype', 'build', 'test', 'refactor', 'review', 'steer', 'debug', 'git', 'release', 'data', 'automate', 'pm', 'design', 'docs', 'marketing', 'security', 'ops'], []);

618 const tagsOf = p => [CAT_TAG[p.cat], ...p.roles || []];

619 const doc = useMemo(() => {

620 const p = typeof window !== 'undefined' ? window.location.pathname : '';

621 const base = p.startsWith('/docs/') ? '/docs' : '';

622 const m = p.slice(base.length).match(/^\/([a-z]{2}(?:-[A-Z]{2})?)\//);

623 const locale = m ? m[1] : 'en';

624 return href => {

625 if (!href || href[0] !== '/' || href[1] === '/') return href;

626 return base + (href.startsWith('/en/') ? '/' + locale + href.slice(3) : href);

627 };

628 }, []);

629 const linkify = s => {

630 const out = [];

631 let last = 0;

632 const re = /\[([^\]]+)\]\(([^)]+)\)/g;

633 for (let m; m = re.exec(s); ) {

634 if (m.index > last) out.push(s.slice(last, m.index));

635 out.push(<a key={m.index} href={doc(m[2])}>{m[1]}</a>);

636 last = re.lastIndex;

637 }

638 if (last < s.length) out.push(s.slice(last));

639 return out;

640 };

641 const codeify = s => s.split(/(`[^`]+`)/g).map((part, i) => part[0] === '`' ? <code key={i}>{part.slice(1, -1)}</code> : part);

642 const SOURCES = useMemo(() => ({

643 'workflows': '/en/common-workflows',

644 'teams': 'https://claude.com/blog/how-anthropic-teams-use-claude-code',

645 'legal': 'https://claude.com/blog/how-anthropic-uses-claude-legal',

646 'cybersecurity': 'https://claude.com/blog/how-anthropic-uses-claude-cybersecurity',

647 'best-practices': '/en/best-practices',

648 'ebook': 'https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf'

649 }), []);

650 const [mounted, setMounted] = useState(false);

651 const [q, setQ] = useState('');

652 const [start, setStart] = useState(true);

653 const [sel, setSel] = useState(null);

654 const [openId, setOpenId] = useState(null);

655 const [copied, setCopied] = useState(null);

656 const [fills, setFills] = useState({});

657 const copyTimer = useRef(null);

658 useEffect(() => {

659 setMounted(true);

660 return () => clearTimeout(copyTimer.current);

661 }, []);

662 const setFill = (id, key, val) => setFills(f => ({

663 ...f,

664 [id + '.' + key]: val

665 }));

666 const fillOf = (p, key) => {

667 const v = fills[p.id + '.' + key];

668 return v !== undefined ? v : p.slots && p.slots[key] !== undefined ? p.slots[key] : '';

669 };

670 const assemble = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => fillOf(p, k) || p.slots && p.slots[k] || k);

671 const preview = p => p.prompt.replace(/\{(\w+)\}/g, (_, k) => p.slots && p.slots[k] || k);

672 const bodyText = p => preview(p) + ' ' + p.teaches.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') + ' ' + (p.next || '');

673 const widthFor = s => (s || '').length + 3 + 'ch';

674 const ql = q.trim().toLowerCase();

675 const toggleTag = k => {

676 setStart(false);

677 setSel(s => !ql && s === k ? null : k);

678 };

679 const clear = () => {

680 setStart(false);

681 setSel(null);

682 setQ('');

683 };

684 const results = useMemo(() => {

685 const list = PROMPTS.filter(p => {

686 if (ql) return p.title.toLowerCase().includes(ql) || bodyText(p).toLowerCase().includes(ql);

687 if (start) return !!p.startN;

688 if (sel) return tagsOf(p).includes(sel);

689 return true;

690 });

691 if (ql) return list;

692 if (start) return list.sort((a, b) => a.startN - b.startN);

693 if (sel) return list.sort((a, b) => (a.roles || []).length - (b.roles || []).length || (b.sdlc === 'operate') - (a.sdlc === 'operate'));

694 return list;

695 }, [PROMPTS, ql, start, sel]);

696 const matchSnippet = p => {

697 if (!ql || p.title.toLowerCase().includes(ql)) return null;

698 const txt = bodyText(p);

699 const at = txt.toLowerCase().indexOf(ql);

700 if (at < 0) return null;

701 const lo = Math.max(0, at - 30), hi = Math.min(txt.length, at + ql.length + 50);

702 return [lo > 0 ? '…' : '', txt.slice(lo, at), <mark key="m">{txt.slice(at, at + ql.length)}</mark>, txt.slice(at + ql.length, hi), hi < txt.length ? '…' : ''];

703 };

704 const grouped = useMemo(() => {

705 if (start && !q.trim()) return [];

706 const g = {};

707 for (const p of results) {

708 const key = p.sdlc + '|' + p.cat;

709 (g[key] = g[key] || ({

710 sdlc: p.sdlc,

711 cat: p.cat,

712 items: []

713 })).items.push(p);

714 }

715 return Object.values(g);

716 }, [results, start, q]);

717 const copy = async (str, id) => {

718 try {

719 await navigator.clipboard.writeText(str);

720 } catch {

721 const ta = document.createElement('textarea');

722 ta.value = str;

723 ta.setAttribute('readonly', '');

724 ta.style.position = 'fixed';

725 ta.style.opacity = '0';

726 document.body.appendChild(ta);

727 ta.select();

728 document.execCommand('copy');

729 document.body.removeChild(ta);

730 }

731 clearTimeout(copyTimer.current);

732 setCopied(id);

733 copyTimer.current = setTimeout(() => setCopied(null), 1600);

734 };

735 const promptBody = p => {

736 if (!p.slots) return <code>{p.prompt}</code>;

737 const parts = p.prompt.split(/(\{\w+\})/g);

738 return <code>

739 {parts.map((part, idx) => {

740 const m = part.match(/^\{(\w+)\}$/);

741 if (!m) return <span key={idx}>{part}</span>;

742 const k = m[1];

743 const val = fillOf(p, k);

744 return <input key={idx} type="text" className="pl-slot" value={val} placeholder={p.slots[k] || k} aria-label={k} style={{

745 width: widthFor(val || p.slots[k])

746 }} onChange={e => setFill(p.id, k, e.target.value)} onFocus={e => e.target.select()} onClick={e => e.stopPropagation()} />;

747 })}

748 </code>;

749 };

750 const card = p => {

751 const open = openId === p.id;

752 const srcHref = SOURCES[p.src];

753 const srcLabel = sourceLabels[p.src];

754 const snip = matchSnippet(p);

755 return <div key={p.id} className={'pl-card' + (open ? ' pl-open' : '')}>

756 <button type="button" className="pl-head" onClick={() => setOpenId(open ? null : p.id)} aria-expanded={open}>

757 <span className="pl-title">{p.title}</span>

758 {!!p.startN && <span className="pl-chip">{L.startHere} · {p.startN}</span>}

759 </button>

760 {snip ? <div className="pl-match">{snip}</div> : <code className="pl-prompt-preview">{preview(p)}</code>}

761 {open && <div className="pl-body">

762 <div className="pl-label">{p.slots ? L.fillAndCopy : L.copyThis}</div>

763 {p.needs && L.needs && L.needs[p.needs] && <div className="pl-hint pl-needs">

764 <span className="pl-needs-label">{L.needsLabel}</span> {linkify(L.needs[p.needs])}

765 </div>}

766 {p.paste && L.paste && L.paste[p.paste] && <div className="pl-hint pl-paste">{L.paste[p.paste]}</div>}

767 {p.slots && <div className="pl-hint">

768 {L.hintBefore} <span className="pl-hint-chip">{L.hintChip}</span> {L.hintAfter}

769 </div>}

770 <div className="pl-prompt-box">

771 <span className="pl-caret">{'❯'}</span>

772 {promptBody(p)}

773 <button type="button" className="pl-copy" onClick={() => copy(assemble(p), p.id)}>

774 {copied === p.id ? L.copied : L.copy}

775 </button>

776 </div>

777 <div className="pl-label">{L.whyWorks}</div>

778 <div className="pl-teaches">{linkify(p.teaches)}</div>

779 {p.nextHref && p.next && <div className="pl-next">

780 <span className="pl-next-label">{L.makeItStick}</span>

781 <a href={doc(p.nextHref)}>{codeify(p.next)} →</a>

782 </div>}

783 {srcLabel && <div className="pl-src">{L.from} {srcHref ? <a href={doc(srcHref)}>{srcLabel}</a> : srcLabel}</div>}

784 </div>}

785 </div>;

786 };

787 const STYLES = useMemo(() => `

788.pl {

789 --pl-accent: #D97757;

790 --pl-accent-bg: rgba(217,119,87,0.07);

791 --pl-bg: #fff;

792 --pl-surface: #FAFAF7;

793 --pl-border: #E8E6DC;

794 --pl-border-subtle: rgba(31,30,29,0.08);

795 --pl-text: #141413;

796 --pl-text-2: #5E5D59;

797 --pl-text-3: #73726C;

798 --pl-text-4: #9C9A92;

799 --pl-mono: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);

800 font-family: 'Anthropic Sans', -apple-system, BlinkMacSystemFont, sans-serif;

801 font-size: 16px; color: var(--pl-text); margin: 8px 0 32px;

802}

803.dark .pl {

804 --pl-bg: #1f1e1d;

805 --pl-surface: #262624;

806 --pl-border: #3d3d3a;

807 --pl-border-subtle: rgba(240,238,230,0.08);

808 --pl-text: #f0eee6;

809 --pl-text-2: #bfbdb4;

810 --pl-text-3: #91908a;

811 --pl-text-4: #73726c;

812}

813.pl *, .pl *::before, .pl *::after { box-sizing: border-box; }

814.pl button { font-family: inherit; cursor: pointer; }

815.pl a { color: var(--pl-accent); text-decoration: none; }

816.pl a:hover { text-decoration: underline; }

817 

818.pl-search {

819 display: flex; align-items: center; gap: 10px;

820 padding: 14px 18px; background: var(--pl-surface);

821 border: 1px solid var(--pl-border); border-radius: 12px;

822 margin-bottom: 14px;

823}

824.pl-search input {

825 flex: 1; border: none; outline: none; background: transparent;

826 font-size: 16px; color: var(--pl-text);

827}

828.pl-search input::placeholder { color: var(--pl-text-4); }

829 

830.pl-tags { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin-bottom: 18px; }

831.pl-tag {

832 padding: 7px 14px; border: 1px solid var(--pl-border); background: var(--pl-bg);

833 font-size: 14px; color: var(--pl-text-2); border-radius: 999px;

834}

835.pl-tag:hover { background: var(--pl-surface); }

836.pl-tag.pl-on { background: var(--pl-text); border-color: var(--pl-text); color: var(--pl-bg); }

837.pl-tag.pl-start { color: var(--pl-accent); font-weight: 500; }

838.pl-tag.pl-start.pl-on { background: var(--pl-accent); border-color: var(--pl-accent); color: #fff; }

839.pl-tags.pl-dim .pl-tag { opacity: 0.5; }

840.pl-tags.pl-dim .pl-tag:hover { opacity: 1; }

841.pl-sep { width: 1px; height: 22px; background: var(--pl-border); margin: 0 4px; }

842.pl-clear { border: none; background: none; font-size: 13px; color: var(--pl-text-4); padding: 4px 6px; }

843.pl-clear:hover { color: var(--pl-text-2); }

844.pl-count { margin-left: auto; font-size: 14px; color: var(--pl-text-4); }

845 

846.pl-group-h {

847 font-size: 12px; letter-spacing: 0.08em; text-transform: uppercase;

848 color: var(--pl-text-4); margin: 24px 0 12px;

849}

850.pl-group-h .pl-phase { color: var(--pl-text-3); }

851.pl-card {

852 border: 1px solid var(--pl-border-subtle); border-radius: 10px;

853 margin-bottom: 12px; background: var(--pl-bg); overflow: hidden;

854 padding: 14px 18px;

855}

856.pl-card.pl-open { border-color: var(--pl-border); background: var(--pl-surface); }

857.pl-head {

858 width: 100%; display: flex; align-items: baseline; gap: 12px;

859 border: none; background: transparent; text-align: left; padding: 0;

860}

861.pl-head:focus-visible { outline: 2px solid var(--pl-accent); outline-offset: 2px; border-radius: 6px; }

862.pl-title {

863 flex: 1; font-size: 17px; font-weight: 500; color: var(--pl-text);

864 white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

865}

866.pl-prompt-preview {

867 display: block; font-family: var(--pl-mono); font-size: 13.5px; color: var(--pl-text-3);

868 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

869}

870.pl-chip {

871 font-size: 11px; letter-spacing: 0.05em; text-transform: uppercase;

872 padding: 3px 9px; border-radius: 999px; flex-shrink: 0;

873 background: var(--pl-accent-bg); color: var(--pl-accent);

874}

875 

876.pl-body { margin-top: 14px; padding-top: 14px; border-top: 1px solid var(--pl-border-subtle); }

877.pl-label {

878 font-size: 11.5px; letter-spacing: 0.08em; text-transform: uppercase;

879 color: var(--pl-text-4); margin: 12px 0 8px;

880}

881.pl-prompt-box {

882 display: flex; align-items: center; gap: 10px;

883 padding: 14px 16px; background: #141413; color: #f0eee6;

884 border-radius: 8px; font-family: var(--pl-mono); font-size: 15px;

885}

886.pl-caret { color: var(--pl-accent); flex-shrink: 0; }

887.pl-prompt-box code { flex: 1; background: none; padding: 0; color: inherit; white-space: pre-wrap; line-height: 1.9; }

888.pl-slot {

889 font-family: var(--pl-mono); font-size: inherit;

890 background: rgba(217,119,87,0.15); color: #f0eee6;

891 border: none; border-bottom: 1.5px dashed var(--pl-accent);

892 border-radius: 4px 4px 0 0; padding: 2px 6px; margin: 0 1px;

893 outline: none; min-width: 6ch; max-width: 100%;

894 box-sizing: content-box; cursor: text;

895}

896.pl-slot:hover { background: rgba(217,119,87,0.22); }

897.pl-slot:focus { background: rgba(217,119,87,0.28); border-bottom-style: solid; }

898.pl-slot::placeholder { color: rgba(240,238,230,0.4); font-style: italic; }

899.pl-hint { font-size: 14px; color: var(--pl-text-3); margin: 0 0 10px; }

900.pl-paste { color: var(--pl-text-2); }

901.pl-needs { color: var(--pl-text-2); }

902.pl-needs-label {

903 display: inline-block; font-size: 10.5px; letter-spacing: 0.06em;

904 text-transform: uppercase; padding: 2px 7px; margin-right: 6px;

905 border-radius: 4px; background: var(--pl-accent-bg); color: var(--pl-accent);

906}

907.pl-hint-chip {

908 font-family: var(--pl-mono); font-size: 0.92em;

909 background: var(--pl-accent-bg); color: var(--pl-accent);

910 border-bottom: 1.5px dashed var(--pl-accent);

911 border-radius: 3px 3px 0 0; padding: 1px 5px;

912}

913.pl-copy {

914 font-size: 12.5px; padding: 6px 12px; border-radius: 6px;

915 background: var(--pl-accent); color: #fff; border: none; flex-shrink: 0;

916}

917.pl-teaches { display: block; font-size: 15.5px; color: var(--pl-text-2); margin: 4px 0 0; line-height: 1.6; }

918.pl-match {

919 display: block; font-size: 13.5px; color: var(--pl-text-3);

920 margin-top: 6px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;

921}

922.pl-match mark { background: var(--pl-accent-bg); color: var(--pl-text); padding: 1px 2px; border-radius: 3px; }

923.pl-next {

924 display: flex; align-items: baseline; gap: 10px;

925 margin: 14px 0 0; padding: 10px 12px;

926 background: var(--pl-accent-bg); border-radius: 8px; font-size: 14.5px;

927}

928.pl-next-label {

929 font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase;

930 color: var(--pl-accent); font-weight: 600; flex-shrink: 0;

931}

932.pl-src { display: block; font-size: 14px; color: var(--pl-text-4); margin: 14px 0 0; }

933 

934.pl-show-all {

935 display: block; width: 100%; padding: 14px; margin-top: 4px;

936 border: 1px dashed var(--pl-border); border-radius: 10px;

937 background: transparent; font-size: 15px; color: var(--pl-accent);

938 text-align: center;

939}

940.pl-show-all:hover { background: var(--pl-accent-bg); border-style: solid; }

941 

942.pl-empty {

943 padding: 32px; text-align: center; color: var(--pl-text-4);

944 border: 1px dashed var(--pl-border); border-radius: 10px;

945}

946`, []);

947 if (!mounted) return <div className="pl" style={{

948 minHeight: 480

949 }} />;

950 return <div className="pl">

951 <style>{STYLES}</style>

952 

953 <div className="pl-search">

954 <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" style={{

955 color: 'var(--pl-text-4)'

956 }}>

957 <circle cx="11" cy="11" r="7" /><line x1="21" y1="21" x2="16.65" y2="16.65" />

958 </svg>

959 <input type="text" placeholder={L.search} value={q} onChange={e => {

960 setQ(e.target.value);

961 if (e.target.value) setStart(false);

962 }} aria-label={L.search} />

963 </div>

964 

965 <div className={'pl-tags' + (ql ? ' pl-dim' : '')}>

966 <button type="button" className={'pl-tag pl-start' + (!ql && start ? ' pl-on' : '')} onClick={() => {

967 setQ('');

968 setStart(!start);

969 if (!start) setSel(null);

970 }}>

971 ★ {L.startHere}

972 </button>

973 <span className="pl-sep" />

974 {TAGS.map(k => <button key={k} type="button" aria-pressed={!ql && sel === k} className={'pl-tag' + (!ql && sel === k ? ' pl-on' : '')} onClick={() => {

975 setQ('');

976 toggleTag(k);

977 }}>

978 {TL(k)}

979 </button>)}

980 {(start || sel || q) && <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>}

981 <span className="pl-count">{results.length} {results.length === 1 ? L.prompt : L.prompts}</span>

982 </div>

983 

984 {results.length === 0 ? <div className="pl-empty">

985 {L.noMatch} {ql ? <code>{q}</code> : null} <button type="button" className="pl-clear" onClick={clear}>{L.clear}</button>

986 </div> : !ql && start ? <div>

987 <div className="pl-group-h">{L.startHereHeader}</div>

988 {results.map(card)}

989 <button type="button" className="pl-show-all" onClick={clear}>

990 {L.showAll && L.showAll.replace('{n}', PROMPTS.length)} →

991 </button>

992 </div> : grouped.map(g => <div key={g.sdlc + '|' + g.cat}>

993 <div className="pl-group-h"><span className="pl-phase">{phaseLabels[g.sdlc] || g.sdlc}</span> · {catLabels[g.cat] || g.cat}</div>

994 {g.items.map(card)}

995 </div>)}

996 </div>;

997};

998 

9Questa è una libreria di prompt da copiare in Claude Code. Utilizzatela per esplorare modi di lavorare che non avete ancora provato, o quando non siete sicuri da dove iniziare.999Questa è una libreria di prompt da copiare in Claude Code. Utilizzatela per esplorare modi di lavorare che non avete ancora provato, o quando non siete sicuri da dove iniziare.

10 1000 

11I prompt sono raccolti da varie guide Anthropic, tra cui [Flussi di lavoro comuni](/it/common-workflows), [Best practice](/it/best-practices) e [Come i team di Anthropic utilizzano Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code). Sono punti di partenza piuttosto che script. Aprite **Perché funziona** sotto qualsiasi prompt per vedere il modello dietro di esso, così potrete scrivere i vostri.1001I prompt sono raccolti da varie guide Anthropic, tra cui [Flussi di lavoro comuni](/it/common-workflows), [Best practice](/it/best-practices) e [Come i team di Anthropic utilizzano Claude Code](https://claude.com/blog/how-anthropic-teams-use-claude-code). Sono punti di partenza piuttosto che script. Aprite **Perché funziona** sotto qualsiasi prompt per vedere il modello dietro di esso, così potrete scrivere i vostri.

12 1002 

1003export const labels = {

1004 startHere: "Iniziate da qui",

1005 startHereHeader: "Cinque prompt da provare per primi",

1006 showAll: "Mostra tutti i {n} prompt",

1007 search: "Cerca prompt…",

1008 clear: "Cancella",

1009 prompt: "prompt",

1010 prompts: "prompt",

1011 noMatch: "Nessun prompt corrisponde",

1012 fillAndCopy: "Compila e copia",

1013 copyThis: "Copia questo prompt",

1014 hintBefore: "Digitate nei",

1015 hintChip: "campi evidenziati",

1016 hintAfter: "per personalizzare, quindi copiate.",

1017 copy: "Copia",

1018 copied: "Copiato",

1019 whyWorks: "Perché funziona",

1020 makeItStick: "Rendilo permanente",

1021 from: "Da",

1022 paste: {

1023 mockup: "Incollate, trascinate o @-menzionate la vostra immagine mockup, quindi inviate questo:",

1024 design: "Incollate, trascinate o @-menzionate la vostra immagine di design, quindi inviate questo:",

1025 screenshot: "Incollate, trascinate o @-menzionate il vostro screenshot, quindi inviate questo:",

1026 plan: "Incollate l'output del vostro piano nel prompt per primo, quindi inviate questo:",

1027 error: "Incollate l'output dell'errore nel prompt per primo, quindi inviate questo:",

1028 csv: "Trascinate il vostro file nel prompt, o sostituite il percorso sottostante con una @-menzione della vostra:"

1029 },

1030 needsLabel: "Richiede",

1031 needs: {

1032 tracker: "il vostro issue tracker aggiunto come [connettore claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) o [server MCP](/it/mcp).",

1033 gh: "la [gh CLI](https://cli.github.com) autenticata, o GitHub aggiunto come [connettore claude.ai](/it/mcp#use-mcp-servers-from-claude-ai).",

1034 browser: "un modo per Claude di renderizzare e fare uno screenshot del risultato. L'[app Desktop](/it/desktop#preview-your-app) ha questa funzione integrata. Nel terminale, installate l'[estensione Chrome](/it/chrome) o un server MCP [Playwright](/it/mcp).",

1035 db: "il vostro data warehouse o log store aggiunto come [connettore claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) o [server MCP](/it/mcp)."

1036 }

1037};

1038 

1039export const tagLabels = {

1040 understand: "Comprendere",

1041 plan: "Pianificare",

1042 prototype: "Prototipo",

1043 build: "Costruire",

1044 test: "Test",

1045 refactor: "Refactoring",

1046 review: "Revisione",

1047 steer: "Guidare",

1048 debug: "Debug",

1049 git: "Git",

1050 release: "Release",

1051 data: "Dati",

1052 automate: "Automatizzare",

1053 pm: "Prodotto",

1054 design: "Design",

1055 docs: "Documentazione",

1056 marketing: "Marketing",

1057 security: "Sicurezza",

1058 ops: "On-call"

1059};

1060 

1061export const phaseLabels = {

1062 discover: "Scoprire",

1063 design: "Progettare",

1064 build: "Costruire",

1065 ship: "Rilasciare",

1066 operate: "Operare"

1067};

1068 

1069export const sourceLabels = {

1070 workflows: "Flussi di lavoro comuni",

1071 teams: "Come i team di Anthropic utilizzano Claude Code",

1072 legal: "Come Anthropic utilizza Claude in Legal",

1073 cybersecurity: "Come Anthropic utilizza Claude in Cybersecurity",

1074 "best-practices": "Best practice",

1075 ebook: "Guida al scaling del coding agentico"

1076};

1077 

1078export const catLabels = {

1079 Onboard: "Onboard",

1080 Understand: "Comprendere",

1081 Plan: "Pianificare",

1082 Prototype: "Prototipo",

1083 Implement: "Implementare",

1084 Test: "Test",

1085 Refactor: "Refactoring",

1086 Review: "Revisione",

1087 Steer: "Guidare",

1088 Git: "Git",

1089 Release: "Release",

1090 Debug: "Debug",

1091 Incident: "Incidente",

1092 Data: "Dati",

1093 Automate: "Automatizzare"

1094};

1095 

1096export const text = {

1097 "get-oriented-in-a": {

1098 title: "Orientarsi in un nuovo repository",

1099 teaches: "Descrivete quello che volete sapere, non quali file leggere. Claude esplora il progetto autonomamente e restituisce un riepilogo di come si incastra.",

1100 next: "Eseguite `/init` per configurare `CLAUDE.md` in modo che Claude lo ricordi ogni sessione"

1101 },

1102 "explain-unfamiliar-code": {

1103 title: "Spiegare codice non familiare",

1104 teaches: "Nominate il file e dite in quale formato volete la risposta. Sostituite la pagina HTML con un diagramma, punti elenco, o quello che si adatta al vostro modo di imparare.",

1105 next: "Impostate uno stile di output in modo che Claude spieghi sempre nel vostro formato preferito"

1106 },

1107 "find-where-something-happens": {

1108 title: "Trovare dove accade qualcosa",

1109 teaches: "Cercate per comportamento invece che per nome file. La ricerca funziona anche quando non sapete come si chiama il file o in quale directory si trova."

1110 },

1111 "see-what-depends-on": {

1112 title: "Controllare cosa si rompe prima di eliminare",

1113 teaches: "Chiedete prima di rimuovere qualcosa. L'elenco dei chiamanti e degli effetti a valle vi dice se state guardando una pulizia di una riga o un cambiamento che dovete coordinare."

1114 },

1115 "trace-how-code-evolved": {

1116 title: "Tracciare come il codice si è evoluto",

1117 teaches: "Puntate alla cronologia dei commit quando la domanda è il perché, non il cosa. Claude legge il log e il blame per qualsiasi sistema di controllo versione utilizzate e spiega le decisioni dietro l'implementazione attuale."

1118 },

1119 "scope-a-change-before": {

1120 title: "Definire l'ambito di un cambiamento prima di iniziare",

1121 teaches: "Dimensionate il lavoro prima di impegnarvi in una roadmap. L'elenco dei file vi dice se state guardando un componente o un cambiamento trasversale."

1122 },

1123 "ask-the-codebase-a": {

1124 title: "Fare una domanda di prodotto alla codebase",

1125 teaches: "Dichiarate il vostro ruolo in modo che la risposta sia al livello giusto. Claude spiega cosa il prodotto effettivamente fa dal codice sorgente, senza che voi abbiate bisogno di leggerlo.",

1126 next: "Impostate uno stile di output in modo che Claude sempre presenti le risposte a questo livello"

1127 },

1128 "plan-a-multi-file": {

1129 title: "Pianificare un cambiamento multi-file prima di toccare il codice",

1130 teaches: "Aggiungere \"non modificare ancora\" separa l'esplorazione dai cambiamenti, così vedete l'approccio prima che qualsiasi codice si muova. Per rendere plan-first il default su ogni prompt, premete Shift+Tab per [plan mode](/it/permission-modes#analyze-before-you-edit-with-plan-mode)."

1131 },

1132 "draft-a-spec-by": {

1133 title: "Bozza di una specifica tramite intervista",

1134 teaches: "Chiedete di essere intervistati invece di scrivere la specifica voi stessi. Claude vi pone domande strutturate finché i requisiti non sono completi, quindi scrive il risultato in un file.",

1135 next: "Salvate le vostre domande di intervista come una skill `/spec` in modo che ogni specifica inizi allo stesso modo"

1136 },

1137 "turn-a-meeting-into": {

1138 title: "Trasformare una riunione in ticket",

1139 teaches: "Saltate il passaggio della trascrizione. Claude estrae gli elementi d'azione dall'input non strutturato e li scrive direttamente nel vostro tracker tramite [MCP](/it/mcp), così rivedete i ticket, non la trascrizione.",

1140 next: "Salvate questo come una skill `/tickets`"

1141 },

1142 "map-edge-cases-before": {

1143 title: "Mappare i casi limite prima di costruire",

1144 teaches: "Chiedete cosa manca, non cosa c'è. Claude elenca gli stati di errore, gli stati vuoti e i casi limite che un design happy-path tende a saltare."

1145 },

1146 "turn-a-mockup-into": {

1147 title: "Trasformare un mockup in un prototipo funzionante",

1148 teaches: "Un prototipo cliccabile risponde a domande che un mockup statico non può. Consegnate il codice funzionante all'ingegneria invece di spiegare le interazioni in un documento."

1149 },

1150 "implement-from-a-screenshot": {

1151 title: "Implementare da uno screenshot e auto-verificare",

1152 teaches: "Questo dà a Claude un ciclo di verifica: renderizza, confronta con l'immagine sorgente, e itera senza che voi indichiate ogni lacuna.",

1153 next: "Utilizzate `/goal` per mantenere Claude iterando finché gli screenshot non corrispondono"

1154 },

1155 "follow-an-existing-pattern": {

1156 title: "Seguire un modello esistente",

1157 teaches: "Puntate al codice che vi piace già. Senza un riferimento, Claude usa come default le best practice generali. Con uno, corrisponde alle convenzioni che la vostra codebase effettivamente usa.",

1158 next: "Chiedete a Claude di scrivere il modello che ha seguito in `CLAUDE.md` in modo che le sessioni future lo corrispondano senza il riferimento"

1159 },

1160 "add-a-small-well": {

1161 title: "Aggiungere una piccola funzionalità ben definita",

1162 teaches: "Dichiarate gli input e gli output, non come costruirla. Claude trova dove vive il codice simile e aggiunge il vostro accanto."

1163 },

1164 "build-a-small-internal": {

1165 title: "Costruire un piccolo strumento interno da zero",

1166 teaches: "Non avete bisogno di un progetto, un framework, o un passo di build. Descrivete lo strumento e chiedete a Claude di aprirlo in modo che lo vediate funzionare immediatamente."

1167 },

1168 "work-an-issue-end": {

1169 title: "Lavorare un problema da capo a fondo",

1170 teaches: "Date il numero del problema, non un riepilogo. Claude legge il ticket completo stesso, così i requisiti che dimentichereste di menzionare vengono attraversati, e valida il cambiamento prima di riferire."

1171 },

1172 "find-and-update-copy": {

1173 title: "Trovare e aggiornare il testo in tutta la codebase",

1174 teaches: "Chiedete varianti e dite cosa saltare. Claude trova fraseologie che una ricerca letterale perderebbe e lascia i fixture di test e la cronologia intatti, così rivedete solo il testo che gli utenti effettivamente vedono."

1175 },

1176 "draft-from-past-examples": {

1177 title: "Bozza di un documento da esempi passati",

1178 teaches: "Puntate a una cartella di lavoro finita invece di descrivere il vostro stile. Claude impara la struttura e la voce da quello che avete già spedito, così la prima bozza legge come una delle vostre.",

1179 next: "Salvate la voce come una skill in modo che ogni bozza inizi lì"

1180 },

1181 "write-tests-run-them": {

1182 title: "Scrivere test, eseguirli, correggere i fallimenti",

1183 teaches: "Chiedete di scrivere, eseguire e correggere insieme in modo che Claude iteri senza fermarsi per istruzioni.",

1184 next: "Eseguite `/init` in modo che Claude impari automaticamente il vostro comando di test"

1185 },

1186 "drive-implementation-from-tests": {

1187 title: "Guidare l'implementazione dai test",

1188 teaches: "Test-driven development: i test definiscono quando il lavoro è completo, e Claude itera sull'implementazione finché non passano."

1189 },

1190 "fill-gaps-from-a": {

1191 title: "Riempire le lacune da un rapporto di copertura",

1192 teaches: "Puntate al rapporto di copertura invece di indovinare cosa non è testato. Claude legge i numeri effettivi e scrive test per i file che ne hanno più bisogno.",

1193 next: "Impostate questo come un `/goal` in modo che Claude continui a scrivere test finché la copertura non raggiunge l'obiettivo"

1194 },

1195 "port-code-between-languages": {

1196 title: "Portare il codice in un'altra lingua",

1197 teaches: "Dite cosa preservare, non solo il linguaggio di destinazione. Nominare l'API o il comportamento che deve rimanere lo stesso dà a Claude un contratto per verificare il port."

1198 },

1199 "generate-docs-for-code": {

1200 title: "Generare documentazione per codice non documentato",

1201 teaches: "Nominate l'ambito e il formato. Claude trova cosa manca e corrisponde allo stile di commento già nel file, così la nuova documentazione legge come il resto."

1202 },

1203 "migrate-a-pattern-across": {

1204 title: "Migrare un modello in tutta la codebase",

1205 teaches: "Descrivete il vecchio modello e il nuovo. Chiedere a Claude di identificare prima ogni posto significa che i siti di chiamata sono elencati nella risposta, così potete controllare che nessuno sia stato perso."

1206 },

1207 "optimize-against-a-measurable": {

1208 title: "Ottimizzare rispetto a un obiettivo misurabile",

1209 teaches: "Dichiarare la metrica e l'obiettivo dà a Claude una chiara definizione di fatto.",

1210 next: "Impostate questo come un `/goal` in modo che Claude continui a misurare e iterare finché non raggiunge il numero"

1211 },

1212 "fix-a-precise-visual": {

1213 title: "Correggere un bug visivo preciso",

1214 teaches: "Un feedback visivo preciso ottiene una correzione precisa. Dichiarate l'elemento esatto, la misurazione e il viewport.",

1215 next: "Aggiungete uno strumento di anteprima in modo che Claude faccia uno screenshot e verifichi la correzione stessa"

1216 },

1217 "review-your-changes-before": {

1218 title: "Rivedere i vostri cambiamenti prima di eseguire il commit",

1219 teaches: "Catturate i problemi mentre sono ancora economici da correggere. Claude legge i file modificati per intero, non solo le righe diff, così individua i problemi che una rapida auto-revisione perde.",

1220 next: "Eseguite `/code-review` per lo stesso controllo in un comando"

1221 },

1222 "review-a-pull-request": {

1223 title: "Rivedere una pull request",

1224 teaches: "Claude rivede con l'intera codebase in contesto, non solo il diff. Legge il codice modificato e quello che chiama, così cattura i problemi che una revisione solo diff perderebbe.",

1225 next: "Attivate questo per ogni PR con Code Review"

1226 },

1227 "review-infrastructure-changes-before": {

1228 title: "Rivedere i cambiamenti dell'infrastruttura prima di applicare",

1229 teaches: "L'output del piano è denso e difficile da scansionare. Incollarlo vi dà un riepilogo in linguaggio semplice di cosa effettivamente cambierà prima di applicarlo."

1230 },

1231 "run-a-security-review": {

1232 title: "Eseguire una revisione di sicurezza con un subagent",

1233 teaches: "Un [subagent](/it/sub-agents) esegue l'audit nel suo proprio context window e riferisce un riepilogo, così una lunga revisione di sicurezza non riempie la vostra sessione principale. Il subagent generico integrato gestisce questo senza configurazione aggiuntiva.",

1234 next: "Configurate un subagent dedicato security-review che tutto il vostro team può usare"

1235 },

1236 "review-content-before-sending": {

1237 title: "Catturare i problemi prima della revisione formale",

1238 teaches: "Ottenete un primo passaggio prima che un umano spenda tempo su di esso. Nominate i problemi che volete controllati in modo che la revisione sia focalizzata, quindi correggete quello che trova e inviate una bozza più pulita.",

1239 next: "Catturate la vostra lista di controllo di revisione come una skill che tutto il vostro team può eseguire"

1240 },

1241 "course-correct-a-wrong": {

1242 title: "Correggere il corso di un approccio sbagliato",

1243 teaches: "Nominate il vincolo che Claude ha perso, non solo che è sbagliato. Una ragione specifica dà a Claude un vincolo concreto da soddisfare al nuovo tentativo, invece di indovinare di nuovo.",

1244 next: "Premete `Esc` due volte per aprire il menu di rewind e ripristinare il codice e la conversazione in modo che il nuovo tentativo inizi pulito"

1245 },

1246 "narrow-the-scope-of": {

1247 title: "Restringere l'ambito di un cambiamento",

1248 teaches: "Quando la direzione è giusta ma il cambiamento è diventato troppo ampio, chiedete a Claude di mantenere parte di esso piuttosto che fare il rewind di tutto. Un confine dichiarato mantiene una piccola correzione dal diventare un refactoring."

1249 },

1250 "turn-a-correction-into": {

1251 title: "Trasformare una correzione in una regola",

1252 teaches: "Una correzione in chat non è condivisa con il vostro team. Una regola nel [CLAUDE.md](/it/memory) del progetto è condivisa una volta che la eseguite il commit, e Claude la legge all'inizio di ogni sessione.",

1253 next: "Aprite `/memory` per rivedere quello che Claude ha scritto"

1254 },

1255 "resolve-merge-conflicts": {

1256 title: "Risolvere i conflitti di merge",

1257 teaches: "Dite quale stato volete, non quali marcatori mantenere. Chiedere il ragionamento rende il merge revisionabile invece di una scatola nera."

1258 },

1259 "commit-with-a-generated": {

1260 title: "Eseguire il commit con un messaggio generato",

1261 teaches: "Lasciate che Claude derivi il messaggio dal diff. Corrisponde allo stile di commit esistente del vostro repository."

1262 },

1263 "open-a-pull-request": {

1264 title: "Aprire una pull request da un ticket",

1265 teaches: "Saltate il cambio di contesto tra tracker, editor e GitHub. Un prompt legge la specifica, fa il cambiamento e apre la PR."

1266 },

1267 "draft-release-notes-from": {

1268 title: "Bozza di note di rilascio dalla cronologia git",

1269 teaches: "Date due punti di riferimento e la struttura che volete. Claude legge il log dei commit tra di loro e bozza un changelog che potete modificare.",

1270 next: "Salvate questo come una skill `/changelog`"

1271 },

1272 "write-a-ci-workflow": {

1273 title: "Scrivere un workflow CI",

1274 teaches: "Descrivete quando dovrebbe eseguire e cosa dovrebbe fare; lo YAML è generato per voi, abbinato ai vostri comandi di build e test del progetto."

1275 },

1276 "find-and-fix-a": {

1277 title: "Trovare e correggere un test fallito",

1278 teaches: "Descrivete il sintomo; non avete bisogno di sapere quale file è rotto. Claude esegue il test per vedere il fallimento, lo traccia nel sorgente e lo corregge."

1279 },

1280 "investigate-a-reported-error": {

1281 title: "Investigare un errore segnalato",

1282 teaches: "Descrivete il sintomo e la posizione; Claude legge il percorso di codice rilevante e traccia le cause probabili. Incollate stack trace o log se li avete.",

1283 next: "Mettete un deeplink nel vostro runbook che apre Claude con questo prompt pre-compilato"

1284 },

1285 "fix-a-build-error": {

1286 title: "Correggere un errore di build alla radice",

1287 teaches: "Chiedere la causa radice e la verifica previene patch superficiali che sopprimono l'errore senza correggerlo."

1288 },

1289 "investigate-a-production-incident": {

1290 title: "Investigare un incidente di produzione",

1291 teaches: "Elencate le fonti di evidenza da correlare, non i passaggi da intraprendere. Claude legge log, cronologia git e config insieme per restringere la causa.",

1292 next: "Collegate Sentry o il vostro log store tramite MCP"

1293 },

1294 "query-logs-in-plain": {

1295 title: "Interrogare i log in inglese semplice",

1296 teaches: "Fate la domanda invece di scrivere l'SQL. Claude costruisce la query, la esegue contro i vostri log collegati, e mostra sia la query che il risultato in modo che possiate controllare cosa è stato eseguito."

1297 },

1298 "diagnose-from-a-console": {

1299 title: "Diagnosticare da uno screenshot della console",

1300 teaches: "Le console cloud vi mostrano il problema ma non i comandi per correggerlo. Claude legge lo screenshot e traduce il dashboard nei comandi kubectl, gcloud o aws da eseguire."

1301 },

1302 "analyze-a-data-file": {

1303 title: "Analizzare un file di dati",

1304 teaches: "Una domanda una tantum non ha bisogno di uno script una tantum. Puntate a un file nella vostra cartella di progetto e Claude lo legge direttamente, trova i modelli e scrive l'output dove lo chiedete.",

1305 next: "Collegate la fonte di dati tramite MCP invece di esportare file"

1306 },

1307 "generate-variations-from-performance": {

1308 title: "Generare variazioni dai dati di performance",

1309 teaches: "Dichiarate il vincolo all'inizio in modo che la generazione rimanga entro il limite. Claude legge le metriche, sceglie cosa sostituire e produce alternative che si adattano.",

1310 next: "Collegate la piattaforma pubblicitaria tramite MCP invece di esportare un file"

1311 },

1312 "turn-a-recurring-task": {

1313 title: "Trasformare un'attività ricorrente in una skill",

1314 teaches: "Nominate i passaggi una volta; riutilizzateli come comando. Claude scrive una [skill](/it/skills) che chiunque nel vostro team può eseguire."

1315 },

1316 "add-a-hook-for": {

1317 title: "Aggiungere un hook per il comportamento ripetuto",

1318 teaches: "Gli hook rendono un comportamento automatico invece di qualcosa che dovete ricordare di chiedere. Descrivete il trigger e l'azione e Claude scrive la configurazione [hook](/it/hooks)."

1319 },

1320 "connect-a-tool-with": {

1321 title: "Connettere uno strumento con MCP",

1322 teaches: "Collegate la fonte una volta invece di incollare i dati ogni sessione. Dopo la configurazione [MCP](/it/mcp), Claude legge dallo strumento direttamente quando lo chiedete."

1323 },

1324 "capture-what-to-remember": {

1325 title: "Catturare cosa ricordare per la prossima volta",

1326 teaches: "Chiedete prima di dimenticare. Claude sa cosa ha dovuto capire questa sessione e propone voci [CLAUDE.md](/it/memory) in modo che la sessione successiva inizi con quel contesto."

1327 }

1328};

1329 

1330<PromptLibrary text={text} labels={labels} tagLabels={tagLabels} phaseLabels={phaseLabels} sourceLabels={sourceLabels} catLabels={catLabels} />

1331 

13<h2 id="what-makes-these-prompts-work">1332<h2 id="what-makes-these-prompts-work">

14 Cosa rende questi prompt efficaci1333 Cosa rende questi prompt efficaci

15</h2>1334</h2>

Details

119 119 

120In una sessione di terminale interattiva, un indicatore `/rc active` si trova nel footer sotto la casella di input mentre la connessione è attiva, ed è nascosto se il terminale è troppo stretto per contenerlo. Il testo dell'indicatore è un collegamento alla sessione su claude.ai. Selezionalo con il tasto freccia giù e premi Invio, oppure esegui `/remote-control` di nuovo, per aprire un pannello di stato con l'URL della sessione e un codice QR che puoi utilizzare per [connetterti da un altro dispositivo](#connect-from-another-device).120In una sessione di terminale interattiva, un indicatore `/rc active` si trova nel footer sotto la casella di input mentre la connessione è attiva, ed è nascosto se il terminale è troppo stretto per contenerlo. Il testo dell'indicatore è un collegamento alla sessione su claude.ai. Selezionalo con il tasto freccia giù e premi Invio, oppure esegui `/remote-control` di nuovo, per aprire un pannello di stato con l'URL della sessione e un codice QR che puoi utilizzare per [connetterti da un altro dispositivo](#connect-from-another-device).

121 121 

122Se la connessione non riesce, l'indicatore diventa rosso e legge `/rc failed`. Selezionalo con il tasto freccia giù e premi Invio per vedere il motivo dell'errore e un'opzione di chiusura, oppure esegui `/remote-control` di nuovo per riprovare.122Se la connessione non riesce, una notifica appare con il motivo dell'errore e l'indicatore scompare dal footer. Esegui `/remote-control` di nuovo per riprovare.

123 123 

124<h3 id="connect-from-another-device">124<h3 id="connect-from-another-device">

125 Connettiti da un altro dispositivo125 Connettiti da un altro dispositivo


206* Su iOS, le modalità Focus e i riepiloghi delle notifiche possono sopprimere o ritardare le notifiche push. Controlla Impostazioni → Notifiche → Claude.206* Su iOS, le modalità Focus e i riepiloghi delle notifiche possono sopprimere o ritardare le notifiche push. Controlla Impostazioni → Notifiche → Claude.

207* Su Android, l'ottimizzazione aggressiva della batteria può ritardare la consegna. Escludi l'app Claude dall'ottimizzazione della batteria nelle impostazioni di sistema.207* Su Android, l'ottimizzazione aggressiva della batteria può ritardare la consegna. Escludi l'app Claude dall'ottimizzazione della batteria nelle impostazioni di sistema.

208 208 

209Claude Code salta le notifiche push mobili mentre stai digitando o sei concentrato sul terminale connesso. {/* min-version: 2.1.181 */}A partire da v2.1.181, puoi impostare [`CLAUDE_CLIENT_PRESENCE_FILE`](/it/env-vars) su un percorso di file marcatore per estendere questo a qualsiasi momento in cui sei alla macchina, anche in un'altra finestra: le notifiche vengono saltate mentre il file esiste. Configura un listener di blocco dello schermo o uno strumento simile per creare il file quando lo schermo si sblocca ed eliminarlo quando lo schermo si blocca.

210 

209<h2 id="limitations">211<h2 id="limitations">

210 Limitazioni212 Limitazioni

211</h2>213</h2>


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

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

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

217* **Alcuni comandi sono solo locali**: i comandi che aprono un selettore interattivo nel terminale, come `/plugin` o `/resume`, funzionano solo dalla CLI locale. I comandi che producono output di testo, inclusi `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, e `/reload-plugins`, funzionano da mobile e web. {/* min-version: 2.1.166 */}A partire dalla v2.1.166, `/mcp` funziona anche da mobile e web: restituisce un riepilogo testuale dello stato del server invece di aprire il selettore, e accetta gli stessi [sottocomandi](/it/commands#all-commands) della CLI locale, con una differenza: da mobile e web, `/mcp reconnect` senza nome del server riconnette ogni server che ha avuto un errore o necessita autenticazione, mentre la CLI locale richiede un nome del server per `reconnect`.219* **Alcuni comandi sono solo locali**: i comandi che aprono un selettore interattivo nel terminale, come `/plugin` o `/resume`, funzionano solo dalla CLI locale. I seguenti funzionano da mobile e web:

220 * Comandi con output di testo: `/compact`, `/clear`, `/context`, `/usage`, `/exit`, `/usage-credits`, `/recap`, `/reload-plugins`

221 * {/* min-version: 2.1.166 */}`/mcp`, dalla v2.1.166: restituisce un riepilogo testuale dello stato del server invece di aprire il selettore, e accetta i [sottocomandi](/it/commands#all-commands) `reconnect`, `enable` e `disable`. A differenza della CLI locale, `/mcp reconnect` senza nome del server riconnette ogni server che ha avuto un errore o necessita autenticazione.

222 * {/* min-version: 2.1.181 */}`/config`, dalla v2.1.181: passa `key=value` per impostare un'impostazione, o eseguilo senza argomenti per elencare le chiavi che puoi impostare.

218 223 

219<h2 id="troubleshooting">224<h2 id="troubleshooting">

220 Risoluzione dei problemi225 Risoluzione dei problemi

sandboxing.md +2 −0

Details

373* **I comandi falliscono con un errore host-not-allowed**: molti strumenti CLI devono raggiungere host specifici. Concedere l'autorizzazione quando richiesto aggiunge l'host al tuo elenco consentito in modo che lo strumento venga eseguito all'interno della sandbox in futuro.373* **I comandi falliscono con un errore host-not-allowed**: molti strumenti CLI devono raggiungere host specifici. Concedere l'autorizzazione quando richiesto aggiunge l'host al tuo elenco consentito in modo che lo strumento venga eseguito all'interno della sandbox in futuro.

374* **`jest` si blocca o fallisce**: `watchman` è incompatibile con la sandbox. Esegui `jest --no-watchman` invece.374* **`jest` si blocca o fallisce**: `watchman` è incompatibile con la sandbox. Esegui `jest --no-watchman` invece.

375* **I CLI basati su Go falliscono la verifica TLS su macOS**: strumenti come `gh`, `gcloud` e `terraform` potrebbero fallire la verifica TLS sotto Seatbelt. Elenca questi strumenti in `excludedCommands` per eseguirli al di fuori della sandbox. Se stai utilizzando `httpProxyPort` con un proxy MITM e CA personalizzato, imposta [`enableWeakerNetworkIsolation`](/it/settings#sandbox-settings) su `true` invece.375* **I CLI basati su Go falliscono la verifica TLS su macOS**: strumenti come `gh`, `gcloud` e `terraform` potrebbero fallire la verifica TLS sotto Seatbelt. Elenca questi strumenti in `excludedCommands` per eseguirli al di fuori della sandbox. Se stai utilizzando `httpProxyPort` con un proxy MITM e CA personalizzato, imposta [`enableWeakerNetworkIsolation`](/it/settings#sandbox-settings) su `true` invece.

376* **`open`, `osascript`, o i flussi di autenticazione basati su browser falliscono con errore `-600` su macOS**: la sandbox blocca gli Apple Events per impostazione predefinita. Imposta [`allowAppleEvents`](/it/settings#sandbox-settings) su `true` nelle impostazioni utente, gestite o CLI per consentirli. Le impostazioni del progetto vengono ignorate per questa chiave. L'abilitazione rimuove l'isolamento dell'esecuzione del codice, poiché i comandi sandboxati possono quindi avviare altre applicazioni non sandboxate senza prompt dell'utente e inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso dell'automazione macOS (TCC). In alternativa, aggiungi il comando a `excludedCommands` per eseguirlo al di fuori della sandbox.

376* **I comandi `docker` falliscono**: `docker` è incompatibile con la sandbox. Aggiungi `docker *` a `excludedCommands` per eseguirlo al di fuori della sandbox.377* **I comandi `docker` falliscono**: `docker` è incompatibile con la sandbox. Aggiungi `docker *` a `excludedCommands` per eseguirlo al di fuori della sandbox.

377* **Bubblewrap non riesce ad avviarsi all'interno di un container**: in un container senza privilegi, bubblewrap non può montare un filesystem `/proc` fresco. Imposta [`enableWeakerNestedSandbox`](/it/settings#sandbox-settings) su `true` in modo che la sandbox interna bind-monti il `/proc` esistente del container invece. Utilizza questa impostazione solo quando il container esterno fornisce già il confine di isolamento di cui hai bisogno, poiché espone le informazioni del processo ai comandi sandboxati che un mount `/proc` fresco nasconderebbe.378* **Bubblewrap non riesce ad avviarsi all'interno di un container**: in un container senza privilegi, bubblewrap non può montare un filesystem `/proc` fresco. Imposta [`enableWeakerNestedSandbox`](/it/settings#sandbox-settings) su `true` in modo che la sandbox interna bind-monti il `/proc` esistente del container invece. Utilizza questa impostazione solo quando il container esterno fornisce già il confine di isolamento di cui hai bisogno, poiché espone le informazioni del processo ai comandi sandboxati che un mount `/proc` fresco nasconderebbe.

378* **Filtro seccomp su Linux**: il filtro seccomp è richiesto per bloccare i socket di dominio Unix. La scheda Dependencies in `/sandbox` mostra se è disponibile. Se manca, esegui `npm install -g @anthropic-ai/sandbox-runtime` per installare l'helper.379* **Filtro seccomp su Linux**: il filtro seccomp è richiesto per bloccare i socket di dominio Unix. La scheda Dependencies in `/sandbox` mostra se è disponibile. Se manca, esegui `npm install -g @anthropic-ai/sandbox-runtime` per installare l'helper.


397* **Escalation dei privilegi tramite socket Unix**: la configurazione `allowUnixSockets` può inavvertitamente concedere l'accesso a potenti servizi di sistema che potrebbero portare a bypass della sandbox. Ad esempio, consentire l'accesso a `/var/run/docker.sock` concede effettivamente l'accesso al sistema host attraverso il socket Docker. Considera attentamente qualsiasi socket Unix che consenti attraverso la sandbox.398* **Escalation dei privilegi tramite socket Unix**: la configurazione `allowUnixSockets` può inavvertitamente concedere l'accesso a potenti servizi di sistema che potrebbero portare a bypass della sandbox. Ad esempio, consentire l'accesso a `/var/run/docker.sock` concede effettivamente l'accesso al sistema host attraverso il socket Docker. Considera attentamente qualsiasi socket Unix che consenti attraverso la sandbox.

398* **Escalation dei permessi del filesystem**: i permessi di scrittura del filesystem eccessivamente ampi possono abilitare attacchi di escalation dei privilegi. Consentire scritture a directory contenenti eseguibili in `$PATH`, directory di configurazione di sistema o file di configurazione della shell dell'utente come `.bashrc` o `.zshrc` può portare all'esecuzione di codice in diversi contesti di sicurezza quando altri utenti o processi di sistema accedono a questi file.399* **Escalation dei permessi del filesystem**: i permessi di scrittura del filesystem eccessivamente ampi possono abilitare attacchi di escalation dei privilegi. Consentire scritture a directory contenenti eseguibili in `$PATH`, directory di configurazione di sistema o file di configurazione della shell dell'utente come `.bashrc` o `.zshrc` può portare all'esecuzione di codice in diversi contesti di sicurezza quando altri utenti o processi di sistema accedono a questi file.

399* **Forza della sandbox Linux**: l'implementazione Linux fornisce un forte isolamento del filesystem e della rete ma include una modalità `enableWeakerNestedSandbox` che le consente di funzionare all'interno di ambienti Docker senza namespace privilegiati, o su host Linux dove gli spazi dei nomi utente senza privilegi sono disabilitati da sysctl. Questa opzione indebolisce considerevolmente la sicurezza e dovrebbe essere utilizzata solo quando l'isolamento aggiuntivo è altrimenti applicato.400* **Forza della sandbox Linux**: l'implementazione Linux fornisce un forte isolamento del filesystem e della rete ma include una modalità `enableWeakerNestedSandbox` che le consente di funzionare all'interno di ambienti Docker senza namespace privilegiati, o su host Linux dove gli spazi dei nomi utente senza privilegi sono disabilitati da sysctl. Questa opzione indebolisce considerevolmente la sicurezza e dovrebbe essere utilizzata solo quando l'isolamento aggiuntivo è altrimenti applicato.

401* **Apple Events su macOS**: la sandbox macOS blocca gli Apple Events per impostazione predefinita. L'impostazione `allowAppleEvents` rimuove questa restrizione in modo che strumenti come `open` e `osascript` funzionino, ma rimuove l'isolamento dell'esecuzione del codice: i comandi sandboxati possono avviare altre applicazioni senza sandbox senza alcun prompt dell'utente, e possono inviare comandi AppleScript alle applicazioni in esecuzione, soggetti al prompt di consenso per l'automazione macOS per app (TCC). È onorato solo dalle impostazioni utente, gestite o CLI. Le impostazioni del progetto non possono abilitarlo.

400* **File di impostazioni protetti**: la sandbox nega automaticamente l'accesso in scrittura ai file `settings.json` di Claude Code a ogni ambito e alla directory delle impostazioni gestite, quindi un comando sandboxato non può modificare la sua stessa politica.402* **File di impostazioni protetti**: la sandbox nega automaticamente l'accesso in scrittura ai file `settings.json` di Claude Code a ogni ambito e alla directory delle impostazioni gestite, quindi un comando sandboxato non può modificare la sua stessa politica.

401 403 

402<h3 id="platform-and-tool-compatibility">404<h3 id="platform-and-tool-compatibility">

settings.md +13 −6

Details

6 6 

7> Configura Claude Code con impostazioni globali e a livello di progetto, e variabili di ambiente.7> Configura Claude Code con impostazioni globali e a livello di progetto, e variabili di ambiente.

8 8 

9Claude Code offre una varietà di impostazioni per configurare il suo comportamento in base alle vostre esigenze. Potete configurare Claude Code eseguendo il comando `/config` quando utilizzate il REPL interattivo, che apre un'interfaccia Impostazioni con schede dove potete visualizzare le informazioni di stato e modificare le opzioni di configurazione.9Claude Code offre una varietà di impostazioni per configurare il suo comportamento in base alle vostre esigenze. Potete configurare Claude Code eseguendo il comando `/config`, che apre un'interfaccia Impostazioni con schede dove potete visualizzare le informazioni di stato e modificare le opzioni di configurazione. {/* min-version: 2.1.181 */}A partire dalla versione 2.1.181, potete modificare una singola opzione senza aprire l'interfaccia passando `key=value` a `/config`, ad esempio `/config verbose=true`.

10 10 

11<h2 id="configuration-scopes">11<h2 id="configuration-scopes">

12 Ambiti di configurazione12 Ambiti di configurazione


234| `awaySummaryEnabled` | Mostra un riepilogo di una riga della sessione quando torni al terminale dopo alcuni minuti di assenza. Imposta a `false` o disattiva Riepilogo sessione in `/config` per disabilitare. Uguale a [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/it/env-vars) | `true` |234| `awaySummaryEnabled` | Mostra un riepilogo di una riga della sessione quando torni al terminale dopo alcuni minuti di assenza. Imposta a `false` o disattiva Riepilogo sessione in `/config` per disabilitare. Uguale a [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/it/env-vars) | `true` |

235| `awsAuthRefresh` | Script personalizzato che modifica la directory `.aws` (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | Script personalizzato che modifica la directory `.aws` (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `aws sso login --profile myprofile` |

236| `awsCredentialExport` | Script personalizzato che restituisce JSON con le credenziali AWS (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | Script personalizzato che restituisce JSON con le credenziali AWS (vedi [configurazione avanzata delle credenziali](/it/amazon-bedrock#advanced-credential-configuration)) | `/bin/generate_aws_grant.sh` |

237| `axScreenReader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. La modalità screen reader utilizza sempre il renderer classico, quindi l'impostazione `tui` non ha effetto mentre è attiva. La variabile di ambiente [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e il flag [`--ax-screen-reader`](/it/cli-reference#cli-flags) hanno la precedenza. Richiede Claude Code v2.1.181 o successivo | `true` |

237| `blockedMarketplaces` | (Solo impostazioni gestite) Elenco di negazione delle fonti del marketplace. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |238| `blockedMarketplaces` | (Solo impostazioni gestite) Elenco di negazione delle fonti del marketplace. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

238| `channelsEnabled` | (Solo impostazioni gestite) Consenti [channels](/it/channels) per l'organizzazione. Nei piani Team e Enterprise di claude.ai, i canali vengono bloccati quando questo non è impostato o è `false`. Per gli account [Anthropic Console](/it/authentication#claude-console-authentication) che utilizzano l'autenticazione con chiave API, i canali sono consentiti per impostazione predefinita a meno che la tua organizzazione non distribuisca impostazioni gestite, nel qual caso questa chiave deve essere impostata a `true` | `true` |239| `channelsEnabled` | (Solo impostazioni gestite) Consenti [channels](/it/channels) per l'organizzazione. Nei piani Team e Enterprise di claude.ai, i canali vengono bloccati quando questo non è impostato o è `false`. Per gli account [Anthropic Console](/it/authentication#claude-console-authentication) che utilizzano l'autenticazione con chiave API, i canali sono consentiti per impostazione predefinita a meno che la tua organizzazione non distribuisca impostazioni gestite, nel qual caso questa chiave deve essere impostata a `true` | `true` |

239| `claudeMd` | (Solo impostazioni gestite) Istruzioni in stile CLAUDE.md iniettate come memoria gestita dall'organizzazione. Onorato solo quando impostato nelle impostazioni gestite o di politica e ignorato nelle impostazioni utente, progetto e locale. Vedi [CLAUDE.md a livello organizzativo](/it/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |240| `claudeMd` | (Solo impostazioni gestite) Istruzioni in stile CLAUDE.md iniettate come memoria gestita dall'organizzazione. Onorato solo quando impostato nelle impostazioni gestite o di politica e ignorato nelle impostazioni utente, progetto e locale. Vedi [CLAUDE.md a livello organizzativo](/it/memory#deploy-organization-wide-claude-md) | `"Always run make lint before committing."` |


244| `deniedMcpServers` | Quando impostato in managed-settings.json, elenco di negazione dei MCP server che sono esplicitamente bloccati. Si applica a tutti gli ambiti inclusi i server gestiti. L'elenco di negazione ha la precedenza sull'elenco di autorizzazione. Vedi [Configurazione MCP gestita](/it/managed-mcp) | `[{ "serverName": "filesystem" }]` |245| `deniedMcpServers` | Quando impostato in managed-settings.json, elenco di negazione dei MCP server che sono esplicitamente bloccati. Si applica a tutti gli ambiti inclusi i server gestiti. L'elenco di negazione ha la precedenza sull'elenco di autorizzazione. Vedi [Configurazione MCP gestita](/it/managed-mcp) | `[{ "serverName": "filesystem" }]` |

245| `disableAgentView` | Imposta a `true` per disattivare gli [agenti in background e la visualizzazione degli agenti](/it/agent-view): `claude agents`, `--bg`, `/background`, e il supervisore su richiesta. Tipicamente impostato nelle [impostazioni gestite](/it/permissions#managed-settings). Equivalente all'impostazione di `CLAUDE_CODE_DISABLE_AGENT_VIEW` a `1` | `true` |246| `disableAgentView` | Imposta a `true` per disattivare gli [agenti in background e la visualizzazione degli agenti](/it/agent-view): `claude agents`, `--bg`, `/background`, e il supervisore su richiesta. Tipicamente impostato nelle [impostazioni gestite](/it/permissions#managed-settings). Equivalente all'impostazione di `CLAUDE_CODE_DISABLE_AGENT_VIEW` a `1` | `true` |

246| `disableAllHooks` | Disabilita tutti gli [hooks](/it/hooks) e qualsiasi [status line](/it/statusline) personalizzato | `true` |247| `disableAllHooks` | Disabilita tutti gli [hooks](/it/hooks) e qualsiasi [status line](/it/statusline) personalizzato | `true` |

248| `disableArtifact` | Imposta a `true` per disabilitare lo strumento [Artifact](/it/artifacts), che pubblica l'output della sessione come pagina web privata su claude.ai. Equivalente all'impostazione di `CLAUDE_CODE_DISABLE_ARTIFACT` a `1` | `true` |

247| `disableAutoMode` | Imposta a `"disable"` per prevenire l'attivazione della [modalità auto](/it/permission-modes#eliminate-prompts-with-auto-mode). Rimuove `auto` dal ciclo `Shift+Tab` e rifiuta `--permission-mode auto` all'avvio. Molto utile nelle [impostazioni gestite](/it/permissions#managed-settings) dove gli utenti non possono ignorarla | `"disable"` |249| `disableAutoMode` | Imposta a `"disable"` per prevenire l'attivazione della [modalità auto](/it/permission-modes#eliminate-prompts-with-auto-mode). Rimuove `auto` dal ciclo `Shift+Tab` e rifiuta `--permission-mode auto` all'avvio. Molto utile nelle [impostazioni gestite](/it/permissions#managed-settings) dove gli utenti non possono ignorarla | `"disable"` |

248| `disableBundledSkills` | Imposta a `true` per disabilitare gli [skills](/it/skills) e i flussi di lavoro che vengono forniti con Claude Code: gli skills bundled e i flussi di lavoro vengono rimossi completamente, mentre i comandi slash incorporati come `/init` rimangono digitabili ma sono nascosti dal modello. Gli skills dai plugin, `.claude/skills/`, e `.claude/commands/` non sono interessati. Equivalente all'impostazione di `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` a `1` | `true` |250| `disableBundledSkills` | Imposta a `true` per disabilitare gli [skills](/it/skills) e i flussi di lavoro che vengono forniti con Claude Code: gli skills bundled e i flussi di lavoro vengono rimossi completamente, mentre i comandi slash incorporati come `/init` rimangono digitabili ma sono nascosti dal modello. Gli skills dai plugin, `.claude/skills/`, e `.claude/commands/` non sono interessati. Equivalente all'impostazione di `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` a `1` | `true` |

251| `disableClaudeAiConnectors` | {/* min-version: 2.1.182 */}Disabilita i [connettori MCP di claude.ai](/it/mcp#use-mcp-servers-from-claude-ai) in modo che non vengano recuperati automaticamente o connessi. Imposta in qualsiasi ambito di impostazioni. `true` in qualsiasi fonte ha la precedenza, quindi un `.claude/settings.json` di progetto controllato può escludere un repository dai connettori cloud, ma un `false` a livello di progetto non può ignorare un `true` a livello utente o di politica. I server passati esplicitamente tramite `--mcp-config` non sono interessati. Per negare i singoli connettori invece di tutti loro, usa [`deniedMcpServers`](/it/managed-mcp). Richiede Claude Code v2.1.182 o successivo | `true` |

249| `disableDeepLinkRegistration` | Imposta a `"disable"` per prevenire che Claude Code registri il gestore del protocollo `claude-cli://` con il sistema operativo all'avvio. I [deep link](/it/deep-links) consentono agli strumenti esterni di aprire una sessione di Claude Code con un prompt pre-compilato. Utile negli ambienti in cui la registrazione del gestore del protocollo è limitata o gestita separatamente | `"disable"` |252| `disableDeepLinkRegistration` | Imposta a `"disable"` per prevenire che Claude Code registri il gestore del protocollo `claude-cli://` con il sistema operativo all'avvio. I [deep link](/it/deep-links) consentono agli strumenti esterni di aprire una sessione di Claude Code con un prompt pre-compilato. Utile negli ambienti in cui la registrazione del gestore del protocollo è limitata o gestita separatamente | `"disable"` |

250| `disabledMcpjsonServers` | Elenco di MCP server specifici dai file `.mcp.json` da rifiutare | `["filesystem"]` |253| `disabledMcpjsonServers` | Elenco di MCP server specifici dai file `.mcp.json` da rifiutare | `["filesystem"]` |

251| `disableRemoteControl` | {/* min-version: 2.1.128 */}Disabilita il [Controllo remoto](/it/remote-control): blocca `claude remote-control`, il flag `--remote-control`, l'avvio automatico e l'interruttore in-sessione. Tipicamente posizionato nelle [impostazioni gestite](/it/permissions#managed-settings) per l'applicazione MDM per dispositivo, ma funziona da qualsiasi ambito. Richiede Claude Code v2.1.128 o successivo | `true` |254| `disableRemoteControl` | {/* min-version: 2.1.128 */}Disabilita il [Controllo remoto](/it/remote-control): blocca `claude remote-control`, il flag `--remote-control`, l'avvio automatico e l'interruttore in-sessione. Tipicamente posizionato nelle [impostazioni gestite](/it/permissions#managed-settings) per l'applicazione MDM per dispositivo, ma funziona da qualsiasi ambito. Richiede Claude Code v2.1.128 o successivo | `true` |


288| `preferredNotifChannel` | Metodo per le notifiche di completamento attività e prompt di permesso: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, o `"notifications_disabled"`. Predefinito: `"auto"`, che invia una notifica desktop in iTerm2, Ghostty e Kitty e non fa nulla in altri terminali. Imposta `"terminal_bell"` per suonare il carattere di campanello in qualsiasi terminale. Appare in `/config` come **Notifications**. Vedi [Ottieni un campanello del terminale o una notifica](/it/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |291| `preferredNotifChannel` | Metodo per le notifiche di completamento attività e prompt di permesso: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, o `"notifications_disabled"`. Predefinito: `"auto"`, che invia una notifica desktop in iTerm2, Ghostty e Kitty e non fa nulla in altri terminali. Imposta `"terminal_bell"` per suonare il carattere di campanello in qualsiasi terminale. Appare in `/config` come **Notifications**. Vedi [Ottieni un campanello del terminale o una notifica](/it/terminal-config#get-a-terminal-bell-or-notification) | `"terminal_bell"` |

289| `prefersReducedMotion` | Riduci o disabilita le animazioni dell'interfaccia utente (spinner, shimmer, effetti flash) per l'accessibilità | `true` |292| `prefersReducedMotion` | Riduci o disabilita le animazioni dell'interfaccia utente (spinner, shimmer, effetti flash) per l'accessibilità | `true` |

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

294| `remoteControlAtStartup` | {/* min-version: 2.1.119 */}Connetti il [Controllo remoto](/it/remote-control) automaticamente quando ogni sessione interattiva si avvia, invece di attendere `/remote-control`. Imposta a `true` per connettersi sempre automaticamente, `false` per non connettersi mai automaticamente, o lascia non impostato per seguire il predefinito della tua organizzazione. Appare in `/config` come **Enable Remote Control for all sessions**. Vedi [Abilita il Controllo remoto per tutte le sessioni](/it/remote-control#enable-remote-control-for-all-sessions) | `false` |

291| `requiredMaximumVersion` | Solo impostazioni gestite. Versione massima di Claude Code consentita per l'avvio. Se la versione in esecuzione è più recente, Claude Code esce all'avvio e istruisce l'utente a installare una versione approvata tramite il metodo approvato dell'organizzazione; `claude install <version>` potrebbe anche funzionare. L'auto-aggiornamento in background e `claude update` saltano le versioni sopra il limite, quindi un'installazione in intervallo rimane in intervallo. `claude update`, `claude install`, e `claude doctor` continuano a funzionare sopra il limite in modo che gli utenti possano recuperare. Le versioni che precedono questa impostazione la ignorano | `"2.1.150"` |295| `requiredMaximumVersion` | Solo impostazioni gestite. Versione massima di Claude Code consentita per l'avvio. Se la versione in esecuzione è più recente, Claude Code esce all'avvio e istruisce l'utente a installare una versione approvata tramite il metodo approvato dell'organizzazione; `claude install <version>` potrebbe anche funzionare. L'auto-aggiornamento in background e `claude update` saltano le versioni sopra il limite, quindi un'installazione in intervallo rimane in intervallo. `claude update`, `claude install`, e `claude doctor` continuano a funzionare sopra il limite in modo che gli utenti possano recuperare. Le versioni che precedono questa impostazione la ignorano | `"2.1.150"` |

292| `requiredMinimumVersion` | Solo impostazioni gestite. Versione minima di Claude Code richiesta per l'avvio. Se la versione in esecuzione è più vecchia, Claude Code esce all'avvio e istruisce l'utente ad aggiornare tramite il metodo approvato dell'organizzazione. `claude update`, `claude install`, e `claude doctor` continuano a funzionare sotto il limite in modo che gli utenti possano recuperare. Differisce da `minimumVersion`, che previene i downgrade ma non blocca mai l'avvio. Le versioni che precedono questa impostazione la ignorano | `"2.1.150"` |296| `requiredMinimumVersion` | Solo impostazioni gestite. Versione minima di Claude Code richiesta per l'avvio. Se la versione in esecuzione è più vecchia, Claude Code esce all'avvio e istruisce l'utente ad aggiornare tramite il metodo approvato dell'organizzazione. `claude update`, `claude install`, e `claude doctor` continuano a funzionare sotto il limite in modo che gli utenti possano recuperare. Differisce da `minimumVersion`, che previene i downgrade ma non blocca mai l'avvio. Le versioni che precedono questa impostazione la ignorano | `"2.1.150"` |

297| `respondToBashCommands` | {/* min-version: 2.1.186 */}Se Claude risponde dopo l'esecuzione di un comando shell `!` della casella di input. Imposta a `false` per aggiungere l'output del comando al contesto senza una risposta. Predefinito: `true`. Vedi [Modalità shell con prefisso `!`](/it/interactive-mode#shell-mode-with-prefix). Richiede Claude Code v2.1.186 o successivo | `false` |

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

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

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


305| `strictKnownMarketplaces` | (Solo impostazioni gestite) Elenco di autorizzazione dei marketplace dei plugin. Non definito = nessuna restrizione, array vuoto = blocco. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |310| `strictKnownMarketplaces` | (Solo impostazioni gestite) Elenco di autorizzazione dei marketplace dei plugin. Non definito = nessuna restrizione, array vuoto = blocco. Applicato all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace aggiunto prima che la politica fosse impostata non può essere utilizzato per recuperare i plugin. Vedi [Restrizioni del marketplace gestito](/it/plugin-marketplaces#managed-marketplace-restrictions) | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

306| `strictPluginOnlyCustomization` | (Solo impostazioni gestite) Blocca skills, agenti, hooks e MCP server dalle fonti utente e di progetto, in modo che possano provenire solo da plugin o impostazioni gestite. `true` blocca tutti e quattro; un array blocca solo quelli denominati. Vedi [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |311| `strictPluginOnlyCustomization` | (Solo impostazioni gestite) Blocca skills, agenti, hooks e MCP server dalle fonti utente e di progetto, in modo che possano provenire solo da plugin o impostazioni gestite. `true` blocca tutti e quattro; un array blocca solo quelli denominati. Vedi [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | `["skills", "hooks"]` |

307| `syntaxHighlightingDisabled` | Disabilita l'evidenziazione della sintassi nei diff, nei blocchi di codice e nelle anteprime dei file | `true` |312| `syntaxHighlightingDisabled` | Disabilita l'evidenziazione della sintassi nei diff, nei blocchi di codice e nelle anteprime dei file | `true` |

308| `teammateMode` | Come i compagni di squadra del [team di agenti](/it/agent-teams) vengono visualizzati: `auto` (sceglie riquadri divisi in tmux o iTerm2, in-process altrimenti), `in-process`, o `tmux` (sceglie riquadri divisi usando tmux o iTerm2, rilevato dal tuo terminale). `--teammate-mode` ignora questo per una sessione. Vedi [scegli una modalità di visualizzazione](/it/agent-teams#choose-a-display-mode) | `"in-process"` |313| `teammateMode` | Come i compagni di squadra del [team di agenti](/it/agent-teams) vengono visualizzati: `in-process` (predefinito), `auto` (sceglie riquadri divisi in tmux o iTerm2, in-process altrimenti), `tmux` (sceglie riquadri divisi usando tmux o iTerm2, rilevato dal tuo terminale), o {/* min-version: 2.1.186 */}`iterm2` (riquadri divisi nativi iTerm2 tramite la CLI `it2`, aggiunto in v2.1.186). Il predefinito è cambiato da `auto` in v2.1.179. `--teammate-mode` ignora questo per una sessione. Vedi [scegli una modalità di visualizzazione](/it/agent-teams#choose-a-display-mode) | `"auto"` |

309| `terminalProgressBarEnabled` | Mostra la barra di avanzamento del terminale nei terminali supportati: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Predefinito: `true`. Appare in `/config` come **Terminal progress bar** | `false` |314| `terminalProgressBarEnabled` | Mostra la barra di avanzamento del terminale nei terminali supportati: ConEmu, Ghostty 1.2.0+, e iTerm2 3.6.6+. Predefinito: `true`. Appare in `/config` come **Terminal progress bar** | `false` |

310| `theme` | {/* min-version: 2.1.119 */}Tema di colore per l'interfaccia: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, o un riferimento a tema personalizzato come `"custom:<slug>"` o `"custom:<plugin-name>:<slug>"`. Predefinito: `"dark"`. Vedi [Crea un tema personalizzato](/it/terminal-config#create-a-custom-theme). Appare in `/config` come **Theme** | `"dark"` |315| `theme` | {/* min-version: 2.1.119 */}Tema di colore per l'interfaccia: `"auto"`, `"dark"`, `"light"`, `"dark-daltonized"`, `"light-daltonized"`, `"dark-ansi"`, `"light-ansi"`, o un riferimento a tema personalizzato come `"custom:<slug>"` o `"custom:<plugin-name>:<slug>"`. Predefinito: `"dark"`. Vedi [Crea un tema personalizzato](/it/terminal-config#create-a-custom-theme). Appare in `/config` come **Theme** | `"dark"` |

311| `tui` | Renderer dell'interfaccia utente del terminale. Usa `"fullscreen"` per il renderer [alt-screen](/it/fullscreen) senza sfarfallio con scrollback virtualizzato. Usa `"default"` per il renderer classico della schermata principale. Imposta tramite `/tui`. Puoi anche impostare la variabile di ambiente [`CLAUDE_CODE_NO_FLICKER`](/it/env-vars) | `"fullscreen"` |316| `tui` | Renderer dell'interfaccia utente del terminale. Usa `"fullscreen"` per il renderer [alt-screen](/it/fullscreen) senza sfarfallio con scrollback virtualizzato. Usa `"default"` per il renderer classico della schermata principale. Imposta tramite `/tui`. Puoi anche impostare la variabile di ambiente [`CLAUDE_CODE_NO_FLICKER`](/it/env-vars) | `"fullscreen"` |


389Configura il comportamento avanzato del sandboxing. Il sandboxing isola i comandi bash dal tuo filesystem e dalla rete. Vedi [Sandboxing](/it/sandboxing) per i dettagli.394Configura il comportamento avanzato del sandboxing. Il sandboxing isola i comandi bash dal tuo filesystem e dalla rete. Vedi [Sandboxing](/it/sandboxing) per i dettagli.

390 395 

391| Chiavi | Descrizione | Esempio |396| Chiavi | Descrizione | Esempio |

392| :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------- |397| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------- |

393| `enabled` | Abilita il sandboxing bash (macOS, Linux e WSL2). Predefinito: false | `true` |398| `enabled` | Abilita il sandboxing bash (macOS, Linux e WSL2). Predefinito: false | `true` |

394| `failIfUnavailable` | Esci con un errore all'avvio se `sandbox.enabled` è true ma la sandbox non può avviarsi (dipendenze mancanti, piattaforma non supportata). Quando false (predefinito), viene mostrato un avviso e i comandi vengono eseguiti senza sandbox. Destinato alle distribuzioni di impostazioni gestite che richiedono il sandboxing come gate rigido | `true` |399| `failIfUnavailable` | Esci con un errore all'avvio se `sandbox.enabled` è true ma la sandbox non può avviarsi (dipendenze mancanti, piattaforma non supportata). Quando false (predefinito), viene mostrato un avviso e i comandi vengono eseguiti senza sandbox. Destinato alle distribuzioni di impostazioni gestite che richiedono il sandboxing come gate rigido | `true` |

395| `autoAllowBashIfSandboxed` | Approva automaticamente i comandi bash quando sandboxed. Predefinito: true | `true` |400| `autoAllowBashIfSandboxed` | Approva automaticamente i comandi bash quando sandboxed. Predefinito: true | `true` |


411| `network.socksProxyPort` | Porta del proxy SOCKS5 utilizzata se desideri portare il tuo proxy. Se non specificato, Claude eseguirà il suo proxy. | `8081` |416| `network.socksProxyPort` | Porta del proxy SOCKS5 utilizzata se desideri portare il tuo proxy. Se non specificato, Claude eseguirà il suo proxy. | `8081` |

412| `enableWeakerNestedSandbox` | Abilita una sandbox più debole per gli ambienti Docker senza privilegi (solo Linux e WSL2). **Riduce la sicurezza.** Predefinito: false | `true` |417| `enableWeakerNestedSandbox` | Abilita una sandbox più debole per gli ambienti Docker senza privilegi (solo Linux e WSL2). **Riduce la sicurezza.** Predefinito: false | `true` |

413| `enableWeakerNetworkIsolation` | (Solo macOS) Consenti l'accesso al servizio di fiducia TLS del sistema (`com.apple.trustd.agent`) nella sandbox. Richiesto affinché gli strumenti basati su Go come `gh`, `gcloud` e `terraform` verifichino i certificati TLS quando si utilizza `httpProxyPort` con un proxy MITM e una CA personalizzata. **Riduce la sicurezza** aprendo un potenziale percorso di esfiltrazione dei dati. Predefinito: false | `true` |418| `enableWeakerNetworkIsolation` | (Solo macOS) Consenti l'accesso al servizio di fiducia TLS del sistema (`com.apple.trustd.agent`) nella sandbox. Richiesto affinché gli strumenti basati su Go come `gh`, `gcloud` e `terraform` verifichino i certificati TLS quando si utilizza `httpProxyPort` con un proxy MITM e una CA personalizzata. **Riduce la sicurezza** aprendo un potenziale percorso di esfiltrazione dei dati. Predefinito: false | `true` |

419| `allowAppleEvents` | (Solo macOS) Consenti ai comandi sandboxed di inviare Apple Events. Richiesto per `open`, `osascript`, e strumenti che aprono URL in un browser, che altrimenti falliscono con errore `-600`. **Rimuove l'isolamento dell'esecuzione del codice.** I comandi sandboxed possono lanciare altre applicazioni senza sandbox senza prompt dell'utente; possono anche inviare comandi AppleScript alle applicazioni in esecuzione come Terminal, soggetto al prompt di consenso per-app macOS automation (TCC). Onorato solo dalle impostazioni utente, gestite, o CLI, non dalle impostazioni di progetto. Predefinito: false | `true` |

414| `bwrapPath` | (Solo impostazioni gestite, Linux/WSL2) Percorso assoluto al binario bubblewrap (`bwrap`). Ignora il rilevamento automatico tramite `PATH`. Onorato solo dalle [impostazioni gestite](/it/settings#settings-files), non dalle impostazioni utente o di progetto. Utile quando `bwrap` è installato in una posizione non standard negli ambienti gestiti. | `/opt/admin/bwrap` |420| `bwrapPath` | (Solo impostazioni gestite, Linux/WSL2) Percorso assoluto al binario bubblewrap (`bwrap`). Ignora il rilevamento automatico tramite `PATH`. Onorato solo dalle [impostazioni gestite](/it/settings#settings-files), non dalle impostazioni utente o di progetto. Utile quando `bwrap` è installato in una posizione non standard negli ambienti gestiti. | `/opt/admin/bwrap` |

415| `socatPath` | (Solo impostazioni gestite, Linux/WSL2) Percorso assoluto al binario `socat` utilizzato per il proxy di rete della sandbox. Ignora il rilevamento automatico tramite `PATH`. Onorato solo dalle impostazioni gestite. | `/opt/admin/socat` |421| `socatPath` | (Solo impostazioni gestite, Linux/WSL2) Percorso assoluto al binario `socat` utilizzato per il proxy di rete della sandbox. Ignora il rilevamento automatico tramite `PATH`. Onorato solo dalle impostazioni gestite. | `/opt/admin/socat` |

416 422 


467* Le descrizioni delle pull request sono testo semplice473* Le descrizioni delle pull request sono testo semplice

468 474 

469| Chiavi | Descrizione |475| Chiavi | Descrizione |

470| :------- | :-------------------------------------------------------------------------------------------------------------- |476| :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

471| `commit` | Attribuzione per i commit git, inclusi eventuali trailer. La stringa vuota nasconde l'attribuzione del commit |477| `commit` | Attribuzione per i commit git, inclusi eventuali trailer. La stringa vuota nasconde l'attribuzione del commit |

472| `pr` | Attribuzione per le descrizioni delle pull request. La stringa vuota nasconde l'attribuzione della pull request |478| `pr` | Attribuzione per le descrizioni delle pull request. La stringa vuota nasconde l'attribuzione della pull request |

479| `sessionUrl` | Se aggiungere il link della sessione claude.ai come trailer `Claude-Session` nei commit e un link nelle descrizioni delle pull request quando eseguito da una sessione web o Controllo remoto. Predefinito: `true`. Imposta a `false` per omettere il link |

473 480 

474**Attribuzione predefinita del commit:**481**Attribuzione predefinita del commit:**

475 482 


497```504```

498 505 

499<Note>506<Note>

500 L'impostazione `attribution` ha la precedenza sull'impostazione deprecata `includeCoAuthoredBy`. Per nascondere tutta l'attribuzione, imposta `commit` e `pr` a stringhe vuote.507 L'impostazione `attribution` ha la precedenza sull'impostazione deprecata `includeCoAuthoredBy`. Per nascondere tutta l'attribuzione, imposta `commit` e `pr` a stringhe vuote e `sessionUrl` a `false`.

501</Note>508</Note>

502 509 

503<h3 id="file-suggestion-settings">510<h3 id="file-suggestion-settings">


678 685 

679La riga `Setting sources` conferma quali fonti vengono lette. Non mostra quale livello ha fornito ogni singola chiave. La scheda **Config** nello stesso dialogo è un editor per un insieme fisso di interruttori come tema e output dettagliato, non una visualizzazione dei contenuti del tuo `settings.json`.686La riga `Setting sources` conferma quali fonti vengono lette. Non mostra quale livello ha fornito ogni singola chiave. La scheda **Config** nello stesso dialogo è un editor per un insieme fisso di interruttori come tema e output dettagliato, non una visualizzazione dei contenuti del tuo `settings.json`.

680 687 

681Se un file di impostazioni contiene errori, come JSON non valido o un valore che non supera la convalida, Claude Code mostra un avviso di problemi di configurazione all'avvio e `/status` elenca i file interessati. Esegui `/doctor` per i dettagli di ogni errore.688Se un file di impostazioni contiene errori, come JSON non valido o un valore che non supera la convalida, `/status` elenca i file interessati. Esegui `/doctor` per i dettagli di ogni errore.

682 689 

683<h3 id="key-points-about-the-configuration-system">690<h3 id="key-points-about-the-configuration-system">

684 Punti chiave sul sistema di configurazione691 Punti chiave sul sistema di configurazione

skills.md +38 −1

Details

173 173 

174Il flag `--add-dir` e il comando `/add-dir` [concedono l'accesso ai file](/it/permissions#additional-directories-grant-file-access-not-configuration) piuttosto che la scoperta della configurazione, ma le skills sono un'eccezione: `.claude/skills/` all'interno di una directory aggiunta viene caricato automaticamente. Questa eccezione si applica solo a `--add-dir` e `/add-dir`. L'impostazione `permissions.additionalDirectories` in `settings.json` concede solo l'accesso ai file e non carica le skills. Vedi [Rilevamento dei cambiamenti in tempo reale](#live-change-detection) per come gli edits vengono rilevati durante una sessione.174Il flag `--add-dir` e il comando `/add-dir` [concedono l'accesso ai file](/it/permissions#additional-directories-grant-file-access-not-configuration) piuttosto che la scoperta della configurazione, ma le skills sono un'eccezione: `.claude/skills/` all'interno di una directory aggiunta viene caricato automaticamente. Questa eccezione si applica solo a `--add-dir` e `/add-dir`. L'impostazione `permissions.additionalDirectories` in `settings.json` concede solo l'accesso ai file e non carica le skills. Vedi [Rilevamento dei cambiamenti in tempo reale](#live-change-detection) per come gli edits vengono rilevati durante una sessione.

175 175 

176Altre configurazioni `.claude/` come subagent, comandi e stili di output non vengono caricate da directory aggiuntive. Vedi la [tabella delle eccezioni](/it/permissions#additional-directories-grant-file-access-not-configuration) per l'elenco completo di ciò che viene e non viene caricato, e i modi consigliati per condividere la configurazione tra i progetti.176Altre configurazioni `.claude/` come comandi e stili di output non vengono caricate da directory aggiuntive. Vedi la [tabella delle eccezioni](/it/permissions#additional-directories-grant-file-access-not-configuration) per l'elenco completo di ciò che viene e non viene caricato, e i modi consigliati per condividere la configurazione tra i progetti.

177 177 

178<Note>178<Note>

179 I file CLAUDE.md da directory `--add-dir` non vengono caricati per impostazione predefinita. Per caricarli, imposta `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Vedi [Carica da directory aggiuntive](/it/memory#load-from-additional-directories).179 I file CLAUDE.md da directory `--add-dir` non vengono caricati per impostazione predefinita. Per caricarli, imposta `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`. Vedi [Carica da directory aggiuntive](/it/memory#load-from-additional-directories).


632 632 

633Le skills dei plugin non sono interessate da `skillOverrides`. Gestisci quelle tramite `/plugin` invece.633Le skills dei plugin non sono interessate da `skillOverrides`. Gestisci quelle tramite `/plugin` invece.

634 634 

635<h2 id="evaluate-and-iterate-on-a-skill">

636 Valuta e itera su una skill

637</h2>

638 

639Vedere una skill attivarsi ti dice che Claude l'ha trovata, non che ha fatto quello che intendevi. Per sapere che una skill funziona, misura due cose separatamente: se Claude la invoca sui prompt che dovrebbe, e se l'output corrisponde a quello che ti aspetti quando lo fa.

640 

641Il controllo per entrambi è un confronto di base. Raccogli alcuni prompt realistici, esegui ciascuno in una sessione nuova con la skill disponibile e di nuovo con essa [disabilitata](#override-skill-visibility-from-settings), e confronta i risultati. Una sessione nuova è importante perché il contesto residuo dall'authoring della skill maschererà le lacune nelle istruzioni scritte.

642 

643<h3 id="run-evals-with-skill-creator">

644 Esegui evals con skill-creator

645</h3>

646 

647Il [plugin `skill-creator`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator) automatizza il loop di confronto all'interno di Claude Code. Installalo dal marketplace ufficiale:

648 

649```text theme={null}

650/plugin install skill-creator@claude-plugins-official

651```

652 

653Se Claude Code segnala che il plugin non viene trovato in nessun marketplace, il tuo marketplace è mancante o obsoleto. Esegui `/plugin marketplace update claude-plugins-official` per aggiornarlo, o `/plugin marketplace add anthropics/claude-plugins-official` se non l'hai ancora aggiunto. Quindi riprova l'installazione.

654 

655Dopo l'installazione, esegui `/reload-plugins` per rendere disponibili le skills del plugin nella sessione attuale. Quindi chiedi a Claude di valutare una skill esistente, ad esempio `evaluate my summarize-changes skill with skill-creator`. Il plugin ti guida attraverso la scrittura di test case ed esegue il loop:

656 

657* **Test cases**: memorizza prompt, file di input e comportamento previsto in `evals/evals.json` all'interno della directory della skill

658* **Isolated runs**: genera un [subagent](/it/sub-agents) per test case in modo che ogni esecuzione inizi con un contesto pulito, e registra il conteggio dei token e la durata

659* **Grading**: controlla ogni asserzione rispetto all'output e scrive pass o fail con evidenza in `grading.json`

660* **Benchmark**: aggrega il tasso di pass, il tempo e i token per con-skill versus senza-skill in `benchmark.json` in modo che tu possa confrontare il miglioramento del tasso di pass rispetto al sovraccarico di token e tempo

661* **Version comparison**: esegue un blind A/B tra due versioni della skill in modo che tu possa confermare che un edit è un miglioramento prima di commitarlo

662* **Description tuning**: genera prompt should-trigger e should-not-trigger, misura il tasso di hit, e propone edits di descrizione quando la skill si attiva su richieste sbagliate

663* **Review viewer**: apre un report HTML dove puoi ispezionare ogni output e registrare feedback qualitativo che l'iterazione successiva legge

664 

665Per il formato del file eval e il flusso di lavoro di iterazione completo, vedi [Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills) su agentskills.io. Per il background sul benchmark e sui modi di confronto, vedi l'[annuncio di skill-creator](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills).

666 

635<h2 id="share-skills">667<h2 id="share-skills">

636 Condividi skills668 Condividi skills

637</h2>669</h2>


8503. Prova a riformulare la tua richiesta per corrispondere più strettamente alla descrizione8823. Prova a riformulare la tua richiesta per corrispondere più strettamente alla descrizione

8514. Invocarla direttamente con `/skill-name` se la skill è invocabile dall'utente8834. Invocarla direttamente con `/skill-name` se la skill è invocabile dall'utente

852 884 

885Se il frontmatter YAML è malformato, Claude Code carica il corpo della skill con metadati vuoti, quindi `/skill-name` funziona comunque ma Claude non ha alcuna `description` per corrispondere. Esegui con `--debug` per vedere l'errore di analisi.

886 

853<h3 id="skill-triggers-too-often">887<h3 id="skill-triggers-too-often">

854 Skill si attiva troppo spesso888 Skill si attiva troppo spesso

855</h3>889</h3>


872</h2>906</h2>

873 907 

874* **[Debug della tua configurazione](/it/debug-your-config)**: diagnostica il motivo per cui una skill non appare o non si attiva908* **[Debug della tua configurazione](/it/debug-your-config)**: diagnostica il motivo per cui una skill non appare o non si attiva

909* **[Valutazione della qualità dell'output della skill](https://agentskills.io/skill-creation/evaluating-skills)**: il formato del file eval e il flusso di lavoro di iterazione su agentskills.io

910* **[Best practice di authoring delle skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**: guida di scrittura che si applica ai prodotti Claude

875* **[Subagents](/it/sub-agents)**: delega attività ad agenti specializzati911* **[Subagents](/it/sub-agents)**: delega attività ad agenti specializzati

876* **[Plugins](/it/plugins)**: pacchetto e distribuisci skills con altre estensioni912* **[Plugins](/it/plugins)**: pacchetto e distribuisci skills con altre estensioni

877* **[Hooks](/it/hooks)**: automatizza i flussi di lavoro intorno agli eventi degli strumenti913* **[Hooks](/it/hooks)**: automatizza i flussi di lavoro intorno agli eventi degli strumenti

878* **[Memory](/it/memory)**: gestisci i file CLAUDE.md per il contesto persistente914* **[Memory](/it/memory)**: gestisci i file CLAUDE.md per il contesto persistente

879* **[Commands](/it/commands)**: riferimento per i comandi integrati e le skills raggruppate915* **[Commands](/it/commands)**: riferimento per i comandi integrati e le skills raggruppate

880* **[Permissions](/it/permissions)**: controlla l'accesso agli strumenti e alle skills916* **[Permissions](/it/permissions)**: controlla l'accesso agli strumenti e alle skills

917* **[Claude Tag skills](https://claude.com/docs/claude-tag/admins/skills-repo)**: le skills del progetto sottoposte a commit in un repository si caricano anche quando quel repository viene utilizzato in un canale Claude Tag

slack.md +15 −1

Details

6 6 

7> Delega i compiti di codifica direttamente dal tuo workspace Slack7> Delega i compiti di codifica direttamente dal tuo workspace Slack

8 8 

9<Note>

10 Claude Code in Slack viene sostituito da [Claude Tag](https://claude.com/docs/claude-tag/overview) per i workspace Team ed Enterprise. Claude Tag esegue @Claude come identità condivisa della tua organizzazione con accesso configurato dall'amministratore, sotto la stessa app Slack, quindi non c'è nulla da reinstallare e le configurazioni esistenti continuano a funzionare durante la transizione. Per passare a un workspace, vedi [Migra dalla versione precedente di Claude in Slack](https://claude.com/docs/claude-tag/admins/migrate-from-earlier).

11</Note>

12 

9Claude Code in Slack porta la potenza di Claude Code direttamente nel tuo workspace Slack. Quando menzioni `@Claude` con un compito di codifica, Claude rileva automaticamente l'intento e crea una sessione Claude Code sul web, permettendoti di delegare il lavoro di sviluppo senza lasciare le conversazioni del tuo team.13Claude Code in Slack porta la potenza di Claude Code direttamente nel tuo workspace Slack. Quando menzioni `@Claude` con un compito di codifica, Claude rileva automaticamente l'intento e crea una sessione Claude Code sul web, permettendoti di delegare il lavoro di sviluppo senza lasciare le conversazioni del tuo team.

10 14 

11Questa integrazione è costruita sull'app Claude for Slack esistente ma aggiunge un instradamento intelligente a Claude Code sul web per le richieste relative alla codifica.15Questa integrazione è costruita sull'app Claude for Slack esistente ma aggiunge un instradamento intelligente a Claude Code sul web per le richieste relative alla codifica. Ogni sessione viene eseguita con il tuo account Claude personale, utilizzando i tuoi repository connessi e i tuoi limiti di piano.

12 16 

13<h2 id="use-cases">17<h2 id="use-cases">

14 Casi d'uso18 Casi d'uso


217 Risoluzione dei problemi221 Risoluzione dei problemi

218</h2>222</h2>

219 223 

224<h3 id="claude-code-is-not-enabled-for-your-account">

225 "Claude Code non è abilitato per il tuo account"

226</h3>

227 

228Questo errore significa che il tuo account Claude non ha ancora un ambiente cloud, non che un amministratore debba abilitare qualcosa. Accedi a [claude.ai/code](https://claude.ai/code) una volta con lo stesso account che hai connesso a Slack. La prima visita crea il tuo ambiente cloud predefinito e l'errore si risolve alla prossima menzione. Ogni utente deve farlo individualmente.

229 

220<h3 id="sessions-not-starting">230<h3 id="sessions-not-starting">

221 Le sessioni non si avviano231 Le sessioni non si avviano

222</h3>232</h3>


277 Documentazione generale di Claude for Slack287 Documentazione generale di Claude for Slack

278 </Card>288 </Card>

279 289 

290 <Card title="Claude Tag" icon="users" href="https://claude.com/docs/claude-tag/overview">

291 @Claude gestito dall'organizzazione in Slack con accesso configurato dall'amministratore

292 </Card>

293 

280 <Card title="Slack App Marketplace" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">294 <Card title="Slack App Marketplace" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">

281 Installa l'app Claude dal Marketplace di Slack295 Installa l'app Claude dal Marketplace di Slack

282 </Card>296 </Card>

statusline.md +1 −1

Details

15* Lavori su più sessioni e hai bisogno di distinguerle15* Lavori su più sessioni e hai bisogno di distinguerle

16* Vuoi che il ramo git e lo stato siano sempre visibili16* Vuoi che il ramo git e lo stato siano sempre visibili

17 17 

18Claude Code può anche eseguire il rendering di [badge di collegamento nel footer](/it/settings#footer-link-badges): chip cliccabili che appaiono nel footer quando un'espressione regolare configurata corrisponde al testo nella conversazione. Questi sono indipendenti dalla barra di stato e non interagiscono con il tuo script; configurali invece con l'impostazione [`footerLinksRegexes`](/it/settings#footer-link-badges).18La barra di stato viene renderizzata nella sua propria riga sopra i badge del footer integrati e non li sostituisce. Per aggiungere badge di collegamento cliccabili al footer quando un ID appare nella conversazione, senza scrivere uno script, configura invece [`footerLinksRegexes`](/it/settings#footer-link-badges).

19 19 

20Ecco un esempio di una [barra di stato multi-riga](#display-multiple-lines) che visualizza le informazioni git sulla prima riga e una barra di contesto codificata a colori sulla seconda.20Ecco un esempio di una [barra di stato multi-riga](#display-multiple-lines) che visualizza le informazioni git sulla prima riga e una barra di contesto codificata a colori sulla seconda.

21 21 

sub-agents.md +6 −11

Details

765I subagent possono essere eseguiti in primo piano (bloccante) o in background (concorrente):765I subagent possono essere eseguiti in primo piano (bloccante) o in background (concorrente):

766 766 

767* **Subagent in primo piano** bloccano la conversazione principale fino al completamento. I prompt di autorizzazione vengono passati a lei mentre si presentano.767* **Subagent in primo piano** bloccano la conversazione principale fino al completamento. I prompt di autorizzazione vengono passati a lei mentre si presentano.

768* **Subagent in background** vengono eseguiti contemporaneamente mentre continua a lavorare. Vengono eseguiti con le autorizzazioni già concesse nella sessione e auto-negano qualsiasi chiamata di strumento che altrimenti richiederebbe un prompt. Se un subagent in background ha bisogno di fare domande di chiarimento, quella chiamata di strumento fallisce ma il subagent continua.768* **Subagent in background** vengono eseguiti contemporaneamente mentre continua a lavorare. {/* min-version: 2.1.186 */}A partire da v2.1.186, quando un subagent in background raggiunge una chiamata di strumento che necessita di autorizzazione, il prompt emerge nella sua sessione principale e nomina il subagent che sta chiedendo. Approvi per consentire al subagent di continuare, o premi Esc per negare quella singola chiamata di strumento senza fermare il subagent. Prima di v2.1.186, i subagent in background auto-negavano qualsiasi chiamata di strumento che avrebbe richiesto un prompt.

769 

770Se un subagent in background fallisce a causa di autorizzazioni mancanti, può avviare un nuovo subagent in primo piano con lo stesso compito per riprovare con prompt interattivi.

771 769 

772Claude decide se eseguire i subagent in primo piano o in background in base all'attività. Può anche:770Claude decide se eseguire i subagent in primo piano o in background in base all'attività. Può anche:

773 771 


776 774 

777Per disabilitare tutta la funzionalità di background task, imposti la variabile di ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` su `1`. Consulti [Environment variables](/it/env-vars).775Per disabilitare tutta la funzionalità di background task, imposti la variabile di ambiente `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` su `1`. Consulti [Environment variables](/it/env-vars).

778 776 

779Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) è impostato su `1`, ogni spawn di subagent viene eseguito in background indipendentemente dal campo `background`. I fork continuano a far emergere i prompt di autorizzazione nel suo terminale mentre si verificano; i subagent denominati auto-negano qualsiasi cosa che altrimenti richiederebbe un prompt, come descritto sopra.777Quando [`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation) è impostato su `1`, ogni spawn di subagent viene eseguito in background indipendentemente dal campo `background`. I prompt di autorizzazione da questi subagent in background emergono nella sua sessione principale come descritto sopra.

780 778 

781<h3 id="common-patterns">779<h3 id="common-patterns">

782 Modelli comuni780 Modelli comuni


849 847 

850Un subagent annidato è configurato nello stesso modo di uno di livello superiore e si risolve dagli stessi [ambiti](#choose-the-subagent-scope). Il pannello dei subagent sotto l'input del prompt mostra l'albero completo: ogni riga visualizza un conteggio `(+N)` di discendenti, e aprire una riga mostra i figli diretti di quel subagent con un percorso di ritorno a `main`. La scheda Running in [`/agents`](#use-the-%2Fagents-command) elenca i subagent in esecuzione come un elenco piatto.848Un subagent annidato è configurato nello stesso modo di uno di livello superiore e si risolve dagli stessi [ambiti](#choose-the-subagent-scope). Il pannello dei subagent sotto l'input del prompt mostra l'albero completo: ogni riga visualizza un conteggio `(+N)` di discendenti, e aprire una riga mostra i figli diretti di quel subagent con un percorso di ritorno a `main`. La scheda Running in [`/agents`](#use-the-%2Fagents-command) elenca i subagent in esecuzione come un elenco piatto.

851 849 

852La profondità viene conteggiata come il numero di livelli di subagent sotto la conversazione principale, indipendentemente dal fatto che ogni livello venga eseguito in [primo piano o in background](#run-subagents-in-foreground-or-background):850La profondità viene conteggiata come il numero di livelli di subagent sotto la conversazione principale, indipendentemente dal fatto che ogni livello venga eseguito in [primo piano o in background](#run-subagents-in-foreground-or-background). Un subagent a profondità cinque non riceve lo strumento Agent e non può generare ulteriormente. Il limite è fisso e non configurabile.

853 

854* **Subagent in primo piano**: possono generare a qualsiasi profondità. Ogni livello blocca il suo genitore fino a quando non ritorna, quindi la catena è auto-limitante: la conversazione principale attende l'intera catena.

855* **Subagent in background**: un subagent in background a profondità cinque non riceve lo strumento Agent e non può generare ulteriormente. Il limite è fisso e non configurabile, ed esiste per prevenire alberi concorrenti incontrollati.

856 851 

857Per impedire a un subagent specifico di generare altri, ometta `Agent` dal suo elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.852Per impedire a un subagent specifico di generare altri, ometta `Agent` dal suo elenco [`tools`](#available-tools) o aggiunga a `disallowedTools`.

858 853 


888 883 

889I subagent ripresi mantengono la loro cronologia di conversazione completa, incluse tutte le precedenti chiamate di strumenti, risultati e ragionamento. Il subagent riprende esattamente da dove si era fermato piuttosto che ricominciare da zero.884I subagent ripresi mantengono la loro cronologia di conversazione completa, incluse tutte le precedenti chiamate di strumenti, risultati e ragionamento. Il subagent riprende esattamente da dove si era fermato piuttosto che ricominciare da zero.

890 885 

891Quando un subagent completa, Claude riceve il suo ID agente. Gli agenti integrati Explore e Plan sono una tantum e non restituiscono alcun ID agente, quindi non possono essere ripresi; usi `general-purpose` o un subagent personalizzato quando ha bisogno di continuare il lavoro. Claude utilizza lo strumento `SendMessage` con l'ID dell'agente come campo `to` per riprendere. Lo strumento `SendMessage` è disponibile solo quando [agent teams](/it/agent-teams) sono abilitati tramite `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`.886Quando un subagent completa, Claude riceve il suo ID agente. Gli agenti integrati Explore e Plan sono una tantum e non restituiscono alcun ID agente, quindi non possono essere ripresi; usi `general-purpose` o un subagent personalizzato quando ha bisogno di continuare il lavoro. Claude utilizza lo strumento `SendMessage` con l'ID dell'agente come campo `to` per riprendere. Lo strumento `SendMessage` è sempre disponibile per riprendere i subagent per ID agente o nome. I messaggi strutturati del protocollo di team come `shutdown_request` e `plan_approval_response` richiedono che [agent teams](/it/agent-teams) siano abilitati.

892 887 

893Per riprendere un subagent, chieda a Claude di continuare il lavoro precedente:888Per riprendere un subagent, chieda a Claude di continuare il lavoro precedente:

894 889 


976Un fork eredita tutto ciò che la sessione principale ha nel momento in cui viene generato. Un subagent denominato inizia dalla sua propria definizione.971Un fork eredita tutto ciò che la sessione principale ha nel momento in cui viene generato. Un subagent denominato inizia dalla sua propria definizione.

977 972 

978| | Fork | Subagent denominato |973| | Fork | Subagent denominato |

979| :-------------------- | :----------------------------------- | :-------------------------------------------------------------------------------------------- |974| :-------------------- | :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------- |

980| Context | Cronologia di conversazione completa | Contesto fresco con il prompt che passa |975| Context | Cronologia di conversazione completa | Contesto fresco con il prompt che passa |

981| System prompt e tools | Uguale alla sessione principale | Dalla [definition file](#write-subagent-files) del subagent |976| System prompt e tools | Uguale alla sessione principale | Dalla [definition file](#write-subagent-files) del subagent |

982| Model | Uguale alla sessione principale | Dal campo `model` del subagent |977| Model | Uguale alla sessione principale | Dal campo `model` del subagent |

983| Permissions | I prompt emergono nel suo terminale | [Auto-negati](#run-subagents-in-foreground-or-background) quando viene eseguito in background |978| Permissions | I prompt emergono nel suo terminale | [I prompt emergono nella sua sessione principale](#run-subagents-in-foreground-or-background) quando viene eseguito in background |

984| Prompt cache | Condiviso con la sessione principale | Cache separata |979| Prompt cache | Condiviso con la sessione principale | Cache separata |

985 980 

986Poiché il prompt di sistema di un fork e le definizioni di strumenti sono identici al principale, la sua prima richiesta riutilizza la cache del prompt del principale. Questo rende il fork più economico rispetto alla generazione di un subagent fresco per attività che necessitano dello stesso contesto.981Poiché il prompt di sistema di un fork e le definizioni di strumenti sono identici al principale, la sua prima richiesta riutilizza la cache del prompt del principale. Questo rende il fork più economico rispetto alla generazione di un subagent fresco per attività che necessitano dello stesso contesto.

Details

13| Strumento | Descrizione | Autorizzazione Richiesta |13| Strumento | Descrizione | Autorizzazione Richiesta |

14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- |14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------- |

15| `Agent` | Genera un [subagent](/it/sub-agents) con la propria finestra di contesto per gestire un'attività. Vedi [comportamento dello strumento Agent](#agent-tool-behavior) | No |15| `Agent` | Genera un [subagent](/it/sub-agents) con la propria finestra di contesto per gestire un'attività. Vedi [comportamento dello strumento Agent](#agent-tool-behavior) | No |

16| `Artifact` | Pubblica un file HTML o Markdown come [artifact](/it/artifacts): una pagina privata e interattiva su claude.ai che puoi condividere all'interno della tua organizzazione. {/* plan-availability: feature=artifacts plans=team,enterprise providers=anthropic */}Richiede un piano Team o Enterprise e autenticazione `/login`; vedi [Disponibilità](/it/artifacts#availability) | Sì |

16| `AskUserQuestion` | Pone domande a scelta multipla per raccogliere requisiti o chiarire ambiguità | No |17| `AskUserQuestion` | Pone domande a scelta multipla per raccogliere requisiti o chiarire ambiguità | No |

17| `Bash` | Esegue comandi shell nel tuo ambiente. Vedi [comportamento dello strumento Bash](#bash-tool-behavior) | Sì |18| `Bash` | Esegue comandi shell nel tuo ambiente. Vedi [comportamento dello strumento Bash](#bash-tool-behavior) | Sì |

18| `CronCreate` | Pianifica un prompt ricorrente o una tantum all'interno della sessione corrente. Le attività hanno ambito di sessione e vengono ripristinate su `--resume` o `--continue` se non scadute. Vedi [attività pianificate](/it/scheduled-tasks) | No |19| `CronCreate` | Pianifica un prompt ricorrente o una tantum all'interno della sessione corrente. Le attività hanno ambito di sessione e vengono ripristinate su `--resume` o `--continue` se non scadute. Vedi [attività pianificate](/it/scheduled-tasks) | No |


35| `ReadMcpResourceTool` | Legge una risorsa MCP specifica per URI | No |36| `ReadMcpResourceTool` | Legge una risorsa MCP specifica per URI | No |

36| `RemoteTrigger` | Crea, aggiorna, esegue ed elenca [Routine](/it/routines) su claude.ai. Supporta il comando `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Le Routine vivono su claude.ai e richiedono un piano Pro, Max, Team, o Enterprise, quindi questo strumento non è accessibile da Amazon Bedrock, Google Vertex AI, o Microsoft Foundry | No |37| `RemoteTrigger` | Crea, aggiorna, esegue ed elenca [Routine](/it/routines) su claude.ai. Supporta il comando `/schedule`. {/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}Le Routine vivono su claude.ai e richiedono un piano Pro, Max, Team, o Enterprise, quindi questo strumento non è accessibile da Amazon Bedrock, Google Vertex AI, o Microsoft Foundry | No |

37| `ScheduleWakeup` | Riprogramma l'iterazione successiva di un [`/loop` auto-paced](/it/scheduled-tasks#let-claude-choose-the-interval). Claude lo chiama alla fine di ogni iterazione per scegliere quando viene eseguita la successiva, tra un minuto e un'ora; non lo chiami direttamente. Il wakeup in sospeso appare in `session_crons` in [Stop hook input](/it/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Non disponibile su Amazon Bedrock, Google Vertex AI, o Microsoft Foundry, dove un prompt `/loop` senza intervallo viene eseguito secondo una pianificazione fissa | No |38| `ScheduleWakeup` | Riprogramma l'iterazione successiva di un [`/loop` auto-paced](/it/scheduled-tasks#let-claude-choose-the-interval). Claude lo chiama alla fine di ogni iterazione per scegliere quando viene eseguita la successiva, tra un minuto e un'ora; non lo chiami direttamente. Il wakeup in sospeso appare in `session_crons` in [Stop hook input](/it/hooks#stop-input). {/* plan-availability: feature=loop-dynamic providers=anthropic */}Non disponibile su Amazon Bedrock, Google Vertex AI, o Microsoft Foundry, dove un prompt `/loop` senza intervallo viene eseguito secondo una pianificazione fissa | No |

38| `SendMessage` | Invia un messaggio a un [team di agenti](/it/agent-teams) compagno, o [riprende un subagent](/it/sub-agents#resume-subagents) per il suo ID agente. I subagent interrotti si riprendono automaticamente in background. Disponibile solo quando `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` è impostato | No |39| `SendMessage` | Invia un messaggio a un [team di agenti](/it/agent-teams) compagno, o [riprende un subagent](/it/sub-agents#resume-subagents) per il suo ID agente. I subagent interrotti si riprendono automaticamente in background. I messaggi del protocollo team strutturato richiedono team di agenti | No |

39| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Carica `ONBOARDING.md` e restituisce un link di condivisione che i compagni di team possono aprire in Claude Code. Chiamato da `/team-onboarding` dopo che la guida è stata scritta. Disponibile per gli abbonati di claude.ai su piani Pro, Max, Team, ed Enterprise | Sì |40| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}Carica `ONBOARDING.md` e restituisce un link di condivisione che i compagni di team possono aprire in Claude Code. Chiamato da `/team-onboarding` dopo che la guida è stata scritta. Disponibile per gli abbonati di claude.ai su piani Pro, Max, Team, ed Enterprise | Sì |

40| `Skill` | Esegue una [skill](/it/skills#control-who-invokes-a-skill) all'interno della conversazione principale | Sì |41| `Skill` | Esegue una [skill](/it/skills#control-who-invokes-a-skill) all'interno della conversazione principale | Sì |

41| `TaskCreate` | Crea una nuova attività nell'elenco delle attività | No |42| `TaskCreate` | Crea una nuova attività nell'elenco delle attività | No |


102L'avvio del subagent non richiede di per sé l'autorizzazione. Le chiamate di strumento del subagent vengono controllate rispetto alle tue regole di autorizzazione mentre viene eseguito:103L'avvio del subagent non richiede di per sé l'autorizzazione. Le chiamate di strumento del subagent vengono controllate rispetto alle tue regole di autorizzazione mentre viene eseguito:

103 104 

104* **Subagent in primo piano** mostrano gli stessi prompt di autorizzazione che vedresti nella conversazione principale, nel momento in cui ogni chiamata di strumento accade.105* **Subagent in primo piano** mostrano gli stessi prompt di autorizzazione che vedresti nella conversazione principale, nel momento in cui ogni chiamata di strumento accade.

105* **Subagent in background** non mostrano prompt. Vengono eseguiti con le autorizzazioni già concesse nella sessione e negano automaticamente qualsiasi chiamata di strumento che altrimenti richiederebbe un prompt. Dopo un rifiuto, il subagent continua senza quello strumento.106* **Subagent in background** {/* min-version: 2.1.186 */}fanno emergere i prompt di autorizzazione nella tua sessione principale a partire dalla v2.1.186. Il prompt indica quale subagent sta chiedendo, e premere Esc nega quella singola chiamata di strumento senza fermare il subagent. Prima della v2.1.186, i subagent in background negavano automaticamente qualsiasi chiamata di strumento che altrimenti richiederebbe un prompt e continuavano senza quello strumento.

106 107 

107Per limitare cosa un subagent può raggiungere in primo luogo, restringi il suo campo `tools`, lascia Bash fuori dall'elenco, o imposta regole di negazione nelle tue impostazioni, come descritto in [Controlla le capacità del subagent](/it/sub-agents#control-subagent-capabilities). Per ulteriori informazioni sulla scelta tra primo piano e background, vedi [Esegui subagent in primo piano o background](/it/sub-agents#run-subagents-in-foreground-or-background).108Per limitare cosa un subagent può raggiungere in primo luogo, restringi il suo campo `tools`, lascia Bash fuori dall'elenco, o imposta regole di negazione nelle tue impostazioni, come descritto in [Controlla le capacità del subagent](/it/sub-agents#control-subagent-capabilities). Per ulteriori informazioni sulla scelta tra primo piano e background, vedi [Esegui subagent in primo piano o background](/it/sub-agents#run-subagents-in-foreground-or-background).

108 109 

ultrareview.md +16 −13

Details

12 12 

13Ultrareview è una revisione del codice profonda che viene eseguita su Claude Code nell'infrastruttura web. Quando eseguite `/code-review ultra`, Claude Code avvia una flotta di agenti revisori in una sandbox remota per trovare i bug nel vostro ramo o nella vostra pull request.13Ultrareview è una revisione del codice profonda che viene eseguita su Claude Code nell'infrastruttura web. Quando eseguite `/code-review ultra`, Claude Code avvia una flotta di agenti revisori in una sandbox remota per trovare i bug nel vostro ramo o nella vostra pull request.

14 14 

15Rispetto a una `/review` locale, ultrareview offre:15Rispetto a una `/code-review` locale o `/review`, ultrareview offre:

16 16 

17* **Segnale più elevato**: ogni risultato segnalato viene riprodotto e verificato in modo indipendente, quindi i risultati si concentrano su bug reali piuttosto che su suggerimenti di stile17* **Segnale più elevato**: ogni risultato segnalato viene riprodotto e verificato in modo indipendente, quindi i risultati si concentrano su bug reali piuttosto che su suggerimenti di stile

18* **Copertura più ampia**: molti agenti revisori esplorano il cambiamento in parallelo, il che evidenzia i problemi che una revisione a passaggio singolo potrebbe perdere18* **Copertura più ampia**: una flotta più grande di agenti revisori esplora il cambiamento in parallelo, il che evidenzia i problemi che una revisione a passaggio medio potrebbe perdere

19* **Nessun utilizzo di risorse locali**: la revisione viene eseguita interamente in una sandbox remota, quindi il vostro terminale rimane libero per altri lavori mentre viene eseguita19* **Nessun utilizzo di risorse locali**: la revisione viene eseguita interamente in una sandbox remota, quindi il vostro terminale rimane libero per altri lavori mentre viene eseguita

20 20 

21Ultrareview richiede l'autenticazione con un account Claude.ai perché viene eseguito su Claude Code nell'infrastruttura web. Se siete connessi solo con una chiave API, eseguite `/login` e autenticatevi prima con Claude.ai. Ultrareview non è disponibile quando si utilizza Claude Code con Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry, e non è disponibile per le organizzazioni che hanno abilitato Zero Data Retention.21Ultrareview richiede l'autenticazione con un account Claude.ai perché viene eseguito su Claude Code nell'infrastruttura web. Se siete connessi solo con una chiave API, eseguite `/login` e autenticatevi prima con Claude.ai. Ultrareview non è disponibile quando si utilizza Claude Code con Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry, e non è disponibile per le organizzazioni che hanno abilitato Zero Data Retention.


42 42 

43<Tip>43<Tip>

44 Se il vostro repository è troppo grande per essere raggruppato, Claude Code vi suggerisce di utilizzare la modalità PR. Eseguite il push del vostro ramo e aprite una PR in bozza, quindi eseguite `/code-review ultra <PR-number>`.44 Se il vostro repository è troppo grande per essere raggruppato, Claude Code vi suggerisce di utilizzare la modalità PR. Eseguite il push del vostro ramo e aprite una PR in bozza, quindi eseguite `/code-review ultra <PR-number>`.

45 

46 Se il diff della pull request è troppo grande, Claude Code rifiuta la revisione con un suggerimento di scoping prima che inizi qualsiasi lavoro di revisione.

45</Tip>47</Tip>

46 48 

47Prima di avviare, Claude Code mostra una finestra di dialogo di conferma con l'ambito della revisione (incluso il conteggio dei file e delle righe quando si esamina un ramo), i vostri run gratuiti rimanenti e il costo stimato. Dopo la conferma, la revisione continua in background e potete continuare a utilizzare la vostra sessione. Il comando viene eseguito solo quando lo richiamate con `/code-review ultra`; Claude non avvia un ultrareview da solo.49Prima di avviare, Claude Code mostra una finestra di dialogo di conferma con l'ambito della revisione (incluso il conteggio dei file e delle righe quando si esamina un ramo), i vostri run gratuiti rimanenti e il costo stimato. Dopo la conferma, la revisione continua in background e potete continuare a utilizzare la vostra sessione. Il comando viene eseguito solo quando lo richiamate con `/code-review ultra`; Claude non avvia un ultrareview da solo.


95 97 

96Per le revisioni automatiche sulle pull request di GitHub, [Code Review](/it/code-review) si integra direttamente con il vostro repository e pubblica i risultati come commenti PR inline senza un passaggio CLI.98Per le revisioni automatiche sulle pull request di GitHub, [Code Review](/it/code-review) si integra direttamente con il vostro repository e pubblica i risultati come commenti PR inline senza un passaggio CLI.

97 99 

98<h2 id="how-ultrareview-compares-to-/review">100<h2 id="how-ultrareview-compares-to-/code-review-and-/review">

99 Come ultrareview si confronta con /review101 Come ultrareview si confronta con /code-review e /review

100</h2>102</h2>

101 103 

102Entrambi i comandi esaminano il codice, ma si rivolgono a diverse fasi del vostro flusso di lavoro.104Tutti e tre i comandi esaminano il codice, ma si rivolgono a diverse fasi del vostro flusso di lavoro.

103 105 

104| | `/review` | `/code-review ultra` |106| | `/code-review` | `/review <pr>` | `/code-review ultra` |

105| -------------- | ------------------------------------ | --------------------------------------------------------------------- |107| -------------- | ------------------------------------ | ---------------------------------------------------- | -------------------------------------------------------------------------- |

106| Viene eseguito | localmente nella vostra sessione | in remoto in una sandbox cloud |108| Destinazione | il vostro diff di lavoro | una pull request di GitHub | il vostro diff di lavoro o una pull request |

107| Profondità | revisione a passaggio singolo | flotta multi-agente con verifica indipendente |109| Viene eseguito | localmente nella vostra sessione | localmente nella vostra sessione | in remoto in una sandbox cloud |

108| Durata | da secondi a pochi minuti | circa 5-10 minuti |110| Profondità | scala con l'argomento effort | il motore `/code-review` medio | flotta multi-agente con verifica indipendente |

109| Costo | conta verso l'utilizzo normale | run gratuiti, quindi circa $5 a $20 per revisione come utilizzo extra |111| Durata | da secondi a pochi minuti | pochi minuti | circa 5-10 minuti |

110| Migliore per | feedback rapido durante l'iterazione | fiducia pre-merge su cambiamenti sostanziali |112| Costo | conta verso l'utilizzo normale | conta verso l'utilizzo normale | run gratuiti, quindi circa $5 a $20 per revisione come crediti di utilizzo |

113| Migliore per | feedback rapido durante l'iterazione | revisione della PR di un collega prima di approvarla | fiducia pre-merge su cambiamenti sostanziali |

111 114 

112Utilizzate `/review` per un feedback rapido mentre lavorate. Utilizzate `/code-review ultra` prima di eseguire il merge di un cambiamento sostanziale quando desiderate un passaggio più profondo che catturi i problemi che una singola revisione potrebbe perdere.115Utilizzate `/code-review` per un feedback rapido mentre lavorate. Utilizzate `/review <pr>` per esaminare una pull request nello stesso modo in cui lo fareste prima di approvarla. Utilizzate `/code-review ultra` prima di eseguire il merge di un cambiamento sostanziale quando desiderate un passaggio più profondo che catturi i problemi che una revisione locale potrebbe perdere.

113 116 

114<h2 id="related-resources">117<h2 id="related-resources">

115 Risorse correlate118 Risorse correlate

Details

34 <span className="digest-feature-pill">v2.1.172</span>34 <span className="digest-feature-pill">v2.1.172</span>

35 </div>35 </div>

36 36 

37 <p className="digest-feature-lede">I sub-agent possono ora generare i propri sub-agent. Il pannello dei subagent sotto il prompt mostra l'albero completo: ogni riga contiene un conteggio dei suoi discendenti e un percorso di ritorno a <code>main</code>. I sub-agent in background sono limitati a cinque livelli di profondità per prevenire alberi concorrenti incontrollati; le catene in foreground possono generare a qualsiasi profondità e sono auto-limitanti.</p>37 <p className="digest-feature-lede">I sub-agent possono ora generare i propri sub-agent. Il pannello dei subagent sotto il prompt mostra l'albero completo: ogni riga contiene un conteggio dei suoi discendenti e un percorso di ritorno a <code>main</code>. Le catene di sub-agent sono limitate a cinque livelli di profondità per prevenire alberi concorrenti incontrollati.</p>

38 38 

39 <p className="digest-feature-try">Apri la visualizzazione degli agenti per osservare l'albero annidato mentre il lavoro si espande:</p>39 <p className="digest-feature-try">Apri la visualizzazione degli agenti per osservare l'albero annidato mentre il lavoro si espande:</p>

40 40 

workflows.md +2 −1

Details

110| `Invio` o `→` | Approfondire la fase selezionata, quindi in un agente per leggere il suo prompt, le recenti chiamate di strumenti e il risultato |110| `Invio` o `→` | Approfondire la fase selezionata, quindi in un agente per leggere il suo prompt, le recenti chiamate di strumenti e il risultato |

111| `Esc` | Tornare indietro di un livello |111| `Esc` | Tornare indietro di un livello |

112| `j` / `k` | Scorrere all'interno del dettaglio dell'agente quando trabocca |112| `j` / `k` | Scorrere all'interno del dettaglio dell'agente quando trabocca |

113| `f` | {/* min-version: 2.1.186 */}Filtrare l'elenco degli agenti nella fase selezionata per stato. Premi di nuovo per ciclare |

113| `p` | Mettere in pausa o riprendere l'esecuzione |114| `p` | Mettere in pausa o riprendere l'esecuzione |

114| `x` | Fermare l'agente selezionato, o fermare l'intero flusso di lavoro quando il focus è sull'esecuzione |115| `x` | Fermare l'agente selezionato, o fermare l'intero flusso di lavoro quando il focus è sull'esecuzione |

115| `r` | Riavviare l'agente in esecuzione selezionato |116| `r` | Riavviare l'agente in esecuzione selezionato |


198 199 

199Premi Invio per salvare. Il flusso di lavoro viene eseguito come `/<name>` nelle future sessioni da entrambi i percorsi.200Premi Invio per salvare. Il flusso di lavoro viene eseguito come `/<name>` nelle future sessioni da entrambi i percorsi.

200 201 

201{/* min-version: 2.1.178 */}A partire dalla v2.1.178, il salvataggio nella posizione del progetto scrive nella directory `.claude/workflows/` più vicina che già esiste tra la tua directory di lavoro e la radice del repository, o nella radice del repository se non ne esiste ancora nessuna. I flussi di lavoro del progetto si caricano anche da ogni `.claude/workflows/` lungo quel percorso, e quando più di uno definisce lo stesso nome Claude Code esegue quello più vicino alla directory di lavoro.202{/* min-version: 2.1.178 */}In un monorepo con diverse directory `.claude/`, puoi mantenere i flussi di lavoro insieme al pacchetto a cui si applicano. A partire dalla v2.1.178, il salvataggio nella posizione del progetto scrive nella directory `.claude/workflows/` più vicina che già esiste tra la tua directory di lavoro e la radice del repository, o nella radice del repository se non ne esiste ancora nessuna. I flussi di lavoro del progetto si caricano anche da ogni `.claude/workflows/` lungo quel percorso, e quando più di uno definisce lo stesso nome Claude Code esegue quello più vicino alla directory di lavoro.

202 203 

203Se un flusso di lavoro di progetto e un flusso di lavoro personale condividono un nome, viene eseguito quello di progetto.204Se un flusso di lavoro di progetto e un flusso di lavoro personale condividono un nome, viene eseguito quello di progetto.

204 205 

Details

58Quando ZDR è abilitato per un'organizzazione Claude Code su Claude for Enterprise, determinate funzionalità che richiedono l'archiviazione di prompt o completamenti vengono automaticamente disabilitate a livello di backend:58Quando ZDR è abilitato per un'organizzazione Claude Code su Claude for Enterprise, determinate funzionalità che richiedono l'archiviazione di prompt o completamenti vengono automaticamente disabilitate a livello di backend:

59 59 

60| Funzionalità | Motivo |60| Funzionalità | Motivo |

61| ------------------------------------------------------------- | --------------------------------------------------------------------------- |61| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |

62| [Claude Code on the Web](/it/claude-code-on-the-web) | Richiede l'archiviazione lato server della cronologia delle conversazioni. |62| [Claude Code on the Web](/it/claude-code-on-the-web) | Richiede l'archiviazione lato server della cronologia delle conversazioni. |

63| [Cloud sessions](/it/desktop#cloud-sessions) dall'app Desktop | Richiede dati di sessione persistenti che includono prompt e completamenti. |63| [Cloud sessions](/it/desktop#cloud-sessions) dall'app Desktop | Richiede dati di sessione persistenti che includono prompt e completamenti. |

64| [Artifacts](/it/artifacts) | Richiede l'archiviazione del contenuto della pagina pubblicata sull'infrastruttura gestita da Anthropic. |

64| Invio di feedback (`/feedback`) | L'invio di feedback invia i dati della conversazione ad Anthropic. |65| Invio di feedback (`/feedback`) | L'invio di feedback invia i dati della conversazione ad Anthropic. |

65 66 

66Queste funzionalità sono bloccate nel backend indipendentemente dalla visualizzazione lato client. Se si vede una funzionalità disabilitata nel terminale Claude Code durante l'avvio, il tentativo di utilizzarla restituisce un errore che indica che le politiche dell'organizzazione non consentono tale azione.67Queste funzionalità sono bloccate nel backend indipendentemente dalla visualizzazione lato client. Se si vede una funzionalità disabilitata nel terminale Claude Code durante l'avvio, il tentativo di utilizzarla restituisce un errore che indica che le politiche dell'organizzazione non consentono tale azione.