El 12 de noviembre, Claude Code 2.1.323 trajo Code Mode. Tres días después empezó a circular por canales de Telegram una publicación: «buscar enlaces rotos llevó 2 turnos en lugar de 13», «el consumo bajó de 150 mil a 2 mil tokens». Actualicé Claude Code y repetí la misma tarea seis veces: tres con Claude Code Code Mode y tres sin él, en la misma copia del repositorio y con el mismo modelo. Code Mode ahorra, pero no donde promete la publicación ni siempre.
Lo principal:
- El contexto inicial en Code Mode es un 29 % menor: 44,4 mil tokens frente a 62,7 mil. Se mantuvo en todas las ejecuciones.
- El número de turnos casi no cambió. Sin Code Mode, Sonnet 5.5 ya escribió un script y lo lanzó en una sola llamada a Bash.
- En la ejecución mediana, la entrada es un 28 % menor. En el promedio de las tres no hay diferencia: una ejecución en Code Mode falló tres veces con su propio script y se comió todo el ahorro.
- Según la tarifa de la API, la tarea costó en promedio $0,155 frente a $0,182. La precisión es idéntica: 22 enlaces rotos de 22 en las seis ejecuciones.
- La cifra «150 mil → 2 mil» viene de otro artículo de Anthropic, de 2025. Lo de «13 turnos contra 2» no aparece en la documentación.
Qué es Claude Code Code Mode#
Normalmente Claude pide las herramientas una por una: leer un archivo, ejecutar un comando, leer el resultado, decidir qué sigue. En Code Mode escribe un fragmento de JavaScript y Claude Code lo ejecuta en tu sesión. Dentro del código están disponibles las mismas herramientas de siempre: $ para comandos de shell, file() para leer, edit() para editar. Hacia fuera, el modelo ve solo dos herramientas, REPL y Poll.
Esto es lo que Claude escribió en una de mis ejecuciones. Acorté la expresión regular y la comprobación de bloques de código, pero la lógica es la misma:
const files = (await $`git ls-files '*.md'`.text()).trim().split('\n')
const missing = []
for (const f of files) {
const dir = f.includes('/') ? f.slice(0, f.lastIndexOf('/')) : '.'
for (const m of (await file(f).text()).matchAll(/\]\(([^)\s#]+)/g)) {
const link = m[1]
if (/^[a-z]+:/i.test(link)) continue
const path = link.startsWith('/') ? link.slice(1) : `${dir}/${link}`
const r = await $`test -e ${path}`.nothrow()
if (r.exitCode !== 0) missing.push(`${f} -> ${link}`)
}
}
;({ files: files.length, missing })El script devuelve al modelo solo la última línea. Leyó 58 archivos e hizo 46 llamadas a shell, y al contexto del modelo llegó únicamente la lista final. En la interfaz se ven las llamadas a las herramientas, y el código se abre en la transcripción con Ctrl+O.
La idea no es nueva. En noviembre de 2025 Anthropic describió el mismo recurso para servidores MCP, y en la API se llama programmatic tool calling. Code Mode lo lleva a la terminal.
Cómo activarlo: CLAUDE_CODE_EXPERIMENTAL_CODE_MODE#
Hace falta la versión 2.1.323 o posterior. Para comprobarla y actualizar:
claude --version
claude updateDespués, se inicia con la variable de entorno:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claudePara que el modo esté siempre activo, la variable se coloca en ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}En la configuración del proyecto esta variable se ignora, así que un repositorio ajeno no puede activarte Code Mode.
En el primer arranque Claude Code muestra una ventana con la descripción del modo, y el cursor queda en «No, start without it». Hay que elegir «Yes, turn on Code Mode», y Claude Code se reinicia. En la parte superior de la sesión aparece la línea Code Mode (experimental) is on · this session can be resumed only with Code Mode on. Es la que se ve en las capturas que circulan por los canales.
Requisitos de la documentación que la publicación omite:
- solo el
claudeinteractivo en la terminal: no funciona con-p, el Agent SDK, el panel de VS Code, la aplicación Desktop ni las sesiones en la nube; - modelos Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2;
- suscripción de Claude o cuenta de Console, sin Bedrock, Vertex, Foundry ni gateways;
- no arranca con
apiKeyHelper, agent teams, exportación de OpenTelemetry niDISABLE_TELEMETRY.
Cómo medí#
La tarea sale de la documentación de Code Mode, textual: «Read every Markdown file in this project and list the links that point to local files that don't exist». El banco de pruebas son 59 archivos Markdown del repositorio de este sitio, 545 KB de texto. La referencia la calculé antes con un script aparte: 23 enlaces rotos, 22 únicos.
Las condiciones son iguales en las seis ejecuciones: Claude Code 2.1.325, Sonnet 5.5, esfuerzo medium, modo auto y una copia limpia del banco en cada ejecución. La sesión interactiva la lancé con expect, porque Code Mode no funciona con -p. Las cifras salen del registro de la sesión, del campo message.usage.
Un detalle del registro. En Code Mode cada llamada a una herramienta desde dentro del script se escribe como una entrada aparte marcada con isVirtual. Si se cuentan como solicitudes al modelo, salen 106 «turnos» en vez de dos. La solicitud real al modelo lleva el campo requestId.
Resultados: el ahorro de tokens en cifras#
| Ejecución | Solicitudes al modelo | Contexto inicial | Entrada por tarea | Salida | ≈ $ por API | Encontrados |
|---|---|---|---|---|---|---|
| Code Mode 1 | 2 | 44 371 | 90 549 | 2 178 | 0,10 | 22/22 |
| Code Mode 2 | 2 | 44 368 | 91 732 | 2 353 | 0,16 | 22/22 |
| Code Mode 3 | 7 | 44 368 | 327 604 | 3 617 | 0,21 | 22/22 |
| Sin él 1 | 2 | 62 665 | 127 175 | 2 242 | 0,17 | 22/22 |
| Sin él 2 | 4 | 62 662 | 255 190 | 3 022 | 0,20 | 22/22 |
| Sin él 3 | 2 | 62 662 | 127 336 | 2 488 | 0,18 | 22/22 |
«Entrada por tarea» es la suma de todas las solicitudes: tokens nuevos, lectura de caché y escritura en caché. El dinero está calculado con la tarifa de Sonnet 5.5 al 15 de noviembre de 2026: entrada $2, escritura en caché de una hora $4, lectura de caché $0,10 y salida $10 por millón de tokens. Con suscripción no se cobra dinero, pero esos mismos tokens consumen los límites.
La primera ejecución en Code Mode es más barata que las demás, y no solo por el modo. Antes hubo un intento de arranque fallido y parte de la caché quedó caliente: se escribieron 18 mil tokens en caché en lugar de 32–35 mil. Sin esa suerte habría costado más o menos como la segunda.
De dónde viene el ahorro y de dónde no#
Menos contexto fijo. Es el efecto principal y el único estable. Sin Code Mode, el modelo recibe las descripciones completas de todas las herramientas. En Code Mode solo asoman REPL y Poll, y el resto se describe de forma más breve, como funciones de JavaScript. La diferencia son 18 mil tokens en cada solicitud. El mismo efecto lo obtuvo por su cuenta wmedia.es con Opus 5.5: primera solicitud de 22 mil tokens contra 36 mil, total de 94,7 mil contra 150,4 mil.
No hubo menos turnos. La publicación pinta un cuadro de «13 pasos, un archivo cada uno, contra 2». En dos de mis tres ejecuciones sin Code Mode, el modelo escribió por sí solo un script de Python y lo lanzó en una sola llamada a Bash: las mismas 2 solicitudes. Los modelos actuales ya juntan el trabajo repetitivo en un script cuando la tarea lo permite. En wmedia.es las solicitudes también fueron iguales, 4 y 4.
Un error en el script sale más caro. La tercera ejecución en Code Mode mostró la otra cara. El primer script no pasó el parser. El segundo tenía un require que no existe en el sandbox. En el tercero, zsh se comió los paréntesis en el comando find. Cada error es una solicitud extra, y cada solicitud arrastra 44 mil tokens de contexto y un historial que crece. Resultado: 7 solicitudes y 328 mil tokens de entrada, peor que cualquier ejecución sin Code Mode.
El consumo en Claude Code lo marca el tamaño del contexto que cada solicitud lleva de nuevo. El número de solicitudes solo lo multiplica. Lo analicé con detalle en el artículo sobre el consumo de tokens de Claude Code: allí las respuestas del modelo resultaron ser alrededor del 2 % del costo.
De dónde salieron los 150 mil, los 2 mil y los 13 turnos#
«De 150 mil a 2 mil». La cifra viene del artículo de Anthropic Code execution with MCP, del 4 de noviembre de 2025. El ejemplo es otro: un agente descarga la transcripción de una reunión de Google Drive y la adjunta a un lead en Salesforce. La transcripción no pasa por el contexto del modelo, y así se llega a «from 150,000 tokens to 2,000 tokens». Nada de esto tiene que ver con Code Mode en Claude Code, cuya documentación no trae ninguna cifra de ahorro.
«2 turnos en lugar de 13». No encontré la fuente: ni en la documentación, ni en el changelog, ni en el artículo de Anthropic. La documentación tiene la misma tarea de los enlaces rotos, pero sin mediciones.
«37 %». Esta cifra también circula en los resúmenes. Sale de la publicación de Anthropic Introducing advanced tool use, del 24 de noviembre de 2025, sobre programmatic tool calling en la API: «from 43,588 to 27,297 tokens, a 37% reduction». Tampoco es Code Mode.
Limitaciones que conviene conocer de antemano#
- Reanudación. Una sesión iniciada en Code Mode solo se puede continuar en la terminal y con el modo activado. Sin la variable,
claude --resumeno la abre. - Desaparecen Chrome y computer use. En Code Mode no funcionan Claude in Chrome, Remote Control ni computer use. Claude Code lo avisa al arrancar: «No Chrome or computer use». Si automatizas el navegador, hay que desactivar el modo.
- El modo auto revisa el código, no las llamadas. El clasificador lee el JavaScript una vez antes de ejecutarlo y no ve los valores que el código calculará sobre la marcha, por ejemplo una ruta sacada de resultados de búsqueda. Las reglas
denyy los hooksPreToolUsesiguen actuando en cada llamada, así que las prohibiciones importantes conviene dejarlas ahí. - Diez minutos. El código que espera un resultado se detiene a los 10 minutos, contando el tiempo de tus respuestas en los diálogos de permisos. En segundo plano vive hasta dos horas, pero solo si la sesión empezó en modo auto o
bypassPermissions. - Hooks. Si un hook
PreToolUsefalla o no alcanza a responder, la llamada desde el código se rechaza, incluso cuandoonFailureno está definido. - No se puede mover la sesión. No se traslada a la aplicación Desktop ni se convierte en una sesión en segundo plano.
Una empresa puede prohibir el modo a todos sus empleados con "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0" en los managed settings.
¿Vale la pena activar Code Mode ahora?#
Para tareas con muchas llamadas del mismo tipo, vale la pena probarlo: una edición repetida en muchos archivos, una búsqueda con filtrado de resultados, comandos independientes en paralelo. El ahorro estable son unos 18 mil tokens de contexto inicial en cada solicitud, y en una sesión larga se acumula.
No lo actives por el milagro de «75 veces más barato»: no existe. Si trabajas con Claude in Chrome o lanzas Claude Code con -p en scripts, el modo todavía no es para ti. Tampoco reemplaza la orquestación de muchos agentes desde JavaScript: para eso están los workflows en Claude Code, y junto con agent teams Code Mode no arranca.
Mi medición es pequeña: una tarea, un modelo, tres ejecuciones por modo. Luego la repetiré con una tarea de ediciones en muchos archivos, donde el modelo sin script sí va archivo por archivo.



