Inicio / Fundamentos y bucle del agente

Claude Code y el bucle del agente

Claude Code encadena reflexión, llamada real a una herramienta y lectura del resultado en bucle hasta lograr el objetivo, no responde una sola vez como un chat.

Claude Code no devuelve una respuesta única antes de esperar una nueva pregunta. Ante un objetivo, reflexiona sobre la acción a emprender, llama a una herramienta real, lectura de un archivo, ejecución de un comando, modificación de código, y luego observa lo que esa herramienta ha producido antes de decidir el siguiente paso. Este bucle se repite tantas veces como sea necesario, hasta que el objetivo se alcanza o se devuelve el control al usuario.

Lo que cambia el bucle respecto a un chat

Un asistente de conversación clásico produce una respuesta y se detiene ahí. Claude Code, en cambio, ejecuta realmente los comandos que propone, lee lo que devuelven en la salida estándar y en el error estándar, y ajusta su plan en función de ese resultado. Dar un objetivo completo, en lugar de una serie de instrucciones desglosadas paso a paso, deja que este bucle despliegue por sí mismo sus etapas intermedias. Una petición formulada como corrige el test que falla en calc.test.js desencadena una secuencia que nadie necesita detallar de antemano: lectura del archivo de test, ejecución de la suite, lectura del mensaje de error, corrección, nueva ejecución.

Objetivo recibido: corregir el test que falla en calc.test.js

Reflexión: leer el archivo de test para entender el fallo
Herramienta: lectura de calc.test.js
Observación: el test espera 4, la función devuelve 5

Reflexión: leer la función implicada
Herramienta: lectura de calc.js
Observación: una suma reemplaza a una resta

Reflexión: corregir la línea defectuosa
Herramienta: modificación de calc.js
Observación: archivo modificado

Reflexión: verificar que el test pase ahora
Herramienta: ejecución de la suite de tests
Observación: bucle terminado, se devuelve el control

Interrumpir sin perder el bucle

El bucle corre visiblemente en la terminal: cada reflexión, cada herramienta llamada y cada observación se muestran sobre la marcha, no solo el resultado final. Esto permite seguir una tarea larga sin tener que relanzarla para saber en qué punto va, e interrumpirla en el camino si la dirección tomada no conviene, conservando lo que ya se ha logrado.

Lo que alimenta cada vuelta del bucle

Cada reflexión se apoya en lo que la sesión ya sabe del proyecto. Una parte de este conocimiento viene de un archivo leído automáticamente al inicio de la sesión, CLAUDE.md, abordado en la lección siguiente, que fija reglas incluso antes de la primera vuelta del bucle. Sin un objetivo completo ni contexto de partida, el bucle igual funciona, pero entonces pasa más vueltas descubriendo información que un archivo de memoria ya habría aportado.