Claude Code dans VS Code : connecter et vérifier l'intégration

Les trois couches de l'intégration

Une panne peut se manifester par « Claude Code ne répond pas », mais l'intégration repose sur trois couches distinctes.

CLI. L'extension officielle inclut Claude Code CLI dans le terminal intégré. Une installation système séparée n'est nécessaire que pour utiliser la CLI hors de l'extension.

Extension VS Code. L'extension Claude Code officielle d'Anthropic fournit le chat, les diffs côte à côte, les mentions de fichiers avec @ et l'historique de session. Lors de la vérification, la documentation officielle demandait VS Code 1.98.0 ou ultérieur.

Endpoint API. Claude Code utilise l'API Anthropic par défaut. Pour BetterToken, définissez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN; l'extension les transmet à Claude Code.

Une entrée réussie dans le Dashboard confirme que BetterToken a accepté la requête. Vérifiez séparément le contexte du fichier et le diff pour valider l'intégration IDE.

Utilisez votre propre compte BetterToken, créez une clé API dans le tableau de bord et reprenez la Base URL dans la documentation.

Créez votre clé API puis configurez Claude Code avec la documentation BetterToken : docs.bettertoken.ai/ai-tools/claude-code

Créer la clé API BetterToken et connecter l'endpoint

Étape 1. Créer le compte et la clé

Ouvrez bettertoken.ai, inscrivez-vous, allez dans la gestion des clés, créez une clé API et copiez-la pour l'étape suivante.

Étape 2. Relever la Base URL

Pour Claude Code, utilisez cette Base URL compatible Anthropic :

https://www.bettertoken.ai

N'ajoutez pas /v1 : Claude Code ajoute lui-même le chemin de méthode. L'adresse avec /v1 est réservée aux outils compatibles OpenAI, comme Codex CLI.

Étape 3. Modifier ~/.claude/settings.json

Sous macOS et Linux, le fichier est ~/.claude/settings.json; sous Windows, %USERPROFILE%\.claude\settings.json. Ajoutez le bloc env :

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "your_api_key_here"
  }
}

Remplacez your_api_key_here par la clé créée à l'étape 1. Si le fichier contient déjà d'autres propriétés, ajoutez seulement "env". La CLI et l'extension lisent toutes deux ce fichier.

Étape 4. Désactiver l'écran de connexion

Dans les réglages de VS Code (Cmd+, sur Mac ou Ctrl+, sur Windows/Linux), ouvrez Extensions → Claude Code et activez Disable Login Prompt. Cette option masque la connexion Anthropic pour un provider tiers; elle ne remplace pas la configuration env.

Démarrer Claude Code dans VS Code

Étape 5. Installer l'extension

Avec Cmd+Shift+X sur Mac ou Ctrl+Shift+X sur Windows/Linux, cherchez « Claude Code » par Anthropic et cliquez sur Install. Si l'icône n'apparaît pas, lancez Developer: Reload Window depuis la palette. Vérifiez sous Help → About que VS Code est au moins en version 1.98.0.

Étape 6. Ouvrir le panneau

Ouvrez un fichier : l'icône Spark (✱) de l'Editor Toolbar apparaît seulement lorsqu'un fichier est ouvert. Cliquez-la pour ouvrir le chat. Autres accès :

• Activity Bar : l'icône Spark dans la barre latérale gauche;
• Command Palette (Cmd+Shift+P / Ctrl+Shift+P) → « Claude Code: Open in New Tab »;
• Status Bar → ✱ Claude Code en bas à droite, même sans fichier ouvert.

Étape 7. Vérifier le contexte du fichier

Sélectionnez plusieurs lignes : Claude Code affiche le nombre de lignes sélectionnées sous le champ de saisie. Option+K sur Mac ou Alt+K sur Windows/Linux ajoute une référence comme @file.ts#5-10 à la requête.

Vérifier contexte, diff et requête Dashboard

Étape 8. Envoyer un test sans risque

Ouvrez un petit script ou fichier de configuration et demandez une modification simple et réversible :

Ajoute avant la première fonction un commentaire d'une ligne qui explique brièvement son rôle.

Ou :

Renomme la variable `tmp` en `result` dans ce fichier.

L'objectif est une modification concrète que vous pouvez inspecter visuellement.

Étape 9. Examiner le diff côte à côte

Après une proposition, l'extension affiche l'avant/après et demande votre accord. Vérifiez puis choisissez Accept ou Reject. Un diff cohérent montre que l'extension a reçu la réponse du modèle et l'a associée au fichier courant; le routage BetterToken se contrôle dans le Dashboard.

Étape 10. Rechercher la requête dans BetterToken

Ouvrez bettertoken.ai, puis le Dashboard ou l'historique des requêtes. Cherchez l'entrée correspondant à l'heure du test et comparez modèle, statut, tokens d'entrée, de sortie et de cache, ainsi que le débit correspondant.

Un diff correct dans VS Code et une entrée réussie au même moment confirment les trois couches : l'extension a transmis le contexte, BetterToken a traité la requête et la réponse est revenue dans l'IDE.

En l'absence de résultat :

• aucune réponse ni entrée Dashboard — vérifiez lancement de l'extension, env, Base URL et réseau;
• entrée Dashboard en erreur — contrôlez clé, modèle et message d'erreur;
• réponse ou diff sans entrée correspondante — revérifiez endpoint, heure et filtres; le routage BetterToken n'est pas encore confirmé.

Si l'intégration n'est pas détectée

L'icône Spark est absente

Elle n'apparaît dans l'Editor Toolbar que lorsqu'un fichier est ouvert. Si c'est le cas :

1. Vérifiez VS Code 1.98.0 ou supérieur dans Help → About.
2. Lancez Developer: Reload Window depuis la Command Palette.
3. Désactivez temporairement Cline, Continue ou GitHub Copilot : leurs icônes peuvent entrer en conflit.

Le bouton ✱ Claude Code de la Status Bar reste utilisable sans fichier ouvert.

VS Code n'hérite pas des variables du terminal

Si ANTHROPIC_BASE_URL est défini dans le shell mais que l'extension demande une connexion, VS Code lancé depuis Spotlight ou le menu Applications n'a pas hérité de cet environnement. Lancez-le dans le terminal :

code .

La session actuelle est alors transmise à VS Code. Sinon, renseignez aussi les variables dans Extensions → Claude Code → environmentVariables.

L'extension redemande une connexion

Confirmez que Disable Login Prompt est activé. Il désactive l'écran Anthropic, mais les variables de connexion doivent toujours être définies séparément.

La configuration modifiée n'est pas lue

Vérifiez le bon chemin et le JSON de settings.json : une virgule en trop ou une accolade manquante empêche le chargement de env. Rechargez ensuite la fenêtre. Contrôlez également qu'aucune ancienne Base URL ou clé n'est définie dans le shell ou les réglages. Pour les champs, consultez la documentation BetterToken actuelle, pas un ancien extrait de blog.

Erreur d'authentification : 401 ou aucune réponse

Contrôlez dans cet ordre :

1. Base URL — https://www.bettertoken.ai sans /v1; le suffixe peut produire un 404 pour certaines méthodes.
2. Clé API — pas d'espace, de saut de ligne ni de guillemet supplémentaire.
3. Conflit de variables — une valeur différente de ANTHROPIC_AUTH_TOKEN ou ANTHROPIC_BASE_URL dans le shell peut remplacer la configuration. Supprimez le conflit ou démarrez avec code ..

Sans entrée Dashboard, vérifiez d'abord envoi, endpoint et réseau; une entrée 401 désigne la clé ou son format.

Documentation complète Claude Code pour BetterToken : docs.bettertoken.ai/ai-tools/claude-code