Инструмент текстового редактора
Позволяет Claude просматривать и изменять текстовые файлы, помогая отлаживать, исправлять и улучшать код или другие текстовые документы.
Claude может использовать определенный Anthropic инструмент текстового редактора для просмотра и изменения текстовых файлов, помогая вам отлаживать, исправлять и улучшать ваш код или другие текстовые документы. Это позволяет Claude напрямую взаимодействовать с вашими файлами, предоставляя практическую помощь, а не просто предлагая изменения.
Перед использованием инструмента текстового редактора
Используйте совместимую модель
Инструмент текстового редактора Anthropic доступен для нескольких моделей Claude:
- Claude Sonnet 4, Opus 4 и Opus 4.1:
text_editor_20250728
- Claude Sonnet 3.7:
text_editor_20250124
- Claude Sonnet 3.5 (устарел):
text_editor_20241022
Claude Sonnet 3.5 (устарел) требует заголовок бета-версии 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 с их соответствующими версиями инструментов.
Оцените соответствие вашего случая использования
Некоторые примеры того, когда использовать инструмент текстового редактора:
- Отладка кода: Попросите Claude выявить и исправить ошибки в вашем коде, от синтаксических ошибок до логических проблем.
- Рефакторинг кода: Позвольте Claude улучшить структуру, читаемость и производительность вашего кода через целевые правки.
- Генерация документации: Попросите Claude добавить строки документации, комментарии или файлы README в вашу кодовую базу.
- Создание тестов: Попросите Claude создать модульные тесты для вашего кода на основе его понимания реализации.
Использование инструмента текстового редактора
Предоставьте инструмент текстового редактора (названный str_replace_based_edit_tool
) Claude, используя Messages API.
Вы можете дополнительно указать параметр max_characters
для контроля усечения при просмотре больших файлов.
max_characters
совместим только с text_editor_20250728
и более поздними версиями инструмента текстового редактора.
Предоставьте инструмент текстового редактора (названный str_replace_based_edit_tool
) Claude, используя Messages API.
Вы можете дополнительно указать параметр max_characters
для контроля усечения при просмотре больших файлов.
max_characters
совместим только с text_editor_20250728
и более поздними версиями инструмента текстового редактора.
Предоставьте инструмент текстового редактора (названный str_replace_editor
) Claude, используя Messages API:
Предоставьте инструмент текстового редактора (названный str_replace_editor
) Claude, используя Messages API:
Инструмент текстового редактора может использоваться следующим образом:
Предоставьте Claude инструмент текстового редактора и пользовательский запрос
- Включите инструмент текстового редактора в ваш API-запрос
- Предоставьте пользовательский запрос, который может потребовать изучения или изменения файлов, например “Можете ли вы исправить синтаксическую ошибку в моем коде?”
Claude использует инструмент для изучения файлов или каталогов
- Claude оценивает, что ему нужно посмотреть, и использует команду
view
для изучения содержимого файлов или списка содержимого каталогов - Ответ API будет содержать блок содержимого
tool_use
с командойview
Выполните команду view и верните результаты
- Извлеките путь к файлу или каталогу из запроса использования инструмента Claude
- Прочитайте содержимое файла или перечислите содержимое каталога
- Если параметр
max_characters
был указан в конфигурации инструмента, усеките содержимое файла до этой длины - Верните результаты Claude, продолжив разговор новым сообщением
user
, содержащим блок содержимогоtool_result
Claude использует инструмент для изменения файлов
- После изучения файла или каталога Claude может использовать команду, такую как
str_replace
, для внесения изменений илиinsert
для добавления текста в определенном номере строки. - Если Claude использует команду
str_replace
, Claude создает правильно отформатированный запрос использования инструмента со старым текстом и новым текстом для замены
Выполните редактирование и верните результаты
- Извлеките путь к файлу, старый текст и новый текст из запроса использования инструмента Claude
- Выполните замену текста в файле
- Верните результаты Claude
Claude предоставляет свой анализ и объяснение
- После изучения и возможного редактирования файлов Claude предоставляет полное объяснение того, что он нашел и какие изменения внес
Команды инструмента текстового редактора
Инструмент текстового редактора поддерживает несколько команд для просмотра и изменения файлов:
view
Команда view
позволяет Claude изучать содержимое файла или перечислять содержимое каталога. Она может читать весь файл или определенный диапазон строк.
Параметры:
command
: Должно быть “view”path
: Путь к файлу или каталогу для просмотраview_range
(необязательно): Массив из двух целых чисел, указывающих номера начальной и конечной строк для просмотра. Номера строк индексируются с 1, и -1 для конечной строки означает чтение до конца файла. Этот параметр применяется только при просмотре файлов, а не каталогов.
str_replace
Команда str_replace
позволяет Claude заменить определенную строку в файле новой строкой. Это используется для внесения точных правок.
Параметры:
command
: Должно быть “str_replace”path
: Путь к файлу для измененияold_str
: Текст для замены (должен точно совпадать, включая пробелы и отступы)new_str
: Новый текст для вставки вместо старого текста
create
Команда create
позволяет Claude создать новый файл с указанным содержимым.
Параметры:
command
: Должно быть “create”path
: Путь, где должен быть создан новый файлfile_text
: Содержимое для записи в новый файл
insert
Команда insert
позволяет Claude вставить текст в определенном месте в файле.
Параметры:
command
: Должно быть “insert”path
: Путь к файлу для измененияinsert_line
: Номер строки, после которой нужно вставить текст (0 для начала файла)new_str
: Текст для вставки
undo_edit
Команда undo_edit
позволяет Claude отменить последнее редактирование, сделанное в файле.
Эта команда доступна только в Claude Sonnet 3.7 и Claude Sonnet 3.5 (устарел). Она не поддерживается в моделях Claude 4, использующих text_editor_20250728
.
Параметры:
command
: Должно быть “undo_edit”path
: Путь к файлу, последнее редактирование которого должно быть отменено
Пример: Исправление синт
аксической ошибки с помощью инструмента текстового редактора
Этот пример демонстрирует, как модели Claude 4 используют инструмент текстового редактора для исправления синтаксической ошибки в файле Python.
Сначала ваше приложение предоставляет Claude инструмент текстового редактора и запрос на исправление синтаксической ошибки:
Claude сначала будет использовать инструмент текстового редактора для просмотра файла:
Ваше приложение должно затем прочитать файл и вернуть его содержимое Claude:
Номера строк
В приведенном выше примере результат инструмента view
включает содержимое файла с номерами строк, добавленными к каждой строке (например, “1: def is_prime(n):”). Номера строк не обязательны, но они необходимы для успешного использования параметра view_range
для изучения определенных разделов файлов и параметра insert_line
для добавления содержимого в точных местах.
Claude выявит синтаксическую ошибку и использует команду str_replace
для ее исправления:
Ваше приложение должно затем внести правку и вернуть результат:
Наконец, Claude предоставит полное объяснение исправления:
Этот пример демонстрирует, как модели Claude 4 используют инструмент текстового редактора для исправления синтаксической ошибки в файле Python.
Сначала ваше приложение предоставляет Claude инструмент текстового редактора и запрос на исправление синтаксической ошибки:
Claude сначала будет использовать инструмент текстового редактора для просмотра файла:
Ваше приложение должно затем прочитать файл и вернуть его содержимое Claude:
Номера строк
В приведенном выше примере результат инструмента view
включает содержимое файла с номерами строк, добавленными к каждой строке (например, “1: def is_prime(n):”). Номера строк не обязательны, но они необходимы для успешного использования параметра view_range
для изучения определенных разделов файлов и параметра insert_line
для добавления содержимого в точных местах.
Claude выявит синтаксическую ошибку и использует команду str_replace
для ее исправления:
Ваше приложение должно затем внести правку и вернуть результат:
Наконец, Claude предоставит полное объяснение исправления:
Этот пример демонстрирует, как Claude Sonnet 3.7 использует инструмент текстового редактора для исправления синтаксической ошибки в файле Python.
Сначала ваше приложение предоставляет Claude инструмент текстового редактора и запрос на исправление синтаксической ошибки:
Примеры Claude Sonnet 3.7 следуют тому же формату, что и примеры Claude 4 выше, используя те же вызовы инструментов и ответы, но с типом инструмента text_editor_20250124
и именем str_replace_editor
.
Реализация инструмента текстового редактора
Инструмент текстового редактора реализован как инструмент без схемы. При использовании этого инструмента вам не нужно предоставлять входную схему, как с другими инструментами; схема встроена в модель Claude и не может быть изменена.
Тип инструмента зависит от версии модели:
- Claude 4:
type: "text_editor_20250728"
- Claude Sonnet 3.7:
type: "text_editor_20250124"
- Claude Sonnet 3.5 (устарел):
type: "text_editor_20241022"
Инициализируйте вашу реализацию редактора
Создайте вспомогательные функции для обработки файловых операций, таких как чтение, запись и изменение файлов. Рассмотрите реализацию функциональности резервного копирования для восстановления после ошибок.
Обработайте вызовы инструмента редактора
Создайте функцию, которая обрабатывает вызовы инструментов от Claude на основе типа команды:
Реализуйте меры безопасности
Добавьте валидацию и проверки безопасности:
- Валидируйте пути к файлам для предотвращения обхода каталогов
- Создавайте резервные копии перед внесением изменений
- Обрабатывайте ошибки корректно
- Реализуйте проверки разрешений
Обработайте ответы Claude
Извлеките и обработайте вызовы инструментов из ответов Claude:
При реализации инструмента текстового редактора имейте в виду:
- Безопасность: Инструмент имеет доступ к вашей локальной файловой системе, поэтому реализуйте надлежащие меры безопасности.
- Резервное копирование: Всегда создавайте резервные копии перед разрешением правок важных файлов.
- Валидация: Валидируйте все входные данные для предотвращения непреднамеренных изменений.
- Уникальное соответствие: Убедитесь, что замены соответствуют точно одному месту, чтобы избежать непреднамеренных правок.
Обработка ошибок
При использовании инструмента текстового редактора могут возникнуть различные ошибки. Вот руководство по их обработке:
Следуйте лучшим практикам реализации
Ценообразование и использование токенов
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) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5 (deprecated)) | 700 tokens |
Для более подробной информации о ценообразовании инструментов см. Ценообразование использования инструментов.
Интеграция инструмента текстового редактора с другими инструментами
Инструмент текстового редактора может использоваться вместе с другими инструментами Claude. При объединении инструментов убедитесь, что вы:
- Сопоставляете версию инструмента с используемой моделью
- Учитываете дополнительное использование токенов для всех инструментов, включенных в ваш запрос
Журнал изменений
Дата | Версия | Изменения |
---|---|---|
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 . |
Следующие шаги
Вот несколько идей о том, как использовать инструмент текстового редактора более удобными и мощными способами:
- Интегрируйте с вашим рабочим процессом разработки: Встройте инструмент текстового редактора в ваши инструменты разработки или IDE
- Создайте систему обзора кода: Попросите Claude просмотреть ваш код и внести улучшения
- Создайте помощника по отладке: Создайте систему, где Claude может помочь вам диагностировать и исправить проблемы в вашем коде
- Реализуйте конвертацию форматов файлов: Позвольте Claude помочь вам конвертировать файлы из одного формата в другой
- Автоматизируйте документацию: Настройте рабочие процессы для автоматического документирования вашего кода Claude
По мере создания приложений с инструментом текстового редактора мы с нетерпением ждем, как вы будете использовать возможности Claude для улучшения вашего рабочего процесса разработки и производительности.