El 13 de noviembre de 2026, Anthropic lanzó Claude Code v2.1.323 con una adición significativa: Code Mode, una función experimental que cambia la forma en que Claude llama a sus herramientas. Según la documentación oficial de Anthropic, en lugar de una llamada a herramienta → un resultado → siguiente decisión, Claude ahora escribe un pequeño script de JavaScript, lo ejecuta y lee solo lo que necesita. El resultado son menos viajes de ida y vuelta entre Claude y tus herramientas, y la posibilidad de ejecutar comandos independientes en paralelo.
Este artículo explica qué hace Code Mode exactamente, cómo habilitarlo, cuándo tiene sentido usarlo y, igual de importante, qué se rompe o se bloquea. Todo lo que aquí aparece proviene de los docs de Anthropic y del changelog de v2.1.323. No lo he evaluado personalmente y voy a indicar cuándo los docs ofrecen orientación cualitativa en lugar de números concretos.
Cómo Claude Code normalmente llama a herramientas
Sin Code Mode, cada llamada a herramienta es un viaje de ida y vuelta independiente. Claude pide ejecutar un comando Bash, lee el resultado, luego pide leer un archivo, lee eso, luego pide una edición. Cada paso espera al anterior. Para una tarea que abarca veinte archivos o que requiere filtrar un resultado de búsqueda antes de hacer la edición, ese ciclo modelo-herramienta-modelo se acumula rápidamente.
Code Mode cambia esto dándole a Claude un entorno de ejecución de JavaScript dentro de tu sesión. Claude escribe un script que llama a herramientas —Bash, Read, Edit— directamente desde código, encadenándolas y paralelizándolas según sea necesario. El script se ejecuta, devuelve solo lo que Claude necesita leer y la conversación avanza. Según los docs, la conversación sigue mostrando cada llamada a herramienta (ves el diff de una edición, por ejemplo), pero no el JavaScript detrás. Presiona Ctrl+O para abrir el visor de transcripciones y leer el código real que escribió Claude.
Este es el ejemplo que Anthropic muestra en los docs para ilustrar la diferencia. Este único script encuentra el archivo objetivo, lo edita y ejecuta las pruebas de una sola vez:
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() });
Nótese que la última línea ejecuta las pruebas de forma concurrente sin que nada las bloquee. Sin Code Mode, esa misma tarea requeriría al menos tres viajes de ida y vuelta separados.
Requisitos — lee esto antes de intentar habilitarlo
Code Mode tiene un conjunto específico de requisitos, y varias configuraciones comunes lo bloquean. Según los docs de Anthropic, esto es lo que necesitas:
- Versión: Claude Code v2.1.323 o posterior. Ejecuta
claude --versionpara verificar; ejecutaclaude updatesi estás desactualizado. Si estás en el canalstable, cambia alatestsi stable aún no llegó a esa versión. - Cuenta: Una suscripción a Claude o una cuenta de Anthropic Console. Code Mode no funciona a través de Amazon Bedrock, el Agent Platform de Google Cloud, Microsoft Foundry, gateways de terceros ni un
ANTHROPIC_BASE_URLpersonalizado. - Modelo: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2. Si usas un modelo más antiguo, verás un error al intentar iniciar.
- Superficie: Una sesión interactiva en la terminal con la compilación nativa de Claude Code. No funciona con
-p, el Agent SDK, el panel de VS Code, la aplicación de escritorio ni sesiones en la nube. - Equipos de agentes: Si tienes equipos de agentes habilitados, necesitas v2.1.326 o posterior (lanzada el 17 de noviembre de 2026).
- Política de organización: La configuración HIPAA y la retención cero de datos no son compatibles.
Varios ajustes también bloquean silenciosamente Code Mode al inicio. Si tienes establecidos CLAUDE_CODE_ENABLE_TELEMETRY, ENABLE_BETA_TRACING_DETAILED o DISABLE_TELEMETRY, Code Mode no arrancará. Lo mismo ocurre con un asistente de clave de API y cualquier configuración de exportación de OpenTelemetry. Si Code Mode no se inicializa, ejecuta /status en la sesión; te indicará el motivo exacto.
Cómo habilitar Code Mode
La variable de entorno CLAUDE_CODE_EXPERIMENTAL_CODE_MODE controla Code Mode. Establécela en 1 antes de iniciar tu sesión. Según los docs, los archivos de configuración del proyecto están explícitamente excluidos: un repositorio que clones no puede habilitar Code Mode por ti.
Pruébalo una vez desde la terminal (macOS, Linux, WSL):
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Pruébalo desde PowerShell en Windows:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude
Habilítalo para cada nueva sesión a través de ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Cuando Code Mode está disponible y la variable está establecida, Claude Code te pide confirmación antes de la primera sesión. Selecciona Yes, turn on Code Mode. Verás 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 un mensaje diferente o ninguno, ejecuta /status para ver el bloqueo específico. Los más comunes están enumerados en la sección de requisitos anterior.
Un detalle importante que los docs señalan: una vez que inicias una sesión en Code Mode, solo puedes reanudarla con Code Mode todavía activado. claude --continue y claude --resume se negarán a abrir una sesión de Code Mode si la variable no está establecida en 1. Ten eso en cuenta antes de usarlo en una tarea larga a la que pienses volver.
Las tareas donde Code Mode realmente ayuda
Los docs oficiales presentan tres escenarios donde Code Mode marca una diferencia significativa. Estos coinciden con lo que los desarrolladores en la comunidad están reportando:
Ediciones repetitivas en muchos archivos. Si necesitas renombrar una constante en 40 archivos, actualizar un patrón de import obsoleto en todo un proyecto o agregar una declaración using a cada archivo C# de un servicio, Code Mode puede agrupar eso en un único script en lugar de 40 viajes de edición separados.
Búsquedas cuyos resultados necesitan filtrarse antes de que Claude los lea. En un codebase grande, ejecutar rg para encontrar coincidencias y luego leer cada coincidencia es ineficiente. Un script de Code Mode puede buscar, filtrar los resultados y devolver solo las líneas relevantes. Este tipo de tarea también funciona bien con los servidores MCP (en inglés) que ya puedas tener configurados: Code Mode puede componerse con ellos.
Comandos independientes que pueden ejecutarse en paralelo. Ejecutar pruebas, linting y generar un informe de cobertura son tareas independientes. Sin Code Mode, Claude las lanza de forma secuencial. Con Code Mode, un único script inicia las tres y espera por todas juntas. Los docs no publican números de benchmark para esto, pero el beneficio estructural es real.
Los docs también indican cuándo omitirlo: una edición pequeña de un solo archivo, o una tarea donde trabajas principalmente en VS Code o la aplicación de escritorio. Code Mode es una función exclusiva de terminal, y agregar un paso de generación de código a una tarea de un solo paso no aporta nada.
Los permisos y el modo automático se comportan de forma diferente
Esta es la sección más importante para entender antes de confiar en Code Mode en un workflow de producción. Según los docs de Anthropic, el modelo de seguridad cambia en un aspecto clave:
En modo automático, el clasificador revisa cada fragmento de código JavaScript antes de ejecutarlo, no cada llamada a herramienta individual dentro del mismo. No puede ver los valores calculados en tiempo de ejecución, como una ruta de archivo que proviene de un resultado de búsqueda. Eso significa que si tienes una regla de allow o deny basada en un valor de ruta, el clasificador no sabrá la ruta real hasta que el script ya se haya ejecutado. Los docs recomiendan mantener hooks PreToolUse (en inglés) explícitos para cualquier llamada a herramienta que necesites controlar estrictamente.
En otros modos de permisos, se te pide confirmación para cada llamada a herramienta que normalmente te la pediría. El script se ejecuta sin revisión previa y los prompts aparecen a medida que las llamadas se ejecutan.
Para equipos que gestionan Code Mode a nivel organizacional, el archivo de managed settings es el plano de control. Establecer la variable en "0" en managed settings lo bloquea para todos:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
}
}
Las personas que ya están en una sesión permanecen en Code Mode hasta que salgan o reinicien. Después de eso, no pueden reanudar sus sesiones de Code Mode mientras el 0 esté establecido. Los managed settings pueden bloquearlo, pero según los docs, no pueden habilitarlo para los usuarios: eso siempre requiere el opt-in explícito del propio usuario.
Si quieres inspeccionar el JavaScript que Claude escribió como hook, escribe un hook PreToolUse que coincida con REPL (el nombre de herramienta que usa Code Mode) y lee el JavaScript de tool_input.code. La configuración de settings.json y CLAUDE.md (en inglés) que ya tienes configurada sigue aplicándose: Code Mode no la omite.
Límites de tiempo y código de larga duración
Code Mode tiene un límite de 10 minutos en tiempo real para código en primer plano. Ese temporizador incluye el tiempo que pases esperando en prompts de permisos. Si estás ejecutando una suite de pruebas lenta o un build largo, ese límite importa.
La ejecución en segundo plano eleva el límite a dos horas, pero solo se activa si inicias la sesión en modo automático o en modo bypassPermissions. Cuando Claude está en modo segundo plano, puedes seguir enviando mensajes; cuando está en primer plano (esperando), no puedes enviar mensajes hasta que el script termine o se agote el tiempo.
Si cambias el modo de permisos a mitad de sesión mientras Claude espera código en ejecución, vuelve al modo con el que iniciaste presionando Shift+Tab. Los docs señalan que si iniciaste en un modo diferente (o elegiste la sesión de una lista de claude --resume), puedes salir y reiniciar con claude --continue --permission-mode auto mientras la variable de Code Mode sigue establecida.
Cosas que vale la pena conocer antes de adoptarlo por completo
OpenTelemetry lo bloquea por completo. Si tu equipo usa la exportación de OpenTelemetry de Claude Code para observabilidad, no puedes usar Code Mode al mismo tiempo. La variable DISABLE_TELEMETRY también lo bloquea. Esto importa para equipos que han configurado monitoreo centralizado de Claude Code.
Las reglas de Bash allow pueden ser eludidas. Los docs lo señalan explícitamente: las reglas de allow y deny de Bash coinciden con el texto del comando, por lo que un comando puede escribirse de una forma que la regla no detecte. Según los docs: "en Code Mode, un git push en una carpeta llamada app puede llegar a tu hook como cd 'app' && git push." Si necesitas reglas que no puedan eludirse mediante variaciones de texto, usa sandboxing, no reglas basadas en texto.
Las sesiones iniciadas sin Code Mode no se pueden reanudar con él. Lo contrario también es verdad: las sesiones de Code Mode solo pueden reanudarse con la variable establecida. Si trabajas en varias máquinas y a veces no tienes la variable configurada, tendrás que iniciar una sesión nueva en esas máquinas.
Es experimental. Anthropic dice explícitamente que Code Mode puede cambiar o eliminarse en cualquier versión. Yo lo trataría como una herramienta de productividad, no como algo sobre lo que construir un pipeline de CI por ahora.
Lecturas adicionales si quieres profundizar en las llamadas a herramientas de IA
Code Mode es esencialmente la implementación de Claude del uso programático de herramientas, y vale la pena entender por qué funciona de esta manera. Dos libros a los que vuelvo constantemente sobre este tema:
AI Engineering de Chip Huyen cubre la arquitectura de sistemas basados en LLMs, incluyendo patrones de uso de herramientas, gestión de contexto y cómo los agentes componen llamadas. Es una buena base si quieres entender por qué agrupar llamadas a herramientas reduce el uso de tokens.
Ver precio de AI Engineering by Chip Huyen en Amazon →
Hands-On Large Language Models profundiza en cómo los modelos procesan y generan llamadas a herramientas, lo que ayuda cuando estás depurando problemas de permisos o tratando de entender qué está revisando realmente el clasificador en modo automático.
Ver precio de Hands-On Large Language Models en Amazon →
¿Deberías habilitarlo?
Si haces mucha refactorización en múltiples archivos, trabajas en un codebase grande donde las búsquedas necesitan filtrado, o ejecutas comandos independientes que podrían correr en paralelo, Code Mode vale la pena probarlo hoy. La configuración es una sola variable de entorno, la confirmación tarda diez segundos y puedes desactivarlo igual de rápido.
Si tu workflow es principalmente en el panel de VS Code, la aplicación de escritorio o sesiones en la nube, o si tienes habilitada la exportación de OpenTelemetry, la función no arrancará, así que no hay nada que decidir por ahora. Los flujos de automatización con la API de Claude (en inglés) que construyo con n8n no usan la terminal interactiva en absoluto, así que Code Mode es ortogonal a esa parte de mi trabajo.
Ten en cuenta que es experimental. Anthropic se reserva el derecho de modificarlo o eliminarlo en cualquier versión. Para workflows críticos de producción, esa advertencia es real. Para el trabajo diario de desarrollo, es el tipo de cosa que vale la pena tener activada y olvidarse, hasta que de repente hace que una tarea de refactorización complicada tome la mitad de turnos.
¿Quieres Claude bien configurado para tu flujo de trabajo?
Reserva una llamada 1 a 1 para configurar Claude: 60 minutos, en vivo, en inglés o en español, grabada para ti. $127. Reserva la llamada →
O empieza con el Claude Prompt Pack: 50 prompts bilingües, $17, descarga inmediata.