Работа с файлами

Claude Code взаимодействует с вашим проектом не напрямую, а через набор файловых инструментов (file tools): Read, Write и Edit. Это специализированные функции, которые модель вызывает по мере необходимости, а среда выполнения (harness) исполняет их и возвращает результат обратно в контекст. Такой подход важен по двум причинам. Во-первых, модель не «угадывает» содержимое файлов из памяти — она читает реальный код прямо перед изменением, поэтому правки опираются на актуальное состояние репозитория. Во-вторых, каждое действие становится явным и проверяемым: вы видите, какой файл прочитан, что именно создаётся и какая строка заменяется.

Read — это точка входа. Инструмент загружает содержимое файла в контекст модели и понимает разные форматы: текстовый код (.ts, .py, .md), изображения (.png, .jpg), PDF и Jupyter-ноутбуки (.ipynb). По умолчанию Read читает до 2000 строк; для крупных файлов применяются параметры offset и limit, чтобы загрузить нужный фрагмент и не переполнять контекстное окно. Именно поэтому в примерах на этой странице запросы вида «Прочитай файл src/auth.ts» сначала приводят к вызову Read, а уже потом к анализу или редактированию.

Edit делает точечную замену: вы задаёте old_string (фрагмент, который нужно заменить) и new_string (на что заменить). Блок кода выше — old_string: "return null;" → new_string: "return data ?? null;" — иллюстрирует ровно это: одна строка меняется без переписывания всего файла. Ключевое ограничение — old_string должен быть уникальным в пределах файла, иначе инструмент не поймёт, какое вхождение менять, и вернёт ошибку. Поэтому при неоднозначности нужно включать в old_string больше контекста (соседние строки, отступы).

Write создаёт новый файл или полностью перезаписывает существующий — как в примере с src/components/Button.tsx на этой странице. Главная ошибка новичков — использовать Write для правки существующего файла: это сотрёт всё прежнее содержимое. Практическое правило простое: для изменений в существующих файлах — Edit (он показывает diff, безопаснее и сохраняет форматирование), для создания с нуля — Write. И помните: Edit и Write требуют, чтобы файл был прочитан через Read заранее — это страховка от слепых правок.