Utiliser Claude Code avec votre propre clé API
Définissez deux variables d'environnement et Claude Code tourne sur votre clé UplinkSwitch. Même outil, mêmes modèles, prix en direct.
Vérifié le 2026-11-13
Ce qu'il vous faut
- Claude Code installé, avec
claudedans votre PATH. - Une clé UplinkSwitch créée dans la console, avec un solde chargé. Le crédit est prépayé à partir de $10, par carte, WeChat Pay, Apple Pay, Google Pay ou crypto.
Deux variables
ANTHROPIC_BASE_URLpointe Claude Code vers UplinkSwitch. Collez-la avec le/v1. La passerelle accepte le chemin que Claude Code construit à partir d'elle.ANTHROPIC_AUTH_TOKENenvoie la clé dansAuthorization: Bearer.ANTHROPIC_API_KEYfonctionne à sa place et envoie la clé dansx-api-key. Définissez l'une, pas les deux.- Une requête qui porte deux clés différentes est refusée avec un
400. - L'URL de base seule ne suffit pas. Sans l'une des variables de clé, Claude Code continue d'utiliser une connexion claude.ai enregistrée.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudeRendre le réglage permanent dans settings.json
Ajoutez les deux variables à ~/.claude/settings.json sous env et elles s'appliquent à tous les projets. .claude/settings.local.json s'applique à un seul projet.
- Trois autres variables nomment les modèles derrière les alias :
ANTHROPIC_DEFAULT_OPUS_MODEL,ANTHROPIC_DEFAULT_SONNET_MODELetANTHROPIC_DEFAULT_HAIKU_MODEL. Donnez-leur des identifiants commeclaude-opus-5-5,claude-sonnet-5-5etclaude-haiku-5-5. - Gardez la clé hors du
.claude/settings.jsond'un projet. Ce fichier est fait pour être commité et partagé. - Quand un export du shell et un fichier de réglages définissent la même variable, le fichier de réglages l'emporte.
- L'extension VS Code lit les identifiants de connexion dans son propre réglage,
claudeCode.environmentVariables, dans les paramètres utilisateur de VS Code.
Choisir un modèle
Les alias opus, sonnet et haiku renvoient à ce que nomment les trois variables de modèle. Définir celle de Haiku déplace aussi vers ce modèle les tâches de fond comme les titres de session. Changez de modèle en cours de session avec /model, au démarrage avec claude --model claude-opus-5-5, ou pour une seule session avec ANTHROPIC_MODEL.
Claude Code parle le format d'API d'Anthropic, et tous les modèles de chat sont servis dans ce format ici, y compris GPT, Gemini, DeepSeek, Kimi et les versions non censurées. Tout identifiant de chat de la liste des modèles fonctionne dans les mêmes variables et reçoit une réponse au format Messages, appels d'outils compris.
Ce que coûte Claude Code sur cette clé
Le tableau affiche les modèles Claude par million de tokens, en direct depuis le catalogue, à côté du tarif officiel publié par Anthropic. Tous les modèles Claude de la clé sont sur la page prix de l'API Claude.
Claude Code envoie toute la conversation à chaque tour et la marque pour le cache de prompts. Les tokens lus depuis le cache sont facturés au tarif de cache, une fraction du tarif d'entrée. Le cache dure cinq minutes par défaut : un tour après une pause plus longue paie une fois le tarif d'entrée pour tout le contexte.
Le coût affiché par Claude Code est sa propre estimation au tarif officiel d'Anthropic. Ce que vous avez payé figure sur la page Utilisation de la console.
| Modèle | Entrée | Entrée en cache | Sortie | Contexte |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2Anthropic | $4.00Tarif officiel $8.00 | $0.10Tarif officiel $0.20 | $20.00Tarif officiel $40.00 | 1,000,000 |
| Claude Fable 5.1claude-fable-5.1Anthropic | $6.00Tarif officiel $10.00 | $2.00Tarif officiel $0.25 | $30.00Tarif officiel $50.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5Anthropic | $2.716Tarif officiel $4.00 | $0.1455Tarif officiel $0.20 | $9.70Tarif officiel $20.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5Anthropic | $1.20Tarif officiel $2.00 | $0.075Tarif officiel $0.10 | $3.00Tarif officiel $10.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5Anthropic | $0.0582Tarif officiel $0.10 | $0.01Tarif officiel $0.01 | $0.1455Tarif officiel $0.50 | 1,000,000 |
| Claude Fable 5claude-fable-5Anthropic | $3.00Tarif officiel $10.00 | $0.30Tarif officiel $1.00 | $15.00Tarif officiel $50.00 | 1,000,000 |
| Claude Opus 5claude-opus-5Anthropic | $1.80Tarif officiel $5.00 | $0.16Tarif officiel $0.50 | $7.50Tarif officiel $25.00 | 1,000,000 |
| Claude Sonnet 5claude-sonnet-5Anthropic | $1.20Tarif officiel $2.00 | $0.12Tarif officiel $0.20 | $3.00Tarif officiel $10.00 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8Anthropic | $1.80Tarif officiel $5.00 | $0.16Tarif officiel $0.50 | $7.50Tarif officiel $25.00 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7Anthropic | $1.80Tarif officiel $5.00 | $0.16Tarif officiel $0.50 | $7.50Tarif officiel $25.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6Anthropic | $1.80Tarif officiel $5.00 | $0.16Tarif officiel $0.50 | $7.50Tarif officiel $25.00 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6Anthropic | $1.80Tarif officiel $3.00 | $0.18Tarif officiel $0.30 | $9.00Tarif officiel $15.00 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5Anthropic | $0.60Tarif officiel $1.00 | $0.06Tarif officiel $0.10 | $3.00Tarif officiel $5.00 | 200,000 |
USD par million de tokens
Vérifier que tout fonctionne
Envoyez un petit message. Avec -i, curl affiche les en-têtes de la réponse : x-uplink-request-id identifie la requête et x-uplink-charge indique ce qu'elle a coûté en USD.
Lancez ensuite claude. La requête apparaît dans la console en quelques secondes. Dans Claude Code, /status affiche une ligne Anthropic base URL avec l'adresse UplinkSwitch et une ligne nommant la variable de clé que vous avez définie. Si la ligne de l'URL de base manque, la variable n'est pas arrivée jusqu'à la session.
curl -i https://api.uplinkswitch.com/v1/messages \
-H "Authorization: Bearer sk-uplink-live-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'Erreurs et correctifs
invalid_api_key(401) : la clé est fausse ou révoquée, ou elle se trouve dans une variable que Claude Code n'a pas lue. Vérifiez avec/status.insufficient_balance(402) : rechargez dans la console.monthly_limit_reached(402) signifie que la clé a atteint la limite de dépenses mensuelle qui lui est fixée.model_not_found(404) : l'identifiant n'est pas dans la liste des modèles. Cherchez une faute de frappe dans les variables de modèle.- Claude Code vous demande de vous connecter alors que le test curl fonctionne : définissez la clé dans un export du shell ou dans
~/.claude/settings.json. Un fichier de réglages de projet ne s'applique qu'après la configuration du premier lancement et la demande de confiance. - Un avertissement au démarrage cite deux sources d'identifiants : une connexion enregistrée et la variable sont toutes deux actives. Lancez
/logoutpour ne garder que la clé. ANTHROPIC_API_KEYest définie mais ignorée : elle demande une approbation unique. Activez Use custom API key sous/config, ou utilisezANTHROPIC_AUTH_TOKEN.
Questions fréquentes
Obtenez une clé pour Claude Code
Deux variables, prépayé à partir de $10, sans abonnement, avec des prix bloqués 30 jours à chaque recharge.
Obtenir une clé