Ejecuta llamadas a herramientas desde código con Code Mode

Cómo funciona Code Mode

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() });

Cuándo usar Code Mode

• Un cambio que se repite en muchos archivos
• Una búsqueda cuyos resultados necesitan filtrarse antes de que Claude los lea
• Varios comandos independientes que pueden ejecutarse al mismo tiempo

Limitaciones de Code Mode

• Reanudación: solo puedes reanudar una sesión de Code Mode en la terminal, con Code Mode activado
• Modo automático: el clasificador del modo automático revisa el código, no cada llamada a herramienta
• Código de larga duración: a menos que el código pueda ejecutarse en segundo plano, esperas a que termine, y se detiene después de diez minutos
• Hooks: puedes ver llamadas a herramientas rechazadas cuando un hook PreToolUse no puede ejecutarse o se agota su tiempo de espera, y salida de código bloqueada por un hook UserPromptSubmit
• Funciones no disponibles: no puedes usar Remote Control, Claude in Chrome ni computer use
• Mover la sesión: no puedes mover la sesión a la aplicación de escritorio ni convertirla en una sesión en segundo plano, y /fork no puede iniciar una copia en segundo plano

Requisitos

• Versión: Claude Code v2.1.323 o posterior, en cualquiera de los dos canales de versiones. Una versión anterior se inicia sin Code Mode, con o sin el motivo it isn't open to your account yet
• Cuenta: una suscripción a Claude o una cuenta de Console. No puedes usar Code Mode a través de un gateway, Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud ni Microsoft Foundry
• Organización: tu organización no usa la configuración HIPAA ni la retención cero de datos
• Modelo: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 o Fable 5.2
• Superficie: una sesión interactiva de claude en una terminal. Code Mode no funciona con -p, el Agent SDK, el panel de VS Code, la aplicación de escritorio ni las sesiones en la nube
• Instalación: la compilación nativa de Claude Code
• Windows: Git for Windows está instalado

Prueba Code Mode

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Code Mode (experimental) is on · this session can be resumed only with Code Mode on

Read every Markdown file in this project and list the links that point to local files that don't exist.

Desactiva Code Mode

Bloquea Code Mode para tu organización

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

Permisos y código de larga duración

Comprobaciones de permisos

• Modo automático: el clasificador revisa cada fragmento de código antes de que se ejecute, no cada llamada a herramienta. No ve los valores calculados en tiempo de ejecución, como una ruta tomada de la salida de una búsqueda, así que mantén reglas o hooks para las llamadas que debas controlar. Aun así, se te puede pedir confirmación cuando se inicia código nuevo mientras se ejecuta código anterior
• Otros modos de permisos: el código se inicia sin revisión, y se te pide confirmación para cada llamada a herramienta que te la pediría en ese modo

Código de larga duración

• Esperando: Claude responde después de que el código termina, y el código se detiene después de diez minutos, incluido el tiempo que pasas en las solicitudes de permiso
• Segundo plano: puedes seguir hablando con Claude, y el código puede ejecutarse hasta dos horas

• Cambiaste a otro modo: presiona Shift+Tab hasta volver al modo en el que iniciaste
• Iniciaste en otro modo, o elegiste la sesión de la lista de claude --resume: si el modo automático está disponible para ti, sal y luego ejecuta claude --continue --permission-mode auto con Code Mode activado
• Pasaste nombres de herramientas a --tools: vuelve a iniciar en el modo automático sin ese flag

Solución de problemas

Code Mode no se inicia

Solicitud de permiso con cuenta regresiva

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

Llamada a herramienta rechazada por un hook

• the hook failed: en una llamada desde el código de Claude, tu hook no pudo iniciarse, fue terminado, salió con 126, 127 o un código superior a 128, o devolvió un error HTTP o una salida no válida. Corrige el hook
• the hook did not finish: se agotó el tiempo de espera de tu hook en una llamada desde el código de Claude, o en cualquier otra llamada a herramienta una vez que Claude ha ejecutado código en la sesión. Aumenta el timeout del hook

Salida de código retenida por un hook

Recursos relacionados

• Modos de permisos: compara el modo automático con los modos que te piden confirmación
• Referencia de hooks: escribe hooks PreToolUse y UserPromptSubmit
• Configuración administrada: aplica una configuración en toda una organización