Compatibilité des modèles
| Modèle | Version de l’outil |
|---|---|
| Modèles Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (déprécié) | text_editor_20250124 |
text_editor_20250728 pour les modèles Claude 4 n’inclut pas la commande undo_edit. Si vous avez besoin de cette fonctionnalité, vous devrez utiliser Claude Sonnet 3.7 (déprécié).Quand utiliser l’outil d’éditeur de texte
Voici quelques exemples de quand utiliser l’outil d’éditeur de texte :- Débogage de code : Demandez à Claude d’identifier et de corriger les bogues dans votre code, 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 : Demandez à Claude de créer des tests unitaires pour votre code en fonction de sa compréhension de l’implémentation.
Utiliser l’outil d’éditeur de texte
str_replace_based_edit_tool) à Claude en utilisant l’API Messages.Vous pouvez éventuellement spécifier un paramètre max_characters pour contrôler la troncature lors de la visualisation de fichiers volumineux.max_characters est uniquement compatible avec text_editor_20250728 et les versions ultérieures de l’outil d’éditeur de texte.Fournir à Claude l'outil d'éditeur de texte et une invite utilisateur
- Incluez l’outil d’éditeur de texte dans votre demande d’API
- Fournissez une invite utilisateur qui peut nécessiter d’examiner ou de modifier des fichiers, comme « Pouvez-vous corriger l’erreur de syntaxe dans mon code ? »
Claude utilise l'outil pour examiner les fichiers ou répertoires
- Claude évalue ce qu’il doit examiner et utilise la commande
viewpour examiner le contenu des fichiers ou lister le contenu des répertoires - La réponse de l’API contiendra un bloc de contenu
tool_useavec la commandeview
Exécuter la commande view et retourner les résultats
- Extrayez le chemin du fichier ou du répertoire de la demande d’utilisation d’outil de Claude
- Lisez le contenu du fichier ou listez le contenu du répertoire
- Si un paramètre
max_charactersa été spécifié dans la configuration de l’outil, tronquez le contenu du fichier à cette longueur - Retournez les résultats à Claude en continuant la conversation avec un nouveau message
usercontenant un bloc de contenutool_result
Claude utilise l'outil pour modifier les fichiers
- Après avoir examiné le fichier ou le répertoire, Claude peut utiliser une commande telle que
str_replacepour apporter des modifications ouinsertpour ajouter du texte à un numéro de ligne spécifique. - Si Claude utilise la commande
str_replace, Claude construit une demande d’utilisation d’outil correctement formatée avec l’ancien texte et le nouveau texte pour le remplacer
Exécuter la modification et retourner les résultats
- Extrayez le chemin du fichier, l’ancien texte et le nouveau texte de la demande d’utilisation d’outil de Claude
- Effectuez le remplacement de texte dans le fichier
- Retournez les résultats à Claude
Claude fournit son analyse et son explication
- Après avoir examiné et possiblement modifié les fichiers, Claude fournit une explication complète de ce qu’il a trouvé et des modifications qu’il a apportées
Commandes de l’outil d’éditeur de texte
L’outil d’éditeur de texte prend en charge plusieurs commandes pour afficher et modifier des fichiers :view
La commandeview permet à Claude d’examiner le contenu d’un fichier ou de lister le contenu d’un répertoire. Elle peut lire l’intégralité du fichier ou une plage de lignes spécifique.
Paramètres :
command: Doit être « view »path: Le chemin du fichier ou du répertoire à afficherview_range(optionnel) : Un tableau de deux entiers spécifiant les numéros de ligne de début et de fin à afficher. Les numéros de ligne sont indexés à partir de 1, et -1 pour la ligne de fin signifie lire jusqu’à la fin du fichier. Ce paramètre s’applique uniquement lors de l’affichage de fichiers, pas de répertoires.
Exemples de commandes view
Exemples de commandes view
str_replace
La commandestr_replace permet à Claude de remplacer une chaîne spécifique dans un fichier par une nouvelle chaîne. Ceci est utilisé pour effectuer des modifications précises.
Paramètres :
command: Doit être « str_replace »path: Le chemin du fichier à modifierold_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
Exemple de commande str_replace
Exemple de commande str_replace
create
La commandecreate permet à Claude de créer un nouveau fichier avec le 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
Exemple de commande create
Exemple de commande create
insert
La commandeinsert permet à Claude d’insérer du texte à un emplacement spécifique dans un fichier.
Paramètres :
command: Doit être « insert »path: Le chemin du fichier à modifierinsert_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
Exemple de commande insert
Exemple de commande insert
undo_edit
La commandeundo_edit permet à Claude d’annuler la dernière modification apportée à un fichier.
text_editor_20250728.command: Doit être « undo_edit »path: Le chemin du fichier dont la dernière modification doit être annulée
Exemple de commande undo_edit
Exemple de commande undo_edit
Exemple : Corriger une erreur de syntaxe avec l’outil d’éditeur de texte
view inclut le contenu du fichier avec les numéros de ligne ajoutés au début de chaque ligne (par exemple, « 1: def is_prime(n): »). Les numéros de ligne ne sont pas obligatoires, mais ils sont essentiels pour utiliser avec succès le paramètre view_range pour examiner des sections spécifiques de fichiers et le paramètre insert_line pour ajouter du contenu à des emplacements précis.str_replace pour la corriger :Implémenter l’outil d’éditeur de texte
L’outil d’éditeur de texte est implémenté en tant qu’outil sans schéma. 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 et ne peut pas être modifié. Le type d’outil dépend de la version du modèle :- Claude 4 :
type: "text_editor_20250728" - Claude Sonnet 3.7 :
type: "text_editor_20250124"
Initialiser votre implémentation d'éditeur
Gérer les appels d'outils d'éditeur
Implémenter les mesures de sécurité
- Validez les chemins de fichiers pour prévenir la traversée de répertoires
- Créez des sauvegardes avant d’apporter des modifications
- Gérez les erreurs correctement
- Implémentez des vérifications de permissions
Traiter les réponses de Claude
- Sécurité : L’outil a accès à votre système de fichiers local, donc implémentez des mesures de sécurité appropriées.
- Sauvegarde : Créez toujours des sauvegardes avant de permettre les modifications de fichiers importants.
- Validation : Validez toutes les entrées pour prévenir les modifications involontaires.
- Correspondance unique : Assurez-vous que les remplacements correspondent exactement à un seul emplacement pour éviter les modifications involontaires.
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 :Fichier non trouvé
Fichier non trouvé
tool_result :Correspondances multiples pour le remplacement
Correspondances multiples pour le remplacement
str_replace de Claude correspond à plusieurs emplacements dans le fichier, retournez un message d’erreur approprié :Aucune correspondance pour le remplacement
Aucune correspondance pour le remplacement
str_replace de Claude ne correspond à aucun texte dans le fichier, retournez un message d’erreur approprié :Erreurs de permission
Erreurs de permission
Suivre les meilleures pratiques de mise en œuvre
Fournir un contexte clair
Fournir un contexte clair
Être explicite sur les chemins de fichiers
Être explicite sur les chemins de fichiers
Créer des sauvegardes avant la modification
Créer des sauvegardes avant la modification
Gérer le remplacement de texte unique avec soin
Gérer le remplacement de texte unique avec soin
str_replace nécessite une correspondance exacte du texte à remplacer. Votre application doit s’assurer qu’il y a exactement une correspondance pour l’ancien texte ou fournir des messages d’erreur appropriés.Vérifier les modifications
Vérifier les modifications
Tarification et utilisation des tokens
The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you’re using. In addition to the base tokens, the following additional input tokens are needed for the text editor tool:| Tool | Additional input tokens |
|---|---|
text_editor_20250429 (Claude 4.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Intégrer l’outil d’éditeur de texte avec d’autres outils
L’outil d’éditeur de texte peut être utilisé aux côtés d’autres outils Claude. Lors de la combinaison d’outils, assurez-vous de :- Faire correspondre la version de l’outil avec le modèle que vous utilisez
- Tenir compte de l’utilisation supplémentaire de tokens pour tous les outils inclus dans votre demande
Journal des modifications
| Date | Version | Modifications |
|---|---|---|
| 28 juillet 2025 | text_editor_20250728 | Publication d’un outil d’éditeur de texte mis à jour qui corrige certains problèmes et ajoute un paramètre max_characters optionnel. Il est par ailleurs identique à text_editor_20250429. |
| 29 avril 2025 | text_editor_20250429 | Publication de l’outil d’éditeur de texte pour Claude 4. Cette version supprime la commande undo_edit mais maintient toutes les autres capacités. Le nom de l’outil a été mis à jour pour refléter son architecture basée sur str_replace. |
| 13 mars 2025 | text_editor_20250124 | Introduction de la documentation autonome de l’outil d’éditeur de texte. Cette version est optimisée pour Claude Sonnet 3.7 mais a des capacités identiques à la version précédente. |
| 22 octobre 2024 | text_editor_20241022 | Publication initiale de l’outil d’éditeur de texte avec Claude Sonnet 3.5 (retiré). Fournit des capacités pour afficher, créer et modifier des fichiers via les commandes view, create, str_replace, insert et undo_edit. |
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 d’examen de code : Demandez à Claude d’examiner votre code et d’apporter des améliorations
- Construire un assistant de débogage : Créez un système où Claude peut vous aider à diagnostiquer et corriger les 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 : Configurez des flux de travail pour que Claude documente automatiquement votre code