Outil d'édition de texte
Claude peut utiliser un outil d’édition de texte défini par Anthropic pour visualiser et modifier des fichiers texte, vous aidant à déboguer, corriger et améliorer votre code ou d’autres documents texte. Cela permet à Claude d’interagir directement avec vos fichiers, fournissant une assistance pratique plutôt que de simplement suggérer des modifications.
Avant d’utiliser l’outil d’édition de texte
Utiliser un modèle compatible
L’outil d’édition de texte d’Anthropic est disponible pour plusieurs modèles Claude :
- Claude 4 Opus & Sonnet :
text_editor_20250429
- Claude Sonnet 3.7 :
text_editor_20250124
- Claude Sonnet 3.5 :
text_editor_20241022
Claude Sonnet 3.5 nécessite l’en-tête bêta computer-use-2024-10-22
lors de l’utilisation de l’outil d’édition de texte.
L’outil d’édition de texte est généralement disponible dans Claude 4 et Sonnet 3.7.
Le plus récent text_editor_20250429
pour les modèles Claude 4 n’inclut pas la commande undo_edit
. Si vous avez besoin de cette fonctionnalité, vous devrez utiliser Claude 3.7 ou Sonnet 3.5 avec leurs versions d’outils respectives.
Évaluer l’adéquation de votre cas d’usage
Quelques exemples de quand utiliser l’outil d’édition de texte sont :
- Débogage de code : Faire identifier et corriger les bogues dans votre code par Claude, des erreurs de syntaxe aux problèmes de logique.
- Refactorisation de code : Laisser Claude améliorer la structure, la lisibilité et les performances de votre code grâce à des modifications ciblées.
- Génération de documentation : Demander à Claude d’ajouter des docstrings, des commentaires ou des fichiers README à votre base de code.
- Création de tests : Faire créer des tests unitaires pour votre code par Claude basés sur sa compréhension de l’implémentation.
Utiliser l’outil d’édition de texte
Fournir l’outil d’édition de texte (nommé str_replace_based_edit_tool
) à Claude en utilisant l’API Messages :
Fournir l’outil d’édition de texte (nommé str_replace_based_edit_tool
) à Claude en utilisant l’API Messages :
Fournir l’outil d’édition de texte (nommé str_replace_editor
) à Claude en utilisant l’API Messages :
Fournir l’outil d’édition de texte (nommé str_replace_editor
) à Claude en utilisant l’API Messages :
L’outil d’édition de texte peut être utilisé de la manière suivante :
Fournir à Claude l'outil d'édition de texte et une invite utilisateur
- Inclure l’outil d’édition de texte dans votre requête API
- Fournir une invite utilisateur qui peut nécessiter l’examen ou la modification de 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
view
pour examiner le contenu des fichiers ou lister le contenu des répertoires - La réponse API contiendra un bloc de contenu
tool_use
avec la commandeview
Exécuter la commande view et retourner les résultats
- Extraire le chemin du fichier ou du répertoire de la demande d’utilisation d’outil de Claude
- Lire le contenu du fichier ou lister le contenu du répertoire et les retourner à Claude
- Retourner les résultats à Claude en continuant la conversation avec un nouveau message
user
contenant 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_replace
pour apporter des modifications ouinsert
pour 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
- Extraire le chemin du fichier, l’ancien texte et le nouveau texte de la demande d’utilisation d’outil de Claude
- Effectuer le remplacement de texte dans le fichier
- Retourner 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’édition de texte
L’outil d’édition de texte prend en charge plusieurs commandes pour visualiser et modifier les fichiers :
view
La commande view
permet à Claude d’examiner le contenu d’un fichier ou de lister le contenu d’un répertoire. Elle peut lire l’ensemble du fichier ou une plage spécifique de lignes.
Paramètres :
command
: Doit être “view”path
: Le chemin vers le fichier ou le répertoire à visualiserview_range
(optionnel) : Un tableau de deux entiers spécifiant les numéros de ligne de début et de fin à visualiser. 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 ne s’applique que lors de la visualisation de fichiers, pas de répertoires.
str_replace
La commande str_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 vers le 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
create
La commande create
permet à Claude de créer un nouveau fichier avec un 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
insert
La commande insert
permet à Claude d’insérer du texte à un emplacement spécifique dans un fichier.
Paramètres :
command
: Doit être “insert”path
: Le chemin vers le 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
undo_edit
La commande undo_edit
permet à Claude d’annuler la dernière modification apportée à un fichier.
Cette commande n’est disponible que dans Claude Sonnet 3.7 et Claude Sonnet 3.5. Elle n’est pas prise en charge dans les modèles Claude 4 utilisant le text_editor_20250429
.
Paramètres :
command
: Doit être “undo_edit”path
: Le chemin vers le fichier dont la dernière modification doit être annulée
Exemple : Corriger une erreur de syntaxe avec l’outil d’édition de texte
Cet exemple démontre comment Claude 4 utilise l’outil d’édition de texte pour corriger une erreur de syntaxe dans un fichier Python.
D’abord, votre application fournit à Claude l’outil d’édition de texte et une invite pour corriger une erreur de syntaxe :
Claude utilisera d’abord l’outil d’édition de texte pour visualiser le fichier :
Votre application devrait alors lire le fichier et retourner son contenu à Claude :
Numéros de ligne
Dans l’exemple ci-dessus, le résultat de l’outil view
inclut le contenu du fichier avec des 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 requis, 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.
Claude identifiera l’erreur de syntaxe et utilisera la commande str_replace
pour la corriger :
Votre application devrait alors effectuer la modification et retourner le résultat :
Finalement, Claude fournira une explication complète de la correction :
Cet exemple démontre comment Claude 4 utilise l’outil d’édition de texte pour corriger une erreur de syntaxe dans un fichier Python.
D’abord, votre application fournit à Claude l’outil d’édition de texte et une invite pour corriger une erreur de syntaxe :
Claude utilisera d’abord l’outil d’édition de texte pour visualiser le fichier :
Votre application devrait alors lire le fichier et retourner son contenu à Claude :
Numéros de ligne
Dans l’exemple ci-dessus, le résultat de l’outil view
inclut le contenu du fichier avec des 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 requis, 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.
Claude identifiera l’erreur de syntaxe et utilisera la commande str_replace
pour la corriger :
Votre application devrait alors effectuer la modification et retourner le résultat :
Finalement, Claude fournira une explication complète de la correction :
Cet exemple démontre comment Claude Sonnet 3.7 utilise l’outil d’édition de texte pour corriger une erreur de syntaxe dans un fichier Python.
D’abord, votre application fournit à Claude l’outil d’édition de texte et une invite pour corriger une erreur de syntaxe :
Les exemples de Claude Sonnet 3.7 suivent le même format que les exemples de Claude 4 ci-dessus, utilisant les mêmes appels d’outils et réponses mais avec le type d’outil text_editor_20250124
et le nom str_replace_editor
.
Implémenter l’outil d’édition de texte
L’outil d’édition de texte est implémenté comme un 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é dans le modèle de Claude et ne peut pas être modifié.
Le type d’outil dépend de la version du modèle :
- Claude 4 :
type: "text_editor_20250429"
- Claude Sonnet 3.7 :
type: "text_editor_20250124"
- Claude Sonnet 3.5 :
type: "text_editor_20241022"
Initialiser votre implémentation d'éditeur
Créer des fonctions d’aide pour gérer les opérations de fichiers comme la lecture, l’écriture et la modification de fichiers. Considérer l’implémentation d’une fonctionnalité de sauvegarde pour récupérer des erreurs.
Gérer les appels d'outils d'éditeur
Créer une fonction qui traite les appels d’outils de Claude basés sur le type de commande :
Implémenter des mesures de sécurité
Ajouter des vérifications de validation et de sécurité :
- Valider les chemins de fichiers pour empêcher la traversée de répertoires
- Créer des sauvegardes avant d’apporter des modifications
- Gérer les erreurs avec élégance
- Implémenter des vérifications de permissions
Traiter les réponses de Claude
Extraire et gérer les appels d’outils des réponses de Claude :
Lors de l’implémentation de l’outil d’édition de texte, gardez à l’esprit :
- 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 des modifications de fichiers importants.
- Validation : Validez toutes les entrées pour empêcher des modifications non intentionnelles.
- Correspondance unique : Assurez-vous que les remplacements correspondent exactement à un emplacement pour éviter des modifications non intentionnelles.
Gérer les erreurs
Lors de l’utilisation de l’outil d’édition de texte, diverses erreurs peuvent survenir. Voici des conseils sur la façon de les gérer :
Suivre les meilleures pratiques d’implémentation
Tarification et utilisation de jetons
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) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5) | 700 tokens |
Pour des informations plus détaillées sur la tarification des outils, voir Tarification de l’utilisation d’outils.
Intégrer l’outil d’édition de texte avec d’autres outils
L’outil d’édition 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 jetons pour tous les outils inclus dans votre requête
Journal des modifications
Date | Version | Modifications |
---|---|---|
29 avril 2025 | text_editor_20250429 | Publication de l’outil d’édition 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’édition 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’édition de texte avec Claude Sonnet 3.5. Fournit des capacités pour visualiser, créer et modifier des fichiers grâce aux commandes view , create , str_replace , insert et undo_edit . |
Prochaines étapes
Voici quelques idées sur la façon d’utiliser l’outil d’édition de texte de manières plus pratiques et puissantes :
- Intégrer avec votre flux de travail de développement : Intégrer l’outil d’édition de texte dans vos outils de développement ou IDE
- Créer un système de révision de code : Faire réviser votre code par Claude et apporter des améliorations
- Construire un assistant de débogage : Créer 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 : Laisser Claude vous aider à convertir des fichiers d’un format à un autre
- Automatiser la documentation : Configurer des flux de travail pour que Claude documente automatiquement votre code
Alors que vous construisez des applications avec l’outil d’édition de texte, nous sommes impatients de voir comment vous exploitez les capacités de Claude pour améliorer votre flux de travail de développement et votre productivité.
Aperçu de l'utilisation d'outils
Apprenez comment implémenter des flux de travail d’outils pour une utilisation avec Claude.
Utilisation d'outils efficace en jetons
Réduisez la latence et les coûts lors de l’utilisation d’outils avec Claude Sonnet 3.7.
Outil Bash
Exécutez des commandes shell avec Claude.