ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL indique aux SDK Anthropic et à Claude Code vers quel hôte envoyer les requêtes API, en remplaçant la valeur par défaut https://api.anthropic.com. Définissez une origine sans chemin — le client ajoute lui-même /v1/messages — et associez-la à ANTHROPIC_AUTH_TOKEN, qui devient l’en-tête Authorization: Bearer.

# The origin only — no trailing /v1, no trailing slash.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

Ouvrez ensuite un nouveau terminal : Claude Code et les SDK lisent ces variables au démarrage du processus. Une session déjà en cours conserve donc l’ancien point de terminaison.

Toutes les variables et leur rôle

La référence des variables d’environnement d’Anthropic répertorie toutes celles que Claude Code lit. Voici celles qui comptent lorsque vous redirigez le point de terminaison.

Configuration par client

Claude Code

Ajoutez les exports au profil shell depuis lequel Claude Code démarre, puis ouvrez un nouveau terminal. L’installation et le flux de travail ne changent pas.

# ~/.zshrc (or ~/.bashrc) — applies to every Claude Code session.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models this endpoint serves. Claude Code's default and its opus/sonnet
# aliases follow Anthropic's newest models, which may not be served here —
# unpinned, those calls 404.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Exécutez /status dans Claude Code pour vérifier quel point de terminaison la session actuelle utilise. Instructions détaillées, y compris pour générer la clé : définir une clé API dans Claude Code.

SDK Anthropic (Python / TypeScript)

Les SDK lisent les mêmes variables d’environnement, et les deux paramètres peuvent aussi être transmis au constructeur — pratique lorsqu’un processus communique avec plusieurs points de terminaison.

from anthropic import Anthropic

# The Anthropic SDK appends /v1/messages, so pass the origin — not .../v1.
client = Anthropic(
    base_url="https://api.kunavo.com",
    auth_token="sk-kn-...",          # sets the Authorization: Bearer header
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Say hi"}],
)
print(msg.content[0].text)

SDK OpenAI — l’autre convention

Si votre code utilise déjà OpenAI, vous n’avez pas du tout besoin de ANTHROPIC_BASE_URL. Définissez base_url sur le chemin compatible avec OpenAI — avec /v1 cette fois-ci — et appelez les mêmes modèles Claude via /v1/chat/completions.

from openai import OpenAI

# The OpenAI SDK is the other convention: it wants the /v1 in the base_url.
client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Say hi"}],
)
print(r.choices[0].message.content)

Cline, Roo Code, Kilo Code, Cursor

Les agents intégrés aux éditeurs proposent généralement les deux mêmes paramètres dans leur interface plutôt que dans l’environnement : un champ « URL de base » ou « point de terminaison personnalisé » et un champ de clé API. Les règles restent les mêmes : origine sans /v1 pour un fournisseur de type Anthropic, et clé dans le champ de clé API. Guides par client : Cline, Roo Code, Kilo Code.

Vérifier le bon fonctionnement

Une commande curl vérifie à la fois l’URL de base et l’identifiant. Une réponse 200 avec un corps JSON signifie que les deux sont corrects.

# 200 and a JSON body means the base URL and the token are both right.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

# In Claude Code, /status shows the endpoint the session is actually using.

En cas de problème

Effet sur un abonnement Pro ou Max

Tant qu’une variable d’identifiant est définie, Claude Code facture la clé plutôt que l’abonnement connecté : les limites de l’offre cessent de s’appliquer et l’utilisation est facturée au propriétaire de la clé. L’abonnement lui-même n’est pas modifié : supprimez la variable, ouvrez un nouveau terminal et Claude Code revient à l’offre. Les deux ne se cumulent jamais. Le calcul des coûts de chacun est expliqué dans Tarifs de Claude Code.

Suivant

• Authentification — clés, en-têtes et portées
• API Messages — le point de terminaison natif d’Anthropic
• Mise en cache des invites — le principal levier de réduction des coûts de Claude Code