Accueil → Guides → Base URL Anthropic pour Claude Code : bien régler ANTHROPIC_BASE_URL

Base URL Anthropic pour Claude Code : bien régler ANTHROPIC_BASE_URL

Claude Code se connecte à l'adresse indiquée par ANTHROPIC_BASE_URL. La seule règle qui piège : il veut l'hôte nu, sans /v1 — l'inverse de presque tous les outils de type OpenAI.

La réponse courte

Définissez deux variables d'environnement avant de lancer Claude Code :

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

L'adresse officielle d'Anthropic est https://api.anthropic.com ; un relais n'a besoin que de la remplacer. Claude Code ajoute lui-même /v1/messages, donc la base URL s'arrête à l'hôte. Sur cette passerelle, 88 % de tout le trafic Claude des 30 derniers jours venait de Claude Code configuré exactement ainsi.

Où le régler

macOS / Linux — dans le shell depuis lequel vous le lancez :

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

Windows PowerShell — pour la fenêtre en cours :

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

~/.claude/settings.json — pour que chaque session le prenne en compte, quel que soit le shell :

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

La valeur est lue au démarrage de Claude Code. Après une modification, quittez et lancez une nouvelle session ; une session ouverte garde l'ancienne adresse. ANTHROPIC_AUTH_TOKEN est envoyé en Authorization: Bearer, ANTHROPIC_API_KEY en x-api-key. Cette passerelle accepte les deux : utilisez-en un seul.

Tester en une commande

Avant d'accuser Claude Code, vérifiez directement l'adresse et la clé :

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"}]}'

Une réponse JSON signifie que tout est bon. text/html ou un 404 signifie que l'URL est fausse ; un 401 en JSON signifie que l'URL est bonne et la clé non.

Quand ajouter /v1 et quand s'en abstenir

Deux familles de SDK coupent l'URL à des endroits différents. Les clients de type Anthropic ajoutent /v1/messages eux-mêmes ; ceux de type OpenAI attendent /v1 dans la base URL et n'ajoutent que /chat/completions :

Client	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

Avec /v1 dans Claude Code, les requêtes partent vers /v1/v1/messages et renvoient 404. Sans /v1 dans Cursor, elles partent vers /chat/completions — 404 aussi. Aucune n'atteint l'API.

Erreur d'URL ou erreur de clé ?

• Une erreur et rien dans votre journal d'utilisation → le chemin est faux. Un 404 est répondu en bordure de réseau et n'arrive jamais à la facturation. Vérifiez /v1 d'abord.
• 401 avec une entrée au journal → la clé est fausse, révoquée, ou le solde est vide.
• Un modèle renvoie 404 alors que les autres fonctionnent avec la même clé → ce modèle appartient à un autre groupe. Chaque clé est liée à un groupe ; créez-en une seconde pour l'autre.
• Un changement semble sans effet → la variable a été définie dans un autre shell, ou la session a démarré avant.

Choisir le modèle

Les noms de modèles sont des chaînes exactes avec des tirets, jamais des points — claude-fable-5-1, pas claude-fable-5.1. Choisissez-le au lancement, ou avec /model dans une session :

claude --model claude-opus-5-5

Les noms et prix actuels sont dans la grille tarifaire. La configuration des autres clients est dans le démarrage rapide, et l'application Claude Desktop dans le guide des applications de bureau.

Commencer

Pas d'abonnement, pas de minimum mensuel, pas de rendez-vous commercial. Rechargez en USDT et dépensez ce que vous consommez — 1 USDT vous donne 2 crédits de solde API.

Lire le démarrage rapide en 30 secondes

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

Les prix de cette page sont remplis automatiquement à partir des données de facturation réelles. Les conditions de tiers sont citées de leur propre documentation.