Utiliser Claude Code avec un autre fournisseur

1Tester la route avant de toucher à Claude Code

Une requête directe te dit si le problème vient de l'adresse, du secret ou de Claude Code. Exporte d'abord les variables dans ton shell :

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

Puis envoie une requête d'un seul token :

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-opus-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Une réponse qui commence par {"id":"msg_ valide l'adresse et le secret. Une erreur qui se plaint du nom de modèle les valide aussi : la passerelle a authentifié avant de refuser. Un 401, en revanche, veut dire que ton secret part dans le mauvais en-tête : bascule sur ANTHROPIC_API_KEY et x-api-key.

2Vérifier ce que voit Claude Code

Lance claude depuis le même shell, envoie un message, puis :

/status

L'onglet Status affiche une ligne Anthropic base URL seulement quand une adresse est configurée. Une ligne Auth token ou API key confirme que c'est bien le secret de la passerelle qui sert, et pas ta connexion claude.ai enregistrée.

3Persister sans committer ton secret

Un export shell ne survit pas à la fermeture du terminal, et ne remonte pas jusqu'aux agents lancés en arrière-plan. Pour que ça tienne partout, passe par le bloc env d'un fichier de réglages :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

~/.claude/settings.json s'applique à tous tes projets. .claude/settings.local.json à un seul, et n'est pas versionné.

Quand un export shell et un bloc env définissent la même variable, c'est la valeur du fichier de réglages qui gagne.

4Le cas OpenRouter

OpenRouter expose un point d'entrée compatible avec l'API Messages, ce qui évite d'installer un proxy local. La configuration ci-dessous vient de la documentation d'OpenRouter, pas de celle d'Anthropic :

export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_API_KEY="<ta-cle-openrouter>"
export ANTHROPIC_AUTH_TOKEN=""
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 est une variable Claude Code documentée : elle interroge la passerelle au démarrage et ajoute ses modèles au sélecteur /model, sous l'étiquette From gateway.

Pour épingler ce que résolvent les alias sonnet, opus et haiku, quatre variables existent côté Claude Code :

export ANTHROPIC_DEFAULT_SONNET_MODEL="..."
export ANTHROPIC_DEFAULT_OPUS_MODEL="..."
export ANTHROPIC_DEFAULT_HAIKU_MODEL="..."
export CLAUDE_CODE_SUBAGENT_MODEL="..."

ANTHROPIC_DEFAULT_HAIKU_MODEL sert aussi aux tâches de fond. Note au passage que ANTHROPIC_SMALL_FAST_MODEL, qu'on voit encore dans de vieux tutoriels, est déprécié en sa faveur.