Cómo activar Code Mode en Claude Code (y cuándo merece la pena)

El nuevo Code Mode experimental de Claude Code permite que Claude escriba JavaScript que ejecuta muchas llamadas a herramientas en un solo paso. Así puedes activarlo, probarlo y desactivarlo.

Graphic of a terminal with one code block branching into several tool icons, for a guide to Code Mode in Claude Code

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:

Código
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 claude en 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

Código
claude --version

Si el número es inferior a 2.1.323, actualiza:

Código
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:

Código
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

Windows PowerShell:

Código
$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:

Código
{
  "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:

Código
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:

Código
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:

Código
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:

Código
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:

Código
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 mostradoSolución
it isn't open to your account yetActualiza 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 APIElimina 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 helperElimina 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 modelsEmpieza con un modelo compatible, por ejemplo claude --model opus
it needs settings that Claude Code downloads from AnthropicQuita la variable que desactiva la descarga de feature flags, como DISABLE_TELEMETRY
your organization's settings don't allow itPregunta a tu administrador por el ajuste administrado

Otros problemas:

  • Ninguna línea sobre Code Mode: comprueba la versión, verifica que la variable vale 1 en tu shell o en tus ajustes de usuario y elimina cualquier 0.
  • 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 PreToolUse falló o agotó el tiempo. Arregla el hook o aumenta su timeout.

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.

Escrito por Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Acerca de Mindloop Experience

Respuestas

Escribe una respuesta

Más de Mindloop Experience

Ver todo de Mindloop Experience

Puedes aplaudir hasta 50 veces.