Utiliser Claude Code dans VS Code

• Examiner et modifier les plans de Claude avant de les accepter
• Accepter automatiquement les modifications au fur et à mesure qu’elles sont apportées
• Mentionner avec @ des fichiers avec des plages de lignes spécifiques à partir de votre sélection
• Accéder à l’historique des conversations
• Ouvrir plusieurs conversations dans des onglets ou des fenêtres séparés

​

Prérequis

• VS Code 1.94.0 ou supérieur
• Un compte Anthropic : tout abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console fonctionne, et aucune clé API n’est requise. Vous vous connecterez avec ce compte lors de la première ouverture de l’extension. Si vous accédez à Claude par l’intermédiaire d’un fournisseur tiers comme Amazon Bedrock ou Google Cloud’s Agent Platform, consultez Utiliser des fournisseurs tiers pour les instructions de configuration.

​

Installer l’extension

• Installer pour VS Code
• Installer pour Cursor

• Autres forks de VS Code : l’extension s’installe aussi dans des forks comme Devin Desktop ou Kiro. Recherchez « Claude Code » dans la vue Extensions de l’éditeur, ou installez-la depuis le registre Open VSX.
• Éditeurs qui ne peuvent pas installer l’extension : installez la CLI et exécutez plutôt claude dans le terminal intégré de l’éditeur. La CLI fonctionne dans n’importe quel terminal.
• Dev containers : pour exécuter Claude Code dans un dev container, consultez Conteneurs de développement.

​

Démarrer

1

Ouvrir le panneau Claude Code

Dans tout VS Code, l’icône Spark désigne 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 lorsqu’un fichier est ouvert.Autres façons d’ouvrir Claude Code :

• Barre d’activité : cliquez sur l’icône Spark dans la barre latérale gauche pour ouvrir la liste des sessions. Cliquez sur une session pour l’ouvrir à votre emplacement préféré, ou démarrez-en une nouvelle. Cette icône est toujours visible dans la barre d’activité.
• Palette de commandes : Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), tapez « Claude Code » et sélectionnez une option comme « Open in New Tab »
• Barre d’état : cliquez sur ✻ Claude Code dans le coin inférieur droit de la fenêtre. Cela fonctionne même lorsqu’aucun fichier n’est ouvert.

Vous pouvez faire glisser le panneau Claude pour le repositionner n’importe où dans VS Code. Consultez Personnaliser votre workflow pour plus de détails.

2

Se connecter

La première fois que vous ouvrez le panneau, un écran de connexion apparaît. Cliquez sur Sign in et terminez l’autorisation dans votre navigateur.Si vous voyez plus tard Not logged in · Please run /login, l’extension rouvre automatiquement l’écran de connexion. S’il n’apparaît pas, rechargez la fenêtre depuis la palette de commandes avec Developer: Reload Window.Si vous avez défini ANTHROPIC_API_KEY dans votre shell mais que la demande de connexion s’affiche toujours, il se peut que VS Code n’ait pas hérité de l’environnement de votre shell. Lancez VS Code depuis un terminal avec code . afin qu’il hérite de vos variables d’environnement, ou connectez-vous plutôt avec votre compte Claude.Une fois connecté, une checklist Learn Claude Code apparaît. Parcourez chaque élément en cliquant sur Show me, ou fermez-la avec le X. Pour la rouvrir plus tard, décochez Hide Onboarding dans les paramètres de VS Code sous Extensions > Claude Code.

3

Envoyer un prompt

Demandez à Claude de vous aider avec votre code ou vos fichiers, qu’il s’agisse d’expliquer le fonctionnement de quelque chose, de déboguer un problème ou d’apporter des modifications.

Claude voit automatiquement le texte que vous avez sélectionné. Appuyez sur Option+K (Mac) / Alt+K (Windows/Linux) pour également insérer une référence @-mention (comme @file.ts#5-10) dans votre prompt.

Voici un exemple de question portant sur une ligne précise d’un fichier :

4

Examiner les modifications

Vérifiez le mode de permission affiché en bas de la zone de prompt :

• En mode Auto ou Edit automatically, Claude modifie la plupart des fichiers de votre espace de travail sans demander.
• En mode Manual, lorsque Claude souhaite modifier un fichier, il affiche une comparaison côte à côte de l’original et des modifications proposées, puis demande la permission. Vous pouvez accepter, refuser ou indiquer à Claude quoi faire à la place. Si vous modifiez directement le contenu proposé dans la vue diff avant d’accepter, Claude en est informé afin qu’il ne suppose pas que le fichier correspond à sa proposition d’origine.

Pour examiner une modification proposée un changement à la fois, utilisez les boutons Accept this change et Reject this change sous chaque changement dans le diff. Refuser un changement l’annule dans le contenu proposé ; l’accepter le marque comme examiné. L’examen changement par changement nécessite Claude Code v2.1.275 ou une version ultérieure.Accepter ou refuser le fichier entier termine toujours l’examen. Un diff comportant plus de 100 changements s’ouvre sans les boutons par changement ; examinez-le donc comme un fichier entier.Les mêmes actions sont disponibles à l’emplacement du curseur depuis le menu contextuel de l’éditeur et depuis la palette de commandes sous les noms Claude Code: Accept Change at Cursor et Claude Code: Reject Change at Cursor.

​

Utiliser la zone de prompt

• Modes de permission : cliquez sur l’indicateur de mode en bas de la zone de prompt pour changer de mode de permission. Avec Claude Code v2.1.283 ou version ultérieure, Auto est le mode de permission de départ intégré ; sur les versions antérieures, il ne l’est que sur les forfaits Pro, Max et Team. Consultez comment l’extension choisit le mode de permission de départ pour savoir ce qui le modifie, ainsi que chaque mode de permission proposé par l’indicateur.
  • Auto : un classifieur examine la plupart des actions au lieu de vous demander. Consultez mode auto pour savoir ce qu’il examine et bloque.
  • Manual : Claude demande la permission avant les modifications de fichiers et la plupart des commandes shell.
  • Plan : Claude décrit ce qu’il va faire et attend votre approbation avant d’effectuer des modifications. VS Code ouvre automatiquement le plan sous forme de document Markdown complet dans lequel vous pouvez ajouter des commentaires en ligne pour donner votre avis avant que Claude ne commence. Vous pouvez également taper /plan dans la zone de prompt. Nécessite Claude Code v2.1.280 ou version ultérieure.
    • /plan : passe en mode plan. Si vous êtes déjà en mode plan, affiche plutôt le plan actuel.
    • /plan suivi d’une tâche, comme /plan fix the auth bug : passe en mode plan et commence à planifier cette tâche.
    • /plan open : lorsque vous êtes déjà en mode plan, ouvre le fichier du plan dans l’éditeur.
  • Edit automatically : Claude effectue les modifications sans demander.
• Modèle : sélectionnez Switch model… dans le menu des commandes pour changer de modèle en cours de session. Vous pouvez aussi cliquer sur le nom du modèle en bas de la zone de prompt pour ouvrir le même sélecteur. Avec Claude Code v2.1.284 ou version ultérieure, taper /model seul dans la zone de prompt ouvre également le sélecteur. Lorsque le modèle actuel prend en charge les niveaux d’effort, le sélecteur affiche aussi une ligne Effort et le bouton du nom du modèle indique le niveau sélectionné. Lorsque vous choisissez un niveau autre que max, Claude Code l’enregistre comme valeur par défaut pour le modèle actuel, sous modelSettings dans vos paramètres utilisateur ; max s’applique uniquement à la session en cours. Le bouton du nom du modèle et la ligne Effort nécessitent Claude Code v2.1.257 ou version ultérieure. Lorsque les workflows dynamiques sont activés et que le modèle actuel les prend en charge, un interrupteur Ultracode apparaît sous la ligne Effort. Activez-le pour que Claude planifie un workflow pour chaque tâche substantielle de cette session, au niveau d’effort sélectionné. Tant qu’il est activé, le bouton du nom du modèle affiche · Ultracode après le niveau. L’interrupteur nécessite Claude Code v2.1.284 ou version ultérieure.
• Menu des commandes : cliquez sur / ou tapez / pour ouvrir le menu des commandes. Les options incluent l’ajout de fichiers en pièce jointe, le changement de modèle et l’activation ou la désactivation de la réflexion étendue. La section Customize comprend des entrées telles que les serveurs MCP, les commandes, les styles de sortie, les hooks, la mémoire, les instructions, les permissions et les plugins. Les éléments accompagnés d’une icône de terminal s’ouvrent dans le terminal intégré.
  • Pour parcourir des commandes comme /usage ou /remote-control, sélectionnez Slash commands dans la section Customize. Une boîte de dialogue les répertorie avec un champ de filtre. Choisissez-en une pour l’exécuter. Taper / dans la zone de prompt continue de suggérer des commandes en ligne. Nécessite Claude Code v2.1.257 ou version ultérieure. Taper /skills ouvre également cette boîte de dialogue. Chaque ligne de skill affiche sa visibilité, comme On ou Name only. Cliquez sur la visibilité pour la modifier, sauf sur les lignes marquées locked, comme les skills de plugins. Le raccourci /skills et les contrôles de visibilité nécessitent Claude Code v2.1.280 ou version ultérieure.
  • Sélectionnez Output styles dans la section Customize pour choisir un style de sortie, y compris vos styles personnalisés. Nécessite Claude Code v2.1.257 ou version ultérieure. Pour créer plutôt un style personnalisé, sélectionnez Build a custom style dans le menu Output styles. Claude Code rédige pour vous le fichier de style au niveau du projet ou de l’utilisateur. Nécessite Claude Code v2.1.261 ou version ultérieure.
  • Sélectionnez Hooks dans la section Customize pour afficher les hooks chargés dans la session, regroupés par événement. Vous pouvez ajouter, modifier ou supprimer les hooks enregistrés dans vos fichiers de paramètres utilisateur, projet et locaux. Les hooks provenant d’autres sources, comme les paramètres gérés ou les plugins, sont en lecture seule. Nécessite Claude Code v2.1.269 ou version ultérieure.
  • Sélectionnez Permissions dans la section Customize pour afficher les règles de permission de la session, regroupées en Allow, Ask et Deny. Vous pouvez ajouter des règles à vos paramètres utilisateur, projet ou locaux, et supprimer les règles qui y sont enregistrées. Les règles provenant d’autres sources, comme les paramètres gérés ou les approbations accordées pour cette session uniquement, sont en lecture seule. Nécessite Claude Code v2.1.269 ou version ultérieure.
  • Sélectionnez Memory dans la section Customize pour activer ou désactiver la mémoire automatique. Lorsqu’elle est activée, vous pouvez également parcourir les souvenirs que Claude a enregistrés et afficher dans votre gestionnaire de fichiers les dossiers qui les contiennent. Nécessite Claude Code v2.1.274 ou version ultérieure. Cliquez sur un souvenir enregistré pour le lire dans la boîte de dialogue, où vous pouvez modifier le texte, supprimer le souvenir ou ouvrir son fichier dans l’éditeur. L’affichage, la modification et la suppression d’un souvenir dans la boîte de dialogue nécessitent Claude Code v2.1.275 ou version ultérieure.
  • Sélectionnez Instructions dans la section Customize pour modifier les fichiers CLAUDE.md que Claude lit. Choisissez un fichier pour l’ouvrir dans l’éditeur. Si le fichier n’existe pas encore, Claude Code le crée d’abord. Nécessite Claude Code v2.1.274 ou version ultérieure.
  • Sélectionnez Status dans la section Customize, ou tapez /status, pour consulter la version de Claude Code, le compte, le modèle et les détails des serveurs MCP de la session. Nécessite Claude Code v2.1.280 ou version ultérieure.
  • Sélectionnez Sandbox dans la section Customize, ou tapez /sandbox, pour voir si les commandes Bash de Claude s’exécutent dans un sandbox. Vous pouvez y changer le mode du sandbox et ajouter des commandes exclues. Nécessite Claude Code v2.1.280 ou version ultérieure.
  • Sélectionnez Claude in Chrome dans la section Customize, ou tapez /chrome, pour vérifier et gérer la connexion Claude in Chrome. Les deux nécessitent une connexion avec un compte claude.ai. Nécessite Claude Code v2.1.280 ou version ultérieure.
  • Sélectionnez Export conversation dans la section Context, ou tapez /export, pour copier la conversation en texte brut ou l’enregistrer dans un fichier. Ajoutez un nom de fichier, comme /export notes.txt, pour ignorer la boîte de dialogue et choisir où enregistrer le fichier. Nécessite Claude Code v2.1.280 ou version ultérieure.
  • La section Settings comprend Enable Remote Control for all sessions, qui définit remoteControlAtStartup pour contrôler si les nouvelles sessions interactives se connectent automatiquement à Remote Control. Nécessite Claude Code v2.1.203 ou version ultérieure. Lorsque vous activez ou désactivez cette option dans une fenêtre VS Code, le changement ne se limite pas aux sessions que vous démarrez ensuite. Il s’applique aussi aux sessions déjà ouvertes dans cette fenêtre VS Code. Si vous la désactivez, les sessions ouvertes se déconnectent. Avec Claude Code v2.1.261 ou version ultérieure, le changement atteint également les sessions ouvertes dans vos autres fenêtres VS Code.
  • La section Settings comprend également Focus view, qui masque les appels d’outils, les résultats d’outils et la réflexion derrière des lignes dépliables, ne laissant que vos prompts et les réponses de Claude. Activez-la à cet endroit, avec Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), ou depuis la palette de commandes avec Claude Code: Toggle Focus view. Le changement s’applique à toutes les sessions ouvertes et persiste d’une session à l’autre. Nécessite Claude Code v2.1.221 ou version ultérieure. La dernière liste de tâches de Claude reste visible, de même que le texte sur lequel porte une question en attente de Claude ; cela nécessite Claude Code v2.1.225 ou version ultérieure. Pendant que Claude exécute des sous-agents, des lignes de progression en direct indiquant leur dernière activité apparaissent sous le groupe d’appels d’outils qui les a lancés. Cela nécessite Claude Code v2.1.269 ou version ultérieure.
  • Pour vous déconnecter de votre compte Anthropic, sélectionnez Sign out dans la section Settings, ou tapez /logout. Avec un fournisseur tiers, le menu ne propose ni l’un ni l’autre. Nécessite Claude Code v2.1.277 ou version ultérieure.
  • Pour signaler un bug, cliquez sur Report a problem en bas du menu, ou tapez /bug ou /feedback suivi éventuellement d’une description qui pré-remplit le rapport. Lorsque vous soumettez le rapport et que vous êtes connecté à Anthropic via une connexion first-party, Claude Code l’envoie à Anthropic. Nécessite Claude Code v2.1.229 ou version ultérieure. Avec un fournisseur tiers, ou sans identifiants Anthropic, rien n’est envoyé. La boîte de dialogue vous l’indique avant que vous ne rédigiez. La soumission enregistre le rapport sous forme d’archive locale dans ~/.claude/feedback-bundles/, avec les motifs connus de clés API et de tokens masqués. L’enregistrement du rapport sur votre ordinateur nécessite Claude Code v2.1.284 ou version ultérieure. Une fois le rapport enregistré, la confirmation indique le nom du fichier et inclut un bouton Show folder. Envoyez ce fichier à votre représentant de compte Anthropic ou joignez-le à une demande d’assistance. Si la politique de votre organisation désactive les retours sur le produit, Report a problem n’apparaît pas dans le menu, et /bug et /feedback affichent l’avis Feedback is turned off by your organization's policy or this environment's settings. au lieu d’ouvrir le rapport. Avec Claude Code v2.1.284 ou version ultérieure, si vous définissez la variable d’environnement DISABLE_FEEDBACK_COMMAND ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, les retours sont également désactivés et l’ouverture du rapport affiche cet avis à la place.
• Questions annexes : tapez /btw suivi d’une question pour poser une question sur votre session sans l’ajouter à la conversation. La réponse s’ouvre dans un panneau à côté du chat, où vous pouvez poser des questions complémentaires. Nécessite Claude Code v2.1.227 ou version ultérieure. Le fil survit aux rechargements de la fenêtre. Claude Code conserve les 20 échanges les plus récents et fait expirer les fils stockés selon le calendrier de cleanupPeriodDays, à condition que Claude Code puisse déterminer la période de rétention en toute sécurité. Pour effacer un fil, cliquez sur l’icône de corbeille dans le panneau.
• Copier une réponse : survolez une réponse et cliquez sur Copy response pour la copier dans votre presse-papiers, ou tapez /copy pour copier la dernière réponse. /copy 2 copie l’avant-dernière. Nécessite Claude Code v2.1.277 ou version ultérieure.
• Favoris : survolez une réponse et cliquez sur Bookmark response pour l’enregistrer, ou cliquez sur Remove bookmark sur une réponse enregistrée pour la retirer. Pour consulter les réponses enregistrées, ouvrez le panneau Bookmarks. Vous pouvez cliquer sur l’icône de favori en haut du panneau Claude Code, sélectionner Bookmarks dans la section Context du menu des commandes, ou taper /bookmarks. Nécessite Claude Code v2.1.286 ou version ultérieure.
• Fichiers que Claude vous envoie : lorsque la session est connectée à Remote Control et que Claude vous envoie des fichiers avec l’outil SendUserFile, la conversation affiche une ligne comme Sent report.md, chart.png. Cliquez sur le nom d’un fichier pour l’ouvrir dans l’éditeur.
• Indicateur de contexte : la zone de prompt indique quelle part de la fenêtre de contexte de Claude vous utilisez. Claude effectue automatiquement une compaction si nécessaire, ou vous pouvez exécuter /compact manuellement.
• Horloge du cache de prompt : une icône d’horloge à côté de l’indicateur de contexte estime le temps restant avant l’expiration du cache de prompt de la conversation. Elle décompte à partir de la durée de vie de cinq minutes ou d’une heure du cache, et chaque réponse qui utilise le cache relance le décompte. En dehors de la compaction, les actions qui invalident le cache ne réinitialisent pas l’horloge, qui peut donc encore afficher des minutes restantes après un changement de modèle.
  • Jusqu’à la fin du décompte, l’icône affiche les minutes restantes, par exemple 12m.
  • Lorsque le décompte est écoulé, les minutes disparaissent et l’icône devient rouge, ou prend la couleur d’erreur de votre thème, jusqu’à la réponse suivante. Le cache a probablement expiré : attendez-vous donc à une réponse plus lente et plus coûteuse à votre prochain message, le temps que le cache se reconstruise. Si la durée de vie de cinq minutes expire régulièrement entre vos messages, consultez Choisir vous-même le TTL.
  • Juste après la compaction de la conversation, l’icône devient également rouge, sans minutes, jusqu’à la réponse suivante, car le cache ne couvre pas encore la conversation compactée.
• Carte des agents : lorsque la conversation inclut des sous-agents, un nombre d’agents tel que 2 agents apparaît en bas de la zone de prompt. Son point indique si un sous-agent est en cours d’exécution ou attend votre permission. Cliquez sur le nombre d’agents pour ouvrir la carte des agents, qui représente les sous-agents de la conversation sous forme d’arbre sous l’agent principal, chacun avec son statut, son temps écoulé et son nombre de tokens. Cliquez sur un sous-agent pour voir son prompt et ses appels d’outils, ouvrir sa transcription en lecture seule, ou l’arrêter pendant son exécution. Nécessite Claude Code v2.1.269 ou version ultérieure. La carte répertorie également, sous les agents, les autres tâches en arrière-plan de la session, comme les commandes shell en arrière-plan et les moniteurs. Cliquez sur une ligne pour ouvrir la fiche de la tâche et l’y arrêter. Pour ouvrir la carte lorsqu’aucun nombre d’agents n’est affiché, par exemple lorsque Claude a lancé un shell en arrière-plan mais aucun sous-agent, tapez /tasks dans la zone de prompt. Les tâches en arrière-plan dans la carte et la saisie de /tasks nécessitent Claude Code v2.1.277 ou version ultérieure. Avec Claude Code v2.1.286 ou version ultérieure, lorsque vous cliquez sur Stop ou appuyez sur Esc, le tour en cours se termine. Les agents en arrière-plan continuent de s’exécuter jusqu’à ce qu’ils aient terminé ou que vous les arrêtiez depuis la carte.
• Réflexion étendue : permet à Claude de consacrer plus de temps au raisonnement sur des problèmes complexes. Activez-la via le menu des commandes (/). Le raisonnement de Claude apparaît dans la conversation sous forme de blocs repliés : cliquez sur un bloc pour le lire, ou appuyez sur Ctrl+O pour déplier ou replier tous les blocs de réflexion de la session. Consultez Réflexion étendue pour plus de détails.
• Saisie multiligne : appuyez sur Shift+Enter pour ajouter une nouvelle ligne sans envoyer. Cela fonctionne aussi dans le champ de texte libre « Other » des boîtes de dialogue de questions.

​

Référencer des fichiers et des dossiers

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

• Lorsque le fichier se trouve dans votre espace de travail et correspond à vos paramètres files.exclude ou search.exclude, Claude reçoit au plus le chemin du fichier, et non le texte que vous avez sélectionné.
• Il en va de même pour un fichier ignoré par git, à condition que le paramètre search.useIgnoreFiles de VS Code et le paramètre respectGitIgnore de l’extension soient tous deux activés, ce qui est le cas par défaut.

• Pour joindre une image, collez-la depuis votre presse-papiers dans la zone de prompt.
• Pour joindre des fichiers, maintenez Shift enfoncé tout en les faisant glisser dans la zone de prompt.
• Pour retirer une pièce jointe du contexte, cliquez sur le X qui l’accompagne.

​

Inclure la sortie du terminal dans les prompts

​

Coller du texte

• Si un avis comme Removed 3 invisible characters from the pasted text apparaît lorsque vous collez, le texte a été inséré sans ces caractères.
• Si un avis concernant des caractères supprimés apparaît lorsque vous envoyez, rien n’a été envoyé. Le texte nettoyé est de retour dans la zone de prompt. Envoyez à nouveau pour envoyer le texte tel qu’il est affiché.

​

Mathématiques LaTeX dans les réponses

• Mathématiques en mode display : un bloc $$ … $$ ou \[ … \] occupant une ou plusieurs lignes à part entière, ainsi qu’un bloc de code délimité dont le langage est math
• Mathématiques en ligne : $…$ ou \(…\) qui s’ouvre et se ferme sur la même ligne, comme $E = mc^2$ ou \(a^2 + b^2 = c^2\)

​

Reprendre des conversations passées

• Titres des sessions : les nouvelles sessions reçoivent des titres générés par l’IA à partir de votre premier message.
• Renommer et archiver : survolez une session pour afficher ces actions. Renommez-la pour lui donner un titre descriptif, ou archivez-la pour la déplacer dans le groupe Archived sessions en bas de la liste.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• Une session : dépliez Archived sessions et cliquez sur Unarchive session.
• Toutes les sessions archivées à la fois : survolez l’en-tête Archived sessions dans la liste des sessions de la barre d’activité et cliquez sur son icône de désarchivage. Nécessite Claude Code v2.1.277 ou version ultérieure.

• L’extension choisit le mode de permission de départ à partir de claudeCode.initialPermissionMode ou d’un choix reporté d’une conversation précédente
• Vous avez configuré claudeCode.claudeProcessWrapper
• Une règle deny supprime l’outil ExitPlanMode

​

Reprendre des sessions cloud depuis claude.ai

​

Consulter le compte et l’utilisation

• Forfait claude.ai : des barres d’utilisation pour les limites de votre forfait, comme la session en cours et la semaine. Chaque barre indique le temps restant avant la réinitialisation de sa limite. La boîte de dialogue détaille également ce qui contribue aux limites de votre forfait. Elle signale les comportements qui représentent 10 % ou plus de l’utilisation récente, comme les échecs de cache, les contextes longs et les sessions faisant un usage intensif de sous-agents ou fortement parallélisées. Chaque comportement signalé s’accompagne d’un conseil pour le réduire. Des tableaux d’attribution indiquent la part d’utilisation provenant de chaque skill, sous-agent, plugin et serveur MCP. Utilisez le sélecteur Day et Week pour basculer entre les dernières 24 heures et les 7 derniers jours. Les chiffres sont approximatifs et calculés à partir des sessions locales sur cette machine ; l’utilisation depuis d’autres appareils ou depuis claude.ai n’est donc pas incluse.
• Autres connexions : lorsque les limites de forfait ne s’appliquent pas à votre connexion, par exemple avec un fournisseur tiers ou une clé API, la section Usage affiche à la place le coût et l’utilisation de tokens propres à la session. La commande /usage de la CLI affiche les mêmes totaux dans son bloc Session. La liste des sessions dans la barre d’activité affiche également les totaux de la session active sous son en-tête Account & usage. Nécessite Claude Code v2.1.277 ou version ultérieure.

​

Revenir en arrière avec les checkpoints

• Fork conversation from here : démarre une nouvelle branche de conversation à partir de ce message tout en conservant toutes les modifications du code
• Rewind code to here : annule les modifications de fichiers jusqu’à ce point de la conversation tout en conservant l’historique complet de la conversation
• Fork conversation and rewind code : démarre une nouvelle branche de conversation et annule les modifications de fichiers jusqu’à ce point

​

Personnaliser votre workflow

​

Choisir l’emplacement de Claude

• Barre latérale secondaire : le côté droit de la fenêtre. Garde Claude visible pendant que vous codez.
• Barre latérale principale : la barre latérale gauche avec les icônes de l’Explorateur, de la Recherche, etc.
• Zone d’édition : ouvre Claude dans un onglet à côté de vos fichiers. Pratique pour les tâches annexes.

​

Reprendre les conversations après un rechargement

• Onglet d’éditeur : la conversation revient avec son onglet.
• Barre latérale : la conversation revient si vous y avez envoyé un message ou si Claude y a répondu au cours des 10 dernières minutes. Si elle ne revient pas, reprenez la conversation depuis l’historique des sessions.

​

Étapes interrompues après un rechargement

​

Désactiver la reprise après un rechargement

​

Une conversation n’a pas été rouverte

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• Pour l’ouvrir quand même : cliquez sur Open it anyway ou sélectionnez la conversation dans l’historique des sessions. Si elle s’ouvre et que le panneau continue de fonctionner, elle revient normalement lors des rechargements suivants. Si le panneau cesse à nouveau de répondre, rechargez la fenêtre pour revenir à un nouveau chat avec la notification.
• Pour la laisser fermée : continuez à travailler dans le nouveau chat. La notification disparaît dès que vous envoyez un prompt.

​

Exécuter plusieurs conversations

​

Organiser les sessions en groupes

• Regrouper ou dégrouper une session : faites un clic droit sur une session pour créer un groupe à partir de celle-ci, la déplacer dans un groupe existant ou la retirer de son groupe. Chaque session n’appartient qu’à un seul groupe à la fois ; la déplacer dans un autre groupe la retire donc du premier.
• Déplacer plusieurs sessions à la fois : faites Cmd-clic (Mac) / Ctrl-clic (Windows/Linux) sur chaque session, ou Shift-clic pour sélectionner une plage, puis faites un clic droit sur la sélection.
• Regrouper une session depuis son onglet : exécutez Claude Code: Add Session Tab to Group depuis la palette de commandes, puis choisissez ou créez un groupe. Nécessite Claude Code v2.1.257 ou une version ultérieure.
• Renommer ou supprimer un groupe : faites un clic droit sur l’en-tête d’un groupe. La suppression d’un groupe ne supprime que le groupe, et ses sessions retournent dans la liste des sessions non groupées.

​

Filtrer la liste des sessions

• Active : activez ce bouton pour n’afficher que les sessions qui attendent votre intervention, sont en cours ou non lues, ainsi que la session de l’onglet Claude qui a eu le focus en dernier.
• Filtrer par état : cliquez sur l’icône en forme d’entonnoir, puis cochez Needs input, Working ou Completed pour afficher les sessions dans l’un de ces états. Cochez Open ou Closed pour filtrer selon qu’une session est ouverte ou non. Une session est considérée comme ouverte lorsqu’elle possède un onglet dans cette fenêtre ou qu’elle s’exécute dans un autre processus Claude Code sur cette machine, par exemple dans un terminal.

​

Passer en mode terminal

​

Gérer les plugins

​

Installer des plugins

• Les plugins installés apparaissent en haut avec des interrupteurs pour les activer ou les désactiver.
  • Si vous désactivez un plugin que le fichier partagé .claude/settings.json de votre projet active, l’extension vous demande d’abord : Disable for me le désactive uniquement pour vous, tandis que Disable for everyone modifie le fichier partagé.
  • Un plugin qui n’a pas pu se charger affiche une brève raison sur sa ligne. Cliquez sur la raison pour voir ce que vous pouvez faire, notamment copier le message d’erreur complet afin de le rechercher dans Dépannage des plugins.
• Les plugins disponibles dans vos marketplaces configurées apparaissent en dessous
• Effectuez une recherche pour filtrer les plugins par nom ou par description
• Cliquez sur Install sur n’importe quel plugin disponible

• Install for you : disponible dans tous vos projets (portée utilisateur)
• Install for this project : partagé avec les collaborateurs du projet (portée projet)
• Install locally : uniquement pour vous, uniquement dans ce dépôt (portée locale)

​

Désinstaller des plugins

• Un plugin que le fichier partagé .claude/settings.json de votre projet active : choisissez Disable for me, qui conserve le plugin installé pour vos collaborateurs, ou Uninstall for everyone, qui supprime l’installation du projet avec --keep-data, de sorte que le répertoire de données enregistrées du plugin est conservé. Si vous avez déjà désactivé le plugin pour vous-même, l’icône de corbeille supprime votre propre installation sans poser la question.
• Sinon, la dernière installation d’un plugin disposant de données enregistrées : choisissez de conserver ou de supprimer les données ; Keep est l’option par défaut

​

Partager un lien d’installation de plugin

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

• Nom du plugin : 100 caractères au maximum, commençant par une lettre ou un chiffre ASCII et n’utilisant par ailleurs que des lettres ASCII, des chiffres, ., _ et -.
• Source de la marketplace : uniquement les formes que liste le paramètre marketplace, donc ni un chemin local, ni une adresse http://, ni le nom de la marketplace, tel que claude-plugins-official. Une URL https:// ne peut pas contenir de nom d’utilisateur, de mot de passe ni de chaîne de requête.
• Référence Git : pour épingler la marketplace à une branche ou à un tag, ajoutez la référence à la source après %23, la forme encodée de #, comme dans marketplace=owner/repo%23v1.0. Un lien contenant un # non encodé échoue. Les marketplaces de l’organisation GitHub anthropics ne peuvent pas être épinglées dans un lien.

• La marketplace ne répertorie aucun plugin portant ce nom : la boîte de dialogue indique que le plugin est introuvable. Vérifiez la valeur plugin par rapport à la liste de la marketplace.
• Le plugin est déjà installé : la boîte de dialogue l’indique, et rien ne change.
• Une autre marketplace portant le même nom a déjà été ajoutée : la boîte de dialogue indique que la marketplace du lien n’a pas été ajoutée, et rien n’est installé.

​

Gérer les marketplaces

• Saisissez un dépôt GitHub, une URL ou un chemin local pour ajouter une nouvelle marketplace
• Cliquez sur l’icône d’actualisation pour mettre à jour la liste des plugins d’une marketplace
• Cliquez sur l’icône de corbeille pour supprimer une marketplace. La supprimer désinstalle tous les plugins que vous avez installés à partir de celle-ci ; une confirmation nomme donc d’abord ces plugins

​

Plugins qui dessinent dans le panneau

• Un volet à côté de la conversation ou au-dessus de la zone de prompt
• Une notification toast ou une barre de statut au-dessus de la zone de prompt
• Un message ou un appel d’outil dessiné à la manière propre du plugin

• From the token-chart plugin : le plugin a dessiné ou affiché cet élément, ou cette carte correspond au plugin qui vous pose une question
• Edited by the token-chart plugin : le plugin a modifié un élément que Claude Code dessine, comme un appel d’outil
• Prompt from the token-chart plugin : le plugin a envoyé ce message en votre nom

​

Automatiser les tâches de navigateur avec Chrome

@browser go to localhost:3000 and check the console for errors

• Activer Chrome par défaut : connectez chaque session à votre navigateur dès son démarrage, sans taper @browser
• Demandes de permission dans les sessions VS Code : quand Claude Code vous demande votre accord avant une action dans le navigateur
• Utiliser Claude Code avec Chrome : instructions de configuration, liste complète des fonctionnalités et dépannage

​

Travailler avec git

​

Créer des commits et des demandes de fusion

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

​

Exécuter des tâches en arrière-plan

​

Déplacer une commande ou un sous-agent en cours d’exécution vers l’arrière-plan

• Moment d’apparition : l’action apparaît dès qu’une commande s’exécute depuis environ deux secondes, ou dès qu’un sous-agent démarre.
• Après le clic : Claude cesse d’attendre et poursuit le tour. La commande ou le sous-agent continue de s’exécuter en tant que tâche en arrière-plan qui avertit Claude une fois terminée.

​

Surveiller les processus en arrière-plan

​

Commandes et raccourcis VS Code

​

Lancer un onglet VS Code depuis d’autres outils

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

​

Configurer les paramètres

• Paramètres d’extension dans VS Code : contrôlent le comportement de l’extension dans VS Code. Ouvrez-les avec Cmd+, (Mac) ou Ctrl+, (Windows/Linux), puis accédez à Extensions > Claude Code. Vous pouvez également taper / et sélectionner General config… pour ouvrir les paramètres.
• Paramètres de Claude Code dans ~/.claude/settings.json : partagés entre l’extension et la CLI. Utilisez-les pour les commandes autorisées, les variables d’environnement, les hooks et les serveurs MCP. Avec Claude Code v2.1.283 ou ultérieure, ils constituent également l’une des entrées qui déterminent le mode de permission dans lequel les conversations démarrent ; sur les versions antérieures, uniquement avec les forfaits Pro, Max et Team. Changer de mode de permission indique l’ordre. Consultez Paramètres pour plus de détails.

​

Paramètres d’extension

​

Utiliser des fournisseurs tiers

​

Utiliser un lecteur d’écran

• Les réponses de Claude : l’extension annonce chaque réponse une seule fois, lorsqu’elle est terminée, et reste silencieuse pendant que le texte s’affiche en streaming. Votre lecteur d’écran lit les blocs de code sous forme d’un résumé indiquant le nombre de lignes, lit les liens par leur libellé et lit les tableaux cellule par cellule ; la réponse complète reste lisible dans la transcription.
• Les demandes de permission et les questions : l’extension annonce une demande lorsque sa demande de permission apparaît, en nommant l’outil que Claude souhaite utiliser. Elle fait la même annonce lorsque Claude vous pose une question et lorsque Claude termine un plan et attend votre relecture.
• Les changements d’état : l’extension annonce quand Claude commence à travailler, quand Claude est prêt pour votre saisie et quand Claude Code commence à compacter la conversation.
• Les messages en file d’attente : lorsque vous envoyez un message pendant que Claude travaille, l’extension annonce « Message queued. » pour ce message.
• Les erreurs et les prompts liés au modèle : l’extension annonce les erreurs dans la conversation, et annonce l’apparition de la demande de consentement aux crédits d’utilisation ou de la demande concernant une requête signalée.

​

Utiliser le panneau de chat au clavier

• Vos messages : « You »
• Les messages de Claude : « Claude »
• Les étapes d’outils : « Claude » suivi du nom de l’outil, par exemple « Claude, Bash »
• Les blocs de réflexion : « Claude, thinking »

• Avec cette option sélectionnée, appuyez sur la touche fléchée Left ou Right. L’extension annonce chaque destination à mesure que vous vous y déplacez. Les touches fléchées nécessitent Claude Code v2.1.268 ou une version ultérieure.
• Cliquez sur la destination dans le libellé.

​

Extension VS Code vs. CLI Claude Code

​

Exécuter la CLI dans VS Code

​

Basculer entre l’extension et la CLI

​

Se connecter à des outils externes avec MCP

• Ajouter des serveurs
• Supprimer des serveurs enregistrés avec la portée locale, utilisateur ou projet
• Activer ou désactiver des serveurs
• Vous reconnecter à un serveur
• Gérer l’authentification OAuth

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

​

Le serveur MCP intégré de l’IDE

• Ouvre les diffs dans la visionneuse de diff native de VS Code
• Lit votre sélection actuelle pour les mentions @
• Demande à VS Code d’exécuter des cellules lorsque vous travaillez dans un notebook Jupyter

• Messages en file d’attente : si vous mettez un message en file d’attente pendant que Claude travaille, il conserve la sélection que vous aviez au moment où vous avez appuyé sur Enter, quelle que soit votre sélection ultérieure.
• Fichiers sensibles : pour exclure un fichier sensible tel que .env, ajoutez une règle de refus Read pour son chemin. Une règle de refus correspondante empêche à la fois le texte sélectionné et la notification de fichier ouvert pour ce fichier de parvenir à Claude.
• Attach Open File désactivé : si vous désactivez le paramètre Attach Open File, la CLI ne reçoit le chemin du fichier actif que lorsque du texte y est sélectionné.

• Transport : ws:// non chiffré. Comme le socket est limité au loopback, tout processus capable de capturer le trafic peut également lire le jeton dans le fichier de verrouillage ; TLS n’apporterait donc aucune protection supplémentaire.
• Jeton d’authentification : chaque activation de l’extension génère un nouveau jeton d’authentification aléatoire et l’écrit dans un fichier de verrouillage à l’emplacement ~/.claude/ide/<port>.lock. La CLI doit présenter ce jeton dans l’en-tête X-Claude-Code-Ide-Authorization pour se connecter.
• Permissions du fichier de verrouillage : le fichier de verrouillage dispose des permissions 0600 dans un répertoire 0700, de sorte que seul l’utilisateur qui exécute VS Code peut le lire. Si CLAUDE_CONFIG_DIR est défini, le fichier de verrouillage est écrit dans $CLAUDE_CONFIG_DIR/ide/ à la place.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. Le code est inséré sous forme de nouvelle cellule à la fin du notebook actif.
2. VS Code fait défiler l’affichage jusqu’à la cellule.
3. Un Quick Pick natif vous demande de choisir Execute ou Cancel.

​

Résoudre les problèmes courants

​

L’extension ne s’installe pas

• Assurez-vous de disposer d’une version compatible de VS Code (1.94.0 ou ultérieure)
• Vérifiez que VS Code a la permission d’installer des extensions
• Essayez de l’installer directement depuis la VS Code Marketplace

​

L’icône Spark n’est pas visible

1. Ouvrez un fichier : l’icône nécessite qu’un fichier soit ouvert. Avoir uniquement un dossier ouvert ne suffit pas.
2. Vérifiez la version de VS Code : la version 1.94.0 ou ultérieure est requise. Vérifiez-la sous Help > About
3. Redémarrez VS Code : exécutez « Developer: Reload Window » depuis la Palette de commandes
4. Désactivez les extensions en conflit : désactivez temporairement les autres extensions d’IA (Cline, Continue, etc.)
5. Vérifiez la confiance de l’espace de travail : l’extension ne fonctionne pas en mode restreint

​

Cmd+Esc ne fait rien sur macOS

1. Ouvrez Réglages Système
2. Accédez à Clavier, puis Raccourcis clavier, puis Manettes de jeu
3. Décochez la case Game Overlay

​

Une conversation reprise est d’abord vide

​

Le panneau cesse de répondre chaque fois qu’un rechargement rouvre une conversation

​

Une formule s’affiche en LaTeX brut

• Elle se lit comme autre chose que des mathématiques : un texte $…$ qui se lit comme un mot reste tel qu’écrit, par exemple $O(n log n)$. Un texte $…$ qui commence par un chiffre, tel que $30$ ou $1/N$, reste également tel qu’écrit, sauf si un caractère tel que =, + ou ^ l’identifie comme des mathématiques. Demandez plutôt à Claude un bloc $$ sur ses propres lignes, que le panneau met en forme sans cette vérification.
• Elle contient des espaces, est longue ou est répartie sur plusieurs lignes : $ x^2 $ avec des espaces à l’intérieur des dollars, un contenu $…$ de plus de 60 caractères, et un $…$ ou \(…\) réparti sur deux lignes ne sont pas mis en forme. Demandez plutôt à Claude un bloc $$ sur ses propres lignes, qui n’a aucune de ces limites.
• Le TeX ne peut pas être mis en forme : une formule contenant une erreur de syntaxe, une définition de macro telle que \newcommand ou \def, ou un % non échappé s’affiche telle qu’écrite. Demandez à Claude de la réécrire en corrigeant l’erreur, sans la macro, ou avec \% pour le signe pourcentage.
• Elle est trop volumineuse : une formule de plus de 8 192 caractères, ou une formule dont le rendu serait bien plus grand que sa source, s’affiche telle qu’écrite. Demandez à Claude de la diviser en formules plus petites ou de l’écrire de manière plus compacte.
• Elle suit une grande quantité de mathématiques : au sein d’un même bloc de texte d’une réponse, le panneau met en forme les formules dans l’ordre jusqu’à une limite. Une formule ultérieure qui dépasserait cette limite s’affiche telle qu’écrite. Demandez à Claude de renvoyer seule la formule dont vous avez besoin.

​

Claude Code ne répond jamais

1. Vérifiez votre connexion internet : assurez-vous de disposer d’une connexion internet stable
2. Démarrez une nouvelle conversation : essayez de démarrer une nouvelle conversation pour voir si le problème persiste
3. Essayez la CLI : exécutez claude depuis le terminal pour voir si vous obtenez des messages d’erreur plus détaillés

​

Désinstaller l’extension

1. Appuyez sur Cmd+Shift+X sur Mac ou Ctrl+Shift+X sur Windows/Linux pour ouvrir la vue Extensions
2. Recherchez « Claude Code »
3. Cliquez sur Uninstall

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

​

Prochaines étapes

• Explorez les workflows courants pour tirer le meilleur parti de Claude Code
• Configurez des serveurs MCP pour étendre les capacités de Claude avec des outils externes. Ajoutez-les et gérez-les avec /mcp dans le panneau de chat.
• Configurez les paramètres de Claude Code pour personnaliser les commandes autorisées, les hooks, et plus encore. Ces paramètres sont partagés entre l’extension et la CLI.
• Consultez les mesures de sécurité et l’utilisation des données de Claude Code