Claude Code dans VS Code : comment utiliser l'extension

Comme indiqué dans la section capacités, le plan mode fonctionne très bien pour les changements d'ampleur. Un détail passé sous silence plus haut : Claude lance d'abord des commandes d'exploration et enregistre le plan complet dans un fichier. Ajoutez vos commentaires avant toute écriture. Même si je finis par modifier une bonne partie du plan, le document écrit reste utile.

Pour un contexte ciblé, utilisez les @-mentions avec plages de lignes : @app.ts#5-10 concentre Claude sur une zone précise. Maintenir Shift tout en faisant glisser des fichiers dans la zone de saisie les ajoute comme pièces jointes. Option+K sur Mac (ou Alt+K sur Windows et Linux) insère directement une @-mention du fichier et de la sélection en cours.

Raccourcis clavier VS Code utiles à connaître

Ces raccourcis proviennent de la documentation de l'extension VS Code d'Anthropic et couvrent ceux que j'utilise le plus souvent dans le panneau.

Le défilement des modes d'autorisation reste dans le CLI : appuyez sur Shift+Tab dans le terminal intégré pour passer entre les modes default, plan et accept-edits. Pour l'ensemble des slash-commands, consultez notre guide des commandes slash Claude Code.

Les checkpoints tracent les éditions de fichiers par Claude tout au long de la session. Survolez n'importe quel message de la conversation pour faire apparaître le bouton de rembobinage. Options : forker la conversation en conservant les modifications de code, rembobiner le code en gardant l'historique de conversation, ou les deux. Les checkpoints sont conservés 30 jours. Ils ne tracent pas les commandes bash : rm, mv et cp sont hors périmètre. Git reste le filet de sécurité adéquat pour toute action destructive.

Claude Code dans VS Code pour le débogage et la refactorisation

Les deux workflows suivent les mêmes étapes : donner le contexte à Claude, revoir la modification proposée, vérifier le résultat. La difficulté commune est de rassembler le bon contexte.

Débogage

Partagez l'erreur en la collant directement, en référençant la sortie du terminal avec @terminal:name, ou en laissant Claude lire le panneau Problèmes via mcp__ide__getDiagnostics. Claude remonte à la cause racine, propose un correctif sous forme de diff, puis vous lancez vos tests pour valider.

Claude Code ne s'intègre pas au débogueur natif de VS Code : pas de points d'arrêt, pas d'exécution pas à pas, pas de variables en direct. Le collage d'erreurs et les diagnostics couvrent la plupart des cas. Si vous avez besoin du débogueur, un serveur MCP communautaire (claude-debugs-for-you sur GitHub) comble le manque, mais nécessite sa propre configuration.

Pour le débogage web en direct, @browser connecte Claude à Chrome via l'extension Claude pour Chrome (version 1.0.36 ou supérieure). Une invite comme @browser go to localhost:3000 and check the console for errors permet à Claude d'inspecter l'état du navigateur sans changer de fenêtre.

Refactorisation

Claude gère bien les modifications coordonnées : renommage d'une fonction à grande échelle, migration d'une bibliothèque à une autre. L'étape de revue de diff l'empêche d'être imprudent.

Le fichier CLAUDE.md est crucial ici. Sans conventions spécifiques au projet, Claude adopte par défaut les patterns inférés depuis le code, qui peuvent ne pas correspondre à vos attentes. Comme indiqué dans la section configuration, /init vous donne un fichier de départ ; prendre dix minutes pour le raffiner avant une grosse refactorisation en vaut la peine.

La compaction du contexte est la limite pratique des longues sessions. Quand la fenêtre de contexte est pleine, Claude compacte automatiquement en résumant l'ancien échange. Ensuite, il peut perdre le fil de décisions antérieures. Lancer /compact manuellement avant une nouvelle phase donne des résultats plus prévisibles que d'attendre la compaction auto en plein milieu d'une tâche.

Claude Code dans VS Code vs le workflow au terminal

La documentation d'Anthropic présente l'extension VS Code comme « la manière recommandée d'utiliser Claude Code dans VS Code ». L'extension apporte des éléments que le terminal n'offre pas : visualiseur de diff côte à côté, revue de plan dans un document markdown modifiable, plusieurs conversations en onglets séparés, et @browser pour le débogage web en direct.

Le terminal l'emporte en capacités. Le raccourci ! pour bash, l'autocomplétion par tabulation, l'ensemble complet des slash-commands, et les workflows en pipes comme tail -200 app.log | claude -p \"...\" sont réservés au CLI. La configuration des serveurs MCP est également limitée au terminal. Depuis l'extension, vous pouvez gérer les serveurs existants avec /mcp mais pas en ajouter de nouveaux.

Les deux ne sont pas exclusifs. Exécuter claude dans le terminal intégré de VS Code bénéficie toujours de l'intégration IDE : visualisation des diffs, partage du contexte de sélection et diagnostics fonctionnent aussi. Les sessions démarrées dans l'extension peuvent se poursuivre au terminal avec claude --resume. Exécutez claude --ide depuis le terminal intégré si vous voulez forcer la connexion du CLI au visualiseur de diff et au pont de diagnostics de VS Code.

La plupart des développeurs combinent les deux : VS Code pour le multi-fichiers et la relecture minutieuse, le terminal pour les tâches rapides et l'automatisation. Certains restent 100 % au terminal : honnêtement, ça fonctionne très bien aussi. Si vous préférez Cursor à VS Code, notre guide Claude Code dans Cursor décrit le même fonctionnement. Dans tous les cas, notre workflow CLI complet reste à connaître.

Claude Code dans VS Code vs GitHub Copilot

Comme mentionné au début, « Claude dans VS Code » peut désigner l'extension native, Claude via le sélecteur de modèles GitHub Copilot, ou le CLI dans le terminal intégré. L'extension native et Copilot partagent un modèle mais pas le même produit, et leurs modes d'usage diffèrent sensiblement.

Via Copilot, le modèle Claude s'exécute dans le paradigme de chat et de complétion de GitHub : pas de bac à sable local OS, pas d'intégrations MCP personnalisées, pas de commandes terminal natives. Via l'extension Claude Code, le même modèle dispose d'une fenêtre de contexte jusqu'à 1 million de tokens, exécute des tâches multi-fichiers et accède aux checkpoints, au plan mode et aux serveurs MCP.

Ces outils sont conçus pour des usages différents. Copilot propose avant tout l'autocomplétion en ligne. Claude Code ne fait aucune autocomplétion. Le mode agent de Copilot a beaucoup progressé, mais dans les benchmarks communautaires, il reste souvent en retrait pour les tâches à travers de nombreux fichiers. Aucun n'est intrinsèquement supérieur.

Extension native et Copilot : même modèle, expérience différente. Image de l'auteur.

Côté prix : Copilot Pro coûte 10 $/mois avec 300 requêtes premium. Claude Code Pro est à 20 $/mois. Beaucoup de développeurs combinent les deux : 10 $ pour Copilot (autocomplétion pendant la frappe) et 20 $ pour Claude Code (tâches délibérées et à plus grande échelle). Les deux produits couvrent des segments différents du flux de travail, avec peu de chevauchement. Anthropic s'est aussi associé à GitHub pour intégrer des modèles Claude dans Copilot, qui gère le volet autocomplétion.

Points de sécurité et vie privée

Anthropic n'utilise pas votre code pour entraîner ses modèles Claude. Les utilisateurs Free, Pro et Max peuvent désactiver totalement la journalisation des données dans les paramètres du compte ; les offres Team, Enterprise et API sont exclues par défaut. Pour plus de détails sur les modes d'autorisation, les serveurs MCP et le bac à sable au-delà de l'interface VS Code, consultez notre guide de sécurité Claude Code.

Un ensemble de chemins est toujours protégé quel que soit le mode : .git, .vscode, .idea, .husky, et .claude (avec exceptions pour ses sous-répertoires de travail), ainsi que .gitconfig, .gitmodules, et plusieurs fichiers de configuration shell et outils. C'est essentiel en mode d'acceptation auto, qui écrit sans pause et peut toucher settings.json et tasks.json. Vérifiez les diffs Git avant de valider.

Le bac à sable isole les commandes bash au répertoire de travail et bloque les accès réseau non autorisés. Il est désactivé par défaut ; activez-le avec /sandbox.

Le mode auto remplace l'approbation action par action par un classifieur qui vérifie les actions avant exécution, bloquant par exemple la suppression massive de fichiers, l'envoi de données vers des points de terminaison non autorisés, et les push forcés sur main. Anthropic le présente comme une alternative plus sûre à --dangerously-skip-permissions.

Les transcriptions locales sont stockées en clair sous ~/.claude/projects/ pendant 30 jours (cleanupPeriodDays ajuste ce délai). Les déploiements Enterprise sur Amazon Bedrock, Google Vertex AI ou Microsoft Foundry suivent les conditions de ces fournisseurs. Le mode auto n'est pas disponible via ces fournisseurs ; il requiert directement l'API Anthropic.

Dépannage : problèmes courants avec l'extension VS Code

La plupart des problèmes d'installation relèvent d'une courte liste. Je les ai tous rencontrés au moins une fois.

• Icône Spark absente : Ouvrez un fichier de projet, pas seulement un dossier. Rechargez la fenêtre depuis la palette de commandes (Developer: Reload Window) ou cliquez sur l'entrée Spark dans la barre d'état (en bas à droite), qui fonctionne même sans fichier ouvert.

• Conflits d'extensions : Désactivez temporairement d'autres extensions IA (Cline, Continue, etc.) si Claude Code n'arrive pas à s'activer.

• Mode restreint : Claude Code ne fonctionne pas en mode restreint de VS Code. Marquez l'espace de travail comme approuvé.

• Verrouillage de fichiers Windows : Repliez le panneau Explorer et mettez en pause les débogueurs actifs avant les longues sessions multi-fichiers si des écritures échouent en cours de route.

• Conflit macOS Tahoe avec Cmd+Esc : La superposition de jeu système peut intercepter Cmd+Esc. Reconfigurez Claude Code: Focus input dans les raccourcis clavier de VS Code (Cmd+K Cmd+S) si le basculement de focus ne répond plus.

• Connexion Bedrock ou Vertex au lieu d'Anthropic : Vous pouvez pointer Claude Code vers des points de terminaison de fournisseurs cloud. Notre guide d'installation de modèles locaux et alternatifs décrit les parcours hors abonnement.

Anthropic maintient un guide de dépannage dédié si rien de tout cela ne résout votre problème.

Limitations et arbitrages

L'extension est un sous-ensemble du CLI. Comme vu dans la comparaison avec le terminal, l'autocomplétion par Tab, le raccourci ! pour bash et les workflows en pipes sont réservés au CLI, tout comme le mode dontAsk pour les pipelines CI.

La visibilité des tâches en arrière-plan est limitée ; pour tout ce que vous devez surveiller de près, le terminal intégré est plus transparent.

L'approbation se fait par fichier, pas par hunk : si Claude réussit une fonction et en rate une autre dans le même fichier, vous acceptez tout puis revenez manuellement sur ce que vous ne voulez pas.

Les limites d'usage sont la première frustration des utilisateurs Pro. Elles s'appliquent en fenêtres glissantes, non par message, et s'épuisent plus vite aux heures de pointe. Pour un usage ponctuel, Pro suffit ; pour une journée de travail, Max 5x ou Max 20x est plus réaliste. Évitez de vous fier aux estimations communautaires : Anthropic ne publie pas de chiffres exacts et ceux-ci évoluent.

Sous Windows, le verrouillage de fichiers entre l'explorateur de projet de VS Code et les écritures de Claude provoque davantage d'échecs que sous macOS ou Linux. Replier le panneau Explorer et mettre en pause les débogueurs actifs avant de grosses sessions multi-fichiers prévient généralement le problème.

Pour conclure

Claude Code dans VS Code est un agent de codage orienté tâches avec une interface qui privilégie la relecture. Le visualiseur de diff, le plan mode et les checkpoints existent parce qu'il est plus important de contrôler ce que l'agent a vraiment changé que d'obtenir un premier jet rapide.

Le workflow au terminal ne disparaît pas : pour les travaux scriptés, automatisés ou très CLI, c'est même la meilleure surface. Mais si vous faites un travail où vous souhaitez lire chaque changement proposé avant son atterrissage, l'éditeur est mieux adapté.

Claude Code évolue chaque semaine ; certaines parties de cet article vieilliront vite. Nos bonnes pratiques Claude Code et le guide Claude Code 2.1 sont de bonnes suites pour rester à jour. Le changelog officiel suit les sorties. Si quelque chose ne correspond pas à ce que vous voyez, commencez par là.

Si vous voulez vous entraîner de façon structurée avec les modèles Claude et des workflows d'agents, je vous recommande notre cours Introduction to Claude Models.