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.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
ao usar a ferramenta de editor de texto.A ferramenta de editor de texto está geralmente disponível nos modelos Claude 4 e Claude Sonnet 3.7.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 ou Sonnet 3.5 com suas respectivas versões de ferramenta.str_replace_based_edit_tool
) para Claude usando a API Messages.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 Claude com a ferramenta de editor de texto e um prompt do usuário
Claude usa a ferramenta para examinar arquivos ou diretórios
view
para examinar o conteúdo dos arquivos ou listar o conteúdo dos diretóriostool_use
com o comando view
Execute o comando view e retorne os resultados
max_characters
foi especificado na configuração da ferramenta, truncar o conteúdo do arquivo para esse comprimentouser
contendo um bloco de conteúdo tool_result
Claude usa a ferramenta para modificar arquivos
str_replace
para fazer mudanças ou insert
para adicionar texto em um número de linha específico.str_replace
, Claude constrói uma solicitação de uso de ferramenta adequadamente formatada com o texto antigo e o novo texto para substituí-loExecute a edição e retorne os resultados
Claude fornece sua análise e explicação
view
permite que Claude examine o conteúdo de um arquivo ou liste o conteúdo de um diretório. 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 ser visualizadoview_range
(opcional): Um array de dois inteiros especificando os números de linha inicial e final para visualizar. Os números de linha são indexados em 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
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 ser modificadoold_str
: O texto a ser substituído (deve corresponder exatamente, incluindo espaços em branco e indentação)new_str
: O novo texto a ser inserido no lugar do texto antigoExemplo de comando str_replace
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 criadofile_text
: O conteúdo a ser escrito no novo arquivoExemplo de comando create
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 ser modificadoinsert_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 ser inseridoExemplo de comando insert
undo_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 desfeitaExemplo de comando undo_edit
view
inclui conteúdo do arquivo com números de linha anexados 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:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
Inicialize sua implementação do editor
Lide com chamadas da ferramenta de editor
Implemente medidas de segurança
Processe as respostas do Claude
Arquivo não encontrado
tool_result
:Múltiplas correspondências para substituição
str_replace
do Claude corresponder a múltiplos locais no arquivo, retorne uma mensagem de erro apropriada:Nenhuma correspondência para substituição
str_replace
do Claude não corresponder a nenhum texto no arquivo, retorne uma mensagem de erro apropriada:Erros de permissão
Forneça contexto claro
Seja explícito sobre caminhos de arquivo
Crie backups antes de editar
Lide com substituição de texto única cuidadosamente
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 mudanças
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 (deprecated)) | 700 tokens |
Data | Versão | Mudanças |
---|---|---|
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 opcional max_characters . É idêntica ao text_editor_20250429 . |
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 independente. 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 (descontinuado). Fornece capacidades para visualizar, criar e editar arquivos através dos comandos view , create , str_replace , insert e undo_edit . |