Descripción general del Agent SDK

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:

• SDK de TypeScript - Para aplicaciones de Node.js y web
• SDK de Python - Para aplicaciones de Python y ciencia de datos
• Modo de transmisión vs modo único - Comprender los modos de entrada y las mejores prácticas

¿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.

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:

• SDK de TypeScript: Reporta problemas en GitHub
• SDK de Python: Reporta problemas en GitHub

Registro de cambios

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

• SDK de TypeScript: Ver CHANGELOG.md
• SDK de Python: Ver CHANGELOG.md

Recursos relacionados

• Referencia de CLI - Documentación completa de CLI
• Integración de GitHub Actions - Automatiza tu flujo de trabajo de GitHub
• Documentación de MCP - Extiende Claude con herramientas personalizadas
• Flujos de trabajo comunes - Guías paso a paso
• Solución de problemas - Problemas comunes y soluciones