Compatibilidade de modelos
| Modelo | Versão da Ferramenta |
|---|---|
| Modelos Claude 4.x | text_editor_20250728 |
| Claude Sonnet 3.7 (descontinuado) | text_editor_20250124 |
text_editor_20250728 para modelos Claude 4 não inclui o comando undo_edit. Se você precisar dessa funcionalidade, será necessário usar Claude Sonnet 3.7 (descontinuado).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: Faça Claude 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 a Claude para adicionar docstrings, comentários ou arquivos README ao seu código.
- Criação de testes: Faça Claude criar testes unitários para seu código com base em sua compreensão da implementação.
Use a ferramenta de editor de texto
str_replace_based_edit_tool) a Claude usando a API de Mensagens.Você pode opcionalmente especificar um parâmetro max_characters para controlar o truncamento ao visualizar arquivos grandes.max_characters é compatível apenas com text_editor_20250728 e versões posteriores da ferramenta de editor de texto.Forneça a Claude a ferramenta de editor de texto e um prompt do usuário
- Inclua a ferramenta de editor de texto em sua solicitação de API
- Forneça um prompt do usuário que pode exigir examinar ou modificar arquivos, como “Você pode corrigir o erro de sintaxe no meu código?”
Claude usa a ferramenta para examinar arquivos ou diretórios
- Claude avalia o que precisa examinar e usa o comando
viewpara examinar o conteúdo do arquivo ou listar o conteúdo do diretório - A resposta da API conterá um bloco de conteúdo
tool_usecom o comandoview
Execute o comando view e retorne os resultados
- Extraia o caminho do arquivo ou diretório da solicitação de uso de ferramenta de Claude
- Leia o conteúdo do arquivo ou liste o conteúdo do diretório
- Se um parâmetro
max_charactersfoi especificado na configuração da ferramenta, truncue o conteúdo do arquivo para esse comprimento - Retorne os resultados a Claude continuando a conversa com uma nova mensagem
usercontendo um bloco de conteúdotool_result
Claude usa a ferramenta para modificar arquivos
- Após examinar o arquivo ou diretório, Claude pode usar um comando como
str_replacepara fazer alterações ouinsertpara adicionar texto em um número de linha específico. - Se Claude usar o comando
str_replace, Claude constrói uma solicitação de uso de ferramenta adequadamente formatada com o texto antigo e o novo texto para substituí-lo
Execute a edição e retorne os resultados
- Extraia o caminho do arquivo, texto antigo e novo texto da solicitação de uso de ferramenta de Claude
- Execute a substituição de texto no arquivo
- Retorne os resultados a Claude
Claude fornece sua análise e explicação
- Após examinar e possivelmente editar os arquivos, Claude fornece uma explicação completa do que encontrou e quais alterações fez
Comandos da ferramenta de editor de texto
A ferramenta de editor de texto suporta vários comandos para visualizar e modificar arquivos:view
O comandoview 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 visualizarview_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.
Exemplos de comandos view
Exemplos de comandos view
str_replace
O comandostr_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 modificarold_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
Exemplo de comando str_replace
Exemplo de comando str_replace
create
O comandocreate 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 criadofile_text: O conteúdo a escrever no novo arquivo
Exemplo de comando create
Exemplo de comando create
insert
O comandoinsert 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 modificarinsert_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
Exemplo de comando insert
Exemplo de comando insert
undo_edit
O comandoundo_edit permite que Claude reverta a última edição feita em um arquivo.
text_editor_20250728.command: Deve ser “undo_edit”path: O caminho para o arquivo cuja última edição deve ser desfeita
Exemplo de comando undo_edit
Exemplo de comando undo_edit
Exemplo: Corrigindo um erro de sintaxe com a ferramenta de editor de texto
view inclui o conteúdo do arquivo com números de linha adicionados a cada linha (por exemplo, “1: def is_prime(n):”). Os números de linha não são obrigatórios, mas são essenciais para usar com sucesso o parâmetro view_range para examinar seções específicas de arquivos e o parâmetro insert_line para adicionar conteúdo em locais precisos.str_replace para corrigi-lo:Implemente a ferramenta de editor de texto
A ferramenta de 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 é incorporado ao modelo de 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"
Inicialize sua implementação do editor
Manipule chamadas de ferramenta do editor
Implemente medidas de segurança
- Valide caminhos de arquivo para evitar travessia de diretório
- Crie backups antes de fazer alterações
- Manipule erros graciosamente
- Implemente verificações de permissões
Processe as respostas de Claude
- Segurança: A ferramenta tem acesso ao seu sistema de arquivos local, portanto implemente medidas de segurança adequadas.
- Backup: Sempre crie backups antes de permitir edições em arquivos importantes.
- Validação: Valide todas as entradas para evitar alterações não intencionais.
- Correspondência única: Certifique-se de que as substituições correspondem exatamente a um local para evitar edições não intencionais.
Manipule erros
Ao usar a ferramenta de editor de texto, vários erros podem ocorrer. Aqui está orientação sobre como tratá-los:Arquivo não encontrado
Arquivo não encontrado
tool_result:Múltiplas correspondências para substituição
Múltiplas correspondências para substituição
str_replace de Claude corresponder a vários locais no arquivo, retorne uma mensagem de erro apropriada:Nenhuma correspondência para substituição
Nenhuma correspondência para substituição
str_replace de Claude não corresponder a nenhum texto no arquivo, retorne uma mensagem de erro apropriada:Erros de permissão
Erros de permissão
Siga as melhores práticas de implementação
Forneça contexto claro
Forneça contexto claro
Seja explícito sobre caminhos de arquivo
Seja explícito sobre caminhos de arquivo
Crie backups antes de editar
Crie backups antes de editar
Manipule a substituição de texto único com cuidado
Manipule a substituição de texto único com cuidado
str_replace requer uma correspondência exata para o texto a ser substituído. Sua aplicação deve garantir que haja exatamente uma correspondência para o texto antigo ou fornecer mensagens de erro apropriadas.Verifique as alterações
Verifique as alterações
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:| Tool | Additional input tokens |
|---|---|
text_editor_20250429 (Claude 4.x) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7 (deprecated)) | 700 tokens |
Integre a ferramenta de editor de texto com outras ferramentas
A ferramenta de 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
| Data | Versão | Alterações |
|---|---|---|
| 28 de julho de 2025 | text_editor_20250728 | Lançamento de uma ferramenta de editor de texto atualizada que corrige alguns problemas e adiciona um parâmetro max_characters opcional. É idêntica a text_editor_20250429 de outra forma. |
| 29 de abril de 2025 | text_editor_20250429 | Lançamento da ferramenta de editor de texto para Claude 4. Esta versão remove o comando undo_edit, mas mantém todas as outras capacidades. O nome da ferramenta foi atualizado para refletir sua arquitetura baseada em str_replace. |
| 13 de março de 2025 | text_editor_20250124 | Introdução da documentação da ferramenta de editor de texto autônoma. Esta versão é otimizada para Claude Sonnet 3.7, mas tem capacidades idênticas à versão anterior. |
| 22 de outubro de 2024 | text_editor_20241022 | Lançamento inicial da ferramenta de editor de texto com Claude Sonnet 3.5 (retirado). Fornece capacidades para visualizar, criar e editar arquivos através dos comandos view, create, str_replace, insert e undo_edit. |
Próximos passos
Aqui estão algumas ideias de como usar a ferramenta de editor de texto de formas mais convenientes e poderosas:- Integre com seu fluxo de trabalho de desenvolvimento: Construa a ferramenta de editor de texto em suas ferramentas de desenvolvimento ou IDE
- Crie um sistema de revisão de código: Faça Claude revisar seu código e fazer melhorias
- Construa um assistente de depuração: Crie um sistema onde Claude pode ajudá-lo a diagnosticar e corrigir problemas em seu código
- Implemente conversão de formato de arquivo: Deixe Claude ajudá-lo a converter arquivos de um formato para outro
- Automatize documentação: Configure fluxos de trabalho para Claude documentar automaticamente seu código