Outils

Outil d'éditeur de texte

Claude peut utiliser un outil d'éditeur de texte défini par Anthropic pour afficher 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, en fournissant une assistance pratique plutôt que de simplement suggérer des modifications.

Compatibilité des modèles

Modèle	Version de l'outil
Modèles Claude 4.x	`text_editor_20250728`
Claude Sonnet 3.7 (obsolète)	`text_editor_20250124`

L'outil 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 (obsolète).

Les versions antérieures de l'outil ne sont pas garanties d'être rétro-compatibles avec les modèles plus récents. Utilisez toujours la version de l'outil qui correspond à votre version de modèle.

Quand utiliser l'outil d'éditeur de texte

Voici quelques exemples de cas d'utilisation de 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

L'outil d'éditeur de texte peut être utilisé de la manière suivante :

Fournissez à 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 view pour examiner le contenu des fichiers ou lister le contenu des répertoires
- La réponse de l'API contiendra un bloc de contenu tool_use avec la commande view
Exécutez la commande view et retournez 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_characters a é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 user contenant un bloc de contenu tool_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 effectuer des modifications ou insert 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écutez la modification et retournez 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 commande view 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 spécifique de lignes.

Paramètres :

command : Doit être « view »
path : Le chemin du fichier ou du répertoire à afficher
view_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.

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 du fichier à modifier
old_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 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

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 du fichier à modifier
insert_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 est disponible uniquement dans Claude Sonnet 3.7 (obsolète). Elle n'est pas prise en charge dans les modèles Claude 4 utilisant le text_editor_20250728.

Paramètres :

command : Doit être « undo_edit »
path : Le chemin du fichier dont la dernière modification doit être annulée

Exemple : Correction d'une erreur de syntaxe avec l'outil d'éditeur de texte

Implémenter l'outil éditeur de texte

L'outil éditeur de texte est implémenté en tant qu'outil sans schéma. Lorsque vous utilisez 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 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_20250728"
Claude Sonnet 3.7 : type: "text_editor_20250124"

Initialiser votre implémentation d'éditeur
Créez des fonctions d'aide pour gérer les opérations de fichiers comme la lecture, l'écriture et la modification de fichiers. Envisagez d'implémenter une fonctionnalité de sauvegarde pour récupérer les erreurs.

Gérer les appels d'outil d'éditeur

Créez une fonction qui traite les appels d'outil de Claude en fonction du type de commande :

def handle_editor_tool(tool_call, model_version):
    input_params = tool_call.input
    command = input_params.get('command', '')
    file_path = input_params.get('path', '')
    
    if command == 'view':
        # Read and return file contents
        pass
    elif command == 'str_replace':
        # Replace text in file
        pass
    elif command == 'create':
        # Create new file
        pass
    elif command == 'insert':
        # Insert text at location
        pass
    elif command == 'undo_edit':
        # Check if it's a Claude 4 model
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Restore from backup for Claude 3.7
        pass

Implémenter les mesures de sécurité
Ajoutez des vérifications de validation et 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 avec élégance
- Implémentez des vérifications de permissions

Traiter les réponses de Claude

Extrayez et gérez les appels d'outil des réponses de Claude :

# Process tool use in Claude's response
for content in response.content:
    if content.type == "tool_use":
        # Execute the tool based on command
        result = handle_editor_tool(content)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

Lors de l'implémentation de l'outil éditeur 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 d'autoriser 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 éditeur 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 des 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.x)	700 tokens
`text_editor_20250124` (Claude Sonnet 3.7 (deprecated))	700 tokens

Pour plus d'informations détaillées sur la tarification des outils, consultez Tarification de l'utilisation des outils.

Intégrer l'outil éditeur de texte avec d'autres outils

L'outil éditeur de texte peut être utilisé aux côtés d'autres outils Claude. Lors de la combinaison d'outils, assurez-vous que :

La version de l'outil correspond au modèle que vous utilisez
Vous tenez compte de l'utilisation supplémentaire de jetons pour tous les outils inclus dans votre demande

Journal des modifications

Date	Version	Modifications
28 juillet 2025	`text_editor_20250728`	Publication d'un outil é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 é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 é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 é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 éditeur de texte de manière plus pratique et puissante :

Intégrer à votre flux de travail de développement : Intégrez l'outil éditeur de texte dans vos outils de développement ou votre IDE
Créer un système d'examen du code : Demandez à Claude d'examiner votre code et d'apporter des améliorations
Créer un assistant de débogage : Créez un système où Claude peut vous aider à diagnostiquer et corriger les problèmes de 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

À mesure que vous créez des applications avec l'outil éditeur 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 des outils

Découvrez comment implémenter des flux de travail d'outils pour une utilisation avec Claude.

Outil Bash

Exécutez des commandes shell avec Claude.

Outils

Outil d'éditeur de texte

Compatibilité des modèles

Modèle	Version de l'outil
Modèles Claude 4.x	`text_editor_20250728`
Claude Sonnet 3.7 (obsolète)	`text_editor_20250124`

L'outil 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 (obsolète).

Quand utiliser l'outil d'éditeur de texte

Voici quelques exemples de cas d'utilisation de 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

L'outil d'éditeur de texte peut être utilisé de la manière suivante :

Fournissez à 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 view pour examiner le contenu des fichiers ou lister le contenu des répertoires
- La réponse de l'API contiendra un bloc de contenu tool_use avec la commande view
Exécutez la commande view et retournez 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_characters a é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 user contenant un bloc de contenu tool_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 effectuer des modifications ou insert 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écutez la modification et retournez 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 commande view 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 spécifique de lignes.

Paramètres :

command : Doit être « view »
path : Le chemin du fichier ou du répertoire à afficher
view_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.

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 du fichier à modifier
old_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 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

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 du fichier à modifier
insert_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 est disponible uniquement dans Claude Sonnet 3.7 (obsolète). Elle n'est pas prise en charge dans les modèles Claude 4 utilisant le text_editor_20250728.

Paramètres :

command : Doit être « undo_edit »
path : Le chemin du fichier dont la dernière modification doit être annulée

Exemple : Correction d'une erreur de syntaxe avec l'outil d'éditeur de texte

Implémenter l'outil éditeur de texte

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
Créez des fonctions d'aide pour gérer les opérations de fichiers comme la lecture, l'écriture et la modification de fichiers. Envisagez d'implémenter une fonctionnalité de sauvegarde pour récupérer les erreurs.

Gérer les appels d'outil d'éditeur

Créez une fonction qui traite les appels d'outil de Claude en fonction du type de commande :

def handle_editor_tool(tool_call, model_version):
    input_params = tool_call.input
    command = input_params.get('command', '')
    file_path = input_params.get('path', '')
    
    if command == 'view':
        # Read and return file contents
        pass
    elif command == 'str_replace':
        # Replace text in file
        pass
    elif command == 'create':
        # Create new file
        pass
    elif command == 'insert':
        # Insert text at location
        pass
    elif command == 'undo_edit':
        # Check if it's a Claude 4 model
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Restore from backup for Claude 3.7
        pass

Implémenter les mesures de sécurité
Ajoutez des vérifications de validation et 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 avec élégance
- Implémentez des vérifications de permissions

Traiter les réponses de Claude

Extrayez et gérez les appels d'outil des réponses de Claude :

# Process tool use in Claude's response
for content in response.content:
    if content.type == "tool_use":
        # Execute the tool based on command
        result = handle_editor_tool(content)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

Lors de l'implémentation de l'outil éditeur 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 d'autoriser 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 éditeur 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 des 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.x)	700 tokens
`text_editor_20250124` (Claude Sonnet 3.7 (deprecated))	700 tokens

Pour plus d'informations détaillées sur la tarification des outils, consultez Tarification de l'utilisation des outils.

Intégrer l'outil éditeur de texte avec d'autres outils

L'outil éditeur de texte peut être utilisé aux côtés d'autres outils Claude. Lors de la combinaison d'outils, assurez-vous que :

La version de l'outil correspond au modèle que vous utilisez
Vous tenez compte de l'utilisation supplémentaire de jetons pour tous les outils inclus dans votre demande

Journal des modifications

Date	Version	Modifications
28 juillet 2025	`text_editor_20250728`	Publication d'un outil é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 é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 é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 é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 éditeur de texte de manière plus pratique et puissante :

Intégrer à votre flux de travail de développement : Intégrez l'outil éditeur de texte dans vos outils de développement ou votre IDE
Créer un système d'examen du code : Demandez à Claude d'examiner votre code et d'apporter des améliorations
Créer un assistant de débogage : Créez un système où Claude peut vous aider à diagnostiquer et corriger les problèmes de 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

Aperçu de l'utilisation des outils

Découvrez comment implémenter des flux de travail d'outils pour une utilisation avec Claude.

Outil Bash

Exécutez des commandes shell avec Claude.

Compatibilité des modèles

Quand utiliser l'outil d'éditeur de texte

Utiliser l'outil d'éditeur de texte

Commandes de l'outil d'éditeur de texte

view

Exemples de commandes view

str_replace

Exemple de commande str_replace

create

Exemple de commande create

insert

Exemple de commande insert

undo_edit

Exemple de commande undo_edit

Exemple : Correction d'une erreur de syntaxe avec l'outil d'éditeur de texte

Implémenter l'outil éditeur de texte

Gérer les erreurs

Fichier non trouvé

Correspondances multiples pour le remplacement

Aucune correspondance pour le remplacement

Erreurs de permission

Suivre les meilleures pratiques d'implémentation

Fournir un contexte clair

Être explicite sur les chemins de fichiers

Créer des sauvegardes avant la modification

Gérer le remplacement de texte unique avec soin

Vérifier les modifications

Tarification et utilisation des jetons

Intégrer l'outil éditeur de texte avec d'autres outils

Journal des modifications

Prochaines étapes

Compatibilité des modèles

Quand utiliser l'outil d'éditeur de texte

Utiliser l'outil d'éditeur de texte

Commandes de l'outil d'éditeur de texte

view

Exemples de commandes view

str_replace

Exemple de commande str_replace

create

Exemple de commande create

insert

Exemple de commande insert

undo_edit

Exemple de commande undo_edit

Exemple : Correction d'une erreur de syntaxe avec l'outil d'éditeur de texte

Implémenter l'outil éditeur de texte

Gérer les erreurs

Fichier non trouvé

Correspondances multiples pour le remplacement

Aucune correspondance pour le remplacement

Erreurs de permission

Suivre les meilleures pratiques d'implémentation

Fournir un contexte clair

Être explicite sur les chemins de fichiers

Créer des sauvegardes avant la modification

Gérer le remplacement de texte unique avec soin

Vérifier les modifications

Tarification et utilisation des jetons

Intégrer l'outil éditeur de texte avec d'autres outils

Journal des modifications

Prochaines étapes