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.

Obtenir une clé

Vérifié le 2026-11-13

Ce qu'il vous faut

  • Claude Code installé, avec claude dans 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_URL pointe Claude Code vers UplinkSwitch. Collez-la avec le /v1. La passerelle accepte le chemin que Claude Code construit à partir d'elle.
  • ANTHROPIC_AUTH_TOKEN envoie la clé dans Authorization: Bearer. ANTHROPIC_API_KEY fonctionne à sa place et envoie la clé dans x-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.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

Rendre 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_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL. Donnez-leur des identifiants comme claude-opus-5-5, claude-sonnet-5-5 et claude-haiku-5-5.
  • Gardez la clé hors du .claude/settings.json d'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èleEntréeEntrée en cacheSortieContexte
Claude Fable 5.2claude-fable-5.2Anthropic$4.00Tarif officiel $8.00$0.10Tarif officiel $0.20$20.00Tarif officiel $40.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00Tarif officiel $10.00$2.00Tarif officiel $0.25$30.00Tarif officiel $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716Tarif officiel $4.00$0.1455Tarif officiel $0.20$9.70Tarif officiel $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20Tarif officiel $2.00$0.075Tarif officiel $0.10$3.00Tarif officiel $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582Tarif officiel $0.10$0.01Tarif officiel $0.01$0.1455Tarif officiel $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00Tarif officiel $10.00$0.30Tarif officiel $1.00$15.00Tarif officiel $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80Tarif officiel $5.00$0.16Tarif officiel $0.50$7.50Tarif officiel $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20Tarif officiel $2.00$0.12Tarif officiel $0.20$3.00Tarif officiel $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80Tarif officiel $5.00$0.16Tarif officiel $0.50$7.50Tarif officiel $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80Tarif officiel $5.00$0.16Tarif officiel $0.50$7.50Tarif officiel $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80Tarif officiel $5.00$0.16Tarif officiel $0.50$7.50Tarif officiel $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80Tarif officiel $3.00$0.18Tarif officiel $0.30$9.00Tarif officiel $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60Tarif officiel $1.00$0.06Tarif officiel $0.10$3.00Tarif officiel $5.00200,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
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 /logout pour ne garder que la clé.
  • ANTHROPIC_API_KEY est définie mais ignorée : elle demande une approbation unique. Activez Use custom API key sous /config, ou utilisez ANTHROPIC_AUTH_TOKEN.

Questions fréquentes

Oui. Tous les modèles de chat sont servis au format Anthropic ici : un identifiant GPT, Gemini, DeepSeek ou non censuré fonctionne dans les variables de modèle et reçoit une réponse au format Messages, appels d'outils compris.

Oui. L'entrée en cache est facturée au tarif de cache. Dans l'enregistrement d'une requête, un nombre de tokens lus en cache supérieur à zéro signifie que le cache a fonctionné.

Remote Control et la dictée vocale demandent une connexion claude.ai : elles sont désactivées tant qu'une variable de clé est définie. La recherche d'outils MCP est désactivée sur un hôte autre qu'Anthropic, et définir ENABLE_TOOL_SEARCH=true l'active.

Supprimez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN de l'environnement, et retirez-les de settings.json si vous les y avez mises.

La page Utilisation de la console montre ce que vous avez payé. Pour une requête précise, retrouvez-la par son identifiant de requête. L'enregistrement liste les tokens en entrée, les tokens lus en cache, les tokens en sortie et le montant facturé en USD, et il arrive dans le journal en une minute environ.

Le crédit est prépayé à partir de $10 dans la console, par carte, WeChat Pay, Apple Pay, Google Pay ou crypto, sans abonnement. Chaque recharge bloque vos prix pendant 30 jours.

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é
Join on Telegram