Mit Cursor mehrere Dateien für eine Aufgabe ändern

Das Problem

Eine Aufgabe im Code betrifft selten nur eine Datei. Wenn in Ihrer Software ein Feld «Telefon» hinzukommen soll, müssen Datenbank, Eingabemaske, Prüfung, Anzeige und vielleicht Export angepasst werden. Wer das von Hand erledigt, verliert Zeit mit Suchen und Anpassen, und übersieht schnell eine Stelle.

Cursor, ein Programmier-Editor mit eingebauter KI, kann solche zusammenhängenden Änderungen über mehrere Dateien vorbereiten und durchführen. Der Agent liest das Projekt, schlägt Änderungen vor und bearbeitet die Dateien. Das spart Zeit, birgt aber ein Risiko: Je mehr Dateien betroffen sind, desto schwerer ist es, den Überblick zu behalten, und desto grösser ist der Schaden bei Fehlern.

Diese Seite zeigt ein Vorgehen, mit dem Sie die Kontrolle behalten. Sie richtet sich an Personen, die Software entwickeln oder betreuen. Die Angaben beziehen sich auf den Stand Oktober 2026. Oberfläche und Funktionen von Cursor ändern sich häufig, massgebend ist die Dokumentation des Herstellers.

So lösen Sie es mit KI – Schritt für Schritt

1. Versionsstand sichern. Stellen Sie sicher, dass das Projekt in einer Versionsverwaltung (zum Beispiel Git) liegt und alle bisherigen Änderungen gespeichert sind. Legen Sie für die Aufgabe einen eigenen Arbeitszweig an. So können Sie alles rückgängig machen.

1. Aufgabe klein schneiden. Eine Aufgabe, ein Ziel. «Telefonfeld zur Kundenmaske hinzufügen» ist gut, «Kundenverwaltung modernisieren» ist zu gross.

1. Kontext mitgeben. Nennen Sie betroffene Dateien oder Ordner, Vorgaben zum Stil und zu bestehenden Regeln. Siehe Projektregeln. Weisen Sie auf Dateien hin, die nicht verändert werden dürfen.

1. Zuerst einen Plan verlangen. Lassen Sie den Agenten schreiben, welche Dateien er ändern will und warum, ohne bereits zu ändern. Prüfen Sie den Plan und korrigieren Sie ihn.

1. Änderungen ausführen lassen. Geben Sie den Plan frei und lassen Sie den Agenten die Änderungen vornehmen. Beobachten Sie, welche Dateien betroffen sind.

1. Jede Änderung ansehen. Gehen Sie die Vergleichsansicht (Diff) Datei für Datei durch. Prüfen Sie, ob Änderungen zum Plan passen und nichts Unerwartetes enthalten. Siehe Änderungen prüfen.

1. Tests und Probelauf. Führen Sie vorhandene Tests aus und probieren Sie die Funktion von Hand. Lassen Sie den Agenten fehlende Tests vorschlagen, aber prüfen Sie diese ebenfalls.

1. Übernehmen oder verwerfen. Übernehmen Sie in einzelnen, verständlichen Schritten mit klarer Beschreibung. Bei Zweifeln verwerfen Sie und beginnen mit einem engeren Auftrag neu.

Vorlage zum Kopieren

AUFGABE (eine Sache):
[z. B. Füge im Kundenformular ein optionales Feld «Telefon» hinzu und zeige es in der Kundenliste an.]

KONTEXT:
- Relevante Dateien/Ordner: [z. B. src/kunden/, templates/kunde_form.php, db/migrationen/]
- Bestehende Konventionen: [z. B. Eingaben werden mit der Funktion h() ausgegeben, Formulare nutzen CSRF-Schutz]
- Nicht ändern: [z. B. alles unter vendor/, Konfigurationsdateien, bestehende Migrationen]

VORGEHEN:
1. Schreibe zuerst einen Plan: welche Dateien du änderst und warum. Ändere noch nichts.
2. Warte auf meine Freigabe.
3. Ändere nur die genannten Dateien und nur, was zur Aufgabe gehört. Kein Umbau, keine Umbenennungen, keine neuen Abhängigkeiten.
4. Liste danach alle geänderten Dateien mit je einem Satz auf.
5. Nenne Risiken und Stellen, die ich von Hand prüfen soll. Wenn du etwas nicht sicher weisst, sage es.

Ersetzen Sie die Angaben. Der erste Schritt, der Plan, ist die wichtigste Sicherung gegen unerwünschte Änderungen.

Worauf Sie achten müssen

• Umfang begrenzen: Agenten ändern gern mehr als verlangt, etwa Formatierung oder Namen. Verlangen Sie ausdrücklich, dass nur das Nötige angepasst wird.
• Übersehene Stellen: Der Agent findet nicht automatisch alle betroffenen Orte. Tests und Suche im Projekt helfen.
• Sicherheitsrelevanter Code: Eingabeprüfung, Rechte und Zugangsdaten verlangen besondere Sorgfalt. Lassen Sie solche Änderungen von einer zweiten Person prüfen.
• Datenschutz: Der Inhalt Ihres Projekts wird für die KI verarbeitet. Klären Sie, was übertragen wird. Siehe Cursor und Datenschutz.
• Geheimnisse: Passwörter und Schlüssel gehören nicht in Quelldateien, die der Agent liest.
• Wartbarkeit: Code, den niemand versteht, ist ein Problem. Übernehmen Sie nur, was Ihr Team nachvollziehen kann.
• Kosten und Grenzen: Intensive Agentennutzung kann Nutzungsgrenzen ausschöpfen. Siehe Cursor kostenlos und Grenzen.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Entwickler bei einer Schweizer Hausverwaltung betreut ein internes Tool für Schadenmeldungen. Neu soll bei jeder Meldung eine Telefonnummer der Meldenden gespeichert und angezeigt werden.

Vorher: Er sucht von Hand in zehn Dateien nach Stellen und übersieht den Export. Nachher: Er legt einen Arbeitszweig an, schreibt den Auftrag mit der Vorlage und lässt zuerst einen Plan erstellen. Der Plan nennt acht Dateien, davon eine ungeplante Konfigurationsdatei, die er ausschliesst. Nach der Ausführung prüft er jeden Diff, ergänzt den Export von Hand und lässt die vorhandenen Tests laufen. Erst dann übernimmt er die Änderung in zwei Schritten.

So hilft Ihnen Alpasana

Wer KI bei Programmieraufgaben einsetzt, muss Änderungen systematisch kontrollieren. Der Kurs KI für Developer von absofort umfasst nach Angebotsbeschreibung Codegenerierung, Debugging, Refactoring und Review, das Delegieren von Aufgaben und die Verifikation der Ergebnisse sowie Datenschutzgrenzen, mit Claude, Claude Code, Claude API und Codex als Kursgegenständen. Ein Entwickler-Playbook mit Prompts, Review-Regeln und Tests gehört dazu. Der Kurs behandelt nicht speziell Cursor.

Häufige Fragen

Wie viele Dateien darf der Agent auf einmal ändern?

Eine feste Zahl gibt es nicht. Entscheidend ist, ob Sie die Änderungen noch überblicken. Als Faustregel: Wenn Sie den Diff nicht in angemessener Zeit sorgfältig lesen können, ist der Auftrag zu gross. Teilen Sie ihn auf.

Was, wenn die Änderung nach der Übernahme Fehler verursacht?

Dank Versionsverwaltung können Sie zum vorherigen Stand zurückkehren. Deshalb ist der Arbeitszweig so wichtig. Beschreiben Sie den Fehler dem Agenten, aber prüfen Sie jede neue Änderung wieder.

Soll ich dem Agenten erlauben, Befehle selbst auszuführen?

Nur mit Vorsicht. Befehle können Dateien löschen oder Daten verändern. Lassen Sie sich Befehle vor der Ausführung zeigen und erlauben Sie nur, was Sie verstehen. In sensiblen Umgebungen arbeiten Sie in einer Testumgebung.