Claude Academy
Chargement

L'outil d'édition de texte

Leçon 325 min

Remarque importante : les chaînes de version de l'outil, pour toutes les versions de modèle, se trouvent ici : https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Claude est fourni avec un outil intégré que vous n'avez pas besoin de créer de toutes pièces : l'outil d'édition de texte. Cet outil donne à Claude la capacité de travailler avec des fichiers et des répertoires, tout comme vous le feriez avec un éditeur de texte standard.

Ce que l'outil d'édition de texte peut faire

L'outil d'édition de texte fournit à Claude un ensemble complet de capacités de manipulation de fichiers :

  • Afficher le contenu d'un fichier ou d'un répertoire
  • Afficher des plages spécifiques de lignes dans un fichier
  • Remplacer du texte dans un fichier
  • Créer de nouveaux fichiers
  • Insérer du texte à des lignes spécifiques dans un fichier

L'outil d'édition de texte est intégré à Claude, mais uniquement son schéma, vous devez donc fournir l'implémentation de l'outil en lui-même.

Cela élargit considérablement les capacités de Claude et lui donne essentiellement le pouvoir d'agir comme un ingénieur logiciel dès le départ.

Comprendre les exigences d'implémentation

Voici où les choses deviennent un peu confuses : bien que le schéma de l'outil soit intégré à Claude, vous devez tout de même fournir l'implémentation en elle-même. Pensez-y de cette façon : Claude sait comment demander des opérations sur des fichiers, mais vous devez écrire le code qui effectue réellement ces opérations.

Le schéma JSON text_editor_tool_schema et une boîte « Fonction » affichant trois points d'interrogation, la fonction que vous devez écrire.

Lorsque vous utilisez des outils personnalisés, vous écrivez généralement à la fois le schéma JSON et l'implémentation de la fonction. Avec l'outil d'édition de texte, Claude fournit la connaissance du schéma, mais vous devez écrire des fonctions pour gérer les demandes de Claude concernant la création de fichiers, la lecture de répertoires, le remplacement de texte, et ainsi de suite.

Versions de schéma

Vous devez tout de même inclure un petit stub de schéma lorsque vous utilisez l'outil d'édition de texte, et le schéma exact dépend du modèle Claude que vous utilisez :

python
def get_text_edit_schema(model):
    if model.startswith("claude-haiku-4-5"):
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }

Claude développe le petit stub de schéma en un schéma beaucoup plus long avec « command », « path », view_range, old_str, new_str et file_text.

Claude développe automatiquement ce petit schéma en une spécification beaucoup plus grande et détaillée qui inclut tous les paramètres et opérations disponibles.

Exemple pratique

Voyons l'outil d'édition de texte en action. Lorsque vous demandez à Claude de travailler avec des fichiers, il utilisera l'outil pour lire, modifier et créer des fichiers selon les besoins.

Par exemple, si vous demandez à Claude d' « Ouvrir le fichier ./main.py et résumer son contenu », Claude va :

  1. Utiliser l'outil d'édition de texte pour afficher le fichier
  2. Lire le contenu
  3. Vous fournir un résumé

Vous pouvez aller plus loin et demander à Claude de modifier des fichiers. Par exemple : « Ouvre le fichier ./main.py et écris une fonction pour calculer pi jusqu'à la 5e décimale. Puis crée un fichier ./test.py pour tester ton implémentation. »

Claude va :

  1. Afficher le fichier main.py existant
  2. Remplacer son contenu par une nouvelle implémentation incluant la fonction de calcul de pi
  3. Créer un nouveau fichier test.py avec des tests unitaires appropriés

Pourquoi utiliser l'outil d'édition de texte ?

Vous vous demandez peut-être pourquoi cet outil existe alors que les éditeurs de code modernes disposent déjà d'assistants IA intégrés. L'outil d'édition de texte devient précieux dans les scénarios où :

  • Vous développez des applications qui doivent modifier des fichiers de manière programmatique
  • Vous travaillez dans des environnements sans accès à des éditeurs de code complets
  • Vous souhaitez intégrer des capacités d'édition de fichiers directement dans vos applications propulsées par Claude

Essentiellement, l'outil d'édition de texte vous permet de reproduire une grande partie des fonctionnalités d'un éditeur de code sophistiqué alimenté par l'IA au sein de vos propres applications, en donnant à Claude la capacité d'être un véritable assistant de codage capable de lire, écrire et modifier des fichiers sur votre système de fichiers.