Conditions préalables
- VS Code 1.98.0 ou supérieur
- Un compte Anthropic (vous vous connecterez lors de la première ouverture de l’extension). Si vous utilisez un fournisseur tiers comme Amazon Bedrock ou Google Vertex AI, consultez plutôt Utiliser des fournisseurs tiers.
Installer l’extension
Cliquez sur le lien de votre IDE pour installer directement : Ou dans VS Code, appuyez surCmd+Shift+X (Mac) ou Ctrl+Shift+X (Windows/Linux) pour ouvrir la vue Extensions, recherchez « Claude Code » et cliquez sur Installer.
Vous devrez peut-être redémarrer VS Code ou exécuter « Developer: Reload Window » à partir de la Palette de commandes après l’installation.
Commencer
Une fois installée, 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 : 
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.
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.- Palette de commandes :
Cmd+Shift+P(Mac) ouCtrl+Shift+P(Windows/Linux), tapez « Claude Code » et sélectionnez une option comme « Ouvrir dans un nouvel onglet » - Barre d’état : Cliquez sur ✱ Claude Code dans le coin inférieur droit de la fenêtre. Cela fonctionne même quand aucun fichier n’est ouvert.
2
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 d’un fichier :
3
Examiner les modifications
Quand Claude veut modifier un fichier, il vous montre un diff et demande la permission. Vous pouvez accepter, rejeter ou dire à Claude ce qu’il faut faire à la place.
Personnaliser votre flux de travail
Une fois que vous êtes opérationnel, vous pouvez repositionner le panneau Claude ou passer en mode terminal.Modifier la disposition
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 (par défaut) : Le côté droit de la fenêtre
- Barre latérale principale : La barre latérale gauche avec les icônes pour l’Explorateur, la Recherche, etc.
- Zone de l’éditeur : Ouvre Claude comme un onglet à côté de vos fichiers
L’icône Spark n’apparaît dans la Barre d’activités (icônes de la barre latérale gauche) que lorsque le panneau Claude est ancré à gauche. Puisque Claude est par défaut sur le côté droit, utilisez l’icône de la Barre d’outils de l’éditeur pour ouvrir Claude.
Passer 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), aller à Extensions → Claude Code et cocher Utiliser le terminal.
Commandes et raccourcis VS Code
Ouvrez la Palette de commandes (Cmd+Shift+P sur Mac ou Ctrl+Shift+P sur Windows/Linux) et tapez « Claude Code » pour voir toutes les commandes VS Code disponibles pour l’extension Claude Code :
Ce sont des commandes VS Code pour contrôler l’extension. Pour les commandes slash Claude Code (comme
/help ou /compact), toutes les commandes CLI ne sont pas encore disponibles dans l’extension. Consultez Extension VS Code vs. Interface de ligne de commande Claude Code pour plus de détails.| Commande | Raccourci | Description |
|---|---|---|
| Focus Input | Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) | Basculer le focus entre l’éditeur et Claude |
| Open in Side Bar | — | Ouvrir Claude dans la barre latérale gauche |
| Open in Terminal | — | Ouvrir Claude en mode terminal |
| Open in New Tab | Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) | Ouvrir une nouvelle conversation comme un onglet d’éditeur |
| Open in New Window | — | Ouvrir une nouvelle conversation dans une fenêtre séparée |
| New Conversation | Cmd+N (Mac) / Ctrl+N (Windows/Linux) | Démarrer une nouvelle conversation (quand Claude est en focus) |
| Insert @-Mention Reference | Alt+K | Insérer une référence au fichier actuel (inclut les numéros de ligne si du texte est sélectionné) |
| Show Logs | — | Afficher les journaux de débogage de l’extension |
| Logout | — | Se déconnecter de votre compte Anthropic |
Configurer les paramètres
L’extension a deux types de paramètres :-
Paramètres d’extension : Ouvrez avec
Cmd+,(Mac) ouCtrl+,(Windows/Linux), puis allez à Extensions → Claude Code.Paramètre Description Selected Model Modèle par défaut pour les nouvelles conversations. Changez par session avec /model.Use Terminal Lancer Claude en mode terminal au lieu du panneau graphique Initial Permission Mode Contrôle les invites d’approbation pour les modifications de fichiers et les commandes. Par défaut default(demander avant chaque action).Preferred Location Emplacement par défaut : barre latérale (droite) ou panneau (nouvel onglet) Autosave Enregistrer automatiquement les fichiers avant que Claude les lise ou les écrive Use Ctrl+Enter to Send Utiliser Ctrl/Cmd+Enter au lieu d’Entrée pour envoyer les invites Enable New Conversation Shortcut Activer Cmd/Ctrl+N pour démarrer une nouvelle conversation Respect Git Ignore Exclure les modèles .gitignore des recherches de fichiers Environment Variables Définir les variables d’environnement pour le processus Claude. Non recommandé—utilisez plutôt les paramètres Claude Code pour que la configuration soit partagée entre l’extension et l’interface de ligne de commande. Disable Login Prompt Ignorer les invites d’authentification (pour les configurations de fournisseur tiers) Allow Dangerously Skip Permissions Contourner toutes les invites de permission. À utiliser avec extrême prudence—recommandé uniquement pour les bacs à sable isolés sans accès à Internet. Claude Process Wrapper Chemin exécutable utilisé pour lancer le processus Claude -
Paramètres Claude Code (
~/.claude/settings.json) : Ces paramètres sont partagés entre l’extension VS Code et l’interface de ligne de commande. Utilisez ce fichier pour les commandes et répertoires autorisés, les variables d’environnement, les hooks et les serveurs MCP. Consultez la documentation des paramètres pour plus de détails.
Utiliser des fournisseurs tiers
Par défaut, Claude Code se connecte directement à l’API d’Anthropic. Si votre organisation utilise Amazon Bedrock, Google Vertex AI ou Microsoft Foundry pour accéder à Claude, configurez l’extension pour utiliser votre fournisseur à la place :1
Désactiver l'invite de connexion
Ouvrez le paramètre Désactiver l’invite de connexion et cochez la case.Vous pouvez également ouvrir les paramètres VS Code (
Cmd+, sur Mac ou Ctrl+, sur Windows/Linux), rechercher « Claude Code login » et cocher Disable Login Prompt.2
Configurer votre fournisseur
Suivez le guide de configuration de votre fournisseur :Ces guides couvrent la configuration de votre fournisseur dans
~/.claude/settings.json, ce qui garantit que vos paramètres sont partagés entre l’extension VS Code et l’interface de ligne de commande.Extension VS Code vs. Interface de ligne de commande Claude Code
L’extension n’a pas encore une parité de fonctionnalités complète avec l’interface de ligne de commande. Si vous avez besoin de fonctionnalités réservées à l’interface de ligne de commande, vous pouvez exécuterclaude directement dans le terminal intégré de VS Code.
| Fonctionnalité | CLI | Extension VS Code |
|---|---|---|
| Commandes slash | Ensemble complet | Sous-ensemble (tapez / pour voir les options disponibles) |
| Configuration du serveur MCP | Oui | Non (configurer via l’interface de ligne de commande, utiliser dans l’extension) |
| Points de contrôle | Oui | À venir |
Raccourci bash ! | Oui | Non |
| Complément de tabulation | Oui | Non |
Exécuter l’interface de ligne de commande dans VS Code
Pour utiliser l’interface de ligne de commande tout en restant dans VS Code, ouvrez le terminal intégré (Ctrl+` sur Windows/Linux ou Cmd+` sur Mac) et exécutez claude. L’interface de ligne de commande s’intègre automatiquement à votre IDE pour des fonctionnalités comme l’affichage des diffs et le partage des diagnostics.
Si vous utilisez un terminal externe, exécutez /ide dans Claude Code pour le connecter à VS Code.
Basculer entre l’extension et l’interface de ligne de commande
L’extension et l’interface de ligne de commande partagent le même historique de conversation. Pour continuer une conversation d’extension dans l’interface de ligne de commande, exécutezclaude --resume dans le terminal. Cela ouvre un sélecteur interactif où vous pouvez rechercher et sélectionner votre conversation.
Considérations de sécurité
Avec les permissions d’édition automatique activées, Claude Code peut modifier les fichiers de configuration de VS Code (commesettings.json ou tasks.json) que VS Code peut exécuter automatiquement. Cela pourrait potentiellement contourner les invites de permission normales de Claude Code.
Pour réduire le risque 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 d’approbation manuelle au lieu de l’acceptation automatique pour les modifications
- Examinez attentivement les modifications avant de les accepter
Corriger les problèmes courants
L’extension ne s’installe pas
- Assurez-vous que vous avez une version compatible de VS Code (1.98.0 ou ultérieure)
- Vérifiez que VS Code a la permission d’installer des extensions
- Essayez d’installer directement à partir du site Web de la Marketplace
L’icône Spark n’est pas visible
L’icône Spark apparaît dans la Barre d’outils de l’éditeur (coin supérieur droit de l’éditeur) quand vous avez un fichier ouvert. Si vous ne la voyez pas :- Ouvrir un fichier : L’icône nécessite qu’un fichier soit ouvert—avoir juste un dossier ouvert ne suffit pas
- Vérifier la version de VS Code : Nécessite 1.98.0 ou supérieur (Aide → À propos)
- Redémarrer VS Code : Exécutez « Developer: Reload Window » à partir de la Palette de commandes
- Désactiver les extensions conflictuelles : Désactivez temporairement les autres extensions IA (Cline, Continue, etc.)
- Vérifier la confiance de l’espace de travail : L’extension ne fonctionne pas en Mode restreint
Cmd+Shift+P / Ctrl+Shift+P) et taper « Claude Code ».
Claude Code ne répond jamais
Si Claude Code ne répond pas à vos invites :- Vérifier votre connexion Internet : Assurez-vous que vous avez une connexion Internet stable
- Démarrer une nouvelle conversation : Essayez de démarrer une nouvelle conversation pour voir si le problème persiste
- Essayer l’interface de ligne de commande : Exécutez
claudeà partir du terminal pour voir si vous obtenez des messages d’erreur plus détaillés - Signaler un bug : Si le problème persiste, signalez un problème sur GitHub avec des détails sur l’erreur
L’interface de ligne de commande autonome ne se connecte pas à l’IDE
- Assurez-vous que vous exécutez Claude Code à partir du terminal intégré de VS Code (pas un terminal externe)
- Assurez-vous que l’interface de ligne de commande pour votre variante d’IDE est installée :
- VS Code : la commande
codedoit être disponible - Cursor : la commande
cursordoit être disponible - Windsurf : la commande
windsurfdoit être disponible - VSCodium : la commande
codiumdoit être disponible
- VS Code : la commande
- Si la commande n’est pas disponible, installez-la à partir de la Palette de commandes → « Shell Command: Install ‘code’ command in PATH »
Désinstaller l’extension
Pour désinstaller l’extension Claude Code :- Ouvrez la vue Extensions (
Cmd+Shift+Xsur Mac ouCtrl+Shift+Xsur Windows/Linux) - Recherchez « Claude Code »
- Cliquez sur Désinstaller
É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. Configurez les serveurs à l’aide de l’interface de ligne de commande, puis utilisez-les dans l’extension.
- Configurez les paramètres Claude Code pour personnaliser les commandes autorisées, les hooks et bien plus. Ces paramètres sont partagés entre l’extension et l’interface de ligne de commande.