Habilidad de API de Claude

La habilidad claude-api es una Habilidad de Agente 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 únicas, chat en streaming, uso de herramientas, procesamiento por lotes, almacenamiento en caché de indicaciones, salidas estructuradas y bucles de agentes personalizados.
• Claude Managed Agents (beta) — una superficie de primera parte para agentes con estado administrados por servidor con ejecución de herramientas alojada en Anthropic, configuraciones de agentes persistentes y contenedores por sesión.

Cubre 8 lenguajes de programación para la Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP y cURL) y 7 lenguajes para Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP y cURL — C# no es compatible actualmente).

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

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

Lo que proporciona la habilidad

Cuando se activa, la habilidad 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
• Guía de uso de herramientas: Ejemplos específicos del lenguaje y fundamentos conceptuales para llamadas de función, incluido el ejecutor de herramientas 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% de costo
• Almacenamiento en caché de indicaciones: Diseño de estabilidad de prefijo, colocación de puntos de interrupción y auditoría de invalidador silencioso
• Migración de modelos: Guía paso a paso para migrar a modelos Claude más nuevos (incluidos los cambios importantes y cambios de comportamiento en Claude Opus 4.7)
• Información del modelo actual: IDs de modelo, tamaños de ventana de contexto y precios
• Guía detallada sobre cómo 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 a través del subcomando /claude-api managed-agents-onboard
• Documentación de Managed Agents específica del lenguaje: Crear agentes persistentes, iniciar sesiones, transmitir eventos y manejar confirmaciones de herramientas para Python, TypeScript, Java, Go, Ruby, PHP y cURL
• Patrones de cliente: Reconexión de flujo sin pérdida, puerta de cola/procesado processed_at, manejo de interrupciones, gotchas de montaje de archivos y manejo de credenciales
• Restricciones de implementación: Managed Agents es solo de primera parte (no disponible en Amazon Bedrock, Google Vertex AI o Microsoft Foundry) — la habilidad enruta implementaciones de terceros a Messages API + uso de herramientas en su lugar

Cuándo se activa la habilidad

La habilidad se activa de dos formas:

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 ayude a construir, depurar u optimizar algo con la API de Claude, un SDK de Anthropic o Managed Agents
• Agregas, modificas o ajustas una característica de Claude en un archivo (almacenamiento en caché de indicaciones, pensamiento adaptativo, compactación, uso de herramientas, lote, archivos, citas, memoria) o una referencia de modelo

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

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

Lenguajes admitidos

La habilidad detecta automáticamente el lenguaje de tu proyecto examinando 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 utiliza varios lenguajes, Claude pregunta cuál se aplica. Para lenguajes no admitidos (Rust, Swift, C++), la habilidad proporciona ejemplos de cURL/HTTP sin procesar.

Cómo usar la habilidad

En Claude Code (incluida)

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

También puedes invocarla directamente:

/claude-api

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

Desde el repositorio de habilidades

El código fuente de la habilidad está disponible en el repositorio de habilidades de Anthropic. Puedes instalarlo usando el comando npx:

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

O instálalo como un plugin de Claude Code:

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

Migración a un modelo Claude más nuevo

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

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

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-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7

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

La habilidad maneja:

• Intercambios de ID de modelo, incluidas constantes de SDK tipadas (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) en todos los lenguajes admitidos, y clasifica cada archivo como un llamador, un definidor de modelo o una referencia de cadena opaca antes de editar
• Cambios de parámetros importantes, como eliminar temperature, top_p y top_k para Claude Opus 4.7, y convertir thinking: {type: "enabled", budget_tokens: N} a thinking: {type: "adaptive"}
• Reemplazo de prefill, convirtiendo patrones de prefill de mensaje de asistente a salidas estructuradas donde sea aplicable
• Limpieza de encabezado 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 a

Mientras edita, la habilidad 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 indicación de control de longitud y rebaseline de costo/límite de velocidad).

Para la lista completa de cambios específicos del modelo que aplica la habilidad, consulta Migración a Claude Opus 4.7.

Configuración de un Managed Agent

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

/claude-api managed-agents-onboard

La habilidad ejecuta una entrevista que te guía a través del modelo mental de Managed Agents (configuraciones de agentes versus sesiones), plantilla una configuración de agente, configura entornos y herramientas, configura el bucle de sesión y emite código ejecutable para tu lenguaje. La habilidad también cubre el flujo obligatorio Agent (una vez) → Session (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 client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* y client.beta.vaults.*.

Ejemplo de uso

Aquí hay ejemplos de tareas que la habilidad 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-4-7 and re-tune effort

Incorporar un nuevo Managed Agent:

/claude-api managed-agents-onboard

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

Próximos pasos