L'outil d'édition de texte intégré

Claude dispose d’un outil intégré (built-in) que vous n’avez pas besoin de créer de zéro : l’outil d’édition de texte. Il permet à Claude de manipuler des fichiers et des répertoires comme dans un éditeur de texte classique.

Ce que l’outil peut faire

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

• Lire le contenu d’un fichier ou d’un répertoire
• Lire une plage de lignes spécifique dans un fichier
• Remplacer du texte dans un fichier
• Créer de nouveaux fichiers
• Insérer du texte à une ligne spécifique
• Annuler les modifications récentes

Cela donne à Claude la capacité d’agir comme un développeur, directement depuis l’API.

Un point important : l’implémentation reste à votre charge

C’est la partie qui peut prêter à confusion : bien que le schéma de l’outil soit intégré dans Claude, vous devez quand même fournir l’implémentation concrète. Autrement dit :

• Claude sait comment demander des opérations sur les fichiers (le schéma est dans ses connaissances)
• Mais vous devez écrire le code qui exécute réellement ces opérations

Pour les outils classiques, vous écrivez à la fois le schéma JSON et la fonction. Ici, Claude fournit la connaissance du schéma, mais les fonctions de création, lecture, remplacement, etc. doivent être implémentées de votre côté.

Versions du schéma

Bien que le schéma principal soit intégré, vous devez inclure un petit schéma stub dans vos requêtes. La version exacte dépend du modèle Claude utilisé :

def get_text_edit_schema(model):
    if model.startswith("claude-sonnet-5"):
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }
    elif model.startswith("claude-3-7-sonnet"):
        return {
            "type": "text_editor_20250124",
            "name": "str_replace_editor",
        }

Note : Les versions exactes des schémas pour tous les modèles sont disponibles dans la documentation officielle.

Claude voit ce petit schéma et le développe automatiquement en interne pour obtenir la spécification complète de l’outil.

Exemple pratique

Quand vous demandez à Claude de travailler avec des fichiers, il utilise l’outil pour lire, modifier et créer des fichiers selon les besoins.

Exemple 1 — Lire et résumer :

“Ouvre le fichier ./main.py et résume son contenu.”

Claude va :

1. Utiliser l’outil pour lire le fichier
2. Analyser le contenu
3. Fournir un résumé

Exemple 2 — Modifier et créer :

“Ouvre ./main.py et écris une fonction pour calculer pi à 5 décimales. Puis crée un fichier ./test.py avec des tests unitaires.”

Claude va :

1. Lire le fichier main.py existant
2. Remplacer son contenu avec la nouvelle implémentation
3. Créer un nouveau fichier test.py avec les tests

Pourquoi utiliser cet outil ?

On pourrait se demander l’intérêt quand les éditeurs de code modernes ont déjà des assistants IA intégrés. L’outil d’édition de texte devient précieux quand :

• Vous construisez des applications qui doivent modifier des fichiers par programme
• Vous travaillez dans des environnements sans éditeur complet (serveur, CI/CD…)
• Vous voulez intégrer des capacités d’édition directement dans vos applications Claude

En résumé, cet outil permet de reproduire les fonctionnalités d’un éditeur de code IA directement dans vos propres applications, avec un contrôle fin sur la façon dont Claude interagit avec votre système de fichiers.