Code Mode es un modo experimental de Claude Code, llegado con la versión 2.1.323 (12 de noviembre de 2026), en el que Claude escribe un pequeño programa en JavaScript que hace varias llamadas a herramientas de una sola vez, en lugar de pedirlas una por una. Está apagado por defecto, solo funciona en la terminal y con ciertos modelos y cuentas. Aquí tienes qué cambia, qué necesitas, cómo probarlo y qué límites debes conocer.
Qué cambia con Code Mode
Normalmente Claude Code pide una herramienta (Bash, Read, Edit…), lee el resultado y decide el siguiente paso. Con Code Mode, Claude redacta un fragmento de JavaScript que encadena esas llamadas: puede ejecutar comandos en paralelo, usar el resultado de una llamada en la siguiente y devolver a Claude solo la parte de la salida que necesita leer.
La documentación oficial pone este ejemplo para una petición como «sube el límite de reintentos»: el código busca el archivo, lo edita y lanza las pruebas, y la última línea devuelve la ruta editada 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 sigues viendo las llamadas a herramientas (por ejemplo, el diff de la edición), pero no el código. Para leerlo, pulsa Ctrl+O y abre el visor de transcripción: cada fragmento aparece como una fila «Code» plegada.
Cuándo tiene sentido usarlo
La propia documentación lo recomienda para tareas con muchas llamadas relacionadas entre sí:
- Un cambio que se repite en muchos archivos.
- Una búsqueda cuyos resultados conviene filtrar antes de que Claude los lea.
- Varios comandos independientes que pueden correr a la vez.
Para tareas pequeñas (editar un archivo, explicar una función) no aporta nada: el modo normal sigue siendo más simple de seguir y de revisar.
Requisitos
| Requisito | Qué pide la documentación |
|---|---|
| Versión | Claude Code 2.1.323 o posterior, en cualquier canal |
| Cuenta | Suscripción de Claude o cuenta de Console; no sirve con gateway, Bedrock, Claude Platform on AWS, Google Cloud ni Foundry |
| Organización | Sin configuración HIPAA ni retención cero de datos |
| Modelo | Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2 |
| Superficie | Sesión interactiva de claude en terminal; no funciona con -p, Agent SDK, panel de VS Code, app de escritorio ni sesiones en la nube |
| Instalación | Versión nativa de Claude Code; en Windows, Git for Windows |
Tampoco arranca con algunos ajustes activos, como un ayudante de clave de API, los equipos de agentes, la exportación de OpenTelemetry o DISABLE_TELEMETRY.
Paso a paso para probarlo
1. Comprueba la versión
claude --version
claude updateSi estás en el canal estable y la actualización no llega a la 2.1.323, la documentación indica esperar a que estable se ponga al día o cambiar al canal latest.
2. Arranca con la variable activada
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claudePara activarlo en todas las sesiones nuevas, define la misma variable en tus ajustes de usuario (~/.claude/settings.json). En la primera sesión te pide confirmar: elige «Yes, turn on Code Mode». Claude Code se reinicia y muestra una línea indicando que Code Mode está activo y que esa sesión solo se podrá reanudar con él activado.
3. Dale una tarea con muchas llamadas
Read every Markdown file in this project and list the links that point to local files that don't exist.Es el prompt de ejemplo de la documentación (puedes escribirlo en español sin problema). Es un buen caso: hay que leer muchos archivos y filtrar antes de responder.
4. Lee el código que escribió Claude
Pulsa Ctrl+O, expande una fila «Code» y vuelve con Ctrl+O. Revisar ese JavaScript es la mejor forma de entender qué hizo realmente.
Cómo apagarlo
Quita la variable de tu shell y de settings.json, o déjala con valor 0; un 0 en cualquiera de los dos sitios lo mantiene apagado aunque el otro tenga un 1. Una organización puede bloquearlo poniendo CLAUDE_CODE_EXPERIMENTAL_CODE_MODE con valor 0 en sus ajustes gestionados.
Permisos y seguridad: lo que debes entender
Cada llamada a herramienta que hace el código pasa por tus reglas deny y ask y por tus hooks PreToolUse, así que no tienes que reescribir reglas para Bash. Lo que cambia es la revisión previa:
- Modo auto: el clasificador revisa cada fragmento de código antes de ejecutarlo, no cada llamada. No ve valores calculados en tiempo de ejecución (por ejemplo, una ruta sacada de una búsqueda), así que conserva reglas o hooks para lo que necesites controlar sí o sí.
- Otros modos: el código arranca sin revisión y se te pregunta por cada llamada que pediría permiso en ese modo.
Si quieres auditar el código en sí, la documentación sugiere un hook PreToolUse que coincida con la herramienta REPL y lea el JavaScript desde tool_input.code. Recuerda además que las reglas de Bash comparan texto de comandos, con o sin Code Mode; para límites que no dependan del texto, mira el sandbox.
Límites y costos
- Solo puedes reanudar una sesión de Code Mode en la terminal y con el modo activado.
- Si el código no puede correr en segundo plano, esperas a que termine y se detiene a los diez minutos; en segundo plano puede durar hasta dos horas (recomendado: empezar en modo auto o bypassPermissions).
- No están disponibles Remote Control, Claude in Chrome ni computer use, y no puedes mover la sesión al escritorio ni convertirla en sesión en segundo plano.
- La documentación no publica cifras de ahorro de tokens o tiempo, así que no las damos por hechas: mide tú mismo con tus tareas.
Además, es una función experimental: puede cambiar o desaparecer en cualquier versión. Si algo falla, /feedback es el canal que indica la documentación.
Qué significa para quien programa con IA
Code Mode acerca a Claude Code a lo que ya haces cuando automatizas: un script que combina búsqueda, filtrado y edición. Si estás aprendiendo, es una buena excusa para leer el JavaScript generado y entender cómo se encadenan las herramientas, algo parecido a lo que ves al construir un agente en Python sin frameworks. Y como el modo respeta tus reglas, vale la pena tener bien definido tu archivo de instrucciones: revisa el ejemplo comentado de CLAUDE.md. Si ya usas extensiones, también te puede interesar cómo probar plugins con claude plugin eval.
Preguntas frecuentes
¿Code Mode viene activado por defecto?
No. Es experimental y está apagado; se activa con la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1.
¿Puedo usarlo en VS Code o en la app de escritorio?
No por ahora. La documentación indica que solo funciona en una sesión interactiva de terminal, no con -p, el Agent SDK, el panel de VS Code, el escritorio ni las sesiones en la nube.
¿Es seguro dejar que Claude ejecute código?
Las llamadas siguen sujetas a tus reglas y hooks, pero en modo auto la revisión es sobre el código completo y no ve valores calculados al ejecutar. Para acciones críticas, mantén reglas deny o hooks y usa el sandbox.
Fuentes
- Documentación oficial: Run tool calls from code with Code Mode
- Changelog oficial de Claude Code (versión 2.1.323, 12 de noviembre de 2026)
- Resumen semanal oficial de Claude Code
Última revisión: 13 de noviembre de 2026. Este artículo se preparó con ayuda de IA a partir de la documentación oficial; los comandos y el código provienen de esa documentación y no se ejecutaron para esta nota. Consulta cómo usamos la IA.
