Texteditor-Tool

Claude kann ein von Anthropic definiertes Texteditor-Tool verwenden, um Textdateien anzuzeigen und zu modifizieren, was Ihnen beim Debuggen, Beheben und Verbessern Ihres Codes oder anderer Textdokumente hilft. Dies ermöglicht es Claude, direkt mit Ihren Dateien zu interagieren und praktische Unterstützung zu leisten, anstatt nur Änderungen vorzuschlagen.

​

Vor der Verwendung des Texteditor-Tools

​

Verwenden Sie ein kompatibles Modell

Anthropics Texteditor-Tool ist nur für Claude 3.5 Sonnet und Claude 3.7 Sonnet verfügbar:

• Claude 3.7 Sonnet: text_editor_20250124
• Claude 3.5 Sonnet: text_editor_20241022

Beide Versionen bieten identische Funktionen - die Version, die Sie verwenden, sollte zum verwendeten Modell passen.

​

Bewerten Sie die Eignung für Ihren Anwendungsfall

Einige Beispiele für die Verwendung des Texteditor-Tools sind:

• Code-Debugging: Lassen Sie Claude Bugs in Ihrem Code identifizieren und beheben, von Syntaxfehlern bis hin zu Logikproblemen.
• Code-Refactoring: Lassen Sie Claude die Codestruktur, Lesbarkeit und Leistung durch gezielte Bearbeitungen verbessern.
• Dokumentationserstellung: Bitten Sie Claude, Docstrings, Kommentare oder README-Dateien zu Ihrer Codebasis hinzuzufügen.
• Test-Erstellung: Lassen Sie Claude Unit-Tests für Ihren Code basierend auf seinem Verständnis der Implementierung erstellen.

​

Verwenden Sie das Texteditor-Tool

Stellen Sie das Texteditor-Tool (mit Namen str_replace_editor) Claude über die Messages API zur Verfügung:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

Das Texteditor-Tool kann auf folgende Weise verwendet werden:

​

Texteditor-Tool-Befehle

Das Texteditor-Tool unterstützt mehrere Befehle zum Anzeigen und Modifizieren von Dateien:

​

view

Der view-Befehl ermöglicht es 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” sein
• path: Der Pfad zur anzuzeigenden Datei oder zum Verzeichnis
• view_range (optional): Ein Array von zwei Ganzzahlen, die die Start- und Endzeilennummern zum Anzeigen angeben. Zeilennummern beginnen bei 1, und -1 für die Endzeile bedeutet bis zum Ende der Datei lesen. Dieser Parameter gilt nur beim Anzeigen von Dateien, nicht bei Verzeichnissen.

// Beispiel für das Anzeigen einer Datei
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "primes.py"
  }
}

// Beispiel für das Anzeigen eines Verzeichnisses
{
  "type": "tool_use",
  "id": "toolu_02B19r91rw91mr917835mr9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "src/"
  }
}

​

str_replace

Der str_replace-Befehl ermöglicht es 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” sein
• path: Der Pfad zur zu modifizierenden Datei
• old_str: Der zu ersetzende Text (muss exakt übereinstimmen, einschließlich Leerzeichen und Einrückung)
• new_str: Der neue Text, der anstelle des alten Texts eingefügt werden soll

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "str_replace",
    "path": "primes.py",
    "old_str": "for num in range(2, limit + 1)",
    "new_str": "for num in range(2, limit + 1):"
  }
}

​

create

Der create-Befehl ermöglicht es Claude, eine neue Datei mit angegebenem Inhalt zu erstellen.

Parameter:

• command: Muss “create” sein
• path: Der Pfad, an dem die neue Datei erstellt werden soll
• file_text: Der Inhalt, der in die neue Datei geschrieben werden soll

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "create",
    "path": "test_primes.py",
    "file_text": "import unittest\nimport primes\n\nclass TestPrimes(unittest.TestCase):\n    def test_is_prime(self):\n        self.assertTrue(primes.is_prime(2))\n        self.assertTrue(primes.is_prime(3))\n        self.assertFalse(primes.is_prime(4))\n\nif __name__ == '__main__':\n    unittest.main()"
  }
}

​

insert

Der insert-Befehl ermöglicht es Claude, Text an einer bestimmten Stelle in einer Datei einzufügen.

Parameter:

• command: Muss “insert” sein
• path: Der Pfad zur zu modifizierenden Datei
• insert_line: Die Zeilennummer, nach der der Text eingefügt werden soll (0 für Dateianfang)
• new_str: Der einzufügende Text

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "insert",
    "path": "primes.py",
    "insert_line": 0,
    "new_str": "\"\"\"Module for working with prime numbers.\n\nThis module provides functions to check if a number is prime\nand to generate a list of prime numbers up to a given limit.\n\"\"\"\n"
  }
}

​

undo_edit

Der undo_edit-Befehl ermöglicht es Claude, die letzte an einer Datei vorgenommene Änderung rückgängig zu machen.

Parameter:

• command: Muss “undo_edit” sein
• path: Der Pfad zur Datei, deren letzte Änderung rückgängig gemacht werden soll

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "undo_edit",
    "path": "primes.py"
  }
}

​

Beispiel: Beheben eines Syntaxfehlers mit dem Texteditor-Tool

Dieses Beispiel zeigt, wie Claude das Texteditor-Tool verwendet, um einen Syntaxfehler in einer Python-Datei zu beheben.

Zunächst stellt Ihre Anwendung Claude das Texteditor-Tool und eine Aufforderung zum Beheben eines Syntaxfehlers zur Verfügung:

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        }
    ]
)

print(response)

Claude wird das Texteditor-Tool zuerst verwenden, um die Datei anzuzeigen:

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ich helfe Ihnen, den Syntaxfehler in Ihrer primes.py-Datei zu beheben. Lassen Sie mich zunächst die Datei ansehen, um das Problem zu identifizieren."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_editor",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

Ihre Anwendung sollte dann die Datei lesen und deren Inhalt an Claude zurückgeben:

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        {
            "role": "user", 
            "content": "There's a syntax error in my primes.py file. Can you help me fix it?"
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Ich helfe Ihnen, den Syntaxfehler in Ihrer primes.py-Datei zu beheben. Lassen Sie mich zunächst die Datei ansehen, um das Problem zu identifizieren."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "name": "str_replace_editor",
                    "input": {
                        "command": "view",
                        "path": "primes.py"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
                    "content": "1: def is_prime(n):\n2:     \"\"\"Check if a number is prime.\"\"\"\n3:     if n <= 1:\n4:         return False\n5:     if n <= 3:\n6:         return True\n7:     if n % 2 == 0 or n % 3 == 0:\n8:         return False\n9:     i = 5\n10:     while i * i <= n:\n11:         if n % i == 0 or n % (i + 2) == 0:\n12:             return False\n13:         i += 6\n14:     return True\n15: \n16: def get_primes(limit):\n17:     \"\"\"Generate a list of prime numbers up to the given limit.\"\"\"\n18:     primes = []\n19:     for num in range(2, limit + 1)\n20:         if is_prime(num):\n21:             primes.append(num)\n22:     return primes\n23: \n24: def main():\n25:     \"\"\"Main function to demonstrate prime number generation.\"\"\"\n26:     limit = 100\n27:     prime_list = get_primes(limit)\n28:     print(f\"Prime numbers up to {limit}:\")\n29:     print(prime_list)\n30:     print(f\"Found {len(prime_list)} prime numbers.\")\n31: \n32: if __name__ == \"__main__\":\n33:     main()"
                }
            ]
        }
    ]
)

Claude wird den Syntaxfehler identifizieren und den str_replace-Befehl verwenden, um ihn zu beheben:

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ich habe den Syntaxfehler in Ihrer primes.py-Datei gefunden. In der `get_primes`-Funktion fehlt ein Doppelpunkt (:) am Ende der for-Schleifenzeile. Lassen Sie mich das für Sie beheben."
    },
    {
      "type": "tool_use",
      "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
      "name": "str_replace_editor",
      "input": {
        "command": "str_replace",
        "path": "primes.py",
        "old_str": "    for num in range(2, limit + 1)",
        "new_str": "    for num in range(2, limit + 1):"
      }
    }
  ]
}

Ihre Anwendung sollte dann die Bearbeitung vornehmen und das Ergebnis zurückgeben:

response = client.messages.create(
    model="claude-3-7-sonnet-20250219",
    max_tokens=1024,
    tools=[
        {
            "type": "text_editor_20250124",
            "name": "str_replace_editor"
        }
    ],
    messages=[
        # Vorherige Nachrichten...
        {
            "role": "assistant",
            "content": [
                {
                    "type": "text",
                    "text": "Ich habe den Syntaxfehler in Ihrer primes.py-Datei gefunden. In der `get_primes`-Funktion fehlt ein Doppelpunkt (:) am Ende der for-Schleifenzeile. Lassen Sie mich das für Sie beheben."
                },
                {
                    "type": "tool_use",
                    "id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "name": "str_replace_editor",
                    "input": {
                        "command": "str_replace",
                        "path": "primes.py",
                        "old_str": "    for num in range(2, limit + 1)",
                        "new_str": "    for num in range(2, limit + 1):"
                    }
                }
            ]
        },
        {
            "role": "user",
            "content": [
                {
                    "type": "tool_result",
                    "tool_use_id": "toolu_01PqRsTuVwXyZAbCdEfGh",
                    "content": "Text wurde an genau einer Stelle erfolgreich ersetzt."
                }
            ]
        }
    ]
)

Schließlich wird Claude eine vollständige Erklärung der Behebung liefern:

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ich habe den Syntaxfehler in Ihrer primes.py-Datei behoben. Das Problem lag in der `get_primes`-Funktion in Zeile 19. Es fehlte ein Doppelpunkt (:) am Ende der for-Schleifenzeile.\n\nHier ist, was ich geändert habe:\n\nVon:\n```python\nfor num in range(2, limit + 1)\n```\n\nZu:\n```python\nfor num in range(2, limit + 1):\n```\n\nIn Python ist ein Doppelpunkt am Ende von Anweisungen erforderlich, die einen neuen Codeblock beginnen, wie for-Schleifen, if-Anweisungen, Funktionsdefinitionen usw. Ohne den Doppelpunkt gibt Python einen Syntaxfehler aus, weil es nicht weiß, wo der Codeblock beginnt.\n\nIhr Code sollte jetzt korrekt ausgeführt werden. Die Funktion wird ordnungsgemäß eine Liste von Primzahlen bis zum angegebenen Limit generieren."
    }
  ]
}

​

Implementieren Sie das Texteditor-Tool

Das Texteditor-Tool wird als schema-loses Tool implementiert, das durch type: "text_editor_20250124" identifiziert wird. Bei der Verwendung dieses Tools müssen Sie kein Eingabeschema wie bei anderen Tools bereitstellen; das Schema ist in Claudes Modell eingebaut und kann nicht modifiziert werden.

def handle_editor_tool(tool_call):
    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 Position einfügen
        pass
    elif command == 'undo_edit':
        # Aus Backup wiederherstellen
        pass

# Tool-Verwendung in Claudes Antwort verarbeiten
for content in response.content:
    if content.type == "tool_use":
        # Tool basierend auf Befehl ausführen
        result = handle_editor_tool(content)
        
        # Ergebnis an Claude zurückgeben
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

​

Fehler behandeln

Bei der Verwendung des Texteditor-Tools können verschiedene Fehler auftreten. Hier sind Hinweise zur Behandlung:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Fehler: Datei nicht gefunden",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Fehler: 3 Übereinstimmungen für Ersetzungstext gefunden. Bitte geben Sie mehr Kontext an, um eine eindeutige Übereinstimmung zu erzielen.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Fehler: Keine Übereinstimmung für Ersetzung gefunden. Bitte überprüfen Sie Ihren Text und versuchen Sie es erneut.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Fehler: Zugriff verweigert. Kann nicht in Datei schreiben.",
      "is_error": true
    }
  ]
}

​

Befolgen Sie Best Practices bei der Implementierung

def backup_file(file_path):
    """Erstellt ein Backup einer Datei vor der Bearbeitung."""
    backup_path = f"{file_path}.backup"
    if os.path.exists(file_path):
        with open(file_path, 'r') as src, open(backup_path, 'w') as dst:
            dst.write(src.read())

def safe_replace(file_path, old_text, new_text):
    """Ersetzt Text nur, wenn es genau eine Übereinstimmung gibt."""
    with open(file_path, 'r') as f:
        content = f.read()
    
    count = content.count(old_text)
    if count == 0:
        return "Fehler: Keine Übereinstimmung gefunden"
    elif count > 1:
        return f"Fehler: {count} Übereinstimmungen gefunden"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "Text erfolgreich ersetzt"

def verify_changes(file_path):
    """Führt Tests oder Überprüfungen nach Änderungen durch."""
    try:
        # Für Python-Dateien, prüfe auf Syntaxfehler
        if file_path.endswith('.py'):
            import ast
            with open(file_path, 'r') as f:
                ast.parse(f.read())
            return "Syntaxprüfung bestanden"
    except Exception as e:
        return f"Überprüfung fehlgeschlagen: {str(e)}"

​

Preise und Token-Nutzung

Das Texteditor-Tool verwendet die gleiche Preisstruktur wie andere Tools, die mit Claude verwendet werden. Es folgt der Standard-Eingabe- und Ausgabe-Token-Preisgestaltung basierend auf dem Claude-Modell, das Sie verwenden.

Zusätzlich zu den Basis-Tokens werden die folgenden zusätzlichen Eingabe-Tokens für das Texteditor-Tool benötigt:

Für detailliertere Informationen über Tool-Preise, siehe Tool-Nutzungspreise.

​

Integrieren Sie das Texteditor-Tool mit der Computer-Nutzung

Das Texteditor-Tool kann zusammen mit dem Computer-Nutzungs-Tool und anderen von Anthropic definierten Tools verwendet werden. Bei der Kombination dieser Tools müssen Sie:

1. Den entsprechenden Beta-Header einschließen (wenn Sie es mit der Computer-Nutzung verwenden)
2. Die Tool-Version mit dem von Ihnen verwendeten Modell abstimmen
3. Die zusätzliche Token-Nutzung für alle in Ihrer Anfrage enthaltenen Tools berücksichtigen

Für weitere Informationen über die Verwendung des Texteditor-Tools im Kontext der Computer-Nutzung, siehe die Computer-Nutzung.

​

Änderungsprotokoll

​

Nächste Schritte

Hier sind einige Ideen, wie Sie das Texteditor-Tool auf bequemere und leistungsfähigere Weise nutzen können:

• Integration in Ihren Entwicklungsworkflow: Bauen Sie das Texteditor-Tool in Ihre Entwicklungswerkzeuge oder IDE ein
• Erstellen Sie ein Code-Review-System: Lassen Sie Claude Ihren Code überprüfen und verbessern
• Bauen Sie einen Debugging-Assistenten: Erstellen Sie ein System, bei dem Claude Ihnen hilft, Probleme in Ihrem Code zu diagnostizieren und zu beheben
• Implementieren Sie Dateiformat-Konvertierung: Lassen Sie Claude Ihnen helfen, Dateien von einem Format in ein anderes zu konvertieren
• Automatisieren Sie die Dokumentation: Richten Sie Workflows ein, damit Claude Ihren Code automatisch dokumentiert

Während Sie Anwendungen mit dem Texteditor-Tool erstellen, sind wir gespannt darauf zu sehen, wie Sie Claudes Fähigkeiten nutzen, um Ihren Entwicklungsworkflow und Ihre Produktivität zu verbessern.