Configuration de Claude Code

La CLI d’Anthropic sur l’endpoint OneProvider. La configuration tient en deux variables d’environnement et un appel de vérification.

Installation

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

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

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

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

Option 2 : paramètres persistants

Claude Code lit les paramètres utilisateur dans settings.json. Le modèle par défaut et les alias de famille ci-dessous viennent des modèles actifs actuels du catalogue.

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

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

Vérification

claude -p "say hi in one sentence"

Vous devriez voir une réponse d’une seule phrase en une ou deux secondes. Si vous voyez 401, la clé est incorrecte ; 400 invalid_request_error signifie que le nom du modèle ne figure pas dans la liste canonique (la réponse indique les ID pris en charge).

Problèmes courants

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

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

Utilisation d’outils

Claude Code utilise le schéma d’outils natif d’Anthropic. L’API 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é définit tool_choice: {"type": "any"} ou tool_choice: {"type": "tool", "name": "X"}, l’API les réécrit en auto + une incitation dans le prompt système. Voir Utilisation d’outils pour le tableau complet.

Rendre persistant

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

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

Quel modèle choisir

Claude Code parle le protocole Anthropic, il fonctionne donc mieux avec la famille Claude. Utilisez claude-sonnet-5-5 comme choix quotidien par défaut : prix et qualité équilibrés pour les modifications, les tests et les explications. Passez à claude-opus-5-5 pour les décisions d’architecture, les gros refactorings et les bugs que vous n’arrivez pas à cerner ; il coûte plus cher par jeton. Utilisez claude-haiku-5-5 pour les questions rapides, les messages de commit et les tâches de fond où la vitesse compte plus que la profondeur. Dans une session, exécutez /model pour changer, ou démarrez avec claude --model claude-opus-5-5. Les paramètres ci-dessus associent les alias sonnet, opus et haiku à ces ID. Les ID actuels sont sur la page des modèles et les tarifs sur la page des tarifs . Les prix sont par million de jetons : mettez donc une limite de dépense sur la clé et surveillez la page « Consommation » du Dashboard.

Erreurs courantes et solutions

claude: command not found après l’installation

Ouvrez d’abord un nouveau terminal : l’installateur place le binaire dans ~/.local/bin. S’il reste introuvable, ajoutez-le avec export PATH="$HOME/.local/bin:$PATH" dans le fichier rc de votre shell. Avec Homebrew, vérifiez que brew install --cask claude-code s’est terminé sans erreur.

400 invalid_request_error à propos du modèle

L’ID du modèle n’est pas dans le catalogue, souvent un ancien alias comme claude-3-5-sonnet. Définissez ANTHROPIC_MODEL et les trois variables ANTHROPIC_DEFAULT_*_MODEL comme dans le settings.json ci-dessus, ou listez les ID valides avec curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY".

404 ou « The requested API endpoint does not exist »

ANTHROPIC_BASE_URL doit être exactement https://api.oneprovider.dev : sans /v1 ni /v1/messages à la fin. Claude Code ajoute lui-même le chemin.

429 « Insufficient balance on this API key »

Le solde de l’espace client est épuisé ou la limite de dépense de la clé est atteinte. Réessayer ne servira à rien : rechargez le solde ou relevez la limite dans l’espace client, puis renvoyez la requête.

La réponse s’arrête en cours de route ou la connexion est réinitialisée

Désactivez tout VPN ou proxy VLESS : ils mettent les flux en mémoire tampon et cassent HTTP/2. OneProvider ne bloque pas par région et ne met pas les flux en tampon. Une requête doit commencer à répondre en moins de 6 minutes et ne peut pas dépasser 10 minutes au total, voir les codes d’erreur .

J’ai modifié settings.json mais rien n’a changé

Claude Code lit le bloc env au démarrage : quittez donc claude puis relancez-le. Gardez les variables dans ~/.claude/settings.json ou dans votre shell : un .claude/settings.json de projet est lu après la configuration du premier lancement, ce qui peut être trop tard.

FAQ

Ai-je besoin d’un compte ou d’un abonnement Claude ?

Non. La clé OneProvider suffit. Claude Code n’a jamais besoin de se connecter à claude.ai ; s’il affiche un écran de connexion, suivez les étapes Auth conflict ci-dessus.

Puis-je utiliser GPT ou d’autres modèles dans Claude Code ?

Claude Code envoie des requêtes Anthropic Messages, utilisez donc des ID Claude. Pour les modèles GPT, utilisez Codex , Cursor ou Cline .

Comment revenir à ma connexion Anthropic ?

Supprimez les variables ANTHROPIC_* définies ci-dessus du bloc env de settings.json et du fichier rc de votre shell, ouvrez un nouveau terminal et exécutez /login.

Où voir ce qu’a coûté une session ?

Sur la page « Consommation » du Dashboard de la clé : chaque requête avec son modèle et son nombre de jetons. Une limite de dépense par clé arrête un agent qui s’emballe.

Est-ce que cela fonctionne sous Windows ?

Oui. Choisissez Windows dans le sélecteur de système d’exploitation en haut : les deux mêmes variables se définissent avec PowerShell, et settings.json se trouve dans votre profil utilisateur, sous .claude.

L’extension VS Code de Claude Code est-elle la même chose ?

Elle partage le même fichier de paramètres. Voir Claude Code dans VS Code .

Réponses rapides

Quelle base URL utiliser ?

Claude Code et les SDK Anthropic utilisent https://api.oneprovider.dev. Les SDK OpenAI et les clients compatibles OpenAI utilisent https://api.oneprovider.dev/v1. Une seule clé fonctionne avec les deux ; la liste des modèles est sur la page des modèles , les tarifs sur la page des tarifs .

Comment s’authentifier ?

Envoyez la clé sk-… telle quelle dans x-api-key ou Authorization: Bearer : l’un des deux, jamais les deux. Conservez la clé dans une variable d’environnement, pas dans un fichier qui sera commité. En savoir plus sur l’authentification .

Où obtenir une clé ?

Ouvrez votre espace client dans le bot Telegram @oneprovider_robot ou sur app.oneprovider.dev, rechargez le solde et appuyez sur « Créer une clé ». Chaque clé peut avoir sa propre limite de dépense. Espace client et clés API .

Que signifient 401, 404 et 429 ?

401 : la clé est absente, mal saisie ou envoyée dans le mauvais en-tête ; collez la clé entière, sans guillemets ni espaces. 404 : le plus souvent une base URL incorrecte, par exemple un /v1 manquant ou en double. 429 avec « Insufficient balance » : le solde de l’espace client est à zéro ou la clé a atteint sa limite de dépense, donc rechargez au lieu de réessayer ; tout autre 429 est une limite de débit, donc attendez le délai indiqué par Retry-After. Détails : codes d’erreur et dépannage .

Pourquoi les flux se coupent-ils ou se réinitialisent-ils ?

Les VPN et les proxys VLESS mettent souvent le SSE en mémoire tampon ou perturbent la négociation HTTP/2. OneProvider n’a aucune restriction régionale et ne met pas les flux en mémoire tampon : désactivez le proxy et réessayez.

Où demander de l’aide si cela ne suffit pas ?

Écrivez à @Oneproviderhelpbot sur Telegram ou ouvrez « Support » dans l’espace client web, en indiquant le code de statut HTTP et le message d’erreur exact. Comment fonctionne le support .