Claude Code · 11 min · 2026-11-16 · Par Équipe MaitriseLIA

Comment installer Claude Code dans VS Code ? Extension, raccourcis, réglages et 7 pannes

L’extension officielle Claude Code pour VS Code s’installe en trois étapes et ne demande aucune clé d’API. Ce guide suit la documentation d’Anthropic du 16 novembre 2026 : prérequis, différence entre l’extension et la ligne de commande, raccourcis, réglages à changer en premier, ce que Claude voit de votre éditeur, et les sept pannes qui bloquent le plus souvent.

Écran d’ordinateur affichant du code dans un éditeur : Claude Code installé comme extension de VS Code
Crédit photo : Unsplash

*Publié le 16 novembre 2026 · Mis à jour le 16 novembre 2026*

Pour installer Claude Code dans VS Code, ouvrez la vue Extensions (Cmd+Shift+X sur Mac, Ctrl+Shift+X sur Windows et Linux), cherchez Claude Code, vérifiez que l’éditeur est Anthropic et cliquez sur Install. Ouvrez ensuite le panneau avec l’icône en forme d’étincelle et connectez-vous avec votre compte Claude : aucune clé d’API n’est demandée. Il faut VS Code 1.94.0 ou plus récent.

L’extension Claude Code pour VS Code est l’interface graphique officielle de Claude Code dans l’éditeur : un panneau de discussion qui lit vos fichiers, propose des modifications sous forme de comparaisons côte à côte et exécute des commandes avec votre accord. Selon la fiche du Visual Studio Marketplace que nous avons relevée le 16 novembre 2026, elle compte 30,3 millions d’installations, une note de 3,7 sur 5 pour 854 avis, et sa dernière version, la 2.1.325, date du 13 novembre 2026. La fiche a été créée le 18 juin 2025.

L’essentiel en une minute

  • Prérequis : VS Code 1.94.0 au minimum, et un forfait Claude payant (Pro, Max, Ultra, Team ou Enterprise) ou un compte Claude Console. Le forfait gratuit de claude.ai ne donne pas accès à Claude Code.
  • Installer : 3 étapes, sans terminal ni clé d’API.
  • Le piège n°1 : l’extension n’installe pas la commande claude dans votre terminal. Ce sont deux installations distinctes.
  • Régler : 23 réglages propres à l’extension, dont 6 méritent d’être regardés le premier jour.
  • Dépanner : 7 pannes documentées, de l’icône invisible au raccourci Cmd+Esc capté par macOS.

Comment installer l’extension Claude Code dans VS Code ?

La documentation officielle de Claude Code (page « Use Claude Code in VS Code », consultée le 16 novembre 2026) décrit une installation en trois étapes.

  1. Ouvrez la vue Extensions avec Cmd+Shift+X (Mac) ou Ctrl+Shift+X (Windows, Linux), tapez « Claude Code » et cliquez sur Install. L’identifiant exact de l’extension est anthropic.claude-code : c’est lui qui garantit que vous installez l’extension d’Anthropic et pas une homonyme.
  2. Ouvrez le panneau en cliquant sur l’icône étincelle en haut à droite de l’éditeur. Si l’extension n’apparaît pas, redémarrez VS Code ou lancez Developer: Reload Window depuis la palette de commandes.
  3. Connectez-vous : au premier affichage, cliquez sur Sign in et validez l’autorisation dans votre navigateur.

Deux précisions que peu de tutoriels donnent. D’abord, le numéro de version de l’extension est celui de la version de Claude Code qu’elle embarque : mettre à jour l’extension, c’est mettre à jour Claude Code dans le panneau. Ensuite, Anthropic publie l’extension sur deux catalogues, le Visual Studio Marketplace et l’Open VSX Registry, et précise que ces catalogues sont des logiciels tiers qu’elle ne maintient ni n’audite.

Et dans Cursor ou un autre dérivé de VS Code ? L’extension s’installe aussi dans Cursor (la documentation fournit un lien d’installation dédié) et dans des dérivés comme Devin Desktop ou Kiro, depuis leur vue Extensions ou depuis Open VSX. Si votre éditeur refuse l’extension, installez la ligne de commande et lancez claude dans son terminal. Pour choisir entre les deux outils, voyez notre comparatif Claude Code vs Cursor et, pour les autres éditeurs et assistants, les comparatifs d’iaCockpit.

Faut-il aussi installer Claude Code en ligne de commande ?

Non pour utiliser le panneau, oui pour taper claude dans le terminal de VS Code. C’est la confusion la plus fréquente : l’extension embarque sa propre copie privée de Claude Code pour le panneau de discussion, mais elle n’ajoute pas la commande claude à votre terminal. La documentation le dit en toutes lettres : installer l’extension ne place pas claude dans le PATH.

Si vous voulez les deux, installez la ligne de commande une fois, avec la commande officielle de votre système :

  • macOS, Linux, WSL : curl -fsSL https://claude.ai/install.sh | bash
  • Windows, PowerShell : irm https://claude.ai/install.ps1 | iex
  • Homebrew : brew install --cask claude-code
  • WinGet : winget install Anthropic.ClaudeCode

Ouvrez ensuite un nouveau terminal et tapez claude --version : un numéro de version s’affiche si tout va bien. L’installation native se met à jour seule en arrière-plan ; Homebrew et WinGet demandent une mise à jour manuelle par défaut. Côté machine, la documentation demande macOS 13.0, Windows 10 version 1809 ou Ubuntu 20.04 au minimum, et 4 Go de mémoire vive. Notre guide Comment installer Claude Code détaille ce chemin.

Bonne nouvelle : les deux partagent le même historique. Une conversation commencée dans le panneau se reprend dans le terminal avec claude --resume, qui ouvre une liste où chercher la conversation.

Comment ouvrir Claude Code et envoyer une première demande ?

Il existe quatre portes d’entrée, et elles ne sont pas toutes visibles en même temps :

  • L’icône étincelle en haut à droite de l’éditeur : la plus rapide, mais elle n’apparaît que si un fichier est ouvert. Un dossier ouvert ne suffit pas.
  • La barre d’activité à gauche : l’icône y est toujours visible et ouvre la liste des sessions.
  • La palette de commandes (Cmd+Shift+P ou Ctrl+Shift+P) : tapez « Claude Code » et choisissez par exemple « Open in New Tab ».
  • La barre d’état en bas à droite : le bouton ✻ Claude Code fonctionne même sans fichier ouvert.

Écrivez ensuite votre demande en français, comme à un collègue. Claude voit automatiquement le texte que vous avez sélectionné dans l’éditeur. Pour pointer un passage précis, appuyez sur Option+K (Mac) ou Alt+K (Windows, Linux) : une référence au fichier et aux lignes s’insère, du type @app.ts#5-10. Vous pouvez aussi taper @ suivi d’un nom de fichier ou de dossier, coller une image, ou glisser un fichier en maintenant Maj.

Après la connexion, une liste « Learn Claude Code » propose un parcours guidé ; la commande « Claude Code: Open Walkthrough » de la palette fait la même chose.

Quel mode de permission choisir dans VS Code ?

Le mode s’affiche en bas de la zone de saisie, et il décide de ce que Claude fait sans vous demander. La documentation en décrit quatre :

ModeCe que fait ClaudePour qui
ManualDemande avant chaque modification de fichier et la plupart des commandesDébuter, ou travailler sur un projet sensible
PlanDécrit ce qu’il va faire et attend votre accord ; le plan s’ouvre comme un document Markdown que vous pouvez annoterToute tâche de plus de quelques étapes
Edit automaticallyModifie les fichiers sans demanderTâches répétitives dans un dépôt versionné
AutoUn classificateur examine la plupart des actions à votre placeSessions longues, une fois les garde-fous compris

En mode Manual, chaque modification s’ouvre en comparaison côte à côte : vous acceptez, vous refusez, ou vous dites à Claude quoi faire à la place. Vous pouvez aussi valider modification par modification avec les boutons Accept this change et Reject this change, sauf si la comparaison contient plus de 100 modifications : au-delà, elle s’ouvre sans ces boutons et se relit en bloc.

Pour revenir en arrière, survolez un message : trois options apparaissent, dont « Rewind code to here », qui remet les fichiers dans l’état de ce moment. Le détail est dans notre guide annuler les modifications de Claude Code, et le mode Plan a son guide dédié.

Extension, mode terminal ou ligne de commande : que choisir ?

C’est la question que les tutoriels esquivent. Il y a en réalité trois façons d’utiliser Claude Code dans VS Code, et la documentation liste précisément ce qui les sépare. Nous les avons mises dans un même tableau de décision :

CritèrePanneau de l’extensionMode terminal de l’extensionLigne de commande dans le terminal intégré
Installation nécessaireExtension seuleExtension seule (réglage Use Terminal)Extension + installation de la ligne de commande
InterfaceGraphique : boutons, onglets, comparaisonsTexte, comme dans un terminalTexte
Commandes et skillsUn sous-ensemble (tapez / pour voir la liste)Celles de la ligne de commandeToutes
Raccourci ! pour lancer une commande shellNonOuiOui
Complétion par la touche TabNonOuiOui
Serveurs MCPOui, avec /mcp dans le panneauOuiOui
Retour en arrière (checkpoints)Oui, au survol d’un messageOuiOui
Formules mathématiques mises en formeOuiNonNon

Notre règle de décision. Si vous ne venez pas du terminal, restez sur le panneau : tout ce dont un débutant a besoin s’y trouve, et les comparaisons côte à côte évitent d’accepter une modification sans la lire. Passez à la ligne de commande dans le terminal intégré le jour où une commande manque dans le menu / du panneau. Le mode terminal de l’extension n’a d’intérêt que si vous préférez l’interface texte sans rien installer de plus.

Dans le terminal intégré, la ligne de commande se connecte automatiquement à l’extension pour afficher les comparaisons dans l’éditeur et partager les diagnostics. Depuis un terminal externe, tapez /ide dans Claude Code pour établir la connexion.

Quels raccourcis clavier faut-il connaître ?

Sept raccourcis ont une combinaison par défaut. Les autres commandes passent par la palette.

ActionMacWindows et Linux
Passer de l’éditeur à Claude, et inversementCmd+EscCtrl+Esc
Ouvrir une conversation dans un nouvel ongletCmd+Shift+EscCtrl+Shift+Esc
Insérer une référence au fichier et à la sélectionOption+KAlt+K
Rouvrir la dernière session ferméeCmd+Shift+TCtrl+Shift+T
Nouvelle conversation (à activer dans les réglages)Cmd+NCtrl+N
Masquer ou afficher l’activité des outilsCtrl+Option+FCtrl+Alt+F
Démarrer ou arrêter la dictée vocaleCmd+DCtrl+D

Dans la zone de saisie, Maj+Entrée ajoute une ligne sans envoyer le message.

Quels réglages changer en premier ?

L’extension se règle à deux endroits : ses réglages propres dans VS Code (Cmd+, ou Ctrl+, puis Extensions > Claude Code), et le fichier ~/.claude/settings.json, partagé avec la ligne de commande, pour les permissions, les hooks et les serveurs MCP. Le tableau de la documentation compte 23 réglages propres à l’extension. Six méritent un coup d’œil dès le premier jour :

RéglageValeur par défautPourquoi y toucher
initialPermissionModenon définiDémarrer chaque conversation en mode plan ou en mode manuel (default)
preferredLocationpanelPasser à sidebar pour garder Claude dans la barre latérale
attachSelection et attachOpenFiletrueLes couper si vous ne voulez pas que la sélection et le fichier ouvert partent d’office avec chaque demande
useCtrlEnterToSendfalseEnvoyer avec Ctrl+Entrée ou Cmd+Entrée, pour éviter les envois accidentels
archiveInactiveSessions14Nombre de jours avant l’archivage automatique d’une session (1, 2, 7, 14, ou 0 pour désactiver)
allowDangerouslySkipPermissionsfalseÀ laisser sur false : ce réglage ajoute un mode sans aucune demande d’autorisation, que la documentation réserve aux bacs à sable sans accès à Internet

Que voit Claude de votre éditeur ?

Plus que ce qu’on imagine, et c’est documenté. Quand l’extension est active, elle fait tourner un petit serveur local nommé ide auquel Claude Code se connecte. Il écoute uniquement sur l’adresse locale 127.0.0.1, sur un port tiré au hasard entre 10000 et 65535, protégé par un jeton renouvelé à chaque activation. Par ce canal, Claude reçoit à chaque message votre sélection en cours et le chemin du fichier actif, et peut lire les erreurs que VS Code signale dans le code.

Trois réflexes pour un professionnel qui manipule des données sensibles :

  • Fichier de secrets ouvert : pour un fichier comme .env, ajoutez une règle de refus Read sur son chemin. Elle empêche à la fois le texte sélectionné et la mention du fichier ouvert d’atteindre Claude.
  • Fichiers ignorés : le réglage respectGitIgnore (activé par défaut) exclut des recherches les fichiers listés dans .gitignore.
  • Espace de travail non approuvé : l’extension ne fonctionne pas en mode restreint de VS Code. C’est une protection, pas une panne.

Pour la méthode complète, voyez sécuriser Claude Code avec les permissions.

Pourquoi l’extension Claude Code ne fonctionne-t-elle pas ?

Les sept pannes ci-dessous viennent de la rubrique de dépannage de la documentation. Elles couvrent l’essentiel des blocages d’un premier jour.

SymptômeCauseSolution
L’extension refuse de s’installerVS Code antérieur à la version 1.94.0Vérifier la version dans Help > About, puis mettre à jour VS Code
L’icône étincelle est absenteAucun fichier ouvert, mode restreint, ou conflit avec une autre extension d’IA (Cline, Continue)Ouvrir un fichier, approuver l’espace de travail, désactiver temporairement l’autre extension, ou passer par ✻ Claude Code dans la barre d’état
Cmd+Esc ne fait rien sur MacDepuis macOS Tahoe, le raccourci système Game Overlay capte la combinaisonRéglages Système > Clavier > Raccourcis clavier > Contrôleurs de jeu : décocher Game Overlay
claude est introuvable dans le terminal intégréL’extension n’installe pas la ligne de commandeInstaller la ligne de commande (voir plus haut), puis rouvrir le terminal
L’écran de connexion revient alors qu’une clé ANTHROPIC_API_KEY est définieVS Code n’a pas hérité des variables de votre terminalLancer VS Code depuis un terminal avec code . ou se connecter avec le compte Claude
Le panneau reste videVersion ancienne de l’extensionPasser à la version 2.1.309 ou plus récente, lancer Developer: Reload Window, puis lire Claude Code: Show Logs
La dictée ou l’onglet Web échoue avec une erreur de certificatProxy d’entreprise qui inspecte le trafic chiffréDéfinir NODE_EXTRA_CA_CERTS dans le bloc env de ~/.claude/settings.json (version 2.1.307 au minimum)

Si Claude ne répond jamais, la documentation conseille trois vérifications dans l’ordre : la connexion Internet, une nouvelle conversation, puis claude lancé dans un terminal pour lire un message d’erreur plus détaillé.

Comment désinstaller l’extension sans qu’elle revienne ?

Dans la vue Extensions, cherchez « Claude Code » et cliquez sur Uninstall. Le cas limite : l’extension peut se réinstaller toute seule. Cela arrive si vous tapez /ide depuis un terminal externe alors que VS Code est ouvert, ou si vous lancez claude dans le terminal intégré avec une version de Claude Code antérieure à la 2.1.318.

Pour l’empêcher, la documentation donne trois moyens équivalents : passer autoInstallIdeExtension à false dans ~/.claude.json, définir CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL à 1 dans le bloc env d’un fichier de réglages, ou désactiver « Auto-install IDE extension » dans /config. Désinstallez ensuite une seconde fois si elle était déjà revenue.

En résumé

QuestionRéponse
Comment installer ?Vue Extensions, « Claude Code », éditeur Anthropic, Install, puis Sign in
Quels prérequis ?VS Code 1.94.0 ou plus récent, forfait Claude payant ou compte Console, pas de clé d’API
L’extension suffit-elle ?Oui pour le panneau ; non pour taper claude dans le terminal
Quel mode pour débuter ?Manual, puis Plan pour les tâches longues
Quel raccourci retenir ?Cmd+Esc ou Ctrl+Esc pour passer de l’éditeur à Claude
La panne la plus courante ?L’icône étincelle invisible parce qu’aucun fichier n’est ouvert

Vous voulez apprendre à utiliser Claude Code dans votre éditeur avec méthode, sans être développeur ? Commencer la formation →

FAQ

Comment installer Claude Code dans VS Code ?

Ouvrez la vue Extensions avec Cmd+Shift+X sur Mac ou Ctrl+Shift+X sur Windows et Linux, cherchez « Claude Code », vérifiez que l’éditeur est Anthropic et cliquez sur Install. Ouvrez ensuite le panneau avec l’icône étincelle et connectez-vous dans le navigateur. Il faut VS Code 1.94.0 ou plus récent et un forfait Claude payant ou un compte Console.

L’extension Claude Code pour VS Code est-elle gratuite ?

L’extension se télécharge gratuitement, mais elle ne fonctionne qu’avec un compte donnant accès à Claude Code : forfait Pro, Max, Ultra, Team ou Enterprise, ou compte Claude Console facturé à l’usage. Selon la documentation, le forfait gratuit de claude.ai n’inclut pas Claude Code. Aucune clé d’API n’est nécessaire pour se connecter.

Faut-il installer la ligne de commande en plus de l’extension ?

Pas pour le panneau de discussion : l’extension embarque sa propre copie de Claude Code. En revanche, elle n’ajoute pas la commande claude à votre terminal. Pour l’utiliser dans le terminal intégré de VS Code, installez la ligne de commande à part, puis vérifiez avec claude --version. Les deux partagent le même historique de conversations.

Claude Code fonctionne-t-il dans Cursor ?

Oui. La documentation fournit un lien d’installation pour Cursor, et l’extension s’installe aussi dans des dérivés de VS Code comme Devin Desktop ou Kiro, depuis leur vue Extensions ou depuis l’Open VSX Registry. Si un éditeur ne peut pas installer l’extension, il reste possible d’installer la ligne de commande et de lancer claude dans son terminal.

Pourquoi l’icône Claude Code n’apparaît-elle pas dans VS Code ?

L’icône étincelle en haut à droite n’apparaît que si un fichier est ouvert ; un dossier seul ne suffit pas. Vérifiez aussi que VS Code est en version 1.94.0 au minimum, que l’espace de travail n’est pas en mode restreint, et désactivez temporairement les autres extensions d’IA. Sinon, cliquez sur ✻ Claude Code dans la barre d’état, en bas à droite.

Sources

  1. Claude Code, documentation « Use Claude Code in VS Code »
  2. Claude Code, documentation « Advanced setup » (installation de la ligne de commande)
  3. Visual Studio Marketplace, fiche « Claude Code for VS Code » (Anthropic)
  4. Open VSX Registry, fiche Anthropic/claude-code
  5. MaitriseLIA, sécuriser Claude Code avec les permissions

À propos de l'auteur

Équipe MaitriseLIA

Experts en formation Claude Code, Anthropic API et outils d'IA professionnels. Nos contenus sont rédigés par des spécialistes qui utilisent Claude Code et les MCPs au quotidien pour automatiser leurs business.