Claude Code

La CLI d’Anthropic sur le point d’accès API-AI. La configuration tient en deux variables d’environnement et un appel de vérification.

Système d’exploitation

Installation

bash

brew install anthropic/claude-code/claude
# or:
npm i -g @anthropic-ai/claude-code

Option 1 : variables d’environnement (session en cours)

Le plus rapide est de définir les variables uniquement dans le terminal en cours. Elles ne persistent pas d’une session à l’autre — voir « Rendre permanent » en bas de page pour qu’elles survivent à un redémarrage.

bash

export ANTHROPIC_BASE_URL=https://api-ai.fr
export ANTHROPIC_API_KEY=mdf-votre-cle

Option 2 : réglages permanents

Claude Code lit les réglages utilisateur dans settings.json. Le modèle par défaut et les alias de familles ci-dessous correspondent aux modèles actifs du catalogue.

Chemin du fichier : ~/.claude/settings.json

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api-ai.fr",
    "ANTHROPIC_API_KEY": "mdf-votre-cle",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  },
  "model": "claude-sonnet-5-5"
}

Vérifier

bash

claude ask "say hi in one sentence"

Vous devriez voir une réponse d’une phrase en une ou deux secondes. Une 401 signifie que la clé est incorrecte ; 400 invalid_request_error signifie que le nom du modèle ne correspond pas à la liste officielle (la réponse liste les identifiants pris en charge).

Problèmes fréquents

Claude Code me demande de me connecter — que faire ?

Vous n’avez pas besoin de vous connecter. La clé API fonctionne sans OAuth. Passez l’écran de connexion ou connectez-vous avec n’importe quel compte : cela n’affecte pas votre clé API-AI. Si l’invite vous gêne, supprimez le jeton OAuth :

bash

# macOS / Linux
unset ANTHROPIC_AUTH_TOKEN

# Windows PowerShell
Remove-Item Env:\ANTHROPIC_AUTH_TOKEN

Puis redémarrez Claude Code. Explication complète : Dépannage · Connexion Claude Code.

Erreur d’analyse JSON dans settings.json (ou une 429 inexpliquée)

La cause la plus fréquente : des guillemets « typographiques » (“ ”) dans ~/.claude/settings.json. Ils apparaissent quand on colle depuis une messagerie ou Notion, et l’analyseur JSON les rejette. Parfois, une configuration cassée se manifeste par une 429, car le client interprète le silence de l’amont comme une limite de débit. Correction en une ligne :

bash

# validate the file
jq . ~/.claude/settings.json

# auto-replace smart quotes with ASCII
sed -i.bak 
  

s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Meilleure prévention : copiez la configuration directement depuis cette documentation — les guillemets y sont déjà corrects. Explication complète : Dépannage · Analyse JSON / 429.

Les connexions coupent — faut-il un VPN ?

Pas besoin de VPN, et un VPN aggrave souvent les choses. API-AI ne bloque aucun pays ; les VPN ou proxys VLESS cassent fréquemment le streaming SSE (la réponse s’arrête en plein milieu) et l’ALPN HTTP/2. Si Claude Code s’interrompt sans raison apparente, désactivez le VPN et réessayez. Explication complète : Dépannage · VPN.

La liste complète des symptômes 400 / 401 / 403 / 404 / 429 / 503 / 504 → causes → solutions se trouve sur la page Dépannage.

Utilisation d’outils

Claude Code utilise le schéma d’outils natif Anthropic. Notre passerelle accepte tous les noms d’outils (Read, Write, Edit, Bash, Grep, Glob, TodoWrite, etc.) avec tool_choice: auto — ce que la CLI envoie par défaut. Aucun en-tête anthropic-beta n’est requis.

Si votre orchestrateur personnalisé envoie tool_choice: {"type": "any"} ou tool_choice: {"type": "tool", "name": "X"}, la couche de compatibilité les réécrit en auto + une consigne dans le prompt système. Voir Utilisation d’outils pour le tableau complet.

Où l’en-tête d’authentification est envoyé

Claude Code envoie x-api-key par défaut. La passerelle accepte cet en-tête comme Authorization: Bearer — les deux fonctionnent. Si vous avez modifié la CLI pour injecter un Bearer, inutile de revenir en arrière.

Rendre permanent

Une fois que tout fonctionne et que vous voulez conserver les variables d’une session à l’autre, ajoutez-les au fichier rc de votre shell (macOS / Linux) ou aux variables d’environnement utilisateur (Windows). Les nouveaux terminaux les chargeront automatiquement.

bash

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api-ai.fr
export ANTHROPIC_API_KEY=mdf-votre-cle
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

Dernière mise à jour : 2 octobre 2026Une erreur ? support@minedom-france.fr