JetBrains IDE-Integration

Claude Code über QCode in IntelliJ IDEA, WebStorm, PyCharm, GoLand und anderen JetBrains IDEs verwenden

Zuletzt überprüft: 2026-09-18 · 📄 Nach offiziellen Docs (Claude Code JetBrains-Plugin 0.1.14-beta (Marketplace; erfordert IDE ≥2024.2))

Auf einen Blick¶

Claude Code bietet ein offizielles JetBrains-Plugin. Die Dokumentation nennt sechs IDEs (Android Studio inklusive, das Ladybug 2024.2.1 oder neuer erfordert; JetBrains MPS separat 2024.3+), und die Kompatibilitätsliste im Marketplace ergänzt RubyMine, CLion, Rider, DataGrip sowie weitere IntelliJ-Plattform-IDEs – wir versprechen daher nicht „jede IntelliJ-basierte IDE“: Prüfen Sie vor der Installation die Plugin-Seite in Ihrer eigenen IDE. Dieses Guide zeigt, wie Sie das Plugin installieren und auf das QCode-Gateway ausrichten, sodass Sie Flaggschiff-Modelle wie Claude Opus 5 und Sonnet 5 zu geringeren Kosten aufrufen können.

Das Plugin teilt sich die Konfiguration mit der Kommandozeilen-Version: Solange Ihr claude CLI QCode erreicht, funktioniert auch das IDE-Plugin.

Voraussetzungen¶

1. Claude Code CLI ist installiert und funktionsfähig (Bestätigung mit claude --version; verlassen Sie sich nicht auf eine möglicherweise veraltete Versionsnummer auf dieser Seite)

2. Folgen Sie dem Installationshandbuch, um die Installation abzuschließen

3. Folgen Sie dem Umgebungsvariablen-Handbuch, um die QCode-API zu konfigurieren

4. Führen Sie claude --version im Terminal aus, um die Funktionsfähigkeit zu bestätigen

5. JetBrains IDE 2024.2 oder neuer (der Marketplace-Eintrag nennt Build 242.0 als Mindestversion, d. h. 2024.2; bei 2024.1 wird das Plugin als inkompatibel angezeigt)

6. Ein QCode-API-Key (beginnt mit cr_) – derselbe Key funktioniert für alle Endpunkte

Installationsschritte¶

Schritt 1: Das Claude Code Plugin installieren¶

1. Öffnen Sie Ihre JetBrains IDE

2. Gehen Sie zu Settings / Preferences → Plugins → Marketplace

3. Suchen Sie nach Claude Code [Beta] – das ist der tatsächliche Marketplace-Name (Herausgeber Anthropic PBC, xmlId com.anthropic.code.plugin). ⚠️ Eine Suche nach nur „Claude Code“ zeigt zunächst mehrere irrelevante Drittanbieter-Nachahmungen; installieren Sie das Plugin von Anthropic PBC

4. Klicken Sie auf Install

5. Starten Sie die IDE neu

Tipp: Falls Ihr Netzwerk den JetBrains Marketplace nicht direkt erreichen kann, laden Sie das .zip-Paket von der Plugin-Homepage herunter und installieren Sie es offline über Plugins → Zahnradsymbol → Install Plugin from Disk.... Details finden Sie in der offiziellen JetBrains-Dokumentation.

Schritt 2: QCode-Zugang konfigurieren¶

Das Plugin nutzt die Konfiguration des Claude Code CLI weiter. Im Kern sind es zwei Umgebungsvariablen:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

Nutzer in Festlandchina: Ersetzen Sie api.qcode.cc durch asia.qcode.cc, was in der Regel schneller und stabiler ist:

bash export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

Die drei Domänen api / asia / us teilen sich denselben API-Key, wählen Sie also die für Ihre Region günstigste. Die BASE_URL darf nicht mit einem Schrägstrich enden.

Tipp: JetBrains IDEs übernehmen die Systemumgebungsvariablen. Haben Sie sie bereits in ~/.zshrc oder ~/.bashrc konfiguriert, erkennt die IDE sie beim Start – sofern die IDE aus einer Umgebung gestartet wird, in der diese Konfiguration geladen wurde (siehe FAQ unten).

Wenn Sie nicht auf globale Umgebungsvariablen angewiesen sein möchten, können Sie sie stattdessen pro Projekt setzen (siehe FAQ).

Schritt 3: Überprüfung¶

1. Drücken Sie in der IDE Cmd+Esc (macOS) bzw. Ctrl+Esc (Windows/Linux), um das Claude Code Panel zu öffnen

2. Geben Sie eine einfache Nachricht ein (z. B. „hello“), um die Verbindung zu testen

3. Erhalten Sie eine normale Antwort, ist das Plugin erfolgreich über QCode verbunden

Sie können auch überprüfen, ob das Gateway selbst erreichbar ist, indem Sie curl verwenden (ein 401 bedeutet, dass der Pfad korrekt ist und nur die Authentifizierung fehlt – wie erwartet):

curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← path is correct, as expected

Nutzung¶

Tastenkürzel¶

Die tatsächlichen Kürzel hängen von der Plugin-Version und Ihrer Tastaturbelegung ab; suchen Sie unter Einstellungen → Tastaturbelegung nach „Claude“, um sie anzupassen.

Kernfunktionen¶

1. Code-Erklärung: Code auswählen → Rechtsklick → Ask Claude, um sich die Logik erklären zu lassen

2. Code-Generierung: Beschreiben Sie Ihre Anforderungen in natürlicher Sprache im Claude-Panel und lassen Sie Code generieren oder anpassen

3. Fehlerbehebung: Senden Sie einen Stacktrace oder eine Fehlermeldung an Claude zur Analyse und Lösung

4. Code-Refactoring: Wählen Sie den Zielcode aus und bitten Sie Claude, die Struktur zu verbessern, Funktionen zu extrahieren oder Tests hinzuzufügen

Native Diff-Ansicht¶

Das Plugin ist tief in JetBrains integriert: Wenn Claude Dateiänderungen vorschlägt, werden sie in der nativen Nebeneinander-Diff-Ansicht der IDE angezeigt, sodass Sie jede Änderung überprüfen, annehmen oder ablehnen können, bevor sie auf die Festplatte geschrieben wird. Das ist übersichtlicher und sicherer als ein einfaches Terminal-Diff.

Nutzung mit dem eingebauten Terminal¶

Das eingebaute Terminal in JetBrains-IDEs kann den Befehl claude auch direkt ausführen und bietet so die vollständige CLI-Erfahrung. Das Plugin übergibt automatisch die aktuell geöffnete Datei und Auswahl als Kontext an die CLI, sodass beide am besten zusammenarbeiten.

Bildeingabe (Vision)¶

Vision-fähige Modelle (Claude Opus 5 / Sonnet 5 und die GPT-5.x-Familie) können Bilder als Eingabe lesen:

• Screenshot direkt (Ctrl+V) in das Claude-Panel einfügen
• Bilddatei per Drag-and-Drop in das Chatfenster ziehen
• Pfad einer Bilddatei im Prompt referenzieren

Typische Anwendungen: UI aus einem Mockup/Screenshot nachbauen, Debugging anhand eines Fehler-Screenshots, Architekturdiagramme und Charts interpretieren.

Dies ist eine Bildeingabe, keine Bildgenerierung. Um ein Modell Bilder generieren zu lassen, verwenden Sie das Modell gpt-image-2 – siehe gpt-image-2 Bildgenerierung.

Modellauswahl¶

Im Claude-Panel können Sie mit dem Befehl /model das Modell wechseln; alle Modelle werden über denselben QCode-API-Key aufgerufen. Gängige Optionen:

Die Preise werden auf dieser Seite nicht angegeben – nutzen Sie die aktuellen Werte auf qcode.cc/models (Administratoren können die Tarife ändern).

QCode unterstützt auch GPT-5.x- und Gemini-Modelle, aber das Claude Code-Plugin für JetBrains zielt auf das Anthropic-Protokoll ab; GPT/Gemini werden besser in den jeweiligen Tools wie Codex / Antigravity verwendet. Die Stückpreise entsprechen dem, was qcode.cc/models anzeigt. IDs der 4.x-Reihe wie claude-sonnet-4-6 und claude-opus-4-8 sind weiterhin erhältlich.

Erweiterte Nutzung¶

• Dynamische Workflows: Nehmen Sie das Stichwort ultracode in Ihren Prompt auf (oder bitten Sie einfach darum, „einen Workflow auszuführen“), um Dutzende bis Hunderte von Hintergrund-Subagenten parallel für große Aufgaben zu orchestrieren (repo-weite Code-Reviews, Bulk-Migrationen, dateiübergreifende Recherche usw.). Subagenten laufen im Hintergrund, während Sie weiterarbeiten; prüfen Sie den Fortschritt mit dem Befehl /workflows. Es läuft auf dem Modell, mit dem Claude Code konfiguriert ist – funktioniert also auch bei Verbindung mit QCode. Siehe Subagenten.

• Headless / Automatisierung: Im IDE-Terminal können Sie auch claude -p "<prompt>" mit --output-format json|text|stream-json für skriptbasierte Aufrufe verwenden. json gibt ein strukturiertes Objekt mit result, total_cost_usd, usage und session_id zurück, das sich mit jq leicht parsen lässt. Siehe Automatisierung & CI/CD.

Das Plugin hat eine eigene Einstellungsseite¶

Offiziell unter Settings → Tools → Claude Code [Beta]. Dokumentiert sind folgende Optionen:

• Claude command – der Befehl, mit dem das Plugin Claude Code startet, z. B. claude, /usr/local/bin/claude, npx @anthropic-ai/claude-code. Wenn die IDE claude nicht finden kann, besteht die offizielle Lösung darin, hier einen absoluten Pfad einzutragen, statt die Art umzubauen, wie Sie die Shell starten

• Suppress notification for when Claude Command is not found – blendet den Hinweis „Befehl nicht gefunden“ aus

• Enable using Option+Enter for multi-line prompts – nur unter macOS
• Enable automatic updates – prüft auf Plugin-Updates und installiert sie; wirksam nach einem Neustart

Ein externes Terminal anbinden: /ide¶

Laut offizieller Dokumentation verbindet /ide, in Claude Code in einem beliebigen externen Terminal ausgeführt, dieses mit der laufenden JetBrains-IDE und aktiviert alle Funktionen. Bei Erfolg antwortet Claude Code mit etwas wie Connected to IntelliJ IDEA.; erkennt es eine IDE ohne das Plugin, installiert /ide das Plugin und fordert Sie zu einem Neustart auf. Mit QCode funktioniert das genauso – das externe claude verwendet die ANTHROPIC_BASE_URL, die Sie bereits konfiguriert haben.

JetBrains Remote Development: Installation auf dem Host¶

Die Dokumentation ist eindeutig: Bei JetBrains Remote Development muss das Plugin auf dem Remote-Host installiert werden, und zwar über Settings → Plugins → Plugin (Host). Eine Installation auf dem lokalen Client bewirkt nichts.

AI Assistant ist ein anderes Produkt¶

Diese Seite behandelt das Claude-Code-Plugin, das Ihre eigene claude-CLI über das Anthropic-Protokoll ansteuert, wobei die Base-URL aus einer Umgebungsvariablen stammt. JetBrains AI Assistant kann ebenfalls Modelle von Drittanbietern nutzen, jedoch über einen anderen Zugang: Settings | Tools | AI Assistant | Providers & API keys. Laut offizieller Dokumentation bietet nur der Typ „OpenAI-compatible“ ein URL-Feld – die Typen Anthropic und Gemini API-Key haben nur ein Key-Feld.

Auch die KI-Vervollständigung im AI Assistant (Inline Completion / Next Edit) akzeptiert nur einen „OpenAI Compatible“-Endpunkt. Die Dokumentation weist zudem darauf hin, dass Inline Completion Fill-in-the-Middle-Unterstützung erfordert, die allgemeinen Chat-Modellen meist fehlt.

FAQ¶

Das Claude-Code-Panel wird nicht angezeigt?¶

1. Prüfen Sie, ob das Plugin installiert und aktiviert ist (Settings → Plugins → Installed)

2. Prüfen Sie, ob die Claude-Code-CLI global installiert ist: Führen Sie claude --version in einem Terminal aus – es sollte eine Version ausgeben (siehe offizielle Releases)

3. Prüfen Sie, ob die IDE-Version ≥ 2024.2 ist

4. Starten Sie die IDE neu; falls nötig, führen Sie File → Invalidate Caches / Restart aus

Esc unterbricht die laufende Generierung nicht?¶

Offizieller Eintrag zur Fehlerbehebung: In JetBrains-Terminals wird Esc von der IDE belegt, um den Fokus in den Editor zu verschieben. Beheben Sie das unter Settings → Tools → Terminal – entweder deaktivieren Sie „Move focus to the editor with Escape“, oder Sie klicken auf „Configure terminal keybindings“ und löschen den Shortcut „Switch focus to Editor“.

Umgebungsvariablen werden nicht übernommen?¶

JetBrains-IDEs übernehmen Umgebungsvariablen aus Ihren Shell-Konfigurationsdateien unter Umständen nicht (per GUI gestartete Prozesse laden ~/.zshrc oft nicht). Lösungen:

• macOS: Starten Sie die IDE über das Terminal (z. B. open -a "IntelliJ IDEA"), statt auf das Dock-Symbol zu klicken; oder nutzen Sie Tools → Create Command-line Launcher und starten Sie die IDE damit aus einem Terminal

• Alle Plattformen: Tragen Sie ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN manuell unter Run/Debug Configurations → Environment variables ein

• Dauerhaft: Setzen Sie sie über JetBrains Toolbox, *.vmoptions oder systemweite Umgebungsvariablen, damit sie bei jedem Start gelesen werden

Authentifizierungsfehler / 401 / 403?¶

1. Prüfen Sie, ob ANTHROPIC_AUTH_TOKEN ein gültiger QCode-Key ist, der mit cr_ beginnt, ohne überflüssige Leerzeichen oder Anführungszeichen

2. Prüfen Sie, ob ANTHROPIC_BASE_URL keinen abschließenden Schrägstrich hat und der Pfad /api lautet (Anthropic-Protokoll)

3. Führen Sie curl -i https://api.qcode.cc/api/v1/messages aus: Ein 401 bedeutet, dass das Gateway erreichbar ist (es fehlt nur die Authentifizierung); ein Verbindungsfehler deutet auf ein Netzwerk- oder Proxy-Problem hin

Verbindungs-Timeouts / Zugriff hinter einem Unternehmens-Proxy blockiert?¶

• Nutzer in Festlandchina sollten zuerst auf asia.qcode.cc wechseln

• Wenn Sie sich hinter einem Unternehmens-Proxy befinden, stellen Sie sicher, dass Settings → Appearance & Behavior → System Settings → HTTP Proxy der IDE korrekt konfiguriert ist, oder setzen Sie die Umgebungsvariable HTTPS_PROXY für das Terminal

• Stellen Sie sicher, dass Ihre Firewall dem IDE-Prozess ausgehenden Zugriff auf *.qcode.cc:443 erlaubt

Umgebungsvariablen geändert, aber die IDE bemerkt es nicht?¶

Umgebungsvariablen werden nur einmal beim Prozessstart gelesen. Nachdem Sie ~/.zshrc oder Systemvariablen bearbeitet haben, müssen Sie die IDE vollständig beenden und neu starten (nicht nur ein Fenster erneut öffnen), damit die Änderungen wirksam werden.

Nächste Schritte¶

• Unter Endpunkte & API-Formate finden Sie die drei Domains und die Base-URL für jedes Protokoll

• Unter VS-Code-Integration finden Sie die VS-Code-Erweiterung

• Unter Cline-Integration finden Sie eine weitere KI-Erweiterung für VS Code

• Unter CLI-Tipps finden Sie Tipps zur Nutzung im Terminal

Sie fragen sich, welches Modell sich in JetBrains am kostengünstigsten betreiben lässt? Werfen Sie einen Blick auf die QCode-Preisseite und wählen Sie Opus / Sonnet / Haiku passend zu Ihrem Budget.