Cómo trabaja un agente de IA como Claude Code

Hola, bienvenido. En la lección anterior vimos que Claude Code es un agente que trabaja dentro de tu proyecto, y en esta lección vamos a ver cómo lo hace: el ciclo que sigue cada vez que le das una tarea, las herramientas que tiene para leer, editar y ejecutar, y cómo intervenir cuando va por donde no quieres. Todavía no vamos a instalar nada, pero todo lo que veamos aquí lo vas a reconocer en pantalla desde la primera sesión, y entenderlo es lo que te permite pararlo a tiempo en lugar de descubrir el problema cuando ya está en el diff.

Seguro que has visto a un agente encadenar una lectura, una búsqueda, una edición y un comando sin que nadie le diga qué archivo abrir. Desde fuera parece que piensa de forma continua, pero lo que ocurre es bastante más mecánico y, por suerte para nosotros, bastante más fácil de controlar: el modelo decide el siguiente paso, una herramienta lo ejecuta, el resultado vuelve al modelo y con esa información decide el paso siguiente. Ese ciclo se repite decenas de veces en una tarea normal, y cada vuelta es un punto en el que tú puedes entrar a corregir.

La documentación de Claude Code describe el trabajo del agente en 3 fases: reunir contexto, actuar y verificar el resultado. Estas fases se mezclan durante toda la tarea, porque Claude usa herramientas en todas ellas: busca archivos para entender el código, edita para hacer cambios y lanza los tests para comprobar su trabajo. A ese ciclo se le llama agentic loop, y es la pieza que vamos a tener en la cabeza durante todo el curso.

¿Cómo se ve en un caso real? Imagina que le pides que arregle los tests que fallan en un proyecto Laravel. La propia documentación pone este ejemplo, y la secuencia típica es esta: ejecuta la suite para ver qué falla, lee la salida del error, busca los archivos relacionados, los lee para entender el código, los edita para corregir el fallo y vuelve a lanzar los tests para verificar que ahora pasan. Si el segundo intento falla, no vuelve a ti con las manos vacías: lee el nuevo error y da otra vuelta al ciclo con lo que ha aprendido. Puesto en un diagrama, el ciclo queda así, junto con las 2 formas que tienes de meterte en él y que veremos más abajo:

Fíjate en que el loop se adapta a lo que pides. Una pregunta sobre tu código puede resolverse solo reuniendo contexto, sin tocar un archivo. Un bug hace que las 3 fases se repitan varias veces, y una refactorización grande puede dedicar la mayor parte del tiempo a verificar. Es Claude quien decide qué necesita cada paso según lo que ha aprendido en el anterior, y por eso 2 ejecuciones de la misma tarea no siguen siempre el mismo camino.

Detrás del loop hay 2 piezas: el modelo, que razona y decide, y las herramientas, que actúan. Claude Code es la capa que rodea al modelo, le da esas herramientas y gestiona el contexto que ve en cada momento, y esa capa es lo que se conoce como harness. Si quieres entender por qué el harness pesa tanto como el modelo en el resultado final, lo tienes explicado en el artículo Qué es un harness en IA y por qué pesa más que el modelo↗ (se abre en una pestaña nueva).