> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# JetBrains IDEs
> Utilisez Claude Code avec les IDEs JetBrains, notamment IntelliJ, PyCharm, WebStorm et bien d'autres
Claude Code s'intègre aux IDEs JetBrains via un plugin dédié, offrant des fonctionnalités telles que l'affichage interactif des différences, le partage du contexte de sélection, et bien d'autres.
IDEs supportés
Le plugin Claude Code fonctionne avec la plupart des IDEs JetBrains, notamment :
* IntelliJ IDEA
* PyCharm
* Android Studio
* WebStorm
* PhpStorm
* GoLand
Fonctionnalités
* **Lancement rapide** : Utilisez `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) pour ouvrir Claude Code directement depuis votre éditeur, ou cliquez sur le bouton Claude Code dans l'interface utilisateur
* **Affichage des différences** : Les modifications de code peuvent être affichées directement dans la visionneuse de différences de l'IDE au lieu du terminal
* **Contexte de sélection** : La sélection actuelle ou l'onglet dans l'IDE est automatiquement partagé avec Claude Code. Les [règles de refus `Read`](/fr/permissions#read-and-edit) bloquent ce partage pour les fichiers correspondants
* **Raccourcis de référence de fichier** : Utilisez `Cmd+Option+K` (Mac) ou `Alt+Ctrl+K` (Linux/Windows) pour insérer des références de fichier telles que `@src/auth.ts#L1-99`
* **Partage des diagnostics** : Les erreurs de diagnostic de l'IDE, telles que les erreurs de lint et de syntaxe, sont automatiquement partagées avec Claude au fur et à mesure que vous travaillez
Installation
Le plugin exécute la commande `claude` dans le terminal intégré de votre IDE et s'y connecte. Il ne regroupe pas sa propre copie de la CLI, donc installez les deux éléments :
Suivez le [guide de démarrage rapide](/fr/quickstart) pour installer la CLI si vous ne l'avez pas déjà fait. Le plugin affiche une notification ' Impossible de lancer Claude Code ' lorsque `claude` ne se trouve pas sur votre PATH.
Installez le [plugin Claude Code](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) depuis la Marketplace JetBrains et redémarrez votre IDE.
Si `claude` est installé quelque part que votre IDE ne peut pas trouver, définissez le chemin complet dans les [paramètres de commande Claude](#general-settings) du plugin.
Claude Code fonctionne avec n'importe quel abonnement Claude payant (Pro, Max, Team ou Enterprise) ou un compte Claude Console, et aucune clé API n'est requise. Vous serez invité à [vous connecter](/fr/authentication#log-in-to-claude-code) la première fois que vous exécutez `claude`.
Après l'installation du plugin, vous devrez peut-être redémarrer complètement votre IDE pour que les modifications prennent effet.
Utilisation
Depuis votre IDE
Exécutez `claude` depuis le terminal intégré de votre IDE, et toutes les fonctionnalités d'intégration seront actives.
Depuis des terminaux externes
Utilisez la commande `/ide` dans n'importe quel terminal externe pour connecter Claude Code à votre IDE JetBrains et activer toutes les fonctionnalités :
```bash theme={null}
claude
```
```text theme={null}
/ide
```
Si vous souhaitez que Claude ait accès aux mêmes fichiers que votre IDE, démarrez Claude Code à partir du même répertoire que la racine du projet de votre IDE.
Configuration
Paramètres de Claude Code
Configurez l'intégration de l'IDE via les paramètres de Claude Code :
1. Exécutez `claude`
2. Entrez la commande `/config`
3. Définissez l'outil de différence sur `auto` pour afficher les différences dans l'IDE, ou `terminal` pour les conserver dans le terminal
Paramètres du plugin
Configurez le plugin Claude Code en accédant à **Paramètres → Outils → Claude Code \[Beta]** :
Paramètres généraux
* **Commande Claude** : Spécifiez une commande personnalisée pour exécuter Claude, par exemple `claude`, `/usr/local/bin/claude`, ou `npx @anthropic-ai/claude-code`
* **Supprimer la notification pour la commande Claude non trouvée** : Ignorez les notifications concernant la non-détection de la commande Claude
* **Activer l'utilisation d'Option+Entrée pour les invites multi-lignes** : Sur macOS uniquement. Lorsqu'elle est activée, Option+Entrée insère de nouvelles lignes dans les invites Claude Code. Désactivez si la touche Option est capturée de manière inattendue. Nécessite un redémarrage du terminal.
* **Activer les mises à jour automatiques** : Vérifiez automatiquement et installez les mises à jour du plugin, appliquées au redémarrage
Pour les utilisateurs WSL : Définissez `wsl -d Ubuntu -- bash -lic "claude"` comme votre commande Claude (remplacez `Ubuntu` par le nom de votre distribution WSL)
Configuration de la touche ESC
Si la touche ESC n'interrompt pas les opérations Claude Code dans les terminaux JetBrains :
1. Accédez à **Paramètres → Outils → Terminal**
2. Soit :
* Décochez « Déplacer le focus vers l'éditeur avec Échap », soit
* Cliquez sur « Configurer les raccourcis clavier du terminal » et supprimez le raccourci « Basculer le focus vers l'éditeur »
3. Appliquez les modifications
Cela permet à la touche ESC d'interrompre correctement les opérations Claude Code.
Configurations spéciales
Développement à distance
Lors de l'utilisation du développement à distance JetBrains, vous devez installer le plugin sur l'hôte distant via **Paramètres → Plugin (Hôte)**.
Le plugin doit être installé sur l'hôte distant, et non sur votre machine cliente locale.
Configuration WSL
Si vous utilisez Claude Code sur WSL2 avec un IDE JetBrains et que vous voyez « Aucun IDE disponible détecté », la cause est généralement le réseau NAT de WSL2 ou le Pare-feu Windows bloquant la connexion entre WSL2 et l'IDE s'exécutant sur l'hôte Windows. WSL1 utilise directement le réseau de l'hôte et n'est pas affecté.
Autoriser le trafic WSL2 via le Pare-feu Windows
Ceci est la correction recommandée car elle conserve votre mode de mise en réseau WSL2 existant.
Depuis votre shell WSL, exécutez :
```bash theme={null}
hostname -I
```
Notez le sous-réseau, par exemple `172.21.123.45` se trouve dans `172.21.0.0/16`.
Ouvrez PowerShell en tant qu'administrateur et exécutez ce qui suit, en ajustant la plage d'adresses IP pour correspondre à votre sous-réseau :
```powershell theme={null}
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
```
Fermez et rouvrez les deux pour que la nouvelle règle prenne effet.
Basculer WSL2 vers la mise en réseau en miroir
La mise en réseau en miroir nécessite Windows 11 22H2 ou version ultérieure. Si vous êtes sur Windows 10, utilisez la règle de pare-feu ci-dessus à la place.
Ajoutez ceci à `.wslconfig` dans votre répertoire utilisateur Windows :
```ini theme={null}
[wsl2]
networkingMode=mirrored
```
Ensuite, redémarrez WSL avec `wsl --shutdown` depuis PowerShell.
Dépannage
Le plugin ne fonctionne pas
Si le plugin est installé mais que les fonctionnalités Claude Code n'apparaissent pas dans votre IDE :
* Assurez-vous que vous exécutez Claude Code à partir du répertoire racine du projet
* Vérifiez que le plugin JetBrains est activé dans les paramètres de l'IDE
* Redémarrez complètement l'IDE (vous devrez peut-être le faire plusieurs fois)
* Pour le développement à distance, assurez-vous que le plugin est installé sur l'hôte distant
IDE non détecté
Si l'exécution de `claude` affiche « Aucun IDE disponible détecté » :
* Vérifiez que le plugin est installé et activé
* Redémarrez complètement l'IDE
* Vérifiez que vous exécutez Claude Code à partir du terminal intégré
* Pour les utilisateurs WSL, consultez la [configuration WSL](#wsl-configuration) ci-dessus
Commande non trouvée
Si cliquer sur l'icône Claude affiche « commande non trouvée » :
1. Vérifiez que Claude Code est installé en exécutant `claude --version` dans un terminal
2. Configurez le chemin de la commande Claude dans les paramètres du plugin
3. Pour les utilisateurs WSL, utilisez le format de commande WSL mentionné dans la section configuration
Considérations de sécurité
Lorsque Claude Code s'exécute dans un IDE JetBrains en mode de permission [`acceptEdits`](/fr/permission-modes#auto-approve-file-edits-with-acceptedits-mode), il peut être en mesure de modifier les fichiers de configuration de l'IDE qui peuvent être exécutés automatiquement par votre IDE. Cela peut augmenter le risque d'exécution de Claude Code en mode `acceptEdits` et permettre de contourner les invites de permission de Claude Code pour l'exécution bash.
Lors de l'exécution dans les IDEs JetBrains, considérez :
* L'utilisation du mode d'approbation manuelle pour les modifications
* La prise de précautions supplémentaires pour vous assurer que Claude n'est utilisé qu'avec des invites de confiance
* La sensibilisation aux fichiers auxquels Claude Code a accès pour les modifier
Pour les problèmes d'installation ou de connexion de Claude Code en dehors de l'IDE, consultez [Dépannage de l'installation et de la connexion](/fr/troubleshoot-install).