Qué es el agent loop y por qué cambia cómo construimos software

De un chat a un agente

Un chat responde una vez. Un agente trabaja en un bucle: recibe una tarea, decide qué herramienta usar, observa el resultado y vuelve a decidir, hasta que la tarea está hecha. Ese bucle es el agent loop, y es el mismo que ejecuta Claude Code por dentro. El Claude Agent SDK lo expone para que lo uses desde tu propio código Python.

Las cinco fases

1. Recibir el prompt. Claude recibe tu tarea junto con el system prompt, las definiciones de herramientas y el historial. El SDK emite un SystemMessage de subtipo init.
2. Evaluar y responder. Claude contesta con texto, con llamadas a herramientas, o con ambos.
3. Ejecutar herramientas. El SDK ejecuta las herramientas y devuelve los resultados a Claude. Los hooks pueden interceptar, modificar o bloquear cada llamada.
4. Repetir. Los pasos 2 y 3 forman un ciclo; cada ciclo es un turno. Termina cuando Claude responde sin pedir herramientas.
5. Devolver el resultado. El SDK emite un ResultMessage con el texto final, el uso de tokens, el costo y el id de sesión.

Por qué importa a un desarrollador Odoo

Construir un módulo Odoo es exactamente una tarea de muchos pasos con verificación: escribir modelos, vistas y permisos, instalar, correr tests, leer el error, corregir. Un agente con las herramientas correctas (leer y editar archivos, ejecutar odoo-bin, consultar la base por API) puede recorrer ese ciclo solo. Tu trabajo pasa a ser diseñar el loop: qué herramientas le das, qué puede y qué no puede hacer, y cuándo debe parar.

Fuente principal: Cómo funciona el agent loop, documentación oficial del Claude Agent SDK.