Nachdem das letzte Kapitel die lesenden Werkzeuge behandelt hat, geht es jetzt um die beiden wichtigsten schreibenden Werkzeuge: Edit und Write. Beide verändern tatsächlich etwas in deinem Projekt - deshalb behandelt sie Claude Code auch anders als reine Lese-Werkzeuge, wie du im nächsten Kapitel siehst.

Edit: eine gezielte Änderung an einer bestehenden Datei

Edit ändert einen bestehenden Abschnitt einer bereits vorhandenen Datei, ohne den Rest der Datei anzufassen. Im Prinzip funktioniert das wie "Suchen und Ersetzen": Ein bestimmter, eindeutig identifizierbarer Textabschnitt wird durch einen neuen ersetzt. Genau das macht Edit zum passenden Werkzeug für gezielte Änderungen: einen Bug in einer einzelnen Funktion beheben, einen Variablennamen konsistent umbenennen, eine einzelne Zeile Konfiguration anpassen.

Weil Edit nur den betroffenen Abschnitt anfasst, bleibt der Rest der Datei - Kommentare, Formatierung, andere Funktionen - unverändert erhalten. Das macht Änderungen auch leichter nachvollziehbar, etwa in einem späteren git diff (mehr dazu in Block 5).

Write: eine Datei komplett (neu) schreiben

Write schreibt eine Datei von Grund auf - entweder eine komplett neue Datei oder das vollständige Ersetzen des Inhalts einer bereits bestehenden Datei. Write ist das passende Werkzeug, wenn eine Datei noch gar nicht existiert (zum Beispiel eine neue Komponente oder ein neues Testmodul) oder wenn eine bestehende Datei so grundlegend umgebaut werden soll, dass eine Reihe einzelner Edit-Änderungen unübersichtlicher wäre als ein kompletter Neuschrieb.

Wann welches Werkzeug sinnvoll ist

• Edit für gezielte, punktuelle Änderungen an bestehenden Dateien - der Normalfall bei Bugfixes und kleineren Anpassungen.
• Write für neue Dateien oder für so weitreichende Umbauten einer bestehenden Datei, dass ein kompletter Neuschrieb klarer ist als viele einzelne Edits.

In der Praxis triffst du diese Entscheidung meist nicht selbst - Claude Code wählt anhand deiner Anfrage das passende Werkzeug. Es hilft aber, den Unterschied zu kennen, um Änderungsvorschläge besser einzuordnen: Eine Edit-Änderung betrifft typischerweise nur wenige Zeilen, eine Write-Änderung kann die gesamte Datei umfassen.

Änderungen nachvollziehen, bevor sie passieren

Bevor eine Edit- oder Write-Änderung tatsächlich gespeichert wird, zeigt dir Claude Code üblicherweise, was genau geändert werden soll - meist in Form eines Vorher-Nachher-Vergleichs, ähnlich einem git diff. Das gibt dir die Möglichkeit, die Änderung zu prüfen, bevor sie wirksam wird. Wie genau diese Bestätigung abläuft und wie du sie konfigurierst, ist Thema des nächsten und übernächsten Kapitels.