L'outil Text Editor

Tous nos outils jusqu’ici étaient définis par nous, schéma compris. Anthropic propose aussi une famille d’outils définis côté modèle, dont le text editor tool : un outil de manipulation de fichiers dont Claude connaît déjà la spécification complète, parce qu’il a été spécifiquement entraîné à s’en servir. Pour vous, cela change l’équation : plus de schéma à rédiger ni de descriptions à peaufiner — mais l’implémentation, elle, reste entièrement à votre charge.

Capacités

L’outil couvre le cycle complet de manipulation de fichiers :

• Voir le contenu d’un fichier ou répertoire
• Voir des plages de lignes spécifiques
• Remplacer du texte dans un fichier
• Créer de nouveaux fichiers
• Insérer du texte à des lignes spécifiques
• Annuler les modifications récentes (versions historiques de l’outil uniquement)

La lecture par plages de lignes n’est pas un gadget : sur un gros fichier, elle permet à Claude de ne charger que la zone utile au lieu de saturer son contexte. Quant au remplacement de texte, il fonctionne par recherche de chaîne exacte — le même mécanisme qu’utilisent les agents de code comme Claude Code pour éditer vos fichiers.

Point important

Le schéma de l’outil est connu de Claude, mais vous devez fournir l’implémentation. Claude sait formuler des demandes — « montre-moi ce fichier », « remplace cette chaîne » — mais c’est votre code qui les exécute réellement, et cette répartition est aussi une responsabilité de sécurité : c’est à votre implémentation de décider quels chemins sont accessibles, d’interdire l’évasion hors du répertoire de travail et de valider les opérations avant de toucher au disque. Le modèle propose, votre code dispose.

Versions du schéma

L’outil a évolué avec les générations de modèles, et chaque génération attend sa version : un type daté et un nom d’outil précis, à sélectionner selon le modèle 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",
        }

Notez le changement de nom entre générations : les modèles récents utilisent str_replace_based_edit_tool, les anciens Sonnet 3.x utilisaient str_replace_editor — et la commande d’annulation (undo_edit) a disparu des versions récentes, qui se limitent à voir, créer, remplacer et insérer. Le tableau de correspondance modèle ↔ version figure dans la documentation Anthropic ; vérifiez-le à chaque montée de version de modèle, car un type inadapté est rejeté par l’API. Une fois le bon type envoyé, Claude expanse automatiquement ce petit schéma en spécification détaillée — c’est tout l’intérêt d’un outil défini côté modèle.

Cas d’usage

Le text editor tool trouve sa place dès qu’une application doit modifier des fichiers sous la conduite du modèle : outils internes qui corrigent des fichiers de configuration, environnements pédagogiques ou bacs à sable dépourvus d’éditeur complet, ou intégration de capacités d’édition directement dans vos applications Claude — relecture et correction de code, refactorisations guidées, mise à jour de documentation. Dans tous ces scénarios, le couple « spécification côté modèle + implémentation côté vous » donne le meilleur des deux mondes : des demandes d’édition fiables, exécutées dans le périmètre exact que votre code autorise.

Points clés à retenir

• Le text editor tool est défini côté modèle : aucun schéma à rédiger, Claude en connaît déjà la spécification
• Vous fournissez l’implémentation — et donc les garde-fous : chemins autorisés, validation, périmètre d’écriture
• Capacités : lecture (fichier, répertoire, plages de lignes), création, remplacement, insertion
• La version du schéma dépend du modèle : text_editor_20250728 / str_replace_based_edit_tool pour les modèles récents, versions datées antérieures pour les anciens Sonnet
• undo_edit n’existe plus dans les versions récentes de l’outil — prévoyez vos propres sauvegardes si nécessaire