# Tool-Guide: Cursor

> Cursor als Vibe-Coding-Tool — Installation, Agent-Modus, Skills und MCP-Integration.

- URL: https://thevibe-coding.de/kurs/tool-cursor
- Typ: kurs | Veroeffentlicht: 2026-02-24 | Aktualisiert: 2026-07-17
- Autor: VIBE CODING | Site: VIBE CODING — thevibe-coding.de

---

# Tool-Guide: Cursor

Cursor ist VS Code — aber mit Superkräften. Ein Editor, den du kennst. Ein Agent, der Code schreibt. Die perfekte Kombination für alle, die eine visuelle Oberfläche brauchen, aber trotzdem die Power eines AI-Agenten wollen.

Schau auch in unsere [Tools-Übersicht](/tools) für den Vergleich mit anderen Tools.

---

## Was ist Cursor?

Cursor ist ein **Code-Editor basierend auf VS Code**, der einen integrierten AI-Agenten mitbringt. Alles, was du an VS Code kennst und liebst — Extensions, Themes, Shortcuts — funktioniert in Cursor. Plus:

- **Agent-Modus** — AI, die dein Projekt versteht und autonom handelt
- **Composer** — Multi-File-Editing mit natürlicher Sprache
- **Eigenes Modell** — Cursors hauseigenes **Composer 2.5** (Stand: Mai 2026), daneben Claude- und GPT-Modelle wählbar
- **Inline-Edits** — Code markieren und per Prompt ändern
- **Chat** — Fragen zum Code stellen, ohne den Editor zu verlassen
- **MCP-Support** — Externe Tools anbinden (Exa, Datenbanken)

Der fundamentale Unterschied zu VS Code + Copilot: Cursor ist nicht nur ein Autocomplete. Es ist ein **Agent**, der Dateien erstellen, bearbeiten und löschen kann — genau wie Claude Code, aber mit GUI.

---

## Installation

### Download
1. Gehe zu [cursor.com](https://cursor.com)
2. Lade die Version für dein Betriebssystem herunter
3. Installiere wie jede andere App

### VS Code Migration
Cursor importiert automatisch:
- Extensions
- Themes
- Keybindings
- Einstellungen

Du musst nichts manuell übertragen. Beim ersten Start fragt Cursor, ob du deine VS-Code-Konfiguration importieren willst. Sag ja.

### Account
- **Free-Tier:** Begrenzte Anfragen pro Monat, aber funktional
- **Pro:** ~$20/Monat — unbegrenzte Anfragen, alle Modelle
- **Business:** Team-Features, SSO

---

## Der Agent-Modus

Der Agent-Modus ist das Herzstück von Cursor für Vibe Coder. Er verwandelt Cursor von einem Editor in einen Agenten.

### Aktivierung
1. Öffne den **Composer** (Cmd+I / Ctrl+I)
2. Wähle den **Agent-Modus** (nicht "Normal" oder "Edit")
3. Schreibe deinen Prompt

### Was der Agent kann
Im Agent-Modus kann Cursor:
- **Mehrere Dateien gleichzeitig** erstellen und bearbeiten
- **Terminal-Befehle** ausführen (npm install, pip install, etc.)
- **Fehler erkennen** und automatisch korrigieren
- **Kontext aus dem gesamten Projekt** nutzen
- **Schrittweise** komplexe Aufgaben abarbeiten

### Beispiel
```
Erstelle einen Telegram-Bot in Python:
1. Erstelle main.py mit Bot-Logik
2. Erstelle requirements.txt mit python-telegram-bot und python-dotenv
3. Erstelle eine .env.example mit den benötigten Variablen
4. Erstelle ein README mit Setup-Anleitung
```

Der Agent erstellt alle vier Dateien, füllt sie mit funktionalem Code und zeigt dir die Änderungen im Diff-View. Du prüfst und akzeptierst.

---

## Composer vs. Chat vs. Inline-Edit

Cursor hat drei Interaktionsmodi — und jeder hat seinen Platz:

### Composer (Cmd+I / Ctrl+I)
- **Für:** Größere Aufgaben, Multi-File-Edits
- **Agent-Modus verfügbar:** Ja
- **Beispiel:** "Füge Authentication zu meiner Express-App hinzu"

### Chat (Cmd+L / Ctrl+L)
- **Für:** Fragen, Erklärungen, Analyse
- **Agent-Modus:** Nein (nur Antworten, keine Dateiänderungen)
- **Beispiel:** "Erkläre mir, was diese Funktion tut"

### Inline-Edit (Cmd+K / Ctrl+K)
- **Für:** Schnelle Änderungen an markiertem Code
- **Agent-Modus:** Nein (nur die markierte Stelle)
- **Beispiel:** Code markieren → "Füge Error-Handling hinzu"

**Faustregel:** Composer für Bauen, Chat für Verstehen, Inline für Feinschliff.

---

## Skills in Cursor

Cursor nutzt ein anderes Skill-System als Claude Code, aber das Konzept ist dasselbe: Wiederverwendbare Anweisungen.

### Projektregeln: .cursor/rules/
Projektweite Anweisungen liegen als Rule-Dateien im Verzeichnis `.cursor/rules/`:
```markdown
# .cursor/rules/general.md

Du arbeitest an einem deutschsprachigen Telegram-Bot-Projekt.

Regeln:
- Alle Kommentare auf Deutsch
- Deutsche Umlaute korrekt verwenden (ä, ö, ü, ß)
- Python 3.11+ Syntax
- Type Hints verwenden
- Logging statt print()
- Secrets immer aus .env laden
- Error-Handling für alle API-Aufrufe
```

Für komplexere Setups teilst du die Regeln auf mehrere Dateien auf:
```
.cursor/
├── rules/
│   ├── general.md
│   ├── telegram.md
│   └── style.md
```

### AGENTS.md
Cursor liest außerdem **AGENTS.md** im Projekt-Root — den offenen, tool-übergreifenden Standard für Projektregeln. Der Vorteil: Dieselbe Datei funktioniert auch in Claude Code, Codex und Antigravity. Wenn du mehrere Tools nutzt, pflege deine Regeln dort.

**Legacy-Hinweis:** Die alte Einzeldatei `.cursorrules` im Projekt-Root funktioniert noch, gilt aber als veraltet. Für neue Projekte nimm `.cursor/rules/` oder AGENTS.md.

### @-Referenzen
In Cursor kannst du mit `@` auf Dateien, Ordner und Docs verweisen:
```
@src/bot.py Füge Retry-Logik zur send_post-Funktion hinzu
@requirements.txt Füge die fehlende Abhängigkeit hinzu
```

---

## MCP in Cursor einrichten

Cursor unterstützt MCP-Server — genau wie Claude Code.

### Konfiguration
Die MCP-Konfiguration liegt in den Cursor-Settings:

1. Öffne **Settings** (Cmd+, / Ctrl+,)
2. Suche nach "MCP"
3. Oder erstelle eine Konfigurationsdatei:

```json
// .cursor/mcp.json
{
  "mcpServers": {
    "exa": {
      "command": "npx",
      "args": ["-y", "exa-mcp-server"],
      "env": {
        "EXA_API_KEY": "dein-api-key"
      }
    }
  }
}
```

4. Cursor neu starten

Jetzt kann der Agent im Composer **live im Internet recherchieren**.

---

## .env-Dateien in Cursor

Cursor versteht `.env`-Dateien nativ. Du kannst:

1. **Eine .env-Datei erstellen** lassen:
   ```
   Erstelle eine .env-Datei mit den nötigen Umgebungsvariablen für einen Telegram-Bot
   ```

2. **Auf .env verweisen** in Prompts:
   ```
   Lade den Token aus der .env-Datei — nutze python-dotenv
   ```

3. **Eine .env.example** pflegen (ohne echte Werte):
   ```
   TELEGRAM_BOT_TOKEN=dein-token-hier
   CHANNEL_ID=deine-channel-id
   ```

**Sicherheit:** Cursor indexiert `.env`-Dateien standardmäßig nicht für den AI-Kontext. Das ist gut — deine Secrets bleiben lokal.

---

## Vorteile für VS-Code-Nutzer

Wenn du VS Code bereits nutzt, ist Cursor ein Upgrade ohne Lernkurve:

### Was bleibt gleich
- Alle Shortcuts
- Alle Extensions (meistens)
- Alle Themes
- Das gesamte Look-and-Feel
- Git-Integration
- Terminal-Integration
- Debugging

### Was dazukommt
- AI-Agent direkt im Editor
- Composer für Multi-File-Aufgaben
- Inline-AI für schnelle Edits
- MCP-Support für externe Tools
- Projektweites Verständnis

### Was anders ist
- Cursor ist ein Fork von VS Code — nicht VS Code selbst
- Manche Extensions können Kompatibilitätsprobleme haben
- Updates kommen von Cursor, nicht von Microsoft
- Die Telemetrie geht an Cursor (anpassbar in Settings)

---

## Wann Cursor verwenden?

### Ideal für
- **VS-Code-Nutzer** — Nullaufwand beim Umstieg
- **Visuelle Arbeiter** — Du willst Code sehen, nicht nur im Terminal arbeiten
- **Web-Projekte** — HTML, CSS, React, Next.js — Cursor zeigt Previews
- **Anfänger** — Der Editor ist vertrauter als ein Terminal
- **Multi-File-Projekte** — Composer zeigt Änderungen über alle Dateien

### Weniger ideal für
- **Terminal-Puristen** — Claude Code ist dort stärker
- **Budget $0** — Free-Tier ist limitiert
- **Open-Source-Überzeugung** — Cursor ist proprietär
- **Serverseitige Arbeit** — Auf einem Remote-Server ist ein Terminal praktischer

---

## Cursor vs. Claude Code

| Aspekt | Cursor | Claude Code |
|--------|--------|-------------|
| Interface | GUI (Editor) | Terminal |
| Lernkurve | Flach (wie VS Code) | Steiler (Terminal) |
| Visuelles Feedback | Stark (Diff-View, Preview) | Minimal (Text) |
| Geschwindigkeit | Gut | Sehr gut |
| MCP-Support | Ja | Ja |
| Regeln/Skills | .cursor/rules/ + AGENTS.md | Skills (SKILL.md) + Commands |
| Preis | $0-20/Monat | $0-20/Monat |
| Open Source | Nein | Nein |
| Offline | Nein | Nein |

**Tipp:** Du musst dich nicht entscheiden. Viele Vibe Coder nutzen beide Tools — Cursor für visuelles Arbeiten, Claude Code für Terminal-Aufgaben und Automatisierung.

---

## Weiterführend

- [Tool-Guide: Claude Code](/kurs/tool-claude-code) — Das Terminal-Werkzeug
- [Tool-Guide: Codex CLI](/kurs/tool-codex) — Die Open-Source-Alternative
- [Tool-Guide: Antigravity](/kurs/tool-antigravity) — Googles agentische IDE
- [FAQ: Prompting und Skills](/kurs/faq-prompting) — Skills meistern