Unterstützte IDEs
Das Claude Code Plugin funktioniert mit den meisten JetBrains IDEs, einschließlich:- IntelliJ IDEA
- PyCharm
- Android Studio
- WebStorm
- PhpStorm
- GoLand
Funktionen
- Schnellstart: Verwenden Sie
Cmd+Esc(Mac) oderCtrl+Esc(Windows/Linux), um Claude Code direkt aus Ihrem Editor zu öffnen, oder klicken Sie auf die Claude Code Schaltfläche in der Benutzeroberfläche - Diff-Anzeige: Code-Änderungen können direkt im IDE Diff-Viewer anstelle des Terminals angezeigt werden
- Auswahlkontext: Die aktuelle Auswahl oder der aktuelle Tab in der IDE wird automatisch mit Claude Code geteilt.
ReadAblehnungsregeln blockieren diese Freigabe für übereinstimmende Dateien - Dateireferenz-Verknüpfungen: Verwenden Sie
Cmd+Option+K(Mac) oderAlt+Ctrl+K(Linux/Windows), um Dateireferenzen wie@src/auth.ts#L1-99einzufügen - Diagnose-Freigabe: Diagnosefehler aus der IDE, wie Lint- und Syntaxfehler, werden automatisch mit Claude geteilt, während Sie arbeiten
Installation
Das Plugin führt denclaude-Befehl im integrierten Terminal Ihrer IDE aus und verbindet sich damit. Es bündelt keine eigene Kopie der CLI, daher installieren Sie beide Komponenten:
1
Installieren Sie die Claude Code CLI
Folgen Sie dem Schnellstart, um die CLI zu installieren, falls Sie dies noch nicht getan haben. Das Plugin zeigt eine Benachrichtigung ‘Claude Code kann nicht gestartet werden” an, wenn
claude nicht in Ihrem PATH vorhanden ist.2
Installieren Sie das JetBrains-Plugin
Installieren Sie das Claude Code Plugin aus dem JetBrains Marketplace und starten Sie Ihre IDE neu.
claude an einem Ort installiert ist, den Ihre IDE nicht finden kann, legen Sie den vollständigen Pfad in der Claude-Befehlseinstellung des Plugins fest.
Claude Code funktioniert mit jedem bezahlten Claude-Abonnement (Pro, Max, Team oder Enterprise) oder einem Claude Console-Konto, und es ist kein API-Schlüssel erforderlich. Sie werden aufgefordert, sich anzumelden, wenn Sie claude zum ersten Mal ausführen.
Nach der Installation des Plugins müssen Sie Ihre IDE möglicherweise vollständig neu starten, damit es wirksam wird.
Verwendung
Aus Ihrer IDE
Führen Sieclaude aus dem integrierten Terminal Ihrer IDE aus, und alle Integrationsfunktionen sind aktiv.
Aus externen Terminals
Verwenden Sie den/ide Befehl in einem beliebigen externen Terminal, um Claude Code mit Ihrer JetBrains IDE zu verbinden und alle Funktionen zu aktivieren:
Konfiguration
Claude Code Einstellungen
Konfigurieren Sie die IDE-Integration durch Claude Code Einstellungen:- Führen Sie
claudeaus - Geben Sie den
/configBefehl ein - Stellen Sie das Diff-Tool auf
autoein, um Diffs in der IDE anzuzeigen, oder aufterminal, um sie im Terminal zu behalten
Plugin-Einstellungen
Konfigurieren Sie das Claude Code Plugin, indem Sie zu Einstellungen → Tools → Claude Code [Beta] gehen:Allgemeine Einstellungen
- Claude Befehl: Geben Sie einen benutzerdefinierten Befehl an, um Claude auszuführen, zum Beispiel
claude,/usr/local/bin/claudeodernpx @anthropic-ai/claude-code - Benachrichtigung für Claude-Befehl nicht gefunden unterdrücken: Überspringen Sie Benachrichtigungen über das Nichtfinden des Claude-Befehls
- Option+Enter für mehrzeilige Eingabeaufforderungen aktivieren: Nur auf macOS. Wenn aktiviert, fügt Option+Enter neue Zeilen in Claude Code Eingabeaufforderungen ein. Deaktivieren Sie dies, wenn die Option-Taste unerwartet erfasst wird. Erfordert einen Terminal-Neustart.
- Automatische Updates aktivieren: Automatisch nach Plugin-Updates suchen und diese installieren, angewendet beim Neustart
ESC-Taste Konfiguration
Wenn die ESC-Taste Claude Code Operationen in JetBrains Terminals nicht unterbricht:- Gehen Sie zu Einstellungen → Tools → Terminal
- Entweder:
- Deaktivieren Sie „Fokus mit Escape zum Editor verschieben”, oder
- Klicken Sie auf „Terminal-Tastenkombinationen konfigurieren” und löschen Sie die Verknüpfung „Fokus zum Editor wechseln”
- Wenden Sie die Änderungen an
Spezielle Konfigurationen
Remote-Entwicklung
Das Plugin muss auf dem Remote-Host installiert werden, nicht auf Ihrem lokalen Client-Computer.WSL-Konfiguration
Wenn Sie Claude Code auf WSL2 mit einer JetBrains IDE verwenden und „Keine verfügbaren IDEs erkannt” sehen, ist die Ursache normalerweise WSL2s NAT-Netzwerk oder die Windows Firewall, die die Verbindung zwischen WSL2 und der IDE blockiert, die auf dem Windows-Host ausgeführt wird. WSL1 verwendet das Netzwerk des Hosts direkt und ist nicht betroffen.WSL2-Datenverkehr durch Windows Firewall zulassen
Dies ist die empfohlene Lösung, da sie Ihren vorhandenen WSL2-Netzwerkmodus beibehält.1
Finden Sie Ihre WSL2 IP-Adresse
Führen Sie in Ihrer WSL-Shell Folgendes aus:Notieren Sie sich das Subnetz, zum Beispiel
172.21.123.45 befindet sich in 172.21.0.0/16.2
Erstellen Sie eine Firewall-Regel
Öffnen Sie PowerShell als Administrator und führen Sie Folgendes aus, passen Sie den IP-Bereich an Ihr Subnetz an:
3
Starten Sie Ihre IDE und Claude Code neu
Schließen Sie beide und öffnen Sie sie erneut, damit die neue Regel wirksam wird.
Wechseln Sie WSL2 zu gespiegeltem Netzwerk
Gespiegeltes Netzwerk erfordert Windows 11 22H2 oder später. Wenn Sie Windows 10 verwenden, verwenden Sie stattdessen die Firewall-Regel oben. Fügen Sie dies zu.wslconfig in Ihrem Windows-Benutzerverzeichnis hinzu:
wsl --shutdown von PowerShell neu.
Troubleshooting
Plugin funktioniert nicht
Wenn das Plugin installiert ist, aber Claude Code Funktionen nicht in Ihrer IDE angezeigt werden:- Stellen Sie sicher, dass Sie Claude Code aus dem Projektstammverzeichnis ausführen
- Überprüfen Sie, dass das JetBrains Plugin in den IDE-Einstellungen aktiviert ist
- Starten Sie die IDE vollständig neu (möglicherweise müssen Sie dies mehrmals tun)
- Stellen Sie für Remote Development sicher, dass das Plugin auf dem Remote-Host installiert ist
IDE nicht erkannt
Wenn das Ausführen vonclaude ‘Keine verfügbaren IDEs erkannt” anzeigt:
- Überprüfen Sie, dass das Plugin installiert und aktiviert ist
- Starten Sie die IDE vollständig neu
- Überprüfen Sie, dass Sie Claude Code aus dem integrierten Terminal ausführen
- Für WSL-Benutzer lesen Sie WSL-Konfiguration oben
Befehl nicht gefunden
Wenn das Klicken auf das Claude-Symbol „Befehl nicht gefunden” anzeigt:- Überprüfen Sie, dass Claude Code installiert ist, indem Sie
claude --versionin einem Terminal ausführen - Konfigurieren Sie den Claude-Befehlspfad in den Plugin-Einstellungen
- Für WSL-Benutzer verwenden Sie das WSL-Befehlsformat, das im Konfigurationsabschnitt erwähnt wird
Sicherheitsaspekte
Wenn Claude Code in einer JetBrains IDE imacceptEdits Berechtigungsmodus ausgeführt wird, kann es möglicherweise IDE-Konfigurationsdateien ändern, die automatisch von Ihrer IDE ausgeführt werden können. Dies kann das Risiko der Ausführung von Claude Code im acceptEdits Modus erhöhen und es ermöglichen, Claude Code Berechtigungsaufforderungen für die Bash-Ausführung zu umgehen.
Bei der Ausführung in JetBrains IDEs sollten Sie Folgendes beachten:
- Verwenden Sie den manuellen Genehmigungsmodus für Bearbeitungen
- Achten Sie besonders darauf, dass Claude nur mit vertrauenswürdigen Eingabeaufforderungen verwendet wird
- Seien Sie sich bewusst, welche Dateien Claude Code ändern kann
Der integrierte IDE MCP Server
Wenn das Plugin aktiv ist, führt es einen lokalen MCP Server aus, mit dem sich die CLI automatisch verbindet. Auf diese Weise öffnet die CLI Diffs im nativen Diff-Viewer der IDE, liest Ihre aktuelle Auswahl für@-Erwähnungen und zieht Inspektionsdiagnostiken in das Gespräch.
Der Server heißt ide und ist in /mcp verborgen, da es nichts zu konfigurieren gibt. Wenn Ihre Organisation jedoch einen PreToolUse Hook verwendet, um MCP-Tools auf eine Zulassungsliste zu setzen, müssen Sie wissen, dass er existiert.
Auswahl und Kontext der offenen Datei. Während der Verbindung bezieht die CLI Ihre aktuelle Editor-Auswahl und den Pfad der aktiven Datei als Kontext in jeden Prompt ein, den Sie senden. Das Transkript zeigt eine ⧉ Selected N lines from <file> Zeile, wenn dies geschieht. Um eine sensible Datei wie .env auszuschließen, fügen Sie eine Read Ablehnungsregel für ihren Pfad hinzu. Eine entsprechende Ablehnungsregel verhindert, dass sowohl der ausgewählte Text als auch die Benachrichtigung über die offene Datei für diese Datei Claude erreichen.
Transport und Authentifizierung. Der Server lauscht auf einem vom Betriebssystem zugewiesenen kurzlebigen Port, und der Port ist nicht konfigurierbar. Der Transport ist unverschlüsseltes ws://; auf Loopback kann jeder Prozess, der den Datenverkehr erfassen kann, auch das Token aus der Lock-Datei lesen, daher würde TLS keinen Schutz gegen einen lokalen Angreifer bieten. Jeder IDE-Start generiert ein neues zufälliges Auth-Token, schreibt es in eine Lock-Datei unter ~/.claude/ide/<port>.lock, und die CLI muss es als X-Claude-Code-Ide-Authorization Header präsentieren, um sich zu verbinden. Wenn CLAUDE_CONFIG_DIR gesetzt ist, wird die Lock-Datei stattdessen in $CLAUDE_CONFIG_DIR/ide/ geschrieben.
Dem Modell ausgesetzte Tools. Der Server hostet mehrere Tools, aber nur eines ist für das Modell sichtbar. Der Rest ist internes RPC, das die CLI für ihre eigene Benutzeroberfläche verwendet, wie das Öffnen von Diffs und das Lesen von Auswahlen, und wird gefiltert, bevor die Werkzeugliste Claude erreicht.
Das JetBrains Plugin stellt dem Modell kein Code-Ausführungs-Tool zur Verfügung.
Listening-Schnittstelle. Welche Netzwerkschnittstelle der Server bindet, wird durch Accept connections from all network interfaces unter Settings → Tools → Claude Code [Beta] → Networking (Advanced) gesteuert. Mit der deaktivierten Einstellung lauscht der Server nur auf
127.0.0.1 und ist von anderen Hosts nicht erreichbar. Mit aktivierter Einstellung ist der Port von Ihrem lokalen Netzwerk aus erreichbar. Die Einstellung existiert für Fälle, in denen die CLI die IDE nicht über Loopback erreichen kann, wie WSL2 mit Standard-NAT-Netzwerk oder ein Remote-IDE-Setup; siehe WSL-Konfiguration für dieses Szenario.