Wie Coding-Agenten arbeiten
Claude Code, Codex und ihre Verwandten arbeiten alle nach derselben Schleife: lesen, planen, ändern, prüfen. Wer die Schleife kennt, weiß, wo er eingreifen muss – und welche Rechte er wofür vergibt.
Boaz Lichtenstein
Ein Chat-Assistent schlägt Code vor, den du kopierst. Ein Coding-Agent arbeitet selbst in deinem Projekt: Er öffnet Dateien, führt Befehle aus, ändert, testet. Die Werkzeuge heißen Claude Code, Codex, Copilot oder Cursor und unterscheiden sich in vielem – nicht aber in der Schleife, nach der sie arbeiten.
Die Schleife
1. Lesen. Der Agent sucht die Stellen, die zur Aufgabe gehören: Dateinamen auflisten, nach Begriffen suchen, Dateien öffnen. Was er nicht liest, kennt er nicht – ein Agent, der eine Funktion ändert, ohne ihre Aufrufer gelesen zu haben, bricht sie.
2. Planen. Aus dem Gelesenen entsteht ein Vorgehen. Gute Agenten schreiben es auf, bevor sie etwas ändern.
3. Ändern. Dateien bearbeiten, neue anlegen, Befehle ausführen.
4. Prüfen. Tests laufen lassen, das Programm starten, die Ausgabe lesen. Schlägt etwas fehl, beginnt die Schleife von vorn.
Der vierte Schritt ist der, an dem sich gute von schlechten Ergebnissen trennen. Ein Agent ohne Möglichkeit zur Prüfung rät – sehr überzeugend.
Wo er läuft
Lokal sieht der Agent alles, was dein Benutzerkonto sieht. In der Cloud sieht er nur das Repository – sicherer, aber ohne deine lokalen Dateien und Dienste.
Rechte: drei Stufen
Jeder Agent kennt Abstufungen, die etwa so aussehen:
- Nur planen. Er liest und schlägt vor, ändert aber nichts.
- Nachfragen. Vor jeder Dateiänderung und jedem Befehl wartet er auf deine Zustimmung.
- Selbstständig. Er arbeitet durch und fragt nur bei bestimmten Befehlen.
Die richtige Stufe hängt nicht von deinem Vertrauen in das Modell ab, sondern davon, was schiefgehen kann. In einem Wegwerf-Projekt auf einem eigenen Branch darf er durcharbeiten. In einem Ordner mit Zugangsdaten oder mit Zugriff auf ein Produktivsystem nicht.
Viele Agenten bieten zusätzlich eine Sandbox: Befehle laufen in einer abgeschotteten Umgebung ohne Netz und ohne Zugriff außerhalb des Projektordners. Wenn es sie gibt, schalte sie ein.
Der Planungsmodus
Lass den Agenten bei jeder nicht trivialen Aufgabe zuerst planen. Du bekommst eine Liste: welche Dateien, welche Änderungen, in welcher Reihenfolge. Daran siehst du in einer Minute, ob er die Aufgabe verstanden hat. Einen falschen Plan zu korrigieren kostet einen Satz. Eine falsche Umsetzung zurückzubauen kostet den Nachmittag.
Kontext ist endlich
Alles, was der Agent liest, belegt Platz in seinem Arbeitsgedächtnis. Nach zwei Stunden mit vielen Dateien und Fehlversuchen werden die Antworten ungenauer: frühere Entscheidungen gehen verloren, bereits Verworfenes taucht wieder auf.
Drei Gegenmittel:
- Regeldatei statt Wiederholung. Was immer gilt, steht in
AGENTS.mdoderCLAUDE.md. - Neue Sitzung bei neuem Thema. Mit einer Übergabe in fünf Sätzen: Ziel, Stand, offene Punkte.
- Nach der dritten Korrektur neu anfangen. Ein besserer Auftrag in einer frischen Sitzung schlägt den fünften Flickversuch.
Was du verlangen solltest
Ein Agent sagt gern „fertig“. Verlange stattdessen drei Dinge: was geändert wurde, welchen Befehl er zur Prüfung ausgeführt hat und was der Befehl ausgegeben hat. Fehlt der dritte Teil, wurde nicht geprüft.
Wie ein Auftrag aussieht, der diese Prüfung von Anfang an mitliefert, ist das Thema der nächsten Station.