Wird geladen
Wird geladen

Das Text Editor Tool ist Claudes integrierte Fähigkeit, die ihm Dateisystemzugriff und Textbearbeitungsfähigkeiten gibt. Anders als bei anderen Tools, bei denen du sowohl das Schema als auch die Implementierung schreibst, weiß Claude bereits, wie es Text-Editor-Operationen anfordern muss - du musst diese Anfragen nur noch behandeln.

Was das Text Editor Tool macht

Dieses Tool gibt Claude die Fähigkeit, mit Dateien und Verzeichnissen zu arbeiten, wie es ein Softwareentwickler tun würde:

  • Datei- oder Verzeichnisinhalte anzeigen
  • Bestimmte Zeilenbereiche in einer Datei anzeigen
  • Text in Dateien ersetzen
  • Neue Dateien erstellen
  • Text an bestimmten Zeilennummern einfügen

Wie es funktioniert

Das Text Editor Tool unterscheidet sich von benutzerdefinierten Tools dadurch, dass nur das JSON-Schema in Claude eingebaut ist. Du musst trotzdem die eigentliche Implementierung bereitstellen.

Jedes benutzerdefinierte Tool verbindet ein JSON-Schema mit einer Funktion: add_duration_to_datetime, get_current_datetime, set_reminder.

Wenn du benutzerdefinierte Tools erstellst, schreibst du beide Seiten - das Schema, das Claude über das Tool informiert, und die Funktion, die die eigentliche Arbeit erledigt. Beim Text Editor Tool hat Claude bereits das Schema, aber du musst Funktionen schreiben, um Claudes Anfragen zum Anzeigen, Bearbeiten oder Erstellen von Dateien zu behandeln.

Einrichtung des Tools

Um das Text Editor Tool zu verwenden, musst du die Tool-Version angeben, die zu deinem Modell passt:

python
# Für Claude 4 und spätere Modelle
text_editor = "text_editor_20250728"

# Für frühere Claude-Modelle
text_editor = "text_editor_20250124"

Der Rest dieser Lektion verwendet die Claude 4 und spätere Version; mit text_editor_20250124 lautet der Tool-Name stattdessen str_replace_editor, und es gibt auch einen Befehl undo_edit.

Du musst außerdem deine Chat-Funktion anpassen, damit sie den Text-Editor-Parameter akzeptiert und ihn in die Modellkonfiguration einbezieht.

Tool-Befehle

Wenn Claude den Text-Editor verwenden möchte, sendet es Tool-Use-Anfragen mit bestimmten Befehlen zurück:

Notebook-Zelle, in der run_tool die str_replace_editor-Befehle "view", "str_replace", "create", "insert" und "undo_edit" behandelt.

Deine Implementierung muss alle vier Befehle behandeln: view, str_replace, create und insert. Hier ist die grundlegende Struktur zur Verarbeitung dieser Anfragen:

python
def run_tool(tool_name, tool_input):
    if tool_name == "str_replace_based_edit_tool":
        command = tool_input.get("command", "")
        if command == "view":
            path = tool_input.get("path", "")
            return text_editor_tool.view(path)
        elif command == "str_replace":
            path = tool_input.get("path", "")
            old_str = tool_input.get("old_str", "")
            new_str = tool_input.get("new_str", "")
            return text_editor_tool.str_replace(path, old_str, new_str)
        # ... andere Befehle behandeln

Beispiel: Dateianalyse

So funktioniert das Tool in der Praxis. Wenn du Claude bittest, "Schreibe eine einsätzige Beschreibung des Codes in der Datei ./main.py", passiert Folgendes:

ToolUse-, ToolResult- und Text-Teile: Claude erhält eine Hello-Funktion, die "hi there" ausgibt, und antwortet, dass sie einen Gruß ausgibt.

Claude sendet eine Tool-Use-Anfrage mit {"command": "view", "path": "./main.py"}. Dein Server verwendet die TextEditorTool-Klasse, um die Datei zu lesen, und gibt den Inhalt zurück. Claude liefert dann seine Analyse basierend auf dem Code, den es gelesen hat.

Praktische Anwendungen

Das Text Editor Tool verwandelt Claude im Wesentlichen in einen Code-Assistenten, der Folgendes kann:

  • Bestehenden Code lesen und eine Analyse liefern
  • Neue Dateien und Funktionen erstellen
  • Bestehenden Code ändern
  • Testdateien einrichten
  • Code über mehrere Dateien hinweg refactoren

Du könntest Claude zum Beispiel bitten, "schreibe eine Funktion, um Pi auf die 5. Stelle in main.py zu berechnen, und erstelle dann eine Datei test.py, um sie zu testen." Claude liest die bestehende Datei, fügt die neue Funktion hinzu, erstellt die Testdatei und schreibt umfassende Tests - alles automatisch mithilfe der Text-Editor-Befehle.

Dies macht es möglich, KI-gestützte Entwicklungstools zu bauen, die modernen Code-Editoren mit integrierten KI-Funktionen ähneln, bei denen du Codeänderungen anfordern und sie direkt in deinem Dateisystem umgesetzt bekommen kannst.