Claude kann ein von Anthropic definiertes Text-Editor-Tool verwenden, um Textdateien anzuzeigen und zu ändern, was dir beim Debuggen, Beheben und Verbessern deines Codes oder anderer Textdokumente hilft. Dies ermöglicht Claude, direkt mit deinen Dateien zu interagieren und praktische Unterstützung zu bieten, anstatt nur Änderungen vorzuschlagen.
| 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 du diese Funktionalität benötigst, musst du Claude Sonnet 3.7 (veraltet) verwenden.
Ältere Tool-Versionen sind nicht garantiert rückwärtskompatibel mit neueren Modellen. Verwende immer die Tool-Version, die deiner Modellversion entspricht.
Einige Beispiele für die Verwendung des Text-Editor-Tools sind:
Das Text-Editor-Tool kann auf folgende Weise verwendet werden:
Das Text-Editor-Tool unterstützt mehrere Befehle zum Anzeigen und Ändern von Dateien:
Der view Befehl ermöglicht Claude, den Inhalt einer Datei zu untersuchen oder die Inhalte 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.Der str_replace Befehl ermöglicht Claude, eine bestimmte Zeichenkette in einer Datei durch eine neue Zeichenkette zu ersetzen. Dies wird für präzise Änderungen 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 sollDer 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 sollDer 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 TextDer 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 dem text_editor_20250728 nicht unterstützt.
Parameter:
command: Muss „undo_edit" seinpath: Der Pfad zur Datei, deren letzte Bearbeitung rückgängig gemacht werden sollDas Text-Editor-Tool wird als schemalooses Tool implementiert. Bei der Verwendung dieses Tools müssen Sie kein Eingabeschema wie bei anderen Tools bereitstellen; das Schema ist in Claudes Modell integriert und kann nicht geändert werden.
Der Tool-Typ hängt von der Modellversion ab:
type: "text_editor_20250728"type: "text_editor_20250124"Beachten Sie bei der Implementierung des Text-Editor-Tools Folgendes:
Bei der Verwendung des Text-Editor-Tools können verschiedene Fehler auftreten. Hier finden Sie Anleitungen zur Fehlerbehandlung:
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-Nutzungspreisgestaltung.
Das Text-Editor-Tool kann zusammen mit anderen Claude-Tools verwendet werden. Beim Kombinieren von Tools sollten Sie Folgendes sicherstellen:
| 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 bei. 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 (). Bietet Funktionen zum Anzeigen, Erstellen und Bearbeiten von Dateien über die Befehle , , , und . |
Hier sind einige Ideen, wie Sie das Text-Editor-Tool auf bequemere und leistungsfähigere Weise nutzen können:
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.
Stelle Claude das Text-Editor-Tool und eine Benutzereingabe zur Verfügung
Claude verwendet das Tool, um Dateien oder Verzeichnisse zu untersuchen
view Befehl, um Dateiinhalte zu untersuchen oder Verzeichnisinhalte aufzulistentool_use Inhaltsblock mit dem view BefehlFühre den view-Befehl aus und gib die Ergebnisse zurück
max_characters Parameter in der Tool-Konfiguration angegeben wurde, kürze den Dateiinhalt auf diese Längeuser Nachricht fortsetzt, die einen tool_result Inhaltsblock enthältClaude verwendet das Tool, um Dateien zu ändern
str_replace verwenden, um Änderungen vorzunehmen, oder insert, um Text an einer bestimmten Zeilennummer hinzuzufügenstr_replace Befehl verwendet, erstellt Claude eine ordnungsgemäß formatierte Tool-Use-Anfrage mit dem alten Text und dem neuen Text, um ihn zu ersetzenFühre die Bearbeitung aus und gib die Ergebnisse zurück
Claude bietet seine Analyse und Erklärung
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 einer Sicherungsfunktion, 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':
# Read and return file contents
pass
elif command == 'str_replace':
# Replace text in file
pass
elif command == 'create':
# Create new file
pass
elif command == 'insert':
# Insert text at location
pass
elif command == 'undo_edit':
# Check if it's a Claude 4 model
if 'str_replace_based_edit_tool' in model_version:
return {"error": "undo_edit command is not supported in Claude 4"}
# Restore from backup for Claude 3.7
passImplementieren Sie Sicherheitsmaßnahmen
Fügen Sie Validierungs- und Sicherheitsprüfungen hinzu:
Verarbeiten Sie Claudes Antworten
Extrahieren und verarbeiten Sie Tool-Aufrufe aus Claudes Antworten:
# Process tool use in Claude's response
for content in response.content:
if content.type == "tool_use":
# Execute the tool based on command
result = handle_editor_tool(content)
# Return result to Claude
tool_result = {
"type": "tool_result",
"tool_use_id": content.id,
"content": result
}viewcreatestr_replaceinsertundo_editFühren Sie Shell-Befehle mit Claude aus.