L’extension Claude Code pour VS Code est l’extension officielle d’Anthropic (ID anthropic.claude-code) qui place Claude Code dans un panneau graphique à l’intérieur de VS Code. Vous l’installez depuis la vue Extensions, vous vous connectez, puis Claude voit votre fichier ouvert et votre sélection, affiche les modifications proposées sous forme de diffs côte à côte que vous acceptez ou rejetez, et partage son historique avec la CLI. Elle demande VS Code 1.94.0 ou plus récent et une offre Claude payante ou un compte Console. Si vous préférez le terminal, vous pouvez aussi lancer la CLI claude dans le terminal intégré de VS Code et conserver les diffs de l’IDE.
Ce guide couvre l’installation, l’extension face à la CLI, la vue diff, le contexte de sélection, les réglages utiles, les problèmes courants et une courte section sur JetBrains. Tout provient de la documentation officielle VS Code et de la documentation JetBrains.
Installer l’extension
- Ouvrez VS Code et appuyez sur
Cmd+Shift+X(Mac) ouCtrl+Shift+X(Windows/Linux). - Cherchez Claude Code et installez l’extension d’Anthropic.
- Si elle n’apparaît pas tout de suite, redémarrez VS Code ou lancez Developer: Reload Window depuis la palette de commandes.
- Ouvrez le panneau et connectez-vous quand il le demande.
Prérequis :
| Prérequis | Détail |
|---|---|
| VS Code | 1.94.0 ou plus récent |
| Compte | Offre Pro, Max, Team ou Enterprise, ou compte Console |
| Espace de travail | Approuvé (l’extension ne tourne pas en mode restreint) |
Cursor et autres forks de VS Code
La documentation donne un lien direct Install for Cursor : Cursor est donc pris en charge. Les autres forks de VS Code peuvent installer l’extension depuis le registre Open VSX. Si votre éditeur ne peut pas l’installer du tout, ouvrez son terminal intégré et lancez claude.
Ouvrir Claude Code
Il y a quatre façons d’y accéder :
- Icône Spark dans la barre d’outils de l’éditeur, en haut à droite. Elle n’apparaît que lorsqu’un fichier est ouvert.
- Liste des sessions dans la barre d’activité, à gauche.
- Palette de commandes (
Cmd+Shift+P/Ctrl+Shift+P) : tapez « Claude Code » et choisissez Open in New Tab. - Barre d’état : cliquez sur ✻ Claude Code en bas à droite. Fonctionne sans fichier ouvert.
Vous pouvez faire glisser le panneau vers la barre latérale secondaire (droite), la barre latérale principale (gauche) ou la zone d’édition sous forme d’onglet. La documentation suggère la barre latérale pour votre session principale et les onglets pour les tâches annexes.
Extension ou CLI dans le terminal intégré ?
Dans les deux cas, c’est le même Claude Code. La différence tient à l’interface et à quelques fonctionnalités.
| Fonctionnalité | CLI | Extension VS Code |
|---|---|---|
| Commandes et skills | Toutes | Un sous-ensemble (tapez / pour les voir) |
| Configuration des serveurs MCP | Oui | Oui, avec /mcp dans le panneau |
| Checkpoints | Oui | Oui |
Raccourci shell ! | Oui | Non |
| Complétion par tabulation | Oui | Non |
Le piège classique : installer l’extension n’ajoute pas claude à votre PATH. L’extension embarque une copie privée de la CLI pour son panneau. Pour taper claude dans un terminal, il vous faut l’installation autonome de la CLI.
Une fois les deux installées, elles partagent l’historique des conversations. Lancez claude --resume dans le terminal pour reprendre une conversation commencée dans le panneau.
Pour lancer la CLI dans VS Code, appuyez sur Ctrl+` (ou Cmd+` sur Mac) et lancez claude. Elle se connecte automatiquement à l’IDE pour les diffs et les diagnostics. Depuis un terminal externe, lancez /ide dans Claude Code pour le connecter à VS Code.
Si vous aimez l’interface du terminal mais la voulez à la place du panneau, activez le réglage Use Terminal (claudeCode.useTerminal).
Règle empirique : utilisez le panneau quand vous voulez parcourir les diffs en cliquant et voir les plans comme des documents. Utilisez la CLI quand vous voulez toutes les commandes slash, le mode shell ! et les raccourcis clavier de notre aide-mémoire.
Contexte de sélection et mentions @
L’extension ajoute à votre message le fichier ouvert dans l’éditeur, et Claude voit le texte que vous avez sélectionné. Inutile de coller du code dans le prompt.
Option+K(Mac) /Alt+K(Windows/Linux) insère une référence au fichier et à la sélection courants, comme@auth.ts#5-10. L’éditeur doit avoir le focus.@dans la zone de saisie mentionne n’importe quel fichier ou dossier.@terminal:nameréférence la sortie d’un terminal.Cmd+Esc/Ctrl+Escbascule le focus entre l’éditeur et Claude.
Note sur la confidentialité : le texte sélectionné n’est pas envoyé depuis les fichiers couverts par files.exclude ou search.exclude, ni depuis les fichiers ignorés par git tant que respectGitIgnore est activé. Cela s’applique au panneau de chat. Si vous voulez n’envoyer que votre sélection et non tout le fichier ouvert, désactivez attachOpenFile.
La vue diff
Quand Claude veut modifier un fichier en mode Manual, VS Code affiche un diff côte à côte de la modification proposée. Vous pouvez l’accepter, la rejeter ou modifier le texte proposé avant de l’accepter. Les versions récentes permettent aussi d’accepter ou de rejeter chaque changement au sein d’une même modification, avec Accept Change at Cursor et Reject Change at Cursor dans la palette de commandes. Les très grosses modifications (plus de 100 changements) n’ont pas de boutons par changement.
La fréquence des diffs dépend du mode d’autorisation choisi dans la zone de saisie :
| Mode | Ce qui se passe |
|---|---|
| Manual | Claude demande avant chaque modification et affiche le diff |
| Edit automatically | Les modifications sont appliquées sans demander |
| Plan | Claude rédige un plan sous forme de document Markdown que vous pouvez commenter, puis attend |
| Auto | Claude décide avec un contrôle de sécurité ; c’est le mode par défaut dans les versions récentes |
Les checkpoints s’ajoutent à cela. Survolez un message pour voir le bouton de retour en arrière : Rewind code to here, Fork conversation from here, ou les deux à la fois.
Réglages à modifier
Ouvrez les réglages de VS Code (Cmd+, / Ctrl+,) et allez dans Extensions > Claude Code. Les réglages partagés, comme les commandes autorisées, les hooks et les serveurs MCP, vont dans ~/.claude/settings.json, que la CLI lit aussi.
| Réglage | Défaut | Pourquoi le changer |
|---|---|---|
useTerminal | false | Ouvrir l’interface de type CLI au lieu du panneau de chat |
initialPermissionMode | non défini | Démarrer les nouveaux chats en default, plan, acceptEdits ou bypassPermissions |
preferredLocation | panel | sidebar garde Claude ancré à droite |
attachOpenFile | true | Désactivez-le pour n’envoyer que votre sélection |
autosave | true | Enregistre les fichiers avant que Claude ne les lise ou les écrive |
useCtrlEnterToSend | false | Envoyer avec Ctrl/Cmd+Entrée, Entrée pour les sauts de ligne |
respectGitIgnore | true | Garder les fichiers ignorés par git hors de la recherche et du contexte de sélection |
environmentVariables | [] | Variables d’environnement pour le seul processus Claude |
allowDangerouslySkipPermissions | false | Ajoute Bypass permissions au menu des modes. Bacs à sable uniquement |
initialPermissionMode n’est lu que dans vos réglages utilisateur, pas dans ceux de l’espace de travail. Ajoutez "$schema": "https://json.schemastore.org/claude-code-settings.json" à settings.json pour avoir l’autocomplétion.
Lancer plusieurs conversations
Open in New Tab (Cmd+Shift+Esc / Ctrl+Shift+Esc) et Open in New Window démarrent des conversations supplémentaires, chacune avec son propre historique. Un point de couleur sur l’icône spark de l’onglet indique l’état : bleu pour une demande d’autorisation en attente, orange quand Claude a terminé alors que l’onglet était masqué. La liste des sessions peut regrouper les sessions et filtrer par Needs input, Working ou Completed.
Résoudre les problèmes courants
| Problème | Solution |
|---|---|
| L’extension ne s’installe pas | Vérifiez que VS Code est en 1.94.0+, qu’il peut installer des extensions, ou installez depuis la page du Marketplace |
| Pas d’icône Spark | Ouvrez un fichier (un dossier seul ne suffit pas), approuvez l’espace de travail, désactivez les extensions d’IA en conflit, rechargez la fenêtre |
Cmd+Esc ne fait rien sous macOS | macOS Tahoe l’associe à Game Overlay. Désactivez-le dans Keyboard Shortcuts → Game Controllers, ou réaffectez Claude Code: Focus input |
| « Not logged in · Please run /login » | Rechargez la fenêtre et reconnectez-vous |
ANTHROPIC_API_KEY non pris en compte | Lancez VS Code depuis un terminal avec code . pour qu’il hérite de l’environnement |
claude introuvable dans le terminal | Installez la CLI autonome ; l’extension ne l’ajoute pas au PATH |
| Claude ne répond jamais | Vérifiez la connexion, démarrez une nouvelle conversation, puis essayez claude dans un terminal pour obtenir une erreur plus claire |
| Besoin des journaux | Lancez Claude Code: Show Logs depuis la palette de commandes |
Claude Code dans les IDE JetBrains
Le plugin Claude Code [Beta] du JetBrains Marketplace prend en charge IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm et GoLand. Contrairement à l’extension VS Code, il lance la CLI claude dans le terminal de l’IDE : installez donc d’abord la CLI. Si « Cannot launch Claude Code » s’affiche, claude n’est pas dans votre PATH.
Ce que vous obtenez :
Cmd+Esc/Ctrl+Escouvre Claude Code depuis l’éditeur.Cmd+Option+K/Alt+Ctrl+Kinsère une référence de fichier comme@src/auth.ts#L1-99.- Les modifications proposées s’ouvrent dans la visionneuse de diff de l’IDE. Réglez Diff tool sur
autoouterminaldans/config. - Votre sélection et les diagnostics de l’IDE (erreurs de lint et de types) sont partagés avec Claude.
- Depuis un terminal externe, lancez
/idepour vous connecter.
Deux solutions tirées de la documentation : si Esc n’interrompt pas Claude, allez dans Settings → Tools → Terminal et décochez « Move focus to the editor with Escape ». Sous WSL, réglez la commande Claude du plugin sur wsl -d Ubuntu -- bash -lic "claude", et si vous voyez « No available IDEs detected », ajoutez une règle de pare-feu ou passez WSL en réseau en miroir (mirrored networking).
Quand une application séparée pour plusieurs agents devient pertinente
L’extension est conçue autour d’une fenêtre d’éditeur et de quelques conversations. Cela couvre la plupart des journées. Cela se complique quand vous lancez quatre ou cinq agents à la fois sur des branches différentes, ou que vous mélangez Claude Code avec Codex ou d’autres agents CLI, et que vous perdez de vue lequel attend une réponse.
C’est le cas pour lequel AgentVera est conçu. C’est une application de bureau pour macOS, Windows et Linux qui lance chaque agent CLI dans son propre volet, dans une grille par projet. Ce n’est pas un éditeur et ne remplace pas VS Code. Beaucoup de gens gardent les deux ouverts.
- Plusieurs agents, une seule vue. Le workspace dispose les agents en grilles jusqu’à 5×4. La vue de groupe compte les agents qui travaillent, qui attendent une réponse ou qui attendent une approbation, avec Approve et Reject sur chaque carte.
- Des diffs sans changer de fenêtre. Les outils éditeur et terminal incluent un éditeur de fichiers et un onglet Changes qui affiche le diff entre HEAD et l’arbre de travail, unifié ou côte à côte. Git et GitHub ajoute les worktrees et les PR.
- Une seconde lecture. La revue de code automatique fait relire le code d’un agent, à la fin de son tour, par un modèle Claude de votre choix, avec des liens fichier:ligne.
Si vous préparez du travail en parallèle, les git worktrees pour agents en parallèle sont l’étape suivante.
Pour essayer AgentVera, commencez par la page d’accueil.