Claude Code Code Mode: Claude escribe JavaScript en lugar de llamar a las herramientas una a una
Desde el 12 de noviembre de 2026 Claude Code tiene un Code Mode experimental: Claude escribe JavaScript con varias llamadas a herramientas. Activación, límites.
El 12 de noviembre de 2026 Anthropic publicó Claude Code v2.1.323 con el Code Mode, un modo experimental en el que Claude escribe un fragmento de JavaScript que hace varias llamadas a herramientas en un solo paso, en lugar de pedir una herramienta cada vez y leer cada resultado. Viene desactivado por defecto, solo funciona en terminal con la API de Anthropic y se puede bloquear para toda la organización.
In sintesi
- El Code Mode llegó con Claude Code v2.1.323 (12 de noviembre de 2026), es experimental y está apagado por defecto. Se activa con
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1. - Claude escribe JavaScript que lanza comandos en paralelo, usa un resultado en la llamada siguiente y devuelve solo la parte de la salida que necesita.
- Cada llamada del código sigue pasando por tus reglas
denyyasky por los hooksPreToolUse. En auto mode, en cambio, el clasificador revisa el código, no cada llamada. - No funciona con Bedrock, gateways,
-p, Agent SDK, VS Code, Desktop, sesiones en la nube ni con organizaciones con ZDR o HIPAA. El código se detiene a los 10 minutos, o a las 2 horas en segundo plano. - La idea no es nueva: Anthropic la describió para MCP en noviembre de 2025 y Cloudflare publica el paquete
@cloudflare/codemode.
Qué cambia respecto a las llamadas directas
Sin Code Mode, Claude pide una llamada a una herramienta (Bash, Read, Edit), lee el resultado y decide el siguiente paso. Con Code Mode escribe un programa que hace las llamadas, y Claude Code lo ejecuta en tu sesión. Según la documentación oficial del Code Mode, un solo fragmento de código puede ejecutar comandos en paralelo, usar un resultado en la llamada siguiente y devolver solo la parte de la salida que Claude necesita leer.
El ejemplo de la documentación sube un límite de reintentos: encuentra el archivo, lo edita, lanza los tests, y la última línea devuelve a Claude la ruta y la salida de los tests.
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() });
En la conversación ves las llamadas (el diff de la edición, por ejemplo) y no el código. Para leerlo pulsa Ctrl+O: cada fragmento aparece como una fila Code plegada en el visor de transcripción.
Por qué Anthropic ha llegado aquí
El razonamiento es de tokens. En el artículo de ingeniería Code execution with MCP (4 de noviembre de 2025) Anthropic señala dos costes de las llamadas directas: las definiciones de herramientas ocupan contexto y cada resultado intermedio pasa por el modelo. Su ejemplo de Google Drive a Salesforce baja de unos 150.000 a 2.000 tokens, una reducción del 98,7 %. Es una cifra del proveedor sobre un escenario construido por ellos, no una medición del Code Mode de Claude Code, y no la he verificado.
El mismo artículo indica que Cloudflare obtuvo resultados parecidos con el nombre "Code Mode". El repositorio Cloudflare Agents incluye el paquete @cloudflare/codemode, descrito como "LLMs write executable code that calls your tools, instead of one tool call at a time". El Code Mode de Claude Code lleva un patrón ya existente a un agente de programación muy usado.
Cómo activarlo y probarlo
Necesitas Claude Code v2.1.323 o posterior, una cuenta Claude o Console y la build nativa. Comprueba con claude --version y actualiza con claude update. Luego inicia la sesión con la variable:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Para tenerlo en todas las sesiones, ponla en tu archivo de usuario ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Claude Code ignora esta variable en los archivos de settings de un proyecto, así que un repositorio clonado no puede activarla por ti. En el primer arranque pide confirmación y muestra arriba Code Mode (experimental) is on. La documentación propone probarlo con una tarea de muchas llamadas relacionadas, por ejemplo: "Lee cada archivo Markdown del proyecto y lista los enlaces a archivos locales que no existen".
Para retomar una sesión de Code Mode con --continue o --resume, la variable debe seguir en 1; si no, Claude Code se niega a retomarla.
Requisitos y límites
El Code Mode tiene muchas restricciones, y a varias empresas les bastan hoy para descartarlo. Resumen de la documentación:
| Aspecto | Estado |
|---|---|
| Modelos | Claude Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 |
| Proveedores | Solo API de Anthropic: sin Bedrock, gateway, Claude Platform on AWS, Google Cloud, Microsoft Foundry |
| Superficies | Solo claude interactivo en terminal: sin -p, Agent SDK, VS Code, Desktop, sesiones en la nube |
| Organización | No disponible con configuración HIPAA ni zero data retention |
| Telemetría | No arranca con API key helper, agent teams, exportación OpenTelemetry o DISABLE_TELEMETRY |
| Duración | El código se detiene a los 10 minutos si Claude espera, hasta 2 horas en segundo plano |
| Funciones | Sin Remote Control, Claude in Chrome, computer use; la sesión no se puede mover a Desktop |
El punto de los proveedores pesa si usas Claude Code a través de Bedrock o un gateway interno: el Code Mode no arranca, con el mensaje it only works with the Anthropic API. Quien tenga OpenTelemetry para monitorizar costes debe elegir, porque hoy no conviven.
Permisos y seguridad: qué cambia de verdad
Cada llamada del código sigue pasando por tus reglas deny y ask y por los hooks PreToolUse, así que no hace falta reescribir matchers de herramientas como Bash. El cambio está en el auto mode: el clasificador revisa el código antes de ejecutarlo, no cada llamada, y no ve los valores calculados en tiempo de ejecución, como una ruta tomada de la salida de una búsqueda. La documentación recomienda mantener reglas o hooks para las llamadas que debas controlar.
Para inspeccionar el código, escribe un hook PreToolUse que haga match con REPL, la herramienta que ejecuta el código de Claude, y lee el JavaScript en tool_input.code. Dos avisos de la misma página. Las reglas de Bash comparan el texto del comando, así que un comando denegado puede colarse en una forma que la regla no reconoce, con o sin Code Mode: para límites que no dependan del texto del comando hace falta sandboxing. Y si un hook PreToolUse falla o agota el tiempo, la llamada se rechaza aunque onFailure no esté definido. Usa "onFailure": "continue" solo donde aceptes el riesgo.
Cómo bloquearlo en la organización
Un administrador puede impedir su uso con las managed settings. El valor 0 siempre gana sobre un 1 definido en otro sitio:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
}
}
Quien ya está en una sesión de Code Mode sigue en ella hasta salir. Tras reiniciar, no puede retomar esas sesiones mientras el 0 esté vigente. Desde las managed settings no se puede activarlo para los usuarios: la adopción sigue siendo una decisión individual.
Qué hacer ahora
El punto de vista de Rayo: es una función para probar en un caso concreto, no para encender a todo el mundo.
- Elige una tarea repetitiva con muchas llamadas relacionadas: una edición idéntica en decenas de archivos, o una búsqueda que requiere filtrar antes de leer.
- Ejecútala dos veces en el mismo repositorio, con y sin Code Mode, y compara el consumo de tokens y el tiempo que muestra tu cuenta. La documentación no publica cifras de ahorro para Claude Code, así que la medición es tuya.
- Abre el código con
Ctrl+Oy léelo: es el mismo trabajo de revisión que harías con un script de un compañero. - Si usas auto mode, añade un hook
PreToolUsesobreREPLantes de ampliar el uso al equipo. - En empresas con Bedrock, ZDR o HIPAA deja el
0en las managed settings y vuelve a evaluar cuando la función salga de la fase experimental. La documentación avisa de que puede cambiar o desaparecer en cualquier versión.
Si tu problema es el gasto de tokens en general, hay palancas más simples: mira cómo ahorrar tokens en Claude Code.
Fuentes
- Run tool calls from code with Code Mode, documentación de Claude Code
- Release v2.1.323 de Claude Code, GitHub, 12 de noviembre de 2026
- Code execution with MCP, Anthropic Engineering, 4 de noviembre de 2025
- Repositorio cloudflare/agents, paquete codemode
FAQ
¿Cómo activo el Code Mode en Claude Code?
Actualiza a v2.1.323 o posterior e inicia claude con CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1, o pon la variable en el bloque env de ~/.claude/settings.json. La primera vez confirmas con "Yes, turn on Code Mode" y Claude Code se reinicia.
¿El Code Mode ahorra tokens? La documentación de Claude Code no publica cifras. El artículo de Anthropic de noviembre de 2025 da un ejemplo de unos 150.000 a 2.000 tokens con ejecución de código sobre MCP, pero es un escenario del proveedor. En tu caso hay que medirlo.
¿Funciona con Bedrock o en modo -p?
No. Solo funciona con la API de Anthropic y en una sesión interactiva de claude en terminal. Quedan fuera Bedrock, gateways, Agent SDK, VS Code, Desktop y sesiones en la nube.
¿Es seguro con el auto mode?
Cada llamada pasa por reglas deny y ask y hooks PreToolUse. En auto mode, en cambio, el clasificador revisa el código y no ve los valores calculados en ejecución. Para llamadas críticas hacen falta reglas, hooks y sandboxing.
¿Cómo lo bloqueo para toda la empresa?
Pon CLAUDE_CODE_EXPERIMENTAL_CODE_MODE en 0 en las managed settings. El 0 prevalece sobre cualquier 1 definido en otro lugar.