Claude Code dans VS Code : installation et intégration complète

Claude Code est l'agent CLI d'Anthropic conçu pour s'intégrer au cœur du workflow des développeurs. Associé à VS Code, l'éditeur de code le plus utilisé dans le monde, il devient un copilote IA capable de lire votre projet, proposer des modifications et les afficher sous forme de diffs directement dans l'éditeur. Ce guide couvre l'installation et l'intégration complète de vscode claude code en 2026, de la première commande npm jusqu'aux bonnes pratiques de productivité.

Prérequis avant de commencer

Avant d'installer Claude Code dans VS Code, vérifiez que votre environnement remplit ces conditions :

• Node.js 18 ou supérieur — Claude Code CLI s'installe via npm ; vérifiez votre version avec node --version
• VS Code 1.80 ou supérieur — pour bénéficier de toutes les fonctionnalités d'intégration et du diff inline
• Un compte Anthropic — avec une clé API valide, créée depuis console.anthropic.com
• Git installé et initialisé — Claude Code exploite l'historique Git pour comprendre le contexte de votre projet

Sur Windows, assurez-vous que npm est accessible dans votre PATH système. Si vous utilisez nvm ou nvm-windows pour gérer vos versions Node.js, activez d'abord la version souhaitée avant d'installer le CLI.

Installation de Claude Code CLI

Claude Code s'installe en une seule commande npm globale. Ouvrez un terminal — celui de VS Code fonctionne parfaitement — et exécutez :

npm install -g @anthropic-ai/claude-code

Une fois l'installation terminée, vérifiez que le CLI est bien disponible :

claude --version

Puis authentifiez-vous avec votre compte Anthropic. Cette commande ouvre un navigateur pour finaliser la connexion :

claude auth login

Vous pouvez aussi définir la variable d'environnement directement dans votre shell si vous préférez gérer la clé manuellement. Sur macOS et Linux, ajoutez cette ligne à votre .bashrc ou .zshrc :

export ANTHROPIC_API_KEY=sk-ant-api03-...

Sur Windows, définissez la variable dans les variables d'environnement système ou via PowerShell :

$env:ANTHROPIC_API_KEY = "sk-ant-api03-..."

Installer l'extension Claude Code pour VS Code

L'extension officielle claude code extension est publiée par Anthropic sur le Marketplace de VS Code. Elle ajoute un panneau latéral dédié, une intégration avec le diff viewer natif de VS Code, et des commandes accessibles depuis la palette.

Méthode 1 : via l'interface graphique

1. Dans VS Code, ouvrez l'onglet Extensions avec le raccourci Ctrl+Shift+X (Windows/Linux) ou Cmd+Shift+X (macOS)
2. Recherchez Claude Code dans la barre de recherche
3. Sélectionnez l'extension publiée par Anthropic et cliquez sur Installer
4. Rechargez VS Code lorsque l'invite apparaît

Méthode 2 : via la ligne de commande

Si vous gérez vos extensions VS Code en script ou en dotfiles, utilisez la commande code :

code --install-extension anthropic.claude-code

Après installation, une icône Claude apparaît dans la barre d'activité latérale gauche de VS Code. Cliquez dessus pour ouvrir le panneau principal de l'extension.

Configurer l'extension dans VS Code

Ouvrez les paramètres VS Code (Ctrl+, ou Cmd+,) et recherchez Claude Code. Les réglages essentiels :

• Clé API — si vous n'avez pas utilisé claude auth login, renseignez ici votre ANTHROPIC_API_KEY
• Modèle par défaut — Claude Sonnet 4.6 pour l'équilibre vitesse/qualité, Claude Opus 4.8 pour les tâches de raisonnement complexe
• Hériter les variables d'environnement — activez Terminal › Integrated: Inherit Env pour que le terminal intégré VS Code accède à votre variable ANTHROPIC_API_KEY définie dans le shell système

Utiliser Claude Code dans le terminal intégré VS Code

Le terminal intégré de VS Code est l'interface naturelle pour claude code vscode. Ouvrez-le avec Ctrl+` (Windows/Linux) ou Cmd+` (macOS), puis naviguez jusqu'au répertoire racine de votre projet si ce n'est pas déjà le cas.

Lancer une session interactive

Démarrez Claude Code en mode interactif depuis la racine de votre projet :

cd /chemin/vers/mon-projet
claude

Claude Code analyse immédiatement la structure du projet, les fichiers Git indexés et les fichiers ouverts dans VS Code. Vous pouvez ensuite lui parler en langage naturel :

> Explique ce que fait la fonction parseConfig dans src/config.ts
> Ajoute une validation des types pour tous les paramètres de getUserById
> Refactorise le module auth pour réduire les dépendances circulaires

Passer une instruction en une seule commande

Pour les opérations ponctuelles sans ouvrir de session interactive, passez l'instruction directement en argument :

claude "Génère des tests unitaires pour le fichier utils/formatter.ts"

Les diffs inline : contrôle total sur les modifications

L'un des atouts majeurs de l'intégration claude code vscode est l'affichage des modifications proposées directement dans le diff viewer natif de VS Code. Lorsque Claude Code propose de modifier un fichier, VS Code ouvre automatiquement la vue diff côte à côte : le fichier original à gauche, la version proposée à droite.

Vous gardez le contrôle total sur chaque modification :

• Accepter la modification pour l'appliquer au fichier source
• Refuser pour revenir à l'état original sans aucun changement
• Modifier manuellement la proposition avant de l'accepter

Ce workflow est particulièrement précieux pour les refactorisations importantes ou les migrations de code : vous voyez exactement ce que Claude Code va changer avant que quoi que ce soit ne soit écrit sur le disque.

Raccourcis clavier et commandes palette

L'extension claude code extension pour VS Code ajoute des commandes accessibles depuis la palette (Ctrl+Shift+P ou Cmd+Shift+P). Recherchez Claude dans la palette pour voir toutes les commandes disponibles :

• Claude Code: Open — ouvre le panneau latéral Claude Code
• Claude Code: Send Selection — envoie le code sélectionné dans l'éditeur à Claude Code
• Claude Code: New Session — démarre une nouvelle session en effaçant le contexte précédent

Pour assigner des raccourcis clavier personnalisés à ces commandes, ouvrez l'éditeur de raccourcis clavier via Ctrl+Shift+P → Préférences : Ouvrir les raccourcis clavier, puis recherchez claude. Vous pouvez lier n'importe quelle commande Claude Code à la combinaison de touches de votre choix.

Donner du contexte avec CLAUDE.md

Claude Code lit automatiquement le fichier CLAUDE.md placé à la racine de votre projet. C'est le mécanisme le plus efficace pour lui transmettre les conventions et contraintes de votre codebase, sans avoir à les répéter à chaque session.

Voici un exemple de CLAUDE.md pour un projet TypeScript/Node.js :

# Mon API REST

## Stack technique
- Node.js 20, TypeScript 5.4, Express 4.19
- Base de données : PostgreSQL avec Drizzle ORM
- Tests : Vitest + Supertest

## Conventions de code
- Pas de `any` TypeScript — utilise des types stricts
- Fonctions pures uniquement dans /src/utils
- Chaque nouvelle fonction publique doit avoir un test unitaire
- Nommage des routes : kebab-case, verbes HTTP explicites

## À ne jamais modifier
- Le fichier src/db/migrations/ — les migrations sont immuables
- Les variables d'environnement listées dans .env.example

Ce fichier est versionné avec le projet, ce qui permet à toute l'équipe de bénéficier du même contexte lors de l'utilisation de Claude Code.

Workflow recommandé : split view terminal + éditeur

Le workflow le plus productif dans VS Code consiste à utiliser la vue en split horizontal : le code source dans le panneau supérieur, le terminal Claude Code dans le panneau inférieur. Vous voyez les diffs apparaître dans l'éditeur en temps réel pendant que vous dialoguez avec l'agent dans le terminal.

Pour les tâches complexes — migration d'architecture, refactorisation multi-fichiers, ajout d'une fonctionnalité transversale — commencez toujours par demander un plan avant de demander du code :

> Décris étape par étape ce que tu vas modifier avant de toucher au code

Cette habitude évite les surprises et vous permet de corriger le cap avant que Claude Code n'applique des dizaines de modifications.

Dépannage des problèmes courants

La commande claude est introuvable dans le terminal VS Code

Si VS Code ne trouve pas la commande claude alors qu'elle fonctionne dans un terminal externe, c'est un problème de PATH. Vérifiez que l'option Terminal › Integrated: Inherit Env est activée dans les paramètres VS Code. Sur Windows, redémarrez VS Code complètement après avoir modifié les variables d'environnement système.

Erreur d'authentification au lancement

Si Claude Code renvoie une erreur d'authentification, relancez le processus de connexion :

claude auth logout
claude auth login

L'extension ne détecte pas le CLI installé

L'extension cherche le binaire claude dans le PATH. Si vous avez installé Node.js via nvm, assurez-vous que la version active au démarrage de VS Code est celle pour laquelle Claude Code est installé. Ajoutez l'initialisation de nvm à votre fichier de profil shell (.bashrc, .zshrc, ou équivalent PowerShell) pour que VS Code en hérite automatiquement.