Cursor einrichten — Installation, .cursorrules, MCP und Aufgabenteilung mit Claude Code

Cursor ist ein VS Code-Fork mit tiefer KI-Integration — derzeit der schnellste Weg zu täglich genutzter KI im Editor. Cursor und Claude Code überschneiden sich, ergänzen sich aber gut: Cursor ist ein Editor-integrierter Pair-Programmer, Claude Code ein Terminal-seitiger Agent. Nicht eines wählen — die Arbeit aufteilen.

Ich glaube, was Cursor zu einem dauerhaften Bestandteil meines Workflows macht, ist nicht die Tab-Autovervollständigung allein, sondern die Fähigkeit des Composer-Modus, mehrere Dateien kohärent zu bearbeiten — weil das früher der Hauptgrund war, in der CLI zu bleiben, statt im Editor zu arbeiten. Anfangs habe ich Cursor nur für schnelle Inline-Edits benutzt; heute setze ich es für ganze Komponentenerstellungen ein, da es die .cursorrules-Kontextsteuerung beherrscht.

Dieser Leitfaden ist betriebssystemunabhängig (macOS/Linux/Windows): Installation → Kernnutzung → .cursorrules → MCP → Aufgabenteilung mit Claude Code.

TL;DR

1. Installation: cursor.com → importiert automatisch VS Code-Erweiterungen/Keymap/Einstellungen
2. Modell: Claude Sonnet/Opus · GPT-4.1 · Cursor Composer. Standardempfehlung: Claude Sonnet
3. Vier Shortcuts: Tab Autovervollständigung · ⌘K Inline-Bearbeitung · ⌘L Seiten-Chat · ⌘I Composer
4. .cursorrules: Projektregeln, die bei jedem Aufruf als System Prompt eingefügt werden
5. Aufteilung mit Claude Code: Cursor = Bearbeitungen + sofortiges Feedback; Claude Code = Mehrfachdatei + autonom + CLI

Voraussetzungen

• macOS 12+ / Windows 10+ / Linux (Ubuntu 22.04+)
• Internet + ein Konto (Cursor oder GitHub OAuth)
• VS Code-Nutzer: Import ist automatisch

1. Installation

macOS

brew install --cask cursor

Windows

winget install -e --id Anysphere.Cursor

Linux

cursor.com/downloads für AppImage oder .deb.

Beim ersten Start importiert Cursor VS Code-Erweiterungen, Keymap und Theme mit einem Klick. Neue Benutzer können einfach die Standardwerte übernehmen.

2. Ein Modell wählen

Cursor → Einstellungen → Modelle. Empfehlungen:

• Claude Sonnet 4 — tägliche Bearbeitung und Refaktorierung. Schnell.
• Claude Opus 4 — schwieriges Debugging und Architekturentscheidungen. Langsamer / teurer, dafür präziser.
• Composer (Cursors eigener) — Mehrfachdatei, agentisch. Beta-Status.
• GPT-4.1 / o1 — nützlich als Fallback oder Vergleich.

Cursor Pro hat modellspezifische Anfragekontingente. Sonnet hat ein großzügiges Limit und ist schnell — als Standard empfohlen; Opus nur bei besonders anspruchsvollen Aufgaben einsetzen.

3. Vier Shortcuts zum Lernen

Tab-Autovervollständigung

• Ergänzt Signaturen, wiederholt Muster, fügt Imports automatisch hinzu
• Nicht blind vertrauen — halluzinierte APIs kommen vor. Esc zum Ablehnen.
• Einstellung: Funktionen → Cursor Tab → „Vorschau deaktivieren" reduziert Rauschen.

⌘K Inline-Bearbeitung

// Auswahl: gesamte Funktion
// ⌘K: "Fehlerbehandlung und Zod-Eingabevalidierung hinzufügen"

Ändert nur die Auswahl. Nicht für große Aufgaben. Schnellste „Absicht → Ergebnis"-Schleife.

⌘L Seiten-Chat

• @Dateiname um eine bestimmte Datei anzuhängen
• @Codebase für Suche im gesamten Repo (embedding-basiert, Beta-Qualität)
• @Web für aktuelle Infos (Cursor führt die Suche durch)

⌘I Composer

Mehrfachdatei-Arbeit (z. B. „den gesamten Auth-Flow refaktorieren"). Im Agentenmodus bearbeitet Composer Dateien direkt. Nie das gesamte Ergebnis auf einmal akzeptieren — Diff für Diff prüfen.

4. .cursorrules — Projektregeln

Eine .cursorrules-Datei im Repo-Stamm wird bei jedem Chat, jeder Bearbeitung und jedem Composer-Aufruf automatisch als System Prompt eingefügt. Code-Stil, Stack und Verbote einmal festhalten — nie wieder von Hand eingeben.

4.1 Template

Für Next.js + TypeScript-Projekte:

# Mac/Linux
curl -fsSL https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -o .cursorrules
shasum -a 256 .cursorrules
# erwartet: 7f1ef76397375cae008ece09b46ddf91aa098dff5edaacebcd7e7e4dec92a21d

# Windows
Invoke-WebRequest -Uri https://devalice.jaceclub.com/assets/ai-agents/cursor-setup/cursorrules-nextjs.txt -OutFile .cursorrules

4.2 Hauptabschnitte (im Template)

• Projektkontext — Stack · Paketmanager · Sprachversionen
• Code-Stil — striktes TS · Dateinamenkonventionen · Pfad-Aliases
• Routing/Daten — App Router-Muster · ISR · Umgebungstrennung
• Sicherheit — keine Secrets · Eingabevalidierung · SQL-Bindungen
• Umfang — keine Refaktorierung außerhalb der Anfrage
• Ausgabeformat — Diff-Stil · eine Alternative mit Abwägungen

4.3 Was sich ändert

Ohne vs. mit .cursorrules:

❌ „erstelle mir hier eine React-Komponente" → Klassen-Komponente, JS, zufällige Extra-Dependencies ✅ „erstelle mir hier eine React-Komponente" → striktes TS Server Component, @/*-Alias, Tailwind

Eine gute .cursorrules-Datei spart bei jedem Prompt 3–4 Zeilen manueller Kontextangabe.

5. .cursorignore

Gleiche Syntax wie .gitignore. Legt fest, welche Dateien die KI nicht in den Kontext laden soll.

# Abhängigkeiten / Build
node_modules
.next
dist

# Große Fixtures
fixtures/large/

# Generierter Code
src/generated/

Ohne diese Einstellung kann @Codebase Build-Ausgaben in die Suchergebnisse einbeziehen — die Antwortqualität sinkt.

6. MCP (Model Context Protocol)

Cursor 0.42+ unterstützt MCP. Da derselbe Standard wie Claude Code verwendet wird, sind Server-Definitionen vollständig portierbar.

Einstellungen → Funktionen → MCP → Server hinzufügen:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

7. Datenschutzmodus

Einstellungen → Allgemein → Datenschutzmodus:

• AUS (Standard) — Cursor kann Logs und Anfragen zur Modellverbesserung nutzen
• AN — keine Trainingsnutzung. Pflicht für Unternehmens- und proprietären Code.

Mit aktivem Datenschutzmodus laufen einige Funktionen (Indexierung) nur lokal. Spürbare Leistungseinbußen gibt es kaum.

8. Aufgabenteilung mit Claude Code

Die stärkste Einrichtung: beide Tools gleichzeitig nutzen. Rollenteilung:

Praktische Muster

1. Kleine Bearbeitung → Cursor ⌘K — Änderung passt in eine Funktion. Sofort akzeptieren.

2. Mehrfachdatei → Claude Code — „ISR zu vier Routen hinzufügen". Änderung und Build-Verifikation von der CLI aus ausführen.

3. Debugging → beide — Cursor für schnelle Hypothesen; Claude Code wenn tieferer Kontext und autonome Ausführung benötigt werden.

4. PR-Erstellung → Claude Code — über gh pr create automatisieren.

5. Review → Cursor ⌘L — Diffs inline lesen und Zeile für Zeile fragen.

Überprüfung

1. Cursor auf einer leeren index.tsx öffnen und Tab ein React-Komponenten-Grundgerüst vorschlagen lassen
2. Eine Funktion auswählen → ⌘K „Fehlerbehandlung hinzufügen" → try/catch hinzugefügt sehen
3. ⌘L Seiten-Chat mit angehängter @package.json → Abhängigkeitsfrage stellen
4. .cursorrules im Repo-Stamm ablegen → neuer Chat → Verhalten ändert sich gemäß Regeln
5. Einstellungen → Datenschutz → AN → normalen Betrieb bestätigen

Fehlerbehebung

Tab-Autovervollständigung ist zu rauschig

Einstellungen → Funktionen → Cursor Tab → „Genauer auslösen", oder vorübergehend deaktivieren. Wenn oft abgelehnt wird, einfach ausschalten.

@Codebase-Ergebnisse sind falsch

Build-Ausgaben und generierten Code zu .cursorignore hinzufügen. Re-Indexierung auslösen (Einstellungen → Indexierung).

Cursors eigenes Modell halluziniert oft

Claude Sonnet als Standard erzwingen. Einstellungen → Modelle → Standardmodell = Claude Sonnet.

.cursorrules scheint ignoriert zu werden

• Dateiname exakt prüfen: .cursorrules, mit führendem Punkt, ohne Erweiterung
• Muss im Repo-Stamm liegen, nicht in einem Unterordner
• In einem neuen Chat testen — bestehende Chats akkumulieren Kontext und können Regeländerungen überdecken

Pro-Kontingent verbrennt schnell

Composer wird zu häufig verwendet. ⌘K für kleine Bearbeitungen nutzen; Composer für echte Mehrfachdatei-Arbeit reservieren.

Tastenkürzel-Konflikt mit Claude Code

Cursor läuft im Editor, Claude Code im Terminal — direkte Kollisionen sind selten, aber beide verwenden in manchen Setups ⌘L. Eines der beiden Kürzel umbelegen.

Referenzen

• Claude Code einrichten — Terminal-Agent-Einrichtung ergänzt Cursor gut
• Multi-Agenten-Workflow — mehrere Tools kombinieren
• Cursor-Dokumentation
• Cursor MCP-Leitfaden

Changelog

• 2026-05-12 — Erste englische Übersetzung (devAlice M2 i18n Seed)