Esegui chiamate agli strumenti dal codice con Code Mode

Come funziona Code Mode

const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

Quando usare Code Mode

• Una modifica che si ripete in molti file
• Una ricerca i cui risultati devono essere filtrati prima che Claude li legga
• Diversi comandi indipendenti che possono essere eseguiti contemporaneamente

Limitazioni di Code Mode

• Ripresa: puoi riprendere una sessione Code Mode solo nel terminale, con Code Mode attivo
• Modalità auto: il classificatore della modalità auto esamina il codice, non ogni chiamata a uno strumento
• Codice di lunga durata: tranne quando il codice può essere eseguito in background, devi attendere che finisca, e si interrompe dopo dieci minuti
• Hook: puoi vedere chiamate agli strumenti rifiutate quando un hook PreToolUse non può essere eseguito o va in timeout, e output del codice bloccato da un hook UserPromptSubmit
• Funzionalità non disponibili: non puoi usare Remote Control, Claude in Chrome o computer use
• Spostamento della sessione: non puoi spostare la sessione nell’app Desktop né trasformarla in una sessione in background, e /fork non può avviare una copia in background

Requisiti

• Versione: Claude Code v2.1.323 o successiva, su uno qualsiasi dei due canali di release. Una versione precedente si avvia senza Code Mode, con o senza il motivo it isn't open to your account yet
• Account: un abbonamento Claude o un account Console. Non puoi usare Code Mode tramite un gateway, Amazon Bedrock, Claude Platform on AWS, Agent Platform di Google Cloud o Microsoft Foundry
• Organizzazione: la tua organizzazione non usa la configurazione HIPAA né la conservazione zero dei dati
• Modello: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2
• Superficie: una sessione claude interattiva in un terminale. Code Mode non funziona con -p, l’Agent SDK, il pannello di VS Code, l’app Desktop o le sessioni cloud
• Installazione: la build nativa di Claude Code
• Windows: Git for Windows è installato

Prova Code Mode

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Code Mode (experimental) is on · this session can be resumed only with Code Mode on

Read every Markdown file in this project and list the links that point to local files that don't exist.

Disattiva Code Mode

Blocca Code Mode per la tua organizzazione

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

Permessi e codice di lunga durata

Controlli dei permessi

• Modalità auto: il classificatore esamina ogni frammento di codice prima che venga eseguito, non ogni chiamata a uno strumento. Non vede i valori calcolati in fase di esecuzione, come un percorso preso dall’output di una ricerca, quindi mantieni regole o hook per le chiamate che devi controllare. Ti può comunque essere chiesta conferma quando nuovo codice si avvia mentre è in esecuzione codice precedente
• Altre modalità di permesso: il codice si avvia senza revisione, e ti viene chiesta conferma per ogni chiamata a uno strumento per cui te la chiederebbe quella modalità

Codice di lunga durata

• Attesa: Claude risponde dopo che il codice è terminato, e il codice si interrompe dopo dieci minuti, incluso il tempo che passi sulle richieste di permesso
• Background: puoi continuare a parlare con Claude, e il codice può essere eseguito per un massimo di due ore

• Sei passato a un’altra modalità: premi Shift+Tab finché non torni alla modalità in cui hai iniziato
• Hai iniziato in un’altra modalità, oppure hai scelto la sessione dall’elenco di claude --resume: se la modalità auto è disponibile per te, esci, quindi esegui claude --continue --permission-mode auto con Code Mode attivo
• Hai passato nomi di strumenti a --tools: riavvia in modalità auto senza quel flag

Risoluzione dei problemi

Code Mode non si avvia

Richiesta di permesso con un conto alla rovescia

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

Chiamata a uno strumento rifiutata da un hook

• the hook failed: su una chiamata dal codice di Claude, il tuo hook non è riuscito ad avviarsi, è stato terminato, è uscito con 126, 127 o un codice superiore a 128, oppure ha restituito un errore HTTP o un output non valido. Correggi l’hook
• the hook did not finish: il tuo hook è andato in timeout su una chiamata dal codice di Claude, oppure su qualsiasi altra chiamata a uno strumento dopo che Claude ha eseguito codice nella sessione. Aumenta il timeout dell’hook

Output del codice trattenuto da un hook

Risorse correlate

• Modalità di permesso: confronta la modalità auto con le modalità che ti chiedono conferma
• Riferimento degli hook: scrivi hook PreToolUse e UserPromptSubmit
• Impostazioni gestite: applica un’unica configurazione a un’intera organizzazione