Claude Code API sin suscripción
El terminal local de Claude Code puede usar API billing en lugar de un plan mensual de Claude. Las llamadas siguen siendo de pago; cambia la autenticación.
Puedes usar Claude Code API sin suscripción en el terminal local eligiendo un proveedor con facturación API en vez de iniciar sesión con un plan Claude.ai. Anthropic admite Console API, proveedores cloud y LLM gateways además de Pro, Max, Team y Enterprise.
Con OmniaKey cargas saldo prepago, creas una API key y das a Claude Code una Base URL compatible con Anthropic junto con un bearer token. No hay suscripción recurrente, pero cada petición al modelo consume API de pago.
¿Claude Code requiere suscripción?
No para el terminal local. Las rutas principales son:
| Vía | Autenticación | Pago | Encaja cuando |
|---|---|---|---|
| Pro, Max, Team, Enterprise | OAuth de suscripción mediante /login | Plan recurrente | Uso interactivo y superficies alojadas |
| Claude Console | Login de Console o ANTHROPIC_API_KEY | Uso de Anthropic API | Facturación directa |
| Gateway LLM como OmniaKey | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN | Saldo/contrato del gateway | Pago por uso y consumo centralizado |
| Bedrock, Google Cloud, Foundry | Credenciales cloud | Factura cloud | Organizaciones estandarizadas en cloud |
Anthropic prioriza ANTHROPIC_AUTH_TOKEN sobre ANTHROPIC_API_KEY y credenciales OAuth guardadas. Claude Code on the Web siempre usa credenciales de suscripción; las variables de entorno no sobrescriben esa superficie.
Configurar Claude Code con pago por uso en OmniaKey
1. Instalar Claude Code
Sigue las instrucciones oficiales y comprueba:
claude --version
2. Añadir saldo y crear una key
Carga saldo en OmniaKey y crea una clave en el dashboard de API Keys. Usa una key distinta por máquina o entorno de automatización y no la guardes en repositorios, historiales o issues.
3. Definir Base URL y bearer token
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
/v1. Claude Code añade /v1/messages; incluir /v1 produciría /v1/v1/messages.Consulta el guía de API key de Claude Code y el setup de Claude Code con OmniaKey.
4. Verificar la vía de facturación
/status
Haz una petición pequeña de solo lectura y confirma el uso en el dashboard. Solo ANTHROPIC_BASE_URL no sustituye una credencial de suscripción. Si ANTHROPIC_API_KEY también está exportada, identifica primero la vía correcta antes de ejecutar:
unset ANTHROPIC_API_KEY
Coste de Claude Code por uso
El agente repite lecturas, output, tools y context; el coste depende de cache, thinking, retries, MCP y sesiones paralelas.
Tarifas actuales de OmniaKey verificadas el 18 de septiembre de 2026 (USD por millón de tokens). Comprueba el catálogo de modelos antes de fijar un presupuesto:
| Modelo | Input | Cache hit | Output | Ejemplo: 1M input + 100K output |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.28 | $0.028 | $1.40 | $0.42 |
| Claude Sonnet 5 | $0.84 | $0.084 | $4.20 | $1.26 |
| Claude Opus 5 | $1.40 | $0.14 | $7.00 | $2.10 |
El ejemplo excluye cache writes, modifiers de contexto largo, retries y turnos adicionales de tools.
Cuándo tiene sentido la API
El pago por uso encaja cuando:
- Claude Code se usa de forma ocasional o por ráfagas;
- quieres que el gasto siga a las peticiones reales;
- varias herramientas deben compartir un saldo prepago;
- necesitas keys revocables para máquinas locales o CI;
- quieres empezar con un modelo barato y escalar de forma explícita.
Un plan puede ser mejor para uso diario intensivo, Web o funciones exclusivas. Mide tu carga antes de comparar.
Controlar el gasto
Lee la guía para reducir tokens de Claude Code, que cubre contexto, salida de tools, effort y coste por tarea aceptada.
Empezar con el modelo adecuado
Usa Claude Sonnet 5 como opción equilibrada, Claude Haiku 4.5 para tareas estrechas y repetibles, y Claude Opus 5 cuando la ambigüedad o el coste del error lo justifiquen. Consulta la guía de modelos, además de las páginas de Sonnet, Haiku y Opus.
Limpiar contexto antiguo entre tareas no relacionadas
Las conversaciones largas reenvían más contexto. Renombra las sesiones que quieras conservar y usa /clear antes de empezar una tarea independiente.
Desactivar tools que no uses
Mantén solo los MCP necesarios, filtra logs grandes y reduce la salida antes de que entre en el contexto.
Medir el coste de la tarea aceptada
Mide una corrección fusionada, una review aceptada o una feature que supera los checks, incluidos retries y corrección humana. La guía de facturación transparente explica cómo reconciliar el gasto.
Errores comunes
Solo definir ANTHROPIC_BASE_URL
La URL cambia el destino, no la credencial. Añade ANTHROPIC_AUTH_TOKEN y verifica /status.
Añadir /v1
Usa https://api.omniakey.com, no https://api.omniakey.com/v1; Claude Code añade el path Messages.
Mezclar credenciales
ANTHROPIC_AUTH_TOKEN tiene prioridad sobre ANTHROPIC_API_KEY. Deja un único camino de facturación intencional por shell o job.
Esperar que Web use la API key
Claude Code on the Web usa suscripciones; esta configuración es para superficies locales de CLI.
Confundir sin suscripción con sin pago
API billing necesita saldo, una key activa y límites suficientes.
Medir una tarea completa
Una tarifa por token solo es un punto de partida. Un agente puede repetir una lectura, llamar a una herramienta varias veces o necesitar correcciones humanas antes de que el cambio sea aceptable.
Para comparar rutas de forma reproducible, fija el mismo commit del repositorio, prompt, modelo, permisos, herramientas y comando de aceptación. Registra:
- el model ID y el protocolo;
- input sin cache, cache writes y cache reads;
- output y esfuerzo de razonamiento;
- llamadas a tools y reintentos;
- tiempo transcurrido y uso del saldo;
- si el resultado pasó una revisión independiente.
El coste de una tarea aceptada incluye los intentos fallidos y el tiempo de corrección. No declares que una ruta es más barata solo porque una respuesta aislada tenga una tarifa menor.
Estas medidas hacen visible la diferencia entre una petición barata y una tarea realmente terminada. Repite la prueba cuando cambien el modelo, el prompt o la configuración de tools.
Guarda el resultado junto al commit para que el presupuesto futuro se base en evidencia.
FAQ
¿Puedo usar Claude Code sin Pro o Max?
Sí. La CLI local puede usar Console API, cloud provider o LLM gateway con credenciales y saldo válidos.
¿La API es gratis sin suscripción?
No. Las llamadas se miden contra la cuenta API o gateway.
¿La API key consume mi allowance de suscripción?
No cuando la credencial API/gateway está activa. Comprueba /status y el dashboard.
¿Funciona en Claude Code on the Web?
No. El producto Web usa credenciales de suscripción.
¿Qué variables usa OmniaKey?
ANTHROPIC_AUTH_TOKEN para el bearer token y ANTHROPIC_BASE_URL=https://api.omniakey.com, sin /v1.
Fuentes comprobadas
- Anthropic: Claude Code authentication
- Anthropic: manage Claude Code costs
- Anthropic: connect Claude Code to an LLM gateway
- Anthropic: Claude API pricing
- OmniaKey Claude Code API key guide
Datos comprobados el 18 de septiembre de 2026. La autenticación, disponibilidad y tarifas pueden cambiar; verifica las fuentes primarias y el catálogo vivo.