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.
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
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
| 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) |
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
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
| 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, 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
- Claude Code Docs (Anthropic) — Run tool calls from code with Code Mode (consultada el 18-11-2026) ↗
- GitHub (anthropics/claude-code) — Release v2.1.323 (12-11-2026) ↗
- GitHub (anthropics/claude-code) — CHANGELOG.md (consultado el 18-11-2026) ↗
- Claude Code Docs (Anthropic) — Permission modes (consultada el 18-11-2026) ↗
- Claude Code Docs (Anthropic) — Tools reference (consultada el 18-11-2026) ↗
- AI Informator — Claude Code: tres subagentes que no te dan la razón (29-10-2026) ↗
- AI Informator — Una skill que pone orden en tus skills (12-11-2026) ↗
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
Comentarios