​
Opciones del SDK

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

​
¿Por qué usar el SDK de Claude Code?

Construido sobre el arnés de agentes que impulsa Claude Code, el SDK de Claude Code proporciona todos los bloques de construcción que necesitas para construir agentes listos para producción:

  • Integración optimizada de Claude: Caché automático de prompts y optimizaciones de rendimiento
  • Ecosistema rico de herramientas: Operaciones de archivos, ejecución de código, búsqueda web y extensibilidad 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

​
¿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 solucionan problemas de producción
  • Bots de revisión de seguridad que auditan código en busca de vulnerabilidades
  • Asistentes de ingeniería de guardia que clasifican incidentes
  • Agentes de revisión de código que hacen cumplir el estilo y las mejores prácticas

Agentes de negocio:

  • Asistentes legales que revisan contratos y cumplimiento
  • 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 Centrales

​
Autenticación

Para autenticación básica, obtén una clave API de Anthropic desde la Consola de Anthropic y establece la variable de entorno ANTHROPIC_API_KEY.

El SDK también soporta 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 instrucciones detalladas de configuración 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 sistema de archivos:

  • Subagentes: Lanza agentes especializados almacenados como archivos Markdown en ./.claude/agents/
  • 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/
  • Memoria (CLAUDE.md): Mantén el contexto del proyecto a través de archivos CLAUDE.md que proporcionan instrucciones y contexto persistentes

Estas características funcionan de manera idéntica a sus contrapartes de Claude Code leyendo desde las mismas ubicaciones del sistema de archivos.

​
Prompts del Sistema

Los prompts del sistema definen el rol, experiencia y 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 general de permisos

​
Protocolo de Contexto de Modelo (MCP)

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

​
Recursos Relacionados