Skill de la Claude API

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

• Messages API: La superficie principal para solicitudes individuales, chat con streaming, "tool use" (uso de herramientas), procesamiento por lotes, "prompt caching" (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 administrados 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 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, desde donde puedes instalarlo en cualquier entorno que admita Agent Skills.

El skill usa "progressive disclosure" (revelació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
• Orientación sobre uso de herramientas: Ejemplos específicos del lenguaje y fundamentos conceptuales para la llamada de funciones, incluido el tool runner beta donde esté disponible
• Patrones de streaming: Detalles de implementación para crear 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, ubicación de puntos de interrupción y auditoría de invalidadores silenciosos
• Migración de modelos: Orientación paso a paso para migrar a modelos Claude más recientes (incluidos los cambios incompatibles y los cambios de comportamiento en Claude Opus 5 y Claude Fable 5.1)
• Información actual de modelos: IDs de modelos, tamaños de "context window" (ventana de contexto) y precios
• Errores comunes: Orientación 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 con processed_at, manejo de interrupciones, problemas comunes con el montaje de archivos y manejo de credenciales
• Restricciones de despliegue: Managed Agents está disponible únicamente en la Claude API y en Claude Platform on AWS (no en Amazon Bedrock, Google Cloud ni Microsoft Foundry). El skill redirige otros 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 crear, depurar u optimizar algo con la Claude API, 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

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

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

Lenguajes compatibles

El skill detecta automáticamente el lenguaje de tu proyecto 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 crear algo con la Claude API, o cuando tu proyecto ya importa un SDK de Anthropic, el skill se activa automáticamente.

También puedes invocarlo directamente:

/claude-api

Para obtener 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 Claude más reciente

El skill de la Claude API puede realizar migraciones de modelos 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 desde el principio para omitir la pregunta de confirmación del 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 todo el directorio de trabajo, un subdirectorio específico o una lista explícita de archivos antes de editar cualquier archivo. Esto aplica tanto a quienes llaman a la Messages API como a Managed Agents.

El skill se encarga de:

• 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 cada 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 los patrones de prefill de mensajes del asistente a salidas estructuradas donde corresponda
• Limpieza de encabezados beta, eliminando los encabezados beta que el modelo de destino no requiere (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 del 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 los 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 activar el resumen del 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 fallback ante rechazos, agregando el manejo de stop_reason: "refusal" antes de leer el contenido de la respuesta y configurando una ruta de reintento de fallback cuando el destino es Claude Fable 5.1, Claude Fable 5 o Claude Opus 5 (el parámetro fallbacks del lado del servidor, normalmente en su modo "default", el middleware de fallback ante rechazos del SDK o un reintento con crédito de fallback), y actualizando el código de fallback escrito para formas de vista previa anteriores

A medida que edita, el skill explica cada cambio y su motivación en línea. Al finalizar, produce una lista de verificación de elementos que requieren verificación manual (normalmente pruebas de integración, ajuste de prompts de control de longitud y recalibración de la línea base de costos y "rate limits" (límites de velocidad)).

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

Configurar un Managed Agent

Para generar 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 Agent frente a Sessions), crea una plantilla de configuración de agente, configura entornos y herramientas, establece el bucle de sesión y genera código ejecutable para tu lenguaje. El skill también cubre el flujo obligatorio Agent (una vez) → Session (cada ejecución): model, system y tools residen en el agente, nunca en la sesión, y los agentes deben crearse una sola 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.*.

Ejemplos de uso

Estos son ejemplos de tareas que el skill ayuda a Claude a manejar:

Crear 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 específica del lenguaje correspondiente y guía a Claude a través de la implementación usando los patrones y mejores prácticas actuales de la API.

Próximos pasos