---
title: Skill de la Claude API
url: https://platform.claude.com/docs/es/agents-and-tools/agent-skills/claude-api-skill
description: Un Agent Skill de código abierto que proporciona a Claude material de referencia actualizado de la API, documentación de los SDK y mejores prácticas para crear aplicaciones con la Claude API y Claude Managed Agents.
---
El skill `claude-api` es un [Agent Skill](https://platform.claude.com/docs/es/agents-and-tools/agent-skills/overview) 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](https://code.claude.com/docs/en/overview) y también está disponible en el [repositorio de skills de Anthropic](https://github.com/anthropics/skills) de código abierto, desde donde puedes instalarlo en cualquier entorno que admita Agent Skills.
El skill usa ["progressive disclosure" (revelación progresiva)](https://platform.claude.com/docs/es/agents-and-tools/agent-skills/overview#how-skills-work) 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](https://platform.claude.com/docs/es/agents-and-tools/tool-use/overview) 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 al 50 % del costo
* **Almacenamiento en caché de prompts:** Diseño de estabilidad del prefijo, ubicació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.5](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Claude Sonnet 5.5](https://platform.claude.com/docs/es/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [Claude Haiku 5.5](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide) y [Claude Fable 5.1](https://platform.claude.com/docs/es/models/fable-5-1/migration-guide))
* **Migración de pensamiento preservado:** Encontrar, medir y corregir las ediciones del historial que invalidan los bloques `thinking`, disponible mediante el subcomando `/claude-api preserved-thinking-migration`
* **Información actual de los modelos:** ID de modelos, tamaños de la "context window" (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 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](https://platform.claude.com/docs/es/build-with-claude/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.
| Lenguaje | SDK de Messages API | Tool runner | Managed Agents |
| ---------- | ------------------- | ----------- | -------------- |
| Python | Sí | Sí (beta) | Sí (beta) |
| TypeScript | Sí | Sí (beta) | Sí (beta) |
| C# | Sí | Sí (beta) | Sí (beta) |
| Go | Sí | Sí (beta) | Sí (beta) |
| Java | Sí | Sí (beta) | Sí (beta) |
| PHP | Sí | Sí (beta) | Sí (beta) |
| Ruby | Sí | Sí (beta) | Sí (beta) |
| cURL | Sí | N/A | Sí (beta) |
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](https://code.claude.com/docs/en/overview) 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:
Usa este skill en Claude Code
```text
/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](https://code.claude.com/docs/en/skills#bundled-skills).
### Desde el repositorio de skills
El código fuente del skill está disponible en el [repositorio de skills de Anthropic](https://github.com/anthropics/skills). Puedes instalarlo usando el comando `npx`:
```bash
npx skills add https://github.com/anthropics/skills --skill claude-api
```
O pídele a Claude Code que lo instale como un [plugin de Claude Code](https://code.claude.com/docs/en/plugins):
Deja que Claude Code lo instale por ti
```text
Instala el plugin claude-api desde el marketplace de plugins anthropics/skills
```
```text wrap
/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`:
Deja que Claude Code migre tu código por ti
```text
/claude-api migrate este proyecto al modelo Claude Opus más reciente
```
También puedes pasar un alcance específico desde el principio para omitir la pregunta de confirmación del alcance:
Deja que Claude Code migre tu código por ti
```text
/claude-api migrate todo lo que está en src/ al modelo Claude Opus más reciente
```
Deja que Claude Code migre tu código por ti
```text
/claude-api migrate apps/api.py y apps/worker.py al modelo Claude Opus más reciente
```
Cuando el alcance es ambiguo (por ejemplo, un simple `/claude-api migrate to claude-opus-5-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 quienes llaman a Managed Agents.
El skill se encarga de:
* **Cambios de ID de modelo**, incluidas las constantes tipadas del SDK (`Model.CLAUDE_OPUS_4_8` → `Model.CLAUDE_OPUS_5_5`) 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 la plataforma en la nube**, conservando los formatos de ID de modelo específicos de cada plataforma (por ejemplo, el prefijo `anthropic.` en Amazon Bedrock) y omitiendo cambios para funciones que no están disponibles en plataformas operadas por socios
* **Cambios incompatibles en 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}` en `thinking: {type: "adaptive"}`
* **Reemplazo del prefill**, convirtiendo los patrones de prefill en mensajes del asistente a [salidas estructuradas](https://platform.claude.com/docs/es/build-with-claude/structured-outputs) cuando 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()` (go: `client.Beta.Messages.New()`; java: `client.beta().messages().create()`; csharp: `client.Beta.Messages.Create()`; php: `$client->beta->messages->create()`) a `client.messages.create()` (go: `client.Messages.New()`; java: `client.messages().create()`; csharp: `client.Messages.Create()`; php: `$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 los prompts**, señalando los prompts de control de longitud, activación de herramientas, subagentes y seguimiento de instrucciones que pueden comportarse de forma diferente en el modelo de destino
* **Manejo de valores predeterminados silenciosos**, volviendo a habilitar 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 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](https://platform.claude.com/docs/es/build-with-claude/refusals-and-fallback) cuando el destino es Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5 o Claude Sonnet 5.5 (el parámetro `fallbacks` del lado del servidor, normalmente 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 para formatos de versiones preliminares 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 [Migración a Claude Opus 5.5 desde Claude Opus 5](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Migración a Claude Opus 5.5 desde Claude Opus 4.8](https://platform.claude.com/docs/es/models/opus-5-5/migration-guide#migrating-from-claude-opus-4-8), [Migrar a Claude Sonnet 5.5 desde Claude Sonnet 5](https://platform.claude.com/docs/es/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [guía de migración a Claude Haiku 5.5](https://platform.claude.com/docs/es/models/haiku-5-5/migration-guide) y [guía de migración a Claude Fable 5.1 y Claude Mythos 5.1](https://platform.claude.com/docs/es/models/fable-5-1/migration-guide).
## Comprobar una integración para el pensamiento preservado
El [pensamiento preservado](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking) mantiene válido un bloque `thinking` solo mientras la indicación del sistema (`system`), las `tools` y los mensajes anteriores a él permanezcan sin cambios. Para encontrar y corregir los lugares donde tu código edita ese historial, abre el repositorio que construye tus solicitudes e invoca el subcomando `preserved-thinking-migration`:
Deja que Claude Code revise tu código por ti
```text
/claude-api preserved-thinking-migration
```
El skill trabaja en cinco pasos:
1. **Alcance:** Comprueba si tu integración se ve afectada y luego envía tres solicitudes de prueba para confirmar que la API informa de una edición deliberada.
2. **Búsqueda:** Captura algunas de tus propias sesiones de varios turnos, compara solicitudes consecutivas y enumera cada lugar donde tu código edita el prefijo.
3. **Medición:** Reproduce las sesiones con `"drop_block"` e informa qué conversaciones pierden bloques `thinking`, en qué turno y por qué.
4. **Corrección:** Reemplaza una edición a la vez con el patrón correspondiente de [Hacer cambios sin editar el prefijo](https://platform.claude.com/docs/es/build-with-claude/preserved-thinking#replace-prefix-edits) y vuelve a medir después de cada cambio.
5. **Informe:** Resume cada causa, el cambio realizado para ella y los recuentos antes y después.
Si tu proyecto tiene una evaluación, el skill también compara las puntuaciones y el uso de tokens con y sin los bloques `thinking` descartados.
Las solicitudes de prueba y las reproducciones son solicitudes reales a la Messages API, facturadas a las tarifas normales del modelo. Cada reproducción solicita solo unos pocos tokens de salida y establece `tool_choice` en `none`, por lo que no se ejecuta ninguna herramienta. El skill indica el costo y pide tu aprobación antes de enviarlas.
## Configurar un Managed Agent
Para generar la estructura de un nuevo Managed Agent desde cero, invoca el subcomando `managed-agents-onboard`:
Deja que Claude Code configure tu agente por ti
```text
/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:**
Deja que Claude Code lo cree por ti
```text
Crea una interfaz de chat con streaming usando la Claude API en TypeScript
```
**Migrar un proyecto existente:**
Deja que Claude Code migre tu código por ti
```text
/claude-api migrate esta base de código al modelo Claude Opus más reciente y vuelve a ajustar el esfuerzo
```
**Incorporar un nuevo Managed Agent:**
Deja que Claude Code configure tu agente por ti
```text
/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
Aprende cómo funcionan los Agent Skills y el modelo de revelación progresiva
Explora los SDK oficiales de Anthropic para todos los lenguajes compatibles
Explora el repositorio público de skills de Anthropic en GitHub