Agent SDK

Descripción general del Agent SDK

Construye agentes de IA en producción con Claude Code como una biblioteca

El Claude Code SDK ha sido renombrado a Claude Agent SDK. Si estás migrando desde el SDK anterior, consulta la Guía de migración.

Construye agentes de IA que leen archivos de forma autónoma, ejecutan comandos, buscan en la web, editan código y más. El Agent SDK te proporciona las mismas herramientas, bucle de agente y gestión de contexto que potencian Claude Code, programable en Python y TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

El Agent SDK incluye herramientas integradas para leer archivos, ejecutar comandos y editar código, para que tu agente pueda comenzar a trabajar inmediatamente sin que tengas que implementar la ejecución de herramientas. Sumérgete en el inicio rápido o explora agentes reales construidos con el SDK:

Inicio rápido

Construye un agente corrector de errores en minutos

Agentes de ejemplo

Asistente de correo electrónico, agente de investigación y más

Comenzar

Instala el SDK
Establece tu clave de API
Obtén una clave de API de la Consola, luego establécela como una variable de entorno:
export ANTHROPIC_API_KEY=your-api-key
El SDK también admite autenticación a través de proveedores de API de terceros:
- Amazon Bedrock: establece la variable de entorno CLAUDE_CODE_USE_BEDROCK=1 y configura las credenciales de AWS
- Google Vertex AI: establece la variable de entorno CLAUDE_CODE_USE_VERTEX=1 y configura las credenciales de Google Cloud
- Microsoft Azure: establece la variable de entorno CLAUDE_CODE_USE_FOUNDRY=1 y configura las credenciales de Azure
Consulta las guías de configuración para Bedrock, Vertex AI o Azure AI Foundry para obtener más detalles.
A menos que haya sido aprobado previamente, 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 Claude Agent SDK. Por favor, utiliza los métodos de autenticación de clave de API descritos en este documento en su lugar.

Ejecuta tu primer agente

Este ejemplo crea un agente que lista archivos en tu directorio actual usando herramientas integradas.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

¿Listo para construir? Sigue el Inicio rápido para crear un agente que encuentre y corrija errores en minutos.

Capacidades

Todo lo que hace que Claude Code sea poderoso está disponible en el SDK:

Características de Claude Code

El SDK también admite la configuración basada en el sistema de archivos de Claude Code. Para usar estas características, establece setting_sources=["project"] (Python) o settingSources: ['project'] (TypeScript) en tus opciones.

Característica	Descripción	Ubicación
Skills	Capacidades especializadas definidas en Markdown	`.claude/skills/SKILL.md`
Slash commands	Comandos personalizados para tareas comunes	`.claude/commands/*.md`
Memory	Contexto e instrucciones del proyecto	`CLAUDE.md` o `.claude/CLAUDE.md`
Plugins	Extiende con comandos personalizados, agentes y servidores MCP	Programático a través de la opción `plugins`

Compara el Agent SDK con otras herramientas de Claude

La plataforma Claude ofrece múltiples formas de construir con Claude. Aquí te mostramos cómo se ajusta el Agent SDK:

Registro de cambios

Ver 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 encuentras errores o problemas con el Agent SDK:

TypeScript SDK: reporta problemas en GitHub
Python SDK: reporta 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 tu 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 tienes 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

Tu producto debe mantener su propia marca y no parecer ser Claude Code o ningún producto de Anthropic. Para preguntas sobre cumplimiento de marca, contacta a nuestro equipo de ventas.

Licencia y términos

El uso del Claude Agent SDK se rige por los Términos de Servicio Comerciales de Anthropic, incluso cuando lo usas para potenciar productos y servicios que pones a disposición de tus 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

Inicio rápido

Construye un agente que encuentre y corrija errores en minutos

Agentes de ejemplo

Asistente de correo electrónico, agente de investigación y más

TypeScript SDK

Referencia completa de API de TypeScript y ejemplos

Python SDK

Referencia completa de API de Python y ejemplos

Was this page helpful?

Agent SDK

Descripción general del Agent SDK

Construye agentes de IA en producción con Claude Code como una biblioteca

El Claude Code SDK ha sido renombrado a Claude Agent SDK. Si estás migrando desde el SDK anterior, consulta la Guía de migración.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Inicio rápido

Construye un agente corrector de errores en minutos

Agentes de ejemplo

Asistente de correo electrónico, agente de investigación y más

Comenzar

Instala el SDK
Establece tu clave de API
Obtén una clave de API de la Consola, luego establécela como una variable de entorno:
export ANTHROPIC_API_KEY=your-api-key
El SDK también admite autenticación a través de proveedores de API de terceros:
- Amazon Bedrock: establece la variable de entorno CLAUDE_CODE_USE_BEDROCK=1 y configura las credenciales de AWS
- Google Vertex AI: establece la variable de entorno CLAUDE_CODE_USE_VERTEX=1 y configura las credenciales de Google Cloud
- Microsoft Azure: establece la variable de entorno CLAUDE_CODE_USE_FOUNDRY=1 y configura las credenciales de Azure
Consulta las guías de configuración para Bedrock, Vertex AI o Azure AI Foundry para obtener más detalles.
A menos que haya sido aprobado previamente, 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 Claude Agent SDK. Por favor, utiliza los métodos de autenticación de clave de API descritos en este documento en su lugar.

Ejecuta tu primer agente

Este ejemplo crea un agente que lista archivos en tu directorio actual usando herramientas integradas.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

¿Listo para construir? Sigue el Inicio rápido para crear un agente que encuentre y corrija errores en minutos.

Capacidades

Todo lo que hace que Claude Code sea poderoso está disponible en el SDK:

Características de Claude Code

Característica	Descripción	Ubicación
Skills	Capacidades especializadas definidas en Markdown	`.claude/skills/SKILL.md`
Slash commands	Comandos personalizados para tareas comunes	`.claude/commands/*.md`
Memory	Contexto e instrucciones del proyecto	`CLAUDE.md` o `.claude/CLAUDE.md`
Plugins	Extiende con comandos personalizados, agentes y servidores MCP	Programático a través de la opción `plugins`

Compara el Agent SDK con otras herramientas de Claude

La plataforma Claude ofrece múltiples formas de construir con Claude. Aquí te mostramos cómo se ajusta el Agent SDK:

Registro de cambios

Ver 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 encuentras errores o problemas con el Agent SDK:

TypeScript SDK: reporta problemas en GitHub
Python SDK: reporta 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 tu 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 tienes 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

Tu producto debe mantener su propia marca y no parecer ser Claude Code o ningún producto de Anthropic. Para preguntas sobre cumplimiento de marca, contacta a nuestro equipo de ventas.

Licencia y términos

Próximos pasos

Inicio rápido

Construye un agente que encuentre y corrija errores en minutos

Agentes de ejemplo

Asistente de correo electrónico, agente de investigación y más

TypeScript SDK

Referencia completa de API de TypeScript y ejemplos

Python SDK

Referencia completa de API de Python y ejemplos

Was this page helpful?