# Claude Code API sin suscripción

> Claude Code API sin suscripción: usa una API key con pago por uso. Configura ANTHROPIC_API_KEY, o ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN.

- Canonical HTML: https://omniakey.com/es/blog/claude-code-api-without-subscription
- Markdown: https://omniakey.com/es/blog/claude-code-api-without-subscription.md
- Published: 2026-08-07 (updated 2026-10-24)
- Author: Kiki, COO at OmniaKey
- Language: es
- Category: Guide
- Reading time: 11 min
- All posts: https://omniakey.com/blog/llms.txt

---

**Respuesta corta:** desde el 24 de octubre de 2026, Claude Code funciona sin plan Pro ni Max en cuanto le das una API key. Con una key de Anthropic Console configura `ANTHROPIC_API_KEY` y Claude Code se salta el login cuando apruebas la key. Con una key de OmniaKey configura `ANTHROPIC_BASE_URL=https://api.omniakey.com` y `ANTHROPIC_AUTH_TOKEN`, y arranca Claude Code desde esa misma shell. A precio de lista de Anthropic, Sonnet 5.5 cuesta $2 por millón de tokens de entrada y $10 de salida.

```bash
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
```

Actualizado el 24 de octubre de 2026: los nombres y precios siguen ya el catálogo actual de Anthropic (Sonnet 5.5, Opus 5.5, Haiku 5.5, Fable 5.1) y el ejemplo de coste está recalculado con las tarifas del 24 de octubre.

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.

> **Sin suscripción no significa gratis ni ilimitado.**
>
> &#x20;Sustituyes un plan recurrente por facturación API medida y necesitas una cuenta autorizada con saldo.

## ¿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](https://code.claude.com/docs/en/setup) y comprueba:

```bash
claude --version
```

### 2. Añadir saldo y crear una key

Carga saldo en OmniaKey y crea una clave en el [dashboard de API Keys](https://omniakey.com/es/dashboard/tokens). 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

```bash
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
```

```powershell
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
```

> **Usa el host sin `/v1`.**
>
> &#x20;Claude Code añade&#x20;
>
> `/v1/messages`
>
> ; incluir&#x20;
>
> `/v1`
>
> &#x20;produciría&#x20;
>
> `/v1/v1/messages`
>
> .

Consulta el [guía de API key de Claude Code](https://docs.omniakey.com/es/guides/claude-code-api-key) y el [setup de Claude Code con OmniaKey](https://omniakey.com/es/blog/claude-code-setup).

### 4. Verificar la vía de facturación

```text
/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:

```bash
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 de la API de Anthropic verificadas el 24 de octubre de 2026 (USD por millón de tokens). Comprueba el [catálogo de modelos](https://omniakey.com/es/models) antes de fijar un presupuesto:

|Modelo|Entrada|Lectura de caché|Salida|100K entrada + 20K salida|
|-|-:|-:|-:|-:|
|[Claude Haiku 5.5](https://omniakey.com/es/claude-haiku-5-5)|desde $0.10|$0.01|desde $0.50|**$0.02**|
|[Claude Sonnet 5.5](https://omniakey.com/es/claude-sonnet-5-5)|$2|$0.10|$10|**$0.40**|
|[Claude Opus 5.5](https://omniakey.com/es/claude-opus-5-5)|$4|$0.20|$20|**$0.80**|
|[Claude Fable 5.1](https://omniakey.com/es/claude-fable-5-1)|$10|$0.25|$50|**$2.00**|

Para Sonnet 5.5 la cuenta es 100K de entrada × $2 por millón = $0.20, más 20K de salida × $10 por millón = $0.20, es decir **$0.40** por petición. Opus 5.5 sale a $0.40 + $0.40 = $0.80, Fable 5.1 a $1.00 + $1.00 = $2.00 y Haiku 5.5 a $0.01 + $0.01 = $0.02 con su tarifa para prompts de hasta 100K tokens.

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](https://omniakey.com/es/blog/reduce-claude-code-token-usage), que cubre contexto, salida de tools, effort y coste por tarea completada.

### Empezar con el modelo adecuado

Empieza con [Claude Sonnet 5.5](https://omniakey.com/es/claude-sonnet-5-5) como opción equilibrada: `/model claude-sonnet-5-5` lo fija y `/model sonnet` sigue el alias. Para tareas estrechas y repetibles usa [Claude Haiku 5.5](https://omniakey.com/es/claude-haiku-5-5), y [Claude Opus 5.5](https://omniakey.com/es/claude-opus-5-5) cuando la ambigüedad o el coste del error lo justifiquen. [Claude Fable 5.1](https://omniakey.com/es/claude-fable-5-1) es para sesiones de agente que duran horas. La [guía de modelos](https://omniakey.com/es/blog/best-model-for-claude-code) te ayuda a elegir.

### 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](https://omniakey.com/es/blog/transparent-billing) 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](https://code.claude.com/docs/en/authentication)
- [Anthropic: manage Claude Code costs](https://code.claude.com/docs/en/costs)
- [Anthropic: connect Claude Code to an LLM gateway](https://code.claude.com/docs/en/llm-gateway-connect)
- [Anthropic: Claude API pricing](https://platform.claude.com/docs/en/about-claude/pricing)
- [OmniaKey Claude Code API key guide](https://docs.omniakey.com/es/guides/claude-code-api-key)

_Datos comprobados el 24 de octubre de 2026. La autenticación, disponibilidad y tarifas pueden cambiar; verifica las fuentes primarias y el catálogo vivo._
