SpyBara
Go Premium

agent-sdk/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

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.

[!NOTE]

A menos que haya sido previamente aprobado, Anthropic no permite que desarrolladores de terceros ofrezcan inicio de sesión en claude.ai o límites de velocidad para sus productos, incluidos los agentes construidos en el Agent SDK de Claude. En su lugar, utilice los métodos de autenticación de clave de API descritos en el Quickstart.

Registro de cambios

Vea el registro de cambios completo para actualizaciones del SDK, correcciones de errores y nuevas características:

Reportar errores

Si encuentra errores o problemas con el Agent SDK:

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.