18 встроенных инструментов

Что такое инструменты (tools) Claude Code

Инструменты (tools) — это набор действий, которые модель может вызывать, чтобы взаимодействовать с вашим компьютером: читать и редактировать файлы, искать по коду, запускать команды в терминале, обращаться к веб-страницам и планировать работу. Сама по себе языковая модель умеет только генерировать текст. Именно инструменты превращают Claude из чат-бота в агента, который реально меняет состояние проекта. Когда вы ставите задачу, модель не пишет ответ вслепую — она выбирает подходящий инструмент, вызывает его с конкретными аргументами, получает результат и решает, какой шаг сделать дальше. Этот цикл «решение → вызов инструмента → наблюдение результата» повторяется, пока задача не выполнена.

Как устроены категории инструментов

Встроенные инструменты сгруппированы по назначению, и интерактивный обозреватель ниже как раз показывает эти категории. Файловые инструменты — это Read (чтение файла), Edit (точечная замена строки в существующем файле) и Write (создание или полная перезапись файла). Поисковые инструменты — Glob ищет файлы по шаблону пути (например, src/**/*.tsx), а Grep ищет текст и регулярные выражения внутри файлов. Исполнение — Bash запускает команды в терминале (тесты, сборку, git), а Task делегирует работу отдельному субагенту с собственным контекстом. Веб-инструменты WebFetch и WebSearch подтягивают свежую информацию из интернета. А инструменты планирования — AskUserQuestion, TaskCreate и TaskUpdate — позволяют задать уточняющий вопрос и вести список задач. Английские названия инструментов лучше не переводить: именно так они называются в логах и документации.

Когда что использовать и типичные ошибки

Правило простое: для изменения существующего файла нужен Edit, а не Write — Write перезапишет файл целиком и сотрёт то, что вы не упомянули. Чтобы найти, где лежит код, используйте Grep и Glob, а не перебор файлов через Bash cat — это и быстрее, и дешевле по токенам. Тяжёлую или изолированную подзадачу разумно отдать в Task: субагент не засоряет основной контекст диалога. Главные подводные камни — давать модели слишком широкие права на Bash (опасные команды вроде rm -rf стоит запрещать через разрешения и хуки), а также вызывать Edit по файлу, который ещё не был прочитан через Read: без свежего содержимого замена строки не совпадёт и вызов завершится ошибкой. Конкретный пример рабочего цикла: Claude вызывает Grep по слову useAuth, находит нужный компонент, Read открывает файл, Edit заменяет одну функцию, и Bash запускает npm test, чтобы убедиться, что ничего не сломалось.