Utiliser Claude Code dans VS Code

Installez et configurez l'extension Claude Code pour VS Code. Obtenez une assistance de codage IA avec des diffs en ligne, des mentions @, un examen du plan et des raccourcis clavier.

L'extension VS Code fournit une interface graphique native pour Claude Code, intégrée directement dans votre IDE. C'est la façon recommandée d'utiliser Claude Code dans VS Code.

Avec l'extension, vous pouvez examiner et modifier les plans de Claude avant de les accepter, accepter automatiquement les modifications au fur et à mesure qu'elles sont apportées, mentionner des fichiers avec des plages de lignes spécifiques à partir de votre sélection, accéder à l'historique des conversations et ouvrir plusieurs conversations dans des onglets ou des fenêtres séparés.

Prérequis

Avant d'installer, assurez-vous que vous avez :

• VS Code 1.94.0 ou supérieur
• Un compte Anthropic : tout abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console fonctionne, et aucune clé API n'est requise. Vous vous connecterez avec ce compte lors de la première ouverture de l'extension. Si vous accédez à Claude par l'intermédiaire d'un fournisseur tiers comme Amazon Bedrock ou Google Cloud's Agent Platform, consultez Utiliser des fournisseurs tiers pour les instructions de configuration.

Installer l'extension

Cliquez sur le lien de votre IDE pour installer directement :

• Installer pour VS Code
• Installer pour Cursor

Ou dans VS Code, appuyez sur Cmd+Shift+X (Mac) ou Ctrl+Shift+X (Windows/Linux) pour ouvrir la vue Extensions, recherchez « Claude Code » et cliquez sur Installer.

L'extension s'installe également dans d'autres forks de VS Code comme Devin Desktop ou Kiro. Recherchez « Claude Code » dans la vue Extensions de l'éditeur, ou installez à partir du registre Open VSX. Si votre éditeur ne peut pas installer l'extension, installez l'interface CLI et exécutez claude dans son terminal intégré à la place. L'interface CLI fonctionne dans n'importe quel terminal.

Démarrer

Une fois installé, vous pouvez commencer à utiliser Claude Code via l'interface VS Code :

1

Ouvrir le panneau Claude Code

Dans VS Code, l'icône Spark indique Claude Code : <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Icône Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

Le moyen le plus rapide d'ouvrir Claude est de cliquer sur l'icône Spark dans la barre d'outils de l'éditeur (coin supérieur droit de l'éditeur). L'icône n'apparaît que lorsque vous avez un fichier ouvert.

Autres façons d'ouvrir Claude Code :

• Barre d'activité : cliquez sur l'icône Spark dans la barre latérale gauche pour ouvrir la liste des sessions. Cliquez sur n'importe quelle session pour l'ouvrir à votre emplacement préféré, ou démarrez-en une nouvelle. Cette icône est toujours visible dans la barre d'activité.
• Palette de commandes : Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), tapez « Claude Code », et sélectionnez une option comme « Open in New Tab »
• Barre d'état : si vous avez défini preferredLocation sur sidebar, ou ouvert Claude avec Claude Code: Open in Side Bar, cliquez sur ✻ Claude Code dans le coin inférieur droit de la fenêtre. Cela fonctionne même quand aucun fichier n'est ouvert.

Vous pouvez faire glisser le panneau Claude pour le repositionner n'importe où dans VS Code. Consultez Personnaliser votre flux de travail pour plus de détails.

2

Se connecter

La première fois que vous ouvrez le panneau, un écran de connexion apparaît. Cliquez sur Se connecter et complétez l'autorisation dans votre navigateur.

Si vous voyez Not logged in · Please run /login plus tard, l'extension rouvre automatiquement l'écran de connexion. Si cela n'apparaît pas, rechargez la fenêtre à partir de la palette de commandes avec Developer: Reload Window.

Si vous avez ANTHROPIC_API_KEY défini dans votre shell mais que vous voyez toujours l'invite de connexion, VS Code n'a peut-être pas hérité de votre environnement shell. Lancez VS Code à partir d'un terminal avec code . pour qu'il hérite de vos variables d'environnement, ou connectez-vous plutôt avec votre compte Claude.

Après vous être connecté, une liste de contrôle Learn Claude Code apparaît. Travaillez sur chaque élément en cliquant sur Show me, ou fermez-la avec le X. Pour la rouvrir plus tard, décochez Hide Onboarding dans les paramètres VS Code sous Extensions → Claude Code.

3

Envoyer une invite

Demandez à Claude de vous aider avec votre code ou vos fichiers, qu'il s'agisse d'expliquer comment quelque chose fonctionne, de déboguer un problème ou de faire des modifications.

Voici un exemple de question sur une ligne particulière dans un fichier :

4

Examiner les modifications

Ce que vous voyez dépend du mode de permission affiché au bas de la boîte d'invite :

• En mode Auto ou Edit automatically, Claude modifie la plupart des fichiers de votre espace de travail sans demander.
• En mode Manual, quand Claude veut modifier un fichier, il affiche une comparaison côte à côte de l'original et des modifications proposées, puis demande la permission. Vous pouvez accepter, rejeter, ou dire à Claude quoi faire à la place. Si vous modifiez directement le contenu proposé dans la vue diff avant d'accepter, Claude est informé que vous l'avez modifié pour qu'il ne suppose pas que le fichier correspond à sa proposition originale.

Pour plus d'idées sur ce que vous pouvez faire avec Claude Code, consultez Flux de travail courants.

Utiliser la boîte de saisie

La boîte de saisie prend en charge plusieurs fonctionnalités :

• Modes de permission : cliquez sur l'indicateur de mode en bas de la boîte de saisie pour basculer entre les modes de permission. Sur les plans Pro, Max et Team, Auto est le mode de permission intégré au démarrage. Consultez comment l'extension choisit le mode de permission au démarrage pour savoir ce qui change cela, et tous les modes de permission que l'indicateur propose.

  • Auto : un classificateur examine la plupart des actions au lieu de vous demander. Consultez le mode auto pour savoir ce qu'il examine et bloque.
  • Manual : Claude demande la permission avant les modifications de fichiers et la plupart des commandes shell.
  • Plan : Claude décrit ce qu'il fera et attend l'approbation avant d'apporter des modifications. VS Code ouvre automatiquement le plan en tant que document Markdown complet où vous pouvez ajouter des commentaires en ligne pour donner votre avis avant que Claude ne commence.
  • Edit automatically : Claude apporte des modifications sans demander.

• Model : sélectionnez Switch model… dans le menu de commande pour changer de modèle en cours de session. Vous pouvez également cliquer sur le nom du modèle en bas de la boîte de saisie pour ouvrir le même sélecteur. Lorsque le modèle actuel prend en charge les niveaux d'effort, le sélecteur affiche également une ligne Effort et le bouton du nom du modèle affiche le niveau sélectionné. Le bouton du nom du modèle et la ligne Effort nécessitent Claude Code v2.1.257 ou version ultérieure.

• Command menu : cliquez sur / ou tapez / pour ouvrir le menu de commande. Les options incluent l'attachement de fichiers, le changement de modèle et l'activation de la réflexion étendue. La section Customize fournit l'accès aux serveurs MCP, aux slash commands, aux styles de sortie, aux hooks, à la mémoire, aux permissions et aux plugins. Les éléments avec une icône de terminal s'ouvrent dans le terminal intégré.

  • Pour parcourir les commandes telles que /usage ou /remote-control, sélectionnez Slash commands dans la section Customize. Une boîte de dialogue les répertorie avec une zone de filtre. Choisissez-en une pour l'exécuter. Taper / dans la boîte de saisie suggère toujours les commandes en ligne. Nécessite Claude Code v2.1.257 ou version ultérieure.

  • Sélectionnez Output styles dans la section Customize pour choisir un style de sortie, y compris vos styles personnalisés. Nécessite Claude Code v2.1.257 ou version ultérieure.

    Pour créer un style personnalisé à la place, sélectionnez Build a custom style dans le menu Output styles. Claude Code écrit le fichier de style pour vous au niveau du projet ou de l'utilisateur. Nécessite Claude Code v2.1.261 ou version ultérieure.

  • Sélectionnez Hooks dans la section Customize pour afficher les hooks chargés dans la session, regroupés par événement. Vous pouvez ajouter, modifier ou supprimer les hooks enregistrés dans vos fichiers de paramètres utilisateur, projet et local. Les hooks provenant d'autres sources, telles que les paramètres gérés ou les plugins, sont en lecture seule. Nécessite Claude Code v2.1.269 ou version ultérieure.

  • Sélectionnez Permissions dans la section Customize pour afficher les règles de permission de la session, regroupées en Allow, Ask et Deny. Vous pouvez ajouter des règles à vos paramètres utilisateur, projet ou local et supprimer les règles enregistrées là. Les règles provenant d'autres sources, telles que les paramètres gérés ou les approbations effectuées pour cette session uniquement, sont en lecture seule. Nécessite Claude Code v2.1.269 ou version ultérieure.

  • La section Settings inclut Enable Remote Control for all sessions, qui définit remoteControlAtStartup pour contrôler si les nouvelles sessions interactives se connectent à Remote Control automatiquement. Nécessite Claude Code v2.1.203 ou version ultérieure.

    Lorsque vous basculez le commutateur activé ou désactivé dans une fenêtre VS Code, la modification s'applique aux sessions déjà ouvertes dans cette fenêtre VS Code, pas seulement aux sessions que vous démarrez par la suite. Si vous le désactivez, les sessions ouvertes se déconnectent. Avec Claude Code v2.1.261 ou version ultérieure, la modification atteint également les sessions ouvertes dans vos autres fenêtres VS Code.

  • La section Settings inclut également Focus view, qui masque les appels d'outils, les résultats d'outils et la réflexion derrière des lignes extensibles, laissant vos invites et les réponses de Claude. Basculez-le là, avec Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), ou depuis la Palette de commandes avec Claude Code: Toggle Focus view. La modification s'applique à chaque session ouverte et persiste entre les sessions. Nécessite Claude Code v2.1.221 ou version ultérieure.

    La dernière liste de tâches de Claude reste visible, tout comme le texte d'une question en attente que Claude pose ; cela nécessite Claude Code v2.1.225 ou version ultérieure. Pendant que Claude exécute les sous-agents, les lignes de progression en direct avec leur dernière activité apparaissent sous le groupe d'appels d'outils qui les a lancés. Cela nécessite Claude Code v2.1.269 ou version ultérieure.

  • Pour signaler un bogue, cliquez sur Report a problem en bas du menu, ou tapez /bug ou /feedback avec une description facultative qui préremplira le rapport. Lorsque vous soumettez le rapport et que vous êtes connecté à Anthropic sur une connexion propriétaire, Claude Code l'envoie à Anthropic. Sur un fournisseur tiers, ou sans identifiants Anthropic, la boîte de dialogue s'ouvre toujours, mais la soumission affiche une erreur et n'envoie rien : contrairement au /bug de la CLI, l'extension n'écrit pas d'archive locale. Nécessite Claude Code v2.1.229 ou version ultérieure.

• Side questions : tapez /btw suivi d'une question pour poser une question sur votre session sans l'ajouter à la conversation. La réponse s'ouvre dans un panneau à côté du chat, où vous pouvez poser des questions de suivi. Le fil persiste lors des rechargements de fenêtre. Claude Code conserve les 20 derniers échanges et expire les fils stockés selon le calendrier cleanupPeriodDays, tant que Claude Code peut déterminer en toute sécurité la période de rétention. Pour effacer un fil, cliquez sur l'icône de corbeille dans le panneau. Nécessite Claude Code v2.1.227 ou version ultérieure.

• Context indicator : la boîte de saisie affiche la quantité de fenêtre de contexte de Claude que vous utilisez. Claude se compacte automatiquement si nécessaire, ou vous pouvez exécuter /compact manuellement.

• Agent map : lorsque la conversation inclut les sous-agents, un nombre d'agents tel que 2 agents apparaît en bas de la boîte de saisie. Son point indique si un sous-agent travaille ou attend votre permission.

  Cliquez sur le nombre d'agents pour ouvrir la carte des agents, qui dessine les sous-agents de la conversation sous forme d'arbre sous l'agent principal, chacun avec son statut, son temps écoulé et son nombre de jetons. Cliquez sur un sous-agent pour voir son invite et ses appels d'outils, ouvrir sa transcription en lecture seule, ou l'arrêter pendant qu'il s'exécute. Nécessite Claude Code v2.1.269 ou version ultérieure.

• Extended thinking : permet à Claude de consacrer plus de temps au raisonnement sur les problèmes complexes. Activez-le via le menu de commande (/). Le raisonnement de Claude apparaît dans la conversation sous forme de blocs réduits : cliquez sur un bloc pour le lire, ou appuyez sur Ctrl+O pour développer ou réduire chaque bloc de réflexion dans la session. Consultez Extended thinking pour plus de détails.

• Multi-line input : appuyez sur Shift+Enter pour ajouter une nouvelle ligne sans envoyer. Cela fonctionne également dans l'entrée en texte libre « Other » des boîtes de dialogue de questions.

Fichiers et dossiers de référence

Utilisez les mentions @-mention pour donner à Claude du contexte sur des fichiers ou dossiers spécifiques. Lorsque vous tapez @ suivi d'un nom de fichier ou de dossier, Claude lit ce contenu et peut répondre à des questions à ce sujet ou y apporter des modifications. Claude Code prend en charge la correspondance floue, vous pouvez donc taper des noms partiels pour trouver ce dont vous avez besoin :

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

Pour les grands PDF, vous pouvez demander à Claude de lire des pages spécifiques au lieu du fichier entier : une seule page, une plage comme les pages 1-10, ou une plage ouverte comme la page 3 et au-delà.

Lorsque vous sélectionnez du texte dans l'éditeur, Claude peut voir votre code en surbrillance automatiquement. Le pied de page de la boîte de saisie affiche le nombre de lignes sélectionnées. Appuyez sur Option+K (Mac) / Alt+K (Windows/Linux) pour insérer une mention @-mention avec le chemin du fichier et les numéros de ligne (par exemple, @app.ts#5-10). Cliquez sur le X sur l'indicateur de sélection pour le supprimer afin que Claude ne reçoive pas la sélection. L'indicateur réapparaît lorsque vous sélectionnez un autre texte ou basculez vers un fichier différent.

Pour attacher une image, collez-la depuis votre presse-papiers dans la boîte de saisie. Vous pouvez également maintenir Shift enfoncé tout en faisant glisser des fichiers dans la boîte de saisie pour les ajouter en tant que pièces jointes. Cliquez sur le X sur n'importe quelle pièce jointe pour la supprimer du contexte.

Reprendre les conversations passées

Cliquez sur le bouton Session history en haut du panneau Claude Code pour accéder à votre historique de conversation. Vous pouvez rechercher par mot-clé ou parcourir par heure.

Cliquez sur n'importe quelle conversation pour la reprendre avec l'historique complet des messages. Si la conversation est déjà ouverte dans un autre onglet de la fenêtre actuelle, cliquer dessus bascule vers cet onglet. Pour plus d'informations sur la reprise des sessions, consultez Manage sessions.

• Session titles : les nouvelles sessions reçoivent des titres générés par l'IA en fonction de votre premier message.
• Rename and archive : survolez une session pour révéler ces actions. Renommez-la pour lui donner un titre descriptif, ou archivez-la pour la déplacer vers le groupe Archived sessions en bas de la liste.

Par défaut, une session sans activité pendant 14 jours se déplace vers Archived sessions automatiquement, sauf si elle est ouverte, non lue, ou dans un groupe. L'archivage automatique nécessite Claude Code v2.1.265 ou version ultérieure. Pour modifier la période ou la désactiver, ouvrez le paramètre Archive Inactive Sessions et sélectionnez un nombre de jours ou Never.

Pour restaurer une session archivée, développez Archived sessions et cliquez sur Unarchive session. Avant la v2.1.257, l'action était Delete session, qui masquait une session sans aucun moyen de la restaurer. Les sessions que vous avez supprimées apparaissent alors sous Archived sessions après la mise à niveau.

Lorsque la conversation que vous reprenez s'est terminée en mode plan, Claude Code restaure le mode plan. Nécessite Claude Code v2.1.246 ou version ultérieure. Claude Code ne le restaure pas dans deux cas :

• L'extension choisit le mode de permission au démarrage à partir de claudeCode.initialPermissionMode ou d'un choix qui se transporte d'une conversation antérieure
• Vous avez claudeCode.claudeProcessWrapper configuré

Reprendre les sessions cloud depuis Claude.ai

Si vous utilisez Claude Code sur le web, vous pouvez reprendre ces sessions cloud directement dans VS Code. Cela nécessite de se connecter avec Claude.ai Subscription, pas Anthropic Console.

Vérifier le compte et l'utilisation

Exécutez /usage pour ouvrir la boîte de dialogue Account & usage. La boîte de dialogue nécessite une connexion claude.ai, elle n'est donc pas proposée sur un fournisseur tiers. Elle affiche votre compte connecté, votre plan et les barres d'utilisation pour les limites de votre plan, telles que la session actuelle et la semaine. Chaque barre affiche le temps restant avant la réinitialisation de sa limite.

La boîte de dialogue détaille également ce qui contribue à vos limites de plan. Elle signale les comportements qui représentent 10 % ou plus de l'utilisation récente, tels que les défauts de cache, le contexte long et les sessions lourdes en sous-agents ou hautement parallèles, chacun avec un conseil pour le réduire. Les tableaux d'attribution montrent la quantité d'utilisation provenant de chaque skill, sous-agent, plugin et serveur MCP.

Utilisez le bouton bascule Day et Week pour basculer entre les 24 dernières heures et les 7 derniers jours. Les chiffres sont approximatifs et calculés à partir des sessions locales sur cette machine, donc l'utilisation d'autres appareils ou de claude.ai n'est pas incluse. Pour plus d'informations sur le suivi et la réduction de l'utilisation, consultez Track your costs.

Personnalisez votre flux de travail

Vous pouvez repositionner le panneau Claude, exécuter plusieurs conversations, organiser la liste des sessions en groupes ou basculer en mode terminal.

Choisissez où Claude se trouve

Vous pouvez faire glisser le panneau Claude pour le repositionner n'importe où dans VS Code. Saisissez l'onglet ou la barre de titre du panneau et faites-le glisser vers :

• Barre latérale secondaire : le côté droit de la fenêtre. Garde Claude visible pendant que vous codez.
• Barre latérale principale : la barre latérale gauche avec les icônes pour l'Explorateur, la Recherche, etc.
• Zone d'éditeur : ouvre Claude sous forme d'onglet à côté de vos fichiers. Utile pour les tâches secondaires.

Après avoir exécuté Developer: Reload Window ou redémarré VS Code, le retour d'une conversation avec son historique dépend de l'endroit où elle était ouverte :

• Onglet d'éditeur : la conversation revient avec son onglet.
• Barre latérale : la conversation revient si vous avez envoyé un message ou si Claude a répondu dans celle-ci au cours des 10 dernières minutes. Si elle ne revient pas, reprenez la conversation à partir de Historique des sessions.

Exécutez plusieurs conversations

Utilisez Ouvrir dans un nouvel onglet ou Ouvrir dans une nouvelle fenêtre depuis la Palette de commandes pour démarrer des conversations supplémentaires. Chaque conversation maintient son propre historique et contexte, ce qui vous permet de travailler sur différentes tâches en parallèle.

Lors de l'utilisation d'onglets, un petit point coloré sur l'icône d'étincelle indique l'état : bleu signifie qu'une demande de permission est en attente, orange signifie que Claude a terminé pendant que l'onglet était masqué.

Organisez les sessions en groupes

Dans la liste des sessions de la barre d'activité, vous pouvez regrouper les sessions connexes dans des groupes nommés et réductibles. Nécessite Claude Code v2.1.229 ou version ultérieure.

• Grouper ou dégrouper une session : cliquez avec le bouton droit sur une session pour créer un groupe à partir de celle-ci, la déplacer dans un groupe existant ou la supprimer de son groupe. Chaque session appartient à un groupe à la fois, donc la déplacer dans un autre groupe la supprime du premier.
• Déplacer plusieurs sessions à la fois : Cmd-clic (Mac) / Ctrl-clic (Windows/Linux) sur chaque session, ou Maj-clic pour sélectionner une plage, puis cliquez avec le bouton droit sur la sélection.
• Grouper une session à partir de son onglet : exécutez Claude Code : Ajouter l'onglet de session au groupe depuis la Palette de commandes, puis choisissez ou créez un groupe. Nécessite Claude Code v2.1.257 ou version ultérieure.
• Renommer ou supprimer un groupe : cliquez avec le bouton droit sur un en-tête de groupe. La suppression d'un groupe supprime uniquement le groupe, et ses sessions reviennent à la liste non groupée.

L'extension enregistre les groupes par dossier d'espace de travail, ils survivent donc aux rechargements de fenêtre et apparaissent dans chaque fenêtre où vous ouvrez le même dossier. Lorsque vous recherchez dans la liste, l'extension affiche les correspondances dans une liste plate unique sur tous les groupes.

Basculez en mode terminal

Par défaut, l'extension ouvre un panneau de chat graphique. Si vous préférez l'interface de style CLI, ouvrez le paramètre Utiliser le terminal et cochez la case.

Vous pouvez également ouvrir les paramètres VS Code (Cmd+, sur Mac ou Ctrl+, sur Windows/Linux), accédez à Extensions → Claude Code, et cochez Utiliser le terminal.

Gérer les plugins

L'extension VS Code inclut une interface graphique pour installer et gérer les plugins. Tapez /plugins dans la zone de saisie pour ouvrir l'interface Gérer les plugins.

Installer les plugins

La boîte de dialogue des plugins affiche deux onglets : Plugins et Marketplaces.

Dans l'onglet Plugins :

• Les plugins installés apparaissent en haut avec des commutateurs pour les activer ou les désactiver
• Les plugins disponibles de vos marketplaces configurées apparaissent ci-dessous
• Recherchez pour filtrer les plugins par nom ou description
• Cliquez sur Installer sur n'importe quel plugin disponible

Lorsque vous installez un plugin, choisissez l'étendue de l'installation :

• Installer pour vous : disponible dans tous vos projets (étendue utilisateur)
• Installer pour ce projet : partagé avec les collaborateurs du projet (étendue du projet)
• Installer localement : uniquement pour vous, uniquement dans ce référentiel (étendue locale)

Partager un lien d'installation de plugin

Pour envoyer quelqu'un directement à l'installation d'un plugin spécifique, donnez-lui l'URL install-plugin de l'extension. L'ouvrir lance ou met au premier plan VS Code, ouvre le panneau Claude Code, et ouvre la boîte de dialogue Gérer les plugins sur le choix d'étendue de ce plugin. Rien ne s'installe jusqu'à ce que la personne choisisse une étendue. Si la marketplace du plugin n'est pas encore configurée dans leur Claude Code, la boîte de dialogue leur demande d'abord de l'ajouter.

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

L'URL prend deux paramètres de requête :

Deux cas se terminent par un message dans la boîte de dialogue au lieu du choix d'étendue :

• La marketplace ne répertorie pas de plugin avec ce nom : la boîte de dialogue signale que le plugin n'a pas été trouvé. Vérifiez la valeur plugin par rapport au répertoire de la marketplace.
• Le plugin est déjà installé : la boîte de dialogue l'indique, et rien ne change.

Les README GitHub, les problèmes et certains autres hôtes Markdown suppriment les liens dont le schéma n'est pas http ou https, donc un lien vscode:// y est rendu en texte brut. Mettez l'URL dans un bloc de code sur ces hôtes, comme Le lien s'affiche en texte brut au lieu d'être cliquable le décrit pour les liens claude-cli://.

Gérer les marketplaces

Basculez vers l'onglet Marketplaces pour ajouter ou supprimer des sources de plugins :

• Entrez un référentiel GitHub, une URL ou un chemin local pour ajouter une nouvelle marketplace
• Cliquez sur l'icône d'actualisation pour mettre à jour la liste des plugins d'une marketplace
• Cliquez sur l'icône de corbeille pour supprimer une marketplace

Les modifications apportées aux plugins dans la boîte de dialogue s'appliquent immédiatement aux sessions Claude Code ouvertes dans cette fenêtre VS Code. Si la session à partir de laquelle vous avez ouvert la boîte de dialogue ne peut pas recharger ses plugins, la boîte de dialogue vous propose de réessayer ou de redémarrer Claude dans cette session.

Pour en savoir plus sur le système de plugins, consultez Plugins et Plugin marketplaces.

Automatiser les tâches du navigateur avec Chrome

Connectez Claude à votre navigateur Chrome pour tester des applications web, déboguer avec les journaux de console et automatiser les flux de travail du navigateur sans quitter VS Code. Cela nécessite l'extension Claude in Chrome version 1.0.36 ou supérieure.

Tapez @browser dans la zone de saisie suivie de ce que vous souhaitez que Claude fasse :

@browser go to localhost:3000 and check the console for errors

Vous pouvez également ouvrir le menu des pièces jointes pour sélectionner des outils de navigateur spécifiques comme ouvrir un nouvel onglet ou lire le contenu de la page.

Claude ouvre de nouveaux onglets pour les tâches du navigateur et partage l'état de connexion de votre navigateur, ce qui lui permet d'accéder à n'importe quel site auquel vous êtes déjà connecté.

Pour les instructions de configuration, la liste complète des capacités et le dépannage, consultez Utiliser Claude Code avec Chrome.

Commandes et raccourcis VS Code

Ouvrez la Palette de commandes (Cmd+Maj+P sur Mac ou Ctrl+Maj+P sur Windows/Linux) et tapez « Claude Code » pour voir toutes les commandes VS Code disponibles pour l'extension Claude Code.

Certains raccourcis dépendent du panneau qui est « actif » (recevant l'entrée au clavier). Lorsque votre curseur se trouve dans un fichier de code, l'éditeur est actif. Lorsque votre curseur se trouve dans la zone de saisie de Claude, Claude est actif. Utilisez Cmd+Échap / Ctrl+Échap pour basculer entre eux.

Lancer un onglet VS Code à partir d'autres outils

L'extension enregistre un gestionnaire URI à vscode://anthropic.claude-code/open. Utilisez-le pour ouvrir un nouvel onglet Claude Code à partir de vos propres outils : un alias shell, un signet de navigateur ou tout script capable d'ouvrir une URL. Si VS Code n'est pas déjà en cours d'exécution, l'ouverture de l'URL le lance d'abord. Si VS Code est déjà en cours d'exécution, l'URL s'ouvre dans la fenêtre actuellement active.

Invoquez le gestionnaire avec l'ouvreur d'URL de votre système d'exploitation.

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

Le gestionnaire accepte deux paramètres de requête optionnels :

Par exemple, pour ouvrir un onglet pré-rempli avec « review my changes » :

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

L'extension gère également vscode://anthropic.claude-code/install-plugin, qui ouvre la boîte de dialogue du plugin sur un plugin. Pour lancer une session terminal au lieu d'un onglet VS Code, utilisez le gestionnaire claude-cli:// de la CLI. Consultez Launch sessions from links.

Configurer les paramètres

L'extension a deux types de paramètres :

• Paramètres de l'extension dans VS Code : contrôlent le comportement de l'extension dans VS Code. Ouvrez avec Cmd+, (Mac) ou Ctrl+, (Windows/Linux), puis allez à Extensions → Claude Code. Vous pouvez également taper / et sélectionner General config… pour ouvrir les paramètres.
• Paramètres Claude Code dans ~/.claude/settings.json : partagés entre l'extension et CLI. Utilisez-le pour les commandes autorisées, les variables d'environnement, les hooks et les serveurs MCP. Sur les plans Pro, Max et Team, c'est aussi l'une des entrées du mode de permission avec lequel les conversations commencent. Switch permission modes énumère l'ordre. Voir Settings pour plus de détails.

Paramètres de l'extension

VS Code lit initialPermissionMode à partir de vos paramètres utilisateur et ignore les valeurs d'espace de travail. Avant la v2.1.225, VS Code définissait par défaut le paramètre sur default et appliquait les valeurs d'espace de travail.

Utiliser un lecteur d'écran

Le panneau de chat de l'extension fonctionne avec les lecteurs d'écran. Vous n'avez rien à activer : l'extension annonce l'activité de la conversation pour chaque utilisateur, sans aucun changement visuel. Ceci est distinct du mode lecteur d'écran de la CLI, qui adapte l'interface du terminal.

Le support des lecteurs d'écran dans le panneau de chat nécessite Claude Code v2.1.236 ou une version ultérieure.

Pendant une conversation, l'extension annonce :

• Les réponses de Claude : l'extension annonce chaque réponse une seule fois, lorsqu'elle est complète, et reste silencieuse pendant que le texte s'affiche. Votre lecteur d'écran lit les blocs de code comme un résumé du nombre de lignes, lit les liens par leur étiquette, et lit les tableaux cellule par cellule ; la réponse complète reste lisible dans la transcription.
• Les demandes de permission et les questions : l'extension annonce une demande lorsque son invite de permission apparaît, en nommant l'outil que Claude souhaite utiliser. Elle annonce de la même manière lorsque Claude vous pose une question et lorsque Claude termine un plan et attend votre examen.
• Les changements de statut : l'extension annonce lorsque Claude commence à travailler, lorsque Claude est prêt pour votre entrée, et lorsque Claude Code commence à compacter la conversation.
• Les erreurs et les invites de modèle : l'extension annonce les erreurs dans la conversation, et annonce lorsque l'invite de consentement des crédits d'utilisation ou l'invite de demande signalée apparaît.

Chaque tour dans la transcription commence par un titre masqué visuellement étiqueté avec l'invite qui a démarré le tour, afin que vous puissiez naviguer entre les tours avec la navigation par titre de votre lecteur d'écran. Vous pouvez également déplacer le focus vers la transcription elle-même avec Tab, puisque l'extension l'expose comme une région étiquetée, et la lire à votre rythme. Pendant que Claude travaille, votre lecteur d'écran lit une étiquette de texte à la place de l'animation du spinner de progression.

Lorsque vous rouvrez une session ou basculez vers une autre, l'extension n'annonce rien : l'historique restauré, les invites de permission en attente, et le statut en cours restent silencieux jusqu'à ce que quelque chose de nouveau se produise.

Extension VS Code vs. Claude Code CLI

Claude Code est disponible à la fois en tant qu'extension VS Code (panneau graphique) et CLI (interface de ligne de commande dans le terminal). Certaines fonctionnalités ne sont disponibles que dans la CLI. Si vous avez besoin d'une fonctionnalité réservée à la CLI, exécutez claude dans le terminal intégré de VS Code. Cela nécessite l'installation CLI autonome : l'extension n'ajoute pas claude à votre PATH. Voir Exécuter la CLI dans VS Code.

Rewind avec checkpoints

L'extension VS Code prend en charge les checkpoints, qui suivent les modifications de fichiers de Claude et vous permettent de revenir à un état antérieur. Survolez n'importe quel message pour révéler le bouton de rewind, puis choisissez parmi trois options :

• Fork conversation from here : démarrer une nouvelle branche de conversation à partir de ce message tout en conservant toutes les modifications de code
• Rewind code to here : annuler les modifications de fichiers jusqu'à ce point de la conversation tout en conservant l'historique complet de la conversation
• Fork conversation and rewind code : démarrer une nouvelle branche de conversation et annuler les modifications de fichiers jusqu'à ce point

Pour plus de détails sur le fonctionnement des checkpoints et leurs limitations, voir Checkpointing.

Exécuter la CLI dans VS Code

Pour utiliser la CLI tout en restant dans VS Code, ouvrez le terminal intégré (Ctrl+` sur Windows/Linux ou Cmd+` sur Mac) et exécutez claude. La CLI s'intègre automatiquement à votre IDE pour des fonctionnalités comme l'affichage des différences et le partage des diagnostics.

L'installation de l'extension ne met pas claude sur votre PATH shell. L'extension regroupe une copie privée de la CLI pour son panneau de chat, mais taper claude dans un terminal nécessite l'installation CLI autonome. Exécutez l'installation une fois et les commandes de cette page, y compris claude mcp add et claude --resume, fonctionnent dans n'importe quel terminal. Si claude n'est toujours pas trouvé après l'installation, vérifiez votre PATH.

Si vous utilisez un terminal externe, exécutez /ide dans Claude Code pour le connecter à VS Code.

Basculer entre l'extension et la CLI

L'extension et la CLI partagent le même historique de conversation. Pour continuer une conversation d'extension dans la CLI, exécutez claude --resume dans le terminal. Cela ouvre un sélecteur interactif où vous pouvez rechercher et sélectionner votre conversation.

Inclure la sortie du terminal dans les invites

Référencez la sortie du terminal dans vos invites en utilisant @terminal:name où name est le titre du terminal. Cela permet à Claude de voir la sortie des commandes, les messages d'erreur ou les journaux sans copier-coller.

Surveiller les processus en arrière-plan

La visibilité des tâches en arrière-plan dans l'extension est limitée par rapport à la CLI. Pour une meilleure visibilité, demandez à Claude de générer la commande afin que vous puissiez l'exécuter dans le terminal intégré de VS Code.

Connecter à des outils externes avec MCP

MCP (Model Context Protocol) les serveurs donnent à Claude accès à des outils externes, des bases de données et des API.

Pour gérer les serveurs MCP sans quitter VS Code, tapez /mcp dans le panneau de chat. À partir de la boîte de dialogue qui s'ouvre, vous pouvez ajouter des serveurs, supprimer les serveurs enregistrés au niveau local, utilisateur ou projet scope, activer ou désactiver les serveurs, vous reconnecter à un serveur et gérer l'authentification OAuth. L'ajout et la suppression de serveurs dans la boîte de dialogue nécessitent Claude Code v2.1.261 ou version ultérieure.

Vous pouvez également exécuter claude mcp add dans le terminal intégré de VS Code (Ctrl+` ou Cmd+`). La boîte de dialogue et la commande du terminal enregistrent dans la même configuration MCP, et les modifications de l'une ou l'autre prennent effet dans les conversations que vous démarrez par la suite. L'exemple ci-dessous ajoute le serveur MCP distant de GitHub, qui s'authentifie avec un jeton d'accès personnel transmis en tant qu'en-tête :

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Remplacez YOUR_GITHUB_PAT par votre jeton d'accès personnel. La commande claude mcp add enregistre la configuration sans valider les identifiants, donc une valeur d'espace réservé est acceptée ici mais le serveur ne se connecte pas plus tard. Pour vérifier la connexion, démarrez une nouvelle conversation, tapez /mcp et vérifiez que le serveur affiche Connected. Un serveur avec de mauvais identifiants affiche Failed.

Une fois configuré, demandez à Claude d'utiliser les outils (par exemple, « Review PR #456 »).

Pour trouver les serveurs à connecter, voir Trouver et créer des serveurs MCP.

Travailler avec git

Claude Code s'intègre à git pour vous aider avec les workflows de contrôle de version directement dans VS Code. Demandez à Claude de valider les modifications, de créer des demandes de fusion ou de travailler sur plusieurs branches. Pour démarrer Claude dans une arborescence de travail isolée avec ses propres fichiers et branche, consultez Exécuter des sessions parallèles avec worktrees.

Créer des commits et des demandes de fusion

Claude peut indexer les modifications, rédiger des messages de commit et créer des demandes de fusion en fonction de votre travail :

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

Lors de la création de demandes de fusion, Claude génère des descriptions basées sur les modifications de code réelles et peut ajouter du contexte concernant les tests ou les décisions d'implémentation.

Utiliser des fournisseurs tiers

Par défaut, Claude Code se connecte directement à l'API d'Anthropic. Si votre organisation utilise Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry pour accéder à Claude, configurez l'extension pour utiliser votre fournisseur à la place :

Sur un fournisseur tiers, l'extension n'offre pas les fonctionnalités qui nécessitent un compte claude.ai, telles que le suivi de l'utilisation, la dictée vocale et l'onglet Web pour les sessions cloud. Une connexion claude.ai restante d'une /login antérieure reste inutilisée : l'extension ne l'envoie avec aucune demande.

Sécurité et confidentialité

Votre code reste privé. Claude Code traite votre code pour fournir une assistance, mais ne l'utilise pas pour entraîner les modèles. Pour plus de détails sur la gestion des données et comment refuser la journalisation, consultez Données et confidentialité.

Avec les autorisations de modification automatique activées, Claude Code peut modifier les fichiers de configuration de VS Code (comme settings.json ou tasks.json) que VS Code peut exécuter automatiquement. Pour réduire les risques lorsque vous travaillez avec du code non approuvé :

• Activez le Mode restreint de VS Code pour les espaces de travail non approuvés
• Utilisez le mode Manuel au lieu de Modifier automatiquement ou Auto pour les modifications
• Examinez attentivement les modifications avant de les accepter

Le serveur MCP IDE intégré

Lorsque l'extension est active, elle exécute un serveur MCP local auquel le CLI se connecte automatiquement. C'est ainsi que le CLI ouvre les diffs dans la visionneuse de diffs native de VS Code, lit votre sélection actuelle pour les mentions @, et — lorsque vous travaillez dans un notebook Jupyter — demande à VS Code d'exécuter les cellules.

Le serveur est nommé ide et est masqué de /mcp car il n'y a rien à configurer. Si votre organisation utilise un hook PreToolUse pour créer une liste d'autorisation des outils MCP, vous devrez cependant savoir qu'il existe.

Contexte de sélection et de fichier ouvert. Lors de la connexion, le CLI inclut votre sélection d'éditeur actuelle et le chemin du fichier actif comme contexte sur chaque invite que vous envoyez. La transcription affiche une ligne ⧉ Selected N lines from <file> lorsque cela se produit. Pour exclure un fichier sensible tel que .env, ajoutez une règle de refus Read pour son chemin. Une règle de refus correspondante empêche à la fois le texte sélectionné et l'avis de fichier ouvert pour ce fichier d'atteindre Claude.

Transport et authentification. Le serveur se lie à 127.0.0.1 sur un port aléatoire dans la plage 10000–65535, et le port n'est pas configurable. Le transport est un ws:// non chiffré ; comme la socket est en boucle locale uniquement, tout processus qui pourrait capturer le trafic peut également lire le jeton du fichier de verrouillage, donc TLS n'ajouterait pas de protection. Chaque activation d'extension génère un jeton d'authentification aléatoire frais, l'écrit dans un fichier de verrouillage à ~/.claude/ide/<port>.lock, et le CLI doit le présenter comme l'en-tête X-Claude-Code-Ide-Authorization pour se connecter. Le fichier de verrouillage a des autorisations 0600 dans un répertoire 0700, donc seul l'utilisateur exécutant VS Code peut le lire. Si CLAUDE_CONFIG_DIR est défini, le fichier de verrouillage est écrit dans $CLAUDE_CONFIG_DIR/ide/ à la place.

Outils exposés au modèle. Le serveur héberge une douzaine d'outils, mais seulement deux sont visibles au modèle. Le reste est un RPC interne que le CLI utilise pour sa propre interface utilisateur — ouvrir les diffs, lire les sélections, enregistrer les fichiers — et sont filtrés avant que la liste des outils n'atteigne Claude.

L'exécution Jupyter demande toujours d'abord. mcp__ide__executeCode ne peut rien exécuter silencieusement. À chaque appel, le code est inséré comme une nouvelle cellule à la fin du notebook actif, VS Code le fait défiler dans la vue, et un Quick Pick natif vous demande d'Exécuter ou d'Annuler. Annuler — ou fermer le sélecteur avec Esc — retourne une erreur à Claude et rien ne s'exécute. L'outil refuse également catégoriquement lorsqu'il n'y a pas de notebook actif, lorsque l'extension Jupyter (ms-toolsai.jupyter) n'est pas installée, ou lorsque le kernel n'est pas Python.

• Assurez-vous que vous disposez d'une version compatible de VS Code (1.94.0 ou ultérieure)
• Vérifiez que VS Code a la permission d'installer des extensions
• Essayez d'installer directement depuis la Place de marché VS Code

L'icône Spark n'est pas visible

L'icône Spark apparaît dans la Barre d'outils de l'éditeur (en haut à droite de l'éditeur) lorsque vous avez un fichier ouvert. Si vous ne la voyez pas :

1. Ouvrez un fichier : L'icône nécessite qu'un fichier soit ouvert. Avoir simplement un dossier ouvert ne suffit pas.
2. Vérifiez la version de VS Code : Nécessite la version 1.94.0 ou ultérieure (Aide → À propos)
3. Redémarrez VS Code : Exécutez « Developer: Reload Window » depuis la Palette de commandes
4. Désactivez les extensions conflictuelles : Désactivez temporairement les autres extensions IA (Cline, Continue, etc.)
5. Vérifiez la confiance de l'espace de travail : L'extension ne fonctionne pas en mode restreint

Sinon, si vous avez défini preferredLocation sur sidebar, ou ouvert Claude avec Claude Code: Open in Side Bar, cliquez sur « ✻ Claude Code » dans la Barre d'état (coin inférieur droit). Cela fonctionne même sans fichier ouvert. Vous pouvez également utiliser la Palette de commandes (Cmd+Shift+P / Ctrl+Shift+P) et taper « Claude Code ».

Cmd+Esc ne fait rien sur macOS

Sur macOS Tahoe et versions ultérieures, le raccourci système Game Overlay est lié à Cmd+Esc par défaut et intercepte la frappe avant qu'elle n'atteigne VS Code. Pour libérer le raccourci :

1. Ouvrez Réglages système
2. Allez à Clavier, puis Raccourcis clavier, puis Contrôleurs de jeu
3. Décochez la case Game Overlay

Sinon, reliez l'extension à une touche différente : ouvrez l'éditeur de raccourcis clavier de VS Code (Cmd+K Cmd+S), recherchez Claude Code: Focus input, et attribuez une nouvelle liaison.

Claude Code ne répond jamais

Si Claude Code ne répond pas à vos invites :

1. Vérifiez votre connexion Internet : Assurez-vous que vous disposez d'une connexion Internet stable
2. Commencez une nouvelle conversation : Essayez de commencer une nouvelle conversation pour voir si le problème persiste
3. Essayez l'interface de ligne de commande : Exécutez claude depuis le terminal pour voir si vous obtenez des messages d'erreur plus détaillés

Si les problèmes persistent, signalez un problème sur GitHub avec des détails sur l'erreur.

Désinstaller l'extension

Pour désinstaller l'extension Claude Code :

1. Ouvrez la vue Extensions (Cmd+Shift+X sur Mac ou Ctrl+Shift+X sur Windows/Linux)
2. Recherchez « Claude Code »
3. Cliquez sur Désinstaller

Si vous exécutez claude dans un terminal intégré VS Code, Claude Code réinstalle l'extension automatiquement. Pour la maintenir désinstallée, désactivez Auto-install IDE extension dans /config, ou définissez autoInstallIdeExtension sur false. Vous pouvez également définir la variable d'environnement CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL sur 1.

Pour supprimer également les données d'extension et réinitialiser tous les paramètres, supprimez le répertoire de stockage de l'extension pour votre plateforme.

Sur macOS :

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

Sur Linux :

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Sur Windows, dans PowerShell :

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

Pour obtenir une aide supplémentaire, consultez le guide de dépannage.

Étapes suivantes

Maintenant que vous avez Claude Code configuré dans VS Code :

• Explorez les flux de travail courants pour tirer le meilleur parti de Claude Code
• Configurez les serveurs MCP pour étendre les capacités de Claude avec des outils externes. Ajoutez et gérez-les avec /mcp dans le panneau de chat.
• Configurez les paramètres Claude Code pour personnaliser les commandes autorisées, les hooks et bien d'autres. Ces paramètres sont partagés entre l'extension et le CLI.