Claude Agent SDK: reutilizar el motor de Claude Code

De herramienta de terminal a biblioteca

La historia empieza con Claude Code, el asistente de programación de Anthropic que trabaja en la terminal. Sus funciones se ofrecieron primero a los desarrolladores como Claude Code SDK, rebautizado Claude Agent SDK en septiembre de 2025 para dejar claro que no sirve solo para programar. La idea: en lugar de escribir usted mismo el ciclo de un agente de IA y sus herramientas, reutiliza los de Claude Code.

De serie, el agente puede leer, escribir y modificar archivos, ejecutar comandos y buscar en la web. Además incluye subagentes especializados, «hooks» (su propio código ejecutado en momentos clave), un sistema de permisos que decide qué acciones requieren su visto bueno, sesiones que se pueden retomar y conexión con servidores MCP para enlazar bases de datos, navegadores o API.

¿Para qué proyectos?

El SDK destaca cuando un agente debe actuar sobre un entorno real: corregir errores, escribir y lanzar pruebas (programación agéntica), clasificar documentos, generar informes o automatizar un paso de integración continua. Anthropic publica agentes de ejemplo en GitHub, como un asistente de correo y un agente de investigación.

Cómo empezar

Necesita Node.js 18+ o Python 3.10+ y una cuenta de Anthropic. Se instala claude-agent-sdk (pip) o @anthropic-ai/claude-agent-sdk (npm), se configura la clave de API y se llama a la función query con una instrucción y la lista de herramientas permitidas. La guía oficial de inicio muestra un agente que encuentra y corrige errores en un archivo.

Puntos fuertes y límites

Puntos fuertes: un agente muy equipado desde la primera línea, la misma mecánica que Claude Code y un control preciso de permisos y contexto.

Límites: solo funciona con modelos Claude; su uso está sujeto a los términos comerciales de Anthropic; y cada ejecución consume tokens facturados, que pueden acumularse en tareas largas. Un agente capaz de ejecutar comandos debe acotarse bien: el aislamiento en sandbox y la herramienta ¿puedo confiar esto a un agente? ayudan a delimitar los riesgos. Si prefiere que Anthropic aloje el agente en lugar de sus propios servidores, la empresa ofrece un producto aparte, Managed Agents.

Alternativas

El OpenAI Agents SDK y Google ADK cumplen un papel similar con otros fabricantes, mientras que smolagents y Pydantic AI son independientes del modelo.