# JetBrains IDE-Integration

> **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

| Element | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (Claude Code Plugin, teilt sich die CLI-Konfiguration) · GPT / chinesische Modelle ⚠️ siehe JetBrains AI Assistant Custom Models (eigener Abschnitt) · Gemini ❌ |
| Protokoll & Base URL | Anthropic: `https://api.qcode.cc/api` (gesetzt in der `claude` CLI env / settings.json) |
| Konfiguration | Settings → Tools → Claude Code [Beta] in der IDE; darunter teilt es sich `~/.claude/` |
| Offizielle Dokumentation | [code.claude.com/docs/en/jetbrains](https://code.claude.com/docs/en/jetbrains) |

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)
   - Folgen Sie dem [Installationshandbuch](/docs/getting-started/installation), um die Installation abzuschließen
   - Folgen Sie dem [Umgebungsvariablen-Handbuch](/docs/getting-started/environment), um die QCode-API zu konfigurieren
   - Führen Sie `claude --version` im Terminal aus, um die Funktionsfähigkeit zu bestätigen

2. **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)

3. **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:

```bash
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](#environment-variables-not-taking-effect)).

### 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):

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

### Tastenkürzel

| Kürzel | Funktion |
|----------|----------|
| `Cmd+Esc` / `Ctrl+Esc` | Claude Code-Panel öffnen / schließen |
| `Cmd+Option+K` / `Ctrl+Alt+K` | Referenz auf die aktuelle Datei (@file) im Prompt einfügen |
| `Esc` | Aktuelle Generierung unterbrechen |

> 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](/docs/usage/image-2).

### 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:

| Modell | Kontext | Geeignet für |
|------|--------|----------|
| `claude-opus-5` | 1M | Flaggschiff, komplexe Refactorings und Architekturüberlegungen |
| `claude-opus-4-7` | 1M | Flaggschiff-Alternative |
| `claude-sonnet-5` | 1M | Alltägliches Coden, ausgewogenes Preis-Leistungs-Verhältnis |
| `claude-haiku-4-5` | 200K | Leichte Aufgaben, schnelle Q&A |

Die Preise werden auf dieser Seite nicht angegeben – nutzen Sie die aktuellen Werte auf [qcode.cc/models](https://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](https://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](/docs/advanced/subagents).

- **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](/docs/advanced/headless).
## 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.

| Pfad | Protokoll | Eigene Adresse? | Was QCode dort bereitstellen kann |
|---|---|---|---|
| Claude-Code-Plugin (diese Seite) | Anthropic Messages | ja, `ANTHROPIC_BASE_URL` = `https://api.qcode.cc/api` | Claude-Modelle und die chinesischen Modellfamilien (Anthropic-Zweig) |
| AI Assistant → OpenAI-compatible | OpenAI Chat Completions | ja, es gibt ein URL-Feld | GPT-Modelle und die chinesischen Modellfamilien (`https://api.qcode.cc/openai/v1`) |
| AI Assistant → Anthropic / Gemini | nativ | **laut Dokumentation kein Adressfeld**, nur Key des Herstellers | kann nicht auf QCode zeigen |

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](https://github.com/anthropics/claude-code/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](/docs/getting-started/endpoints-and-api-paths) finden Sie die drei Domains und die Base-URL für jedes Protokoll

- Unter [VS-Code-Integration](/docs/ide/vscode) finden Sie die VS-Code-Erweiterung

- Unter [Cline-Integration](/docs/ide/cline) finden Sie eine weitere KI-Erweiterung für VS Code

- Unter [CLI-Tipps](/docs/usage/cli-tips) 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](https://qcode.cc/pricing) und wählen Sie Opus / Sonnet / Haiku passend zu Ihrem Budget.