Intégration JetBrains
📚 Navigation de la série : L'article précédent 08 Intégration VS Code a introduit Claude Code dans VS Code. Cet article change de camp — si votre outil de prédilection est la famille JetBrains (IntelliJ IDEA, PyCharm, WebStorm...), il existe aussi un plugin natif, avec une approche à la fois similaire et différente. Article suivant : 10 Application de bureau (Desktop).
A : « Je passe mes journées dans PyCharm, les extensions VS Code ça ne me concerne pas, non ? »
B : « Il y a un plugin natif. Installe-le, et avec Cmd+Esc tu pourras appeler Claude directement depuis ton éditeur. »
A : « C'est la même chose que l'extension VS Code ? J'aurai le diff, les mentions @, tout ça ? »
B : « Le moteur est le même CLI, mais l'interface n'a pas été conçue par la même équipe — certaines choses sont identiques, pour d'autres il faut changer d'approche. Par exemple, il tourne par défaut dans le terminal intégré de l'IDE, ce n'est pas un panneau indépendant. »
C'est une question très typique des développeurs backend utilisant GoLand : Les utilisateurs de JetBrains craignent souvent d'être des « citoyens de seconde zone », et que les meilleures fonctionnalités soient réservées à VS Code.
Pour être franc, cette inquiétude est en partie fondée, en partie erronée. Ce qui est vrai : le plugin JetBrains est effectivement plus léger que l'extension VS Code. Il connecte le CLI à l'IDE pour que les informations circulent entre les deux, plutôt que de créer un panneau graphique complet et indépendant. Ce qui est faux : Toutes les fonctionnalités essentielles sont bien là.
Cet article va vous expliquer clairement : comment installer, comment se connecter, les différences avec VS Code, et comment résoudre les problèmes spécifiques à JetBrains (la touche ESC, WSL, le développement à distance).
Après avoir lu cet article, vous obtiendrez :
- Les étapes complètes pour installer le plugin Claude Code dans IntelliJ / PyCharm / WebStorm, etc.
- Quand utiliser le « Terminal intégré de l'IDE » ou le « Terminal externe
/ide» pour se connecter. - Un tableau comparatif « Plugin JetBrains vs Extension VS Code », ainsi que les raccourcis clavier propres à JetBrains.
- Les solutions officielles pour trois problèmes fréquents : la touche ESC qui ne marche pas pour interrompre, WSL2 qui « ne détecte pas l'IDE », et le développement à distance.
01 Bien comprendre : Que fait réellement le plugin ?
Beaucoup de gens sont perplexes après avoir installé le plugin : « J'ai installé le plugin, mais où est le panneau de discussion façon VS Code ? »
Conclusion immédiate : Le plugin JetBrains n'est pas une fenêtre de discussion indépendante, c'est un « pont ». Le cœur de Claude Code reste le CLI qui tourne dans le terminal. Ce que fait le plugin, c'est connecter l'IDE et le CLI : le code sélectionné dans l'éditeur, les erreurs lint signalées par l'IDE, ou les modifications proposées par Claude, peuvent transiter automatiquement entre l'« IDE » et « le Claude du terminal ».
Analogie : L'AirDrop entre un téléphone et un ordinateur. Les fichiers ou le presse-papiers restent sur leur appareil d'origine, mais avec AirDrop, les deux appareils se « connaissent » — copiez sur l'ordinateur, collez sur le téléphone. Le plugin, c'est ce canal entre l'IDE et Claude : vous sélectionnez du code dans PyCharm, le Claude du terminal le « voit » instantanément, pas besoin de copier-coller.
Il y a donc un élément crucial à comprendre :
Dans JetBrains, l'endroit où vous discutez avec Claude, c'est le terminal intégré de l'IDE — ce n'est pas un nouveau panneau latéral.
C'est la plus grande différence d'expérience avec VS Code : VS Code vous offre un panneau de discussion graphique ; JetBrains vous fait utiliser claude dans le terminal intégré, avec le plugin qui fournit le contexte en arrière-plan. La discussion a lieu dans le terminal, le diff s'ouvre dans la visionneuse native de l'IDE, vous cumulez les avantages des deux mondes, et la courbe d'apprentissage est quasi nulle — les commandes, les raccourcis, les slash commands / sont exactement ceux du terminal. La première fois qu'on installe le plugin dans IntelliJ, on craint de devoir s'adapter à une nouvelle interface, mais on découvre que c'est le même Claude du terminal, sauf qu'il a soudainement « des yeux », il peut voir ce que vous avez sélectionné et ce que l'IDE souligne en rouge.
💡 En un mot : Le plugin JetBrains est l'« AirDrop » entre l'IDE et le CLI, les conversations se passent dans le terminal intégré, les diffs s'ouvrent dans l'IDE, ce n'est pas un panneau de discussion indépendant.
02 Quels IDE sont pris en charge ? Faites votre choix
JetBrains est toute une famille de logiciels, pas un seul programme. La bonne nouvelle, c'est que le plugin Claude Code couvre la quasi-totalité des logiciels grand public de la marque.
Liste officielle des IDE pris en charge :
| IDE | Langage / Usage principal |
|---|---|
| IntelliJ IDEA | Java / Kotlin, le cœur de métier backend, Android |
| PyCharm | Python, Data, IA, scripts |
| WebStorm | Frontend JS / TS |
| PhpStorm | PHP |
| GoLand | Go |
| Android Studio | Développement Android (basé sur IntelliJ) |
La communication officielle précise qu'il est « adapté à la plupart des IDE JetBrains » — pour ceux qui ne sont pas dans la liste (RubyMine, CLion, Rider, etc.), il y a de fortes chances qu'il fonctionne aussi, mais l'éditeur ne s'y engage pas formellement. Installez-le si possible, s'il y a un problème, considérez que le support n'est « pas explicitement confirmé ».
Analogie : Les différents modèles de voitures d'une même marque partagent le même système multimédia. IntelliJ, PyCharm, WebStorm, c'est comme la berline, le SUV et la sportive d'un même constructeur, ils ont des cibles différentes mais partagent la même architecture sous-jacente (ils sont construits sur la plateforme IntelliJ). Ainsi, un seul plugin fonctionne partout, et toutes les étapes de ce guide, que vous utilisiez IntelliJ ou GoLand, suivront les mêmes chemins de menu. La démonstration ci-dessous se fera avec PyCharm.
L'image ci-dessus illustre bien cette relation : le plugin Claude Code, en haut, est unique, il s'adapte à chaque IDE en dessous ; et IntelliJ IDEA, PyCharm, WebStorm, bien qu'ils gèrent des langages différents, reposent tous sur la plateforme IntelliJ. C'est pourquoi on ne l'installe qu'une fois pour pouvoir l'utiliser partout, l'installation et la configuration sont identiques.
💡 En un mot : Tous les principaux IDE JetBrains sont pris en charge, ils partagent la même plateforme IntelliJ — les étapes d'installation et de configuration sont identiques, quel que soit l'IDE.
03 Installation : Le plugin et le CLI, les deux sont indispensables
C'est l'étape où il est le plus facile de se tromper, car l'intégration JetBrains nécessite que deux choses soient prêtes : le plugin, et l'exécutable CLI de Claude Code. Il ne peut en manquer aucun.
Analogie : Une application mobile et son compte serveur. Si on installe l'application (le plugin) sans avoir créé de compte sur le serveur (le CLI), on ouvre juste une coquille vide. L'interface est le plugin, mais celui qui fait le vrai travail, c'est le CLI en « arrière-plan ». Il faut donc vérifier que le CLI est présent avant d'installer le plugin.
Étape 1 : Vérifier que le CLI est installé
Si vous suivez cette série depuis le début, vous l'avez installé lors de l'article 02. En cas de doute, lancez cette commande dans n'importe quel terminal :
claude --versionRésultat attendu : Affichage d'un numéro de version, semblable à 2.x.x (Claude Code).
Si le terminal affiche command not found, le CLI n'est pas installé. Retournez à l'article 02 Installation ou utilisez la commande d'installation officielle (selon votre système d'exploitation) :
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iexNote pour la Chine : L'installation du CLI, l'autorisation de connexion, puis l'utilisation de Claude pour coder nécessitent une connexion aux services d'Anthropic, et donc l'usage d'un VPN. C'est le cas pour la version terminal, la version VS Code et la version JetBrains.
Étape 2 : Installer le plugin JetBrains
Deux méthodes sont possibles, la première est recommandée.
Méthode 1 : Rechercher dans l'IDE (Recommandé)
- Ouvrez votre IDE JetBrains
- Allez dans Settings (Paramètres) → Plugins (Raccourci Mac
Cmd+,, Windows/LinuxCtrl+Alt+S) - Allez dans l'onglet Marketplace
- Recherchez Claude Code
- Cliquez sur Install (Installer)
- Après l'installation, il est impératif de redémarrer l'IDE
Méthode 2 : Installer via le site web du Marketplace
Allez directement sur la page Claude Code du Marketplace des plugins JetBrains, et suivez les instructions.
Faites attention, le nom du plugin comporte le suffixe [Beta] — cela signifie qu'il est encore en phase bêta, son comportement peut changer avec les mises à jour (référez-vous à la documentation officielle). Les fonctionnalités principales marchent, mais ne le considérez pas comme une version stable définitive.
Étape 3 : Redémarrer l'IDE (Ne pas sauter)
L'éditeur insiste particulièrement sur ce point :
Après l'installation du plugin, il se peut que vous deviez redémarrer complètement l'IDE pour qu'il s'active.
« Redémarrer complètement » signifie quitter totalement l'application et la relancer, pas seulement fermer une fenêtre. Ce piège est très fréquent : après l'installation, on lance claude dans l'IDE, l'intégration ne s'active pas, on pense que le plugin est cassé ; il suffit de quitter complètement IntelliJ et de le rouvrir, tout fonctionne alors parfaitement. La documentation place ce conseil en tête de la liste de dépannage « si le plugin ne fonctionne pas », ce qui prouve sa fréquence.
| ❌ Pièges fréquents | ✅ Méthode correcte |
|---|---|
| Installer seulement le plugin, sans le CLI | Vérifier la présence du CLI d'abord avec claude --version |
| Utiliser juste après l'installation sans redémarrer | Quitter complètement l'IDE et le relancer après installation |
| Installer un plugin similaire par erreur | S'assurer de choisir l'officiel Claude Code [Beta] |
| Redémarrer juste en fermant la fenêtre | « Redémarrer complètement » = Arrêter le processus et relancer |
💡 En un mot : L'intégration JetBrains requiert l'exécutable CLI + le plugin, il faut les deux ; après installation, redémarrer complètement l'IDE est indispensable, c'est la cause la plus courante de l'erreur « installé mais inactif ».
04 Connexion : Deux méthodes, selon le point de lancement
Le plugin est installé et l'IDE redémarré. L'étape suivante consiste à « connecter » Claude Code à l'IDE. Une fois connectés, le partage de sélection, l'affichage des diffs dans l'IDE et le partage des diagnostics seront activés. La méthode de connexion dépend de l'endroit où vous lancez Claude.
Méthode 1 : Lancement depuis le terminal intégré de l'IDE (Recommandé, automatique)
Le plus simple. Ouvrez le terminal intégré de l'IDE (généralement en bas, onglet Terminal), et lancez :
claudeRésultat attendu : Claude Code se lance, et toutes les fonctionnalités d'intégration s'activent automatiquement, sans aucune manipulation supplémentaire. Comme vous lancez depuis le « ventre » de l'IDE, le plugin sait naturellement à quel IDE il doit se connecter.
Analogie : Se connecter au Wi-Fi chez soi. Quand vous rentrez, le téléphone se connecte tout seul, sans taper de mot de passe. Le terminal intégré, c'est cette expérience : l'environnement est bon, la connexion se fait toute seule.
Méthode 2 : Lancement depuis un terminal externe, utiliser /ide pour connecter manuellement
Si vous avez l'habitude d'utiliser des terminaux indépendants comme iTerm ou Windows Terminal, lancez d'abord Claude, puis établissez la connexion manuellement :
claudePuis, dans la conversation Claude, tapez :
/ideRésultat attendu : Claude liste les IDE JetBrains détectés. Sélectionnez le bon, la connexion s'établit et les fonctionnalités s'activent. Analogie : Se connecter au Wi-Fi chez quelqu'un d'autre, il faut choisir le réseau manuellement — /ide c'est cette action.
Un prérequis souvent oublié : Lancer depuis le répertoire racine du projet
Peu importe la méthode choisie, l'éditeur le rappelle :
Si vous voulez que Claude ait accès aux mêmes fichiers que l'IDE, lancez Claude Code depuis le même répertoire racine que votre projet dans l'IDE.
En d'autres termes : Dans quel projet est ouvert l'IDE, lancez claude dans le répertoire racine de ce projet. Si vous lancez depuis ~/Downloads, les fichiers vus par Claude ne correspondront pas au projet ouvert dans l'IDE. Le terminal intégré répond automatiquement à ce prérequis — c'est l'autre raison qui fait de la Méthode 1 la méthode recommandée.
| Méthode de lancement | Méthode de connexion | Répertoire du projet |
|---|---|---|
| Terminal intégré de l'IDE | Activation automatique, aucune action requise | Se trouve par défaut à la racine du projet ✅ |
| Terminal externe (iTerm, etc.) | Exécuter /ide et sélectionner manuellement l'IDE | Vous devez faire un cd manuel vers la racine du projet |
En règle générale, utiliser exclusivement le terminal intégré de l'IDE suffit amplement : la connexion est automatique, le répertoire est le bon, le terminal et le code sont dans la même fenêtre, on bascule avec Cmd+Esc. On n'utilise /ide que si un terminal externe est déjà ouvert pour d'autres tâches.
💡 En un mot : Lancement via le terminal intégré de l'IDE = connexion automatique, alignement naturel des répertoires (recommandé) ; Lancement via un terminal externe = exécution de
/idepour connexion manuelle. Quelle que soit la méthode, toujours lancer depuis la racine du projet.
05 Ce qu'il peut faire : Cinq fonctionnalités d'intégration
Une fois connecté, le plugin apporte cinq « bonus », que nous allons détailler. Observez particulièrement les différences avec VS Code (un tableau comparatif se trouve à la fin de la section).
- ① Lancement rapide : Appuyez sur
Cmd+Esc(Mac) /Ctrl+Esc(Windows/Linux) dans l'éditeur pour ouvrir directement Claude, vous pouvez aussi cliquer sur le bouton de l'interface. C'est le plus utilisé — une question vous vient en codant, pas besoin de cliquer sur l'onglet du terminal, un raccourci et le focus est fait. - ② Partage du contexte de la sélection : Le code actuellement sélectionné dans l'IDE, ou l'onglet ouvert, est automatiquement partagé avec Claude. Si vous sélectionnez un bout de code et demandez « pourquoi ça plante », il sait que vous parlez de ce bout-là.
- ③ Raccourci pour référencer un fichier : Appuyez sur
Cmd+Option+K(Mac) /Alt+Ctrl+K(Linux/Windows) pour insérer une référence de fichier du type@src/auth.ts#L1-99, avec chemin et numéros de ligne, permettant à Claude de le localiser avec précision. - ④ Affichage des Diffs : Les modifications de code sont affichées directement dans le visualiseur de diff de l'IDE, au lieu des symboles texte dans le terminal (cette option n'est pas forcément activée par défaut, il faut la configurer sur
auto, nous verrons ça dans la section suivante). - ⑤ Partage des diagnostics : Les avertissements de l'analyseur statique (lint) de l'IDE, les erreurs de syntaxe, les soulignements rouges ou jaunes sont automatiquement partagés avec Claude. Il peut « voir » directement ce qui est souligné en rouge, sans que vous ayez à copier-coller l'erreur.
Deux remarques importantes concernant la sécurité et l'usage :
⚠️ Sécurité (Identique à VS Code) : Si un fichier est concerné par une règle de refus
Readque vous avez définie, la sélection ne sera pas partagée et ne sera pas envoyée à Claude (selon la documentation). Il est conseillé de définir cette règle pour les fichiers sensibles comme.env.⚠️ Usage : Le raccourci pour référencer un fichier est différent de celui de VS Code. Sur VS Code c'est
Option+K/Alt+K, sous JetBrains il faut ajouter une touche, c'estCmd+Option+K/Alt+Ctrl+K. C'est l'erreur la plus commune quand on passe de l'un à l'autre.
Le partage des diagnostics est l'une des fonctionnalités les plus appréciables. L'analyseur de code de JetBrains est l'un des meilleurs du marché. Avant, il fallait copier l'erreur affichée en rouge pour la coller à Claude dans le terminal, maintenant il la lit directement. Si PyCharm vous signale un « import inutilisé » et quelques erreurs de type, un simple « corrige les erreurs signalées par l'IDE » suffira, il les réparera une à une, sans que vous ayez besoin de coller la moindre ligne.
| Fonctionnalité | JetBrains | VS Code | Remarques |
|---|---|---|---|
| Lancement rapide | Cmd/Ctrl+Esc | Cmd/Ctrl+Esc | Identique |
| Partage sélection / onglet | ✅ Auto | ✅ Auto | Identique |
| Raccourci de réf. de fichier | Cmd+Option+K / Alt+Ctrl+K | Option+K / Alt+K | Différent ! |
| Diff dans l'IDE | ✅ (doit être configuré sur auto) | ✅ | Identique |
| Partage de diagnostics | ✅ Auto | ✅ Auto | Identique |
| Interface de discussion | Terminal intégré de l'IDE | Panneau graphique indépendant | Différence majeure |
💡 En un mot : Des cinq bonus, le partage de la sélection, des diagnostics, et du diff vers l'IDE sont quasi identiques à VS Code ; la différence principale est que la conversation a lieu dans le terminal intégré, avec aussi un raccourci pour la référence de fichier qui nécessite une touche de plus.
06 Configuration : Activer les diffs, et régler le plugin
Installer et connecter c'est bien, mais il y a deux réglages qui prendront deux minutes et qui changeront la donne.
Configuration 1 : Régler l'outil de diff sur auto (Important)
Comme évoqué précédemment, le diff peut s'ouvrir dans l'IDE, mais cela dépend d'un paramètre. Dans Claude Code, lancez /config, cherchez l'outil de diff (diff tool), et réglez-le sur auto :
/config| Valeur | Effet |
|---|---|
auto | Les modifications s'affichent dans le visualiseur de diff de l'IDE côte à côte (recommandé) |
terminal | Les modifications s'affichent dans le terminal avec des symboles de texte |
Il est fortement recommandé de choisir auto — puisque vous utilisez un IDE, profitez de l'excellente vue de diff côte à côte de JetBrains, la lecture d'un diff textuel dans le terminal est éprouvante quand les modifications sont nombreuses.
Configuration 2 : Paramètres du plugin (Settings → Tools → Claude Code [Beta])
Les paramètres propres au plugin sont cachés dans Settings → Tools → Claude Code [Beta]. Quelques points à connaître :
- Claude command (Chemin de la commande Claude) : Par défaut
claude. Si la commandeclauden'est pas dans votre PATH habituel, indiquez le chemin absolu (ex:/usr/local/bin/claude) ou utiliseznpx @anthropic-ai/claude-code. C'est presque toujours ici qu'il faut agir si l'icône Claude vous indique « command not found ». - Désactiver la notification "Claude command non trouvée" : À décocher si le rappel est gênant.
- Activer la saisie multi-lignes avec Option+Enter (macOS uniquement) : Si activé,
Option+Enterdans la zone de saisie crée un saut de ligne. Désactivez cette option si la touche Option est interceptée accidentellement et perturbe votre saisie, redémarrez le terminal après modification. - Activer les mises à jour automatiques : Vérifie et installe automatiquement les mises à jour du plugin, applicables au prochain redémarrage.
De tout ça, retenez surtout la première ligne, Claude command (le chemin de la commande) — si un clic sur l'icône Claude affiche « command not found », c'est là qu'il faut chercher.
💡 Attention spéciale pour les utilisateurs WSL : Paramétrez la commande Claude avec
wsl -d Ubuntu -- bash -lic "claude"(en remplaçantUbuntupar le nom de votre distribution WSL).
💡 En un mot : Lancez
/configdans Claude Code pour régler le diff surauto, puis rendez-vous dans Settings → Tools → Claude Code [Beta] pour régler le plugin — notamment le chemin de la commande Claude, clé pour résoudre le problème « commande non trouvée ».
07 Trois problèmes fréquents spécifiques aux utilisateurs JetBrains
Ces trois problèmes sont plus susceptibles de toucher les utilisateurs JetBrains que ceux de VS Code. Les solutions présentées sont officielles.
Problème 1 : La touche ESC ne parvient pas à interrompre
Un vieux défaut du terminal JetBrains : Vous voulez presser ESC pour interrompre l'action en cours de Claude, mais le focus passe d'un coup dans l'éditeur, et l'action n'est pas interrompue. La raison ? ESC est lié par défaut à « Déplacer le focus vers l'éditeur ». La solution :
- Allez dans Settings → Tools → Terminal
- Choisissez l'une de ces options : décochez « Move focus to the editor with Escape (Déplacer le focus vers l'éditeur avec Échap) », ou cliquez sur « Configure terminal keybindings » pour supprimer la combinaison de touches affectée à « Switch focus to Editor ».
- Appliquez les modifications.
Après ce réglage, ESC interrompra normalement l'action. Il est fortement conseillé de faire ce changement juste après l'installation — il n'y a rien de plus frustrant que de vouloir stopper Claude en plein délire, appuyer sur ESC et ne rien voir se passer.
Problème 2 : Sous WSL2, le message « Aucun IDE détecté » apparaît
Avec Claude Code et JetBrains IDE sous WSL2, lancer /ide aboutit souvent au message « No available IDEs detected » (Aucun IDE disponible détecté). Le problème ne vient pas du plugin, mais du réseau NAT de WSL2 ou du pare-feu Windows, qui bloquent la connexion entre le « Claude dans WSL2 » et l'« IDE sous Windows » (WSL1 n'est pas concerné). Voici deux solutions officielles. La solution 1 (Autorisation du pare-feu) est recommandée, car elle ne modifie pas votre configuration réseau actuelle :
# Étape 1 : Obtenir l'IP dans le shell WSL
hostname -I
# Si la sortie est 172.21.123.45, le sous-réseau à noter est 172.21.0.0/16# Étape 2 : Lancer PowerShell en tant qu'administrateur, et créer une règle de pare-feu (ajuster la plage IP selon votre sous-réseau)
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16Ensuite, redémarrez l'IDE et Claude Code pour que la règle soit prise en compte.
La seconde solution consiste à configurer WSL2 en mode réseau miroir « mirrored » (nécessite Windows 11 22H2 ou supérieur), en ajoutant networkingMode=mirrored sous la section [wsl2] du fichier .wslconfig dans votre répertoire utilisateur Windows, suivi d'un wsl --shutdown pour redémarrer. Si vous êtes sur Windows 10, ne vous lancez pas dans le mode miroir, utilisez directement la solution 1.
Problème 3 : Développement à distance, où installer le plugin ?
Si vous utilisez le Développement à distance (Remote Development) de JetBrains — votre client local se connecte à un serveur distant pour coder — il y a un aspect contre-intuitif :
Le plugin doit être installé sur la « machine hôte distante (Remote Host) », pas sur votre machine cliente locale.
L'installation se fait dans Settings → Plugin (Host). L'erreur la plus commune est d'installer le plugin sur le client local et de ne jamais réussir à se connecter. Après avoir cherché des heures, on réalise qu'on l'a installé au mauvais endroit. Mémorisez ceci : L'endroit où Claude travaille concrètement est l'endroit où le plugin doit être installé. Dans un développement à distance, la machine distante est celle qui travaille, c'est donc elle qui reçoit le plugin.
| Problème | Solution en une phrase |
|---|---|
| ESC n'interrompt pas | Settings → Tools → Terminal, décochez « Escape déplace le focus vers l'éditeur » |
| WSL2 ne détecte pas l'IDE | Autorisez la connexion dans le pare-feu Windows (recommandé) ou passez en réseau miroir, puis redémarrez |
| Impossible de se connecter en Dev. Distant | Installez le plugin sur la machine distante (Remote Host) via (Settings → Plugin (Host)), pas en local |
💡 En un mot : Modifier les raccourcis du terminal pour que ESC fonctionne, autoriser le pare-feu pour le souci de détection sous WSL2, et installer le plugin sur la machine distante pour le développement à distance — ce sont les trois pièges les plus fréquents pour JetBrains. Pensez à modifier la touche ESC dès l'installation.
08 Mise en pratique : Effectuer l'ensemble du processus en 10 minutes sous JetBrains
Voici les étapes à suivre depuis le début. À chaque étape est précisé « le résultat attendu » pour que vous puissiez vérifier vous-même. La démonstration se fait sous PyCharm, mais les étapes sont identiques pour les autres IDE JetBrains.
Étape 0 : S'assurer que le CLI est installé — Exécutez claude --version, le résultat attendu est l'affichage de la version (ex: 2.x.x (Claude Code)). S'il indique command not found, retournez à l'article 02 Installation.
Étape 1 : Installer le plugin et redémarrer — PyCharm → Settings → Plugins → Marketplace, recherchez Claude Code → Install, quittez totalement PyCharm puis redémarrez-le. Résultat attendu : Après redémarrage, vous trouvez Claude Code [Beta] dans Settings → Tools.
Étape 2 : Créer un mini-projet de test — Créez un nouveau fichier demo.py :
def greet(name):
return "Hello " + name
print(greet("world"))Étape 3 : Lancer Claude depuis le terminal intégré de l'IDE — Ouvrez l'onglet Terminal en bas de PyCharm et exécutez claude. Résultat attendu : L'intégration s'active automatiquement (lancé depuis le terminal intégré, pas besoin de /ide). Lors du premier lancement, on vous invitera à vous connecter à votre compte Anthropic, autorisez la connexion via le navigateur.
Étape 4 : Régler l'outil de diff sur auto — Dans Claude, lancez /config, réglez l'outil de diff sur auto. Les modifications s'afficheront ainsi dans la visionneuse de diff de PyCharm.
Étape 5 : Sélectionner du code + Poser une question pour vérifier le partage du contexte
Dans l'éditeur, sélectionnez les deux lignes de la fonction greet, retournez dans le terminal Claude et tapez :
Y a-t-il quelque chose à améliorer dans la fonction que j'ai sélectionnée ?Résultat attendu : Claude vous répondra sur la base des deux lignes sélectionnées (peut-être suggérera-t-il d'utiliser un f-string ou d'ajouter des annotations de type). Il ne vous demandera pas « de quelle fonction vous parlez », ce qui signifie que le partage de contexte fonctionne. C'est la confirmation que « l'AirDrop » fonctionne bien.
Étape 6 : Lui demander de modifier, et voir le diff dans l'IDE
Continuez et tapez :
Aide-moi à le modifier pour utiliser les f-string et ajoute des annotations de type.Résultat attendu : Parce que vous avez réglé sur auto à l'étape 4, les modifications s'afficheront dans la visionneuse de diff de PyCharm côte à côte. L'original return "Hello " + name à gauche, le code modifié return f"Hello {name}" à droite, avec l'annotation de type sur la signature de la fonction. Acceptez si c'est bon.
Arrivé à cette étape, vous avez validé les quatre points cruciaux : installation du plugin, connexion avec le CLI, partage de la sélection et affichage du diff dans l'IDE. Si à l'étape 5 il vous demande de quelle fonction il s'agit, ou si le diff ne s'affiche pas dans l'IDE à l'étape 6, revoyez les sections 03, 04 et 06.
09 Résumé
Cet article a détaillé l'installation et l'utilisation de Claude Code au sein des IDE JetBrains. Voici les points essentiels :
- Le plugin est un « pont », pas un « panneau » : Il relie l'IDE au CLI, la discussion se fait dans le terminal intégré de l'IDE et les diffs s'affichent dans la visionneuse native, il n'y a pas de fenêtre de discussion indépendante comme sur VS Code.
- Deux choses à installer : L'exécutable CLI + le plugin, les deux sont indispensables ; il faut impérativement redémarrer complètement l'IDE après l'installation, c'est la cause numéro 1 d'un plugin inactif.
- Deux méthodes pour se connecter : Le lancement depuis le terminal intégré est automatique (recommandé), le lancement depuis un terminal externe nécessite la commande manuelle
/ide. Quel que soit le cas, lancez-le toujours à la racine du projet. - Trois pièges exclusifs : ESC n'interrompt pas (modifier le raccourci du terminal), WSL2 ne trouve pas l'IDE (autoriser le pare-feu), développement à distance : le plugin doit être installé sur la machine distante.
Vous devriez maintenant être en mesure : d'installer le plugin seul dans votre IDE JetBrains, de relier Claude à votre IDE, de fournir un contexte précis avec le partage de sélection, et d'examiner les modifications via la visionneuse de diff de l'IDE. Les utilisateurs de JetBrains ne sont pas laissés pour compte, vous profitez de l'essentiel de l'expérience.
Maintenant que nous avons abordé les deux principaux IDE, VS Code et JetBrains, leur point commun est qu'ils requièrent d'abord un IDE dans lequel Claude s'intègre. Que faire si vous ne voulez même pas ouvrir d'IDE, mais souhaitez simplement un client Claude autonome et prêt à l'emploi ?
Article suivant : 10 Application de bureau (Desktop) — Claude Code dispose également d'une application de bureau indépendante, qui ne dépend d'aucun éditeur et se lance par un double-clic. Nous découvrirons à qui elle s'adresse, comment la comparer avec les intégrations IDE et quels sont les avantages spécifiques qu'elle propose, inaccessibles via les versions IDE.