Documentation 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

403 403 

404Questi processi in background consumano una piccola quantità di token (in genere meno di \$0,04 per sessione) anche senza interazione attiva.404Questi processi in background consumano una piccola quantità di token (in genere meno di \$0,04 per sessione) anche senza interazione attiva.

405 405 

406Quando i suggerimenti di prompt sono attivati, Claude Code invia anche una breve richiesta al modello che la sessione sta utilizzando dopo che Claude risponde, per [suggerire il prompt successivo](/docs/it/interactive-mode#prompt-suggestions). Quella richiesta riutilizza la cache dei prompt della conversazione, quindi è principalmente letture della cache più alcuni token di output. Claude Code [salta questa operazione quando l'account è vicino o ha raggiunto il limite di utilizzo](/docs/it/interactive-mode#when-claude-code-skips-suggestions). Per interrompere queste richieste, [disattivare i suggerimenti di prompt](/docs/it/interactive-mode#turn-prompt-suggestions-off).

407 

406<h2 id="why-usage-climbs-in-a-long-session">408<h2 id="why-usage-climbs-in-a-long-session">

407 Perché l'utilizzo aumenta in una sessione lunga409 Perché l'utilizzo aumenta in una sessione lunga

408</h2>410</h2>

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare su `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per le richieste di autorizzazione senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Impostare su `1` per impedire a Claude Code di eseguire i vostri [hook `Notification` per le richieste di autorizzazione senza risposta](/docs/it/hooks#notification) nelle sessioni in cui Claude Code le invia al callback `canUseTool` dell'Agent SDK, che è come Claude Desktop e l'estensione VS Code ospitano Claude Code. Non ha effetto nelle sessioni di terminale. Richiede Claude Code v2.1.233 o successivo |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Impostare su `1` per saltare il caricamento delle skill dalla directory di skill gestite a livello di sistema. Utile per le sessioni di container o CI che non dovrebbero caricare le skill fornite dall'operatore |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che [genera un titolo di sessione](/docs/it/sessions#name-your-sessions) |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Impostare su `1` per disabilitare gli aggiornamenti automatici del titolo del terminale in base al contesto della conversazione. Questo salta anche la richiesta del modello piccolo/veloce in background che [genera un titolo di sessione](/docs/it/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |275| `CLAUDE_CODE_DISABLE_THINKING` | Impostare su `1` per omettere completamente il parametro `thinking` dalle richieste API. Questa è un'opzione di compatibilità per i proxy e i gateway che rifiutano il parametro. Sui modelli che pensano per impostazione predefinita, omettere il parametro significa che il modello potrebbe comunque pensare. Per disabilitare esplicitamente il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) sull'API Anthropic, utilizzare `MAX_THINKING_TOKENS=0`. Nessuna variabile disattiva il pensiero su Opus 5.5 o sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `MAX_THINKING_TOKENS=0` omette allo stesso modo il parametro, quindi le due variabili si comportano allo stesso modo lì |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare su `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Impostare su `1` per saltare la [auto-compattazione](/docs/it/costs#reduce-token-usage) proattiva quando Claude Code non riconosce l'ID del modello, come un alias di [gateway LLM](/docs/it/llm-gateway). Senza questa variabile, Claude Code compatta alla finestra di contesto che presume per l'ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` può correggere la finestra presunta; vedere [Correggere la finestra per un ID modello gateway o personalizzato](/docs/it/model-config#correct-the-window-for-a-gateway-or-custom-model-id) per quando si applica ogni variabile. Richiede Claude Code v2.1.223 o successivo |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Impostare su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) e eseguire il rendering di ogni messaggio nella trascrizione. Utilizzare se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero apparire i messaggi |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Impostare su `1` per disabilitare lo scorrimento virtuale nel [rendering a schermo intero](/docs/it/fullscreen) e eseguire il rendering di ogni messaggio nella trascrizione. Utilizzare se lo scorrimento in modalità a schermo intero mostra aree vuote dove dovrebbero apparire i messaggi |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Impostare su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente invece che attraverso il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [trasferirsi al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [mettete in background la sessione](/docs/it/agent-view#from-inside-a-session). Se impostate la variabile, un comando PowerShell messo in background si arresta quando il processo della sessione esce. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successivo |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Impostare su `1` per avviare i comandi dello [strumento PowerShell](/docs/it/tools-reference#powershell-tool) su Windows direttamente invece che attraverso il launcher `cmd.exe`. Per impostazione predefinita, il launcher consente a un comando PowerShell [in esecuzione in background](/docs/it/tools-reference#background-commands) di [trasferirsi al processo successivo della sessione](/docs/it/agent-view#the-supervisor-process), ad esempio quando [mettete in background la sessione](/docs/it/agent-view#from-inside-a-session). Se impostate la variabile, un comando PowerShell messo in background si arresta quando il processo della sessione esce. I comandi Bash non sono interessati. Richiede Claude Code v2.1.269 o successivo |

461| `IS_DEMO` | Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |461| `IS_DEMO` | Impostare su qualsiasi valore non vuoto, come `1`, per abilitare la modalità demo: nasconde il vostro email e il nome dell'organizzazione dall'intestazione e dall'output `/status`, e salta l'onboarding. **L'impostazione su `0` o `false` abilita comunque la modalità demo**, a differenza della maggior parte delle variabili on/off; annullare l'impostazione della variabile per disattivarla. Utile quando si trasmette o si registra una sessione |

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

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi |463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Numero di tentativi che Claude Code consente quando la risposta del modello non supera la convalida rispetto allo [`--json-schema`](/docs/it/cli-reference#cli-flags) in modalità non interattiva con il flag `-p`; dopo quel numero di tentativi non riusciti senza output valido, l'esecuzione fallisce. Lo stesso limite si applica quando l'output strutturato di un subagent di [flusso di lavoro](/docs/it/workflows) non supera la convalida. Impostazione predefinita: 5, un primo tentativo più quattro tentativi |

464| `MAX_THINKING_TOKENS` | Budget di token fisso per il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |464| `MAX_THINKING_TOKENS` | Budget di token fisso per il [pensiero esteso](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code lo limita a un token al di sotto dei token di output massimi della richiesta e mai al di sotto di 1.024. Vedere `CLAUDE_CODE_MAX_OUTPUT_TOKENS` per come viene impostato quel limite. Quando non impostato e il pensiero è abilitato, i modelli con [ragionamento adattivo](/docs/it/model-config#adjust-effort-level) scelgono la loro profondità di pensiero e gli altri modelli utilizzano il limite. Impostare su `0` per disabilitare il pensiero sull'API Anthropic, tranne su Opus 5.5 e sui modelli Fable, che non possono avere il pensiero disattivato. Su [provider di terze parti](/docs/it/third-party-integrations), `0` omette il parametro `thinking`. Con il pensiero disattivato sull'API Anthropic, Claude Code invia lo sforzo `high` invece di un livello più alto ai modelli che sa [non accettano quella combinazione](/docs/it/errors#effort-isnt-available-with-thinking-turned-off), come Opus 5. Claude Code ignora i valori diversi da zero sui modelli di ragionamento adattivo, tranne sui modelli in cui `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` disattiva il ragionamento adattivo |

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

466| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache |466| `MCP_CONNECTION_NONBLOCKING` | Controlla se l'avvio aspetta i server MCP per connettersi prima della prima query. L'avvio MCP è non bloccante per impostazione predefinita: i server si connettono in background e i loro strumenti diventano disponibili man mano che finiscono. Impostare su `0` per fare in modo che Claude Code aspetti i server per connettersi prima della prima query. I server configurati con [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral) fanno comunque aspettare l'avvio indipendentemente, tranne quando serviti dalla [cache di scoperta](/docs/it/mcp#server-status-detail), poiché i loro strumenti devono essere presenti quando viene costruito il primo prompt. In modalità non interattiva (`-p`) senza `--input-format stream-json`, Claude Code aspetta anche i server ancora in sospeso prima del primo turno indipendentemente da questa variabile. Quando passate [`--mcp-config`](/docs/it/cli-reference#cli-flags) esplicitamente, l'attesa ha una scadenza più lunga; vedere la voce di quel flag per l'eccezione del server memorizzato in cache |

467| `MCP_CONNECT_TIMEOUT_MS` | Quanto a lungo l'avvio MCP bloccante aspetta, in millisecondi, il batch di connessione prima di fare uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |467| `MCP_CONNECT_TIMEOUT_MS` | Quanto a lungo l'avvio MCP bloccante aspetta, in millisecondi, il batch di connessione prima di fare uno snapshot dell'elenco degli strumenti (predefinito: 5000). Si applica quando `MCP_CONNECTION_NONBLOCKING=0` o per i server contrassegnati [`alwaysLoad: true`](/docs/it/mcp#exempt-a-server-from-deferral). I server ancora in sospeso alla scadenza continuano a connettersi in background. Distinto da `MCP_TIMEOUT`, che limita il tentativo di connessione di un singolo server |

439* Premete `Tab` o `Freccia destra` per inserire il suggerimento nell'input del prompt, quindi `Invio` per inviare439* Premete `Tab` o `Freccia destra` per inserire il suggerimento nell'input del prompt, quindi `Invio` per inviare

440* Iniziate a digitare per chiudere il suggerimento440* Iniziate a digitare per chiudere il suggerimento

441 441 

442Claude Code genera ciascuno di questi suggerimenti di prompt successivo con una richiesta in background che riutilizza la cache del prompt della conversazione, quindi il costo aggiuntivo è minimo.442Claude Code genera ciascuno di questi suggerimenti di prompt successivo con una richiesta in background al medesimo modello che la vostra sessione sta utilizzando. La richiesta conta verso i limiti di utilizzo del vostro piano o i vostri costi API. Poiché riutilizza la cache del prompt della conversazione, è principalmente costituita da letture della cache più alcuni token di output, quindi il costo aggiuntivo è minimo.

443 443 

444<h3 id="when-claude-code-skips-suggestions">444<h3 id="when-claude-code-skips-suggestions">

445 Quando Claude Code salta i suggerimenti445 Quando Claude Code salta i suggerimenti

95 * **In una sandbox VM completa**: quando la tua configurazione gestita di Claude Desktop imposta [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox), Claude Code viene eseguito all'interno di una macchina virtuale dove la policy MDM del dispositivo e il file di impostazioni gestite non sono presenti.95 * **In una sandbox VM completa**: quando la tua configurazione gestita di Claude Desktop imposta [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox), Claude Code viene eseguito all'interno di una macchina virtuale dove la policy MDM del dispositivo e il file di impostazioni gestite non sono presenti.

96 * **Remote Cowork sessions**: queste vengono eseguite su VM gestite da Anthropic, dove Claude Code non ha policy del dispositivo da leggere.96 * **Remote Cowork sessions**: queste vengono eseguite su VM gestite da Anthropic, dove Claude Code non ha policy del dispositivo da leggere.

97 97 

98 La tabella [surface coverage](/docs/it/model-config#surface-coverage) confronta Cowork con le altre surface.98 Ovunque la sessione venga eseguita, claude.ai applica gli elenchi [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces) e [`blockedMarketplaces`](/docs/it/settings-reference#blockedmarketplaces) della console admin stessa quando chiunque aggiunge un marketplace da un repository git su claude.ai o da **Customize** nella scheda Cowork. [How restrictions work](/docs/it/plugin-marketplaces#how-restrictions-work) descrive quel controllo. La tabella [surface coverage](/docs/it/model-config#surface-coverage) confronta Cowork con le altre surface.

99* **Running sessions**: la maggior parte dei cambiamenti raggiunge una sessione in esecuzione secondo la pianificazione nella [tabella del meccanismo di consegna](#choose-a-delivery-mechanism), senza un riavvio.99* **Running sessions**: la maggior parte dei cambiamenti raggiunge una sessione in esecuzione secondo la pianificazione nella [tabella del meccanismo di consegna](#choose-a-delivery-mechanism), senza un riavvio.

100 * I cambiamenti a [`forceRemoteSettingsRefresh`](/docs/it/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/it/settings-reference#requiredminimumversion), e [alcune chiavi modificabili dall'utente](/docs/it/settings#when-edits-take-effect) hanno effetto al prossimo avvio della sessione.100 * I cambiamenti a [`forceRemoteSettingsRefresh`](/docs/it/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/it/settings-reference#requiredminimumversion), e [alcune chiavi modificabili dall'utente](/docs/it/settings#when-edits-take-effect) hanno effetto al prossimo avvio della sessione.

101 * Una voce [`policyHelper`](/docs/it/settings-reference#policyhelper) nuova o modificata ha effetto al prossimo avvio. Se le impostazioni server-managed oscurano l'helper a quell'avvio, l'helper viene eseguito non appena un fetch segnala che quelle impostazioni sono state rimosse.101 * Una voce [`policyHelper`](/docs/it/settings-reference#policyhelper) nuova o modificata ha effetto al prossimo avvio. Se le impostazioni server-managed oscurano l'helper a quell'avvio, l'helper viene eseguito non appena un fetch segnala che quelle impostazioni sono state rimosse.

461 Cosa un'esecuzione può accedere461 Cosa un'esecuzione può accedere

462</h2>462</h2>

463 463 

464`claude plugin eval` carica le skill e gli hook del plugin target e esegue la sua suite di eval sulla tua macchina, come te. Puntare a un plugin è la stessa decisione di fiducia di `claude --plugin-dir`, quindi valuta solo i plugin di cui ti fidi. L'isolamento descritto in questa sezione limita quello che l'agente sotto test può raggiungere; non è un confine contro il codice del plugin stesso, e una suite che passa non dice nulla su se il plugin è sicuro.464`claude plugin eval` carica le skill, gli hook e gli agenti del plugin target ed esegue la sua suite di eval sulla tua macchina, come te. Puntare a un plugin è la stessa decisione di fiducia di `claude --plugin-dir`, quindi valuta solo i plugin di cui ti fidi. L'isolamento descritto in questa sezione limita quello che l'agente sotto test può raggiungere; non è un confine contro il codice del plugin stesso, e una suite che passa non dice nulla su se il plugin è sicuro.

465 465 

466<h3 id="trust-the-plugin-directory">466<h3 id="trust-the-plugin-directory">

467 Fidati della directory del plugin467 Fidati della directory del plugin

648 648 

649Se il plugin è stato caricato e `Δ` è ancora vicino a zero con il tuo grader `tool_used: Skill` che fallisce, questo è di solito un risultato reale, significando che la `description` della skill non attiva sulla formulazione del prompt. Regola la descrizione e riesegui la stessa suite.649Se il plugin è stato caricato e `Δ` è ancora vicino a zero con il tuo grader `tool_used: Skill` che fallisce, questo è di solito un risultato reale, significando che la `description` della skill non attiva sulla formulazione del prompt. Regola la descrizione e riesegui la stessa suite.

650 650 

651<h3 id="agent-type-’-’-not-found-for-one-of-your-plugin’s-agents">

652 "Agent type '...' not found" for one of your plugin's agents

653</h3>

654 

655Per impostazione predefinita, ogni caso viene eseguito sia con il tuo plugin che senza di esso, e le esecuzioni senza di esso sono la [baseline senza plugin](#the-no-plugin-baseline). Quando Claude invia uno degli agenti del tuo plugin in un'esecuzione baseline, la chiamata dello strumento Agent fallisce con `Agent type '<plugin>:<agent-name>' not found. Available agents: ...`. L'elenco nomina solo gli agenti che esistono senza il plugin, come i [subagenti integrati](/docs/it/sub-agents#built-in-subagents).

656 

657L'errore è previsto, poiché `Δ` confronta le tue esecuzioni del plugin rispetto alla baseline. Nel risultato JSON, le esecuzioni baseline sono sotto `cases[].arms.without`.

658 

659Nelle esecuzioni con il tuo plugin caricato, un caso che elenca `Agent` in `allowed_tools` può inviare uno degli agenti del tuo plugin per il suo nome con namespace, come `my-plugin:code-reviewer` per l'agente `code-reviewer` in un plugin denominato `my-plugin`. Per saltare le esecuzioni baseline, passa `--ablation none`.

660 

651<h3 id="everything-scores-zero-although-the-right-files-were-produced">661<h3 id="everything-scores-zero-although-the-right-files-were-produced">

652 Tutto ottiene un punteggio zero sebbene i file corretti siano stati prodotti662 Tutto ottiene un punteggio zero sebbene i file corretti siano stati prodotti

653</h3>663</h3>

1128 1128 

1129Le restrizioni vengono controllate prima di qualsiasi operazione di rete o filesystem. Il controllo viene eseguito sull'aggiunta del marketplace e sull'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin. Se un marketplace è stato aggiunto prima che la politica fosse configurata e la sua origine non corrisponde più all'allowlist, Claude Code rifiuta di installare o aggiornare plugin da esso. Lo stesso controllo si applica a `blockedMarketplaces`.1129Le restrizioni vengono controllate prima di qualsiasi operazione di rete o filesystem. Il controllo viene eseguito sull'aggiunta del marketplace e sull'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin. Se un marketplace è stato aggiunto prima che la politica fosse configurata e la sua origine non corrisponde più all'allowlist, Claude Code rifiuta di installare o aggiornare plugin da esso. Lo stesso controllo si applica a `blockedMarketplaces`.

1130 1130 

1131Dove i due elenchi vengono applicati dipende da dove li imposti:

1132 

1133* **La console di amministrazione claude.ai**: Claude Code applica entrambi gli elenchi nelle sessioni che [leggono le impostazioni gestite dal server](/docs/it/managed-settings#where-and-when-a-policy-applies). claude.ai li controlla anche quando chiunque nella tua organizzazione aggiunge un nuovo marketplace da un repository git su claude.ai, o da **Customize** nell'app Claude Desktop al di fuori della sua scheda Code. Questo copre un marketplace che un membro aggiunge per il proprio account e uno aggiunto per l'intera organizzazione in [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins). claude.ai rifiuta un repository che l'allowlist non ammette o che la blocklist nomina. Non ri-controlla un marketplace che è stato aggiunto in entrambi i posti prima che tu imposti gli elenchi, e non controlla i plugin caricati.

1134* **Un file di impostazioni gestite, una politica a livello di sistema operativo o un'altra origine gestita**: Claude Code applica entrambi gli elenchi dove legge quella fonte. claude.ai non la legge.

1135 

1131Per bloccare ogni repository di marketplace sotto un proprietario GitHub, utilizza la forma owner-wildcard in una voce `blockedMarketplaces`: `{ "source": "github", "repo": "untrusted-org/*" }`. Richiede Claude Code v2.1.223 o successivo. Per le regole di corrispondenza, che differiscono tra la blocklist e l'allowlist, vedi [Owner wildcards](/docs/it/settings-reference#owner-wildcards).1136Per bloccare ogni repository di marketplace sotto un proprietario GitHub, utilizza la forma owner-wildcard in una voce `blockedMarketplaces`: `{ "source": "github", "repo": "untrusted-org/*" }`. Richiede Claude Code v2.1.223 o successivo. Per le regole di corrispondenza, che differiscono tra la blocklist e l'allowlist, vedi [Owner wildcards](/docs/it/settings-reference#owner-wildcards).

1132 1137 

1133Quando un utente aggiunge un URL di repository `https://` che Claude Code [clona piuttosto che recupera](/docs/it/discover-plugins#add-from-other-git-hosts), come un URL di repository bare `github.com` o `gitlab.com`, Claude Code lo controlla anche rispetto alle voci `url` in `blockedMarketplaces`. Claude Code blocca l'aggiunta se una voce nomina lo stesso URL. In quel confronto, Claude Code ignora il suffisso `.git` e qualsiasi ref che l'utente aggiunge dopo `#`. Richiede Claude Code v2.1.232 o successivo. Prima di v2.1.232, Claude Code corrispondeva a una voce `url` solo rispetto a un URL che recuperava come file `marketplace.json` ospitato.1138Quando un utente aggiunge un URL di repository `https://` che Claude Code [clona piuttosto che recupera](/docs/it/discover-plugins#add-from-other-git-hosts), come un URL di repository bare `github.com` o `gitlab.com`, Claude Code lo controlla anche rispetto alle voci `url` in `blockedMarketplaces`. Claude Code blocca l'aggiunta se una voce nomina lo stesso URL. In quel confronto, Claude Code ignora il suffisso `.git` e qualsiasi ref che l'utente aggiunge dopo `#`. Richiede Claude Code v2.1.232 o successivo. Prima di v2.1.232, Claude Code corrispondeva a una voce `url` solo rispetto a un URL che recuperava come file `marketplace.json` ospitato.

4514 4514 

4515Blocca le fonti di marketplace dei plugin per la tua organizzazione. Claude Code controlla la lista di blocco all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace che qualcuno ha aggiunto prima di impostare la policy non può essere utilizzato per recuperare plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem.4515Blocca le fonti di marketplace dei plugin per la tua organizzazione. Claude Code controlla la lista di blocco all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, quindi un marketplace che qualcuno ha aggiunto prima di impostare la policy non può essere utilizzato per recuperare plugin. Le fonti bloccate vengono controllate prima del download, quindi non toccano mai il filesystem.

4516 4516 

4517Se imposti questa chiave nella [console di amministrazione claude.ai](/docs/it/server-managed-settings), claude.ai la applica anche quando chiunque nella tua organizzazione aggiunge un marketplace da un repository git su claude.ai, come [Come funzionano le restrizioni](/docs/it/plugin-marketplaces#how-restrictions-work) descrive.

4518 

4517* **Scope**: [`Managed`](#scopes)4519* **Scope**: [`Managed`](#scopes)

4518* **Type**: array di oggetti di fonte marketplace, nelle stesse forme di [`strictKnownMarketplaces`](#allowed-source-types)4520* **Type**: array di oggetti di fonte marketplace, nelle stesse forme di [`strictKnownMarketplaces`](#allowed-source-types)

4519* **Default**: non impostato, quindi nessun marketplace è bloccato4521* **Default**: non impostato, quindi nessun marketplace è bloccato

4610 4612 

4611Limita le fonti di marketplace dei plugin da cui le persone nella tua organizzazione possono aggiungere e installare plugin. Claude Code applica la lista di autorizzazione all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, prima di qualsiasi operazione di rete o filesystem, quindi un marketplace che qualcuno ha aggiunto prima di impostare la policy non può essere utilizzato per recuperare plugin una volta che la sua fonte non corrisponde più. Gli utenti bloccati vedono un errore che nomina la policy gestita.4613Limita le fonti di marketplace dei plugin da cui le persone nella tua organizzazione possono aggiungere e installare plugin. Claude Code applica la lista di autorizzazione all'aggiunta del marketplace e all'installazione, aggiornamento, aggiornamento e auto-aggiornamento del plugin, prima di qualsiasi operazione di rete o filesystem, quindi un marketplace che qualcuno ha aggiunto prima di impostare la policy non può essere utilizzato per recuperare plugin una volta che la sua fonte non corrisponde più. Gli utenti bloccati vedono un errore che nomina la policy gestita.

4612 4614 

4615Se imposti questa chiave nella [console di amministrazione claude.ai](/docs/it/server-managed-settings), claude.ai la applica anche quando chiunque nella tua organizzazione aggiunge un marketplace da un repository git su claude.ai, come [Come funzionano le restrizioni](/docs/it/plugin-marketplaces#how-restrictions-work) descrive.

4616 

4613* **Scope**: [`Managed`](#scopes)4617* **Scope**: [`Managed`](#scopes)

4614* **Type**: array di oggetti di fonte marketplace; vedi [Tipi di fonte consentiti](#allowed-source-types)4618* **Type**: array di oggetti di fonte marketplace; vedi [Tipi di fonte consentiti](#allowed-source-types)

4615* **Default**: non impostato, quindi gli utenti possono aggiungere qualsiasi marketplace. Un array vuoto è un blocco completo che blocca ogni fonte di marketplace, incluso il marketplace ufficiale di Anthropic4619* **Default**: non impostato, quindi gli utenti possono aggiungere qualsiasi marketplace. Un array vuoto è un blocco completo che blocca ogni fonte di marketplace, incluso il marketplace ufficiale di Anthropic