Claude Code API sin suscripción
El terminal local de Claude Code puede usar facturación de API en lugar de un plan mensual de Claude. Las llamadas al modelo siguen siendo de pago; cambian la autenticación y la factura.
Puedes usar Claude Code API sin suscripción en el terminal local eligiendo un proveedor con facturación de API en vez de iniciar sesión con un plan de pago de Claude.ai. Anthropic admite oficialmente Claude Console con facturación de API, proveedores cloud y gateways LLM, además de la autenticación de suscripciones Pro, Max, Team y Enterprise.
Con OmniaKey, esta vía consiste en cargar un saldo prepagado, crear una clave API y dar a Claude Code una base URL compatible con Anthropic junto con un bearer token. No hay una suscripción recurrente de Claude, pero cada petición al modelo consume uso de API de pago.
Sin suscripción no significa gratis ni ilimitado. Significa sustituir un plan recurrente y sus límites incluidos por facturación de API medida. Necesitas una cuenta autorizada y con saldo en la API o el gateway.
¿Claude Code requiere una suscripción?
No para el flujo local de terminal. Claude Code admite varias vías legítimas de autenticación y facturación:
| Vía | Cómo te autenticas | Cómo pagas | Cuándo encaja |
|---|---|---|---|
| Claude Pro, Max, Team o Enterprise | OAuth de la suscripción mediante /login | Plan recurrente con límites incluidos | Uso interactivo habitual y superficies alojadas de Claude |
| Claude Console | Login de Console o ANTHROPIC_API_KEY | Uso de la API de Anthropic | Equipos que quieren facturación directa de Anthropic API |
| Gateway LLM como OmniaKey | ANTHROPIC_BASE_URL más ANTHROPIC_AUTH_TOKEN | Saldo o contrato del gateway | Pago por uso, saldo común y consumo centralizado |
| Bedrock, Google Cloud o Foundry | Credenciales del proveedor cloud | Factura del proveedor cloud | Organizaciones estandarizadas en una plataforma cloud |
La documentación de autenticación de Anthropic coloca ANTHROPIC_AUTH_TOKEN por delante de ANTHROPIC_API_KEY y de las credenciales OAuth guardadas de una suscripción. Por eso una sesión de gateway bien configurada puede funcionar de forma independiente a una suscripción de Claude.
Este artículo cubre el CLI local de Claude Code y las herramientas que reutilizan su vía de credenciales. Claude Code on the Web siempre usa credenciales de suscripción; las claves API y los tokens de gateway del entorno no sustituyen esa superficie alojada.
Configura Claude Code con pago por uso en OmniaKey
1. Instala Claude Code
Sigue las instrucciones actuales de instalación de Claude Code de Anthropic y comprueba el comando:
claude --version
Instalar el cliente no financia las peticiones al modelo. La credencial del siguiente paso determina dónde se autorizan y se cobran.
2. Añade saldo a la cuenta API y crea una clave
Carga saldo en OmniaKey y crea una clave en el panel de API Keys. Usa una clave distinta para cada equipo o entorno de automatización; así podrás revocar una sin interrumpir las demás.
No subas la clave a un repositorio, no la dejes en un historial de shell compartido ni la publiques en un issue. Trátala como una contraseña.
3. Define la base URL y el bearer token
En macOS o Linux:
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
En PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
ANTHROPIC_AUTH_TOKEN se envía como credencial Authorization: Bearer. Anthropic documenta esta variable específicamente para gateways y proxies que autentican mediante bearer token.
Usa el host sin /v1. Claude Code añade /v1/messages por su cuenta. Si defines https://api.omniakey.com/v1, obtendrás la ruta incorrecta /v1/v1/messages.
La guía de clave API para Claude Code también cubre Windows, los ids de modelos y el contrato exacto del endpoint.
Para seguir la ruta más corta del producto, mantén abierta la configuración de Claude Code con OmniaKey mientras defines las dos variables.
4. Verifica qué vía de facturación está activa
Dentro de Claude Code ejecuta:
/status
Después haz una petición pequeña y de solo lectura y confirma que el uso aparece en el panel de OmniaKey. La verificación es importante: definir solo ANTHROPIC_BASE_URL no sustituye una credencial de suscripción guardada. Un gateway necesita tanto la base URL como su credencial.
Si también exportas ANTHROPIC_API_KEY en ese shell, elimínala para dejar clara la vía elegida:
unset ANTHROPIC_API_KEY
No borres una credencial a ciegas en automatización compartida. Identifica primero qué proveedor debe usar el job y conserva en su almacén de secretos solo esa credencial.
¿Cuánto cuesta Claude Code con pago por uso?
No existe una cifra mensual universal que sea honesta. Claude Code es un bucle de agente: lee contexto, genera salida, llama herramientas, recibe resultados y puede iniciar más trabajo. El modelo, el tamaño del repositorio, el contexto en caché, thinking, los reintentos, las definiciones MCP y las sesiones paralelas cambian la factura.
Estas son las tarifas actuales del catálogo de OmniaKey comprobadas el 7 de agosto de 2026, en USD por millón de tokens. Los precios pueden cambiar; comprueba el catálogo de modelos en vivo antes de presupuestar.
| Modelo | Entrada | Acierto de caché | Salida | Ejemplo: 1M entrada + 100K salida |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.20 | $0.02 | $1.00 | $0.30 |
| Claude Sonnet 5 | $0.60 | $0.06 | $3.00 | $0.90 |
| Claude Opus 5 | $1.00 | $0.10 | $5.00 | $1.50 |
El ejemplo usa entrada sin caché y excluye escrituras de caché, modificadores de contexto largo, modos especiales de velocidad, reintentos y turnos adicionales provocados por herramientas. Es una unidad comparable, no una predicción para una tarea completa.
La propia guía de costes de Anthropic dice que el gasto de API varía mucho y recomienda medir un piloto en vez de asumir que una media representa tu carga. El mismo principio vale para cualquier gateway: mide el coste de completar una tarea en tus repositorios.
Cuándo tiene sentido la facturación de API
El pago por uso suele encajar cuando:
- utilizas Claude Code de forma ocasional o por ráfagas, no cada día;
- quieres que el gasto siga las peticiones reales en vez de comprar otro seat;
- varias herramientas de programación deben compartir un saldo prepagado;
- necesitas claves revocables para equipos locales o CI;
- quieres usar un modelo económico en tareas rutinarias y escalar de forma explícita.
Una suscripción puede seguir siendo mejor si usas Claude Code intensamente cada día, quieres Claude Code on the Web, necesitas una función exclusiva de suscripción o prefieres comprar un seat predecible en vez de consumo medido. No des por hecho qué opción es más barata sin medir tu uso.
Mantén controlado el gasto de API
Para reducir el consumo real, y no solo poner un techo a la factura, sigue la guía para reducir el consumo de tokens de Claude Code. Cubre el contexto, la salida de herramientas, el effort y el coste por tarea aceptada.
Empieza las tareas rutinarias con el modelo adecuado
Usa Claude Sonnet 5 como opción equilibrada para el día a día, Claude Haiku 4.5 para tareas acotadas y repetibles, y Claude Opus 5 cuando la ambigüedad o el coste de equivocarse lo justifiquen. La guía de modelos para Claude Code ofrece una política más completa.
Limpia el contexto obsoleto entre tareas distintas
Las conversaciones largas vuelven a enviar más contexto. Renombra una sesión que quieras conservar y usa /clear antes de empezar trabajo no relacionado. Ahorras tokens sin perder la sesión guardada.
Desactiva las herramientas que no usas
Cada integración activa puede sumar definiciones y resultados al contexto. Mantén el conjunto MCP enfocado, no vuelques logs completos y filtra la salida extensa antes de que Claude la lea.
Evalúa el trabajo terminado, no una respuesta
Una tarifa por token más baja pierde la ventaja si el modelo necesita muchas correcciones. Mide el coste total de un arreglo fusionado, una review aceptada o una función con tests verdes, incluidos reintentos y limpieza humana.
Para los principios generales, lee cómo debería funcionar una facturación API transparente.
Errores habituales
Definir solo ANTHROPIC_BASE_URL
La URL cambia el destino de red, pero no necesariamente la credencial activa. Proporciona el ANTHROPIC_AUTH_TOKEN correspondiente y verifica el resultado.
Añadir /v1 a la base URL
Claude Code agrega la ruta de Messages API. Usa https://api.omniakey.com, no https://api.omniakey.com/v1.
Mezclar credenciales directas y de gateway
ANTHROPIC_AUTH_TOKEN tiene más prioridad que ANTHROPIC_API_KEY, pero dejar secretos ajenos en el mismo entorno dificulta el diagnóstico. Da a cada shell o job una única vía de facturación intencionada.
Esperar que el producto Web alojado use la clave API
Claude Code on the Web utiliza credenciales de suscripción. Esta configuración de pago por uso es para superficies locales basadas en el CLI; no desbloquea funciones alojadas de una suscripción.
Interpretar “sin suscripción” como “sin pago”
La facturación API sigue necesitando fondos. Un saldo cero, una clave revocada o un límite de gasto detienen las peticiones igual que un límite de plan.
Preguntas frecuentes
¿Puedo usar Claude Code sin Claude Pro o Max?
Sí. El CLI local puede autenticarse mediante Claude Console API, un proveedor cloud compatible o un gateway LLM. Sigues necesitando credenciales válidas y una cuenta financiada en el proveedor elegido.
¿Es gratis usar Claude Code API sin suscripción?
No. Las llamadas al modelo se miden en la cuenta API o del gateway. “Pago por uso” describe el esquema de facturación, no acceso gratuito.
¿Una clave API consume el límite de mi suscripción de Claude?
No cuando está activa la credencial API o de gateway prevista. Anthropic coloca esas credenciales antes que el OAuth guardado de la suscripción. Comprueba /status y el panel de consumo del proveedor en lugar de asumirlo.
¿Puedo usar esta configuración en Claude Code on the Web?
No. Anthropic indica que el producto Web alojado siempre usa credenciales de suscripción y no permite que las claves API del entorno las sustituyan.
¿Qué variable de OmniaKey debe usar Claude Code?
Usa ANTHROPIC_AUTH_TOKEN para el bearer token de OmniaKey y ANTHROPIC_BASE_URL=https://api.omniakey.com. No añadas /v1 al final de la URL.
Fuentes
- Anthropic: autenticación de Claude Code
- Anthropic: gestión de costes de Claude Code
- Anthropic: conectar Claude Code a un gateway LLM
- Anthropic: precios de Claude API
- Guía de OmniaKey para la clave API de Claude Code
Datos comprobados el 7 de agosto de 2026. La autenticación, la disponibilidad de modelos y las tarifas pueden cambiar; verifica la documentación primaria y el catálogo en vivo antes de depender de ellos.