Skill de la API de Claude

El skill claude-api es un Agent Skill de código abierto que proporciona a Claude material de referencia detallado y actualizado para construir aplicaciones en dos superficies de Anthropic:

• Messages API: La superficie principal para solicitudes individuales, chat con streaming, uso de herramientas, procesamiento por lotes, almacenamiento en caché de prompts, salidas estructuradas y bucles de agente personalizados.
• Claude Managed Agents (beta): Una superficie alojada por Anthropic para agentes con estado gestionados por el servidor, con ejecución de herramientas alojada por Anthropic, configuraciones de agente persistentes y sandboxes por sesión.

Cubre ocho lenguajes de programación tanto para la Messages API como para los Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby y cURL.

El skill viene incluido con Claude Code y también está disponible en el repositorio de skills de Anthropic de código abierto, donde puedes instalarlo en cualquier entorno que admita Agent Skills.

El skill utiliza divulgación progresiva para mantener el contexto eficiente: Claude carga solo la documentación relevante para el lenguaje de tu proyecto, la superficie (Messages API o Managed Agents) y la tarea específica en cuestión (uso de herramientas, streaming, lotes, etc.), en lugar de cargar todo a la vez.



Qué proporciona el skill

Cuando se activa, el skill equipa a Claude con:

Para la Messages API:

• Documentación del SDK específica del lenguaje: Instalación, inicio rápido, patrones comunes y manejo de errores para el lenguaje de tu proyecto
• Guía de uso de herramientas: Ejemplos específicos del lenguaje y fundamentos conceptuales para la llamada a funciones, incluido el tool runner beta donde esté disponible
• Patrones de streaming: Detalles de implementación para construir interfaces de chat y manejar la visualización incremental
• Procesamiento por lotes: Procesamiento por lotes sin conexión al 50% del costo
• Almacenamiento en caché de prompts: Diseño de estabilidad de prefijos, colocación de puntos de interrupción y auditoría de invalidadores silenciosos
• Migración de modelos: Guía paso a paso para migrar a modelos de Claude más recientes (incluidos los cambios incompatibles y los cambios de comportamiento en Claude Opus 5)
• Información actual de modelos: IDs de modelos, tamaños de ventana de contexto y precios
• Errores comunes: Guía detallada para evitar errores frecuentes al integrarse con la API

Para Managed Agents (beta):

• Flujo de incorporación: Un recorrido guiado por entrevista para configurar un nuevo Managed Agent desde cero, disponible a través del subcomando /claude-api managed-agents-onboard
• Documentación de Managed Agents específica del lenguaje: Creación de agentes persistentes, inicio de sesiones, streaming de eventos y manejo de confirmaciones de herramientas para Python, TypeScript, C#, Go, Java, PHP, Ruby y cURL
• Patrones de cliente: Reconexión de stream sin pérdidas, compuerta de encolado/procesado processed_at, manejo de interrupciones, problemas comunes de montaje de archivos y manejo de credenciales
• Restricciones de despliegue: Managed Agents está disponible únicamente en la API de Claude y en Claude Platform on AWS (no en Amazon Bedrock, Google Cloud ni Microsoft Foundry). El skill dirige los demás despliegues a la Messages API y al uso de herramientas en su lugar.



Cuándo se activa el skill

El skill se activa de dos maneras:

La activación automática ocurre cuando:

• Tu código importa un SDK de Anthropic (anthropic para Python, @anthropic-ai/sdk para TypeScript/JavaScript)
• Le pides a Claude que te ayude a construir, depurar u optimizar algo con la API de Claude, un SDK de Anthropic o Managed Agents
• Agregas, modificas o ajustas una funcionalidad de Claude en un archivo (almacenamiento en caché de prompts, pensamiento adaptativo, compactación, uso de herramientas, lotes, archivos, citas, memoria) o una referencia a un modelo

Invocación manual escribiendo /claude-api (con un subcomando opcional o texto libre) en cualquier entorno donde el skill esté instalado.

El skill no se activa para tareas de programación generales, trabajo de ML/ciencia de datos, o código que importa otros SDKs de IA (como OpenAI).



Lenguajes compatibles

El skill detecta el lenguaje de tu proyecto automáticamente examinando los archivos del proyecto (por ejemplo, requirements.txt para Python, tsconfig.json para TypeScript, go.mod para Go) y carga la documentación apropiada.

Si tu proyecto usa varios lenguajes, Claude pregunta cuál aplica. Para lenguajes no compatibles (Rust, Swift, C++), el skill proporciona ejemplos de cURL/HTTP sin procesar.



Cómo usar el skill



En Claude Code (incluido)

El skill se distribuye con Claude Code y no requiere instalación. Cuando le pides a Claude que te ayude a construir algo con la API de Claude, o cuando tu proyecto ya importa un SDK de Anthropic, el skill se activa automáticamente.

También puedes invocarlo directamente:

/claude-api

Para más información sobre cómo funcionan los skills incluidos en Claude Code, consulta la documentación de skills de Claude Code.



Desde el repositorio de skills

El código fuente del skill está disponible en el repositorio de skills de Anthropic. Puedes instalarlo usando el comando npx:

npx skills add https://github.com/anthropics/skills --skill claude-api

O instalarlo como un plugin de Claude Code:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills



Migrar a un modelo de Claude más reciente

El skill de la API de Claude puede realizar migraciones de modelos de Claude en toda una base de código. Invócalo directamente con /claude-api migrate:

/claude-api migrate this project to claude-opus-5

También puedes pasar un alcance específico por adelantado para omitir la pregunta de confirmación de alcance:

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

Cuando el alcance es ambiguo (por ejemplo, un simple /claude-api migrate to claude-opus-5), el skill te pide que elijas entre el directorio de trabajo completo, un subdirectorio específico o una lista explícita de archivos antes de editar cualquier archivo. Esto aplica tanto a los llamadores de la Messages API como a los de Managed Agents.

El skill maneja:

• Reemplazos de IDs de modelo, incluidas las constantes tipadas del SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5) en todos los lenguajes compatibles, y clasifica cada archivo como un llamador, un definidor de modelo o una referencia de cadena opaca antes de editar
• Detección de plataforma en la nube, preservando los formatos de ID de modelo específicos de la plataforma (por ejemplo, el prefijo anthropic. en Amazon Bedrock) y omitiendo cambios para funcionalidades que no están disponibles en plataformas operadas por socios
• Cambios incompatibles de parámetros, como eliminar temperature, top_p y top_k para Claude Opus 4.8 y Claude Opus 4.7, y convertir thinking: {type: "enabled", budget_tokens: N} a thinking: {type: "adaptive"}
• Reemplazo de prefill, convirtiendo patrones de prefill de mensajes del asistente a salidas estructuradas donde sea aplicable
• Limpieza de encabezados beta, eliminando encabezados que son GA en el modelo de destino (por ejemplo, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) y volviendo de client.beta.messages.create a client.messages.create
• Calibración de esfuerzo, recomendando un punto de partida de output_config.effort para el modelo de destino (por ejemplo, el valor predeterminado high en Claude Opus 5, y xhigh para casos de uso de programación y agénticos en Claude Opus 4.8 y Claude Opus 4.7)
• Ajuste del comportamiento de prompts, señalando prompts de control de longitud, activación de herramientas, subagentes y seguimiento de instrucciones que pueden comportarse de manera diferente en el modelo de destino
• Manejo de valores predeterminados silenciosos, volviendo a optar por el resumen de pensamiento (thinking.display: "summarized") cuando el razonamiento se muestra a los usuarios en Claude Opus 4.8 y Claude Opus 4.7
• Configuración de respaldo ante rechazos, agregando el manejo de stop_reason: "refusal" antes de leer el contenido de la respuesta y configurando una ruta de reintento de respaldo cuando el destino es Claude Fable 5 o Claude Opus 5 (el parámetro fallbacks del lado del servidor, típicamente en su modo "default", el middleware de respaldo ante rechazos del SDK, o un reintento con crédito de respaldo), y actualizando el código de respaldo escrito contra formas de vista previa anteriores

A medida que edita, el skill explica cada cambio y su motivación en línea. Al completarse, produce una lista de verificación de elementos que requieren verificación manual (típicamente pruebas de integración, ajuste de prompts de control de longitud y recalibración de costos/límites de velocidad).

Para la lista completa de cambios específicos del modelo que aplica el skill, consulta Migrar a Claude Opus 5 desde Claude Opus 4.8.



Configurar un Managed Agent

Para crear la estructura de un nuevo Managed Agent desde cero, invoca el subcomando managed-agents-onboard:

/claude-api managed-agents-onboard

El skill ejecuta una entrevista que te guía a través del modelo mental de Managed Agents (configuraciones de Agente versus Sesiones), crea una plantilla de configuración de agente, configura entornos y herramientas, establece el bucle de sesión y emite código ejecutable para tu lenguaje. El skill también cubre el flujo obligatorio Agente (una vez) → Sesión (cada ejecución): model, system y tools viven en el agente, nunca en la sesión, y los agentes deben crearse una vez y referenciarse por ID.

Managed Agents requiere el encabezado beta managed-agents-2026-04-01, que el SDK establece automáticamente para todas las llamadas a client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* y client.beta.vaults.*.



Ejemplo de uso

Aquí hay ejemplos de tareas que el skill ayuda a Claude a manejar:

Construir una aplicación de chat:

Build a streaming chat UI with the Claude API in TypeScript

Migrar un proyecto existente:

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

Incorporar un nuevo Managed Agent:

/claude-api managed-agents-onboard

En cada caso, el skill carga la documentación relevante específica del lenguaje y guía a Claude a través de la implementación usando patrones actuales de la API y mejores prácticas.



Próximos pasos