Claude Code dans VS Code : installation et usage

Pour utiliser Claude Code dans VS Code, installez l'extension officielle d'Anthropic depuis la vue Extensions, connectez-vous avec un abonnement Claude payant, puis réglez le mode de permission avant d'ouvrir la première conversation. Ces trois gestes prennent quelques minutes. Le troisième est le plus facile à oublier, alors que depuis la version 2.1.283 une nouvelle conversation démarre par défaut en mode Auto, où l'agent agit sans vous demander.

L'extension compte 28 864 230 installations sur la place de marché de VS Code (relevé du 28 octobre 2026), avec une note moyenne de 3,7 sur 5 sur 836 avis. Le public visé est large : dans l'enquête Stack Overflow 2025, 75,9 % des développeurs qui ont répondu à la question utilisaient Visual Studio Code, et l'édition 2026 ne détaille plus les éditeurs. Chez Noxcod, nos sessions de Claude Code tournent surtout en terminal, sur un serveur Linux où plusieurs agents travaillent en parallèle. Nous ouvrons l'extension pour une autre raison : relire. Pour nous, elle est le meilleur poste de relecture de Claude Code, et le CLI garde tout ce qui tourne longtemps ou sans surveillance.

Installer l'extension Claude Code dans VS Code en quatre gestes

L'extension s'installe depuis VS Code lui-même : ouvrez la vue Extensions avec Ctrl+Shift+X (Cmd+Shift+X sur Mac), cherchez « Claude Code », vérifiez que l'éditeur affiché est Anthropic avec sa coche de vérification, puis cliquez sur Installer. L'identifiant exact, visible sur la fiche de l'extension, est anthropic.claude-code.

Les prérequis tiennent en deux lignes dans la documentation officielle. Il faut VS Code 1.94.0 ou plus récent, et un compte Anthropic : un abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Console facturé à l'usage. Avec un abonnement, aucune clé d'API n'est demandée. L'offre gratuite de Claude n'inclut pas Claude Code. Sur la page tarifs d'Anthropic, relevée le 28 octobre 2026, Pro coûte 17 $ par mois en engagement annuel (200 $ payés d'avance) ou 20 $ au mois, Max démarre à 100 $ par mois, et le siège Team Standard vaut 20 $ par mois en engagement annuel ou 25 $ au mois. Les prix y sont affichés en dollars.

Au premier lancement, cliquez sur l'icône en forme d'étincelle en haut à droite de l'éditeur. Elle n'apparaît que lorsqu'un fichier est ouvert ; sans fichier, passez par l'entrée « Claude Code » de la barre d'état, en bas à droite. Un écran de connexion s'ouvre et l'autorisation se termine dans le navigateur. Si vous comptiez sur une variable ANTHROPIC_API_KEY définie dans votre shell et que l'écran de connexion insiste, VS Code n'a pas hérité de votre environnement : lancez-le depuis un terminal avec code ..

L'extension ne fonctionne pas non plus en mode restreint, comme le rappelle la page de dépannage : si le panneau reste vide dans un dépôt fraîchement cloné, approuvez d'abord le dossier.

Ce que l'extension embarque, et pourquoi le CLI reste à installer

L'extension embarque sa propre copie de Claude Code, mais elle n'ajoute pas la commande claude à votre PATH. Taper claude dans le terminal intégré renvoie donc une commande introuvable tant que vous n'avez pas fait l'installation autonome du CLI, comme le précise la section Run CLI in VS Code. Nous avons ouvert le manifeste de la version 2.1.312, publiée le 27 octobre 2026 : il déclare 23 réglages propres à VS Code et 31 commandes, et le paquet pour Linux x64 diffusé sur Open VSX pèse 137 Mo. Son numéro de version est celui du Claude Code qu'elle contient, d'après la page d'installation.

Les deux interfaces partagent davantage qu'on ne le croit. L'historique est commun : une conversation commencée dans le panneau se reprend en terminal avec claude --resume. La configuration aussi, puisque le fichier ~/.claude/settings.json sert à l'extension comme au CLI pour les commandes autorisées, les variables d'environnement, les hooks et les serveurs MCP. Les hooks que nous avons écrits pour le terminal, comme celui qui bloque une commande destructive, valent donc aussi pour les conversations du panneau. Nous détaillons ces mécanismes dans notre article sur les hooks, skills et MCP au quotidien.

Quand l'extension est active, elle fait aussi tourner un serveur MCP local nommé ide, attaché à 127.0.0.1 sur un port tiré entre 10 000 et 65 535 et protégé par un jeton que seul votre utilisateur peut lire. C'est par lui que le CLI lancé dans le terminal intégré ouvre ses propositions dans l'afficheur de différences de VS Code et lit les erreurs du panneau Problèmes.

Il reste des écarts entre les deux. La comparaison officielle en liste trois : le panneau ne propose qu'une partie des commandes et des skills, le raccourci ! qui lance une commande shell n'y existe pas, et la complétion par tabulation non plus. Quand une de ces fonctions vous manque, ouvrez le terminal intégré et lancez claude. La désinstallation réserve enfin une surprise : si vous retirez l'extension mais lancez encore claude dans le terminal intégré, Claude Code la réinstalle tout seul, sauf si vous désactivez l'option autoInstallIdeExtension.

Régler le mode de permission avant la première conversation

Pour régler le mode de départ, posez claudeCode.initialPermissionMode dans vos paramètres utilisateur de VS Code. Sans ce réglage, une nouvelle conversation démarre en mode Auto depuis la version 2.1.283, sur toutes les offres et chez tous les fournisseurs, selon la documentation des modes : un classifieur relit la plupart des actions à votre place au lieu de vous les soumettre. Il bloque par défaut le téléchargement suivi de l'exécution d'un script, l'envoi de données sensibles vers l'extérieur, les déploiements en production ou le force push, selon la liste publiée par Anthropic. Sur un projet personnel, ce confort se défend. Sur le dépôt d'un client, nous préférons voir chaque modification passer.

L'extension choisit le mode de départ dans un ordre fixe, décrit sur la page des modes de permission. Elle prend d'abord le réglage claudeCode.initialPermissionMode, puis le dernier mode choisi dans l'indicateur s'il s'agissait de Manual, Edit automatically ou Auto, puis le permissions.defaultMode des réglages gérés ou de ~/.claude/settings.json, et enfin le défaut intégré. Le mode choisi un jour dans l'indicateur se reporte donc sur toutes les conversations suivantes, sans rappel. Par ailleurs, VS Code ne lit initialPermissionMode que dans vos paramètres utilisateur : une valeur posée dans les paramètres de l'espace de travail est ignorée.

Pour un poste qui touche à des dépôts clients, nous utilisons cette valeur :

"claudeCode.initialPermissionMode": "default"

Dans le tableau des réglages de l'extension, la valeur default correspond au mode affiché Manual : Claude demande avant chaque modification de fichier et avant la plupart des commandes. La valeur plan va plus loin, l'agent décrit ce qu'il compte faire et attend votre accord. Pour une équipe, ce réglage individuel ne suffit pas, puisque chacun peut le changer. Sur Team et Enterprise, le verrou se pose côté organisation, en désactivant le mode Auto dans les réglages gérés avec permissions.disableAutoMode réglé sur "disable". Quelques chemins protégés restent sensibles dans tous les cas : en Manual et en Edit automatically, toute écriture dans .git, .vscode, .claude, .npmrc ou .mcp.json vous est demandée, et en Auto elle passe par le classifieur. Le reste des garde-fous, bac à sable et données comprises, fait l'objet de notre article sur la sécurité de Claude Code.

Relire chaque modification avant qu'elle touche le disque

En mode Manual, l'extension affiche chaque modification proposée dans l'afficheur de différences de VS Code, à côté de l'original, et attend votre décision avant d'écrire le fichier. Depuis la v2.1.275, d'après la documentation de l'extension, des boutons Accept this change et Reject this change apparaissent sous chaque bloc modifié : vous gardez la nouvelle validation de formulaire et refusez le renommage de variable qui l'accompagnait, sans réécrire de consigne. Au-delà de 100 changements, ces boutons disparaissent et la relecture se fait sur le fichier entier. Si vous retouchez vous-même le contenu proposé avant d'accepter, Claude en est informé et ne suppose pas que le fichier correspond à sa proposition.

C'est la meilleure raison d'ouvrir Claude Code dans VS Code plutôt que dans un terminal. Un diff de quarante lignes qui défile dans une console se lit mal, et on finit par accepter en bloc. Dans l'éditeur, la coloration syntaxique, la navigation entre les changements et la commande Accept Change at Cursor ramènent la relecture au rythme d'une revue de code ordinaire.

Le mode Plan suit la même logique en amont. Quand Claude a fini de planifier, VS Code ouvre le plan comme un document Markdown complet, sur lequel vous ajoutez des commentaires en ligne avant que l'agent commence. Taper /plan suivi d'une tâche, par exemple /plan corrige la validation du formulaire de contact, bascule en mode Plan et lance la réflexion d'un coup. Commenter une ligne du plan coûte une phrase ; corriger le code après exécution coûte un aller-retour complet.

Les points de restauration complètent le dispositif. En survolant un message, vous pouvez repartir de ce point dans une nouvelle branche de conversation, ramener le code à cet état en gardant l'historique, ou faire les deux. Leurs limites sont documentées : une session garde les 100 derniers points, les copies de fichiers sont supprimées environ 30 jours après la dernière sauvegarde, un fichier modifié uniquement par une commande shell n'est pas suivi, et les modifications d'un sous-agent ne sont en général pas restaurées. Avant de laisser l'agent lancer un script qui réécrit des fichiers, faites un commit git.

Donner du contexte à Claude sans lui envoyer vos secrets

Claude voit automatiquement votre sélection et le fichier ouvert dans VS Code, et la seule protection de vos secrets qui tienne dans le panneau comme dans le terminal est une règle de lecture interdite dans vos réglages. Le contexte d'abord : le raccourci Alt+K (Option+K sur Mac) insère une référence précise comme @app.ts#5-10, le symbole @ accepte des noms partiels (@auth trouve aussi bien auth.js que AuthService.ts), et la forme @terminal:nom transmet la sortie d'un terminal par son titre, pratique pour une trace d'erreur de build. Ces syntaxes sont décrites dans la section Reference files and folders.

Ce contexte automatique a un revers. Le panneau retient le texte sélectionné dans un fichier exclu par files.exclude ou search.exclude, ou ignoré par git, et Claude n'en reçoit que le chemin. La documentation précise que ce filtre ne couvre que le panneau : en mode terminal, une sélection faite dans votre .env peut partir chez Claude. La règle qui tient dans les deux interfaces se pose dans ~/.claude/settings.json ou dans les réglages du projet :

{
  "permissions": {
    "deny": ["Read(.env)", "Read(.env.*)", "Read(./secrets/**)"]
  }
}

D'après la page des permissions, un nom de fichier sans chemin, comme .env, s'applique à toute profondeur sous le dossier courant. Ces règles couvrent les outils de lecture de Claude, les mentions @, la sélection partagée par l'éditeur et les commandes shell que Claude Code reconnaît, comme cat ou head. Elles ne couvrent pas un script Python ou Node qui ouvre le fichier lui-même : pour un blocage au niveau du système, il faut le bac à sable. Si vous préférez couper toute transmission automatique, les réglages claudeCode.attachSelection et claudeCode.attachOpenFile se désactivent séparément.

L'horloge placée à côté de l'indicateur de contexte estime le temps restant avant l'expiration du cache de prompt, qui vit cinq minutes ou une heure selon la description de la zone de saisie. Quand elle passe au rouge, le message suivant sera plus lent et plus cher, le temps que le cache se reconstruise.

Plusieurs conversations, MCP et plugins depuis le panneau

Le panneau gère plusieurs conversations en parallèle, chacune avec son historique et son contexte. Les commandes Open in New Tab et Open in New Window de la palette de commandes en ouvrent de nouvelles. Sur l'icône de chaque onglet, un point bleu signale une demande de permission en attente et un point orange une réponse terminée pendant que l'onglet était caché. Une session inactive depuis 14 jours, si elle n'est ni ouverte, ni non lue, ni rangée dans un groupe, passe d'elle-même dans les sessions archivées.

Plusieurs onglets ne font pas plusieurs copies du dépôt. Deux conversations qui modifient les mêmes fichiers se marchent dessus, et les points de restauration de l'une ne capturent pas, en règle générale, les modifications faites par une autre session. Quand nous faisons travailler plusieurs agents en même temps, chacun reçoit son propre worktree git, avec ses fichiers et sa branche, mécanisme que la documentation de l'extension renvoie vers les sessions parallèles en worktree. Dans VS Code, ouvrez chaque worktree dans sa propre fenêtre plutôt que d'empiler les onglets dans la même.

Les serveurs MCP se gèrent sans quitter l'éditeur : la commande /mcp ouvre une fenêtre qui ajoute, retire, active ou reconnecte un serveur et gère son authentification OAuth. La commande claude mcp add tapée dans le terminal intégré écrit dans la même configuration. Attention, cette commande enregistre le serveur sans vérifier les identifiants ; c'est l'état Connected dans /mcp, après une nouvelle conversation, qui prouve que la connexion fonctionne.

La commande /plugins ouvre de la même façon un gestionnaire de plugins avec trois portées : pour vous dans tous vos projets, pour le projet et ses collaborateurs, ou localement pour vous dans ce seul dépôt. Avant d'en activer un, lisez notre méthode pour auditer un plugin avant de l'activer.

Panneau ou terminal : la répartition que nous appliquons

Nous ouvrons le panneau VS Code pour relire et décider, et nous gardons le terminal pour ce qui tourne longtemps, en parallèle ou sans personne devant l'écran. Le terminal donne toutes les commandes, le mode non interactif claude -p pour les scripts et l'intégration continue, et, dans notre cas, des sessions qui continuent sur un serveur distant quand l'éditeur est fermé.

Si vous travaillez dans une fenêtre VS Code connectée en SSH, à WSL ou à un conteneur de développement, la configuration à modifier est celle du système distant : la documentation précise, à propos des certificats, que ~/.claude/settings.json se modifie sur la machine connectée et pas sur votre poste. Nous en déduisons que vos règles de lecture et vos hooks se posent, eux aussi, sur la machine distante.

Les pannes courantes ont leur page de dépannage. Sur macOS Tahoe et les versions suivantes, Cmd+Esc ne fait rien parce que le raccourci de la surcouche de jeu du système l'intercepte ; décochez cette surcouche dans les réglages clavier de macOS, section des manettes de jeu, ou attribuez un autre raccourci à la commande Claude Code: Focus input. Si l'icône d'étincelle manque, ouvrez un fichier, vérifiez votre version de VS Code et désactivez un moment vos autres extensions d'IA. Si Claude ne répond plus du tout, la documentation conseille de lancer claude dans un terminal pour obtenir des messages d'erreur plus détaillés.

Régler son propre poste se fait seul ; aligner une équipe entière sur les mêmes règles demande plus de méthode. C'est l'objet de notre article pour former une équipe à Claude Code, et si vous voulez ce réglage déployé sur vos postes, vous pouvez contacter Noxcod.

Questions fréquentes sur Claude Code dans VS Code

Claude Code dans VS Code est-il gratuit ?

L'extension s'installe gratuitement, mais elle ne fonctionne qu'avec un compte payant. Il faut un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Console facturé à la consommation de l'API. L'offre gratuite de Claude n'inclut pas Claude Code. Sur la page tarifs d'Anthropic relevée le 28 octobre 2026, l'abonnement Pro coûte 20 dollars par mois sans engagement, ou 17 dollars par mois en engagement annuel.

L'extension fonctionne-t-elle dans Cursor ou un autre éditeur dérivé de VS Code ?

Pour Cursor, oui : la page d'installation d'Anthropic fournit un lien direct. Pour les autres éditeurs dérivés de VS Code, l'extension est publiée sur le registre Open VSX. Dans un éditeur qui n'accepte pas l'extension, installez le CLI et lancez claude dans son terminal intégré : vous perdez le panneau graphique, mais vous gardez l'agent et sa configuration.

Pourquoi la commande claude est-elle introuvable dans le terminal de VS Code ?

Parce que l'extension garde sa copie de Claude Code pour elle et n'ajoute rien au PATH de votre shell, comme l'explique la section Run CLI in VS Code. Pour taper claude dans le terminal intégré, faites l'installation autonome du CLI, une seule fois. Les deux partagent ensuite l'historique : une conversation du panneau se reprend avec claude --resume, et le CLI lancé dans le terminal intégré affiche ses différences dans l'éditeur.

Comment empêcher Claude de lire mon fichier .env depuis VS Code ?

Ajoutez les règles Read(.env) et Read(.env.*) dans la liste deny de vos réglages Claude Code. D'après la page des permissions, elles bloquent les outils de lecture, les mentions @ et la sélection partagée par l'éditeur, dans le panneau comme dans le terminal. Le filtrage des fichiers ignorés par git ne protège que le panneau. Pour bloquer aussi les scripts qui ouvrent le fichier eux-mêmes, activez le bac à sable.

Comment annuler une modification ratée de Claude dans VS Code ?

Survolez le message à partir duquel tout a dérapé et choisissez de ramener le code à cet état, avec ou sans nouvelle branche de conversation. Ces points de restauration suivent les fichiers modifiés par les outils d'édition de Claude : un fichier changé uniquement par une commande shell reste en place, et les modifications d'un sous-agent ne sont en général pas restaurées. Pour ces cas, et pour tout ce qui doit durer, git reste le vrai filet de sécurité.