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.

​
Instalación

npm install @anthropic-ai/claude-agent-sdk

​
Opciones del SDK

El Claude Agent SDK está disponible en múltiples formas para adaptarse a diferentes casos de uso:

​
¿Por qué usar el Claude Agent SDK?

Construido sobre el arnés de agentes que impulsa Claude Code, el Claude Agent SDK proporciona todos los bloques de construcción que necesitas para crear agentes listos para producción. Aprovechando el trabajo que hemos realizado en Claude Code, incluyendo:
  • Gestión de contexto: Compactación automática y gestión de contexto para asegurar que tu agente no se quede sin contexto.
  • Ecosistema de herramientas enriquecido: Operaciones de archivos, ejecución de código, búsqueda web y extensibilidad de MCP
  • Permisos avanzados: Control granular sobre las capacidades del agente
  • Elementos esenciales de producción: Manejo de errores integrado, gestión de sesiones y monitoreo
  • Integración optimizada de Claude: Almacenamiento en caché automático de indicaciones y optimizaciones de rendimiento

​
¿Qué puedes construir con el SDK?

Aquí hay algunos tipos de agentes de ejemplo que puedes crear: Agentes de codificación:
  • Agentes SRE que diagnostican y corrigen problemas de producción
  • Bots de revisión de seguridad que auditan código en busca de vulnerabilidades
  • Asistentes de ingeniería oncall que clasifican incidentes
  • Agentes de revisión de código que aplican estilo y mejores prácticas
Agentes comerciales:
  • Asistentes legales que revisan contratos y cumplimiento normativo
  • Asesores financieros que analizan informes y pronósticos
  • Agentes de soporte al cliente que resuelven problemas técnicos
  • Asistentes de creación de contenido para equipos de marketing

​
Conceptos principales

​
Autenticación

Para la autenticación básica, recupera una clave de API de Claude desde la Consola de Claude y establece la variable de entorno ANTHROPIC_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
Para obtener instrucciones de configuración detalladas para proveedores de terceros, consulta la documentación de Amazon Bedrock y Google Vertex AI.
A menos que haya sido aprobado previamente, no permitimos que desarrolladores de terceros apliquen límites de velocidad de Claude.ai para sus productos, incluidos 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.

​
Soporte completo de características de Claude Code

El SDK proporciona acceso a todas las características predeterminadas disponibles en Claude Code, aprovechando la misma configuración basada en el sistema de archivos:
  • Subagenetes: Lanza agentes especializados almacenados como archivos Markdown en ./.claude/agents/
  • Habilidades del agente: Extiende Claude con capacidades especializadas almacenadas como archivos SKILL.md en ./.claude/skills/
  • Hooks: Ejecuta comandos personalizados configurados en ./.claude/settings.json que responden a eventos de herramientas
  • Comandos de barra: Usa comandos personalizados definidos como archivos Markdown en ./.claude/commands/
  • Plugins: Carga plugins personalizados programáticamente usando la opción plugins para extender Claude Code con comandos personalizados, agentes, habilidades, hooks y servidores MCP. Consulta Plugins para obtener detalles.
  • Memoria (CLAUDE.md): Mantén el contexto del proyecto a través de archivos CLAUDE.md o .claude/CLAUDE.md en tu directorio de proyecto, o ~/.claude/CLAUDE.md para instrucciones a nivel de usuario. Para cargar estos archivos, debes establecer explícitamente settingSources: ['project'] (TypeScript) o setting_sources=["project"] (Python) en tus opciones. Consulta Modificar indicaciones del sistema para obtener detalles.
Estas características funcionan de manera idéntica a sus contrapartes de Claude Code al leer desde las mismas ubicaciones del sistema de archivos.

​
Indicaciones del sistema

Las indicaciones del sistema definen el rol, la experiencia y el comportamiento de tu agente. Aquí es donde especificas qué tipo de agente estás construyendo.

​
Permisos de herramientas

Controla qué herramientas puede usar tu agente con permisos granulares:
  • allowedTools - Permite explícitamente herramientas específicas
  • disallowedTools - Bloquea herramientas específicas
  • permissionMode - Establece la estrategia de permisos general

​
Protocolo de contexto del modelo (MCP)

Extiende tus agentes con herramientas e integraciones personalizadas a través de servidores MCP. Esto te permite conectarte a bases de datos, APIs y otros servicios externos.

​
Reportar errores

Si encuentras errores o problemas con el Agent SDK:

​
Registro de cambios

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

​
Recursos relacionados