Skill de la API de Claude

La skill claude-api es una 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, 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 8 lenguajes de programación tanto para la Messages API como para Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby y cURL.

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

La skill utiliza divulgación progresiva para mantener el contexto eficiente: Claude carga únicamente 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 la skill

Cuando se activa, la skill equipa a Claude con:

Para la Messages API:

• Documentación de 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 a 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 con un 50 % de descuento en el 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 de Claude más recientes (incluidos los cambios incompatibles y los cambios de comportamiento en Claude Opus 4.8)
• Información actual de modelos: IDs de modelo, tamaños de ventana de contexto y precios
• Errores comunes: Orientación detallada para evitar errores frecuentes al integrar 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 mediante el 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érdida, 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). La skill redirige otros despliegues a la Messages API y al uso de herramientas en su lugar.



Cuándo se activa la skill

La 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 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 de modelo

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

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



Lenguajes compatibles

La 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 correspondiente.

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



Cómo usar la skill



En Claude Code (incluida)

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

También puedes invocarla directamente:

/claude-api

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



Desde el repositorio de skills

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

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

O instalarla 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

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

/claude-api migrate this project to claude-opus-4-8

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

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

Cuando el alcance es ambiguo (por ejemplo, un simple /claude-api migrate to claude-opus-4-8), la 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.

La skill maneja:

• Reemplazos de ID de modelo, incluidas las constantes tipadas del SDK (Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8) en todos los lenguajes compatibles, y clasifica cada archivo como llamador, definidor de modelo o referencia de cadena opaca antes de editarlo
• 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 mensaje del asistente a salidas estructuradas cuando corresponda
• Limpieza de encabezados beta, eliminando encabezados que ya son de disponibilidad general (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 para output_config.effort en el modelo de destino (por ejemplo, xhigh para casos de uso de programación y agénticos en Claude Opus 4.8 y Claude Opus 4.7)
• Ajuste de 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 activar la resumición 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 (el parámetro fallbacks del lado del servidor, el middleware de fallback ante rechazos del SDK o un reintento con crédito de fallback), y actualizando el código de fallback escrito contra formas de vista previa anteriores

A medida que edita, la 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 reestablecimiento de líneas base de costo/límite de velocidad).

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



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

La skill ejecuta una entrevista que te guía a través del modelo mental de Managed Agents (configuraciones de Agent versus Sessions), 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. La 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 la 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-4-8 and re-tune effort

Incorporar un nuevo Managed Agent:

/claude-api managed-agents-onboard

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



Próximos pasos