Aprendiendo IA

Code Mode: Claude Code escribe el guion de un tirón

Desde el 12 de noviembre, Claude Code, el agente de programación de Anthropic, tiene un modo experimental en el que Claude ya no pide sus herramientas una a una: escribe un pequeño programa en JavaScript que las encadena y puede lanzarlas en paralelo. Así se activa, se pone a prueba y se lee el código que escribe, y este es el riesgo que conviene conocer antes de dejarlo en modo automático.

Ilustración: el destello de Claude, como titiritero, mueve a la vez con sus crucetas tres marionetas —una ventana de terminal, una lupa y un lápiz— sobre un pequeño escenario.
📷 Imagen generada con IA

En resumen

  • Code Mode llegó con Claude Code v2.1.323, publicada el 12 de noviembre de 2026, y está apagado por defecto.
  • Claude escribe un trozo de JavaScript que hace las llamadas a herramientas, puede lanzarlas en paralelo y le devuelve solo lo que necesita leer.
  • Se enciende con la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE a 1, solo en una sesión interactiva en la terminal.
  • Según la documentación, en modo automático el clasificador revisa el código, pero no ve los valores que se calculan al ejecutarlo.

Qué es Code Mode

Esquema ilustrado en dos mitades: a la izquierda, el destello de Claude va y vuelve con una pelota a tres cajas, una por una; a la derecha, lanza una sola hoja que llega a las tres a la vez y recibe un único sobre de vuelta.
📷 Imagen generada con IA

Claude Code es el agente de programación para la terminal de Anthropic, la empresa estadounidense que desarrolla Claude. Trabaja con herramientas propias, como `Bash` para ejecutar comandos, `Read` para leer archivos o `Edit` para modificarlos. Code Mode llegó con la versión v2.1.323, publicada el 12 de noviembre de 2026.

Sin Code Mode, Claude pide cada llamada, lee su resultado y solo entonces decide la siguiente. Con él, escribe de una vez el guion que las encadena. Según la documentación, conviene probarlo en tareas con muchas llamadas relacionadas: un cambio que se repite en muchos archivos, una búsqueda cuyos resultados hay que filtrar o varios comandos independientes que pueden correr a la vez.

Un guion de cuatro líneas

La documentación lo ilustra con un ejemplo de cuatro líneas que sube un límite de reintentos. La primera usa `rg -l "function retryPolicy" src` para encontrar los archivos de `src` que contienen esa función; la segunda se queda con el primero; la tercera llama a `edit` para cambiar `maxAttempts: 3` por `maxAttempts: 5`, y la cuarta lanza los tests con `npm test -- retryPolicy`.

Según la documentación, la última línea devuelve a Claude solo la ruta del archivo y la salida de los tests. En la conversación ves las llamadas, por ejemplo los cambios de la edición (el diff), pero no el código: para leerlo está el paso 5.

Qué hace falta

Qué hace falta para usar Code Mode
Requisito Qué pide
Versión v2.1.323 o posterior (12-11-2026), en el canal stable o en latest
Cuenta Suscripción de Claude o cuenta de Console; no vale a través de pasarelas, Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, Microsoft Foundry ni Claude Models on Google Cloud (Anthropic managed)
Modelo Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2
Dónde Solo una sesión interactiva de claude en la terminal: ni -p, ni Agent SDK, ni el panel de VS Code, ni la app de escritorio, ni sesiones en la nube
Instalación La compilación nativa de Claude Code; en Windows, con Git for Windows instalado
Organización Sin la configuración HIPAA ni retención cero de datos (zero data retention)
Requisitos según la documentación de Claude Code (consultada el 18-11-2026). Es una función experimental y puede cambiar.

La tabla recoge lo que pide la documentación. Tampoco arranca con algunos ajustes activos, como un asistente de claves de API (API key helper), la exportación de OpenTelemetry o `DISABLE_TELEMETRY`.

Pasos 1 a 3: actualiza, enciende y confirma

Los comandos salen de la documentación oficial. Paso 1: comprueba la versión con `claude --version` y, si es anterior a la v2.1.323, ejecuta `claude update`. En el canal `stable` puede que aún no llegue: toca esperar o pasarse a `latest`.

Paso 2: Code Mode se enciende con la variable de entorno `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE` a `1`. En macOS, Linux o WSL: `CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude`. En PowerShell, en Windows, primero `$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"` y después `claude`. Para todas las sesiones, va en el bloque `env` de `~/.claude/settings.json`: `{"env": {"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"}}`. Según la documentación, Claude Code ignora esta variable en los ajustes de un proyecto, así que un repositorio que clones no puede encendértelo.

Paso 3: la primera vez pide confirmación. Elige Yes, turn on Code Mode; se reiniciará y mostrará cerca del principio `Code Mode (experimental) is on · this session can be resumed only with Code Mode on`. Si aparece `Code Mode (experimental) isn't available`, el motivo va en la misma línea y también en `/status`.

Pasos 4 y 5: dale trabajo y lee su código

Ilustración: una ventana de terminal plegada como un acordeón; el destello de Claude despliega uno de los pliegues y deja ver líneas de código representadas como barras de colores.
📷 Imagen generada con IA

Paso 4: abre un proyecto que conozcas, para poder juzgar el resultado, y dale una tarea con muchas llamadas. La que propone la documentación, en español: «Lee todos los archivos Markdown de este proyecto y haz una lista de los enlaces que apuntan a archivos locales que no existen».

Paso 5: pulsa `Ctrl+O` para abrir el visor de la transcripción (transcript viewer). Cada trozo de código aparece como una fila Code plegada; al desplegarla ves el JavaScript que hay detrás de las llamadas. Con `Ctrl+O` otra vez vuelves a la conversación.

Paso 6: compáralo con una sesión normal

Este paso no lo describe la documentación, pero enseña la diferencia: repite la tarea en una sesión sin la variable, o con ella a `0`, y verás a Claude pedir cada llamada y leer su resultado antes de la siguiente. La documentación no dice que Code Mode sea más rápido ni más barato, así que no lo des por hecho.

Tiene límites. Para reanudar con `claude --continue` o `claude --resume`, la variable debe seguir a `1`: sin Code Mode, Claude Code se niega. El código que no va en segundo plano se detiene a los diez minutos, avisos de permiso incluidos; en segundo plano dura hasta dos horas, si la sesión arrancó en modo `auto` o `bypassPermissions`. Y no hay Remote Control, Claude in Chrome ni uso del ordenador (computer use).

El vigilante revisa el guion, no cada paso

Quién revisa qué, según el modo
Modo Antes de que corra el código En cada llamada
Automático (auto) El clasificador revisa el código entero Reglas deny y ask y hooks; el clasificador no ve los valores calculados al ejecutar
Otros modos Nada: arranca sin revisión Reglas, hooks y el aviso que ese modo pida
Según la documentación de Claude Code.
Ilustración: a la entrada de un pasillo, un guardia con el destello de Claude en la placa examina con una lupa una hoja de instrucciones; tras la pared, fuera de su vista, unas flechas llegan a puertas que solo se iluminan al alcanzarlas.
📷 Imagen generada con IA

Según la documentación, desde la v2.1.283 el modo automático es el de arranque en las sesiones interactivas de terminal y de VS Code. Como Code Mode exige la v2.1.323, si no has cambiado ese modo es probable que ya trabajes en él. La barra de estado lo indica con `auto mode on`, y `Shift+Tab` cambia de modo.

Cada llamada del código pasa igualmente por tus reglas `deny` y `ask` y por tus hooks `PreToolUse`, con el nombre habitual de la herramienta, como `Bash`. Lo que cambia es el clasificador: revisa cada trozo de código antes de que corra, no cada llamada, y no ve los valores calculados al ejecutarlo, como una ruta sacada de una búsqueda.

En el ejemplo de los reintentos, el clasificador puede aprobar un guion que edita el primer archivo que encuentre la búsqueda, pero cuál es solo se sabe al ejecutarlo. Por eso la documentación recomienda mantener reglas o hooks para las llamadas que haya que controlar. En los demás modos, el código arranca sin revisión y se pregunta por cada llamada que ese modo preguntaría.

Cómo cerrar los huecos

Según la documentación, en Code Mode un `git push` en una carpeta `app` puede llegar al hook como `cd 'app' && git push`, así que un hook que filtre comandos debe comprobar cada parte. Para revisar el propio código, un hook `PreToolUse` que case con `REPL`, la herramienta que lo ejecuta, puede leer el JavaScript en `tool_input.code`.

Con o sin Code Mode, las reglas de `Bash` casan con el texto del comando, y Claude puede ejecutar un comando prohibido de una forma que la regla no reconozca. Para límites que no dependan del texto, la documentación remite al aislamiento (sandboxing).

Si en modo automático Claude lanza código nuevo mientras otro sigue corriendo, el primero pierde la revisión del clasificador y Claude Code pregunta por sus llamadas pendientes con una cuenta atrás: `Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session`. Sin respuesta, la llamada se rechaza. La v2.1.327, del 17 de noviembre, corrigió un caso concreto: el guion en marcha recibía avisos y rechazos aunque el modo automático también permitiera el segundo; en los demás casos se mantiene la cuenta atrás.

Cómo apagarlo

Quita la variable del shell y de `~/.claude/settings.json` y abre una sesión nueva, o déjala a `0`: según la documentación, con un `0` en un sitio sigue apagado aunque haya un `1` en el otro. Una empresa puede bloquearlo para toda la organización con un `0` en los ajustes gestionados (managed settings), pero no encenderlo desde ahí.

Para seguir afinando Claude Code, en esta serie hay guías para montar tres subagentes que no te dan la razón y una skill que pone orden en tus skills.

Leer más: Claude Code: tres subagentes que no te dan la razón, en otra lección ↗

Conclusión

Code Mode cambia el ritmo de Claude Code: en vez de ir llamada a llamada, Claude escribe un guion que las encadena, las lanza en paralelo cuando puede y se queda con lo que necesita leer. Se prueba con una variable de entorno y una tarea de muchos archivos, y `Ctrl+O` enseña qué ha escrito. Lo que no cambia es la necesidad de vigilar: en modo automático, el clasificador revisa el guion entero, no cada llamada, así que las llamadas que importan deben seguir protegidas con reglas, hooks o aislamiento.

Fuentes primarias

Comentarios

Sé respetuoso. Los comentarios se moderan.

    La continuación natural

    Aprende IA a tu ritmo con nuestros cursos gratuitos.

    En nuestra plataforma de aprendizaje TAKU podrás acceder a este y muchos otros cursos de manera totalmente gratuita.

    APRENDER CON TAKU

    ← Volver al blog