Una sesión normal de Claude Code pasa muchos turnos en pasos pequeños. Claude lee un archivo, espera, ejecuta un comando, espera otra vez, edita un archivo y también lee ese resultado. El modo Code cambia la forma de ese trabajo. Claude escribe un fragmento de JavaScript que hace las llamadas a herramientas, y Claude Code ejecuta ese código en tu sesión.
Anthropic agregó el modo Code en Claude Code v2.1.323 el 12 de noviembre de 2026, y la documentación lo llama experimental y apagado por defecto. Esa etiqueta importa. La función puede cambiar o ser retirada en cualquier versión, la documentación no da ninguna cifra de ahorro de tokens para ella, y una sesión iniciada con ella solo puede reanudarse con ella todavía activa. Pruébala en trabajo que puedas revisar, no en trabajo que no puedas permitirte rehacer.
Este tutorial sigue la página oficial de documentación de Claude Code para el modo Code, revisada el 16 de noviembre de 2026. No afirma haber hecho una prueba propia. El orden es deliberado. Revisa primero la versión y la cuenta, activa el modo para una sola sesión, empieza con una tarea que solo lee, y lee el guion antes de dejar que un guion edite archivos por ti.
Qué vas a construir o aprender
Vas a activar el modo Code para una sesión en terminal y usarlo de la forma que recomienda Anthropic. Eso significa una tarea que toma muchas llamadas relacionadas a herramientas, como un cambio que se repite en muchos archivos, una búsqueda cuyos resultados necesitan filtro antes de que Claude los lea, o varios comandos que pueden ejecutarse al mismo tiempo.
También vas a aprender qué no cambia. Cada llamada a herramienta que hace el código todavía pasa por tus reglas de permiso de denegar y preguntar y por tus ganchos PreToolUse. Lo que cambia es la unidad que revisas. En modo auto, el clasificador revisa cada fragmento de código antes de que se ejecute, no cada llamada a herramienta dentro de él, y no ve los valores que el código calcula mientras se ejecuta.
Un solo guion puede contener las llamadas que antes tomaban muchos turnos. Ilustración: Dirty Static
Antes de empezar
Trabaja en un repositorio Git y parte de un estado que puedas medir. Confirma o guarda tu trabajo actual, ejecuta git status y anota el resultado. Si un guion cambia después un archivo que no esperabas, ese primer registro es la forma de saberlo.
Conoce los límites de tiempo antes de que empiece un trabajo largo. El código que Claude espera se detiene después de diez minutos, y ese tiempo incluye el tiempo pasado en solicitudes de permiso. El código que puede ejecutarse en segundo plano puede durar hasta dos horas. El código en segundo plano necesita una sesión iniciada en modo auto o en modo bypassPermissions, según la documentación.
Remote Control, Claude en Chrome y el uso de la computadora no funcionan mientras el modo Code está activo. Tampoco puedes mover una sesión en modo Code a la aplicación de escritorio ni convertirla en una sesión en segundo plano, y el comando de bifurcación no puede iniciar una copia en segundo plano de ella. Planifica una sesión que se quede en la terminal donde empezó. Para un contexto más amplio sobre mantener acotado el trabajo de los agentes, consulta nuestra guía para evitar que Claude Code filtre secretos a GitHub.
Paso 1: Revisa la versión y la superficie
Acción: revisa tu versión en una terminal y confirma que trabajarás en una sesión interactiva en terminal con la compilación nativa.
claude --version
Resultado esperado: la versión es v2.1.323 o posterior. Si es más antigua, actualiza primero Claude Code y revisa otra vez. Una versión más antigua inicia sin el modo Code, con o sin una razón que diga que todavía no está abierto a tu cuenta. Si planeas usar el panel de VS Code, la aplicación de escritorio, una sesión en la nube, el SDK de Agent o la bandera de impresión para este trabajo, detente aquí. El modo Code no iniciará en esas superficies.
Paso 2: Activa el modo Code para una sesión
Acción: ajusta la variable de entorno en tu shell e inicia Claude Code. Esta forma activa el modo solo para este inicio, que es el alcance correcto para una primera prueba.
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
Resultado esperado: Claude Code te pide confirmar antes de la primera sesión en modo Code, luego se reinicia con una línea cerca de la parte superior que dice que el modo Code está activo y que la sesión solo puede reanudarse con el modo Code activo. Si ves una línea que dice que el modo Code no está disponible, lee la razón en esa misma línea y usa la tabla de solución de problemas de abajo. El comando de estado dentro de la sesión también muestra la razón.
Paso 3: Mantén el ajuste, solo si la primera prueba lo merece
Acción: si quieres el modo Code en cada sesión nueva, agrega la variable al bloque env de tu archivo de ajustes de usuario en ~/.claude/settings.json. No pongas el interruptor en un archivo de ajustes de proyecto esperando que funcione. La documentación trata esto como una elección del usuario, y un repositorio clonado no debería poder activarlo por ti.
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
Resultado esperado: las sesiones nuevas en terminal inician con el mismo flujo de confirmación y el mismo aviso. Ten un hecho en mente cuando depures este ajuste. Un valor de 0 en un lugar mantiene el modo Code apagado aunque otro lugar ajuste 1. Esa regla también permite que una organización bloquee el modo para todos por medio de ajustes administrados, y los ajustes administrados no pueden activarlo para los usuarios.
Paso 4: Ejecuta una primera tarea que solo lee
Acción: dale a Claude una tarea de búsqueda cuyos resultados necesiten filtro, y pide un valor de retorno corto. Cambia la palabra y la carpeta para que coincidan con una búsqueda que de verdad necesites, y mantén la tarea en lectura e informe.
Find every file under src that mentions retryPolicy. Return only the file paths and, for each path, the line that sets the retry limit. Do not edit any file.
Resultado esperado: Claude escribe JavaScript que hace las llamadas, ejecuta la búsqueda y devuelve la parte de la salida que necesita leer. En la conversación ves las llamadas a herramientas, como un resultado de búsqueda o una lectura de archivo, y no el código. Un fragmento de código puede ejecutar comandos en paralelo, usar un resultado en la siguiente llamada y devolver un resultado filtrado en vez de cada resultado bruto completo.
La puerta todavía existe. Cada llamada todavía pasa por tus reglas y tus ganchos. Ilustración: Dirty Static
Paso 5: Lee el guion antes de confiar en una edición
Acción: pulsa Ctrl+O para abrir el visor de transcripción. Cada fragmento de código aparece allí como una fila Code contraída, con una pista sobre cómo expandirla. Lee el guion completo y revisa tres cosas. Los archivos que toca coinciden con tu tarea. Los comandos coinciden con el trabajo que pediste. La última parte del guion devuelve solo lo que Claude necesita leer después.
Resultado esperado: puedes explicar qué hará el guion antes de que haga más trabajo. Si no puedes, no pases todavía a una tarea de edición. Pide a Claude el texto del error o el texto del guion en forma simple, corrige la solicitud y empieza la tarea otra vez.
Paso 6: Ejecuta una tarea pequeña de edición en una rama
Acción: pasa a una rama que puedas descartar, luego dale a Claude el tipo de tarea que la documentación usa como ejemplo. La documentación muestra a Claude subiendo un límite de reintentos. En ese ejemplo, el guion encuentra el archivo que contiene la política de reintentos, edita el límite en ese archivo, ejecuta las pruebas de esa política y devuelve la ruta del archivo y la salida de las pruebas.
El guion en el ejemplo de la documentación toma esta forma. Este es el código que Claude podría escribir para esa solicitud, mostrado para que sepas qué buscar en el visor de transcripción. No es un comando para pegar y ejecutar por su cuenta.
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() });
Da la tarea en tus propias palabras, con tu propio límite y tu propio comando de prueba, y observa las solicitudes de permiso cuando lleguen. En los modos que preguntan, recibes una solicitud por cada llamada a herramienta que te la haría en ese modo. En modo auto, el clasificador revisa primero el código, así que mantén reglas de denegación o ganchos para las llamadas que debes controlar, porque el clasificador no ve los valores calculados mientras el código se ejecuta.
Resultado esperado: la conversación muestra las llamadas a herramientas que hizo el guion, como la diferencia de la edición, y el guion devuelve la ruta editada y la salida de las pruebas. El código en sí se queda en el visor de transcripción, no en la conversación principal.
Paso 7: Apaga el modo Code y anota la regla de reanudación
Acción: para apagar el modo, retira CLAUDE_CODE_EXPERIMENTAL_CODE_MODE de tu shell y de ~/.claude/settings.json, luego inicia una sesión nueva. También puedes mantener la variable y cambiar su valor a 0 en cualquiera de los dos lugares.
Resultado esperado: las sesiones nuevas inician sin el modo Code. Una sesión en modo Code puede reanudarse solo en la terminal, con el modo Code activo. Si tratas de reanudarla con el modo apagado, inicia en su lugar una sesión nueva y lleva la tarea en tu solicitud, con la diferencia y los resultados de pruebas del trabajo hecho hasta ahora.
Verificación
Revisa cuatro cosas y anota los resultados. El aviso al inicio de la sesión dijo que el modo Code estaba activo. La primera tarea no cambió ningún archivo, lo que git status confirma según el registro que tomaste antes de empezar. El visor de transcripción contenía el guion como una fila Code, y lo leíste antes de que se ejecutara la tarea de edición. La tarea de edición devolvió la ruta que cambió y la salida de pruebas que afirmó, y la diferencia y una nueva ejecución de las pruebas coinciden con ese retorno.
Termina con la diferencia. Ejecuta git diff y nombra cada archivo que lista según la tarea que diste. Un resumen limpio de Claude no es prueba. La diferencia, la salida de estado y las pruebas son la prueba que puedes revisar por tu cuenta.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| El modo Code no inicia y la razón dice que todavía no está abierto a tu cuenta | La versión es más antigua que v2.1.323, o la cuenta todavía no ha sido abierta a la función | Actualiza Claude Code, revisa tu conexión de red y vuelve a iniciar. Si la razón se mantiene, inténtalo otro día |
| La razón dice que solo funciona con la API de Anthropic | Los ajustes enrutan las solicitudes por un proveedor en la nube, una puerta de enlace o una URL base personalizada | Retira esos ajustes de enrutamiento, luego inicia sesión con una suscripción de Claude o una cuenta Console y vuelve a iniciar |
| La razón menciona un ayudante de clave API | Un ayudante de clave API, un token de autenticación o un encabezado de autenticación personalizado está ajustado | Retira el ayudante y los ajustes nombrados, luego inicia sesión o ajusta tu clave API de la forma que nombra la documentación, y vuelve a iniciar |
| La razón dice que solo funciona con modelos compatibles | La sesión inició con un modelo fuera de la lista compatible | Inicia con un modelo compatible, por ejemplo con la bandera de modelo ajustada a opus. Haiku 5.5 y Fable 5.2 también funcionan |
| La razón menciona telemetría o ajustes de funciones | La telemetría está apagada, la exportación OpenTelemetry está activa, o los equipos de agentes están activos | Desactiva las variables que nombra la razón, si puedes trabajar sin esas funciones, e inicia una sesión nueva |
| Un gancho rechaza una llamada a herramienta | Un gancho PreToolUse falló, agotó su tiempo o no dio ninguna decisión en una llamada desde código | Pide a Claude el texto del error, corrige el gancho o sube su tiempo límite. Para dejar pasar las llamadas cuando un gancho falla, ajusta onFailure a continue en ese gancho |
| La salida del código se bloquea donde esperabas un resultado | Un gancho UserPromptSubmit bloqueó la salida del código que se ejecuta en segundo plano | Cambia el gancho para que no bloquee cuando la fuente en su entrada es poll_event |
| Una solicitud muestra una cuenta regresiva en modo auto | Código nuevo empezó mientras código anterior todavía se ejecutaba, así que el código anterior perdió su revisión del clasificador | Responde antes de que termine la cuenta regresiva. Sin respuesta, esa llamada se rechaza, y las llamadas posteriores que mostrarían una cuenta regresiva se rechazan sin solicitud |
| Una sesión no se reanuda | Tratas de reanudar una sesión en modo Code sin el modo Code, o fuera de una terminal | Inicia en una terminal con el modo Code activo, o inicia una sesión nueva y lleva la tarea |
Próximos pasos
Usa el modo Code donde la forma encaja y sáltalo donde no encaja. Un cambio que se repite en muchos archivos, una búsqueda que necesita filtro y un conjunto de comandos que pueden ejecutarse al mismo tiempo son las tareas que nombra Anthropic. Una tarea con una o dos llamadas gana poco, y una tarea que necesitas observar llamada por llamada se ejecuta mejor en el modo normal.
Ignora la cifra de ahorro de tokens que verás compartida para esta función hasta que Anthropic publique una para el modo Code en sí. La documentación del modo Code no da ninguna cifra así. La cifra en amplia circulación viene de un artículo de Anthropic de 2025 sobre una función de API relacionada, y una cifra para una superficie no es una promesa para otra. Mide tus propias sesiones en tus propias tareas, y mantén el modo solo si el trabajo se mantiene fácil de leer, fácil de revisar y fácil de deshacer.
Fuentes
- Anthropic, documentación de Claude Code, Run tool calls from code with Code Mode, code.claude.com/docs/en/code-mode, revisada el 16 de noviembre de 2026. La fuente para cómo funciona el modo Code, la forma del guion de ejemplo, los requisitos, los pasos para activar y desactivar, las reglas de permiso, los límites de tiempo y las razones de solución de problemas.
- Anthropic, registro de cambios de Claude Code, versión 2.1.323, 12 de noviembre de 2026, por medio de code.claude.com. La fuente para la fecha de salida y la descripción del modo Code como una opción experimental donde Claude escribe JavaScript para llamar a sus herramientas.
- Anthropic, Introducing advanced tool use on the Claude Developer Platform, 24 de noviembre de 2025, anthropic.com. Solo contexto, para el trabajo de API relacionado sobre llamar a herramientas desde código. Este tutorial no usa sus cifras de tokens como cifras para el modo Code en Claude Code.
- Crédito de imagen: todas las imágenes de este artículo son ilustraciones de Dirty Static.
FIN DE LA TRANSMISIÓN
Mantén la curiosidad. Cuestiónalo todo.


