Инструмент текстового редактора
Узнайте, как использовать инструмент текстового редактора Claude для просмотра и изменения текстовых файлов, помогая отлаживать, исправлять и улучшать ваш код или другие текстовые документы.
Claude может использовать определенный Anthropic инструмент текстового редактора для просмотра и изменения текстовых файлов, помогая вам отлаживать, исправлять и улучшать ваш код или другие текстовые документы. Это позволяет Claude напрямую взаимодействовать с вашими файлами, предоставляя практическую помощь, а не просто предлагая изменения.
Перед использованием инструмента текстового редактора
Используйте совместимую модель
Инструмент текстового редактора Anthropic доступен для нескольких моделей Claude:
- Claude 4 Opus & Sonnet:
text_editor_20250429
- 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 и Sonnet 3.7.
Более новый text_editor_20250429
для моделей Claude 4 не включает команду undo_edit
. Если вам требуется эта функциональность, вам нужно будет использовать Claude 3.7 или Sonnet 3.5 с их соответствующими версиями инструментов.
Оцените соответствие вашего случая использования
Некоторые примеры того, когда использовать инструмент текстового редактора:
- Отладка кода: Пусть Claude выявляет и исправляет ошибки в вашем коде, от синтаксических ошибок до логических проблем.
- Рефакторинг кода: Позвольте Claude улучшить структуру вашего кода, читаемость и производительность через целевые правки.
- Генерация документации: Попросите Claude добавить строки документации, комментарии или README файлы в вашу кодовую базу.
- Создание тестов: Пусть Claude создает модульные тесты для вашего кода на основе его понимания реализации.
Используйте инструмент текстового редактора
Предоставьте инструмент текстового редактора (названный str_replace_based_edit_tool
) Claude, используя Messages API:
Предоставьте инструмент текстового редактора (названный str_replace_based_edit_tool
) Claude, используя Messages API:
Предоставьте инструмент текстового редактора (названный str_replace_editor
) Claude, используя Messages API:
Предоставьте инструмент текстового редактора (названный str_replace_editor
) Claude, используя Messages API:
Инструмент текстового редактора может использоваться следующим образом:
Предоставьте Claude инструмент текстового редактора и пользовательский запрос
- Включите инструмент текстового редактора в ваш API запрос
- Предоставьте пользовательский запрос, который может потребовать изучения или изменения файлов, например “Можете ли вы исправить синтаксическую ошибку в моем коде?”
Claude использует инструмент для изучения файлов или каталогов
- Claude оценивает, что ему нужно посмотреть, и использует команду
view
для изучения содержимого файлов или списка содержимого каталогов - Ответ API будет содержать блок содержимого
tool_use
с командойview
Выполните команду view и верните результаты
- Извлеките путь к файлу или каталогу из запроса использования инструмента Claude
- Прочитайте содержимое файла или перечислите содержимое каталога и верните их Claude
- Верните результаты 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_20250429
.
Параметры:
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_20250429"
- 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) | 700 tokens |
Для более подробной информации о ценообразовании инструментов см. Ценообразование использования инструментов.
Интегрируйте инструмент текстового редактора с другими инструментами
Инструмент текстового редактора может использоваться вместе с другими инструментами Claude. При объединении инструментов убедитесь, что вы:
- Сопоставляете версию инструмента с используемой моделью
- Учитываете дополнительное использование токенов для всех инструментов, включенных в ваш запрос
Журнал изменений
Дата | Версия | Изменения |
---|---|---|
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 для улучшения вашего рабочего процесса разработки и производительности.