Construye tus propios agentes con el Claude Agent SDK

El Claude Agent SDK te da el bucle de agente de Claude Code como biblioteca, para tus propios programas en lugar de la CLI ya hecha.

Qué es el SDK

El Claude Agent SDK es una biblioteca para Python y TypeScript. Te da el mismo bucle de agente, las mismas herramientas integradas y la misma gestión de contexto que impulsan Claude Code, pero programable en tu propio código en lugar del terminal.

El bucle de agente viene incluido

Normalmente, al trabajar con un LLM tienes que construir tú mismo un bucle: enviar una petición, comprobar si el modelo quiere usar una herramienta, ejecutar la herramienta, devolver el resultado, repetir. Con el SDK, Claude se encarga de esto: llamas a query() con un prompt, y la respuesta llega como un flujo de mensajes —razonamiento, llamadas a herramientas, resultados de herramientas— hasta que la tarea está terminada.

Definir herramientas

Las herramientas integradas como Read, Write, Edit, Bash, Glob, Grep y WebSearch funcionan de inmediato, sin que tengas que implementarlas tú. Con allowed_tools defines lo que el agente puede usar; con permission_mode controlas cuánta aprobación necesita. Además, puedes conectar tus propios servidores MCP cuando el agente necesite acceder a sistemas externos.

¿SDK o la CLI ya hecha?

Para el desarrollo interactivo y tareas puntuales, la CLI de Claude Code es suficiente. El SDK está pensado para pipelines de CI/CD, aplicaciones propias y automatización en producción: las mismas capacidades, pero integradas en tu propio programa en lugar del terminal.

EJEMPLO

En tu propio código: `query(prompt="Lee README.md y resume los tres puntos más importantes", options=ClaudeAgentOptions(allowed_tools=["Read"]))` – el agente lee el archivo por sí mismo y responde como un flujo de mensajes.

🛠️ EJERCICIO — PRUÉBALO TÚ

Con el Claude Agent SDK (Python o TypeScript), construye un pequeño agente que lea un archivo con errores intencionados y los repare.

Instala el SDK (pip install claude-agent-sdk o npm install @anthropic-ai/claude-agent-sdk) y configura tu ANTHROPIC_API_KEY.
Escribe un archivo pequeño con un error evidente (por ejemplo, una división entre cero) y llama a query() con allowed_tools=["Read","Edit"].
Sigue el flujo de mensajes y observa cómo el agente lee, razona y modifica el archivo, sin que tú hayas programado el bucle de herramientas.

✅ AUTOEVALUACIÓN

☐ ¿Escribiste tú en algún sitio un bucle para las llamadas a herramientas, o se encargó el SDK?
☐ ¿Qué ocurre si configuras permission_mode en "plan" en lugar de "acceptEdits"?
☐ ¿Cuándo usarías la CLI de Claude Code en lugar del SDK para la misma tarea?

QUIZ RÁPIDO

¿Qué se encarga de hacer automáticamente el Claude Agent SDK que, en una solución construida por ti mismo sobre la API pura, tendrías que programar tú?