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

​
Opciones del SDK

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

​
Conceptos Fundamentales

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

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

​
Casos de Uso Comunes

​
Pruebas Automatizadas y CI/CD

Crea agentes que ejecuten pruebas, analicen resultados y solucionen problemas automáticamente en tu pipeline de CI/CD.

​
Revisión de Código y Auditorías de Seguridad

Construye agentes que revisen pull requests en busca de vulnerabilidades de seguridad, calidad de código y cumplimiento.

​
Respuesta a Incidentes

Despliega agentes SRE que diagnostiquen problemas de producción, analicen logs y sugieran soluciones.

​
Generación de Documentación

Crea agentes que generen y mantengan documentación basada en tu base de código.

​
Análisis de Datos

Construye agentes que analicen datos, generen informes y creen visualizaciones.

​
Mejores Prácticas

  • Usa formato de salida JSON para análisis programático de respuestas
  • Maneja errores con gracia - verifica códigos de salida e implementa lógica de reintento
  • Usa gestión de sesiones para mantener contexto en conversaciones de múltiples turnos
  • Implementa timeouts para operaciones de larga duración
  • Respeta los límites de velocidad al hacer múltiples solicitudes
  • Prueba exhaustivamente antes de desplegar a producción

​
Recursos Relacionados