Claude Code llama a la API Messages de Anthropic y lee dos variables de entorno para decidir dónde: ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN. Eso hace que la pregunta pueda responderse en una sola frase: cualquier servicio que implemente la API Messages puede impulsar Claude Code, lo que deja tres opciones reales: una suscripción de Claude, una clave de API de Anthropic o una pasarela compatible con Messages. Cuál es la mejor no es una cuestión de funciones, sino de forma de facturación, y la respuesta honesta es que una suscripción gana para la mayoría de los usuarios individuales diarios. Esta página presenta la decisión y el argumento a favor de cada opción.
Sesgo declarado: Kunavo es una de las pasarelas de la tercera opción, y no es la respuesta adecuada para todo el mundo; la sección sobre cuándo mantener una suscripción no es una cortesía, sino la recomendación para una gran parte de los lectores.
Las tres fuentes y para qué sirve cada una
| Fuente | Forma de facturación | Ideal para | Límites estrictos |
|---|---|---|---|
| Suscripción Claude Pro / Max | Cuota mensual fija | Uso interactivo diario que puedes saturar | Ventanas de uso; no sirve para ejecuciones desatendidas ni de CI |
| Clave de API de Anthropic | Por token, precio de lista | Uso por ráfagas, automatización, gestión de claves de equipo | Sin límite máximo: el gasto escala con el uso |
| Pasarela compatible con Messages | Por token, precio de la pasarela | Lo mismo que arriba, más una clave para varios proveedores | Depende de que la pasarela implemente una parte suficiente de la API |
El argumento suscripción frente a API, formulado correctamente
La afirmación más extendida en este ámbito es que una suscripción es muchas veces más barata que la API; una de las páginas que aparece en esta búsqueda la cifra en 36×. Ese número es aritméticamente correcto y se basa en una suposición que sus fuentes rara vez explicitan: compara una suscripción utilizada hasta saturarla con el gasto en tokens del mismo trabajo. Bajo esa suposición, una cuota fija gana obviamente, y para un desarrollador que programa la mayoría de los días laborables y alcanza con frecuencia el límite de la ventana, realmente es así. La tarifa del plan de Anthropic es el dato de entrada para ese cálculo.
La suposición deja de ser válida en cuatro situaciones habituales, y entonces la facturación por token no es solo competitiva, sino lo único que funciona:
- Uso por ráfagas. Dos semanas intensas y un mes tranquilo es algo habitual, y una cuota fija no se reduce a cero.
- Ejecuciones desatendidas. Los trabajos de CI, los agentes programados y las canalizaciones con scripts necesitan una clave, no una sesión de plan interactiva.
- Agotamiento de la ventana. Cuando se consume la ventana de uso de un plan, el trabajo se detiene hasta que se restablece; dentro del mismo plan no hay forma de comprar capacidad adicional. La página sobre el coste de Claude Code desarrolla la comparación con cifras actuales.
- Contabilidad por equipo y proyecto. Las claves separadas con registros de gasto separados son un concepto de facturación por token; un plan personal no lo es.
Útil en la práctica: no son opciones excluyentes. Claude Code cambia mediante dos variables de entorno, por lo que la combinación habitual es una suscripción para el trabajo interactivo diario y una clave para todo lo que ocurre cuando se agota la ventana o no hay nadie frente al teclado.
Lo que realmente debe funcionar para Claude Code
Claude Code utiliza más partes de la API Messages que un cliente de chat, así que «compatible con OpenAI» no es la especificación que debes comprobar. Cuatro requisitos determinan si una fuente funciona:
/v1/messages, de forma nativa. Claude Code utiliza la API Messages de Anthropic, no el formato de chat-completions de OpenAI. Un endpoint que ofrezca solo compatibilidad con OpenAI necesita una capa de traducción delante; eso es lo que existe para proporcionar Claude Code Router.- Streaming. Todas las respuestas se transmiten; una fuente que solo admita respuestas almacenadas en búfer falla inmediatamente.
- Caché de prompts. Esto es lo que determina la factura. Claude Code vuelve a enviar un prompt de sistema grande y el contexto de archivos en cada turno, por lo que la entrada sin caché domina la factura; la entrada en caché tiene un precio muy inferior al de la entrada nueva, y una fuente que no admita caché puede costar varias veces más por el mismo trabajo.
- Los IDs de modelo y la longitud de contexto que pretendes utilizar. Comprueba los slugs específicos, no el nombre de la familia.
Opción 3 en detalle: dirigir Claude Code a una pasarela
Una puerta de enlace compatible con Messages cobra por token como la API de Anthropic, con dos diferencias que pueden importarte o no: el precio unitario puede estar por debajo del de lista de Anthropic, y una clave da acceso a modelos de más de un proveedor. Kunavo implementa /v1/messages con streaming y almacenamiento en caché de prompts, y ofrece Claude Sonnet 5 a $1.40 / $7.00 por cada 1 M de tokens, frente a los $2.00 / $10.00 de Anthropic. La configuración consiste en dos variables y cuatro referencias de modelo: el modelo de sesión más los alias opus, sonnet y haiku:
# Claude Code reads these two variables. Set them and it bills
# per token against a key; unset them and it goes back to your plan.
# Note the base URL is the origin — no /v1 suffix.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves: Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models. The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve, so /model sonnet, opusplan's execution phase and
# sonnet subagents 404 without the sonnet pin. The opus pin (Opus 5.5) needs
# Claude Code v2.1.280 or later (claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claude
# Back to the subscription:
# unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKENLa configuración completa, incluidas las variables para sobrescribir el modelo y cómo verificar la conexión, está en la página de integración de Claude Code. Si quieres mantener una suscripción y cambiar a una clave solo cuando se agote la ventana, cc-switch gestiona el cambio.
Cuándo mantener la suscripción
Si utilizas Claude Code de forma interactiva la mayoría de los días laborables, una sesión cada vez, y alcanzas habitualmente la ventana de uso, un plan es la opción más barata y ninguna pasarela lo superará; la cuota fija está haciendo un trabajo real por ti. Cambia o añade una clave cuando el patrón deje de coincidir: ejecuciones desatendidas, meses con uso por ráfagas, más de una sesión simultánea o registros de gasto por proyecto. Esa es toda la decisión, y para una gran parte de los lectores termina aquí.
De qué tratan los otros resultados de esta búsqueda
Vale la pena aclararlo, porque la frase es ambigua y la mayoría de las páginas que aparecen en la búsqueda responden a otra pregunta. «Mejores clientes de IA para la API de Claude» significa interfaces de chat, una decisión diferente cubierta por integraciones de clientes. «Mejores API para usar con Claude Code» normalmente significa servicios de datos e integración que permites que el agente llame: servidores MCP y conectores SaaS, no la fuente del modelo. «Alternativas a Claude Code» significa sustituir la propia herramienta, lo que constituye una comparación de agentes de programación. Si llegaste buscando una de esas tres cosas, esas son las páginas que debes leer.
Preguntas frecuentes
¿Qué API utiliza Claude Code?
Claude Code llama a la API Messages de Anthropic. Lee dos variables de entorno — ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN —, por lo que cualquier servicio que implemente la API Messages en esa URL base puede servirlo: directamente Anthropic o una pasarela compatible. Configura las variables y Claude Code factura por token contra esa clave; si las desconfiguras, vuelve a tu suscripción de Claude.
¿Es más barato ejecutar Claude Code con una suscripción o con una clave de API?
Depende de si puedes saturar la suscripción. Un plan Claude Pro o Max tiene una cuota mensual fija con ventanas de uso; el acceso a la API factura por token, sin límite máximo ni ventanas. Si programas la mayoría de los días laborables y alcanzas con frecuencia el límite de la ventana, la suscripción es mucho más barata por unidad de trabajo; esa es la base real de las afirmaciones de que «la API cuesta muchas veces más». Si lo usas por ráfagas, lo ejecutas desatendido en CI, necesitas más de una sesión simultánea o quieres que el gasto se reduzca a cero en un mes tranquilo, gana la facturación por token. La mayoría de los usuarios individuales diarios están mejor con una suscripción.
¿Puedo usar Claude Code sin una suscripción de Claude?
Sí. Dirígelo a una clave de API en lugar de a un plan configurando ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN; la herramienta es la misma, solo cambia la fuente de facturación. Esa clave puede ser una clave de API de Anthropic o una de una pasarela compatible con Messages. Si Claude Code es gratis explica completamente la parte del plan.
¿Qué debo comprobar antes de dirigir Claude Code a una pasarela?
Cuatro cosas, porque Claude Code utiliza más partes de la API Messages que una aplicación de chat. Primero, el propio endpoint /v1/messages, no solo un /v1/chat/completions compatible con OpenAI. Segundo, el streaming: Claude Code transmite todas las respuestas. Tercero, la caché de prompts, porque Claude Code vuelve a enviar un prompt de sistema grande y el contexto de archivos en cada turno, y la entrada sin caché es la partida individual más grande de la factura. Cuarto, el contexto largo y los IDs de modelo que pretendes usar. Una pasarela que cubra las finalizaciones de chat pero no estos elementos parecerá funcionar y después fallará a mitad de la sesión.
¿Claude Code funciona con endpoints compatibles con OpenAI?
No directamente: utiliza la API Messages de Anthropic, no el formato de chat-completions de OpenAI. Los endpoints que ofrecen solo compatibilidad con OpenAI necesitan una capa de traducción intermedia, que es lo que proporcionan herramientas como Claude Code Router. Una pasarela que implemente /v1/messages de forma nativa no necesita traducción.
¿Qué modelo debería usar Claude Code?
Claude Code utiliza de forma predeterminada un modelo avanzado para el razonamiento y un modelo pequeño para las llamadas rutinarias; ambos se pueden configurar mediante sus ajustes. La diferencia de coste entre niveles es grande: Claude Opus 5.5 cuesta $2.80 / $14.00 por 1 M de tokens frente a Claude Sonnet 5, que cuesta $1.40 / $7.00 en Kunavo; por eso, la elección del modelo influye más en la factura que la elección del proveedor.