Descripción general del Agent SDK
Construya agentes de IA en producción con Claude Code como una biblioteca
Un agente es una aplicación que completa una tarea planificando sus propios pasos y llamando a herramientas que leen archivos, ejecutan comandos o editan código. El Agent SDK le proporciona las mismas herramientas, bucle de agente, y gestión de contexto que potencian Claude Code, programable en Python y TypeScript.
Comparar el Agent SDK con otras herramientas de Claude
El Agent SDK, la CLI, el Client SDK y los Managed Agents difieren en quién ejecuta el agente, qué viene integrado y cómo acceder a él. Encuentre la fila que coincida con cómo desea construir y ejecutar el suyo.
| Desea | Utilice | Lo que obtiene |
|---|---|---|
| Integrar el agente de Claude Code en su propia aplicación Python o TypeScript, en un proceso que usted opera | Agent SDK | Una biblioteca que ejecuta el binario de Claude Code, con las capacidades de Claude Code, como herramientas integradas, permisos, sesiones y hooks. |
| Realizar desarrollo interactivo o ejecutar tareas puntuales desde una terminal | Claude Code CLI | La interfaz de terminal, construida para uso interactivo diario. |
| Llamar a la API de Claude directamente desde su propio código | Client SDK | Acceso directo a la API de Claude desde cualquiera de los lenguajes del Client SDK. Usted escribe el bucle de herramientas usted mismo, o deja que el ejecutor de herramientas beta del Client SDK lo impulse. |
| Tener que Anthropic aloje el agente, configurado a través de la API de Claude | Managed Agents | Un arnés de agente alojado que ejecuta el bucle del agente, con sesiones en un sandbox en la nube administrado por Anthropic o un sandbox autohospedado en su propia infraestructura. Úselo desde el SDK para su lenguaje, la CLI ant, o la API REST. |
Para impulsar el mismo bucle de agente desde un lenguaje distinto a Python o TypeScript, ejecute la CLI como un subproceso con la bandera -p y --output-format json.
Capacidades
Estas capacidades de Claude Code están disponibles en el SDK:
| Capacidad | Qué hace | Más información |
|---|---|---|
| Herramientas integradas | Leer, escribir, editar archivos, ejecutar comandos y buscar en la web | Referencia de herramientas |
| Hooks | Ejecutar código personalizado en puntos clave del ciclo de vida del agente | Hooks |
| Subagentes | Generar agentes especializados para subtareas enfocadas | Subagentes |
| MCP | Conectar herramientas y fuentes de datos externas a través del Protocolo de Contexto del Modelo | MCP |
| Permisos | Controlar qué herramientas se ejecutan automáticamente, cuáles necesitan aprobación | Permisos |
| Sesiones | Mantener contexto en múltiples intercambios, reanudar o dividir más tarde | Sesiones |
| Skills, comandos y memoria | Cargar automáticamente desde .claude/ de su proyecto y desde ~/.claude/, igual que Claude Code |
Skills, Comandos, Memoria, Carga de configuración |
| Plugins | Empaquetar skills, agentes, hooks y servidores MCP, y cargarlos por ruta local | Plugins |
Comenzar
Siga el Quickstart para instalar el SDK, establecer su clave de API y construir su primer agente, uno que encuentre y corrija errores en código existente.
Registro de cambios
Vea el registro de cambios completo para actualizaciones del SDK, correcciones de errores y nuevas características:
- TypeScript SDK: ver CHANGELOG.md
- Python SDK: ver CHANGELOG.md
Reportar errores
Si encuentra errores o problemas con el Agent SDK:
- TypeScript SDK: reportar problemas en GitHub
- Python SDK: reportar problemas en GitHub
Directrices de marca
Para socios que integran el Claude Agent SDK, el uso de la marca Claude es opcional. Al hacer referencia a Claude en su producto:
Permitido:
- "Claude Agent", preferido para menús desplegables
- "Claude", cuando ya está dentro de un menú etiquetado como "Agents"
- "{YourAgentName} Powered by Claude", si tiene un nombre de agente existente
No permitido:
- "Claude Code" o "Claude Code Agent"
- Arte ASCII de marca Claude Code o elementos visuales que imiten Claude Code
Su producto debe mantener su propia marca y no parecer ser Claude Code o ningún producto de Anthropic. Para preguntas sobre cumplimiento de marca, póngase en contacto con el equipo de ventas de Anthropic.
Licencia y términos
El uso del Claude Agent SDK se rige por los Términos de Servicio Comerciales de Anthropic, incluso cuando lo utiliza para potenciar productos y servicios que pone a disposición de sus propios clientes y usuarios finales, excepto en la medida en que un componente específico o dependencia esté cubierto por una licencia diferente como se indica en el archivo LICENSE de ese componente.
Próximos pasos
Estos recursos cubren detalles técnicos más profundos y proyectos de ejemplo para construir con el Agent SDK.
- Inicio rápido: construya su primer agente que encuentre y corrija errores
- Guía de migración: migre desde los paquetes del Claude Code SDK al Agent SDK
- Bucle de agente: cómo Claude planifica, llama herramientas y decide cuándo se completa una tarea
- Agentes de ejemplo: aplicaciones de demostración para desarrollo local
- SDK de TypeScript: referencia completa de API de TypeScript y ejemplos
- SDK de Python: referencia completa de API de Python y ejemplos
- Diseño del arnés de agente: cómo el equipo de Claude Code utiliza flujos de trabajo dinámicos para orquestar muchos subagentes a la vez