Faut-il un compte claude.ai ou un abonnement pour utiliser Claude Code avec une clé API ?

Non. Une fois ANTHROPIC_AUTH_TOKEN défini, les requêtes portent cet identifiant et non la connexion claude.ai, et les limites d'usage de l'abonnement ne s'appliquent pas. Votre compte est chez RelaySwitch, s'ouvre avec un e-mail, et chaque tour est débité du solde prépayé.

ANTHROPIC_BASE_URL doit-elle se terminer par /v1 ?

Les deux formes sont acceptées. Les exemples de ce site utilisent https://api.relayswitch.io/v1. Claude Code ajoute /v1/messages derrière cette adresse, et la passerelle gère le /v1 en double.

Les variables sont définies, pourquoi Claude Code demande-t-il encore de se connecter ?

Les variables n'arrivent pas jusqu'à ce processus. Un éditeur de code ouvert depuis le Dock ou le menu Démarrer ne lit pas les export du terminal. Écrivez les deux variables dans le bloc env de ~/.claude/settings.json, puis lancez /status et vérifiez que la ligne Anthropic base URL apparaît.

Combien coûte une session de code ?

Cela dépend du modèle et de la longueur du contexte. L'essentiel de l'entrée d'une session de code est du contexte renvoyé, facturé au prix de l'entrée en cache : le coût dépend donc surtout du prix du cache et du prix de sortie. Le tableau de cette page donne les prix actuels par million de tokens, et le coût réel figure sur le reçu de chaque requête.

Comment payer sans carte de crédit ?

Rechargez avec USDT, USDC, BTC, ETH, SOL dans la console, dès $10. La carte, y compris Apple Pay et Google Pay, est aussi acceptée. Le solde est tenu en dollars américains, n'expire pas, et il n'y a pas d'abonnement.

Comment savoir que c'est bien Claude qui répond ?

Chaque modèle reçoit le même prompt de test une fois par jour et sa réponse est comparée aux résultats précédents ; les résultats sont publics sur https://api.relayswitch.io/v1/proof, sans clé API. Chaque requête a aussi un reçu signé qui indique l'id du modèle, les tokens facturés et le coût.

Vérifié le 2026-11-12

Claude Code avec une clé API prépayée

Claude Code lit l'adresse de l'endpoint dans ANTHROPIC_BASE_URL et l'identifiant d'accès dans ANTHROPIC_AUTH_TOKEN. Pointez les deux vers RelaySwitch, et chaque tour est débité au token d'un solde prépayé que vous rechargez par carte ou en crypto. La même clé donne accès à 13 modèles Claude.

01Deux façons de se connecter à Claude Code, et celle utilisée ici

Claude Code a deux identités. La première se connecte avec un compte claude.ai via /login et consomme le quota de l'abonnement. La seconde utilise une clé API et est facturée au token. Les deux peuvent coexister sur la même machine, mais une session n'en utilise qu'une.

Cette page traite de la seconde. Une fois ANTHROPIC_AUTH_TOKEN défini, les requêtes portent cet identifiant et non la connexion claude.ai : vous n'avez donc besoin ni d'un compte claude.ai ni d'un compte chez l'éditeur du modèle. Votre compte est chez RelaySwitch et s'ouvre avec un e-mail.

02Deux variables d'environnement sur macOS, Linux et WSL

Essayez d'abord dans le terminal déjà ouvert. Remplacez la valeur de la clé par votre clé API, qui commence par sk-relay-, puis lancez claude.

ANTHROPIC_BASE_URL indique où envoyer les requêtes. Les exemples de ce site utilisent https://api.relayswitch.io/v1 ; avec ou sans /v1 à la fin, l'adresse est acceptée.
ANTHROPIC_AUTH_TOKEN envoie la clé en Authorization: Bearer. ANTHROPIC_API_KEY fonctionne aussi et part en x-api-key, mais demande une approbation unique en mode interactif. N'en utilisez qu'une : une requête qui porte deux clés différentes est refusée avec un statut 400.
La Base URL seule ne suffit pas. Sans l'une des variables de clé, Claude Code continue d'utiliser la connexion claude.ai enregistrée.

bash

1export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"

2export ANTHROPIC_AUTH_TOKEN="sk-relay-..."

3claude

03Windows PowerShell

Claude Code tourne nativement sous Windows, WSL n'est donc pas obligatoire. Dans PowerShell, les deux mêmes variables s'écrivent avec la syntaxe suivante.

powershell

1$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"

2$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."

3claude

04Pour conserver le réglage : settings.json et VS Code

Les variables définies dans un terminal ne valent que pour cette fenêtre. Pour qu'elles s'appliquent à tous les projets et à toutes les façons de lancer Claude Code, écrivez-les dans le bloc env de ~/.claude/settings.json (sous Windows : %USERPROFILE%\.claude\settings.json). Si la même variable existe dans le terminal et dans ce fichier, c'est le fichier de réglages qui l'emporte.

Ne mettez pas la clé dans le .claude/settings.json du projet, car ce fichier est fait pour être commité. L'extension VS Code lit son propre réglage, claudeCode.environmentVariables, dans les paramètres utilisateur de VS Code. L'application de bureau ne lit pas ces deux variables d'environnement.

Les étapes complètes, avec un exemple de fichier, sont dans le guide Claude Code (en anglais).

05Vérifier que les requêtes passent bien par votre clé

Testez d'abord sans Claude Code : envoyez une petite requête directement à l'endpoint Messages. Une réponse 200 avec du JSON signifie que l'adresse et la clé sont correctes.

Lancez ensuite claude, envoyez un message, puis tapez /status. Vous devez voir une ligne Anthropic base URL qui pointe vers RelaySwitch et une ligne Auth token qui nomme la variable que vous avez définie. Si la ligne base URL n'apparaît pas, la variable n'est pas arrivée jusqu'à cette session. La requête apparaît en quelques secondes sur la page Usage de la console.

bash

1curl -i https://api.relayswitch.io/v1/messages \

2 -H "Authorization: Bearer sk-relay-..." \

3 -H "anthropic-version: 2023-06-01" \

4 -H "content-type: application/json" \

5 -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'

06Choisir le modèle : opus, sonnet, haiku

La commande /model bascule entre trois alias. L'id vers lequel pointe chaque alias est fixé par ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL ; les trois acceptent n'importe quel id Claude du tableau ci-dessous. Pour une seule session, utilisez ANTHROPIC_MODEL ou claude --model suivi de l'id.

L'écart de coût vient surtout du prix de sortie et du prix de l'entrée en cache. Une approche économe : sonnet pour le travail quotidien, puis un modèle plus cher seulement quand sonnet échoue à plusieurs reprises sur un problème.

Les id GPT, Gemini ou DeepSeek répondent aussi dans Claude Code, car la passerelle traduit la requête Messages vers le format de ces modèles. Anthropic ne prend toutefois pas en charge Claude Code sur des modèles non-Claude : le tool use peut donc y être moins fluide.

Modèle	Éditeur	Entrée	Sortie	Contexte
Claude Fable 5.1claude-fable-5.1	Anthropic	$6.00	$30.00	1,000,000
Claude Fable 5.2claude-fable-5.2	Anthropic	$4.00	$20.00	1,000,000
Claude Fable 5claude-fable-5	Anthropic	$3.00	$15.00	1,000,000
Claude Opus 5.5claude-opus-5-5	Anthropic	$2.716	$9.70	1,000,000
Claude Sonnet 4.6claude-sonnet-4-6	Anthropic	$1.80	$9.00	1,000,000
Claude Opus 4.6claude-opus-4-6	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.7claude-opus-4-7	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 4.8claude-opus-4-8	Anthropic	$1.80	$7.50	1,000,000
Claude Opus 5claude-opus-5	Anthropic	$1.80	$7.50	1,000,000
Claude Haiku 4.5claude-haiku-4-5	Anthropic	$0.60	$3.00	200,000
Claude Sonnet 5claude-sonnet-5	Anthropic	$1.20	$3.00	1,000,000
Claude Sonnet 5.5claude-sonnet-5-5	Anthropic	$1.20	$3.00	1,000,000
Claude Haiku 5.5claude-haiku-5-5	Anthropic	$0.0582	$0.1455	1,000,000

USD par million de tokens

07Cache, coûts et limites par clé

Claude Code envoie toute la conversation à chaque tour et la marque pour le prompt cache. Les tokens lus depuis le cache sont facturés au prix de l'entrée en cache, inférieur au prix d'entrée. Le cache dure cinq minutes par défaut : le premier tour après une longue pause paie donc une fois le prix d'entrée pour tout le contexte.

Le coût qu'affiche Claude Code est sa propre estimation, basée sur les prix officiels d'Anthropic. Ce qui est réellement débité figure sur la page Usage de la console et sur le reçu de chaque requête.

Un agent de code enchaîne beaucoup de requêtes, et en cas de problème le solde part vite. Créez une clé dédiée à Claude Code, puis donnez-lui un budget en dollars et un plafond de dépenses quotidien : quand la limite est atteinte, la passerelle répond 402 et seule cette clé s'arrête, le reste du solde du compte n'est pas touché. La même clé peut recevoir une liste d'autorisation de modèles. La création d'une clé est expliquée sur la page Clé API Claude.

Questions fréquentes

Faut-il un compte claude.ai ou un abonnement pour utiliser Claude Code avec une clé API ?: Non. Une fois ANTHROPIC_AUTH_TOKEN défini, les requêtes portent cet identifiant et non la connexion claude.ai, et les limites d'usage de l'abonnement ne s'appliquent pas. Votre compte est chez RelaySwitch, s'ouvre avec un e-mail, et chaque tour est débité du solde prépayé.
ANTHROPIC_BASE_URL doit-elle se terminer par /v1 ?: Les deux formes sont acceptées. Les exemples de ce site utilisent https://api.relayswitch.io/v1. Claude Code ajoute /v1/messages derrière cette adresse, et la passerelle gère le /v1 en double.
Les variables sont définies, pourquoi Claude Code demande-t-il encore de se connecter ?: Les variables n'arrivent pas jusqu'à ce processus. Un éditeur de code ouvert depuis le Dock ou le menu Démarrer ne lit pas les export du terminal. Écrivez les deux variables dans le bloc env de ~/.claude/settings.json, puis lancez /status et vérifiez que la ligne Anthropic base URL apparaît.
Combien coûte une session de code ?: Cela dépend du modèle et de la longueur du contexte. L'essentiel de l'entrée d'une session de code est du contexte renvoyé, facturé au prix de l'entrée en cache : le coût dépend donc surtout du prix du cache et du prix de sortie. Le tableau de cette page donne les prix actuels par million de tokens, et le coût réel figure sur le reçu de chaque requête.
Comment payer sans carte de crédit ?: Rechargez avec USDT, USDC, BTC, ETH, SOL dans la console, dès $10. La carte, y compris Apple Pay et Google Pay, est aussi acceptée. Le solde est tenu en dollars américains, n'expire pas, et il n'y a pas d'abonnement.
Comment savoir que c'est bien Claude qui répond ?: Chaque modèle reçoit le même prompt de test une fois par jour et sa réponse est comparée aux résultats précédents ; les résultats sont publics sur https://api.relayswitch.io/v1/proof, sans clé API. Chaque requête a aussi un reçu signé qui indique l'id du modèle, les tokens facturés et le coût.

Pages liées

Deux variables, puis lancez claude

Créez une clé API dans la console, rechargez dès $10 par carte ou en crypto, et Claude Code tourne sur votre solde prépayé.

Modèles Obtenir une clé API