Costes y límites

Cómo configurar ANTHROPIC_BASE_URL y la API Key en Claude Code

Configura ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN en Claude Code, evita conflictos entre ajustes y verifica la conexión sin exponer tu API Key.

BetterToken

Equipo editorial

14 ago 20266 min de lectura

Cómo configurar ANTHROPIC_BASE_URL y la API Key en Claude Code

Para conectar Claude Code a BetterToken, configura ANTHROPIC_BASE_URL=https://bettertoken.ai —sin /v1— y proporciona tu API Key mediante ANTHROPIC_AUTH_TOKEN. Lo más práctico es guardar ambos valores en ~/.claude/settings.json: se aplicarán a todos tus proyectos y no tendrás que añadir la clave a cada repositorio.

La guía actualizada de BetterToken para Claude Code reúne un ejemplo compatible y las opciones para VS Code. En esta configuración, BetterToken ofrece acceso independiente a la API con pago por uso; no convierte una API Key en una suscripción de Claude ni modifica las condiciones de la cuenta de Anthropic.

Si todavía no tienes una clave, inicia sesión primero en BetterToken Workspace, crea tu propia API Key y comprueba en la guía actual qué group o mapping requiere el modelo elegido. No uses una clave compartida del equipo ni un group antiguo copiado de otro ejemplo: los pasos siguientes presuponen que ya dispones de una clave propia adecuada.

Los dos valores que necesitas

Campo	Valor para BetterToken	Error habitual
`ANTHROPIC_BASE_URL`	`https://bettertoken.ai`	Añadir `/v1`, que corresponde a clientes OpenAI-compatible
`ANTHROPIC_AUTH_TOKEN`	`YOUR_API_KEY`	Pegar la clave con espacios, comillas copiadas del gestor de contraseñas o guardarla en un archivo público

Claude Code utiliza el protocolo de Anthropic. Por eso su dirección no coincide con la de Codex y otros clientes OpenAI-compatible, que normalmente necesitan `https://www.bettertoken.ai/v1%60.?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka

Paso 1. Elimina variables que puedan entrar en conflicto

Antes de cambiar la configuración, comprueba si quedan valores anteriores:


printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"

No muestres el token en la terminal. Si esas variables están definidas en el shell actual y quieres que prevalezca el archivo de configuración, elimínalas:


unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN

Después revisa ~/.zshrc, ~/.bashrc, los archivos .env, la configuración del IDE y cualquier gestor de proveedores. Un proceso que ya estaba en ejecución puede conservar las variables que heredó al arrancar, incluso después de editar el archivo.

Paso 2. Añade la configuración de usuario

Según la documentación oficial de Claude Code, la configuración de usuario se guarda en ~/.claude/settings.json, la del proyecto en .claude/settings.json y la configuración local del proyecto en .claude/settings.local.json.

Para BetterToken, añade este bloque:


{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai/?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-015&utm_content=anthropic-base-url-api-key-nastroyka",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "3000000"
  }
}

Sustituye únicamente YOUR_API_KEY. Si el archivo ya contiene permissions, hooks, plugins u otros campos, no lo sobrescribas por completo: añade o combina el objeto env y asegúrate de que el resultado siga siendo JSON válido.

Restringe el acceso al archivo y comprueba después que los permisos se hayan aplicado:


chmod 600 ~/.claude/settings.json
ls -l ~/.claude/settings.json

En la salida no deben aparecer permisos de lectura ni escritura para el grupo o para otros usuarios. No adjuntes el archivo completo a un issue. En equipos, no publiques un token de trabajo compartido: cada persona debe usar su propia clave.

Paso 3. Reinicia Claude Code

Cierra por completo el proceso actual y vuelve a iniciar claude. Abrir otra pestaña del terminal no basta si Claude Code sigue ejecutándose: el proceso mantiene el entorno que recibió al arrancar.

La extensión de VS Code tiene un punto de configuración distinto, claudeCode.environmentVariables, dentro del settings.json de VS Code. No des por hecho que el shell del terminal y la extensión leen siempre el mismo conjunto de variables.

Paso 4. Verifica la conexión con una tarea pequeña

Inicia Claude Code en una carpeta de prueba y envía una petición segura:


Responde en una sola línea: CLAUDE_PROVIDER_OK. No modifiques archivos ni ejecutes comandos.

Antes de enviar la petición, anota la hora actual. La configuración funciona si:

recibes una respuesta sin 401, 403, ConnectionRefused ni model not found;
aparece en el Workspace de BetterToken un nuevo registro con una hora posterior al inicio de la prueba;
ese registro muestra el modelo esperado, el estado y el consumo;
Claude Code no vuelve al proveedor anterior después del reinicio.

Una respuesta correcta por sí sola no demuestra la ruta: si existe un conflicto, Claude Code podría haber utilizado otro provider. La prueba es el nuevo registro de la solicitud de prueba en el Workspace. Abre el repositorio de trabajo únicamente después de confirmar que existe un nuevo registro en el Workspace con una hora posterior al inicio de la prueba.

Cómo localizar conflictos de configuración

No presupongas un orden de prioridad universal: la configuración efectiva depende de cómo se inicia Claude Code, de las managed policies y del entorno que el proceso ya haya heredado. Empieza por localizar todas las fuentes que contienen los nombres relevantes:


printenv ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
grep -lE '"ANTHROPIC_(BASE_URL|AUTH_TOKEN)"' \
  ~/.claude/settings.json \
  .claude/settings.json \
  .claude/settings.local.json 2>/dev/null

El comando solo muestra nombres de archivo, no el valor del token. Revisa también los managed settings de la organización, la extensión de VS Code y cualquier gestor externo de proveedores que intervenga en el arranque. Después, cambia una sola fuente cada vez, reinicia por completo el cliente y repite la pequeña petición comprobando el nuevo registro en el Workspace.

Errores frecuentes

`ConnectionRefused` o conexión con el endpoint equivocado

Comprueba la dirección literalmente: https://bettertoken.ai, sin /v1, sin /messages y sin espacios finales. El cliente añade por sí mismo la ruta necesaria.

`401` o `authentication failure`

Si sospechas que la clave se ha filtrado, crea una nueva. Cópiala sin espacios y confirma que utilizas ANTHROPIC_AUTH_TOKEN, no una variable destinada a otro cliente. No envíes el token en texto plano al soporte.

Los cambios no se aplican

Cierra todos los procesos de Claude Code, comprueba los valores antiguos con printenv y vuelve a iniciar el cliente. En VS Code, ejecuta Reload Window o reinicia la extensión.

`model not found`

No copies un Model ID al azar de un artículo antiguo. Si la clave o el modelo requieren un mapeo explícito, copia el ID actual desde Setup o desde la guía vigente de Claude Code.

Lista de comprobación rápida

La Base URL de Claude Code no incluye /v1.
La clave real no está en Git ni en una captura de pantalla.
Se han localizado todas las fuentes de configuración antiguas y se han comprobado una por una.
El cliente se ha reiniciado por completo.
La petición pequeña y de solo lectura aparece en el Workspace.

Cuando se cumplan los cinco puntos, continúa con la tarea real. Si alguno falla, abre la guía paso a paso para configurar Claude Code, selecciona tu cliente y comprueba cada campo por separado en lugar de sustituir toda la configuración.

¿Quieres optimizar tu flujo de trabajo con LLM?

Conecta modelos mediante una API, gestiona claves y controla el gasto en IA.