Aprenent IA

Code Mode: Claude Code escriu el guió d'una tirada

Des del 12 de novembre, Claude Code, l'agent de programació d'Anthropic, té un mode experimental en què Claude ja no demana les eines una per una: escriu un petit programa en JavaScript que les encadena i les pot llançar en paral·lel. Així s'activa, es posa a prova i es llegeix el codi que escriu, i aquest és el risc que convé conèixer abans de deixar-lo en mode automàtic.

Il·lustració: l'espurna de Claude, com a titellaire, mou alhora amb les creuetes tres titelles —una finestra de terminal, una lupa i un llapis— sobre un petit escenari.
📷 Imatge generada amb IA

En resum

  • Code Mode va arribar amb Claude Code v2.1.323, publicada el 12 de novembre de 2026, i està desactivat per defecte.
  • Claude escriu un fragment de JavaScript que fa les crides a eines, les pot llançar en paral·lel i només li torna el que necessita llegir.
  • S'activa amb la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE a 1, només en una sessió interactiva al terminal.
  • Segons la documentació, en mode automàtic el classificador revisa el codi, però no veu els valors que es calculen en executar-lo.

Què és Code Mode

Esquema il·lustrat en dues meitats: a l'esquerra, l'espurna de Claude va i torna amb una pilota a tres caixes, una per una; a la dreta, llança un sol full que arriba a les tres alhora i rep un únic sobre de tornada.
📷 Imatge generada amb IA

Claude Code és l'agent de programació per al terminal d'Anthropic, l'empresa estatunidenca que desenvolupa Claude. Treballa amb eines pròpies, com `Bash` per executar ordres, `Read` per llegir fitxers o `Edit` per modificar-los. Code Mode va arribar amb la versió v2.1.323, publicada el 12 de novembre de 2026.

Sense Code Mode, Claude demana cada crida, en llegeix el resultat i només aleshores decideix la següent. Amb Code Mode, escriu d'una vegada el guió que les encadena. Segons la documentació, convé provar-lo en tasques amb moltes crides relacionades: un canvi que es repeteix en molts fitxers, una cerca els resultats de la qual cal filtrar o diverses ordres independents que es poden executar alhora.

Un guió de quatre línies

La documentació ho il·lustra amb un exemple de quatre línies que apuja un límit de reintents. La primera fa servir `rg -l "function retryPolicy" src` per trobar els fitxers de `src` que contenen aquesta funció; la segona es queda amb el primer; la tercera crida `edit` per canviar `maxAttempts: 3` per `maxAttempts: 5`, i la quarta llança les proves amb `npm test -- retryPolicy`.

Segons la documentació, l'última línia només torna a Claude la ruta del fitxer i la sortida de les proves. A la conversa veus les crides, per exemple els canvis de l'edició (el diff), però no el codi: per llegir-lo hi ha el pas 5.

Què cal

Què cal per fer servir Code Mode
Requisit Què demana
Versió v2.1.323 o posterior (12-11-2026), al canal stable o al latest
Compte Subscripció de Claude o compte de Console; no funciona a través de passarel·les, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry ni Claude Models on Google Cloud (Anthropic managed)
Model Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2
On Només una sessió interactiva de claude al terminal: ni -p, ni Agent SDK, ni el panell de VS Code, ni l'aplicació d'escriptori, ni sessions al núvol
Instal·lació La compilació nativa de Claude Code; a Windows, amb Git for Windows instal·lat
Organització Sense la configuració HIPAA ni retenció zero de dades (zero data retention)
Requisits segons la documentació de Claude Code (consultada el 18-11-2026). És una funció experimental i pot canviar.

La taula recull el que demana la documentació. Tampoc no arrenca amb alguns ajustos actius, com un assistent de claus d'API (API key helper), l'exportació d'OpenTelemetry o `DISABLE_TELEMETRY`.

Passos 1 a 3: actualitza, activa i confirma

Les ordres surten de la documentació oficial. Pas 1: comprova la versió amb `claude --version` i, si és anterior a la v2.1.323, executa `claude update`. Al canal `stable` potser encara no hi ha arribat: caldrà esperar o passar-se a `latest`.

Pas 2: Code Mode s'activa amb la variable d'entorn `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` a `1`. A macOS, Linux o WSL: `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude`. Al PowerShell, a Windows, primer `$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"` i després `claude`. Per a totes les sessions, va al bloc `env` de `~/.claude/settings.json`: `{"env": {"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"}}`. Segons la documentació, Claude Code ignora aquesta variable als ajustos d'un projecte, de manera que un repositori que clonis no te'l pot activar.

Pas 3: la primera vegada demana confirmació. Tria Yes, turn on Code Mode; es reiniciarà i mostrarà prop del començament `Code Mode (experimental) is on · this session can be resumed only with Code Mode on`. Si apareix `Code Mode (experimental) isn't available`, el motiu surt a la mateixa línia i també a `/status`.

Passos 4 i 5: dona-li feina i llegeix-ne el codi

Il·lustració: una finestra de terminal plegada com un acordió; l'espurna de Claude desplega un dels plecs i deixa veure línies de codi representades com a barres de colors.
📷 Imatge generada amb IA

Pas 4: obre un projecte que coneguis, per poder jutjar el resultat, i dona-li una tasca amb moltes crides. La que proposa la documentació, en català: «Llegeix tots els fitxers Markdown d'aquest projecte i fes una llista dels enllaços que apunten a fitxers locals que no existeixen».

Pas 5: prem `Ctrl+O` per obrir el visor de la transcripció (transcript viewer). Cada fragment de codi hi apareix com una fila Code plegada; si la desplegues, veus el JavaScript que hi ha darrere de les crides. Amb `Ctrl+O` una altra vegada tornes a la conversa.

Pas 6: compara'l amb una sessió normal

Aquest pas no el descriu la documentació, però ensenya la diferència: repeteix la tasca en una sessió sense la variable, o amb la variable a `0`, i veuràs Claude demanar cada crida i llegir-ne el resultat abans de la següent. La documentació no diu que Code Mode sigui més ràpid ni més barat, així que no ho donis per fet.

Té límits. Per reprendre amb `claude --continue` o `claude --resume`, la variable ha de continuar a `1`: sense Code Mode, Claude Code s'hi nega. El codi que no va en segon pla s'atura als deu minuts, avisos de permís inclosos; en segon pla dura fins a dues hores, si la sessió es va iniciar en mode `auto` o `bypassPermissions`. I no hi ha Remote Control, Claude in Chrome ni ús de l'ordinador (computer use).

El vigilant revisa el guió, no cada pas

Qui revisa què, segons el mode
Mode Abans que s'executi el codi A cada crida
Automàtic (auto) El classificador revisa tot el codi Regles deny i ask i hooks; el classificador no veu els valors calculats en executar
Altres modes Res: arrenca sense revisió Regles, hooks i l'avís que demani aquell mode
Segons la documentació de Claude Code.
Il·lustració: a l'entrada d'un passadís, un guarda amb l'espurna de Claude a la placa examina amb una lupa un full d'instruccions; darrere la paret, fora de la seva vista, unes fletxes arriben a portes que només s'il·luminen quan hi arriben.
📷 Imatge generada amb IA

Segons la documentació, des de la v2.1.283 el mode automàtic és el d'inici a les sessions interactives de terminal i de VS Code. Com que Code Mode exigeix la v2.1.323, si no has canviat aquest mode és probable que ja hi treballis. La barra d'estat ho indica amb `auto mode on`, i `Shift+Tab` canvia de mode.

Cada crida del codi passa igualment per les teves regles `deny` i `ask` i pels teus hooks `PreToolUse`, amb el nom habitual de l'eina, com `Bash`. El que canvia és el classificador: revisa cada fragment de codi abans que s'executi, no cada crida, i no veu els valors calculats en executar-lo, com una ruta extreta d'una cerca.

En l'exemple dels reintents, el classificador pot aprovar un guió que edita el primer fitxer que trobi la cerca, però quin és només se sap en executar-lo. Per això la documentació recomana mantenir regles o hooks per a les crides que calgui controlar. En els altres modes, el codi arrenca sense revisió i es pregunta per cada crida que aquell mode preguntaria.

Com tapar els forats

Segons la documentació, en Code Mode un `git push` en una carpeta `app` pot arribar al hook com a `cd 'app' && git push`, de manera que un hook que filtri ordres n'ha de comprovar cada part. Per revisar el codi mateix, un hook `PreToolUse` que coincideixi amb `REPL`, l'eina que l'executa, pot llegir el JavaScript a `tool_input.code`.

Amb Code Mode o sense, les regles de `Bash` coincideixen amb el text de l'ordre, i Claude pot executar una ordre prohibida d'una manera que la regla no reconegui. Per a límits que no depenguin del text, la documentació remet a l'aïllament (sandboxing).

Si en mode automàtic Claude llança codi nou mentre un altre encara s'executa, el primer perd la revisió del classificador i Claude Code pregunta per les crides pendents amb un compte enrere: `Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session`. Sense resposta, la crida es rebutja. La v2.1.327, del 17 de novembre, va corregir un cas concret: el guió en marxa rebia avisos i rebutjos encara que el mode automàtic també permetés el segon; en els altres casos es manté el compte enrere.

Com desactivar-lo

Treu la variable del shell i de `~/.claude/settings.json` i obre una sessió nova, o deixa-la a `0`: segons la documentació, amb un `0` en un lloc continua desactivat encara que hi hagi un `1` a l'altre. Una empresa el pot bloquejar per a tota l'organització amb un `0` als ajustos gestionats (managed settings), però no activar-lo des d'allà.

Per continuar afinant Claude Code, en aquesta sèrie hi ha guies per muntar tres subagents que no et donen la raó i una skill que posa ordre a les teves skills.

Llegir-ne més: Claude Code: tres subagents que no et donen la raó, en una altra lliçó ↗

Conclusió

Code Mode canvia el ritme de Claude Code: en lloc d'anar crida per crida, Claude escriu un guió que les encadena, les llança en paral·lel quan pot i es queda amb el que necessita llegir. Es prova amb una variable d'entorn i una tasca de molts fitxers, i `Ctrl+O` ensenya què ha escrit. El que no canvia és la necessitat de vigilar: en mode automàtic, el classificador revisa el guió sencer, no cada crida, així que les crides que importen han de continuar protegides amb regles, hooks o aïllament.

Fonts primàries

Comentaris

Sigues respectuós. Els comentaris es moderen.

    La continuació natural

    Aprèn IA al teu ritme amb els nostres cursos gratuïts.

    A la nostra plataforma d'aprenentatge TAKU podràs accedir a aquest i a molts altres cursos de manera totalment gratuïta.

    APRENDRE AMB TAKU

    ← Torna al blog