Ferramenta de editor de texto

Claude pode usar uma ferramenta de editor de texto definida pela Anthropic para visualizar e modificar arquivos de texto, ajudando você a depurar, corrigir e melhorar seu código ou outros documentos de texto. Isso permite que Claude interaja diretamente com seus arquivos, fornecendo assistência prática em vez de apenas sugerir mudanças.

Compatibilidade de modelos

Quando usar a ferramenta de editor de texto

Alguns exemplos de quando usar a ferramenta de editor de texto são:

• Depuração de código: Peça ao Claude para identificar e corrigir bugs em seu código, desde erros de sintaxe até problemas de lógica.
• Refatoração de código: Deixe Claude melhorar a estrutura, legibilidade e desempenho do seu código através de edições direcionadas.
• Geração de documentação: Peça ao Claude para adicionar docstrings, comentários ou arquivos README ao seu código.
• Criação de testes: Peça ao Claude para criar testes unitários para seu código com base em sua compreensão da implementação.

Use a ferramenta de editor de texto

A ferramenta de editor de texto pode ser usada da seguinte forma:

Comandos da ferramenta de editor de texto

A ferramenta de editor de texto suporta vários comandos para visualizar e modificar arquivos:

view

O comando view permite que Claude examine o conteúdo de um arquivo ou liste o conteúdo de um diretório. Ele pode ler o arquivo inteiro ou um intervalo específico de linhas.

Parâmetros:

• command: Deve ser "view"
• path: O caminho para o arquivo ou diretório a visualizar
• view_range (opcional): Uma matriz de dois inteiros especificando os números de linha inicial e final a visualizar. Os números de linha são indexados a partir de 1, e -1 para a linha final significa ler até o final do arquivo. Este parâmetro se aplica apenas ao visualizar arquivos, não diretórios.

str_replace

O comando str_replace permite que Claude substitua uma string específica em um arquivo por uma nova string. Isso é usado para fazer edições precisas.

Parâmetros:

• command: Deve ser "str_replace"
• path: O caminho para o arquivo a modificar
• old_str: O texto a substituir (deve corresponder exatamente, incluindo espaços em branco e indentação)
• new_str: O novo texto a inserir no lugar do texto antigo

create

O comando create permite que Claude crie um novo arquivo com conteúdo especificado.

Parâmetros:

• command: Deve ser "create"
• path: O caminho onde o novo arquivo deve ser criado
• file_text: O conteúdo a escrever no novo arquivo

insert

O comando insert permite que Claude insira texto em um local específico em um arquivo.

Parâmetros:

• command: Deve ser "insert"
• path: O caminho para o arquivo a modificar
• insert_line: O número da linha após a qual inserir o texto (0 para o início do arquivo)
• new_str: O texto a inserir

undo_edit

O comando undo_edit permite que Claude reverta a última edição feita em um arquivo.

Parâmetros:

• command: Deve ser "undo_edit"
• path: O caminho para o arquivo cuja última edição deve ser desfeita

Exemplo: Corrigindo um erro de sintaxe com a ferramenta de editor de texto

Implementar a ferramenta editor de texto

A ferramenta editor de texto é implementada como uma ferramenta sem esquema. Ao usar esta ferramenta, você não precisa fornecer um esquema de entrada como com outras ferramentas; o esquema é integrado ao modelo Claude e não pode ser modificado.

O tipo de ferramenta depende da versão do modelo:

• Claude 4: type: "text_editor_20250728"
• Claude Sonnet 3.7: type: "text_editor_20250124"

Lidar com erros

Ao usar a ferramenta editor de texto, vários erros podem ocorrer. Aqui está orientação sobre como tratá-los:

Seguir as melhores práticas de implementação

Preços e uso de 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:

Para informações mais detalhadas sobre preços de ferramentas, consulte Preços de uso de ferramentas.

Integrar a ferramenta editor de texto com outras ferramentas

A ferramenta editor de texto pode ser usada junto com outras ferramentas Claude. Ao combinar ferramentas, certifique-se de:

• Corresponder a versão da ferramenta com o modelo que você está usando
• Contabilizar o uso de tokens adicional para todas as ferramentas incluídas em sua solicitação

Registro de alterações

Próximos passos

Aqui estão algumas ideias de como usar a ferramenta editor de texto de formas mais convenientes e poderosas:

• Integrar com seu fluxo de trabalho de desenvolvimento: Construa a ferramenta editor de texto em suas ferramentas de desenvolvimento ou IDE
• Criar um sistema de revisão de código: Tenha Claude revisar seu código e fazer melhorias
• Construir um assistente de depuração: Crie um sistema onde Claude possa ajudá-lo a diagnosticar e corrigir problemas em seu código
• Implementar conversão de formato de arquivo: Deixe Claude ajudá-lo a converter arquivos de um formato para outro
• Automatizar documentação: Configure fluxos de trabalho para Claude documentar automaticamente seu código

Conforme você constrói aplicações com a ferramenta editor de texto, estamos animados para ver como você aproveita as capacidades do Claude para aprimorar seu fluxo de trabalho de desenvolvimento e produtividade.