Inicio → Guías → Base URL de Anthropic para Claude Code: configurar bien ANTHROPIC_BASE_URL

Base URL de Anthropic para Claude Code: configurar bien ANTHROPIC_BASE_URL

Claude Code se conecta a la dirección a la que apunte ANTHROPIC_BASE_URL. La única regla que hace tropezar: quiere solo el host, sin /v1, justo al revés que casi todas las herramientas de tipo OpenAI.

La respuesta corta

Define dos variables de entorno antes de iniciar Claude Code:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

La dirección oficial de Anthropic es https://api.anthropic.com; para un relé basta con sustituirla. Claude Code añade /v1/messages por su cuenta, así que la base URL termina en el host. En esta pasarela, el 88 % de todo el tráfico de Claude de los últimos 30 días vino de Claude Code configurado exactamente así.

Dónde configurarlo

macOS / Linux — en la terminal desde la que lo lanzas:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — para la ventana actual:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — para que todas las sesiones lo usen sin tocar la terminal:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

El valor se lee al iniciar Claude Code. Si lo cambias, sal y abre una sesión nueva; una sesión abierta conserva la dirección antigua. ANTHROPIC_AUTH_TOKEN se envía como Authorization: Bearer; ANTHROPIC_API_KEY, como x-api-key. Esta pasarela acepta cualquiera de los dos: usa uno, no ambos.

Pruébalo con un comando

Antes de culpar a Claude Code, comprueba directamente la dirección y la clave:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Una respuesta JSON significa que ambas están bien. text/html o un 404 significa que la URL está mal; un 401 en JSON significa que la URL es correcta y la clave no.

Cuándo añadir /v1 y cuándo no

Dos familias de SDK cortan la URL en puntos distintos. Los clientes de tipo Anthropic añaden /v1/messages ellos mismos; los de tipo OpenAI esperan /v1 en la base URL y solo añaden /chat/completions:

Cliente	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Con /v1 en Claude Code las peticiones van a /v1/v1/messages y devuelven 404. Sin /v1 en Cursor van a /chat/completions, también 404. Ninguna llega a la API.

¿Error de URL o error de clave?

• Un error y nada en tu registro de uso → la ruta está mal. Un 404 se responde en el borde de la red y nunca llega a facturación. Revisa /v1 primero.
• 401 con entrada en el registro → la clave es incorrecta, está revocada o el saldo está vacío.
• Un modelo da 404 y los demás funcionan con la misma clave → ese modelo pertenece a otro grupo. Cada clave está ligada a un grupo; crea una segunda para el otro.
• Un cambio parece no surtir efecto → la variable se definió en otra terminal o la sesión empezó antes.

Elegir el modelo

Los nombres de modelo son cadenas exactas con guiones, nunca puntos: claude-fable-5-1, no claude-fable-5.1. Elígelo al iniciar o con /model dentro de una sesión:

claude --model claude-opus-5-5

Los nombres y precios actuales están en la lista de precios. La configuración de otros clientes está en el inicio rápido, y la app Claude Desktop en la guía de aplicaciones de escritorio.

Empieza a usarlo

Sin suscripción, sin mínimo mensual, sin llamada comercial. Recarga con USDT y gasta lo que uses — 1 USDT te da 2 créditos de saldo de API.

Lee el inicio rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Los precios de esta página se rellenan automáticamente con datos de facturación reales. Las condiciones de terceros se citan de su propia documentación.