Cursor Tutorial 2026: Anleitung zum Einstieg in 15 Minuten

Dieses Cursor Tutorial zeigt, wie du Cursor nutzt, wenn du es zum ersten Mal öffnest. Die Cursor Anleitung auf Deutsch folgt der offiziellen Dokumentation von Cursor mit Stand 1. November 2026, als Cursor IDE 3.27 die aktuelle Version war.

Ein Hinweis zur Methode: Das NxCode-Team hat diesen Guide auf Basis dieser Dokumente geschrieben und die Schritte nicht auf einer frischen Installation durchgespielt. NxCode ist unser eigenes Produkt, ein KI-App-Builder, und von Cursor getrennt. Wo der Guide sagt, was du sehen solltest, stammt das aus der Dokumentation, dein Bildschirm kann also in Kleinigkeiten abweichen. Wo sich offizielle Seiten widersprechen oder eine Lücke lassen, sagen wir das.

Wenn du schon ein älteres Cursor-Tutorial gelesen hast, stell dich auf Überraschungen ein. Composer-Modus, Inline Edit mit Cmd+K und der separate Chat-Modus sind alle aus der aktuellen Dokumentation verschwunden.

Deine 15-Minuten-Route

Minuten	Was du tust	Was du davon hast
0–3	Installieren, anmelden, Übungsordner öffnen	Cursor läuft auf deinem Computer
3–5	Die zwei Fenster und ein paar Shortcuts lernen	Du weißt, wo Agent zu finden ist
5–10	Erste Aufgabe mit Ask, dann mit Agent ausführen	Eine kleine Seite, von Agent verbessert
10–12	Änderungen prüfen und testen	Du weißt, was Agent wirklich getan hat
12–14	Einen Checkpoint wiederherstellen üben	Du weißt, wie du etwas rückgängig machst
14–15	Eine Projektregel hinzufügen	Agent folgt deinen Vorlieben

Was ist Cursor?

Cursor ist ein Code-Editor mit eingebautem KI-Agenten. Du beschreibst eine Aufgabe in normaler Sprache, und Agent liest dein Projekt, bearbeitet Dateien und kann Befehle ausführen.

Wenn du VS Code kennst, wird dir der Editor vertraut vorkommen. Die normalen Bearbeitungs-Shortcuts sind gleich, und du kannst deine Erweiterungen, Themes, Einstellungen und Tastenbelegungen importieren.

An einem normalen Tag passieren in Cursor drei Dinge:

Agent übernimmt Aufgaben quer durch dein Projekt.
Tab sagt voraus, was du gleich tippst, wenn du selbst Code schreibst.
Rules sagen Agent, wie dein Projekt behandelt werden soll.

Cursor passt zu allen, die mit Code arbeiten wollen oder es lernen möchten. Wer nur eine fertige App will und kein Interesse am Lesen von Diffs hat, steht vor einer anderen Aufgabe. Darum geht es unten unter „Wann ein anderes Tool besser passt“. NxCode ist dort eine Option.

Cursor installieren und zum ersten Mal öffnen

Schritt 1: Herunterladen

Geh zu cursor.com/download und wähle dein System.

System	Voraussetzung	Was du herunterlädst
macOS	12 oder neuer	`.dmg`, für Apple Silicon oder Intel
Windows	10 oder neuer	`.exe`, x64 oder ARM64, jeweils mit System- und User-Installer
Linux	Debian/Ubuntu oder RHEL/Fedora	Zuerst apt- oder yum-Repository, AppImage ebenfalls verfügbar

Unter Linux bevorzugt der offizielle Quickstart die Repositories für apt und yum, weil sie ein Desktop-Icon, automatische Updates und das Kommandozeilentool mitbringen.

Schritt 2: Cursor öffnen und anmelden

Die offizielle Reihenfolge ist kurz: herunterladen, öffnen, anmelden, Ordner wählen, mit einer kleinen Aufgabe beginnen. Du brauchst ein Konto.

Die Anmeldung bei Cursor kann dich auf eine gemeinsame xAI-Seite mit Grok- oder xAI-Branding führen. Das ist so vorgesehen, denn Neukundschaft startet jetzt mit The X Subscription, dem Abo, unter dem Cursor verkauft wird. Die Anmeldung führt weder Konten zusammen noch ändert sie einen Tarif.

Ältere Guides nennen „KI-Modell wählen“ als Schritt beim ersten Start. Die aktuelle Dokumentation hat keinen solchen Schritt. Du kannst später unter Cursor Settings > Models einen Standard festlegen oder während einer Unterhaltung wechseln.

Die Dokumentation sagt auch nicht, ob neue Nutzende zuerst im Agents Window oder im Editor landen. Der nächste Abschnitt zeigt, wie du zwischen beiden wechselst, beide Startpunkte sind also in Ordnung.

Schritt 3: Einen Tarif wählen

Starte mit Free ($0, begrenzte Nutzung), wechsle zu Plus ($8/Monat), wenn die Limits deine Arbeit unterbrechen, und wähle Premium ($30/Monat) erst, wenn du Cloud Agents, Drittanbieter-Modelle oder eigene API-Schlüssel brauchst.

Die Preise verstehen sich ohne Steuern. Darüber liegen Super ($100) und Ultra ($200). Details stehen in unserem Cursor-Preisguide oder auf der offiziellen Preisseite. Kaufe nur über die offizielle Website oder per In-App-Kauf, denn laut Preisseite gilt bei Cursor: „not authorize any resellers or third-party sellers“ (keine Autorisierung für Reseller oder Drittverkäufe).

Schritt 4: Optional, dein VS-Code-Setup übernehmen

Der Import von VS-Code-Einstellungen wird nicht mehr als Schritt beim ersten Start beschrieben. Wenn du ihn möchtest, drücke Cmd+Shift+J (Ctrl+Shift+J unter Windows und Linux), um Cursor Settings zu öffnen, und geh dann zu General > Account > VS Code Import > Import.

Erweiterungen kommen in Cursor aus Open VSX, nicht aus dem VS Code Marketplace, und nicht jede Erweiterung ist dort verfügbar. Fehlt nach dem Import eine, ist das der wahrscheinliche Grund.

Prüfe vor jeder Installation, wer die Erweiterung veröffentlicht hat. Am 29. Oktober 2026 warnte Cursor vor einer bösartigen Erweiterung in seinem Marketplace, die sich als Anthropic.claude-code (Versionen 2.1.312 und 2.1.313) ausgab.

Die Oberfläche kennenlernen

Zwei Fenster: Agents Window und Editor

Cursor hat zwei Hauptoberflächen, und laut Dokumentation werden beide weiter unterstützt. Du kannst sie gleichzeitig geöffnet lassen.

	Agents Window	Editor (IDE)
Aufgebaut um	Agenten	Deine Dateien
Gut für	Mehrere Repositories, parallele Agenten, lokale, Cloud- und SSH-Arbeit	Code neben Agent lesen und bearbeiten
So kommst du hin	Cmd+Shift+P, dann Open Agents Window	Cmd+Shift+P, dann Open IDE

Unter Windows und Linux ist die Befehlspalette Ctrl+Shift+P.

Einige Funktionen gibt es nur im Agents Window, darunter mehrere Workspaces, die neue Diff-Ansicht, parallele Cloud-Agenten und die native Worktrees-Oberfläche.

Nutze am ersten Tag den Editor. Dort siehst du Datei und Unterhaltung nebeneinander, so kannst du leichter verfolgen, was Agent tut.

Das Agent-Panel

Drücke im Editor Cmd+I (Ctrl+I), um das Panel an der Seite zu öffnen. Die Dokumentation nennt es „Agent panel“, die Shortcut-Tabelle „Sidepanel“. Beides ist dasselbe.

Im Panel nutzt du:

Das Eingabefeld für deine Anfrage. Du kannst Bilder hineinziehen oder einfügen oder das Mikrofon für Spracheingabe nutzen.
Das Modus-Dropdown, das zwischen Agent, Ask, Plan und Debug wechselt.
Die Modellauswahl oben im Eingabefeld.
@, um auf etwas Bestimmtes zu zeigen, und /, um Skills und Befehle aufzurufen.

Die aktuelle offizielle @-Liste ist kurz: eine Datei oder ein Ordner wie @index.html oder @src/components/, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main) und @Browser. Wenn du nicht sicher bist, welche Datei wichtig ist, lass @ weg. Laut Dokumentation findet Agent relevante Dateien über seine eigene Suche.

Ältere Tutorials lehren @codebase, @docs und @web. Diese stehen nicht in der aktuellen Liste, und wir konnten nicht bestätigen, ob sie noch funktionieren.

Die Seitenleiste hat außerdem eine Seite Customize, die Plugins, Skills, MCP, Subagents, Rules, Befehle und Hooks an einem Ort sammelt. Du wirst sie später nutzen.

Begriffe, die du kennen solltest: Was die Namen heute bedeuten

Viele Namen bei Cursor haben sich geändert. Diese Tabelle zeigt, was jeder heute bedeutet.

Begriff	Was er heute bedeutet	Wenn ein altes Tutorial sagt
Composer	Cursors eigenes Modell, derzeit Composer 2.5, als schnell und kosteneffizient beschrieben	„Composer-Modus“: nicht mehr in der Dokumentation, nutze Agent
Agent	Der Standardmodus und der wichtigste Arbeitsweg	„In Composer auf Agent umschalten“: kein Umschalten nötig
Chat	Kein eigener Modus. Die Dokumentation schreibt „Agent (Chat)“	„Chat öffnen, um Fragen zu stellen“: nutze Ask, den Nur-Lese-Modus
Inline Edit	Eingestellt; siehe unten	„Code markieren und mit Cmd+K direkt bearbeiten“: Code markieren, Cmd+K oder Cmd+L drücken, dann landet er in Agent
Tab	Autovervollständigung, Name unverändert	„Supermaven“: Das Wort kommt in der von uns gelesenen offiziellen Dokumentation nicht vor
Free	Der $0-Tarif für Neukundschaft	„Hobby“: ein Legacy-Tarif, der für Bestandskundschaft bleibt
`.mdc`-Regel	Der vorgeschriebene Dateityp für Projektregeln	„`.cursorrules`“: Legacy, soll eingestellt werden

Cursors Hilfeseite sagt, Cmd+K „used to open inline edit, which has been replaced by this workflow“ (öffnete früher Inline Edit, das durch diesen Ablauf ersetzt wurde). Ein Beitrag eines Cursor-Teammitglieds im offiziellen Forum nennt das Datum, den 26. Oktober 2026, und sagt, dass dies auch das Erzeugen von Befehlen mit Cmd+K im Terminal einschließt. Der vorgeschlagene Ersatz ist Cmd+I und eine Anfrage an Agent. Eine Hilfeseite zum Terminal erwähnt noch das Erzeugen von Befehlen in natürlicher Sprache, die Dokumentation ist hier also nicht ganz einheitlich. Dieser Guide folgt dem Beitrag aus dem Cursor-Team.

Shortcuts für deinen ersten Tag

Cursors Referenztabelle nennt nur Mac-Tasten, und Hilfeseiten ergänzen einige Tasten für Windows und Linux. Wo nichts aufgeführt ist, sagen wir das, statt zu raten. Prüfe diese Fälle in den Shortcut-Einstellungen der App (Cmd+R, dann Cmd+S, oder Ctrl+R, dann Ctrl+S).

Aktion	Mac	Windows / Linux
Agent-Panel öffnen oder schließen	Cmd+I, Cmd+L oder Cmd+K	Ctrl+I, Ctrl+L oder Ctrl+K
Markierten Code an neuen Chat senden	Cmd+L oder Cmd+K	Ctrl+L oder Ctrl+K
Markierten Code zum aktuellen Chat hinzufügen	Cmd+Shift+L	Nicht aufgeführt, in der App prüfen
Modi durchschalten	Shift+Tab	Shift+Tab
Modusmenü öffnen	Cmd+.	Ctrl+.
Modelle durchschalten	Cmd+/	Ctrl+/
Tab-Vorschlag annehmen	Tab	Tab
Tab wortweise annehmen	Cmd+→	Ctrl+→
Tab-Vorschlag ablehnen	Escape oder weitertippen	Escape oder weitertippen
Alle Änderungen annehmen	Cmd+Return	Nicht aufgeführt, in der App prüfen
Alle Änderungen ablehnen	Cmd+Shift+Backspace	Nicht aufgeführt, in der App prüfen
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
Befehlspalette	Cmd+Shift+P	Ctrl+Shift+P

Zwei Tasten hängen davon ab, wo du bist. Cmd+K öffnet im Editor das Panel, im Agents Window aber eine Befehlspalette. Auch Cmd+Return hat je nach Kontext mehrere Bedeutungen, wie die Shortcut-Referenz zeigt. Cmd+Shift+Backspace ist außerdem zum Abbrechen einer laufenden Antwort aufgeführt, drücke es also mit Bedacht.

Die erste Aufgabe: Ein kleines Projekt mit Agent verbessern

Dieses Beispiel nutzt eine einzelne Webseite, du brauchst also nur Cursor und einen Browser. Du stellst zuerst Fragen und lässt Agent dann Änderungen vornehmen.

Schritt 1: Das Übungsprojekt anlegen

Lege einen leeren Ordner namens cursor-practice an und wähle ihn in Cursor als Ordner aus. Erstelle eine Datei namens index.html und füge Folgendes ein:

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

Speichere die Datei und öffne sie im Browser. Drücke den Button ohne eingetragenen Rechnungsbetrag, und du bekommst „Tip: 0“. Das ist das kleine Problem, das du beheben wirst.

Schritt 2: Fragen, bevor du etwas änderst

Drücke Cmd+I (Ctrl+I). Öffne das Modus-Dropdown und wähle Ask oder drücke Shift+Tab, bis es angezeigt wird. Tippe:

Explain what index.html does in plain language.
Then list the problems a user could run into.

Was du sehen solltest: eine schriftliche Antwort im Panel. Deine Datei ändert sich nicht, denn Ask ist schreibgeschützt. Die Antwort wird wahrscheinlich den leeren Rechnungsbetrag erwähnen. Der genaue Wortlaut variiert von Lauf zu Lauf, erwarte also keine feste Antwort.

Schritt 3: Agent eine konkrete Aufgabe geben

Wechsle zurück zu Agent. Ein Moduswechsel öffnet ein neues Kontextfenster, formuliere die Anfrage also so, dass sie für sich allein steht:

In @index.html, improve the tip calculator:
1. If the bill is empty, zero or negative, show "Enter a bill above 0".
2. Show the tip with two decimal places.
3. Add a dropdown for 10%, 15% and 20%, with 15% selected by default.
Keep everything in this one file. Do not add libraries.

Was du sehen solltest: Agent liest die Datei und beginnt zu bearbeiten. Wichtig für den Einstieg: Änderungen werden angewendet, während Agent arbeitet. Du gibst nicht jede Änderung vorab frei. Du prüfst das Ergebnis danach in einer Diff-Ansicht.

Agent möchte vielleicht auch einen Befehl ausführen. Wie damit umgegangen wird, hängt vom Run-Modus ab, eingestellt unter Cursor Settings > Agents > Approvals & Execution. Die Optionen sind Auto-review (der Standard), Allowlist und Run Everything. Lass es vorerst beim Standard.

Schritt 4: Das Diff prüfen

Cursor zeigt die Änderungen in einer Diff-Ansicht. Die Dokumentation nennt den genauen Button nicht, suche also rund um die bearbeitete Datei und das Agent-Panel danach. Lies das Diff Zeile für Zeile. Es zeigt entfernte und hinzugefügte Zeilen, du siehst also genau, was sich geändert hat. Achte bei dieser Aufgabe auf:

eine Prüfung des Rechnungsbetrags
ein Dropdown mit drei Prozentwerten
ein auf zwei Dezimalstellen gerundetes Trinkgeld
nichts Unzusammenhängendes, etwa eine neue Datei, um die du nicht gebeten hast

Lehne alles ab, was du nicht willst. Um auf einem Mac alles auf einmal anzunehmen oder abzulehnen, nutze Cmd+Return oder Cmd+Shift+Backspace. Unter Windows und Linux prüfe das wie oben erwähnt in der App.

Schritt 5: Selbst testen

Lade die Seite im Browser neu und probiere diese Fälle aus:

Eingabe	Erwartetes Ergebnis
Leerer Rechnungsbetrag	Die Meldung „Enter a bill above 0“
-5	Dieselbe Meldung
100 bei 15 %	Tip: 15.00 oder ähnlich
100 bei 20 %	Tip: 20.00 oder ähnlich

Wenn ein Fall fehlschlägt, sag Agent genau, was passiert ist: „Bei einem Rechnungsbetrag von -5 zeigt die Seite Tip: -0.75. Sie sollte die Meldung anzeigen.“ Das funktioniert viel besser als „Es ist kaputt“.

Schritt 6: Rückgängigmachen üben

Nimm jetzt eine Änderung vor, die du wieder verwerfen willst:

Change the page background to bright green and make all text 40px.

Lade den Browser neu, um sie zu sehen. Scrolle dann in der Unterhaltung nach oben und klicke bei dieser Anfrage auf Restore Checkpoint. Eine Hilfeseite nennt diesen Button Revert. Lade erneut, und das Grün sollte weg sein. Wenn nicht, stelle von der Anfrage davor wieder her. Agent erstellt Checkpoints vor größeren Änderungen. Siehst du also bei einer so kleinen Änderung keinen Button, lehne sie stattdessen im Diff ab. Deine Nachrichten bleiben in der Unterhaltung, denn eine Wiederherstellung setzt nur Dateien zurück.

Das ist die ganze tägliche Schleife: fragen, anweisen, prüfen, testen, bei Bedarf rückgängig machen. Wenn Diffs lesen genau der Teil ist, den du nie tun möchtest, ist das früh gut zu wissen. Es kann ein Zeichen sein, dass NxCode, unser eigener App-Builder, besser zu dir passt als ein Editor.

Wann du Agent, Ask, Plan und Debug nutzt

Es gibt vier Modi. Wechsle mit Shift+Tab oder über das Dropdown im Agent-Panel.

Modus	Nutze ihn, wenn	Kann er Dateien ändern?	Beispiel-Prompt
Agent	du etwas bauen, umbauen oder reparieren lassen willst. Das ist der Standard	Ja	„Füge einen Reset-Button hinzu und lösche das Ergebnis, wenn er gedrückt wird.“
Ask	du Code verstehen willst	Nein, schreibgeschützt	„Wie wird das Trinkgeld hier berechnet?“
Plan	die Aufgabe groß oder unklar ist und du den Ansatz zuerst prüfen willst	Nach deiner Freigabe	„Plane, wie diese Seite in getrennte HTML-, CSS- und JS-Dateien aufgeteilt wird.“
Debug	ein Bug Belege aus dem laufenden Programm braucht	Ja	„Das Trinkgeld ist falsch, nachdem ich den Prozentsatz geändert habe. Finde die Ursache.“

Eine einfache Entscheidungshilfe:

Noch nicht verstanden? Ask.
Du weißt, was du willst, und die Änderung ist klein? Agent.
Betrifft viele Dateien, oder du bist beim Ansatz unsicher? Plan.
Ein Bug, den du durch Lesen des Codes nicht erklären kannst? Debug.

Im Plan-Modus stellt Agent Rückfragen, untersucht deinen Code und schreibt einen Plan. Gebaut wird erst, wenn du auf Build klickst. Pläne werden standardmäßig in deinem Home-Verzeichnis gespeichert, und Save to workspace verschiebt einen in dein Projekt. Cursor kann Plan auch vorschlagen, wenn deine Anfrage komplex aussieht.

Im Debug-Modus bildet Agent Hypothesen, ergänzt Logging und nutzt die Laufzeitinformationen, um die Ursache zu finden.

Änderungen prüfen und rückgängig machen

Review-Checkliste

Nutze sie, bevor du eine Änderung von Agent behältst:

Lies das ganze Diff, nicht nur die Zusammenfassung.
Jede geänderte Datei gehört zur Aufgabe.
Du kannst jede Änderung erklären. Wenn nicht, frag im Ask-Modus nach.
Nichts wurde gelöscht, was bleiben sollte.
Im Code stehen keine Passwörter, Schlüssel oder anderen Geheimnisse.
Du hast selbst getestet, auch mit einer ungültigen Eingabe.

Über dein eigenes Review hinaus hat Cursor Agent Review, das du mit /agent-review oder im Tab Source Control startest.

So funktionieren Checkpoints

Agent erstellt automatisch einen Checkpoint vor größeren Änderungen. Checkpoints werden lokal gespeichert und sind von Git getrennt.

Es gibt drei Wege zur Wiederherstellung:

Klicke in der Chat-Zeitleiste auf einen Checkpoint für eine Vorschau und stelle ihn dann wieder her.
Klicke bei einer früheren Anfrage auf Restore Checkpoint.
Fahre mit der Maus über eine Nachricht und klicke auf den +-Button.

Die Wiederherstellung setzt Dateien zurück, löscht aber keine Nachrichten. Um auch die Unterhaltung zu kürzen, erstelle einen Fork ab einer früheren Nachricht.

Bei einem Namen widersprechen sich die offiziellen Seiten. Die Agent-Dokumentation nennt den Button Restore Checkpoint, die Hilfeseite zu Plan dagegen Revert, gefolgt von Confirm. Achte auf beide Beschriftungen.

Nutze Git für alles, was bleiben soll

Cursors eigener Rat lautet: „use Git for permanent version control“ (nutze Git für dauerhafte Versionskontrolle). Checkpoints sind ein schnelles Rückgängig, Git ist deine langfristige Historie. Sichere vor einer größeren Agent-Aufgabe einen funktionierenden Stand:

git init
git add .
git commit -m "Working version before Agent task"

git init brauchst du pro Projekt nur einmal.

Regeln zu deinem Projekt hinzufügen

Rules sind dauerhafte Anweisungen, damit du dich nicht wiederholen musst. Füge dem Übungsprojekt eine hinzu. Es gibt drei Wege, eine Projektregel zu erstellen:

Tippe /create-rule in den Chat.
Geh zu Customize > Rules > Add Rule.
Führe New Cursor Rule über die Befehlspalette aus.

Oder lege die Datei selbst unter .cursor/rules/practice.mdc an:

---
description: Conventions for this practice project
globs:
alwaysApply: true
---

- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

Bitte Agent jetzt um eine weitere kleine Änderung. Er sollte diese Regeln befolgen, ohne dass du sie erwähnst.

Vier Dinge solltest du wissen:

Die Endung muss .mdc sein. Dateien mit der Endung .md werden vom Rules-System in diesem Ordner ignoriert.
AGENTS.md ist die einfachere Option. Es ist reines Markdown und liegt im Projektstamm oder einem Unterordner. Cursor liest CLAUDE.md genauso.
Rules gelten nur für Agent. Sie wirken sich nicht auf Tab oder Bugbot aus.
Halte sie kurz. Cursor empfiehlt weniger als 500 Zeilen pro Regel.

Rules gibt es in vier Typen: Always Apply, Apply Intelligently, Apply to Specific Files und Apply Manually (mit einer @-Erwähnung). Die Rangfolge ist Team, dann Project, dann User. .cursorrules ist Legacy und wird eingestellt, beginne also kein neues Projekt damit.

MCP, Skills, Subagents und Cloud Agents im Überblick

Am ersten Tag brauchst du nichts davon. Das hier dient nur dazu, dass du die Namen wiedererkennst.

MCP verbindet Agent mit externen Tools und Diensten. Installiere über Customize > MCPs > Add to Cursor oder konfiguriere .cursor/mcp.json in einem Projekt oder ~/.cursor/mcp.json global. Wenn beide denselben Namen definieren, gewinnt das Projekt. Unser Cursor-MCP-Guide geht weiter ins Detail.
Skills sind Ordner mit einer Datei SKILL.md, die Agent ein Vorgehen beibringen. Agent nutzt sie, wenn sie relevant sind, oder du rufst einen mit / auf. Eingebaute Beispiele sind /create-rule, /review und /shell.
Subagents haben ihren eigenen Kontext und können parallel laufen. Eingebaut sind Explore und Browser. Eigene kommen in .cursor/agents/.
Cloud Agents laufen auf isolierten Cloud-Maschinen und hängen daher nicht davon ab, dass dein Computer online bleibt. Wähle Cloud im Dropdown am Agent-Eingabefeld. Admins müssen zuerst GitHub, GitLab, Bitbucket oder Azure DevOps verbinden, und du brauchst Lese- und Schreibzugriff auf das Repository. In Free und Plus sind sie nicht verfügbar.

Die Kommandozeile: `agent`

Cursor hat auch eine CLI, und der Befehl lautet agent. Installiere sie so:

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

Prüfe sie mit agent --version und melde dich mit agent login an. Führe dann in einem Projektordner agent für eine interaktive Sitzung aus oder agent -p "your request" für einen einzelnen nicht interaktiven Lauf. Sie liest dieselben Dateien .cursor/rules, AGENTS.md und CLAUDE.md wie der Editor. Am Anfang kannst du das getrost auf später verschieben.

Häufige Fehler

Einem alten Tutorial folgen. Wenn ein Guide sagt, du sollst den Composer-Modus öffnen, mit Cmd+K direkt bearbeiten oder beim ersten Start ein Modell wählen, beschreibt er ein älteres Cursor.

Annehmen, dass sich nichts ändert, bevor du zustimmst. Die Änderungen von Agent sind bereits angewendet, während er arbeitet. Prüfe das Diff, bevor du weitermachst, und führe den Code nicht blind aus.

Vage Anfragen schreiben. „Reparier das“ gibt Agent wenig Anhaltspunkte. Sag, was passiert, was passieren soll und wo: „Wenn der Rechnungsbetrag leer ist, zeigt die Seite Tip: 0. Sie sollte stattdessen eine Meldung anzeigen.“

Zu groß anfangen. Beginne nicht mit einer kompletten App. Nimm zuerst kleine Aufgaben und für alles Größere den Plan-Modus.

Checkpoints als Backups behandeln. Sie sind lokal und von Git getrennt. Committe alles, was dir wichtig ist.

Eine Regel als .md speichern. Das sieht richtig aus und bewirkt nichts. Nutze .mdc oder AGENTS.md im Projektstamm.

Den Run-Modus am ersten Tag ändern. Lass den Standard, bis du verstehst, was Agent auf deinem Computer ausführt und welche Berechtigung jede Option gewährt.

Ein Drittanbieter-Modell wählen, ohne die Kosten zu prüfen. Ab Premium belasten Drittanbieter-Modelle ab der ersten Anfrage das Prepaid-Guthaben zum API-Listenpreis. Sie nutzen nicht deinen Wochenpool.

Code annehmen, den du nicht erklären kannst. Dafür gibt es den Ask-Modus. Frage „Was macht diese Änderung, Schritt für Schritt?“, bevor du sie behältst.

Fehlerbehebung

Oberfläche und Einrichtung

Was du siehst	Wahrscheinlicher Grund	Was du tun kannst
Nirgends ein Composer-Modus	Es gibt ihn nicht mehr als Modus	Nutze Agent mit Cmd+I (Ctrl+I)
Cmd+K bearbeitet nicht direkt	Inline Edit wurde eingestellt	Code markieren, Cmd+K drücken, dann die Änderung in Agent beschreiben
Cmd+K öffnet eine Befehlspalette	Du bist im Agents Window	Mit Cmd+Shift+P, dann Open IDE zurück zum Editor
Eine Grok- oder xAI-Anmeldeseite erscheint	Gemeinsame Anmeldung	Das ist so vorgesehen. Die Anmeldung führt keine Konten zusammen
Eine Erweiterung fehlt	Sie ist vielleicht nicht auf Open VSX	Suche auf Open VSX nach einer Alternative
Eine Regel wird ignoriert	Falsche Endung oder falscher Ort	Nutze `.cursor/rules/name.mdc` und prüfe den Typ
Agent vergisst früheren Kontext	Du hast den Modus gewechselt	Jeder Wechsel öffnet ein neues Kontextfenster, nenne die wichtigsten Punkte also erneut
Ein Shortcut tut unter Windows nichts	Er weicht vielleicht von der Mac-Taste ab	Prüfe die Shortcut-Einstellungen mit Ctrl+R, dann Ctrl+S

Modelle, Tarife und CLI

Was du siehst	Wahrscheinlicher Grund	Was du tun kannst
Claude oder GPT fehlt	Tarif oder Region	Free und Plus schließen Drittanbieter-Modelle aus. Einige Modelle sind außerdem in bestimmten Regionen ausgeblendet
Cloud Agents sind nicht verfügbar	Tarif oder Repository-Einrichtung	Nötig sind mindestens Premium, ein verbundener Git-Anbieter und Repository-Zugriff
Du stößt an ein Nutzungslimit	Tariflimit erreicht	Prüfe Usage auf grok.com/dashboard. In bezahlten Tarifen auf den wöchentlichen Reset warten, Prepaid-Guthaben nutzen oder upgraden
Abrechnung nicht auffindbar	Abrechnung ist umgezogen	The X Subscription nutzt grok.com/dashboard/billing. Legacy-Tarife nutzen cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin` ist nicht in deinem PATH	Füge es deinem PATH hinzu und öffne dann ein neues Terminal

Wann ein anderes Tool besser passt

Cursor ist ein Werkzeug für die Arbeit mit Code. Diese Szenarien können woandershin führen:

Du möchtest gar keinen Code schreiben oder prüfen. Du willst aus einer Beschreibung eine funktionierende App. Dafür ist NxCode, unser eigenes Produkt, gedacht. Wir stellen es her, berücksichtige das beim Lesen, und sieh dir unseren Vergleich mit Cursor und Copilot an.
Du lebst im Terminal. Probiere zuerst Cursors Befehl agent oder vergleiche ihn mit dem Workflow in unserem Claude-Code-Tutorial.
Du nutzt JetBrains. Du musst vielleicht nicht den Editor wechseln, denn Cursors Agent verbindet sich über ACP mit JetBrains.
Du vergleichst noch Tools. Unser Ranking von KI-Coding-Tools stellt die Optionen vor.

Cursor mit Free auszuprobieren kostet nichts, eine kleine echte Aufgabe ist also ein vernünftiger Weg zur Entscheidung. Wenn sich der Ablauf oben natürlich angefühlt hat, bleib dabei. Wenn dir der Code selbst im Weg stand, passt wahrscheinlich das erste Szenario zu dir.

FAQ

Wie fange ich zum ersten Mal mit Cursor an?

Lade Cursor von cursor.com/download herunter, öffne es, melde dich an und wähle einen Ordner. Drücke dann Cmd+I (Ctrl+I unter Windows und Linux), um Agent zu öffnen, und bitte ihn, den Code zu erklären. Cursors Quickstart empfiehlt, mit einer kleinen Aufgabe wie dieser zu beginnen.

Was ist aus dem Composer-Modus in Cursor geworden?

Der Composer-Modus kommt in Cursors aktueller Dokumentation nicht vor. Composer ist jetzt der Name von Cursors eigenem Modell, derzeit Composer 2.5. Die vier Modi sind Agent, Ask, Plan und Debug. Für die Arbeit über mehrere Dateien, die ältere Tutorials im Composer-Modus erledigten, nutzt du Agent.

Was ist aus Inline Edit mit Cmd+K in Cursor geworden?

Inline Edit wurde eingestellt. Ein Beitrag eines Cursor-Teammitglieds im offiziellen Forum datiert das auf den 26. Oktober 2026. Markiere im Editor Code und drücke Cmd+K oder Cmd+L (Ctrl+K oder Ctrl+L unter Windows und Linux), um die Auswahl in Agent zu holen, und beschreibe dort die Änderung.

Ist Cursor kostenlos?

Ja, es gibt einen Free-Tarif für $0 mit begrenzter Nutzung von Agent, Chat und Tab. Cursor nennt für diese Limits keine Zahl. Die aktuelle Preisseite sagt nicht, ob eine Kreditkarte nötig ist, prüfe das also bei der Anmeldung. Bezahlte Tarife beginnen mit Plus für $8 im Monat vor Steuern.

Welche KI-Modelle kann ich in Cursor nutzen?

Cursors eigene Modelle sind Grok 4.7, das Cursor sein Flaggschiffmodell nennt, Grok 4.6, Grok 4.5 und Composer 2.5. Drittanbieter-Modelle wie Claude, GPT und Gemini brauchen mindestens Premium und werden zum API-Listenpreis aus Prepaid-Guthaben bezahlt. Free und Plus enthalten sie nicht.

Ändert Cursor Agent meine Dateien, bevor ich zustimme?

Ja. Agent wendet Änderungen während der Arbeit an, und du prüfst sie danach in einer Diff-Ansicht, in der du ablehnen kannst, was du nicht willst. Agent erstellt außerdem vor größeren Änderungen Checkpoints, sodass du frühere Dateistände wiederherstellen kannst.

Muss ich programmieren können, um Cursor zu nutzen?

Du kannst es ohne viel Erfahrung ausprobieren, weil der Ask-Modus Code in einfacher Sprache erklärt, du musst aber trotzdem Diffs lesen und das Ergebnis beurteilen. Wenn du lieber eine App beschreiben und gar nicht mit Code arbeiten möchtest, ist NxCode, unser eigenes Produkt, dafür gebaut.

Wo kann ich Cursor kaufen, und kann ich aus Festlandchina abonnieren?

Laut Cursor werden Abos nur über die offizielle Website oder per In-App-Kauf verkauft, Reseller sind nicht autorisiert. Der In-App-Kauf auf iOS deckt die App-Store-Regionen außer Festlandchina ab. Ob Web-Abos in Festlandchina eingeschränkt sind, ließ sich anhand der offiziellen Seiten nicht verifizieren.

Quellen

Alle Seiten wurden am 1. November 2026 geprüft. Shortcuts, Tarife und Namen können sich ändern, maßgeblich sind also die App und die offiziellen Seiten.