Claude Code in Cursor: Einrichtung und Workflow-Guide

Cursor bringt bereits einen eigenen KI-Agenten mit. Er kann Dateien bearbeiten, Befehle ausführen und über deinen gesamten Code hinweg arbeiten. Warum also einen zweiten Agenten im selben Editor installieren?

Claude Code ist Anthropics agentisches Coding-Tool: Es liest deinen Code, plant Änderungen, editiert Dateien, führt Tests aus und liefert dir anschließend einen Diff zur Prüfung. Die VS-Code-Erweiterung bringt diesen Workflow nach Cursor, das auf derselben VS-Code-Basis aufsetzt. Ergebnis: zwei getrennte KI-Systeme im selben Fenster – jeweils mit eigenem Kontext, eigener Abrechnung und eigener Arbeitsweise. Ob das sinnvoll ist, hängt davon ab, was du baust.

Bevor wir tiefer einsteigen: „Claude Code in Cursor“ kann aktuell zwei Dinge bedeuten. Es gibt die Claude-Code-Erweiterung (darum geht es hier) – und es gibt die Auswahl von Claude-Modellen über Cursors eingebauten Model Picker (ein separates Produkt, das Claude nur als Backend nutzt). Auf diesen Unterschied gehe ich gleich in einem eigenen Abschnitt ein. Falls du stattdessen einen direkten Vergleich der beiden Tools als eigenständige Produkte suchst, haben wir einen separaten Claude Code vs. Cursor Artikel dazu.

Was ist Claude Code in Cursor?

Claude Code ist Anthropics agentisches Coding-Tool. Es liest Codebasen, bearbeitet Dateien, führt Terminalbefehle aus, steuert git-Workflows und verbindet sich über MCP (Model Context Protocol) mit externen Diensten. Es ist als CLI, VS-Code-Erweiterung, Desktop-App und im Web verfügbar.

Cursor basiert auf einer VS-Code-ähnlichen Umgebung, und die Claude-Code-VS-Code-Erweiterung wird offiziell dafür unterstützt. In Anthropics Dokumentation ist „Install for Cursor“ als eigener Installationspfad aufgeführt – getrennt von der Standard-VS-Code-Installation. Das ist kein Community-Workaround.

Zwei KI-Workflows in einem Editor. Bild: Autor.

Hier stolpern viele: Wenn jemand „Claude Code in Cursor“ sagt, kann das bedeuten, dass die eigene Erweiterung oder CLI von Claude Code in Cursor läuft – mit Anthropics vollem agentischem Workflow, eigenem Panel, Berechtigungsmodell und Sitzungshistorie. Oder es meint, dass Claude-Modelle als Backend für Cursors eigene native KI verwendet werden. Beides ist verwandt, aber nicht dasselbe Produkt – und es verhält sich unterschiedlich.

Claude Code vs. Claude-Modelle in Cursor

Das ist damit jeweils gemeint.

Claude-Modelle in Cursor

Cursor hat einen Model Picker, mit dem du zwischen Claude Sonnet, Claude Opus, GPT, Gemini und anderen wählen kannst. Im „Auto“-Modus wählt Cursor das Modell automatisch. Wenn du Claude Sonnet im Chat oder Agent Mode von Cursor nutzt, verwendest du Cursors Produkt: dessen UX, Abrechnung und Kontextverwaltung. Das Modell ist Claude, aber die Experience gehört Cursor.

Claude Code in Cursor

Wenn du die Claude-Code-Erweiterung in Cursor installierst, bekommst du ein eigenes Panel, ein eigenes Kontextfenster und eine Abrechnung über dein Anthropic-Abo oder deinen API-Schlüssel. Beide können im selben Editorfenster laufen, teilen aber keinen Kontext. Claude Code weiß nicht, was Cursors nativer Agent tut.

„Claude Sonnet“ im Model Picker von Cursor auszuwählen ist nicht dasselbe wie Claude Code zu installieren. Wenn du den Plan-und-Ausführen-Workflow von Claude Code und die Projekterinnerung über CLAUDE.md willst, brauchst du die Erweiterung oder die CLI. Ein Satz aus der Developer-Community bringt den Unterschied gut auf den Punkt: „Cursor ist eine IDE mit KI-Funktionen. Claude Code ist ein KI-Agent mit IDE-Zugriff.“

So richtest du Claude Code in Cursor ein

Die Einrichtung läuft über drei Wege – welcher sinnvoll ist, hängt von deiner Situation ab.

Vorweg: Claude Code erfordert ein kostenpflichtiges Anthropic-Abo. Der kostenlose Tarif auf Claude.ai umfasst es nicht. Minimum ist der Pro-Plan für 20 $ pro Monat. Außerdem brauchst du Cursor mit VS-Code-Engine-Version 1.98.0 oder höher.

Die drei Wege sind:

• Weg 1: Die VS-Code-Erweiterung (offiziell, für die meisten Entwickler empfohlen)
• Weg 2: Das integrierte Terminal (am friktionsärmsten, wenn Claude Code bereits installiert ist)
• Weg 3: MCP-Server (fortgeschritten, für Team-Setups oder Multi-Tool-Umgebungen)

Wenn Claude Code bereits auf deinem Rechner installiert ist, springe direkt zu Weg 2.

Weg 1: Die VS-Code-Erweiterung (empfohlen)

Öffne Cursors Erweiterungen-Panel mit Cmd+Shift+X auf dem Mac oder Ctrl+Shift+X unter Windows und Linux. Suche nach „Claude Code“ und installiere die von Anthropic veröffentlichte Erweiterung. Die Erweiterungs-ID ist anthropic.claude-code.

Nach Claude Code in Cursor suchen. Bild: Autor.

Wichtig vorab: Die Erweiterung taucht in Cursors Marketplace-Suche manchmal nicht auf. Das passiert oft genug, dass du dich darauf einstellen solltest. Wenn sie nicht erscheint, hat Anthropics VS-Code-Dokumentation einen „Install for Cursor“-Button, der die URI cursor:extension/anthropic.claude-code direkt triggert. Falls das auch scheitert, findest du dort Anweisungen zur manuellen VSIX-Installation.

Nach der Installation erscheint ein Spark-Symbol in der Editor-Toolbar, wenn du eine Datei (nicht nur einen Ordner) geöffnet hast. Es erscheint außerdem in der Aktivitätsleiste links und in der Statusleiste unten rechts – beide sind auch ohne geöffnete Datei sichtbar. Klicke eines davon an und anschließend bei der ersten Sitzung auf Sign in, um dich über den Browser zu authentifizieren.

Ein paar Checks, falls etwas seltsam wirkt:

• Wenn das Icon nach der Installation nicht erscheint, führe „Developer: Reload Window“ über die Befehlspalette aus

• Wenn du ANTHROPIC_API_KEY in deiner Shell gesetzt hast, aber trotzdem die Anmeldemaske siehst, starte Cursor aus dem Terminal mit cursor ., damit es deine Umgebung erbt

Weg 2: Das integrierte Terminal (am wenigsten Reibung)

Wenn Claude Code bereits auf deinem Rechner installiert ist, kannst du die Erweiterung überspringen. Öffne Cursors integriertes Terminal mit `Ctrl+`` und tippe claude`. Claude Code läuft dann als interaktive Sitzung im Terminal, während der Editor daneben offen bleibt. So umgehst du mögliche Kompatibilitätsprobleme mit Erweiterungen komplett.

Falls Claude Code noch nicht installiert ist, ist der native Installer der empfohlene Weg. Er ist in sich geschlossen, benötigt kein Node.js und aktualisiert sich im Hintergrund automatisch:

# macOS, Linux, or WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell (requires Git for Windows)
irm https://claude.ai/install.ps1 | iex

Die npm-Methode (npm install -g @anthropic-ai/claude-code) funktioniert weiterhin, gilt aber inzwischen als Legacy.

Weg 3: MCP-Server (fortgeschritten)

Wenn du für den Eigengebrauch einrichtest, überspringe das.

Für Teams, die Multi-Tool-MCP-Umgebungen aufbauen, kannst du Claude Code als lokalen MCP-Server laufen lassen und ihn über Cursors MCP-Einstellungen anbinden, indem du Folgendes zu mcp.json hinzufügst:

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["--mcp"]
    }
  }
}

Damit stehen die Tools von Claude Code neben allen anderen konfigurierten MCP-Servern zur Verfügung. Das funktioniert mit Cursor. Die meisten Einzelentwickler brauchen es nicht.

Was du mit Claude Code in Cursor tun kannst

Claude Code deckt mehr Aufgaben ab, als man von einem Chat-Tool erwartet. Das bekommst du in Cursor:

• Unbekannten oder Legacy-Code erklären, indem die relevanten Dateien direkt gelesen werden
• Features über mehrere Dateien planen und umsetzen – mit Review-Schritt, bevor sich etwas ändert
• Debuggen anhand von Fehlermeldungen oder Stacktraces und die Ursache im Code zurückverfolgen
• Tests generieren, ausführen und Fehler beheben, bis sie grün sind
• Änderungen stagen, Commit-Messages schreiben, Branches anlegen und Pull Requests eröffnen

Die @-Erwähnung ist wichtig. Tippe @ gefolgt von Datei- oder Ordnernamen, um sie in den Kontext zu ziehen. Claude Code unterstützt Fuzzy Matching, Teilnamen reichen oft. Wenn du Code im Editor markierst, sieht Claude ihn automatisch.