Accueil › Claude Code › JetBrains

Claude Code JetBrains : intégrer l’agent IA dans votre IDE préféré

Le plugin Claude Code [Beta] connecte le terminal Claude Code aux IDEs JetBrains (IntelliJ IDEA, PyCharm, WebStorm, GoLand, PhpStorm, Android Studio). Les modifications de code s’affichent dans le diff viewer natif de l’IDE, le contexte de sélection est partagé automatiquement, et les diagnostics (lint, erreurs de compilation) sont transmis à Claude en temps réel.

Comment fonctionne l’intégration

Contrairement à l’extension VS Code qui offre une interface graphique native, le plugin JetBrains fonctionne comme un pont intelligent entre le CLI Claude Code et votre IDE. Le plugin orchestre le terminal et utilise le diff viewer de l’IDE pour les flux de revue et d’acceptation des modifications.

Concrètement, Claude Code tourne dans le terminal intégré de votre IDE JetBrains. Le plugin ajoute quatre capacités par-dessus cette base terminale.

Diff viewer natif. Quand Claude propose des modifications, elles s’ouvrent dans le diff viewer JetBrains que vous utilisez déjà pour Git. Vous pouvez revoir, ajuster et accepter ou rejeter les changements ligne par ligne, dans un environnement familier. C’est un gain énorme par rapport à la lecture de diffs dans le terminal.

Contexte de sélection automatique. Le plugin transmet automatiquement le fichier ouvert et le bloc de code sélectionné à Claude Code. Vous n’avez pas besoin de taper « je regarde UserService.java lignes 50-75 » : Claude le sait déjà.

Partage de diagnostics. Les erreurs, avertissements et indicateurs de lint de l’IDE sont partagés avec Claude en temps réel. Vous pouvez simplement demander « corrige ces erreurs TypeScript » sans copier-coller un seul message d’erreur.

Raccourcis de lancement. Cmd+Esc (Mac) ou Ctrl+Esc (Windows/Linux) ouvre Claude Code avec tout le contexte courant prêt à l’emploi.

Installation pas à pas

Prérequis

Avant d’installer le plugin, trois éléments doivent être en place.

Node.js (version LTS recommandée) pour le CLI Claude Code. Vérifiez avec node --version.

Claude Code CLI installé globalement. Si ce n’est pas fait, exécutez :

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

Un abonnement Claude actif. Le plan Pro ($20/mois) est le minimum requis. Les plans Max, Team et Enterprise donnent accès à des fonctionnalités supplémentaires comme la fenêtre de contexte d’1M tokens.

Installer le plugin

Étape 1. Ouvrez votre IDE JetBrains et allez dans Settings (ou Preferences sur Mac) > Plugins > Marketplace.

Étape 2. Recherchez « Claude Code [Beta] ». Vérifiez que l’éditeur est bien « Anthropic PBC » pour éviter les plugins tiers non officiels.

Étape 3. Cliquez sur Install, puis redémarrez complètement l’IDE. Un simple redémarrage du plugin ne suffit pas toujours : le redémarrage complet de l’IDE est nécessaire pour que le plugin soit pleinement activé.

Étape 4. Ouvrez le terminal intégré de l’IDE (View > Tool Windows > Terminal), naviguez vers la racine de votre projet et lancez :

claude

Toutes les fonctionnalités d’intégration s’activent automatiquement. Si c’est votre première utilisation, Claude Code vous demandera de vous authentifier via votre navigateur.

Configuration du plugin

Les paramètres du plugin sont accessibles via Settings > Tools > Claude Code [Beta]. Plusieurs options méritent votre attention.

Claude command. Spécifiez la commande pour lancer Claude si le chemin par défaut ne fonctionne pas. Options courantes : claude, /usr/local/bin/claude, ou npx @anthropic-ai/claude-code.

Diff tool. Réglez sur auto pour que Claude Code détecte automatiquement l’IDE et utilise son diff viewer natif.

Option+Enter pour multi-lignes (macOS). Quand activé, Option+Enter insère des sauts de ligne dans les prompts Claude Code. Désactivez cette option si la touche Option est capturée de façon inattendue (nécessite un redémarrage du terminal).

Mises à jour automatiques. Active la vérification et l’installation automatique des mises à jour du plugin (appliquées au redémarrage).

Correction ESC. Si la touche Esc n’interrompt pas les opérations dans le terminal Claude Code, allez dans Settings > Tools > Terminal et vérifiez la configuration de la touche Escape.

Raccourcis clavier et workflow quotidien

Raccourcis principaux

Workflow type dans JetBrains

Un workflow quotidien typique avec Claude Code dans un IDE JetBrains suit ce schéma.

1. Ouverture de session. Ouvrez votre projet dans l’IDE. Lancez Cmd+Esc (ou Ctrl+Esc) pour ouvrir Claude Code. Claude charge automatiquement le CLAUDE.md de votre projet et connaît la structure de votre codebase.

2. Sélection + question. Sélectionnez un bloc de code dans l’éditeur. Claude Code reçoit automatiquement le contexte de votre sélection. Posez votre question ou donnez votre instruction. Par exemple : « Refactore cette méthode pour utiliser async/await au lieu des callbacks ».

3. Revue dans le diff viewer. Claude propose ses modifications. Elles s’ouvrent dans le diff viewer natif de JetBrains. Vous pouvez accepter ou rejeter chaque changement individuellement, exactement comme pour un merge Git.

4. Diagnostic automatique. Si le code modifié génère des erreurs, les diagnostics de l’IDE sont automatiquement partagés avec Claude. Demandez « corrige les erreurs » et Claude les voit sans que vous ayez à copier quoi que ce soit.

5. Itération. Continuez l’échange jusqu’à ce que le code soit satisfaisant. Utilisez /clear entre les tâches non liées pour garder un contexte propre.

Cas d’usage concrets dans JetBrains

Refactoring multi-fichiers

C’est le cas d’usage où Claude Code dans JetBrains brille le plus. Contrairement aux outils d’autocomplétion qui travaillent fichier par fichier, Claude Code raisonne sur l’ensemble du projet. Des développeurs rapportent avoir demandé à Claude d’ajouter des champs à une table de base de données dans un projet .NET : Claude a créé les modèles, les migrations, les repositories, les services et les endpoints API en une quinzaine de minutes, en respectant le style existant du projet.

Ajoute un champ "lastLoginAt" (DateTime) à l'entité User.
Mets à jour le modèle, crée la migration, adapte le repository,
le service et l'endpoint API. Assure-toi que le code compile
et respecte les patterns existants du projet.

Debugging avec contexte IDE

Le partage de diagnostics rend le debugging beaucoup plus fluide. Quand votre IDE affiche des erreurs (lignes rouges, avertissements), Claude Code les voit en temps réel.

J'ai 3 erreurs TypeScript dans le fichier ouvert.
Corrige-les en respectant les types existants du projet.
Explique ce qui causait chaque erreur.

Revue de code locale

Avant de soumettre une PR, utilisez Claude Code pour un premier passage de revue directement dans l’IDE.

Revue les changements que j'ai faits depuis le dernier commit.
Cherche les bugs potentiels, les problèmes de sécurité
et les violations des conventions du projet.
Utilise "git diff" pour voir les changements.

Claude exécute git diff, analyse les changements dans le contexte de la codebase complète, et poste ses trouvailles. Les corrections proposées s’ouvrent dans le diff viewer pour revue.

Génération de tests

Sélectionnez une classe ou une méthode dans l’éditeur, puis demandez à Claude de générer les tests correspondants. Claude détecte automatiquement le framework de test utilisé dans le projet (JUnit, pytest, Jest, etc.) grâce au CLAUDE.md ou à l’analyse du projet.

Écris les tests unitaires pour la classe sélectionnée.
Couvre les cas normaux, les edge cases et les erreurs.
Utilise le framework de test déjà en place dans le projet.

JetBrains vs VS Code : quelle intégration choisir ?

Le choix dépend de votre écosystème et de vos habitudes. Si vous êtes dans l’écosystème JetBrains (IntelliJ pour Java/Kotlin, PyCharm pour Python, WebStorm pour JavaScript), le plugin vous permet de rester dans votre IDE sans changer d’outil. L’avantage principal est le diff viewer JetBrains, que beaucoup de développeurs considèrent supérieur à celui de VS Code pour les revues complexes.

Si vous êtes flexible sur l’IDE, l’extension VS Code offre une intégration plus poussée avec un panneau dédié et une interface de chat graphique. Certains développeurs qui avaient migré vers Cursor reviennent vers JetBrains grâce au plugin Claude Code, trouvant que la combinaison JetBrains + Claude Code dépasse Cursor pour les tâches complexes multi-fichiers.

Claude Code vs JetBrains AI Assistant vs Junie

L’écosystème JetBrains propose ses propres outils IA qu’il faut distinguer du plugin Claude Code.

JetBrains AI Assistant est l’offre IA intégrée de JetBrains, vendue comme un abonnement séparé ($8,33/mois en annuel). Il utilise des modèles variés (dont Claude) en backend. L’avantage : une intégration graphique profonde dans l’IDE. L’inconvénient : pas d’option « bring your own key », vous payez l’abonnement JetBrains AI en plus de votre abonnement Claude, et vous n’avez pas le contrôle sur le modèle exact utilisé.

Junie est l’agent de coding de JetBrains, conçu pour des tâches autonomes dans l’IDE. Il utilise aussi des modèles LLM en backend et s’intègre nativement aux fonctionnalités JetBrains. C’est un concurrent direct de Claude Code dans l’écosystème JetBrains.

Claude Code (plugin) utilise directement l’API Anthropic avec vos propres credentials. Vous contrôlez le modèle (Opus 4.6, Sonnet 4.6), vous bénéficiez de toutes les fonctionnalités Claude Code (sous-agents, hooks, skills, mode CLI) et le coût est celui de votre abonnement Claude existant.

Notre avis : si vous avez déjà un abonnement Claude Pro ou Max, le plugin Claude Code est le choix le plus logique. Vous évitez un abonnement supplémentaire, vous gardez le contrôle sur le modèle, et vous bénéficiez de l’écosystème complet Claude Code (commandes custom, CLAUDE.md, intégration GitHub, mode CLI). JetBrains AI Assistant est pertinent si vous voulez une interface plus graphique et que vous n’avez pas d’abonnement Claude.

Remote Development et WSL

JetBrains Remote Development

Si vous utilisez JetBrains Remote Development (Gateway), le plugin doit être installé sur l’hôte distant, pas sur votre machine locale. Allez dans Settings > Plugin (Host) pour installer le plugin côté serveur.

Windows Subsystem for Linux (WSL)

Les utilisateurs WSL nécessitent souvent une configuration supplémentaire pour que la détection de l’IDE fonctionne correctement. Points à vérifier :

Assurez-vous d’utiliser WSL 2 (WSL 1 ne supporte pas le sandboxing de Claude Code). Vérifiez que le CLI Claude Code est installé dans l’environnement WSL (pas Windows). Si l’IDE ne détecte pas Claude Code, spécifiez le chemin complet dans les paramètres du plugin (Settings > Tools > Claude Code [Beta] > Claude command).

Consultez le guide de dépannage WSL dans la documentation officielle pour les instructions détaillées de configuration.

Considérations de sécurité spécifiques à JetBrains

L’intégration JetBrains introduit un risque spécifique que vous devez connaître. Quand Claude Code tourne dans un IDE JetBrains avec les permissions d’auto-edit activées, il peut potentiellement modifier des fichiers de configuration de l’IDE qui sont exécutés automatiquement. Cela pourrait théoriquement permettre de contourner les invites de permission Bash de Claude Code.

Les recommandations d’Anthropic pour atténuer ce risque : préférez le mode Normal (avec approbation manuelle) plutôt que le mode Auto-accept quand vous travaillez sur des dépôts non audités. Soyez conscient des fichiers auxquels Claude Code a accès et qu’il peut modifier. Utilisez le sandboxing pour une isolation au niveau OS. Et vérifiez toujours les modifications proposées dans le diff viewer avant de les accepter.

Dépannage

Le diff viewer ne s’ouvre pas

Vérifiez que vous avez redémarré l’IDE après l’installation du plugin (pas juste rechargé les plugins). Confirmez que le CLI fonctionne dans le terminal intégré (claude --version). Assurez-vous d’avoir des fichiers ouverts dans l’IDE. Si le problème persiste, vérifiez que le paramètre diff tool est sur auto dans les settings du plugin.

Erreur de connexion

Les proxies d’entreprise et les certificats personnalisés sont la cause la plus fréquente. Configurez HTTPS_PROXY/HTTP_PROXY dans vos variables d’environnement. Si nécessaire, pointez NODE_EXTRA_CA_CERTS vers votre bundle de certificats. Lancez /doctor dans Claude Code pour diagnostiquer l’environnement.

Le terminal est instable

C’est un retour fréquent pendant la phase beta. L’écran peut sauter ou les sorties peuvent être désordonnées pendant que Claude réfléchit. Quelques atténuations : augmentez la taille du buffer du terminal dans les settings de l’IDE, utilisez /compact régulièrement pour réduire la taille du contexte, et n’hésitez pas à /clear entre les tâches.

La touche Esc ne fonctionne pas

Allez dans Settings > Tools > Terminal et vérifiez les keybindings. Le terminal JetBrains peut capturer Esc avant que Claude Code ne le reçoive. Certains plugins de keymap (vim, IdeaVim) peuvent aussi interférer.

Questions fréquentes