Passer au contenu principal
Claude Code VS Code Extension Interface

Extension VS Code (Bêta)

L’extension VS Code, disponible en bêta, vous permet de voir les modifications de Claude en temps réel via une interface graphique native intégrée directement dans votre IDE. L’extension VS Code facilite l’accès et l’interaction avec Claude Code pour les utilisateurs qui préfèrent une interface visuelle au terminal.

Fonctionnalités

L’extension VS Code fournit :
  • Expérience IDE native : Panneau latéral Claude Code dédié accessible via l’icône Spark
  • Mode plan avec édition : Examinez et modifiez les plans de Claude avant de les accepter
  • Mode d’acceptation automatique des modifications : Appliquez automatiquement les modifications de Claude au fur et à mesure qu’elles sont effectuées
  • Gestion des fichiers : Mentionnez les fichiers avec @ ou attachez des fichiers et des images à l’aide du sélecteur de fichiers système
  • Utilisation du serveur MCP : Utilisez les serveurs Model Context Protocol configurés via la CLI
  • Historique des conversations : Accès facile aux conversations précédentes
  • Plusieurs sessions : Exécutez plusieurs sessions Claude Code simultanément
  • Raccourcis clavier : Support de la plupart des raccourcis de la CLI
  • Commandes slash : Accédez à la plupart des commandes slash CLI directement dans l’extension

Exigences

  • VS Code 1.98.0 ou supérieur

Installation

Téléchargez et installez l’extension depuis la Place de marché des extensions Visual Studio Code.

Fonctionnement

Une fois installée, vous pouvez commencer à utiliser Claude Code via l’interface VS Code :
  1. Cliquez sur l’icône Spark dans la barre latérale de votre éditeur pour ouvrir le panneau Claude Code
  2. Invitez Claude Code de la même manière que vous le feriez dans le terminal
  3. Regardez Claude analyser votre code et suggérer des modifications
  4. Examinez et acceptez les modifications directement dans l’interface
    • Conseil : Faites glisser la barre latérale plus largement pour voir les diffs en ligne, puis cliquez dessus pour les développer et voir les détails complets

Utilisation de fournisseurs tiers (Vertex et Bedrock)

L’extension VS Code prend en charge l’utilisation de Claude Code avec des fournisseurs tiers comme Amazon Bedrock et Google Vertex AI. Lorsqu’elle est configurée avec ces fournisseurs, l’extension ne vous demandera pas de vous connecter. Pour utiliser des fournisseurs tiers, configurez les variables d’environnement dans les paramètres de l’extension VS Code :
  1. Ouvrez les paramètres VS Code
  2. Recherchez « Claude Code: Environment Variables »
  3. Ajoutez les variables d’environnement requises

Variables d’environnement

VariableDescriptionRequisExemple
CLAUDE_CODE_USE_BEDROCKActiver l’intégration Amazon BedrockRequis pour Bedrock"1" ou "true"
CLAUDE_CODE_USE_VERTEXActiver l’intégration Google Vertex AIRequis pour Vertex AI"1" ou "true"
ANTHROPIC_API_KEYClé API pour l’accès tiersRequis"your-api-key"
AWS_REGIONRégion AWS pour Bedrock"us-east-2"
AWS_PROFILEProfil AWS pour l’authentification Bedrock"your-profile"
CLOUD_ML_REGIONRégion pour Vertex AI"global" ou "us-east5"
ANTHROPIC_VERTEX_PROJECT_IDID de projet GCP pour Vertex AI"your-project-id"
ANTHROPIC_MODELRemplacer le modèle principalID de modèle de remplacement"us.anthropic.claude-sonnet-4-5-20250929-v1:0"
ANTHROPIC_SMALL_FAST_MODELRemplacer le modèle petit/rapideOptionnel"us.anthropic.claude-3-5-haiku-20241022-v1:0"
CLAUDE_CODE_SKIP_AUTH_LOGINDésactiver toutes les invites de connexionOptionnel"1" ou "true"
Pour des instructions de configuration détaillées et des options de configuration supplémentaires, consultez :

Pas encore implémenté

Les fonctionnalités suivantes ne sont pas encore disponibles dans l’extension VS Code :
  • Configuration complète du serveur MCP : Vous devez d’abord configurer les serveurs MCP via la CLI, puis l’extension les utilisera
  • Configuration des sous-agents : Configurez les sous-agents via la CLI pour les utiliser dans VS Code
  • Points de contrôle : Enregistrez et restaurez l’état de la conversation à des points spécifiques
  • Raccourcis avancés :
    • Raccourci # pour ajouter à la mémoire
    • Raccourci ! pour exécuter les commandes bash directement
  • Complément de tabulation : Complément du chemin de fichier avec la touche de tabulation
Nous travaillons à l’ajout de ces fonctionnalités dans les futures mises à jour.

Considérations de sécurité

Lorsque Claude Code s’exécute dans VS Code avec les autorisations d’édition automatique activées, il peut être en mesure de modifier les fichiers de configuration de l’IDE qui peuvent être exécutés automatiquement par votre IDE. Cela peut augmenter le risque d’exécution de Claude Code en mode d’édition automatique et permettre de contourner les invites d’autorisation de Claude Code pour l’exécution bash. Lors de l’exécution dans VS Code, considérez :
  • L’activation du Mode restreint VS Code pour les espaces de travail non fiables
  • L’utilisation du mode d’approbation manuelle pour les modifications
  • La prise de précautions supplémentaires pour s’assurer que Claude n’est utilisé qu’avec des invites de confiance

Intégration CLI héritée

La première intégration VS Code que nous avons publiée permet à Claude Code s’exécutant dans le terminal d’interagir avec votre IDE. Elle fournit le partage du contexte de sélection (la sélection/l’onglet actuel est automatiquement partagé avec Claude Code), la visualisation des diffs dans l’IDE au lieu du terminal, les raccourcis de référence de fichier (Cmd+Option+K sur Mac ou Alt+Ctrl+K sur Windows/Linux pour insérer des références de fichier comme @File#L1-99), et le partage automatique des diagnostics (erreurs de lint et de syntaxe). L’intégration héritée s’installe automatiquement lorsque vous exécutez claude à partir du terminal intégré de VS Code. Exécutez simplement claude à partir du terminal et toutes les fonctionnalités s’activent. Pour les terminaux externes, utilisez la commande /ide pour connecter Claude Code à votre instance VS Code. Pour configurer, exécutez claude, entrez /config, et définissez l’outil diff sur auto pour la détection automatique de l’IDE. L’extension et l’intégration CLI fonctionnent toutes deux avec Visual Studio Code, Cursor, Windsurf et VSCodium.

Dépannage

L’extension ne s’installe pas

  • Assurez-vous que vous disposez d’une version compatible de VS Code (1.85.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 place de marché

L’intégration héritée ne fonctionne pas

  • Assurez-vous que vous exécutez Claude Code à partir du terminal intégré de VS Code
  • Assurez-vous que la CLI pour votre variante d’IDE est installée :
    • VS Code : la commande code doit être disponible
    • Cursor : la commande cursor doit être disponible
    • Windsurf : la commande windsurf doit être disponible
    • VSCodium : la commande codium doit être disponible
  • Si la commande n’est pas installée :
    1. Ouvrez la palette de commandes avec Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux)
    2. Recherchez « Shell Command: Install ‘code’ command in PATH » (ou l’équivalent pour votre IDE)
Pour une aide supplémentaire, consultez notre guide de dépannage.