Volver al blog
Claude CodeIALaravel

Claude Code 2.1.323 incorpora Code Mode para encadenar herramientas

Code Mode permite a Claude Code escribir JavaScript para coordinar varias herramientas en una sola ejecución.

Por Isma5 min de lectura

Menos turnos para resolver tareas repetitivas

Cuando una tarea exige buscar, filtrar resultados, tocar varios archivos y ejecutar pruebas, el ciclo habitual de un agente se vuelve lento. Hace una llamada a herramienta, lee la salida, decide el siguiente paso y repite. Code Mode cambia esa mecánica: Claude escribe JavaScript para coordinar varias llamadas dentro de una misma ejecución.

La idea no es convertir Claude Code en un entorno de automatización generalista. Sirve para que el agente pueda encadenar operaciones relacionadas, reutilizar una salida en el siguiente paso y lanzar trabajos independientes en paralelo. El resultado que vuelve al modelo puede ser más pequeño y más útil que un bloque enorme de salida sin filtrar.

Dónde me encaja en un proyecto Laravel

En un Laravel grande hay tareas que se benefician claramente de ese flujo. Por ejemplo, localizar una configuración repetida en varios módulos, revisar qué pruebas cubren unas rutas concretas o detectar usos de una clase antes de preparar un cambio. En vez de pedir resultados por partes, Code Mode puede organizar búsquedas, seleccionar los archivos relevantes y dejar preparada una modificación acompañada de sus tests.

No sustituye revisar el diff ni entender la arquitectura del proyecto. Si el cambio afecta a políticas, colas, migraciones o integraciones externas, sigo queriendo decidir qué se toca y por qué. Su valor está en quitar trabajo mecánico de exploración y coordinación, no en delegar el criterio técnico.

También tiene sentido en el homelab

En el homelab suelo acumular inventarios, contenedores, servicios y configuraciones repartidas entre máquinas. Ahí resulta útil cuando hay varias comprobaciones independientes: consultar estados, buscar referencias en ficheros de configuración o contrastar la salida de varios comandos. Si hay que modificar algo, las reglas de permisos siguen siendo una barrera necesaria antes de convertir una comprobación en una acción.

Lo importante es que Code Mode no elimina la visibilidad de lo que ocurre. En la conversación se siguen mostrando las llamadas a herramientas y sus efectos, como los cambios realizados por una edición. El JavaScript que ha escrito Claude se puede consultar desde el visor de transcripciones con Ctrl+O.

Cómo activarlo

Code Mode es experimental y viene desactivado. Requiere Claude Code 2.1.323 o posterior, una sesión interactiva de terminal y una cuenta compatible. Para probarlo en macOS, Linux o WSL, basta con arrancar Claude Code con esta variable de entorno:

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

También se puede dejar activado para las nuevas sesiones desde la configuración de usuario. Claude Code ignora esta variable si aparece en los archivos de configuración del proyecto, así que un repositorio clonado no puede habilitar Code Mode por su cuenta.

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

Ese bloque debe guardarse en ~/.claude/settings.json. La primera vez, Claude Code pide confirmación y reinicia la sesión con el modo activo. Si más adelante quiero retomarla, tengo que mantener la variable a 1 al usar claude --continue o claude --resume.

Permisos, hooks y la parte que conviene no olvidar

Cada llamada a herramienta ejecutada desde el código sigue pasando por las reglas deny y ask, además de los hooks PreToolUse. No hay que reescribir los matchers habituales de herramientas como Bash solo por activar Code Mode. Si necesito inspeccionar el propio JavaScript antes de que se ejecute, la documentación indica que un hook PreToolUse puede coincidir con la herramienta REPL y leer tool_input.code.

Hay un matiz relevante en modo automático. El clasificador revisa el bloque de código antes de ejecutarlo, no cada llamada individual que contiene. Como algunos valores se calculan durante la ejecución, conviene mantener reglas o hooks para las operaciones que deban estar controladas de forma estricta.

La letra pequeña

No es una mejora automática para cualquier sesión. Code Mode no funciona con -p, Agent SDK, el panel de VS Code, Claude Desktop ni las sesiones cloud. Tampoco está disponible mediante gateways, Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform o Microsoft Foundry.

Las sesiones iniciadas con este modo solo se pueden reanudar desde la terminal y con Code Mode activo. Además, no permite Remote Control, Claude in Chrome ni computer use, y no se puede mover la sesión a la aplicación de escritorio. Es una limitación razonable para una función experimental, pero conviene saberlo antes de incorporarla a un flujo diario.

También hay que vigilar las ejecuciones largas. Si el código espera en primer plano, se detiene tras diez minutos, incluyendo el tiempo consumido en avisos de permisos. Puede ejecutarse en segundo plano en determinadas condiciones de modo de permisos, pero eso no convierte las tareas largas en algo que deba lanzarse sin supervisión.

Para revisar código Laravel o coordinar comprobaciones en el homelab, Code Mode parece una mejora práctica cuando el problema está formado por muchas llamadas pequeñas y relacionadas. Para un cambio delicado, una operación destructiva o una decisión de arquitectura, sigue siendo más importante definir bien los límites, los permisos y la revisión final. La novedad no está en darle más autonomía sin control, sino en reducir los turnos innecesarios dentro de un marco que ya exista.


Fuente de la versión 2.1.323 · Documentación oficial de Code Mode

Newsletter

Lo que aprendo programando con IA, cada dos semanas en tu correo.

Cifras reales, errores incluidos. Sin spam y te das de baja con un clic.

Sin spam y te das de baja con un clic. Uso tu correo solo para enviarte esto y la newsletter. Más en la política de privacidad.