Claude Code · modo experimental · noviembre 2026
Code Mode en Claude Code
Que Claude haga todos los mandados de un jalón y solo te traiga lo que sirve. Menos lectura de relleno, más plan para lo importante.
En corto
Claude deja de ir y venir por cada cosa. Hace la lista, va una vez y regresa solo con lo que usa.
Code Mode es un modo nuevo de Claude Code, todavía en prueba. En vez de pedir una herramienta, leer todo el resultado y luego pedir la siguiente, Claude escribe un programita que hace todas las vueltas juntas y le devuelve solo la parte que necesita. Se prende con una línea en la terminal, y en un minuto sabes si te sirve.
Ficha
Code Mode en Claude Code
- Qué necesitas
- Claude Code 2.1.323 o más nuevo, en la terminal, con tu plan de Claude o una cuenta de Console
- Dónde se hace
- Solo en la terminal. La app de escritorio y VS Code todavía no lo traen
- Cuánto cuesta
- Nada extra: usa tu mismo plan, y la idea es que te rinda más
- Cuánto toma
- Un minuto para prenderlo
- Estado
- Experimental y apagado de fábrica. Puede cambiar o desaparecer
01 · Qué es
Code Mode, explicado como a un niño de 5 años
Imagina que mandas a alguien a la tienda por cinco cosas. El mandadero de siempre va por la leche, regresa y te lee el ticket completo, renglón por renglón. Va por el pan, regresa y otra vez te lee el ticket entero. Así con las cinco. Al final tienes lo que pediste, pero escuchaste un montón de cosas que no te servían.
Así trabaja Claude Code hoy. Pide una herramienta (buscar, abrir un archivo, correr un comando), lee el resultado completo y hasta entonces decide el siguiente paso. Todo lo que lee se queda en la conversación, y eso es lo que se come tu plan.
Sin Code Mode
Una vuelta por cada cosa
- 1Busca dónde está la función y lee todos los resultados.
- 2Abre el archivo y lo lee completo.
- 3Hace el cambio.
- 4Corre las pruebas y lee toda la salida, aunque solo importe una línea.
Con Code Mode
Primero la lista, luego una sola vuelta
- 1Claude escribe un programita con todo lo que hay que hacer.
- 2El programita busca, abre, cambia y corre las pruebas de un jalón.
- 3A Claude solo le regresa qué archivo cambió y si pasaron las pruebas.
Dicho un poquito más técnico: Claude escribe un pedazo de JavaScript que llama a sus herramientas de siempre. Ese código puede correr varias cosas al mismo tiempo, usar lo que salió de una en la siguiente y, al final, devolver solo la parte que Claude necesita leer. Claude Code lo corre dentro de tu sesión.
Tú no tienes que saber JavaScript. Lo escribe Claude, y tú le hablas igual que siempre, en español y con tus palabras.
Lo que ves en pantalla
En la conversación sigues viendo lo que Claude hace, por ejemplo el cambio en cada archivo, pero no el código del programita. Si te da curiosidad, presiona Ctrl+O: se abre el historial y ahí la fila Code se despliega con el programita completo. Ctrl+O otra vez y regresas.
02 · ¿Te sirve?
Revisa esto antes de prenderlo
Te sirve si…
- Usas Claude Code en la terminal, la ventana donde escribes claude para empezar.
- Tienes la versión 2.1.323 o más nueva. Si usas equipos de agentes (agent teams), la 2.1.326.
- Entras con tu plan de Claude (Pro, Max, Team o Enterprise) o con una cuenta de Console.
- Trabajas con Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2.
- Instalaste la versión nativa de Claude Code. En Windows, además, necesitas Git for Windows.
Todavía no funciona en…
- La app de escritorio de Claude ni el panel de VS Code.
- El modo sin pantalla (claude -p), el Agent SDK ni las sesiones en la nube.
- Cuentas que entran por Amazon Bedrock, Google Cloud, Microsoft Foundry o un gateway de tu empresa.
- Organizaciones con configuración HIPAA o con cero retención de datos.
- Sesiones con Remote Control, Claude in Chrome o computer use.
Si tú usas la app de escritorio
No te quedas fuera del todo. Abre la terminal, entra a la misma carpeta de tu proyecto y escribe claude: tu CLAUDE.md y tus skills del proyecto son los mismos. Para tareas grandes usa la terminal con Code Mode, y para lo demás sigue en la app.
03 · Prenderlo
Prenderlo en tres pasos
Paso 1 · Revisa tu versión
Abre tu terminal y fíjate qué versión tienes. Si es menor que 2.1.323, actualiza.
Ver tu versión
claude --versionActualizar Claude Code
claude updatePaso 2 · Arranca Claude con el modo prendido
Entra a la carpeta de tu proyecto y copia la línea de tu sistema.
Mac, Linux o WSL
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claudeWindows (PowerShell)
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"; claudePaso 3 · Dile que sí
La primera vez Claude Code te pregunta si lo quieres activar. Elige Yes, turn on Code Mode. Se reinicia solo y, cerca de arriba, aparece esta línea:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
Si ves eso, ya está. La segunda mitad importa: esta sesión solo se puede retomar (con claude --continue o claude --resume) mientras el modo siga prendido. Y al revés, una sesión que empezaste sin Code Mode se retoma sin él.
Dejarlo prendido siempre
La línea del paso 2 vale solo para esa vez. Para no escribirla cada día, guárdalo en tu configuración personal. No tienes que abrir el archivo tú: pídeselo a Claude.
Déjalo prendido siempre
Pégalo en Claude Code. Te enseña el archivo antes de guardarlo.
Agrega a mi archivo ~/.claude/settings.json, dentro de "env", la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE con el valor "1". No borres nada de lo que ya tenga el archivo: si "env" ya existe, solo suma esta línea. Enséñame cómo queda antes de guardarlo.
Tiene que ser tu archivo, no el del proyecto
Claude Code ignora esta variable en los settings de un proyecto, y lo hace a propósito: así un repositorio que clonas de internet no te puede prender el modo sin que tú lo decidas. Va en ~/.claude/settings.json, el tuyo.
Apagarlo
Borra la variable de la terminal y de ~/.claude/settings.json, o cámbiale el 1 por un 0, y abre una sesión nueva. Un 0 en cualquiera de los dos lados gana: aunque en el otro diga 1, el modo queda apagado.
04 · Dónde se nota
Dónde sí vas a ver la diferencia, y dónde no
Code Mode luce cuando la tarea tiene muchas vueltas. Si solo hay una, no hay nada que juntar. La documentación da tres casos:
- Un mismo cambio que se repite en muchos archivos.
- Una búsqueda con muchos resultados que hay que filtrar antes de leerlos.
- Varios comandos que no dependen uno del otro y pueden correr al mismo tiempo.
Pruébalo con uno de estos. Cámbiales los nombres por los de tu proyecto.
Un cambio en todo el proyecto
El caso más claro: el mismo cambio en muchos archivos.
Cambia el nombre de la función calcularTotal por calcularTotalConImpuestos en todo el proyecto, incluidas las importaciones. Cuando termines, dime solo qué archivos tocaste y si las pruebas siguen pasando.
Busca y filtra
Muchos resultados, pocos que importan.
Busca en todo el proyecto los comentarios TODO y FIXME. Agrúpalos por archivo y enséñame solo los 10 más importantes, con una línea de por qué cada uno.
Solo los errores que importan
Para que no te pegue cientos de líneas de salida.
Corre el linter y las pruebas. No me pegues la salida completa: dame solo los errores reales, del más grave al menos grave, con archivo y línea.
Varias cosas al mismo tiempo
Tareas independientes que pueden correr juntas.
Al mismo tiempo: revisa qué dependencias están desactualizadas, cuenta cuántas líneas tiene cada carpeta de src y encuentra los archivos de más de 300 líneas. Dame un resumen de cinco renglones.
El truco: termina con “dame solo…”
El programita le devuelve a Claude lo que necesita leer. Si tú le dices qué necesitas (los 10 más importantes, solo los errores, cinco renglones), tiene un criterio claro para filtrar y regresa menos papel.
Dónde no vas a notar nada
Una pregunta sencilla, como qué hace este archivo, o un cambio de una sola línea. Con una vuelta no hay mandados que juntar, así que gasta casi lo mismo.
05 · Lo honesto
Lo que nadie te dice de Code Mode
Lo que vas a oír
Gasta 40% menos
Lo que hay de verdad
Anthropic no da ningún número en su documentación. El 40% sale de personas que lo midieron en sus propios proyectos, y cambia mucho según la tarea: en refactors grandes reportan más, en tareas cortas menos. Tómalo como pista, no como promesa.
Lo que vas a oír
Va más rápido
Lo que hay de verdad
No siempre. Escribir y correr el programita toma su tiempo, y en algunas pruebas de usuarios tardó más que el modo normal. Ahorra plan; minutos, a veces sí y a veces no.
Lo que vas a oír
Ya es una función normal
Lo que hay de verdad
Es experimental y viene apagado. Puede cambiar o desaparecer en cualquier versión. Si algo se porta raro, cuéntaselo a Anthropic con /feedback.
Lo que vas a oír
Se salta mis permisos
Lo que hay de verdad
No. Cada herramienta que usa el programita pasa por tus reglas de permisos y tus hooks, con su nombre de siempre, por ejemplo Bash. En modo auto hay un detalle: el revisor automático lee el código antes de correrlo, no cada llamada, y no ve valores que salen a mitad del camino. Lo que de verdad tengas que controlar, déjalo en una regla o un hook.
Lo que vas a oír
Lo dejo trabajando horas
Lo que hay de verdad
Si te quedas esperando al programita, se corta a los 10 minutos, contando el tiempo en que te pide permiso. En segundo plano puede durar hasta dos horas, pero eso pide modo auto.
Lo que vas a oír
Sigo la sesión donde quiera
Lo que hay de verdad
Una sesión de Code Mode solo se retoma en la terminal y con el modo prendido. No se puede pasar a la app de escritorio ni volverla una sesión de fondo.
| Lo que vas a oír | Lo que hay de verdad |
|---|---|
| Gasta 40% menos | Anthropic no da ningún número en su documentación. El 40% sale de personas que lo midieron en sus propios proyectos, y cambia mucho según la tarea: en refactors grandes reportan más, en tareas cortas menos. Tómalo como pista, no como promesa. |
| Va más rápido | No siempre. Escribir y correr el programita toma su tiempo, y en algunas pruebas de usuarios tardó más que el modo normal. Ahorra plan; minutos, a veces sí y a veces no. |
| Ya es una función normal | Es experimental y viene apagado. Puede cambiar o desaparecer en cualquier versión. Si algo se porta raro, cuéntaselo a Anthropic con /feedback. |
| Se salta mis permisos | No. Cada herramienta que usa el programita pasa por tus reglas de permisos y tus hooks, con su nombre de siempre, por ejemplo Bash. En modo auto hay un detalle: el revisor automático lee el código antes de correrlo, no cada llamada, y no ve valores que salen a mitad del camino. Lo que de verdad tengas que controlar, déjalo en una regla o un hook. |
| Lo dejo trabajando horas | Si te quedas esperando al programita, se corta a los 10 minutos, contando el tiempo en que te pide permiso. En segundo plano puede durar hasta dos horas, pero eso pide modo auto. |
| Sigo la sesión donde quiera | Una sesión de Code Mode solo se retoma en la terminal y con el modo prendido. No se puede pasar a la app de escritorio ni volverla una sesión de fondo. |
06 · Si no arranca
Si en vez de “is on” te sale otra cosa
Cuando no puede prenderse, Claude Code pone Code Mode (experimental) isn't available y, en la misma línea, la razón. También la ves escribiendo /status. Busca la tuya:
Si la razón dice…
it isn't open to your account
Qué hacer
Si tienes menos de la 2.1.323, actualiza con claude update. Si ya la tienes, revisa tu internet y vuelve a intentar más tarde.
Si la razón dice…
it only works with the Anthropic API
Qué hacer
Quita la configuración de Bedrock, Google Cloud, Foundry, un gateway o un ANTHROPIC_BASE_URL propio. Si usas un proxy para ahorrar tokens, como Headroom u OmniRoute, abre esta sesión sin él.
Si la razón dice…
it doesn't work with an API key helper
Qué hacer
Quita apiKeyHelper o ANTHROPIC_AUTH_TOKEN de tu configuración y entra con tu cuenta.
Si la razón dice…
it only works with Opus 5.5, Sonnet 5.5 and later models
Qué hacer
Cambia de modelo, por ejemplo arrancando con claude --model opus. Haiku 5.5 y Fable 5.2 también sirven.
Si la razón dice…
it needs settings that Claude Code downloads / OpenTelemetry is on
Qué hacer
Quita de tu entorno DISABLE_TELEMETRY, CLAUDE_CODE_ENABLE_TELEMETRY o ENABLE_BETA_TRACING_DETAILED.
Si la razón dice…
it doesn't yet work with the plugin
Qué hacer
Escribe /plugin y desactiva el plugin que te nombra.
Si la razón dice…
it can't be used together with agent teams yet
Qué hacer
Actualiza a la 2.1.326 o más nueva.
Si la razón dice…
your organization's settings don't allow it
Qué hacer
Tu empresa lo apagó. Pregúntale a quien administra Claude en tu organización.
| Si la razón dice… | Qué hacer |
|---|---|
| it isn't open to your account | Si tienes menos de la 2.1.323, actualiza con claude update. Si ya la tienes, revisa tu internet y vuelve a intentar más tarde. |
| it only works with the Anthropic API | Quita la configuración de Bedrock, Google Cloud, Foundry, un gateway o un ANTHROPIC_BASE_URL propio. Si usas un proxy para ahorrar tokens, como Headroom u OmniRoute, abre esta sesión sin él. |
| it doesn't work with an API key helper | Quita apiKeyHelper o ANTHROPIC_AUTH_TOKEN de tu configuración y entra con tu cuenta. |
| it only works with Opus 5.5, Sonnet 5.5 and later models | Cambia de modelo, por ejemplo arrancando con claude --model opus. Haiku 5.5 y Fable 5.2 también sirven. |
| it needs settings that Claude Code downloads / OpenTelemetry is on | Quita de tu entorno DISABLE_TELEMETRY, CLAUDE_CODE_ENABLE_TELEMETRY o ENABLE_BETA_TRACING_DETAILED. |
| it doesn't yet work with the plugin | Escribe /plugin y desactiva el plugin que te nombra. |
| it can't be used together with agent teams yet | Actualiza a la 2.1.326 o más nueva. |
| your organization's settings don't allow it | Tu empresa lo apagó. Pregúntale a quien administra Claude en tu organización. |
Y si no aparece ninguna línea, ni la buena ni la mala: revisa la versión, que la variable diga 1 y que no haya un 0 escondido en tu terminal, en ~/.claude/settings.json o en un archivo que pases con --settings.
Que Claude lo diagnostique
Pégalo en una sesión normal. Solo revisa, no cambia nada.
Code Mode no me arranca. Revisa mi versión de Claude Code, si la variable CLAUDE_CODE_EXPERIMENTAL_CODE_MODE está en 1 en mi terminal y en ~/.claude/settings.json, si hay un 0 en algún lado, y si tengo configurado algún proxy, ANTHROPIC_BASE_URL, apiKeyHelper o telemetría que lo bloquee. Dime qué encontraste y qué cambiarías, sin cambiar nada todavía.
07 · Más ahorro
Súmale lo que ya tienes en la bóveda
Code Mode tapa una fuga: lo que Claude lee de más mientras hace vueltas. Hay otras, y para cada una ya hay una guía en la bóveda. Se pueden juntar.
Para ir más lejos
Piensa en el mandadero
Cada vez que le pidas algo grande a Claude, acuérdate de los tickets. Mientras menos papel traiga de regreso, más plan te queda para lo que sí importa, y con Code Mode prendido y un “dame solo…” al final del prompt, el papel se queda en la tienda.
Guía de la bóveda
Esta guía es una de las gratuitas de la bóveda.
Lo nuevo sale primero en Instagram
Ahí publico lo que voy probando antes de que se vuelva guía.
@soyenriquerocha
Guía gratis
Únete a la comunidad
Crea tu cuenta gratis con tu correo y la guía se abre aquí mismo. Te sirve para todas las guías. Si el código no te llega, revisa spam o Promociones.