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.

Consigue una clave

Revisado 2026-11-13

Qué necesitas

  • Claude Code instalado, con claude en 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_URL apunta Claude Code a UplinkSwitch. Pégala con el /v1. El gateway acepta la ruta que Claude Code construye a partir de ella.
  • ANTHROPIC_AUTH_TOKEN envía la clave como Authorization: Bearer. ANTHROPIC_API_KEY funciona en su lugar y envía la clave como x-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.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

Hazlo 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_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL. Ponlas en id como claude-opus-5-5, claude-sonnet-5-5 y claude-haiku-5-5.
  • No pongas la clave en el .claude/settings.json de 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.

ModeloEntradaEntrada en cachéSalidaContexto
Claude Fable 5.2claude-fable-5.2Anthropic$4.00Precio de lista $8.00$0.10Precio de lista $0.20$20.00Precio de lista $40.001,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.001,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.001,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.001,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.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00Precio de lista $10.00$0.30Precio de lista $1.00$15.00Precio de lista $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80Precio de lista $5.00$0.16Precio de lista $0.50$7.50Precio de lista $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20Precio de lista $2.00$0.12Precio de lista $0.20$3.00Precio de lista $10.001,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.001,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.001,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.001,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.001,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.00200,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
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 /logout para quedarte solo con la clave.
  • ANTHROPIC_API_KEY está definida pero se ignora: necesita una aprobación única. Activa Use custom API key en /config, o usa ANTHROPIC_AUTH_TOKEN.

Preguntas

Sí. Aquí todos los modelos de chat se sirven en el formato de Anthropic, así que un id de GPT, Gemini, DeepSeek o sin censura funciona en las variables de modelo y se responde como una respuesta Messages, llamadas a herramientas incluidas.

Sí. La entrada en caché se cobra a la tarifa de caché. En el registro de una solicitud, un conteo de tokens de lectura de caché mayor que cero significa que la caché funcionó.

Remote Control y el dictado por voz necesitan un inicio de sesión de claude.ai, así que están desactivados mientras haya una variable de clave definida. La búsqueda de herramientas MCP está desactivada en un host que no es de Anthropic, y definir ENABLE_TOOL_SEARCH=true la activa.

Quita las variables ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN, y bórralas de settings.json si las pusiste ahí.

La página Uso de la consola muestra lo que pagaste. Para una sola solicitud, búscala por su request id. El registro lista los tokens de entrada, los tokens de lectura de caché, los tokens de salida y el cargo en USD, y llega al log en cerca de un minuto.

El saldo es prepago desde $10 en la consola, con tarjeta, WeChat Pay, Apple Pay, Google Pay o cripto, sin suscripción. Cada recarga bloquea tus precios durante 30 días.

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
Join on Telegram