Позволяет Claude просматривать и изменять текстовые файлы, помогая отлаживать, исправлять и улучшать код или другие текстовые документы.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
при использовании инструмента текстового редактора.Инструмент текстового редактора общедоступен в моделях Claude 4 и Claude Sonnet 3.7.text_editor_20250728
для моделей Claude 4 не включает команду undo_edit
. Если вам требуется эта функциональность, вам нужно будет использовать Claude Sonnet 3.7 или Sonnet 3.5 с их соответствующими версиями инструментов.str_replace_based_edit_tool
) Claude, используя Messages API.Вы можете дополнительно указать параметр max_characters
для контроля усечения при просмотре больших файлов.max_characters
совместим только с text_editor_20250728
и более поздними версиями инструмента текстового редактора.Предоставьте Claude инструмент текстового редактора и пользовательский запрос
Claude использует инструмент для изучения файлов или каталогов
view
для изучения содержимого файлов или списка содержимого каталоговtool_use
с командой view
Выполните команду view и верните результаты
max_characters
был указан в конфигурации инструмента, усеките содержимое файла до этой длиныuser
, содержащим блок содержимого tool_result
Claude использует инструмент для изменения файлов
str_replace
, для внесения изменений или insert
для добавления текста в определенном номере строки.str_replace
, Claude создает правильно отформатированный запрос использования инструмента со старым текстом и новым текстом для заменыВыполните редактирование и верните результаты
Claude предоставляет свой анализ и объяснение
view
позволяет Claude изучать содержимое файла или перечислять содержимое каталога. Она может читать весь файл или определенный диапазон строк.
Параметры:
command
: Должно быть “view”path
: Путь к файлу или каталогу для просмотраview_range
(необязательно): Массив из двух целых чисел, указывающих номера начальной и конечной строк для просмотра. Номера строк индексируются с 1, и -1 для конечной строки означает чтение до конца файла. Этот параметр применяется только при просмотре файлов, а не каталогов.Примеры команд view
str_replace
позволяет Claude заменить определенную строку в файле новой строкой. Это используется для внесения точных правок.
Параметры:
command
: Должно быть “str_replace”path
: Путь к файлу для измененияold_str
: Текст для замены (должен точно совпадать, включая пробелы и отступы)new_str
: Новый текст для вставки вместо старого текстаПример команды str_replace
create
позволяет Claude создать новый файл с указанным содержимым.
Параметры:
command
: Должно быть “create”path
: Путь, где должен быть создан новый файлfile_text
: Содержимое для записи в новый файлПример команды create
insert
позволяет Claude вставить текст в определенном месте в файле.
Параметры:
command
: Должно быть “insert”path
: Путь к файлу для измененияinsert_line
: Номер строки, после которой нужно вставить текст (0 для начала файла)new_str
: Текст для вставкиПример команды insert
undo_edit
позволяет Claude отменить последнее редактирование, сделанное в файле.
text_editor_20250728
.command
: Должно быть “undo_edit”path
: Путь к файлу, последнее редактирование которого должно быть отмененоПример команды undo_edit
view
включает содержимое файла с номерами строк, добавленными к каждой строке (например, “1: def is_prime(n):”). Номера строк не обязательны, но они необходимы для успешного использования параметра view_range
для изучения определенных разделов файлов и параметра insert_line
для добавления содержимого в точных местах.str_replace
для ее исправления:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
Инициализируйте вашу реализацию редактора
Обработайте вызовы инструмента редактора
Реализуйте меры безопасности
Обработайте ответы Claude
Файл не найден
tool_result
:Множественные совпадения для замены
str_replace
Claude соответствует нескольким местам в файле, верните соответствующее сообщение об ошибке:Нет совпадений для замены
str_replace
Claude не соответствует никакому тексту в файле, верните соответствующее сообщение об ошибке:Ошибки разрешений
Предоставляйте четкий контекст
Будьте явными в отношении путей к файлам
Создавайте резервные копии перед редактированием
Осторожно обрабатывайте уникальную замену текста
Проверяйте изменения
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 |
Дата | Версия | Изменения |
---|---|---|
28 июля 2025 | text_editor_20250728 | Выпуск обновленного инструмента текстового редактора, который исправляет некоторые проблемы и добавляет необязательный параметр max_characters . В остальном он идентичен text_editor_20250429 . |
29 апреля 2025 | text_editor_20250429 | Выпуск инструмента текстового редактора для Claude 4. Эта версия удаляет команду undo_edit , но сохраняет все остальные возможности. Имя инструмента было обновлено, чтобы отразить его архитектуру на основе str_replace. |
13 марта 2025 | text_editor_20250124 | Введение автономной документации инструмента текстового редактора. Эта версия оптимизирована для Claude Sonnet 3.7, но имеет идентичные возможности с предыдущей версией. |
22 октября 2024 | text_editor_20241022 | Первоначальный выпуск инструмента текстового редактора с Claude Sonnet 3.5 (устарел). Предоставляет возможности для просмотра, создания и редактирования файлов через команды view , create , str_replace , insert и undo_edit . |