Clé API Claude Code : obtenez-en une et configurez-la en 1 minute

Clé API vs connexion par abonnement

Claude Code a deux façons de s'authentifier. Avec /login, il utilise votre forfait Claude Pro ou Max, et l'utilisation est décomptée du quota de 5 heures et du quota hebdomadaire de ce forfait. Avec une clé API, il envoie les requêtes au point de terminaison API que vous configurez, et vous payez par token.

Lorsqu'une clé API est configurée, Claude Code facture cette clé et n'utilise pas le quota de votre forfait Claude. Supprimez les variables et exécutez /login pour revenir en arrière.

Comment fonctionnent les limites d'utilisation de Claude Code

Où obtenir une clé et comment recharger

1. 1. Inscription

   Créez un compte sur aicodewith.ai avec e-mail, Google ou GitHub.

2. 2. Rechargez votre solde

   La facturation est prépayée. Les comptes internationaux paient en USD par carte via Stripe ; les comptes de Chine continentale paient en CNY via Alipay. La région de facturation est choisie lors de votre première recharge et le montant minimum est indiqué au moment du paiement.

3. 3. Créez la clé

   Ouvrez API Keys dans le tableau de bord et créez une clé. Vous pouvez éventuellement définir un plafond de dépenses quotidien, mensuel ou total. Copiez la clé ; vous la collerez ensuite dans Claude Code.

Votre solde est débité par token au prix du modèle et du canal que vous utilisez. Les crédits sont valables un an, et le solde inutilisé peut être remboursé dans les 90 jours suivant la recharge ; des frais de 10% s'appliquent.

Options de rechargeFAQ sur les paiements et remboursementsPolitique de remboursement

"From" prices are based on the Economy channel, the lowest-priced Claude channel currently listed (about 19% of Anthropic list price). Other channels cost more; the rate depends on the channel you choose, and the models page is always the source of truth.

Où placer la clé

Choisissez un seul emplacement. settings.json est le plus fiable car la CLI Claude Code et ses extensions IDE le lisent toutes. Les variables shell sont pratiques pour un test rapide ou une tâche CI.

1. 1. Option A : ~/.claude/settings.json (recommandé)

   macOS et Linux : ~/.claude/settings.json. Windows : %USERPROFILE%\.claude\settings.json. Créez le fichier s'il n'existe pas, et fusionnez le bloc env s'il existe.

   ~/.claude/settings.json

   {
     "env": {
       "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
       "ANTHROPIC_API_KEY": "",
       "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
     }
   }

2. 2. Ignorez l'écran de connexion au premier lancement

   Lors d'une nouvelle installation, ajoutez ce champ à ~/.claude.json pour que Claude Code ne vous demande pas de vous connecter à un compte Anthropic. Si le fichier existe, ajoutez le champ au lieu de l'écraser.

   ~/.claude.json

   {
     "hasCompletedOnboarding": true
   }

3. 3. Option B : variables d'environnement shell

   Ajoutez ces lignes à ~/.zshrc ou ~/.bashrc (ou exportez-les dans une étape CI), puis ouvrez un nouveau terminal.

   bash / zsh

   export ANTHROPIC_BASE_URL="https://api.aicodewith.ai"
   export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
   export ANTHROPIC_API_KEY=""

4. 4. Option B sous Windows (PowerShell)

   Définit des variables au niveau utilisateur. Ouvrez ensuite un nouveau terminal.

   PowerShell

   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicodewith.ai", "User")
   [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")

ANTHROPIC_BASE_URL est le domaine brut https://api.aicodewith.ai. N'ajoutez pas /v1 ; Claude Code ajoute lui-même le chemin et /v1 entraîne des erreurs 404.

ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_API_KEY ?

Définir ANTHROPIC_API_KEY sur une chaîne vide est important : si une ancienne clé Anthropic est encore exportée dans votre shell, elle peut être envoyée à la place de votre clé aicodewith et la requête échoue avec 401.

Guide complet de configuration de Claude Code

Vérifier que cela fonctionne, et ce que signifient les erreurs

1. Fermez toutes les sessions Claude Code et exécutez claude à nouveau.
2. Exécutez /status et confirmez que le point de terminaison API affiche api.aicodewith.ai.
3. Envoyez un court message. La requête et son coût apparaissent dans l'historique d'utilisation du tableau de bord.
4. Exécutez /cost pour voir le coût par token de la session.

Une clé sur plusieurs projets et machines

Une clé n'est pas liée à un appareil ou à un projet. Utilisez la même clé sur votre ordinateur portable, un serveur de développement et CI, ou créez une clé par projet, coéquipier ou pipeline. Des clés distinctes vous donnent des historiques d'utilisation et des plafonds de dépenses distincts, et vous pouvez en supprimer une sans toucher aux autres.

• •Les plafonds de dépenses quotidiens, mensuels ou totaux par clé empêchent une boucle d'agent qui s'emballe de vider le solde.
• •L'historique d'utilisation montre chaque requête avec son modèle, ses tokens et son coût.
• •Traitez les clés comme des mots de passe : gardez-les hors de git, et renouvelez une clé si elle fuit.

Étapes suivantes

Utiliser Claude Code sans abonnementAlternative à Claude Max : payer par tokenLes limites d'utilisation de Claude Code expliquéesGuide d'intégration de Claude CodeDocumentation

FAQ