Text-Editor-Tool
Claude kann ein von Anthropic definiertes Text-Editor-Tool verwenden, um Textdateien anzuzeigen und zu ändern, was Ihnen beim Debuggen, Beheben und Verbessern Ihres Codes oder anderer Textdokumente hilft. Dies ermöglicht Claude, direkt mit Ihren Dateien zu interagieren und praktische Unterstützung zu bieten, anstatt nur Änderungen vorzuschlagen.
Modellkompatibilität
| Modell | Tool-Version |
|---|---|
| Claude 4.x Modelle | text_editor_20250728 |
| Claude Sonnet 3.7 (veraltet) | text_editor_20250124 |
Das text_editor_20250728 Tool für Claude 4 Modelle enthält nicht den undo_edit Befehl. Wenn Sie diese Funktionalität benötigen, müssen Sie Claude Sonnet 3.7 (veraltet) verwenden.
Ältere Tool-Versionen sind nicht garantiert rückwärtskompatibel mit neueren Modellen. Verwenden Sie immer die Tool-Version, die Ihrer Modellversion entspricht.
Wann das Text-Editor-Tool verwenden
Einige Beispiele für die Verwendung des Text-Editor-Tools sind:
- Code-Debugging: Lassen Sie Claude Fehler in Ihrem Code identifizieren und beheben, von Syntaxfehlern bis zu Logikproblemen.
- Code-Refaktorierung: Lassen Sie Claude Ihre Code-Struktur, Lesbarkeit und Leistung durch gezielte Änderungen verbessern.
- Dokumentationsgenerierung: Bitten Sie Claude, Docstrings, Kommentare oder README-Dateien zu Ihrer Codebasis hinzuzufügen.
- Testerstellung: Lassen Sie Claude Unit-Tests für Ihren Code basierend auf seinem Verständnis der Implementierung erstellen.
Das Text-Editor-Tool verwenden
Das Text-Editor-Tool kann auf folgende Weise verwendet werden:
Stellen Sie Claude das Text-Editor-Tool und eine Benutzereingabe zur Verfügung
- Fügen Sie das Text-Editor-Tool in Ihre API-Anfrage ein
- Geben Sie eine Benutzereingabe an, die möglicherweise das Untersuchen oder Ändern von Dateien erfordert, z. B. „Kannst du den Syntaxfehler in meinem Code beheben?"
Claude verwendet das Tool, um Dateien oder Verzeichnisse zu untersuchen
- Claude bewertet, was es sich ansehen muss, und verwendet den
viewBefehl, um Dateiinhalte zu untersuchen oder Verzeichnisinhalte aufzulisten - Die API-Antwort enthält einen
tool_useInhaltsblock mit demviewBefehl
- Claude bewertet, was es sich ansehen muss, und verwendet den
Führen Sie den view-Befehl aus und geben Sie Ergebnisse zurück
- Extrahieren Sie den Datei- oder Verzeichnispfad aus Claudes Tool-Use-Anfrage
- Lesen Sie den Dateiinhalt oder listen Sie die Verzeichnisinhalte auf
- Wenn ein
max_charactersParameter in der Tool-Konfiguration angegeben wurde, kürzen Sie den Dateiinhalt auf diese Länge - Geben Sie die Ergebnisse an Claude zurück, indem Sie das Gespräch mit einer neuen
userNachricht mit einemtool_resultInhaltsblock fortsetzen
Claude verwendet das Tool, um Dateien zu ändern
- Nach dem Untersuchen der Datei oder des Verzeichnisses kann Claude einen Befehl wie
str_replaceverwenden, um Änderungen vorzunehmen, oderinsert, um Text an einer bestimmten Zeilennummer hinzuzufügen. - Wenn Claude den
str_replaceBefehl verwendet, erstellt Claude eine ordnungsgemäß formatierte Tool-Use-Anfrage mit dem alten Text und dem neuen Text, um ihn zu ersetzen
- Nach dem Untersuchen der Datei oder des Verzeichnisses kann Claude einen Befehl wie
Führen Sie die Bearbeitung aus und geben Sie Ergebnisse zurück
- Extrahieren Sie den Dateipfad, den alten Text und den neuen Text aus Claudes Tool-Use-Anfrage
- Führen Sie den Textersatz in der Datei durch
- Geben Sie die Ergebnisse an Claude zurück
Claude bietet seine Analyse und Erklärung
- Nach dem Untersuchen und möglicherweise Bearbeiten der Dateien bietet Claude eine vollständige Erklärung dessen, was es gefunden hat und welche Änderungen es vorgenommen hat
Text-Editor-Tool-Befehle
Das Text-Editor-Tool unterstützt mehrere Befehle zum Anzeigen und Ändern von Dateien:
view
Der view Befehl ermöglicht Claude, den Inhalt einer Datei zu untersuchen oder den Inhalt eines Verzeichnisses aufzulisten. Er kann die gesamte Datei oder einen bestimmten Zeilenbereich lesen.
Parameter:
command: Muss „view" seinpath: Der Pfad zur anzuzeigenden Datei oder zum Verzeichnisview_range(optional): Ein Array von zwei Ganzzahlen, das die Start- und Endzeilennummern zum Anzeigen angibt. Zeilennummern sind 1-indiziert, und -1 für die Endzeilennummer bedeutet bis zum Ende der Datei lesen. Dieser Parameter gilt nur beim Anzeigen von Dateien, nicht von Verzeichnissen.
str_replace
Der str_replace Befehl ermöglicht Claude, einen bestimmten String in einer Datei durch einen neuen String zu ersetzen. Dies wird für präzise Bearbeitungen verwendet.
Parameter:
command: Muss „str_replace" seinpath: Der Pfad zur zu ändernden Dateiold_str: Der zu ersetzende Text (muss genau übereinstimmen, einschließlich Leerzeichen und Einrückung)new_str: Der neue Text, der anstelle des alten Textes eingefügt werden soll
create
Der create Befehl ermöglicht Claude, eine neue Datei mit angegebenem Inhalt zu erstellen.
Parameter:
command: Muss „create" seinpath: Der Pfad, wo die neue Datei erstellt werden sollfile_text: Der Inhalt, der in die neue Datei geschrieben werden soll
insert
Der insert Befehl ermöglicht Claude, Text an einer bestimmten Stelle in einer Datei einzufügen.
Parameter:
command: Muss „insert" seinpath: Der Pfad zur zu ändernden Dateiinsert_line: Die Zeilennummer, nach der der Text eingefügt werden soll (0 für Anfang der Datei)new_str: Der einzufügende Text
undo_edit
Der undo_edit Befehl ermöglicht Claude, die letzte an einer Datei vorgenommene Bearbeitung rückgängig zu machen.
Dieser Befehl ist nur in Claude Sonnet 3.7 (veraltet) verfügbar. Er wird in Claude 4 Modellen mit text_editor_20250728 nicht unterstützt.
Parameter:
command: Muss „undo_edit" seinpath: Der Pfad zur Datei, deren letzte Bearbeitung rückgängig gemacht werden soll
Beispiel: Beheben eines Syntaxfehlers mit dem Text-Editor-Tool
Das Text-Editor-Tool implementieren
Das Text-Editor-Tool wird als schemafreies Tool implementiert. Bei der Verwendung dieses Tools müssen Sie kein Eingabeschema wie bei anderen Tools bereitstellen; das Schema ist in das Modell integriert und kann nicht geändert werden.
Der Tool-Typ hängt von der Modellversion ab:
- Claude 4:
type: "text_editor_20250728" - Claude Sonnet 3.7:
type: "text_editor_20250124"
Initialisieren Sie Ihre Editor-Implementierung
Erstellen Sie Hilfsfunktionen zur Verarbeitung von Dateivorgängen wie Lesen, Schreiben und Ändern von Dateien. Erwägen Sie die Implementierung von Sicherungsfunktionen, um sich von Fehlern zu erholen.
Verarbeiten Sie Editor-Tool-Aufrufe
Erstellen Sie eine Funktion, die Tool-Aufrufe von Claude basierend auf dem Befehlstyp verarbeitet:
def handle_editor_tool(tool_call, model_version): input_params = tool_call.input command = input_params.get('command', '') file_path = input_params.get('path', '') if command == 'view': # Dateiinhalt lesen und zurückgeben pass elif command == 'str_replace': # Text in Datei ersetzen pass elif command == 'create': # Neue Datei erstellen pass elif command == 'insert': # Text an Stelle einfügen pass elif command == 'undo_edit': # Überprüfen Sie, ob es ein Claude 4 Modell ist if 'str_replace_based_edit_tool' in model_version: return {"error": "undo_edit command is not supported in Claude 4"} # Aus Sicherung für Claude 3.7 wiederherstellen passImplementieren Sie Sicherheitsmaßnahmen
Fügen Sie Validierungs- und Sicherheitsprüfungen hinzu:
- Validieren Sie Dateipfade, um Directory-Traversal zu verhindern
- Erstellen Sie Sicherungen vor Änderungen
- Behandeln Sie Fehler elegant
- Implementieren Sie Berechtigungsprüfungen
Verarbeiten Sie Claudes Antworten
Extrahieren und verarbeiten Sie Tool-Aufrufe aus Claudes Antworten:
# Verarbeiten Sie Tool-Use in Claudes Antwort for content in response.content: if content.type == "tool_use": # Führen Sie das Tool basierend auf dem Befehl aus result = handle_editor_tool(content) # Geben Sie das Ergebnis an Claude zurück tool_result = { "type": "tool_result", "tool_use_id": content.id, "content": result }
Bei der Implementierung des Text-Editor-Tools beachten Sie bitte:
- Sicherheit: Das Tool hat Zugriff auf Ihr lokales Dateisystem, daher implementieren Sie bitte angemessene Sicherheitsmaßnahmen.
- Sicherung: Erstellen Sie immer Sicherungen, bevor Sie Änderungen an wichtigen Dateien zulassen.
- Validierung: Validieren Sie alle Eingaben, um unbeabsichtigte Änderungen zu verhindern.
- Eindeutige Übereinstimmung: Stellen Sie sicher, dass Ersetzungen genau an einer Stelle übereinstimmen, um unbeabsichtigte Bearbeitungen zu vermeiden.
Fehler behandeln
Bei der Verwendung des Text-Editor-Tools können verschiedene Fehler auftreten. Hier ist eine Anleitung zur Fehlerbehandlung:
Befolgen Sie Best Practices für die Implementierung
Preisgestaltung und Token-Nutzung
The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you're using.
In addition to the base tokens, the following additional input tokens are needed for the text editor tool:
| Tool | Additional input tokens |
|---|---|
text_editor_20250429 (Claude 4.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Weitere detaillierte Informationen zur Tool-Preisgestaltung finden Sie unter Tool-Use-Preisgestaltung.
Integrieren Sie das Text-Editor-Tool mit anderen Tools
Das Text-Editor-Tool kann zusammen mit anderen Claude-Tools verwendet werden. Beim Kombinieren von Tools sollten Sie:
- Die Tool-Version mit dem verwendeten Modell abgleichen
- Die zusätzliche Token-Nutzung für alle in Ihrer Anfrage enthaltenen Tools berücksichtigen
Änderungsprotokoll
| Datum | Version | Änderungen |
|---|---|---|
| 28. Juli 2025 | text_editor_20250728 | Veröffentlichung eines aktualisierten Text-Editor-Tools, das einige Probleme behebt und einen optionalen max_characters Parameter hinzufügt. Es ist ansonsten identisch mit text_editor_20250429. |
| 29. April 2025 | text_editor_20250429 | Veröffentlichung des Text-Editor-Tools für Claude 4. Diese Version entfernt den undo_edit Befehl, behält aber alle anderen Funktionen. Der Tool-Name wurde aktualisiert, um seine str_replace-basierte Architektur widerzuspiegeln. |
| 13. März 2025 | text_editor_20250124 | Einführung der eigenständigen Text-Editor-Tool-Dokumentation. Diese Version ist für Claude Sonnet 3.7 optimiert, hat aber identische Funktionen wie die vorherige Version. |
| 22. Oktober 2024 | text_editor_20241022 | Erste Veröffentlichung des Text-Editor-Tools mit Claude Sonnet 3.5 (eingestellt). Bietet Funktionen zum Anzeigen, Erstellen und Bearbeiten von Dateien über die view, create, str_replace, insert und undo_edit Befehle. |
Nächste Schritte
Hier sind einige Ideen, wie Sie das Text-Editor-Tool auf bequemere und leistungsfähigere Weise verwenden können:
- Integrieren Sie mit Ihrem Entwicklungs-Workflow: Integrieren Sie das Text-Editor-Tool in Ihre Entwicklungstools oder IDE
- Erstellen Sie ein Code-Review-System: Lassen Sie Claude Ihren Code überprüfen und verbessern
- Erstellen Sie einen Debugging-Assistenten: Erstellen Sie ein System, in dem Claude Ihnen bei der Diagnose und Behebung von Problemen in Ihrem Code helfen kann
- Implementieren Sie Dateiformat-Konvertierung: Lassen Sie Claude Ihnen bei der Konvertierung von Dateien von einem Format zu einem anderen helfen
- Automatisieren Sie Dokumentation: Richten Sie Workflows ein, damit Claude Ihren Code automatisch dokumentiert
Während Sie Anwendungen mit dem Text-Editor-Tool erstellen, freuen wir uns darauf zu sehen, wie Sie Claudes Funktionen nutzen, um Ihren Entwicklungs-Workflow und Ihre Produktivität zu verbessern.