claude-api

Overview

Para qué te ayuda claude-api

La skill claude-api es una referencia práctica para crear aplicaciones impulsadas por LLM con Claude usando la Claude API, los SDK oficiales de Anthropic y materiales de Agent SDK cuando están disponibles. Está organizada por lenguaje para que los desarrolladores puedan pasar rápidamente de la configuración inicial a solicitudes funcionales, respuestas en streaming, tool use y patrones de integración en backend.

Esta skill resulta especialmente útil cuando ya tienes claro que quieres trabajar con Claude y necesitas orientación de implementación, en lugar de una introducción general a la IA. El repositorio incluye documentación específica por lenguaje para C#, Go, Java, PHP, Ruby, Python y TypeScript, además de ejemplos HTTP directos en curl/.

Para quién es esta skill

claude-api encaja especialmente bien para:

• Desarrolladores de backend que integran Claude en servicios, workers y herramientas internas
• Desarrolladores de API que están eligiendo entre llamadas HTTP directas y SDK oficiales
• Equipos que comparan el soporte por lenguaje antes de estandarizar en Python, TypeScript, Go, Java, PHP, Ruby o C#
• Desarrolladores que necesitan ejemplos de streaming, tool use, batching, uso de files API y manejo de errores
• Desarrolladores de agentes que usan los materiales de Agent SDK para Python o TypeScript

Qué problemas resuelve

En lugar de obligarte a reunir ejemplos dispersos, claude-api te ofrece un punto de partida estructurado para decisiones de implementación habituales:

• Qué SDK o superficie de API usar
• Qué carpeta de lenguaje leer primero
• Cómo autenticarte con ANTHROPIC_API_KEY
• Cómo enviar una primera solicitud de mensaje
• Cuándo conviene usar streaming para salidas largas
• Dónde consultar tool use, batches, files API, prompt caching, referencias de modelos y códigos de error

La skill también incluye archivos de referencia compartidos como shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md y shared/tool-use-concepts.md, lo que resulta útil cuando necesitas orientación sobre el comportamiento del backend más allá de un ejemplo mínimo tipo hello world.

Superficies de documentación compatibles en el repositorio

La evidencia del repositorio muestra estas áreas principales:

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

Esto hace que claude-api sea más que una simple colección de fragmentos para un único lenguaje. La mejor forma de entenderla es como una skill de integración backend multilenguaje para el ecosistema de Claude API.

Cuándo claude-api es una buena opción

Usa claude-api cuando:

• Tu base de código importa anthropic, @anthropic-ai/sdk o claude_agent_sdk
• Quieres patrones de uso de los SDK oficiales de Anthropic
• Necesitas ejemplos prácticos para integrar Claude API en el servidor
• Quieres orientación de instalación específica por lenguaje antes de implementar
• Necesitas entender funciones como streaming, tool use, batches o soporte de files API

Cuándo claude-api no es la opción adecuada

Esta skill no es la mejor elección cuando:

• Tu proyecto usa el SDK de otro proveedor de IA, como openai
• Necesitas ayuda de programación genérica no relacionada con la integración de Claude
• Buscas patrones de UI frontend en lugar de flujos de API y backend
• Necesitas un lenguaje que no cubre el repositorio y no quieres usar ejemplos HTTP directos de curl/

How to Use

Instala la skill

Añade claude-api desde el repositorio de skills de Anthropic:

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

Después de instalarla, empieza por SKILL.md y luego entra en la carpeta del lenguaje que corresponda a tu base de código.

Elige primero la carpeta correcta

La forma más rápida de aprovechar bien claude-api es seleccionar la ruta específica del lenguaje antes de entrar en los detalles de implementación.

Algunos puntos de partida útiles del repositorio son:

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

Si estás evaluando el soporte de los SDK antes de elegir un stack, revisa varias carpetas de lenguaje en paralelo. El repositorio separa claramente el uso directo de Claude API de la guía de Agent SDK en Python y TypeScript.

Ajusta la superficie a tu caso de uso

Según la estructura del repositorio, claude-api admite varias rutas prácticas:

• Usa curl/examples.md para solicitudes HTTP directas o para lenguajes no compatibles
• Usa carpetas de lenguaje como go/, java/, php/, ruby/ o csharp/ para patrones con SDK oficiales
• Usa python/claude-api/ o typescript/claude-api/ para una cobertura más profunda de temas como streaming, tool use, batches y files API
• Usa python/agent-sdk/ o typescript/agent-sdk/ si tu proyecto se centra en flujos de agentes y no solo en llamadas directas de mensajes

Esta estructura es útil para tomar decisiones de instalación porque no todos los lenguajes ofrecen las mismas funciones de nivel superior. Por ejemplo, el repositorio incluye de forma explícita documentación de Agent SDK para Python y TypeScript, mientras que otros lenguajes se centran en el uso del SDK de Claude API.

Configura la autenticación de forma segura

En los ejemplos del repositorio, el patrón estándar es usar la variable de entorno ANTHROPIC_API_KEY en lugar de escribir secretos directamente en el código. Eso hace que claude-api encaje bien en flujos de backend orientados a producción y en entornos de CI.

Antes de probar los ejemplos, confirma que tu entorno de ejecución puede leer ANTHROPIC_API_KEY.

Rutas de instalación habituales por lenguaje

La evidencia del repositorio incluye estos ejemplos de instalación:

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: configuración de dependencias con com.anthropic:anthropic-java
• HTTP directo: usa curl contra https://api.anthropic.com/v1/messages

Si estás decidiendo entre SDK y HTTP, empieza por el SDK cuando tu lenguaje sea compatible y recurre a los ejemplos de curl/ cuando necesites control de bajo nivel sobre la solicitud o trabajes con otro lenguaje.

Empieza con una solicitud básica de mensaje

La mayoría de las guías por lenguaje de claude-api siguen el mismo flujo práctico:

1. Inicializar un cliente
2. Leer la API key desde el entorno
3. Enviar una solicitud de mensaje con un modelo de Claude
4. Leer bloques de texto de la respuesta

Esta consistencia resulta útil cuando los equipos trabajan en varios lenguajes de backend. Puedes estandarizar el patrón de solicitud aunque cambie la sintaxis del código.

Usa streaming para respuestas largas

El SKILL.md del repositorio recomienda explícitamente usar streaming por defecto en solicitudes que puedan implicar entradas largas, salidas largas o un max_tokens alto, ya que el streaming ayuda a evitar timeouts en las solicitudes. Esa recomendación es una de las conclusiones operativas más importantes de claude-api.

Si tu aplicación genera respuestas largas, resúmenes, bucles con tools o razonamientos extensos, revisa primero la documentación de streaming:

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• Secciones de streaming dentro de archivos específicos por lenguaje como go/claude-api.md, java/claude-api.md, ruby/claude-api.md y csharp/claude-api.md

Explora funciones avanzadas de backend

Una de las razones para instalar claude-api en lugar de depender de una única guía rápida es la mayor profundidad temática del repositorio. Entre los archivos relevantes están:

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

Estos recursos son especialmente valiosos para flujos de backend en producción, donde necesitas algo más que un simple ejemplo de solicitud y respuesta.

Usa las referencias compartidas para resolver problemas

Si tu primera integración falla, claude-api incluye material de apoyo útil para depurar y planificar:

• shared/error-codes.md para entender el significado de los errores HTTP, su posibilidad de reintento y sus causas más comunes
• shared/models.md para referencias relacionadas con modelos
• shared/live-sources.md para orientación relacionada con las fuentes

La referencia de códigos de error es especialmente útil porque distingue entre condiciones reintentables como 429, 500 y 529, y problemas de solicitud no reintentables como 400 o problemas de autenticación como 401.

Checklist práctico de evaluación antes de adoptar claude-api

Antes de apostar por esta skill en un proyecto, pregúntate:

• ¿Necesitamos ejemplos oficiales de SDK en alguno de los lenguajes compatibles?
• ¿Esperamos salidas largas y, por tanto, necesitamos orientación sobre streaming?
• ¿Necesitamos ejemplos de tool use, files API o procesamiento por lotes?
• ¿Estamos creando flujos de agentes en Python o TypeScript?
• ¿Queremos una ruta alternativa de HTTP directo con curl?

Si la respuesta a varias de estas preguntas es sí, claude-api probablemente encaje muy bien.

FAQ

¿Qué es claude-api en este repositorio?

claude-api es una skill de anthropics/skills que ayuda a los desarrolladores a crear aplicaciones con Claude API, los SDK de Anthropic y recursos de Agent SDK. Está organizada por lenguaje y respaldada por documentos de referencia compartidos.

¿Cómo instalo claude-api?

Usa:

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

Después, abre SKILL.md y la carpeta del lenguaje que corresponda a tu stack.

¿Qué lenguajes cubre claude-api?

La evidencia del repositorio muestra documentación para C#, Go, Java, PHP, Ruby, Python, TypeScript y ejemplos HTTP directos con curl.

¿claude-api incluye guía sobre Agent SDK?

Sí, pero según la estructura del repositorio, los materiales de Agent SDK están específicamente en python/agent-sdk/ y typescript/agent-sdk/. Si necesitas ejemplos de flujos de agentes, esas son las primeras carpetas que deberías revisar.

¿claude-api ayuda con streaming y tool use?

Sí. El repositorio incluye documentación sobre streaming y tool use, especialmente en las carpetas de Claude API para Python y TypeScript, y varias guías específicas por lenguaje también incluyen secciones de streaming.

¿claude-api sirve solo para llamadas directas a la API?

No. Cubre tanto el uso directo de Claude API como patrones de integración basados en SDK. También incluye ejemplos HTTP directos en curl/examples.md para desarrolladores que no quieren usar un SDK o trabajan en otro lenguaje.

¿Cuándo debería usar curl en lugar de un SDK?

Usa curl cuando necesites ejemplos HTTP directos, cuando tu lenguaje no esté cubierto por un SDK oficial dentro de esta skill o cuando quieras inspeccionar directamente la estructura de la solicitud y la respuesta antes de adoptar una librería cliente.

¿claude-api incluye orientación sobre manejo de errores?

Sí. shared/error-codes.md documenta los códigos de error HTTP, las causas habituales y qué problemas se pueden reintentar. Eso hace que claude-api sea útil para planificar integraciones en producción, no solo para la configuración inicial.

¿claude-api es una buena opción para ayuda general de programación?

No. La descripción del repositorio está centrada en el uso de Claude API y los SDK de Anthropic. Si tu tarea no está relacionada con integrar Claude, esta skill es demasiado especializada.

¿Qué debería leer primero después de instalar claude-api?

Empieza por SKILL.md y luego pasa al archivo que corresponda a tu lenguaje y caso de uso. Para muchos equipos, la mejor secuencia es:

1. SKILL.md
2. Tu guía de lenguaje, como go/claude-api.md o php/claude-api.md
3. Documentación específica por tema, como streaming.md, tool-use.md, batches.md o files-api.md
4. Referencias compartidas como shared/error-codes.md