Claude Code dans JetBrains (IntelliJ, PyCharm) : Installation 2026

Claude Code dans JetBrains : l'agent IA directement dans IntelliJ et PyCharm

Vous codez sur IntelliJ IDEA, PyCharm, WebStorm ou PhpStorm et vous regardez les utilisateurs de VS Code brancher Claude Code sur leur éditeur ? Bonne nouvelle : Claude Code s'intègre nativement dans tous les IDE JetBrains via un plugin dédié. Diff viewer natif, partage automatique de la sélection, raccourcis de référence de fichiers, remontée des erreurs du linter en temps réel — l'agent IA d'Anthropic devient un vrai copilote au cœur de votre IDE préféré.

Dans ce guide tutoriel en français, vous allez voir comment installer Claude Code dans JetBrains en moins de cinq minutes, comment connecter l'agent à votre IDE avec la commande /ide, comment activer le diff viewer, et comment régler les problèmes classiques (WSL2, ESC qui n'interrompt pas, "No available IDEs detected"). À la fin, votre IntelliJ ou PyCharm sera transformé en environnement de dev assisté par IA.

Sommaire

Pourquoi utiliser Claude Code dans JetBrains plutôt que VS Code ?<a id="pourquoi-jetbrains"></a>

Beaucoup de développeurs professionnels — surtout en Java, Kotlin, Python, PHP ou Go — vivent dans l'écosystème JetBrains pour son indexation sémantique, son refactoring industriel et son débogueur. Jusqu'ici, brancher un agent IA terminal sur ces IDE demandait des bricolages. Le plugin officiel Claude Code [Beta] change la donne.

L'intérêt est double. D'abord, vous gardez toute la puissance de l'IDE (navigation, inspections, run configurations) tout en déléguant à Claude les tâches répétitives : écrire un test, refactorer un module, corriger un bug remonté par le linter. Ensuite, l'intégration est bidirectionnelle : Claude voit votre sélection et vos diagnostics, et vous renvoie ses modifications dans le diff viewer natif de JetBrains au lieu d'un diff terminal illisible.

C'est exactement le même moteur que le CLI : si vous découvrez l'outil, commencez par notre [guide pour débuter avec Claude Code](/blog/comment-utiliser-claude-code-guide-debutant-2026), puis revenez ici pour l'intégration IDE. Et si vous hésitez encore entre éditeurs, notre comparatif [Claude Code vs Gemini CLI](/blog/claude-code-vs-gemini-cli-2026) éclaire les différences de philosophie entre agents terminal.

Prérequis avant l'installation<a id="prerequis"></a>

Avant d'installer le plugin, assurez-vous d'avoir les éléments suivants.

1. Le CLI Claude Code installé

Le plugin JetBrains ne contient pas l'agent : il fait le pont entre votre IDE et le CLI claude. Vous devez donc installer Claude Code au préalable. Si ce n'est pas fait, suivez notre tutoriel complet pour [installer Claude Code sur Mac, Windows et Linux](/blog/comment-installer-claude-code-mac-windows-linux). Vérifiez ensuite l'installation :

claude --version

2. Un compte Claude actif

Claude Code fonctionne avec n'importe quel abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console. Aucune clé API n'est requise : vous serez invité à vous connecter au premier lancement de claude.

3. Un IDE JetBrains compatible

Le plugin fonctionne avec la plupart des IDE JetBrains, notamment :

Si votre IDE JetBrains n'est pas dans cette liste mais partage la même base (RubyMine, CLion, Rider…), tentez quand même : le plugin est compatible avec la grande majorité de la gamme.

Installer le plugin Claude Code pour JetBrains<a id="installer-plugin"></a>

L'installation passe par le JetBrains Marketplace, accessible directement depuis votre IDE.

Étape 1 : ouvrir le Marketplace

Dans votre IDE, allez dans Settings → Plugins (ou Cmd+, sur Mac / Ctrl+Alt+S sur Windows-Linux), puis onglet Marketplace.

Étape 2 : chercher et installer

Tapez "Claude Code" dans la barre de recherche. Sélectionnez le plugin officiel Claude Code [Beta] édité par Anthropic, puis cliquez sur Install.

Étape 3 : redémarrer l'IDE

C'est l'étape qu'on oublie souvent : redémarrez complètement votre IDE pour que le plugin prenne effet. Sur certaines configurations, un seul redémarrage ne suffit pas — n'hésitez pas à relancer une seconde fois si le bouton Claude Code n'apparaît pas.

Une fois le plugin actif, vous verrez apparaître un bouton Claude Code dans l'interface, et le raccourci Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux) ouvrira l'agent directement depuis votre éditeur.

Connecter Claude Code à votre IDE avec /ide<a id="commande-ide"></a>

Il existe deux façons d'activer l'intégration entre Claude Code et JetBrains.

Méthode 1 : le terminal intégré (automatique)

La plus simple. Ouvrez le terminal intégré de votre IDE et lancez :

claude

Lancé depuis le terminal de JetBrains, Claude Code détecte automatiquement l'IDE et active toutes les fonctionnalités d'intégration. Rien d'autre à faire.

Méthode 2 : la commande /ide (terminal externe)

Si vous préférez travailler dans un terminal externe (iTerm, Windows Terminal, Alacritty…), lancez claude puis tapez :

/ide

Cette commande connecte Claude Code à votre IDE JetBrains et active toutes les fonctionnalités (diff viewer, sélection, diagnostics). Astuce importante : pour que Claude ait accès aux mêmes fichiers que votre IDE, démarrez Claude Code depuis le répertoire racine de votre projet — celui qui contient votre .idea/ ou votre fichier projet.

Pour aller plus loin sur la configuration du contexte projet, notre [guide du fichier CLAUDE.md](/blog/claude-md-fichier-configuration-guide-complet-2026) explique comment donner à l'agent les conventions, l'architecture et les commandes de votre repo — un réflexe à prendre dès le premier jour.

Les 5 fonctionnalités de l'intégration JetBrains<a id="fonctionnalites"></a>

Une fois connecté, voici ce que le plugin Claude Code apporte concrètement à votre IDE.

1. Quick launch (Cmd+Esc / Ctrl+Esc)

Ouvrez Claude Code instantanément depuis l'éditeur avec Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux), ou via le bouton Claude Code dans l'interface. Plus besoin de jongler entre fenêtres.

2. Diff viewing natif

C'est la fonctionnalité phare. Quand Claude propose des modifications, les changements s'affichent dans le diff viewer de JetBrains — celui que vous connaissez déjà — au lieu d'un diff brut dans le terminal. Vous relisez, vous éditez à la volée, vous acceptez ou refusez. La revue de code assistée devient fluide.

3. Selection context (partage automatique)

La sélection courante ou l'onglet actif de votre IDE est automatiquement transmise à Claude Code. Sélectionnez une fonction, demandez "explique-moi ce bloc" ou "ajoute la gestion d'erreur" : Claude sait déjà de quoi vous parlez. Pour exclure un fichier sensible (comme .env), ajoutez une règle de refus Read dans vos permissions — elle bloque le partage de ce fichier.

4. File reference shortcuts (Cmd+Option+K)

Insérez une référence de fichier précise dans votre prompt avec Cmd+Option+K (Mac) ou Alt+Ctrl+K (Linux/Windows). Claude reçoit alors une référence du type @src/auth.ts#L1-99, parfaite pour cibler exactement les lignes à modifier.

5. Diagnostic sharing (erreurs du linter en temps réel)

Les erreurs de diagnostic de l'IDE — lint, erreurs de syntaxe, warnings — sont automatiquement partagées avec Claude pendant que vous travaillez. L'agent voit les squiggles rouges en même temps que vous et peut les corriger sans que vous ayez à copier-coller le message d'erreur.

Ces cinq briques transforment l'expérience : Claude n'est plus un terminal à côté, c'est un collaborateur qui voit votre écran. Pour décupler cette intégration, beaucoup de développeurs branchent ensuite des serveurs externes via le [protocole MCP (Model Context Protocol)](/blog/mcp-model-context-protocol-claude-code), afin de donner à Claude un accès à leurs bases de données, leurs APIs ou leurs outils internes — un sujet qui rejoint le travail sur les [agents IA open-source et auto-hébergés détaillé sur formation-openclaw.com](https://formation-openclaw.com) pour les équipes qui veulent garder le contrôle de leur infrastructure.

Vidéo : maîtriser Claude Code de débutant à expert

Avant de plonger dans la configuration fine, cette session de Sophiène IA fait le tour complet de Claude Code — installation, fonctionnalités et workflows. Idéale pour visualiser l'outil en action avant de l'intégrer à votre IDE JetBrains :

Configurer le plugin (diff, commande, ESC)<a id="configuration"></a>

Deux niveaux de configuration cohabitent : les réglages côté Claude Code et les réglages côté plugin JetBrains.

Réglage du diff viewer (côté Claude Code)

Pour décider si les diffs s'affichent dans l'IDE ou dans le terminal :

Réglages du plugin (Settings → Tools → Claude Code [Beta])

Côté JetBrains, allez dans Settings → Tools → Claude Code [Beta] :

Régler le problème de la touche ESC

Frustration classique : la touche ESC n'interrompt pas Claude Code dans le terminal JetBrains, parce qu'elle est captée pour repasser le focus à l'éditeur. Pour corriger :

ESC interrompt désormais correctement les opérations de l'agent.

Dépannage : WSL2, IDE non détecté, command not found<a id="depannage"></a>

Voici les trois pannes les plus fréquentes et leurs correctifs.

"No available IDEs detected" sur WSL2

C'est le grand classique sous Windows. La cause est presque toujours le NAT de WSL2 ou le pare-feu Windows qui bloque la connexion entre WSL2 et l'IDE tournant sur l'hôte Windows. (WSL1 n'est pas affecté car il utilise directement le réseau de l'hôte.)

Solution recommandée — autoriser le trafic WSL2 dans le pare-feu :

# Dans votre shell WSL, trouvez votre IP
hostname -I
# Ex : 172.21.123.45 → sous-réseau 172.21.0.0/16

Puis dans PowerShell en administrateur, en adaptant la plage IP à 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/16

Redémarrez ensuite l'IDE et Claude Code. Autre option (Windows 11 22H2+) : basculer WSL2 en réseau mirrored en ajoutant networkingMode=mirrored dans .wslconfig, puis wsl --shutdown.

Pour les utilisateurs WSL, pensez aussi à configurer la Claude command du plugin sous la forme wsl -d Ubuntu -- bash -lic "claude" (remplacez Ubuntu par le nom de votre distribution).

"command not found" au clic sur l'icône Claude

Le plugin ne fait rien

Sécurité : prudence avec l'auto-edit

Quand Claude Code tourne dans un IDE JetBrains avec les permissions d'auto-édition activées, il peut potentiellement modifier des fichiers de configuration de l'IDE exécutés automatiquement. Sur du code non fiable, privilégiez le mode d'approbation manuelle des modifications et vérifiez les changements avant de les accepter. Pour des sessions parallèles et isolées sur plusieurs branches, le drapeau --worktree reste la meilleure pratique — voir notre guide sur les [git worktrees et sessions parallèles avec Claude Code](/blog/claude-code-git-worktree-sessions-paralleles-2026). Et pour itérer sereinement sans craindre une mauvaise modification, le système de [checkpoints et rewind de Claude Code](/blog/claude-code-rewind-btw-fork-context-hygiene-2026) permet de revenir en arrière à tout moment.

**Et si vous arrêtiez de configurer à la main ce qu'une IA peut faire à votre place ?** Intégrer Claude Code à votre IDE n'est que la première marche. Découvrez comment déléguer des pans entiers de votre développement à des agents Claude Code orchestrés et bien configurés : [**se faire remplacer par l'IA**](https://go.saas-ia.io/se-faire-remplacer-par-lia). Vous y verrez des workflows complets, du setup IDE jusqu'aux équipes d'agents en production.

FAQ : Claude Code et JetBrains<a id="faq"></a>

Comment installer Claude Code dans IntelliJ IDEA ?

Ouvrez Settings → Plugins → Marketplace, cherchez "Claude Code", installez le plugin officiel Claude Code [Beta] d'Anthropic, puis redémarrez complètement IntelliJ. Le plugin requiert le CLI claude installé séparément (vérifiez avec claude --version). Lancez ensuite claude dans le terminal intégré pour activer l'intégration.

Le plugin Claude Code fonctionne-t-il avec PyCharm et WebStorm ?

Oui. Le plugin Claude Code est compatible avec la plupart des IDE JetBrains : IntelliJ IDEA, PyCharm, WebStorm, PhpStorm, GoLand et Android Studio. La procédure d'installation est identique sur tous (Settings → Plugins → Marketplace).

Quelle différence entre le plugin JetBrains et l'extension VS Code ?

Les deux exposent les mêmes fonctionnalités d'intégration (diff viewer natif, partage de sélection, diagnostics, raccourcis de référence de fichiers). La différence principale est l'IDE hôte. Côté JetBrains, l'agent passe par le terminal intégré ou la commande /ide. Dans les deux cas, c'est le même moteur Claude Code et le même historique de sessions, donc vous pouvez basculer d'un éditeur à l'autre sans perdre votre travail.

À quoi sert la commande /ide dans Claude Code ?

/ide connecte une session Claude Code lancée dans un terminal externe à votre IDE JetBrains (ou VS Code), pour activer le diff viewer natif, le partage de sélection et les diagnostics. Si vous lancez claude directement dans le terminal intégré de l'IDE, la connexion est automatique et /ide n'est pas nécessaire.

Pourquoi Claude Code affiche "No available IDEs detected" ?

Le plus souvent sous WSL2 : le réseau NAT ou le pare-feu Windows bloque la connexion entre WSL2 et l'IDE Windows. Ajoutez une règle de pare-feu autorisant le trafic interne WSL2, ou basculez WSL2 en réseau mirrored (Windows 11 22H2+). Vérifiez aussi que le plugin est installé/activé, que vous lancez Claude depuis la racine du projet, et redémarrez l'IDE.

Faut-il une clé API pour utiliser Claude Code dans JetBrains ?

Non. Claude Code fonctionne avec n'importe quel abonnement Claude payant (Pro, Max, Team, Enterprise) ou un compte Claude Console, sans clé API. Vous vous connectez simplement au premier lancement de claude. Une clé API n'est nécessaire que pour des intégrations via fournisseurs tiers (Bedrock, Vertex AI).

Pour aller plus loin : faire de votre IDE un vrai poste de dev IA

Installer Claude Code dans JetBrains est l'une des meilleures décisions de productivité que vous puissiez prendre en 2026 si vous vivez dans IntelliJ, PyCharm ou WebStorm. Cinq minutes de setup, un diff viewer natif, le partage automatique du contexte — et votre IDE devient un environnement de dev assisté par IA qui rivalise avec n'importe quel éditeur "agent-first".

La prochaine étape consiste à bien configurer l'agent et à automatiser vos workflows récurrents. C'est exactement ce que couvre notre formation : du setup IDE jusqu'aux équipes d'agents en production. Et pour les équipes qui automatisent leurs APIs et leurs flux de données, les ressources sur l'[intégration d'APIs et de données côté immoapi.app](https://immoapi.app) complètent bien le sujet MCP.

Pour continuer à maîtriser Claude Code :