Comment utiliser Claude Code avec VS Code ?
Claude Code est l'assistant IA d'Anthropic conçu pour les développeurs. Disponible directement dans VS Code via une extension officielle, il permet de générer, modifier, analyser et déboguer du code sans quitter son éditeur. Depuis 2025, l'extension native est la méthode recommandée pour utiliser Claude Code dans VS Code — voici comment l'installer et en tirer le meilleur parti.
Prérequis avant l'installation
Avant d'installer l'extension Claude Code, vérifiez les points suivants :
- VS Code 1.98.0 ou supérieur — les versions antérieures ne sont pas compatibles avec l'extension
- Un compte Anthropic — vous vous connecterez lors du premier lancement de l'extension. Claude Code nécessite un abonnement Claude Pro, Max, Team ou Enterprise
- Si vous utilisez Amazon Bedrock ou Google Vertex AI comme fournisseur, une configuration spécifique dans settings.json est nécessaire
Installer l'extension Claude Code
L'installation se fait directement depuis VS Code en quelques secondes :
- Ouvrez VS Code et appuyez sur Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (Mac) pour ouvrir le panneau Extensions
- Recherchez "Claude Code" dans la barre de recherche
- Installez l'extension publiée par Anthropic — vérifiez bien l'éditeur pour éviter les extensions tierces non officielles
- Si l'icône Spark n'apparaît pas après installation, redémarrez VS Code ou exécutez "Developer: Reload Window" depuis la palette de commandes
Bon à savoir : l'extension inclut automatiquement le CLI (interface en ligne de commande) Claude Code. Vous n'avez donc pas besoin d'installer le CLI séparément — il est accessible directement depuis le terminal intégré de VS Code pour les fonctionnalités avancées.
Ouvrir Claude Code dans VS Code
Une fois l'extension installée, l'icône Spark (⚡) identifie Claude Code dans toute l'interface VS Code. Plusieurs façons d'y accéder :
- Barre d'outils de l'éditeur : cliquez sur l'icône Spark en haut à droite de l'éditeur — visible uniquement quand un fichier est ouvert
- Barre d'activité : cliquez sur l'icône Spark dans la barre latérale gauche pour ouvrir la liste des sessions. Toujours visible même sans fichier ouvert
- 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 de la fenêtre
Lors de la première ouverture, une checklist de démarrage guidé apparaît. Parcourez chaque étape en cliquant sur "Show me" ou ignorez-la avec la croix.
Envoyer une première requête
Claude Code voit automatiquement le fichier actuellement ouvert dans votre éditeur. Pour interagir :
- Sélectionnez du code dans votre fichier — Claude Code inclut automatiquement cette sélection dans le contexte de votre requête
- Appuyez sur Option+K (Mac) / Alt+K (Windows/Linux) pour insérer une référence @fichier.ts#5-10 vers votre sélection dans le prompt
- Tapez votre demande en langage naturel : "Explique cette fonction", "Corrige ce bug", "Ajoute des tests unitaires pour cette classe"…
Quand Claude Code propose de modifier un fichier, il affiche une comparaison diff côte à côte des changements proposés avant de les appliquer. Vous pouvez accepter, rejeter ou demander des ajustements.
Les modes de permission
Claude Code propose trois modes de permission accessibles depuis le bas de la boîte de prompt :
| Mode | Comportement | Usage recommandé |
|---|---|---|
| Normal | Claude demande confirmation avant chaque action | Usage quotidien, contrôle précis |
| Plan | Claude décrit ce qu'il va faire et attend votre approbation avant de modifier quoi que ce soit | Tâches complexes, refactorings importants |
| Auto-accept | Claude effectue les modifications sans demander | Tâches répétitives, prototypage rapide |
Le mode Plan est particulièrement utile pour les modifications importantes : Claude ouvre le plan sous forme de document Markdown dans lequel vous pouvez ajouter des commentaires inline avant qu'il commence à modifier votre code.
Référencer des fichiers avec les @-mentions
Pour donner du contexte supplémentaire à Claude Code, utilisez les @-mentions dans le prompt :
- Tapez @ suivi du nom du fichier pour le mentionner : @auth.ts
- Ajoutez une plage de lignes pour cibler une section précise : @auth.ts#10-25
- Mentionnez un dossier entier : @src/components/
- Utilisez Option+K / Alt+K depuis une sélection pour insérer automatiquement la référence
Gérer plusieurs conversations
VS Code permet d'ouvrir plusieurs sessions Claude Code simultanément — utile pour travailler en parallèle sur plusieurs fonctionnalités ou dossiers de workspace :
- Chaque session maintient son propre contexte indépendant
- Ouvrez une nouvelle conversation avec Cmd+N (Mac) / Ctrl+N (Windows/Linux) depuis le panneau Claude
- Accédez à l'historique des conversations depuis l'icône Spark de la barre d'activité
- Les sessions peuvent être ouvertes comme onglets ou fenêtres séparées selon vos préférences
Bon à savoir : si vous travaillez sur un projet monorepo ou microservices, chaque dossier de workspace peut avoir sa propre session Claude Code avec son propre contexte. Pour personnaliser le comportement de Claude sur votre projet, créez un fichier CLAUDE.md à la racine de votre dépôt — Claude Code le lira automatiquement pour adapter ses réponses à votre projet, vos conventions et vos instructions spécifiques.
Utiliser le CLI depuis le terminal intégré
L'extension VS Code inclut le CLI Claude Code, accessible depuis le terminal intégré de VS Code. Le CLI offre des fonctionnalités avancées non disponibles dans l'interface graphique :
- Exécutez claude dans le terminal intégré pour lancer une session CLI
- Utilisez claude -p "votre prompt" pour des requêtes non interactives (mode print)
- La commande /terminal-setup dans une session configure automatiquement le raccourci Shift+Enter pour les prompts multi-lignes
- Basculez entre l'interface graphique et le CLI via le menu des paramètres de l'extension
Raccourcis clavier essentiels
| Action | Mac | Windows / Linux |
|---|---|---|
| Ouvrir le panneau Extensions | Cmd+Shift+X | Ctrl+Shift+X |
| Palette de commandes | Cmd+Shift+P | Ctrl+Shift+P |
| Insérer @-mention depuis sélection | Option+K | Alt+K |
| Basculer focus éditeur / Claude | Cmd+Esc | Ctrl+Esc |
| Nouvelle conversation | Cmd+N | Ctrl+N |
Bon à savoir : Claude Code pour VS Code fonctionne également avec Cursor, Windsurf et VSCodium — la procédure d'installation est identique. Pour les équipes utilisant Amazon Bedrock ou Google Vertex AI, ajoutez les variables d'environnement correspondantes dans le fichier settings.json de VS Code pour configurer le fournisseur alternatif.
Nicolas,