Usa Claude Code con tu propia clave de API
Define dos variables de entorno y Claude Code funciona con tu clave de UplinkSwitch. Misma herramienta, mismos modelos, precios en vivo.
Revisado 2026-11-13
Qué necesitas
- Claude Code instalado, con
claudeen tu PATH. - Una clave de UplinkSwitch de la consola, con saldo cargado. El saldo es prepago desde $10 con tarjeta, WeChat Pay, Apple Pay, Google Pay o cripto.
Dos variables
ANTHROPIC_BASE_URLapunta Claude Code a UplinkSwitch. Pégala con el/v1. El gateway acepta la ruta que Claude Code construye a partir de ella.ANTHROPIC_AUTH_TOKENenvía la clave comoAuthorization: Bearer.ANTHROPIC_API_KEYfunciona en su lugar y envía la clave comox-api-key. Define una, no las dos.- Una solicitud que lleva dos claves distintas se rechaza con un
400. - La URL base sola no basta. Sin una de las variables de clave, Claude Code sigue usando un inicio de sesión guardado de claude.ai.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudeHazlo permanente en settings.json
Añade las dos variables a ~/.claude/settings.json dentro de env y se aplican a todos los proyectos. .claude/settings.local.json se aplica a un solo proyecto.
- Tres variables más nombran los modelos detrás de los alias:
ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_SONNET_MODELyANTHROPIC_DEFAULT_HAIKU_MODEL. Ponlas en id comoclaude-opus-5-5,claude-sonnet-5-5yclaude-haiku-5-5. - No pongas la clave en el
.claude/settings.jsonde un proyecto. Ese archivo está pensado para subirse al repositorio y compartirse. - Cuando un export del shell y un archivo de ajustes definen la misma variable, gana el archivo de ajustes.
- La extensión de VS Code lee las credenciales de su propio ajuste,
claudeCode.environmentVariables, en los ajustes de usuario de VS Code.
Elegir un modelo
Los alias opus, sonnet y haiku se resuelven a lo que nombren las tres variables de modelo. Definir la de Haiku también mueve a ese modelo el trabajo en segundo plano, como los títulos de sesión. Cambia de modelo dentro de una sesión con /model, al arrancar con claude --model claude-opus-5-5, o para una sola sesión con ANTHROPIC_MODEL.
Claude Code habla el formato de API de Anthropic, y aquí todos los modelos de chat se sirven en él, incluidos GPT, Gemini, DeepSeek, Kimi y las versiones sin censura. Cualquier id de chat de la lista de modelos funciona en las mismas variables y se responde como una respuesta Messages, llamadas a herramientas incluidas.
Cuánto cuesta Claude Code con esta clave
La tabla muestra los modelos Claude por millón de tokens, en vivo desde el catálogo, junto al precio de lista que publica Anthropic. Todos los modelos Claude de la clave están en la página de precios de la API de Claude.
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 a la tarifa de caché, una fracción de la tarifa de entrada. La caché dura cinco minutos por defecto, así que un turno tras una pausa más larga paga una vez la tarifa de entrada por todo el contexto.
El costo que muestra Claude Code es su propia estimación al precio de lista de Anthropic. Lo que pagaste está en la página Uso de la consola.
| Modelo | Entrada | Entrada en caché | Salida | Contexto |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00Precio de lista $8.00 | $0.10Precio de lista $0.20 | $20.00Precio de lista $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00Precio de lista $10.00 | $2.00Precio de lista $0.25 | $30.00Precio de lista $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716Precio de lista $4.00 | $0.1455Precio de lista $0.20 | $9.70Precio de lista $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20Precio de lista $2.00 | $0.075Precio de lista $0.10 | $3.00Precio de lista $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582Precio de lista $0.10 | $0.01Precio de lista $0.01 | $0.1455Precio de lista $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00Precio de lista $10.00 | $0.30Precio de lista $1.00 | $15.00Precio de lista $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80Precio de lista $5.00 | $0.16Precio de lista $0.50 | $7.50Precio de lista $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20Precio de lista $2.00 | $0.12Precio de lista $0.20 | $3.00Precio de lista $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80Precio de lista $5.00 | $0.16Precio de lista $0.50 | $7.50Precio de lista $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80Precio de lista $5.00 | $0.16Precio de lista $0.50 | $7.50Precio de lista $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80Precio de lista $5.00 | $0.16Precio de lista $0.50 | $7.50Precio de lista $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80Precio de lista $3.00 | $0.18Precio de lista $0.30 | $9.00Precio de lista $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60Precio de lista $1.00 | $0.06Precio de lista $0.10 | $3.00Precio de lista $5.00 | 200,000 |
USD por millón de tokens
Comprueba que funciona
Envía un mensaje pequeño. Con -i, curl imprime las cabeceras de la respuesta: x-uplink-request-id identifica la solicitud y x-uplink-charge es lo que costó en USD.
Después ejecuta claude. La solicitud aparece en la consola en segundos. Dentro de Claude Code, /status muestra una línea Anthropic base URL con la dirección de UplinkSwitch y una línea que nombra la variable de clave que definiste. Si falta la línea de la URL base, la variable no llegó a la sesión.
curl -i https://api.uplinkswitch.com/v1/messages \
-H "Authorization: Bearer sk-uplink-live-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'Errores y soluciones
invalid_api_key(401): la clave es incorrecta o está revocada, o está en una variable que Claude Code no leyó. Revisa/status.insufficient_balance(402): recarga en la consola.monthly_limit_reached(402) significa que la clave alcanzó el límite de gasto mensual que tiene configurado.model_not_found(404): el id no está en la lista de modelos. Revisa si hay erratas en las variables de modelo.- Claude Code te pide iniciar sesión aunque la prueba con curl funciona: define la clave en un export del shell o en
~/.claude/settings.json. Un archivo de ajustes de proyecto solo se aplica después de la configuración inicial y del aviso de confianza. - Un aviso al arrancar nombra dos fuentes de credenciales: hay un inicio de sesión guardado y la variable activos a la vez. Ejecuta
/logoutpara quedarte solo con la clave. ANTHROPIC_API_KEYestá definida pero se ignora: necesita una aprobación única. Activa Use custom API key en/config, o usaANTHROPIC_AUTH_TOKEN.
Preguntas
Consigue una clave para Claude Code
Dos variables, prepago desde $10, sin suscripción, y con bloqueo de precios de 30 días en cada recarga.
Consigue una clave