Claude Code dans VS Code

Installez l'extension Claude Code dans VS Code, faites-la pointer vers AI in IDE avec une seule clé API et vérifiez la première requête en quelques minutes.

Le montage complet tient en une extension, une clé et un bloc JSON : pas d'abonnement Anthropic, pas de carte bancaire à enregistrer, pas de forfait par siège.

Cette page traite de VS Code proprement dit. Cursor utilise la même extension et les mêmes réglages : si c'est votre éditeur, allez plutôt à Claude Code dans Cursor. JetBrains suit une logique différente, le plugin n'embarquant pas le CLI — voir Claude Code dans JetBrains.

Versions et prérequis

Le numéro de version de l'extension est celui de Claude Code qu'elle embarque : l'extension 2.1.286 contient Claude Code 2.1.286. Installer l'extension n'ajoute pas claude au PATH — il faut pour cela le CLI autonome (npm install -g @anthropic-ai/claude-code). Le CLI ne sert qu'aux sessions en terminal ou à claude mcp add ; le panneau de discussion fonctionne sans lui.

Installer l'extension

• Lien direct : Installer pour VS Code — la vue Extensions s'ouvre avec l'éditeur déjà résolu, mais vous devez encore confirmer l'installation.
• Manuellement : Cmd+Shift+X (macOS) ou Ctrl+Shift+X (Windows/Linux), cherchez Claude Code, cliquez sur Installer.
• Marché inaccessible : téléchargez le VSIX depuis le Visual Studio Marketplace puis utilisez Installer depuis un VSIX….

Si le panneau n'apparaît pas, exécutez Developer: Reload Window depuis la palette de commandes. Les places de marché d'extensions sont des logiciels tiers ; une installation neuve demande toujours une confirmation.

Créer et copier la clé API

1. Choisissez une offre sur la page des tarifs. Un même compte permet de créer des clés distinctes pour Claude, GPT et Gemini ; chaque clé utilise le canal choisi.
2. Ouvrez API Keys dans votre tableau de bord et créez une clé.
3. Sélectionnez le canal AWSQ ou CCMAX : ce sont les canaux Claude Code. Une clé Codex ou Gemini sera refusée ici.
4. Vous pouvez ensuite retrouver la clé complète dans la liste API Keys pour l’afficher ou la copier.

Remplacez YOUR_DASHBOARD_API_KEY par cette valeur dans tous les extraits ci-dessous.

Configuration

Il y a deux niveaux, et c'est là que la plupart des installations échouent. Un VS Code lancé depuis le Dock ou le menu Démarrer n'hérite pas de votre profil shell : un export ANTHROPIC_BASE_URL=... dans ~/.zshrc fonctionne dans le terminal intégré mais reste invisible pour le panneau de discussion. Écrivez les valeurs dans le fichier de réglages de Claude Code, que l'extension et le CLI lisent tous les deux.

1. Fichier de réglages Claude Code

~/.claude/settings.json sous macOS et Linux, C:/Users/<UserName>/.claude/settings.json sous Windows. Créez le fichier et son dossier s'ils n'existent pas :

Copy
1
{
2
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY",
6
    "API_TIMEOUT_MS": "600000",
7
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
8
  }
9
}

ANTHROPIC_BASE_URL doit rester l'hôte nu. Claude Code ajoute lui-même /v1/messages ; avec https://api.aiinide.com/v1 la requête part vers /v1/v1/messages et renvoie une erreur 404. Si vous avez déjà un settings.json, fusionnez l'objet env au lieu de remplacer le fichier, sinon vous perdez vos règles de permissions et vos hooks.

2. Désactiver l'écran de connexion Anthropic

Le panneau est conçu autour d'un compte claude.ai et affiche un écran de connexion au premier lancement. Demandez-lui de s'en passer :

Copy
1
"claudeCode.disableLoginPrompt": true

Placez ceci dans le settings.json utilisateur de VS Code (Cmd+, / Ctrl+, → cherchez « Claude Code login »), ou dans la section Extensions sous Claude Code.

3. Facultatif : fixer le modèle et les délais

Copy
1
{
2
  "model": "claude-sonnet-5-5",
3
  "env": {
4
    "ANTHROPIC_BASE_URL": "https://api.aiinide.com",
5
    "ANTHROPIC_AUTH_TOKEN": "YOUR_DASHBOARD_API_KEY"
6
  }
7
}

Sans model, l'extension garde son sélecteur par défaut ; vous pouvez changer en cours de session avec /model.

4. Si vous préférez les variables d'environnement

Les profils shell restent utiles pour les sessions en terminal, notamment si vous lancez l'éditeur avec code . depuis un terminal. Sous macOS ou Linux :

Copy
1
export ANTHROPIC_BASE_URL='https://api.aiinide.com'
2
export ANTHROPIC_AUTH_TOKEN="YOUR_DASHBOARD_API_KEY"
3
export API_TIMEOUT_MS=600000
4
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Sous Windows : setx ANTHROPIC_BASE_URL "https://api.aiinide.com", puis de même pour les trois autres, et redémarrez VS Code. Attention à la priorité : un ANTHROPIC_AUTH_TOKEN exporté dans le shell l'emporte sur le fichier. Gardez une seule source de vérité.

Vérifier

Commencez par lister les modèles pour vérifier la clé et son canal Claude. Cette requête ne consomme pas de quota.

Copy
1
curl --globoff -i 'https://api.aiinide.com/v1/models' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01"

Le statut HTTP 200 renvoie la liste des modèles. Un statut 401 indique une clé absente, invalide ou expirée. Un statut 400 indique que la clé appartient à un autre canal. Dans l’exemple Messages ci-dessous, utilisez un identifiant de la liste.

1. L'icône Spark. Ouvrez un fichier et cliquez sur l'icône Spark dans la barre d'outils de l'éditeur, ou sur ✻ Claude Code dans la barre d'état. Aucun écran de connexion ne doit apparaître.
2. /status. Dans la zone de saisie, lancez /status : la version de Claude Code et le modèle actif s'affichent.
3. Envoyez une courte demande dans l’éditeur, puis vérifiez la consommation de cette clé dans le tableau de bord.
4. Testez un appel au modèle avec la clé vérifiée.

Copy
1
curl --globoff 'https://api.aiinide.com/v1/messages' \
2
  -H "x-api-key: YOUR_DASHBOARD_API_KEY" \
3
  -H "anthropic-version: 2023-06-01" \
4
  -H "Content-Type: application/json" \
5
  -d '{"model":"MODEL_ID_FROM_LIST","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'

1. Consommation. Ouvrez Utilisation : un message réussi apparaît en tokens consommés sur cette clé.

Dépannage

Utilisez un identifiant exact renvoyé par GET /v1/models. Une faute dans un nom claude-* peut diriger la requête vers le modèle Claude configuré par défaut, qui sera alors facturé à son propre tarif.

API Error: 404

Réglez ANTHROPIC_BASE_URL sur https://api.aiinide.com. Ajouter /v1 envoie la requête vers /v1/v1/messages, qui renvoie une erreur 404.

API Error: 400 — requête invalide

• Mauvais canal. Les clés Codex et Gemini s'authentifient sur d'autres chemins et renvoient 400 ici. Recréez la clé en AWSQ ou CCMAX.
• settings.json corrompu. Une virgule finale ou une valeur au mauvais niveau rend le fichier illisible, et l'extension retombe sur ses valeurs par défaut. Validez-le : la ligne $schema fait apparaître les erreurs directement dans VS Code.

Vérification de la clé API

Utilisez le statut de GET /v1/models pour vérifier la clé. Si elle est absente ou invalide, le point d’entrée natif POST /v1/messages peut renvoyer HTTP 200 avec un message d’authentification dans content.

• Jeton non chargé. Le processus du panneau n'a pas lu settings.json. Enregistrez, puis Developer: Reload Window ; un redémarrage complet de VS Code est la version fiable.
• ANTHROPIC_API_KEY prioritaire. Si votre shell exporte aussi ANTHROPIC_API_KEY, une ancienne clé Anthropic peut prendre le pas sur ANTHROPIC_AUTH_TOKEN. Supprimez-la.
• Clé expirée. Une clé créée avec une date d'expiration cesse de fonctionner sans message. Vérifiez les dates dans le tableau de bord et faites une rotation.

Réseau, TLS et délais

Problèmes liés à la fenêtre

• Mode restreint. L'extension est désactivée dans les espaces de travail non approuvés. Approuvez le dossier et rechargez.
• Remote SSH, WSL ou conteneur de développement. Les réglages doivent être sur l'hôte distant, dans ~/.claude/settings.json à l'intérieur de cet environnement. Modifier le fichier local n'a aucun effet sur les sessions distantes.
• claude: command not found dans le terminal intégré. C'est normal : l'extension n'installe pas le CLI. Installez-le globalement, ou continuez d'utiliser le panneau.
• Icône Spark absente. Elle exige un fichier ouvert. Vérifiez ensuite la version (1.94.0+) et désactivez temporairement les autres extensions IA qui occupent le même emplacement de barre d'outils.

Modèles et tarifs

Les tarifs de base d'Opus 5.5 sont de 4 $ par million de tokens en entrée, 0,20 $ en lecture de cache et 20 $ en sortie. AWSQ consomme le quota à 0,8× et CCMAX à 2× : la même clé achète donc un volume de travail différent selon le canal. Si l'amont sert en mode Fast, les tarifs de base et de cache doublent et la facturation suit usage.speed.

• Prix et quotas actuels : tarifs
• Gestion des canaux et quotas : API Keys
• Protocole et tarifs détaillés : Configuration
• Tarification officielle du mode Fast : documentation Anthropic
• Référence officielle de configuration des modèles : code.claude.com

Questions fréquentes

Faut-il aussi un abonnement Anthropic ? Non. C'est tout l'intérêt du montage : ANTHROPIC_AUTH_TOKEN plus une URL de base remplacent la connexion claude.ai, et claudeCode.disableLoginPrompt empêche l'extension de la réclamer.

La même clé fonctionne-t-elle dans Cursor ? Oui. Cursor exécute la même extension, donc le même settings.json et les mêmes réglages claudeCode.* s'appliquent. Voir Claude Code dans Cursor.

L'extension lit-elle le settings.json de l'espace de travail ? Certains réglages, comme le mode de permissions initial, ne sont pris en compte qu'au niveau utilisateur. Placez les réglages de connexion dans ~/.claude/settings.json pour qu'ils soient identiques dans chaque espace de travail et chaque fenêtre.