Claude Code con una API key prepago
Claude Code lee la dirección del endpoint de ANTHROPIC_BASE_URL y la credencial de ANTHROPIC_AUTH_TOKEN. Apunta las dos a RelaySwitch y cada turno se descuenta por token del saldo prepago que recargas con tarjeta o cripto. La misma key da acceso a 13 modelos Claude.
01Dos formas de iniciar sesión en Claude Code y la que se usa aquí
Claude Code tiene dos identidades. La primera inicia sesión con una cuenta de claude.ai mediante /login y consume la cuota de la suscripción. La segunda usa una API key y se cobra por token. Las dos pueden convivir en la misma máquina, pero una sesión solo usa una de ellas.
Esta página trata la segunda. Una vez definida ANTHROPIC_AUTH_TOKEN, las peticiones llevan esa credencial y no el inicio de sesión de claude.ai, así que no necesitas cuenta en claude.ai ni en el desarrollador del modelo. Tu cuenta está en RelaySwitch y se abre con un email.
02Dos variables de entorno en macOS, Linux y WSL
Pruébalo primero en la terminal que tengas abierta. Sustituye el valor por tu API key, que empieza por sk-relay-, y ejecuta claude.
ANTHROPIC_BASE_URLindica adónde se envían las peticiones. Los ejemplos de este sitio usan https://api.relayswitch.io/v1; la dirección se acepta igual con o sin/v1al final.ANTHROPIC_AUTH_TOKENenvía la key comoAuthorization: Bearer.ANTHROPIC_API_KEYtambién sirve y se envía comox-api-key, pero en modo interactivo hay que aprobarla una vez. Usa solo una de las dos: una petición que lleva dos keys distintas se rechaza con un 400.- La Base URL sola no basta. Sin una de las variables de key, Claude Code sigue usando el inicio de sesión de claude.ai que tenga guardado.
export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"export ANTHROPIC_AUTH_TOKEN="sk-relay-..."claude03Windows PowerShell
Claude Code funciona de forma nativa en Windows, así que WSL no es obligatorio. En PowerShell, las mismas dos variables se escriben con esta sintaxis.
$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."claude04Para que se guarden: settings.json y VS Code
Las variables definidas en la terminal solo valen para esa ventana. Para que se apliquen a todos los proyectos y a todas las formas de lanzar Claude Code, escríbelas en el bloque env de ~/.claude/settings.json (en Windows: %USERPROFILE%\.claude\settings.json). Si la misma variable está en la terminal y en este archivo, gana el archivo de settings.
No guardes la key en el .claude/settings.json del proyecto, porque ese archivo está pensado para entrar en los commits. La extensión de VS Code lee su propio ajuste, claudeCode.environmentVariables, en los user settings de VS Code. La aplicación de escritorio no lee estas dos variables de entorno.
Los pasos completos, con un ejemplo del contenido del archivo, están en la guía de Claude Code (en inglés).
05Comprobar que las peticiones pasan de verdad por tu key
Prueba primero sin Claude Code: envía una petición pequeña directamente al endpoint Messages. Una respuesta 200 con JSON significa que la dirección y la key son correctas.
Después ejecuta claude, envía un mensaje y escribe /status. Debe aparecer una línea Anthropic base URL que apunte a RelaySwitch y una línea Auth token que nombre la variable que definiste. Si la línea de la base URL no aparece, la variable no llegó a esa sesión. La petición se ve en la página Usage de la consola en cuestión de segundos.
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'06Elegir modelo: opus, sonnet, haiku
El comando /model cambia entre tres alias. A qué id apunta cada alias lo deciden ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL; las tres admiten cualquier id de Claude de la tabla de abajo. Para una sola sesión, usa ANTHROPIC_MODEL o claude --model seguido del id.
La diferencia de costo viene sobre todo del precio de output y del precio de cached input. Un patrón que ahorra: sonnet para el trabajo diario, y pasar a un modelo más caro solo cuando sonnet falla varias veces con el mismo problema.
Los id de GPT, Gemini o DeepSeek también responden en Claude Code, porque el gateway traduce la petición Messages al formato de ese modelo. Pero Anthropic no da soporte a Claude Code con modelos que no son Claude, así que el tool use puede funcionar peor con ellos.
| Modelo | Desarrollador | Input | Output | Contexto |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
USD por millón de tokens
07Caché, costos y límites por key
Claude Code envía toda la conversación en cada turno y la marca para el prompt cache. Los tokens leídos de la caché se cobran al precio de cached input, más bajo que el de input. La caché dura cinco minutos por defecto, así que el primer turno tras una pausa larga paga una vez el precio de input por todo el contexto.
La cifra de costo que muestra Claude Code es su propia estimación, basada en los precios oficiales de Anthropic. Lo que se descuenta de verdad queda registrado en la página Usage de la consola y en el recibo de cada petición.
Un agente de programación envía muchas peticiones seguidas y, si algo va mal, el saldo se consume rápido. Crea una key solo para Claude Code y ponle un presupuesto en dólares y un límite de gasto diario: al alcanzar el límite, el gateway responde 402 y solo se detiene esa key, mientras el resto del saldo de la cuenta queda intacto. La misma key puede llevar una lista de modelos permitidos. Cómo crear la key se explica en la página de Claude API key.
Preguntas frecuentes
- ¿Necesito una cuenta de claude.ai o una suscripción para usar Claude Code con API key?
- No. Una vez definida ANTHROPIC_AUTH_TOKEN, las peticiones llevan esa credencial y no el inicio de sesión de claude.ai, y los límites de uso de la suscripción no se aplican. Tu cuenta está en RelaySwitch, se abre con un email y cada turno se descuenta del saldo prepago.
- ¿ANTHROPIC_BASE_URL debe terminar en /v1 o no?
- Se aceptan las dos formas. Los ejemplos de este sitio usan https://api.relayswitch.io/v1. Claude Code añade /v1/messages detrás de esa dirección y el gateway resuelve el /v1 repetido.
- Ya definí las variables, ¿por qué Claude Code sigue pidiendo iniciar sesión?
- Las variables no llegan a ese proceso. Un editor abierto desde el Dock o desde el menú Inicio no lee los export de la terminal. Escribe las dos variables en el bloque env de ~/.claude/settings.json, ejecuta /status y comprueba que aparece la línea Anthropic base URL.
- ¿Cuánto cuesta una sesión de programación?
- Depende del modelo y de la longitud del contexto. La mayor parte del input de una sesión de programación es contexto que se reenvía y se cobra al precio de cached input, así que el costo lo marcan sobre todo el precio de caché y el de output. La tabla de esta página muestra los precios actuales por millón de tokens, y el costo real figura en el recibo de cada petición.
- ¿Cómo pago sin tarjeta de crédito?
- Recarga con USDT, USDC, BTC, ETH, SOL en la consola, desde $10. También se aceptan tarjetas, incluidas Apple Pay y Google Pay. El saldo se lleva en dólares estadounidenses, no caduca y no hay suscripción.
- ¿Cómo sé que quien responde es Claude?
- Cada modelo recibe el mismo prompt de prueba una vez al día y su respuesta se compara con los resultados anteriores; los resultados están abiertos en https://api.relayswitch.io/v1/proof sin API key. Cada petición tiene además un recibo firmado que registra el id del modelo, los tokens cobrados y el costo.
Dos variables y ejecuta claude
Crea una API key en la consola, recarga desde $10 con tarjeta o cripto y Claude Code funciona con tu saldo prepago.