# Extension Claude Code pour VS Code : guide complet

URL: https://agentvera.dev/fr/blog/claude-code-vs-code/ · Publié: 2026-10-23

Installez l’extension Claude Code pour VS Code, utilisez le contexte de sélection et la vue diff, réglez les bons paramètres, dépannez et configurez JetBrains.

**En bref:**

- L’extension officielle Claude Code (anthropic.claude-code) demande VS Code 1.94.0 ou plus récent, et un abonnement Pro, Max, Team ou Enterprise ou un compte Console.
- Installer l’extension n’ajoute pas claude à votre PATH ; installez la CLI autonome pour l’utiliser dans un terminal : les deux partagent l’historique des conversations.
- Dans les IDE JetBrains, le plugin Claude Code [Beta] lance la CLI claude dans le terminal de l’IDE : la CLI doit donc être installée au préalable.

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](https://code.claude.com/docs/en/vs-code "Claude Code dans VS Code") et de la [documentation JetBrains](https://code.claude.com/docs/en/jetbrains "Claude Code dans les IDE JetBrains").

## Installer l’extension

1. Ouvrez VS Code et appuyez sur `Cmd+Shift+X` (Mac) ou `Ctrl+Shift+X` (Windows/Linux).
2. Cherchez **Claude Code** et installez l’extension d’Anthropic.
3. Si elle n’apparaît pas tout de suite, redémarrez VS Code ou lancez **Developer: Reload Window** depuis la palette de commandes.
4. 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](https://code.claude.com/docs/en/setup "Installer Claude Code").

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](/fr/blog/claude-code-commands-cheat-sheet/ "Aide-mémoire des commandes Claude Code").

## 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:name` référence la sortie d’un terminal.
- `Cmd+Esc` / `Ctrl+Esc` bascule 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+Esc` ouvre Claude Code depuis l’éditeur.
- `Cmd+Option+K` / `Alt+Ctrl+K` insè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 `auto` ou `terminal` dans `/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 `/ide` pour 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](/fr/blog/best-ai-coding-cli-tools/ "Les meilleurs outils CLI de codage IA"), et que vous perdez de vue lequel attend une réponse.

C’est le cas pour lequel [AgentVera](/fr/agents/claude-code/ "Claude Code dans 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](/fr/features/workspace/ "Workspace") dispose les agents en grilles jusqu’à 5×4. La [vue de groupe](/fr/features/group-view/ "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](/fr/features/editor-and-terminal/ "É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](/fr/features/git-and-github/ "Git et GitHub") ajoute les worktrees et les PR.
- **Une seconde lecture.** La [revue de code automatique](/fr/features/code-review/ "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](/fr/blog/git-worktree-parallel-agents/ "Git worktrees pour agents en parallèle") sont l’étape suivante.

Pour essayer AgentVera, commencez par la [page d’accueil](/fr/ "AgentVera").

## Questions fréquentes

**Comment installer l’extension Claude Code dans VS Code ?** Ouvrez la vue Extensions avec Cmd+Shift+X ou Ctrl+Shift+X, cherchez Claude Code et installez l’extension publiée par Anthropic (ID anthropic.claude-code). Elle demande VS Code 1.94.0 ou plus récent et un abonnement Pro, Max, Team ou Enterprise ou un compte Console.

**L’extension VS Code inclut-elle la CLI Claude Code ?** Elle embarque une copie privée de la CLI pour son panneau de chat, mais n’ajoute pas claude à votre PATH. Pour lancer claude dans le terminal intégré, installez une fois la CLI autonome. Les deux partagent le même historique de conversations : claude --resume retrouve donc les sessions de l’extension.

**L’extension Claude Code fonctionne-t-elle dans Cursor ?** Oui. La documentation VS Code donne un lien Install for Cursor, et les autres forks de VS Code peuvent l’installer depuis le registre Open VSX. Dans un éditeur qui ne peut pas installer l’extension, lancez plutôt claude dans le terminal intégré.

**Pourquoi ne vois-je pas l’icône Spark de Claude Code ?** L’icône n’apparaît dans la barre d’outils de l’éditeur que lorsqu’un fichier est ouvert. Vérifiez que VS Code est en 1.94.0 ou plus, que l’espace de travail est approuvé et qu’aucune autre extension d’IA n’entre en conflit, puis lancez Developer: Reload Window. L’élément Claude Code de la barre d’état fonctionne sans fichier ouvert.

**Existe-t-il un plugin Claude Code pour les IDE JetBrains ?** Oui. Le plugin Claude Code [Beta] du JetBrains Marketplace fonctionne avec IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm et Android Studio. Il lance la CLI dans le terminal de l’IDE : elle doit donc être installée. Il ajoute les diffs dans l’IDE et le partage de la sélection.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/