Claude Code

Configuration de la clé API Claude Code

Claude Code lit deux variables d’environnement pour acheminer les requêtes n’importe où : ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY. Faites-les pointer vers RunAPI et exécutez chaque modèle Claude à la moitié du tarif officiel. Ce guide montre les commandes exactes pour Mac, Linux et Windows.

Mis à jour le June 18, 2026 RunAPI Editorial
En un coup d'œil

Comment définir une clé API personnalisée dans Claude Code ?

Claude Code utilise deux variables d’environnement pour décider où vont les requêtes et comment elles s’authentifient. Définissez ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY avec les valeurs RunAPI et chaque requête est acheminée via RunAPI avec 50% de réduction. Vous voulez utiliser un fournisseur entièrement différent ? RunAPI fonctionne aussi comme passerelle de remplacement afin que vous puissiez exécuter des modèles Claude sans compte Anthropic direct.

Deux variables

ANTHROPIC_BASE_URL définit le point de terminaison. ANTHROPIC_API_KEY définit la clé. C’est toute la configuration — deux variables, aucun autre changement.

Valeur de l'endpoint

Définissez ANTHROPIC_BASE_URL sur https://runapi.ai pour que Claude Code route via RunAPI.

Persistez-les

Ajoutez les deux exports à votre profil shell (.zshrc ou .bashrc) afin de ne pas avoir à les redéfinir à chaque session. Les utilisateurs Windows les définissent dans PowerShell et ouvrent une nouvelle fenêtre.

50 % de remise

Chaque modèle Claude est facturé à la moitié du tarif officiel d'Anthropic. Sans abonnement, sans limite.

Avant de commencer

De quoi avez-vous besoin avant de configurer Claude Code ?

La configuration prend quelques minutes. Vous avez besoin de Claude Code installé, d’un compte RunAPI et d’un terminal. Exécutez d’abord claude --version pour confirmer que Claude Code fonctionne avant de toucher à toute configuration de clé API.

Claude Code installé

Installez Claude Code depuis la source officielle et confirmez qu’il s’exécute avec claude --version dans votre terminal. Si cette commande renvoie une erreur, corrigez l’installation avant de définir des clés API.

Un compte RunAPI

Inscrivez-vous sur runapi.ai. Le niveau gratuit inclut des crédits pour tester n'importe quel modèle Claude avant d'alimenter un solde.

Une clé API

Créez une clé depuis Dashboard → API Keys. Copiez-la une seule fois — elle n’est affichée en entier qu’au moment de la création. Ne la collez pas dans des dépôts publics et ne la partagez pas dans des captures d’écran.

Accès au terminal

Vous avez besoin d’un shell pour définir des variables d’environnement. macOS et Linux utilisent .zshrc ou .bashrc. Les utilisateurs Windows peuvent utiliser PowerShell — définissez la variable, puis ouvrez une nouvelle fenêtre de terminal pour qu’elle prenne effet.

Étape par étape

Comment configurer une clé API Claude Code avec RunAPI

Exécutez ces commandes dans l’ordre. Elles définissent le point de terminaison et la clé, les rendent persistants dans votre profil shell, et confirment que Claude Code les prend en compte. Remplacez le placeholder par votre vraie clé RunAPI. Utilisez ANTHROPIC_API_KEY (pas CLAUDE_API_KEY) — c’est la variable que Claude Code lit réellement.

1

Définir l'URL de base

Cela indique à Claude Code d'envoyer les requêtes à RunAPI au lieu de l'endpoint Anthropic par défaut.

export ANTHROPIC_BASE_URL=https://runapi.ai
2

Définir la clé API

Collez votre clé RunAPI à la place du placeholder. Claude Code l'utilise pour authentifier chaque requête.

export ANTHROPIC_API_KEY=sk-your-runapi-key
3

Persister les deux variables

Ajoutez les deux exports à ~/.zshrc (ou ~/.bashrc) afin qu’ils survivent aux nouvelles sessions de terminal. Rechargez avec source ~/.zshrc. Sur Windows, définissez-les dans PowerShell et ouvrez une nouvelle fenêtre de terminal pour que le changement prenne effet.

echo 'export ANTHROPIC_BASE_URL=https://runapi.ai' >> ~/.zshrc
4

Vérifier la configuration

Confirmez que la variable affiche l’URL RunAPI. Si elle est vide, rechargez votre profil shell ou ouvrez un nouveau terminal — les variables définies dans une session ne sont pas automatiquement transférées.

echo $ANTHROPIC_BASE_URL
5

Exécuter Claude Code

Lancez Claude Code dans votre projet. Il route désormais via RunAPI à 50 % du tarif officiel.

claude
Variables d'environnement

Quelles variables d'environnement Claude Code lit-il ?

Claude Code lit un petit ensemble de variables pour contrôler le point de terminaison, l’authentification, le modèle et la longueur de sortie. Le tableau liste celles qui comptent pour la configuration d’un point de terminaison personnalisé et ce que chacune fait. Remarque : utilisez ANTHROPIC_API_KEY (pas CLAUDE_API_KEY) — c’est la variable que Claude Code lit réellement.

Variable Rôle Exemple de valeur
ANTHROPIC_BASE_URL Endpoint personnalisé vers lequel Claude Code envoie les requêtes https://runapi.ai
ANTHROPIC_API_KEY Clé utilisée pour authentifier les requêtes sk-your-runapi-key
ANTHROPIC_MODEL Modèle par défaut pour les nouvelles sessions claude-sonnet-4-6
CLAUDE_CODE_MAX_OUTPUT_TOKENS Limite des tokens retournés par réponse 8192

Vous pouvez également stocker ces valeurs dans un fichier de configuration .claude.json dans votre répertoire personnel ou de projet au lieu de les exporter à chaque session.

Choisir un modèle

Quel modèle Claude exécuter dans Claude Code ?

Claude Code accepte tout ID de modèle Claude via RunAPI. Choisissez selon la tâche : un modèle rapide et économique pour les modifications courantes, un modèle équilibré pour le codage quotidien, ou le plus puissant pour les problèmes difficiles. Définissez ANTHROPIC_MODEL pour changer la valeur par défaut, ou changez de modèle dans Claude Code — la facturation suit le modèle que vous appelez réellement.

claude-haiku-4-5

Le plus rapide et le moins cher à $1/M en entrée et $5/M en sortie via RunAPI. Idéal pour les modifications de routine et les recherches rapides.

claude-sonnet-4-6

Défaut équilibré pour le codage quotidien à $3/M en entrée et $15/M en sortie via RunAPI. La plupart des développeurs l'utilisent.

claude-opus-4-7

Le plus puissant pour les problèmes complexes à $5/M en entrée et $25/M en sortie via RunAPI. À utiliser pour les refactorisations et révisions complexes.

Changez à tout moment

Définissez ANTHROPIC_MODEL ou changez le modèle dans Claude Code à tout moment. La facturation suit le modèle que vous appelez réellement, toujours avec 50% de réduction.

Corriger les erreurs courantes

Pourquoi ma clé API Claude Code ne fonctionne-t-elle pas ?

La plupart des problèmes de configuration viennent de l’une de ces trois choses : le mauvais nom de variable d’environnement (utilisez ANTHROPIC_API_KEY, pas CLAUDE_API_KEY), une session shell obsolète qui n’a pas pris en compte les changements de profil, ou une faute de frappe dans la clé. Le tableau liste les erreurs courantes et la correction pour chacune.

Erreur ou symptôme Cause probable Solution
401 Unauthorized Clé API incorrecte ou expirée Vérifiez ANTHROPIC_API_KEY et créez une nouvelle clé dans le tableau de bord RunAPI si nécessaire
Les requêtes atteignent encore Anthropic ANTHROPIC_BASE_URL non défini dans ce shell Exécutez echo $ANTHROPIC_BASE_URL ; si vide, rechargez votre profil ou ouvrez un nouveau terminal
404 Not Found Slash final ou chemin incorrect dans l'URL de base Définissez l'URL de base exactement sur https://runapi.ai sans chemin final
Modèle introuvable Identifiant de modèle invalide ou mal orthographié Utilisez un identifiant valide comme claude-sonnet-4-6 ou claude-opus-4-7
Variables perdues au redémarrage Exports non écrits dans le profil shell Ajoutez les deux exports à ~/.zshrc ou ~/.bashrc et rechargez
Version rapide

Configuration de la clé API Claude Code en quatre étapes

1

Définir l'URL de base

Exportez ANTHROPIC_BASE_URL=https://runapi.ai pour router les requêtes via RunAPI.

2

Définir la clé API

Exportez ANTHROPIC_API_KEY avec votre clé RunAPI depuis Tableau de bord → Clés API.

3

Persister les deux variables

Ajoutez les deux exports à ~/.zshrc ou ~/.bashrc et rechargez avec source ~/.zshrc afin qu’ils survivent aux nouvelles sessions. Sur Windows, définissez-les dans PowerShell et ouvrez une nouvelle fenêtre de terminal.

4

Exécuter Claude Code

Exécutez claude --version pour confirmer l’installation, puis lancez claude dans votre projet. Les requêtes sont désormais acheminées via RunAPI avec 50% de réduction sur le tarif officiel.

Questions fréquentes

FAQ Clé API Claude Code

Comment ajouter une clé API à Claude Code ?

Définissez deux variables d’environnement. Exportez ANTHROPIC_BASE_URL vers https://runapi.ai et ANTHROPIC_API_KEY vers votre clé RunAPI. Ajoutez les deux à votre profil shell (.zshrc ou .bashrc) afin qu’elles persistent entre les sessions. Claude Code les lit au démarrage et achemine chaque requête via RunAPI.

Où obtenir une clé API Claude Code ?

Créez-en une sur runapi.ai. Inscrivez-vous, ouvrez Dashboard → API Keys, puis générez une clé. Copiez-la immédiatement — la clé complète n’est affichée qu’à la création. L’offre gratuite inclut des crédits pour tester n’importe quel modèle Claude avant d’alimenter un solde.

À quoi sert ANTHROPIC_BASE_URL ?

Elle indique à Claude Code vers quel endpoint envoyer les requêtes. Par défaut, Claude Code appelle Anthropic directement. La définir sur https://runapi.ai route chaque requête via RunAPI, qui facture les mêmes modèles à 50 % du tarif officiel.

Puis-je utiliser Claude Code avec d’autres fournisseurs d’API comme OpenAI ?

Existe-t-il un moyen d’utiliser Claude Code avec d’autres fournisseurs d’API comme OpenAI ? Oui — Claude Code prend en charge tout point de terminaison compatible OpenAI via ANTHROPIC_BASE_URL. RunAPI expose une passerelle compatible afin que vous puissiez changer de fournisseur sans modifier votre code, en utilisant une seule clé pour Claude, GPT et d’autres modèles.

Pourquoi Claude Code facture-t-il encore au plein tarif ?

Exécutez echo $ANTHROPIC_BASE_URL dans votre terminal. Si rien ne s’affiche, l’export n’a pas persisté. Ajoutez les deux exports à ~/.zshrc ou ~/.bashrc, exécutez source ~/.zshrc, puis ouvrez un nouveau terminal et vérifiez à nouveau. Les utilisateurs Windows doivent ouvrir une nouvelle fenêtre PowerShell après avoir défini les variables d’environnement.

Puis-je stocker la clé dans un fichier de configuration à la place ?

Oui. Placez les valeurs dans un fichier .claude.json dans votre répertoire personnel ou de projet plutôt que de les exporter à chaque session. Les deux approches fonctionnent — le fichier est pratique pour les clés par projet, tandis que les exports sont plus simples pour une configuration globale unique.

Comment surveiller les coûts après la configuration ?

Ouvrez le tableau de bord RunAPI. Il affiche les dépenses par clé et par requête en temps réel. Pour plafonner le coût de sortie, définissez CLAUDE_CODE_MAX_OUTPUT_TOKENS afin que chaque réponse soit limitée, et utilisez claude-haiku-4-5 pour les modifications courantes.

Cela change-t-il le comportement de Claude Code ?

Non. RunAPI relaie les requêtes directement vers les modèles Claude sous-jacents. La sortie, l’utilisation des outils et le comportement sont identiques à un appel direct à Anthropic. Vous ne changez que l’endroit où vont les requêtes et la manière dont elles sont facturées — l’expérience de codage reste la même.

ARTICLES CONNEXES

Explorer davantage

Pointez Claude Code vers RunAPI en deux commandes.

Créez un compte RunAPI gratuit, définissez ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY dans votre profil shell, et exécutez chaque modèle Claude dans Claude Code avec 50% de réduction sur la tarification officielle Anthropic.