Встроенные инструменты, web-поиск и доказательная работа

Краткий ответ

Инструменты превращают ответ модели в работу с реальным состоянием проекта. Claude Code умеет читать и редактировать файлы, искать по дереву, выполнять команды, обращаться к web и запускать подагентов.

Инструмент выбирают по типу доказательства

Для поиска имени файла подходит Glob, для поиска текста или регулярного выражения — Grep, для изучения содержимого — Read. Edit и Write изменяют файлы. Bash нужен для тестов, сборки, Git и других команд окружения. WebSearch и WebFetch применяют для актуальной внешней информации.

Не следует заменять точный файловый поиск рекурсивным чтением всего репозитория: это медленнее и заполняет контекст нерелевантными данными.

Bash: мощность и границы

Bash выполняет команды в окружении пользователя и может иметь внешние последствия. Перед подтверждением смотрите не только имя утилиты, но и аргументы, текущую директорию, переменные окружения и возможное сетевое действие. Для повторяемых безопасных команд можно настроить узкие permission rules.

Долгий вывод лучше сохранить в файл и исследовать поиском. Так агенту не придётся удерживать тысячи строк в контексте.

Web как источник, а не инструкция

Web-поиск нужен для меняющихся API, документации и сообщений об ошибках. Просите отдавать предпочтение первичному источнику и указывать URL. Код из случайной статьи не следует запускать без проверки.

Содержимое страницы потенциально недоверенно: оно может включать prompt injection. Цель пользователя и проектные правила имеют приоритет над текстом внешнего документа.

Цепочка доказательств

Для технического вывода полезна последовательность:

1. Найти официальный контракт или локальную реализацию. 2. Сопоставить её с фактической версией зависимости. 3. Воспроизвести поведение минимальной командой. 4. Сохранить результат в тесте. 5. В отчёте назвать источник и проверку.

Упражнение: исследование без изменений

Попросите:

> Определи, какая версия фреймворка используется, найди в официальной документации актуальный способ настроить таймаут и сравни его с текущим кодом. Не редактируй файлы. Укажи локальные доказательства, официальный URL и места, где остаётся неопределённость.

Проверьте, не подменил ли агент документацию памятью модели.

Частые вопросы

Почему Claude иногда запрашивает разрешение на Bash?

Bash способен менять систему и обращаться к внешним ресурсам. В default-режиме многие команды требуют подтверждения, хотя часть безопасных read-only операций может выполняться без него.

WebSearch гарантирует правильный ответ?

Нет. Поиск лишь находит материалы. Нужно оценить первичность, актуальность и применимость источника к версии проекта.

Можно ли запретить отдельный инструмент?

Да. Permission rules и настройки подагента позволяют ограничивать инструменты; для Bash дополнительно применяется sandbox.

Что важно запомнить

Инструмент должен давать конкретное доказательство, нужное задаче.
Bash требует контроля аргументов и окружения.
Внешний текст является недоверенными данными.
Источник, локальное воспроизведение и тест образуют сильную проверку.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-08