Tutorials

Claude Code in IntelliJ IDEA nutzen: Die ultimative Schritt-für-Schritt-Anleitung

Melden

Claude Code ist das offizielle, terminal-basierte Agenten-Tool von Anthropic. Es ermöglicht Entwicklern, Programmieraufgaben mithilfe von KI direkt im Codebase-Kontext zu lösen – von der Fehlersuche über Refactorings bis hin zur Erstellung ganzer Features.

In dieser Anleitung erfährst du Schritt für Schritt, wie du Claude Code optimal in IntelliJ IDEA einrichtest, integrierst und im Entwickleralltag effizient einsetzt.

Voraussetzungen

Bevor du startest, stelle sicher, dass folgende Komponenten bereitstehen:

  1. IntelliJ IDEA (Ultimate oder Community Edition).
  2. Node.js (Version 18 oder höher) installiert (node -v im Terminal prüfen).
  3. Ein Anthropic-Konto mit hinterlegter Zahlungsmethode bzw. API-Guthaben für die Claude 3.7 / 3.5 Sonnet Modelle.

Schritt 1: Claude Code CLI global installieren

Claude Code wird als Node-Paket über die Kommandozeile vertrieben.

  1. Öffne dein Systemterminal (oder das Terminal in IntelliJ mit Alt + F12 bzw. Cmd + F12 auf macOS).
  2. Installiere das offizielle CLI-Tool global:
    npm install -g @anthropic-ai/claude-code
  3. Prüfe, ob die Installation erfolgreich war:
    claude --version

Schritt 2: Authentifizierung und Ersteinrichtung

Beim ersten Start verknüpfst du das Tool mit deinem Anthropic-Account.

  1. Führe im Terminal folgenden Befehl aus:
    claude
  2. Claude Code leitet dich automatisch durch den OAuth-Login im Browser.
  3. Melde dich bei Anthropic an und bestätige den Zugriff.
  4. Alternativ (für CI/CD oder feste Umgebungen): Du kannst deinen API-Schlüssel auch direkt als Umgebungsvariable setzen:
    export ANTHROPIC_API_KEY="sk-ant-api..."

Schritt 3: Die perfekte Integration in IntelliJ IDEA

Da Claude Code ein CLI-First-Tool ist, gibt es zwei Wege, es nahtlos in IntelliJ zu nutzen:

Methode A: Das integrierte IntelliJ-Terminal (Empfohlen)

Die einfachste und direkteste Methode ist die Nutzung über die IntelliJ-Oberfläche.

  1. Öffne dein Projekt in IntelliJ IDEA.
  2. Öffne das untere Panel Terminal (Alt + F12 / Option + F12).
  3. Starte Claude Code direkt im Stammverzeichnis deines Projekts:
    claude
  4. Pro-Tipp: Teile das Terminalfenster in zwei Bereiche (Rechtsklick auf den Terminal-Reiter -> Split Vertically). Nutze links deine Git-Befehle / Build-Tools und rechts Claude Code.

Methode B: Als "External Tool" für Tastenkombinationen

Du kannst Claude Code als externes Werkzeug hinterlegen, um es per Klick oder Shortcut zu starten:

  1. Gehe auf Settings / Preferences (Strg + Alt + S bzw. Cmd + ,).
  2. Navigiere zu Tools -> External Tools.
  3. Klicke auf das + (Hinzufügen) und fülle die Felder aus:
    • Name: Claude Code
    • Program: claude (oder den absoluten Pfad, z. B. /usr/local/bin/claude bzw. C:\Users\<Name>\AppData\Roaming\npm\claude.cmd)
    • Working directory: $ProjectFileDir$
  4. Bestätige mit OK.
  5. Du kannst nun unter Settings -> Keymap nach „Claude Code“ suchen und dem Tool einen eigenen Shortcut (z. B. Strg + Shift + C) zuweisen.

Schritt 4: Best Practices im Entwickleralltag

Sobald Claude Code in deinem Projekt läuft, liest der Agent deine Datei- und Projektstruktur ein.

1. Codebase erkunden & Fragen stellen

Du musst Dateien nicht kopieren; Claude hat direkten Lesezugriff.

Prompt-Beispiel:
Erkläre mir, wie die Authentifizierung in diesem Projekt aufgebaut ist und welche Endpunkte betroffen sind.

2. Fehler analysieren und beheben

Wenn IntelliJ dir einen Stacktrace oder Kompilierungsfehler anzeigt:

Prompt-Beispiel:
Ich erhalte in UserServiceTest eine NullPointerException. Analysiere die Datei und passe den Code an, um das Problem zu beheben.

Claude wird dir den Diff vorschlagen und nach deiner Bestätigung (Y) die Datei direkt auf der Festplatte ändern. IntelliJ synchronisiert die Änderungen in Echtzeit.

3. Refactoring und Tests schreiben

Prompt-Beispiel:
Erstelle einen vollständigen JUnit-5-Test für OrderController.java und beachte dabei unsere bestehende Mockito-Struktur.

4. Git-Workflows automatisieren

Claude Code kann Git-Befehle ausführen:

Prompt-Beispiel:
Prüfe git diff und erstelle einen aussagekräftigen Commit für die letzten Änderungen.

Schritt 5: Wichtige Konfigurationen

Projektdateien ausschließen (.claudeignore)

Um API-Kosten zu sparen und sensible Daten zu schützen, solltest du eine .claudeignore-Datei im Projektstammverzeichnis erstellen (funktioniert wie .gitignore):

# Build-Ordner ausschließen
target/
build/
.gradle/
node_modules/

# Sensible Dateien
.env*
*.key
*.pem

# IntelliJ-spezifische Daten
.idea/
*.iml

Zusammenfassung

Mit der Kombination aus der Stärke von IntelliJ IDEA (Indexierung, Typensicherheit, Debugger) und Claude Code (autonomes Suchen, Code-Generierung und Refactoring via CLI) erhältst du einen extrem mächtigen KI-Copiloten. Du musst deine IDE nie verlassen und behältst dank der Versionskontrolle von IntelliJ jederzeit die volle Kontrolle über alle Änderungen, die die KI vorschlägt.

0