SDK de Anthropic y Claude Code
Zabio sirve la Messages API de Anthropic en el mismo host y con la misma key que la API compatible con OpenAI. Las herramientas hechas con los SDK de Anthropic, entre ellas Claude Code, funcionan cambiando dos ajustes: la base URL y la key. Tu cuenta, tu crédito y tu factura son los mismos.
| Ruta | Qué es |
|---|---|
POST /v1/messages |
la Messages API de Anthropic: un mensaje, o un stream con los eventos de Anthropic |
POST /v1/messages/count_tokens |
el conteo de tokens de Anthropic |
GET /v1/models con el header anthropic-version |
la lista de modelos con la forma de Anthropic |
Base URL y key
Section titled “Base URL y key”Los SDK de Anthropic añaden /v1/messages por su cuenta, así que su base URL no lleva /v1:
| Cliente | Base URL |
|---|---|
| SDK de Anthropic, Claude Code | https://api.zabio.ai |
| SDK de OpenAI | https://api.zabio.ai/v1 |
Envía tu key de Zabio de cualquiera de las dos formas que usan los SDK: x-api-key: zb_live_... o Authorization: Bearer [MASKED] El header anthropic-version` se acepta con cualquier valor.
import anthropic
client = anthropic.Anthropic(base_url="https://api.zabio.ai", api_key="insert your zabio.ai key here")message = client.messages.create( model="claude-sonnet-5", max_tokens=1024, messages=[{"role": "user", "content": "Hola"}],)print(message.content[0].text)import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ baseURL: "https://api.zabio.ai", apiKey: "insert your zabio.ai key here" });const message = await client.messages.create({ model: "claude-sonnet-5", max_tokens: 1024, messages: [{ role: "user", content: "Hola" }],});Claude Code
Section titled “Claude Code”Define tres variables de entorno antes de iniciar claude:
export ANTHROPIC_BASE_URL="https://api.zabio.ai"export ANTHROPIC_AUTH_TOKEN="insert your zabio.ai key here"export ANTHROPIC_API_KEY=""ANTHROPIC_AUTH_TOKEN envía tu key de Zabio como bearer token. ANTHROPIC_API_KEY debe existir y estar vacía, para que Claude Code no use una key de Anthropic ni te pida iniciar sesión en Anthropic. Los ajustes de modelo de Claude Code eligen el modelo: ANTHROPIC_MODEL=auto deja que Zabio elija en cada petición, y /model dentro de una sesión cambia a cualquier id de modelo de GET /v1/models. Los ids de modelo de Anthropic con fecha, que Claude Code usa en sus llamadas de fondo (claude-haiku-4-5-20251001), los sirve el modelo del mismo nombre sin la fecha (claude-haiku-4-5).
El advisor de Claude Code no está disponible a través de Zabio. Cuando configuras un modelo advisor, Claude Code añade la herramienta advisor de Anthropic a cada petición; Zabio la quita, la lista en zabio.ignored_parameters y la sesión sigue sin el advisor. Lo mismo vale para cualquier otra herramienta que Anthropic ejecuta de su lado (consulta Herramientas de servidor).
Qué modelo responde
Section titled “Qué modelo responde”- Un modelo Claude nombrado en
model(claude-sonnet-5,claude-opus-5-5,claude-haiku-4-5): Zabio envía a Anthropic el cuerpo de tu petición tal como lo escribiste, con tus bloques de system, tus marcascache_control, los bloques de thinking y sus firmas, imágenes y documentos. La respuesta es el mensaje o el stream de Anthropic, con el id de Zabio. Zabio escribe tres cosas sobre tu cuerpo: el id del modelo,max_tokenscuando tu plan o tu saldo limitan la respuesta, ymetadata.user_id, que pasa a ser un id opaco derivado de tu organización y de tu valor (con tu propia key de Anthropic, tu valor). Consulta Qué recibe el proveedor. Cuando el modelo que nombraste rechaza un campo, Zabio lo cambia para que la petición no falle, y la respuesta lo dice. En los modelos Claude 5,claude-opus-4-8yclaude-opus-4-7,temperature,top_pytop_kse omiten y aparecen enzabio.dropped_parameters, ythinkingconbudget_tokensse envía como thinking adaptativo con el esfuerzo que corresponde al presupuesto (aparece comobudget_tokens). En un modelo que siempre piensa (claude-fable-5-2,claude-fable-5-1,claude-fable-5,claude-opus-5-5,claude-opus-5,claude-sonnet-5-5),thinking: {"type": "disabled"}se envía como thinking adaptativo con el esfuerzo más bajo, yzabio.reasoning.appliedlo indica. Una elección de herramienta forzada (anyotool) enclaude-fable-5-2,claude-fable-5-1,claude-opus-5-5oclaude-sonnet-5-5se rechaza con 400 antes de llegar a Anthropic, que también la rechaza (consulta Elección de herramienta forzada). auto,auto/best,auto/balanced,auto/cheap, o un modelo de otro proveedor (gpt-5-mini,gemini-3.5-flash): la petición se traduce, se enruta como un chat completion y la respuesta se traduce de vuelta a la forma de Anthropic. auto puede elegir el modelo de cualquier proveedor, Claude incluido. Consulta Modelos.
Cada llamada se factura como la misma llamada en chat completions: el precio de lista del proveedor más la comisión, con las lecturas y escrituras de caché de Anthropic a sus propias tarifas. Una llamada a Claude que escribe en la caché de una hora se factura a la tarifa de escritura de una hora.
Lo que la traducción no lleva
Section titled “Lo que la traducción no lleva”Se aplica a auto y a los modelos de otros proveedores, nunca a un modelo Claude nombrado en model:
| En tu petición o respuesta | Qué pasa |
|---|---|
| Bloques de thinking de turnos anteriores | se omiten; los otros proveedores no pueden leer las firmas de Anthropic |
| Thinking en la respuesta | no se devuelve; la respuesta lleva solo texto y llamadas a herramientas |
Marcas cache_control |
no se envían; los otros proveedores guardan en caché un prefijo repetido por su cuenta |
top_k |
no se envía; aparece en zabio.ignored_parameters |
Mensajes con el rol system entre los turnos |
se envían en su lugar como texto del usuario; los otros proveedores no aceptan ahí un mensaje de system |
thinking y output_config.effort |
se leen como un nivel de razonamiento en la escala de Zabio (un presupuesto de menos de 4.096 tokens es low, de menos de 16.384 medium, y a partir de ahí high; max es el más alto) |
stop_sequence en la respuesta |
null: el stop reason es stop_sequence, pero no se nombra la secuencia que coincidió |
El uso en el message_start de un stream |
cero; los conteos llegan en message_delta |
Bloques de documento, imágenes dentro de un tool_result, herramientas definidas por Anthropic (bash_*, text_editor_*, computer_*, memory_*) |
se rechazan con invalid_request_error: nombra un modelo Claude para enviarlos |
En un modelo Claude nombrado en model, una petición que lleva algo de la última fila se queda en Anthropic cuando Anthropic falla: el fallback de tu key llega solo a otros modelos Claude.
Lo que Zabio no sirve en esta ruta
Section titled “Lo que Zabio no sirve en esta ruta”Se rechaza con 400 invalid_request_error, sin enviar nada a un proveedor:
| Campo o valor | Por qué |
|---|---|
container, mcp_servers |
no se sirven los contenedores de ejecución de código de Anthropic ni su conector MCP. Ejecuta tu cliente MCP por tu cuenta y envía sus herramientas como custom tools |
speed: "fast" |
el modo rápido tiene sus propios precios; Zabio sirve la velocidad estándar |
inference_geo distinto de global |
la residencia de datos tiene sus propios precios; Zabio sirve inferencia global |
| Un campo que la Messages API de Anthropic no tiene | como lo responde Anthropic: <field>: Extra inputs are not permitted. |
Herramientas de servidor
Section titled “Herramientas de servidor”La búsqueda web de Anthropic pasa tal cual en un modelo Claude nombrado en model que acepta búsqueda web (uno cuyo zabio.pricing.per_search aparece en GET /v1/models): la herramienta web_search_20250305, como la envías, con los bloques propios de Anthropic en la respuesta (server_tool_use, web_search_tool_result, las citations del texto). Cada búsqueda que Anthropic cuenta (usage.server_tool_use.web_search_requests) se factura en su propia línea junto a la llamada, al precio por búsqueda del proveedor con la comisión de Zabio, y aparece en zabio.search y zabio.cost; los resultados cuentan como tokens de entrada. Una herramienta de búsqueda web sin max_uses recibe max_uses: 5, el máximo que la llamada puede hacer y lo que cuenta su comprobación de saldo; un valor que envíes se conserva. Con la key de Anthropic propia de tu organización la herramienta pasa y Anthropic te cobra las búsquedas directamente.
Donde la búsqueda web no se sirve, la herramienta se quita y aparece en zabio.ignored_parameters como tools: <type> con el motivo, y la llamada sigue sin ella: en auto y en modelos de otros proveedores, en un modelo que no acepta búsqueda web, en una key con la búsqueda web desactivada y dentro de los límites del plan Free. Las versiones posteriores de la herramienta (web_search_20260209 y siguientes), que ejecutan código del lado de Anthropic, se quitan de la misma forma.
Las demás herramientas que Anthropic ejecuta de su lado (web_fetch_*, code_execution_*, el advisor advisor_* y las demás) Anthropic las cobra por uso, un cargo que Zabio no factura. Se quitan de tu petición antes de que llegue a cualquier modelo, cada una aparece en zabio.ignored_parameters como tools: <type>, y la llamada sigue con tus otras herramientas. Un tool_choice que nombra una herramienta quitada pasa a auto. Usa herramientas propias (custom tools) para lo que el modelo deba llamar.
service_tier se acepta y no se envía: las llamadas van al tier estándar. Estos valores de anthropic-beta no se transmiten, y cada uno aparece en zabio.ignored_parameters: context-1m-* (en los modelos que lo necesitan, Anthropic cobra más los prompts de más de 200.000 tokens), fast-mode-*, mcp-client-*, code-execution-*, skills-*, files-api-* y oauth-*. Cualquier otra beta llega a los modelos Claude tal como la enviaste.
Streaming
Section titled “Streaming”Con stream: true la respuesta son los eventos de Anthropic: message_start, luego content_block_start, content_block_delta y content_block_stop por cada bloque, message_delta con el stop reason y el uso, y message_stop. En un modelo Claude nombrado en model son los eventos propios de Anthropic, ping y los deltas de thinking incluidos. Mientras el modelo no ha empezado su respuesta, Zabio puede enviar líneas de comentario SSE (: ZABIO PROCESSING) para mantener abierta la conexión; los SDK las ignoran. Zabio todavía puede pasar una petición a otro modelo mientras no se ha enviado nada de la respuesta, así que una fase larga de thinking te llega cuando empieza el primer texto o la primera llamada a una herramienta. Un fallo en el stream lo termina con el evento error de Anthropic.
Contar tokens
Section titled “Contar tokens”POST /v1/messages/count_tokens recibe la petición sin max_tokens y responde {"input_tokens": N}. En un modelo Claude el conteo es el de Anthropic. En auto y en los modelos de otros proveedores es la estimación de Zabio, la misma que usa la admisión, marcada "zabio": {"estimated": true}. Contar es gratis y cuenta para el límite de peticiones de tu key.
La lista de modelos
Section titled “La lista de modelos”GET /v1/models con el header anthropic-version (los SDK de Anthropic lo envían) responde con la forma de Anthropic: data con type, id, display_name y created_at de cada modelo, luego has_more, first_id y last_id. limit (de 1 a 1.000, 20 por defecto), after_id y before_id la recorren por páginas. La lista es la misma que sin el header: primero los modelos auto, luego todos los modelos que tu key puede llamar.
Errores
Section titled “Errores”Los errores en estas rutas usan el envoltorio de Anthropic, para que los SDK lancen sus propias excepciones:
{ "type": "error", "error": { "type": "not_found_error", "message": "The model 'claude-nope' does not exist or you do not have access to it." }, "request_id": "req_6f1c...", "zabio": { "code": "model_not_found" }}zabio.code es el código que el mismo error tiene en las rutas de OpenAI. Consulta Errores para los códigos de estado.
El objeto zabio
Section titled “El objeto zabio”Un mensaje lleva el objeto zabio de un chat completion junto a los campos de Anthropic: el proveedor, el modelo que respondió, el costo y, con auto, el enrutamiento. Un stream no lo lleva; lee el header x-zabio-vendor y busca la llamada en Logs. Las opciones de petición de Zabio van en el objeto zabio del cuerpo o en los headers x-zabio-*, como en chat completions.