Outil d'éditeur de texte

Claude peut utiliser un outil d’éditeur de texte défini par Anthropic pour visualiser et modifier des fichiers texte, vous aidant à déboguer, corriger et améliorer votre code ou d’autres documents texte. Cela permet à Claude d’interagir directement avec vos fichiers, fournissant une assistance pratique plutôt que de simplement suggérer des modifications.

​

Avant d’utiliser l’outil d’éditeur de texte

​

Utiliser un modèle compatible

L’outil d’éditeur de texte d’Anthropic n’est disponible que pour Claude 3.5 Sonnet et Claude 3.7 Sonnet :

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

Les deux versions offrent des capacités identiques - la version que vous utilisez doit correspondre au modèle avec lequel vous travaillez.

​

Évaluer l’adéquation de votre cas d’utilisation

Voici quelques exemples de cas où utiliser l’outil d’éditeur de texte :

• Débogage de code : Faites identifier et corriger les bugs dans votre code par Claude, des erreurs de syntaxe aux problèmes de logique.
• Refactorisation de code : Laissez Claude améliorer la structure, la lisibilité et les performances de votre code grâce à des modifications ciblées.
• Génération de documentation : Demandez à Claude d’ajouter des docstrings, des commentaires ou des fichiers README à votre base de code.
• Création de tests : Faites créer des tests unitaires par Claude pour votre code en fonction de sa compréhension de l’implémentation.

​

Utiliser l’outil d’éditeur de texte

Fournissez l’outil d’éditeur de texte (nommé str_replace_editor) à Claude en utilisant l’API Messages :

L’outil d’éditeur de texte peut être utilisé de la manière suivante :

​

Commandes de l’outil d’éditeur de texte

L’outil d’éditeur de texte prend en charge plusieurs commandes pour visualiser et modifier les fichiers :

​

view

La commande view permet à Claude d’examiner le contenu d’un fichier ou de lister le contenu d’un répertoire. Elle peut lire le fichier entier ou une plage spécifique de lignes.

Paramètres :

• command : Doit être “view”
• path : Le chemin vers le fichier ou le répertoire à visualiser
• view_range (optionnel) : Un tableau de deux entiers spécifiant les numéros de ligne de début et de fin à visualiser. Les numéros de ligne commencent à 1, et -1 pour la ligne de fin signifie lire jusqu’à la fin du fichier. Ce paramètre s’applique uniquement lors de la visualisation de fichiers, pas de répertoires.

// Exemple pour visualiser un fichier
{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "primes.py"
  }
}

// Exemple pour visualiser un répertoire
{
  "type": "tool_use",
  "id": "toolu_02B19r91rw91mr917835mr9",
  "name": "str_replace_editor",
  "input": {
    "command": "view",
    "path": "src/"
  }
}

​

str_replace

La commande str_replace permet à Claude de remplacer une chaîne spécifique dans un fichier par une nouvelle chaîne. Elle est utilisée pour faire des modifications précises.

Paramètres :

• command : Doit être “str_replace”
• path : Le chemin vers le fichier à modifier
• old_str : Le texte à remplacer (doit correspondre exactement, y compris les espaces et l’indentation)
• new_str : Le nouveau texte à insérer à la place de l’ancien texte

{
  "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

La commande create permet à Claude de créer un nouveau fichier avec un contenu spécifié.

Paramètres :

• command : Doit être “create”
• path : Le chemin où le nouveau fichier doit être créé
• file_text : Le contenu à écrire dans le nouveau fichier

{
  "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

La commande insert permet à Claude d’insérer du texte à un emplacement spécifique dans un fichier.

Paramètres :

• command : Doit être “insert”
• path : Le chemin vers le fichier à modifier
• insert_line : Le numéro de ligne après lequel insérer le texte (0 pour le début du fichier)
• new_str : Le texte à insérer

{
  "type": "tool_use",
  "id": "toolu_01A09q90qw90lq917835lq9",
  "name": "str_replace_editor",
  "input": {
    "command": "insert",
    "path": "primes.py",
    "insert_line": 0,
    "new_str": "\"\"\"Module pour travailler avec les nombres premiers.\n\nCe module fournit des fonctions pour vérifier si un nombre est premier\net pour générer une liste de nombres premiers jusqu'à une limite donnée.\n\"\"\"\n"
  }
}

​

undo_edit

La commande undo_edit permet à Claude d’annuler la dernière modification apportée à un fichier.

Paramètres :

• command : Doit être “undo_edit”
• path : Le chemin vers le fichier dont la dernière modification doit être annulée

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

​

Exemple : Correction d’une erreur de syntaxe avec l’outil d’éditeur de texte

Cet exemple montre comment Claude utilise l’outil d’éditeur de texte pour corriger une erreur de syntaxe dans un fichier Python.

Tout d’abord, votre application fournit à Claude l’outil d’éditeur de texte et une invite pour corriger une erreur de syntaxe :

Claude utilisera d’abord l’outil d’éditeur de texte pour visualiser le fichier :

{
  "id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Je vais vous aider à corriger l'erreur de syntaxe dans votre fichier primes.py. Laissez-moi d'abord examiner le fichier pour identifier le problème."
    },
    {
      "type": "tool_use",
      "id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
      "name": "str_replace_editor",
      "input": {
        "command": "view",
        "path": "primes.py"
      }
    }
  ]
}

Votre application doit alors lire le fichier et retourner son contenu à Claude :

Claude identifiera l’erreur de syntaxe et utilisera la commande str_replace pour la corriger :

{
  "id": "msg_01VwXyZAbCdEfGhIjKlMnO",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "tool_use",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "J'ai trouvé l'erreur de syntaxe dans votre fichier primes.py. Dans la fonction `get_primes`, il manque un deux-points (:) à la fin de la ligne de la boucle for. Je vais corriger cela pour vous."
    },
    {
      "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):"
      }
    }
  ]
}

Votre application doit alors effectuer la modification et retourner le résultat :

Enfin, Claude fournira une explication complète de la correction :

{
  "id": "msg_01IjKlMnOpQrStUvWxYzAb",
  "model": "claude-3-7-sonnet-20250219",
  "stop_reason": "end_turn",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "J'ai corrigé l'erreur de syntaxe dans votre fichier primes.py. Le problème se trouvait dans la fonction `get_primes` à la ligne 19. Il manquait un deux-points (:) à la fin de la ligne de la boucle for.\n\nVoici ce que j'ai modifié :\n\nDe :\n```python\nfor num in range(2, limit + 1)\n```\n\nÀ :\n```python\nfor num in range(2, limit + 1):\n```\n\nEn Python, un deux-points est requis à la fin des instructions qui commencent un nouveau bloc de code, comme les boucles for, les instructions if, les définitions de fonctions, etc. Sans le deux-points, Python génère une erreur de syntaxe car il ne sait pas où commence le bloc de code.\n\nVotre code devrait maintenant s'exécuter correctement. La fonction générera correctement une liste de nombres premiers jusqu'à la limite spécifiée."
    }
  ]
}

​

Implémenter l’outil d’éditeur de texte

L’outil d’éditeur de texte est implémenté comme un outil sans schéma, identifié par type: "text_editor_20250124". Lors de l’utilisation de cet outil, vous n’avez pas besoin de fournir un schéma d’entrée comme avec d’autres outils ; le schéma est intégré au modèle de Claude et ne peut pas être modifié.

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':
        # Lire et retourner le contenu du fichier
        pass
    elif command == 'str_replace':
        # Remplacer le texte dans le fichier
        pass
    elif command == 'create':
        # Créer un nouveau fichier
        pass
    elif command == 'insert':
        # Insérer du texte à un emplacement
        pass
    elif command == 'undo_edit':
        # Restaurer depuis la sauvegarde
        pass

# Traiter l'utilisation d'outil dans la réponse de Claude
for content in response.content:
    if content.type == "tool_use":
        # Exécuter l'outil en fonction de la commande
        result = handle_editor_tool(content)
        
        # Retourner le résultat à Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

​

Gérer les erreurs

Lors de l’utilisation de l’outil d’éditeur de texte, diverses erreurs peuvent survenir. Voici des conseils sur la façon de les gérer :

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Erreur : Fichier non trouvé",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Erreur : 3 correspondances trouvées pour le texte de remplacement. Veuillez fournir plus de contexte pour obtenir une correspondance unique.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Erreur : Aucune correspondance trouvée pour le remplacement. Veuillez vérifier votre texte et réessayer.",
      "is_error": true
    }
  ]
}

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "content": "Erreur : Permission refusée. Impossible d'écrire dans le fichier.",
      "is_error": true
    }
  ]
}

​

Suivre les meilleures pratiques d’implémentation

def backup_file(file_path):
    """Créer une sauvegarde d'un fichier avant l'édition."""
    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):
    """Remplacer le texte uniquement s'il y a exactement une correspondance."""
    with open(file_path, 'r') as f:
        content = f.read()
    
    count = content.count(old_text)
    if count == 0:
        return "Erreur : Aucune correspondance trouvée"
    elif count > 1:
        return f"Erreur : {count} correspondances trouvées"
    else:
        new_content = content.replace(old_text, new_text)
        with open(file_path, 'w') as f:
            f.write(new_content)
        return "Texte remplacé avec succès"

def verify_changes(file_path):
    """Exécuter des tests ou des vérifications après avoir apporté des modifications."""
    try:
        # Pour les fichiers Python, vérifier les erreurs de syntaxe
        if file_path.endswith('.py'):
            import ast
            with open(file_path, 'r') as f:
                ast.parse(f.read())
            return "Vérification de la syntaxe réussie"
    except Exception as e:
        return f"Échec de la vérification : {str(e)}"

​

Tarification et utilisation des tokens

L’outil d’éditeur de texte utilise la même structure de tarification que les autres outils utilisés avec Claude. Il suit la tarification standard des tokens d’entrée et de sortie basée sur le modèle Claude que vous utilisez.

En plus des tokens de base, les tokens d’entrée supplémentaires suivants sont nécessaires pour l’outil d’éditeur de texte :

Pour des informations plus détaillées sur la tarification des outils, voir Tarification de l’utilisation des outils.

​

Intégrer l’outil d’éditeur de texte avec l’utilisation de l’ordinateur

L’outil d’éditeur de texte peut être utilisé aux côtés de l’outil d’utilisation de l’ordinateur et d’autres outils définis par Anthropic. Lors de la combinaison de ces outils, vous devrez :

1. Inclure l’en-tête bêta approprié (si utilisé avec l’utilisation de l’ordinateur)
2. Faire correspondre la version de l’outil avec le modèle que vous utilisez
3. Tenir compte de l’utilisation supplémentaire de tokens pour tous les outils inclus dans votre requête

Pour plus d’informations sur l’utilisation de l’outil d’éditeur de texte dans un contexte d’utilisation de l’ordinateur, voir Utilisation de l’ordinateur.

​

Journal des modifications

​

Prochaines étapes

Voici quelques idées sur la façon d’utiliser l’outil d’éditeur de texte de manière plus pratique et puissante :

• Intégrer à votre flux de travail de développement : Intégrez l’outil d’éditeur de texte dans vos outils de développement ou IDE
• Créer un système de revue de code : Faites examiner et améliorer votre code par Claude
• Construire un assistant de débogage : Créez un système où Claude peut vous aider à diagnostiquer et corriger des problèmes dans votre code
• Implémenter la conversion de format de fichier : Laissez Claude vous aider à convertir des fichiers d’un format à un autre
• Automatiser la documentation : Mettez en place des flux de travail pour que Claude documente automatiquement votre code

Alors que vous construisez des applications avec l’outil d’éditeur de texte, nous sommes impatients de voir comment vous exploitez les capacités de Claude pour améliorer votre flux de travail et votre productivité.