Chargement

L'outil d'édition de texte

Leçon 325 min

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

Chargement

Claude est livré 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 offre à 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 d'un fichier

L'outil d'édition de texte est intégré à Claude, mais seulement son schéma, vous devez donc fournir l'implémentation de l'outil réel.

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 déroutantes : bien que le schéma de l'outil soit intégré à Claude, vous devez tout de même fournir l'implémentation réelle. Pensez-y ainsi : 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 « Function » 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 traiter les demandes de Claude visant à créer des fichiers, lire des répertoires, remplacer du texte, et ainsi de suite.

Versions de schéma

Vous devez tout de même inclure un petit extrait 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 extrait de schéma en un schéma beaucoup plus long qui inclut « 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 vaste 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 de 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. Crée ensuite 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 créez 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 voulez intégrer des capacités d'édition de fichiers directement dans vos applications alimenté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, donnant à Claude la capacité d'être un véritable assistant de codage capable de lire, d'écrire et de modifier des fichiers sur votre système de fichiers.