Claude Code Code Mode: Claude scrive JavaScript invece di chiamare i tool uno a uno
Dal 12 novembre 2026 Claude Code ha un Code Mode sperimentale: Claude scrive JavaScript che fa più chiamate ai tool. Attivazione, limiti e permessi.
Il 12 novembre 2026 Anthropic ha rilasciato Claude Code v2.1.323 con il Code Mode, una modalità sperimentale in cui Claude scrive un frammento di JavaScript che esegue più chiamate ai tool in un solo passaggio, invece di chiedere un tool alla volta e leggere ogni risultato. È disattivata di default, funziona solo in terminale con l'API Anthropic e può essere bloccata a livello di organizzazione.
In sintesi
- Il Code Mode è arrivato in Claude Code v2.1.323 (12 novembre 2026), è sperimentale e spento di default. Si attiva con
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1. - Claude scrive JavaScript che lancia comandi in parallelo, usa un risultato nella chiamata successiva e restituisce solo la parte di output che gli serve.
- Ogni chiamata fatta dal codice passa comunque dalle regole
denyeaske dagli hookPreToolUse. In auto mode però il classificatore rivede il codice, non ogni singola chiamata. - Non funziona con Bedrock, gateway,
-p, Agent SDK, VS Code, Desktop, sessioni cloud, né con organizzazioni in ZDR o HIPAA. Il codice si ferma dopo 10 minuti, 2 ore se in background. - L'idea non è nuova: Anthropic l'ha descritta a novembre 2025 per MCP e Cloudflare ha un pacchetto
@cloudflare/codemode.
Cosa cambia rispetto alle chiamate dirette
Senza Code Mode Claude chiede una chiamata a un tool (Bash, Read, Edit), legge il risultato e decide il passo dopo. Con il Code Mode scrive un programma che fa le chiamate, e Claude Code lo esegue nella tua sessione. Lo dice la documentazione ufficiale del Code Mode: un solo pezzo di codice può eseguire comandi in parallelo, usare un risultato nella chiamata successiva e restituire solo la parte di output che Claude deve leggere.
L'esempio della documentazione è un cambio di limite di retry: trova il file, lo modifica, lancia i test, e l'ultima riga restituisce a Claude il percorso e l'output dei test.
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() });
Nella conversazione vedi le chiamate (il diff della modifica, per esempio) e non il codice. Per leggerlo premi Ctrl+O: ogni frammento compare come riga Code compressa nel transcript viewer.
Perché Anthropic ci è arrivata
La logica viene da un ragionamento sui token. Nel post di ingegneria Code execution with MCP (4 novembre 2025) Anthropic descrive due costi delle chiamate dirette: le definizioni dei tool occupano contesto e ogni risultato intermedio passa dal modello. Il suo esempio, dal Google Drive a Salesforce, scende da circa 150.000 a 2.000 token, una riduzione del 98,7%. È un dato del vendor su uno scenario costruito da loro, non una misura sul Code Mode di Claude Code, e non l'ho verificato.
Lo stesso post nota che Cloudflare ha trovato risultati simili con il nome "Code Mode". Il repository Cloudflare Agents include il pacchetto @cloudflare/codemode, descritto come "LLMs write executable code that calls your tools, instead of one tool call at a time". Il Code Mode di Claude Code è quindi l'arrivo di un pattern già circolante dentro un coding agent molto usato.
Come attivarlo e provarlo
Servono Claude Code v2.1.323 o successivo, un account Claude o Console e il build nativo. Controlla con claude --version e aggiorna con claude update. Poi avvia la sessione con la variabile:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Per averlo in ogni sessione, mettila nel file utente ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Claude Code ignora questa variabile nei file di settings di un progetto, quindi un repository clonato non può accenderla al posto tuo. Al primo avvio chiede conferma e mostra in cima la riga Code Mode (experimental) is on. La documentazione propone di provarlo con un compito che richiede molte chiamate correlate, per esempio: "Leggi ogni file Markdown del progetto e elenca i link a file locali che non esistono".
Se vuoi riprendere una sessione Code Mode con --continue o --resume, la variabile deve restare a 1, altrimenti Claude Code rifiuta di riprenderla.
Requisiti e limiti
Il Code Mode ha parecchi vincoli, e per molte aziende bastano a escluderlo oggi. Li riassumo dalla documentazione:
| Aspetto | Stato |
|---|---|
| Modelli | Claude Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 |
| Provider | Solo API Anthropic: no Bedrock, gateway, Claude Platform on AWS, Google Cloud, Microsoft Foundry |
| Superfici | Solo claude interattivo in terminale: no -p, Agent SDK, VS Code, Desktop, sessioni cloud |
| Organizzazione | Non disponibile con configurazione HIPAA o zero data retention |
| Telemetria | Non parte con API key helper, agent teams, export OpenTelemetry o DISABLE_TELEMETRY |
| Durata | Il codice si ferma dopo 10 minuti se Claude aspetta, fino a 2 ore in background |
| Funzioni | Niente Remote Control, Claude in Chrome, computer use; la sessione non si sposta su Desktop |
Il punto sui provider pesa se usi Claude Code tramite Bedrock o un gateway interno: lì il Code Mode non parte, con il messaggio it only works with the Anthropic API. Chi ha OpenTelemetry attivo per il monitoraggio dei costi deve scegliere, perché le due cose oggi non convivono.
Permessi e sicurezza: cosa cambia davvero
Ogni chiamata fatta dal codice passa comunque dalle regole deny e ask e dagli hook PreToolUse, quindi non serve riscrivere i matcher per tool come Bash. Il cambiamento riguarda l'auto mode: il classificatore rivede il codice prima che parta, non ogni chiamata, e non vede i valori calcolati a runtime, come un percorso preso dall'output di una ricerca. La documentazione consiglia di tenere regole o hook per le chiamate che devi controllare.
Per ispezionare il codice, scrivi un hook PreToolUse che fa match su REPL, il tool che esegue il codice di Claude, e leggi il JavaScript da tool_input.code. Due avvertenze dalla stessa pagina. Le regole Bash confrontano il testo del comando, quindi un comando negato può passare in una forma che la regola non riconosce, con o senza Code Mode: per limiti indipendenti dal testo serve il sandboxing. E se un hook PreToolUse non risponde o va in timeout, la chiamata viene rifiutata, anche se onFailure non è impostato. Imposta "onFailure": "continue" solo dove accetti il rischio.
Come bloccarlo in un'organizzazione
Un amministratore può impedirne l'uso con le managed settings. Il valore 0 vince sempre sul valore 1 impostato altrove:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
}
}
Chi è già in una sessione Code Mode ci resta fino alla chiusura. Dopo il riavvio non può più riprendere quelle sessioni finché lo 0 è in vigore. Dalle managed settings non si può invece attivarlo per gli utenti: l'adozione resta una scelta individuale.
Cosa fare adesso
Il mio punto di vista come Rayo: è una funzione da provare su un caso preciso, non da accendere per tutti.
- Scegli un compito ripetitivo con molte chiamate correlate: una modifica identica su decine di file, o una ricerca con filtro prima della lettura.
- Eseguilo due volte sullo stesso repository, con e senza Code Mode, e confronta il consumo di token e il tempo che il tuo account mostra. La documentazione non pubblica numeri di risparmio per Claude Code, quindi la misura è tua.
- Apri il codice con
Ctrl+Oe leggilo: è lo stesso lavoro di revisione che faresti su uno script scritto da un collega. - Se usi l'auto mode, aggiungi un hook
PreToolUsesuREPLprima di estendere l'uso al team. - Nelle aziende con Bedrock, ZDR o HIPAA lascia lo
0nelle managed settings e rivaluta quando la funzione uscirà dalla fase sperimentale. La documentazione avvisa che può cambiare o sparire in qualsiasi release.
Se il tuo problema è il consumo di token in generale, le leve più semplici sono altre: vedi come ridurre i token di Claude Code.
Fonti
- Run tool calls from code with Code Mode, documentazione Claude Code
- Release v2.1.323 di Claude Code, GitHub, 12 novembre 2026
- Code execution with MCP, Anthropic Engineering, 4 novembre 2025
- Repository cloudflare/agents, pacchetto codemode
FAQ
Come si attiva il Code Mode in Claude Code?
Aggiorna a v2.1.323 o successivo e avvia claude con CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1, oppure metti la variabile nel blocco env di ~/.claude/settings.json. Alla prima volta confermi con "Yes, turn on Code Mode" e Claude Code si riavvia.
Il Code Mode fa risparmiare token? La documentazione di Claude Code non pubblica numeri. Il post Anthropic del novembre 2025 riporta un esempio da circa 150.000 a 2.000 token con l'esecuzione di codice su MCP, ma è uno scenario del vendor. Per il tuo caso va misurato.
Funziona con Bedrock o in modalità -p?
No. Funziona solo con l'API Anthropic e in una sessione claude interattiva nel terminale. Restano fuori Bedrock, gateway, Agent SDK, VS Code, Desktop e sessioni cloud.
È sicuro con l'auto mode?
Ogni chiamata passa da regole deny, ask e hook PreToolUse. In auto mode però il classificatore rivede il codice e non vede i valori calcolati a runtime. Per le chiamate critiche servono regole, hook e sandboxing.
Come lo blocco per tutta l'azienda?
Metti CLAUDE_CODE_EXPERIMENTAL_CODE_MODE a 0 nelle managed settings. Il valore 0 prevale su qualsiasi 1 impostato altrove.