Cursor Agent-Modus nutzen: Repo-Aufgabe starten und Diffs prüfen
Agent öffnen, eine begrenzte Repo-Aufgabe geben, Diffs selbst lesen, bevor etwas bleibt.
Das Repo ist in Cursor schon offen. Das Modell soll arbeiten — ohne einen Stapel ungelesener Diffs zu übernehmen. Die offizielle Hilfe nennt diesen Weg den Agent-Modus: einen Chat starten, eine Repo-Aufgabe geben, jede berührte Datei lesen.
Die suchbare Aufgabe ist Cursor Agent-Modus nutzen: das Agent-Panel öffnen, den nur lesenden Ask meiden, eine begrenzte Aufgabe schreiben und in der Diff-Ansicht entscheiden, was bleibt. Kürzel und Prüfschritte folgen cursor.com/help/ai-features/agent.
Den Modus wählen, der Dateien ändern darf
Agent schreibt
Er sucht den Baum, ändert viele Dateien, startet eine Shell und kann bei Fehlern anhalten. Das Ergebnis ist ein Patch, den ihr lest und behaltet.
Ask liest nur
Ask beantwortet Fragen und ändert nichts. Sitzt das Panel auf Ask, gibt es eine Erklärung und eine leere Diff. Umschalt+Tab wechselt die Modi; das Dropdown tut dasselbe.
| Modus | Wann | Ändert Dateien? |
|---|---|---|
| Agent | Funktion, Refactor oder Fix, den ihr prüfen wollt | Ja |
| Ask | Nur den Baum verstehen | Nein |
| Plan | Große Änderung über viele Dateien, zuerst ein Plan | Nach Freigabe des Plans |
| Debug | Fehler, der Laufzeitbelege braucht | Ja |
Ein Durchlauf: starten, zuweisen, prüfen
- 01Das Agent-Panel öffnen
In einem Ordner, der schon ein Git-Repo ist, Cmd+I (Mac) oder Ctrl+I (Windows/Linux). Der Schalter muss Agent heißen. War der letzte Thread eine andere Sache, neuen Chat öffnen. Offiziell: jeder Modus hat eigenen Kontext; bei Aufgabenwechsel ist frisch sauberer.
- 02Eine begrenzte Repo-Aufgabe geben
Ergebnis, Dateien oder Bereich und das Fertig-Kriterium nennen. Beispiel: Nullprüfung in src/auth/session.ts, vorhandenen Unit-Test laufen. Keine fünf fremden Arbeiten. Das offizielle Beispiel ist eine konkrete Bitte.
- 03Die Diff-Ansicht beobachten
Return. Agent sucht, wendet Änderungen während der Arbeit an. Dateien öffnen sich in der Diff. Stop, wenn er den genannten Ordner verlässt. Eine Folgeanweisung wartet in der Queue, bis der Lauf endet.
- 04Lesen, dann behalten oder ablehnen
Neue und gelöschte Zeilen lesen. Unerwünschte Brocken ablehnen. Über eine frühere Nachricht Restore Checkpoint: Dateiänderungen danach gehen zurück, der Chat bleibt. Tests selbst laufen lassen; eine grüne Zeile im Agent-Log ist keine Abnahme.
In src/auth/session.ts eine Wache: fehlt die
user id, 401 zurück. Den Ordner billing nicht
anfassen. Den vorhandenen session-Unit-Test
laufen und bei Fehler stoppen.
Wo erste Aufgaben oft brechen
- Das Panel stand auf Ask
- Keine Datei ändert sich. Mit Umschalt+Tab oder dem Moduswähler auf Agent, dieselbe Eingabe erneut senden.
- Der Prompt nannte keine Grenze
- Agent sucht weit. Verzeichnis, Test und verbotene Pfade nennen.
- Den ganzen Stapel übernommen
- Fremde Dateien ablehnen. Löschungen prüfen. Ist die Form falsch, Checkpoint wiederherstellen statt eine zweite Umschreibung auf einen schlechten Patch zu legen.
Eine Aufgabe, ein Chat, dann die Diff lesen. Die Übernehmen-Taste ist keine Prüfung.
Cloud Agents sind eine andere Tür
cursor.com/agents kann einen Cloud Agent im Browser starten. Die Desktop-Schleife dieses Leitfadens gilt weiter: die Prüfung gehört euch. Ungelesene Diffs auf keinem der Wege mergen.
Müssen zwei Leute eine Umstrukturierung abstimmen, bevor jemand ausliefert, Liste und riskante Brocken auf eine Seite. Ein kurzer oakmeet-Raum reicht — Browser, Raumcode, kein Konto. Grenzen stehen unter acht Personen, etwa eine Stunde.
Ist Agent dasselbe wie Composer oder Chat?
Die aktuelle Hilfe nennt Agent den Assistenten, der Dateien ändern und Befehle ausführen kann. Ältere Oberflächen schrieben Composer. Zeigt euer Build noch Composer, den Modus wählen, der Dateien ändern darf — nicht den nur lesenden Ask/Chat.
Brauche ich Konto und bezahlten Tarif?
Anmeldung ist nötig. Der Verbrauch folgt Cursor-Tarif und Modellkontingent. Aktuelle Tarife stehen unter cursor.com/docs. Diese Seite verkauft keinen Tarif.
Kann ich nach dem Übernehmen zurück?
Restore Checkpoint an einer früheren Agent-Nachricht setzt Dateiänderungen danach zurück. git checkout / git restore gelten weiter für alles auf der Platte. Restore löscht den Chat nicht.
Lieber zuerst Plan?
Bei einer großen Änderung über viele Dateien sagt die Tabelle: zuerst Plan, Ansatz freigeben, dann darf er ändern. Für eine einzelne, klar begrenzte Repo-Aufgabe geht dieses Tutorial den Agent-Weg.