¿Qué es Claude Agent SDK?
El Claude Agent SDK permite a un programa en Python o TypeScript ejecutar el mismo bucle de agente, las mismas herramientas y la misma gestión de contexto que mueven Claude Code. Antes se llamaba Claude Code SDK. La biblioteca arranca un binario de Claude Code incluido e intercambia mensajes con él, así que un agente construido encima puede leer, escribir y editar archivos, ejecutar comandos de shell y buscar en la web desde el primer momento.
query() ejecuta una tarea puntual como un flujo asíncrono; ClaudeSDKClient mantiene una sesión bidireccional y añade herramientas propias, escritas como funciones normales de Python y servidas como servidores MCP en proceso, además de hooks que ejecutan tu código en puntos del ciclo de vida del agente. Subagentes, sesiones que se reanudan o bifurcan, modos de permiso, skills, plugins y la memoria del proyecto de las carpetas .claude/ se heredan de Claude Code.
El paquete de Python requiere Python 3.10 o posterior. La versión 0.2.178 salió el 4 de noviembre de 2026 con Claude Code 2.1.318 incluido; el paquete de TypeScript se publica como @anthropic-ai/claude-agent-sdk.
¿Merece la pena Claude Agent SDK?
El valor del Agent SDK es que las partes difíciles ya están escritas. La edición de archivos, el acceso a la shell, la compactación del contexto, los subagentes y las peticiones de permiso vienen de Claude Code, que Anthropic actualiza cada pocos días, así que una llamada a query() de diez líneas consigue un agente capaz de arreglar un fallo en un repositorio real. Frameworks rivales como el OpenAI Agents SDK o LangGraph te dan piezas para montar; este te da un entorno terminado que hay que acotar.
Esa inversión determina el modelo de seguridad. Por defecto Claude tiene todo el conjunto de herramientas de Claude Code, incluidos Bash y Write. allowed_tools solo aprueba automáticamente las herramientas que enumeras; no quita las demás, que pasan al modo de permisos y a tu callback can_use_tool. Para quitar una herramienta hace falta disallowed_tools. Quien integre el SDK en un servicio debería leer la guía de permisos antes que el quickstart, y ejecutar el proceso en un contenedor si las entradas no son de confianza.
La etiqueta de código abierto necesita una nota al pie. El envoltorio de Python tiene licencia MIT, pero el trabajo lo hace el binario de Claude Code incluido, y la documentación dice que el uso del SDK se rige por los Commercial Terms de Anthropic. El repositorio de TypeScript figura con todos los derechos reservados. No puedes bifurcar el bucle del agente, solo configurarlo.
El ritmo de versiones sigue al de Claude Code: 25 versiones de Python entre el 15 de septiembre y el 4 de noviembre de 2026, de 0.2.153 a 0.2.178, todavía por debajo de 1.0. El repositorio tiene unas 8.440 estrellas y 616 issues y pull requests abiertos. La documentación prohíbe a los productos de terceros ofrecer el inicio de sesión de claude.ai o los límites de los planes sin aprobación, así que un producto construido con el SDK factura mediante claves de API; en la máquina de un desarrollador, el uso con sesión iniciada consume su plan de Claude. Un crédito mensual para el SDK anunciado para el 15 de junio de 2026 se suspendió ese mismo día.
Dónde se gana su sitio
Un ingeniero de plataforma en una empresa de 100 desarrolladores
Ejecutar un bot interno que clasifique trabajos de CI fallidos y proponga parches
Llama a query() desde el runner de CI con cwd en el checkout, disallowed_tools para todo lo que esté fuera del repositorio y un hook PreToolUse que bloquee comandos de red; el uso se factura a una clave de API de la Console con su propio límite de gasto.
Una start-up que añade un agente a un producto de gestión documental
Dejar que los clientes pidan a un agente reorganizar y resumir sus archivos
Expón las acciones del propio producto como herramientas con el decorador @tool y create_sdk_mcp_server, para que corran en proceso; cada sesión de cliente va en su propio contenedor, y la facturación pasa por claves de API porque el inicio de sesión de claude.ai no está permitido.
Una desarrolladora independiente que automatiza tareas en su portátil
Programar refactorizaciones repetidas sin escribir un bucle de agente
Un script corto de Python con ClaudeSDKClient y el modo acceptEdits hace las ediciones; con su plan personal de Claude iniciado, consume los límites de ese plan en lugar de generar una factura aparte.
Antes de decidirte
- Puesta en marcha
- pip install claude-agent-sdk en Python 3.10+ (o npm install @anthropic-ai/claude-agent-sdk), define una clave de API y el agente de corrección de fallos del quickstart funciona en minutos; no hace falta instalar Claude Code aparte.
- Integraciones
- Servidores MCP, herramientas propias en proceso, hooks, subagentes, skills y plugins de las carpetas .claude/; Claude API, Amazon Bedrock, Google Cloud y Microsoft Foundry para acceder a los modelos.
- Datos y privacidad
- Se ejecuta en local con los permisos de su proceso y envía prompts y contenido de archivos a Claude según las condiciones de la API o del plan de la cuenta; el conjunto de herramientas por defecto puede leer, escribir y ejecutar en cualquier sitio donde pueda el proceso.
- Coste a escala
- El SDK es gratuito; el coste son los tokens de Claude a tarifas de API, y los bucles de agente con muchas llamadas a herramientas multiplican los tokens por tarea. Los planes Max, Ultra y Team incluyen créditos mensuales de API utilizables con una clave de Console vinculada.
- Límites
- Solo modelos Claude; API anterior a 1.0 con versiones frecuentes; las normas de marca prohíben llamar Claude Code a un producto; el bucle del agente no se puede modificar.
Lo bueno
- Las herramientas de archivos, shell y web de Claude Code desde el primer momento
- Herramientas propias como servidores MCP en proceso, sin proceso aparte
- Hooks, subagentes, sesiones y plugins heredados
- El mismo motor en la API, Bedrock, Google Cloud y Foundry
- Versiones frecuentes al ritmo de Claude Code
Lo malo
- El binario central es cerrado y se rige por los Commercial Terms de Anthropic
- Todas las herramientas disponibles por defecto; allowed_tools no restringe
- Solo modelos Claude
- Anterior a 1.0, con versiones cada pocos días
- Los productos no pueden ofrecer el inicio de sesión de claude.ai a sus usuarios
Ideal para
Desarrolladores que quieren un agente de programación o de trabajo con archivos al nivel de Claude Code dentro de su propio producto y han apostado por Claude.
Alternativas a Claude Agent SDK
Claude Agent SDK: preguntas frecuentes
- ¿Merece la pena Claude Agent SDK?
- No hay vía más rápida hacia un agente que ya sabe editar archivos y ejecutar comandos, siempre que aceptes Claude Code como un motor cerrado dentro de él. Le damos un 4.2 sobre 5.
- ¿Cuánto cuesta Claude Agent SDK?
- El envoltorio de Python es gratuito bajo licencia MIT; el binario de Claude Code incluido y el paquete de TypeScript se rigen por los Commercial Terms de Anthropic. Pagas el uso de la Claude API o consumes los límites de tu propio plan de Claude.
- ¿Qué inconvenientes tiene Claude Agent SDK?
- El binario central es cerrado y se rige por los Commercial Terms de Anthropic; todas las herramientas disponibles por defecto; allowed_tools no restringe; solo modelos Claude; anterior a 1.0, con versiones cada pocos días; los productos no pueden ofrecer el inicio de sesión de claude.ai a sus usuarios.
- ¿Para quién es Claude Agent SDK?
- Desarrolladores que quieren un agente de programación o de trabajo con archivos al nivel de Claude Code dentro de su propio producto y han apostado por Claude.
- ¿Cuánto cuesta Claude Agent SDK para un equipo o en producción?
- El SDK es gratuito; el coste son los tokens de Claude a tarifas de API, y los bucles de agente con muchas llamadas a herramientas multiplican los tokens por tarea. Los planes Max, Ultra y Team incluyen créditos mensuales de API utilizables con una clave de Console vinculada.
- ¿Es Claude Agent SDK seguro para los datos de la empresa?
- Se ejecuta en local con los permisos de su proceso y envía prompts y contenido de archivos a Claude según las condiciones de la API o del plan de la cuenta; el conjunto de herramientas por defecto puede leer, escribir y ejecutar en cualquier sitio donde pueda el proceso.
- ¿Cuáles son las mejores alternativas a Claude Agent SDK?
- Las alternativas más cercanas que hemos analizado son OpenAI Agents SDK, Pydantic AI, LangGraph y Google Agent Development Kit (ADK).
Respuestas comprobadas el 6 nov 2026.
¿Desarrollas Claude Agent SDK? Muestra esta nota en tu web
