Normalmente, Claude Code solicita cada llamada a una herramienta directamente y lee el resultado antes de decidir qué hacer a continuación. Code Mode, añadido en la versión 2.1.323 el 12 de noviembre de 2026, permite que Claude escriba un breve fragmento de JavaScript que hace varias llamadas a herramientas en un solo paso. Esta guía te muestra cómo activarlo, probarlo en una tarea real, leer el código que escribió Claude y volver a desactivarlo.
A 15 de noviembre de 2026, Code Mode es experimental y está desactivado por defecto. La documentación de Anthropic dice que puede cambiar o desaparecer en cualquier versión.
Qué hace Code Mode
En una sesión normal, Claude pide herramientas como Bash, Read o Edit directamente y lee cada resultado antes del siguiente paso. En una sesión con Code Mode sigues escribiendo tu prompt en lenguaje normal, pero Claude escribe JavaScript para llevarlo a cabo. Un solo fragmento de código puede ejecutar comandos en paralelo, pasar un resultado a la siguiente llamada y devolver solo la parte de la salida que Claude necesita leer.
La documentación de Code Mode de Anthropic da este ejemplo de lo que Claude podría escribir si le pides aumentar un límite de reintentos. Busca el archivo, lo edita y ejecuta las pruebas:
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() });
Tú no escribes este código y, por defecto, no lo ves. La conversación muestra las llamadas a herramientas, como el diff de la edición.
La documentación sugiere probarlo en tareas que requieren muchas llamadas a herramientas relacionadas:
- un cambio que se repite en muchos archivos;
- una búsqueda cuyos resultados hay que filtrar antes de que Claude los lea;
- varios comandos independientes que pueden ejecutarse a la vez.
Lee primero las limitaciones
Code Mode tiene contrapartidas reales. Comprueba que puedes vivir con ellas antes de activarlo:
- Reanudar: una sesión con Code Mode solo se puede reanudar en la terminal y con Code Mode activado.
- Código de larga duración: salvo que el código pueda ejecutarse en segundo plano (ver el paso 6), tienes que esperar, y se detiene a los diez minutos.
- Funciones que faltan: Remote Control, Claude in Chrome y computer use no funcionan en una sesión con Code Mode, y no puedes mover la sesión a la app de escritorio.
Qué necesitas
- Claude Code v2.1.323 o posterior, instalado con la compilación nativa.
- Una suscripción a Claude o una cuenta de Claude Console. Code Mode no funciona a través de un gateway, Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud ni Microsoft Foundry.
- Uno de estos modelos: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2.
- Una sesión interactiva de
claudeen una terminal. No funciona con-p, el Agent SDK, el panel de VS Code, la app de escritorio ni las sesiones en la nube. - En Windows, tener instalado Git for Windows.
- Una organización que no use la configuración HIPAA ni la retención cero de datos.
Paso 1: comprueba tu versión
claude --version
Si el número es inferior a 2.1.323, actualiza:
claude update
Si estás en el canal de versiones stable y la actualización todavía no llega a 2.1.323, la documentación indica que esperes a que stable se ponga al día o cambies a latest.
Paso 2: inicia Claude Code con Code Mode activado
Code Mode se controla con una sola variable de entorno, CLAUDE_CODE_EXPERIMENTAL_CODE_MODE. Para probarlo una vez, define la variable solo para un arranque.
macOS, Linux o WSL:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Windows PowerShell:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
Para activarlo en cada nueva sesión, añade un bloque env a tu archivo de ajustes de usuario en ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Claude Code ignora esta variable en los archivos de ajustes de un proyecto, así que un repositorio que clones no puede activar Code Mode por ti.
Paso 3: confirma el aviso
Antes de tu primera sesión con Code Mode, Claude Code te pide confirmación. Selecciona Yes, turn on Code Mode (Sí, activar Code Mode). Claude Code se reinicia y muestra esta línea cerca de la parte superior de la sesión:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
Si ves otra línea, o ninguna, salta a la sección de errores más abajo.
Paso 4: dale a Claude una tarea con muchas llamadas a herramientas
En un proyecto que conozcas bien, prueba el prompt de la documentación:
Read every Markdown file in this project and list the links that point to local files that don't exist.
Otro prompt que encaja con el patrón:
Run the linter, the type checker and the unit tests at the same time, then summarize only the failures.
Resultado esperado: Claude responde como siempre y ves las llamadas a herramientas que hizo.
Paso 5: lee el código que escribió Claude
Pulsa Ctrl+O para abrir el visor de la transcripción. Cada fragmento de código aparece como una fila contraída Code. Despliega una para ver el JavaScript detrás de las llamadas a herramientas y vuelve a pulsar Ctrl+O para regresar a la conversación.
Paso 6: gestiona los permisos y las tareas largas
Tus ajustes de seguridad actuales siguen aplicándose. Cada llamada a herramienta que hace el código pasa por tus reglas de permisos deny y ask y por tus hooks PreToolUse, y no necesitas cambiar ninguna regla para una herramienta como Bash.
Lo que cambia es cómo se revisa el código:
- En el modo auto, un clasificador revisa cada fragmento de código antes de ejecutarlo, no cada llamada a herramienta. No puede ver valores que se calculan mientras el código se ejecuta, como una ruta sacada de los resultados de una búsqueda. Mantén reglas o hooks para todo lo que necesites controlar.
- En otros modos de permisos, el código arranca sin revisión y recibes un aviso por cada llamada a herramienta que normalmente te lo pediría.
Para compilaciones o pruebas largas, Claude espera al código, que se detiene a los diez minutos, o deja que siga en segundo plano, donde puede ejecutarse hasta dos horas mientras sigues hablando. El código en segundo plano necesita una sesión iniciada en modo auto o en modo bypassPermissions. Si tienes acceso al modo auto, la documentación da esta forma de reiniciar en él:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue --permission-mode auto
Para revisar el código tú mismo con tu propio script, escribe un hook PreToolUse que coincida con REPL, la herramienta que ejecuta el código de Claude, y lee el JavaScript desde tool_input.code.
Paso 7: reanuda o desactívalo
Para volver más tarde a una sesión con Code Mode, mantén la variable definida al reanudar:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude --continue
Con Code Mode desactivado, Claude Code se niega a reanudar esa sesión. Las sesiones que iniciaste sin Code Mode se reanudan sin él, aunque la variable esté definida.
Para desactivar Code Mode, elimina CLAUDE_CODE_EXPERIMENTAL_CODE_MODE de tu shell y de ~/.claude/settings.json y luego inicia una nueva sesión. También puedes poner su valor en 0. Un 0 en un sitio mantiene Code Mode desactivado aunque el otro diga 1.
Los administradores pueden bloquearlo para toda una organización poniendo el mismo bloque env, con el valor "0", en los ajustes administrados (managed settings). Los ajustes administrados solo pueden bloquear Code Mode. No pueden activarlo para los usuarios.
Errores comunes y soluciones
Si la sesión empieza con Code Mode (experimental) isn't available, el motivo aparece en la misma línea, y /status también lo muestra. Corrige la causa e inicia una nueva sesión. La tabla cubre varios motivos; la documentación recoge el resto.
| Motivo mostrado | Solución |
|---|---|
it isn't open to your account yet | Actualiza si tienes una versión inferior a v2.1.323. Si no, revisa tu red y vuelve a empezar. Si persiste, inténtalo otro día |
it only works with the Anthropic API | Elimina los ajustes que envían las solicitudes a través de un proveedor de nube, un gateway o una ANTHROPIC_BASE_URL personalizada |
it doesn't work with an API key helper | Elimina apiKeyHelper, ANTHROPIC_AUTH_TOKEN y cualquier encabezado Authorization o X-Api-Key en ANTHROPIC_CUSTOM_HEADERS, y después inicia sesión o define ANTHROPIC_API_KEY |
it only works with Opus 5.5, Sonnet 5.5 and later models | Empieza con un modelo compatible, por ejemplo claude --model opus |
it needs settings that Claude Code downloads from Anthropic | Quita la variable que desactiva la descarga de feature flags, como DISABLE_TELEMETRY |
your organization's settings don't allow it | Pregunta a tu administrador por el ajuste administrado |
Otros problemas:
- Ninguna línea sobre Code Mode: comprueba la versión, verifica que la variable vale
1en tu shell o en tus ajustes de usuario y elimina cualquier0. - Un aviso de permisos con cuenta atrás: en modo auto, cuando Claude lanza más código mientras el anterior sigue ejecutándose, puede que te pregunte por las llamadas pendientes del código anterior. Responde antes de que termine la cuenta atrás o esa llamada se rechazará.
- Claude informa de una llamada a herramienta rechazada: un hook
PreToolUsefalló o agotó el tiempo. Arregla el hook o aumenta sutimeout.
Conclusión
Code Mode merece la pena si tus sesiones incluyen muchas búsquedas, ediciones y pruebas repetidas. Actívalo para una sesión con la variable de entorno, dale una tarea de muchos pasos y lee el código con Ctrl+O. Espera cambios mientras siga siendo experimental.
Si estás ampliando tu configuración de Claude Code, nuestras guías sobre agent skills en Claude Code y sobre cómo dar a tu agente un navegador real con Chrome DevTools MCP son buenas lecturas para seguir.
Fuentes
Enlaces revisados por última vez el 15 de noviembre de 2026.





Escribe una respuesta