claude-api: conectar Claude con el SDK oficial y evitar primero los parámetros abandonados

Para quién

claude-api es para quien en el prompt nombra Claude o Anthropic y necesita una referencia de modelos, parámetros, streaming, herramientas o caché. Es una referencia de Claude API / Anthropic SDK, no otro instalador. Cuando un prompt nombra Claude/Anthropic de cualquier forma, lee primero esta guía; no la saltes porque «parece una frase».

El uso más ajustado: vas a añadir o cambiar una llamada a Claude en un proyecto existente, y el lenguaje del proyecto ya tiene un SDK oficial de Anthropic. La guía exige: al implementar una función Claude, hay que llamar por el SDK oficial de ese lenguaje. No encaja si solo quieres inventar pseudocódigo sin SDK indicado, o tratar la ruta de la página como comando de instalación.

El modelo por defecto se escribe Claude Opus 5; la cadena exacta es claude-opus-5. Las peticiones un poco complejas usan por defecto adaptive thinking. La guía no da comando de instalación. Si el asistente actual aún no puede cambiar código según esta referencia, la guía existente se detiene aquí; no infieras un directorio de skill desde la dirección.

Primera prueba en 3 minutos

El primer camino oficial es comprobar o cambiar una llamada según la referencia, no instalar. La página de la guía es

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Sigue solo las restricciones de esa página. No escribas una frase de instalación que no aparece ni pongas marcadores de secretos en el código.

Requisito: el asistente actual ya puede trabajar como claude-api, tienes un fragmento de llamada desechable o una función vacía, y esta máquina ya tiene el SDK oficial de Anthropic de ese lenguaje. No hay comando de instalación, así que la «ubicación» es este código de proyecto, no un directorio de skill adivinado.

Primera tarea de bajo riesgo: primero una comprobación de solo lectura. Haz que mire si la llamada existente pasa por el SDK oficial, si el modelo es claude-opus-5, si thinking es adaptive y si aparece el budget_tokens abandonado. No envíes primero una petición larga a una cuenta real. Señal de éxito: el asistente señala cualquier desvío de esos cuatro puntos y se detiene para que confirmes antes de cambiar código.

Si hay que cambiar, cambia solo la cadena del modelo y la forma de thinking: thinking: {type: "adaptive"}. La guía dice que en Claude 4.6+ budget_tokens está abandonado y en Opus 4.6 / Sonnet 4.6 se rechaza y devuelve 400. Ante un aviso de escritura, confirma primero que no se escribe ningún secreto en el repositorio.

Casos de uso

Caso 1: añadir una función Claude al proyecto. Si el prompt nombra Claude/Anthropic, lee primero la referencia. Implementa por el SDK oficial de Anthropic del lenguaje del proyecto, modelo claude-opus-5, peticiones un poco complejas por defecto con adaptive thinking. Encaja cuando ya elegiste el lenguaje y solo falta escribir bien la llamada. Las frases existentes solo despliegan la vía «SDK oficial» y no nombran otros SDK; no cambies por tu cuenta a un envoltorio no nombrado. La página de contraste es

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Caso 2: quitar un parámetro thinking viejo que da 400. En Claude 4.6+ usa thinking: {type: "adaptive"}; budget_tokens está abandonado en Opus 4.6 / Sonnet 4.6, se rechaza y devuelve 400. Encaja cuando acabas de copiar una config thinking de un ejemplo viejo y la petición dio 400 al momento. Cambia primero solo este punto y luego decide si envías una petición real. La guía no lista todos los campos abandonados, así que solo puedes confirmar este budget_tokens.

Límites de uso

Sin comando de instalación: no trates la ruta de la página como instalador. Límite de disparo: si un prompt nombra Claude/Anthropic de cualquier forma, lee primero; no lo saltes como una frase. Límite de llamada: implementar una función debe ir por el SDK oficial de Anthropic del lenguaje del proyecto; las frases existentes no despliegan otras vías en paralelo. Límite de modelo: por defecto Claude Opus 5, cadena claude-opus-5; peticiones complejas por defecto adaptive thinking. Límite de parámetro: budget_tokens da 400 en los modelos 4.6 nombrados. Límite de secretos: no escribas marcadores de secretos ni pongas secretos en el código. Esta referencia también cubre precios, streaming, herramientas y temas afines, pero las frases existentes no dan ejemplos paso a paso de esos temas.