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 se adaptan a diferentes necesidades. Utilice la tabla para encontrar el que coincida con lo que está construyendo.
| Si está... | Utilice | Por qué |
|---|---|---|
| Construyendo un agente sin implementar el bucle de herramientas usted mismo | Agent SDK | Una biblioteca de Python o TypeScript que ejecuta el bucle del agente por usted. |
| Realizando desarrollo interactivo o ejecutando tareas puntuales desde una terminal | Claude Code CLI | La interfaz de terminal, construida para uso interactivo diario. |
| Llamando a la API directamente e implementando el bucle de herramientas usted mismo | Client SDK | Acceso directo a la API de Anthropic en lugar de a Claude Code. Usted implementa el bucle de herramientas. |
| Ejecutando agentes de larga duración o asincronos sin gestionar su propia infraestructura de sandbox o sesión | Managed Agents | API REST alojada, un producto separado del Agent SDK. Anthropic ejecuta el agente y el sandbox. |
El SDK está disponible como biblioteca solo para Python y TypeScript. Para impulsar el mismo bucle de agente desde otro idioma, 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