Поиск и навигация

Как Claude Code находит код в проекте

Прежде чем редактировать код, агенту нужно понять, что вообще лежит в проекте. Для этого Claude Code использует два дополняющих друг друга инструмента поиска: Glob ищет файлы по имени и пути, а Grep ищет текст внутри файлов. Это не одно и то же: Glob отвечает на вопрос «где лежат нужные файлы?», а Grep — на вопрос «в каких файлах встречается вот эта строка или шаблон (regex)?». Агент сам решает, какой инструмент применить, и часто запускает их по очереди, не заставляя вас вручную перебирать директории.

Шаблоны Glob на этой странице — это привычные glob-выражения. Запись **/*.ts означает «любой файл с расширением .ts на любой глубине вложенности»; двойная звёздка ** раскрывается в произвольное число подпапок, а фигурные скобки {js,ts} перечисляют альтернативы. Восклицательный знак в начале (например !**/node_modules/**) исключает каталог из выдачи. Результаты Glob возвращаются отсортированными по времени изменения, поэтому свежие файлы оказываются наверху — это удобно, когда ищешь то, что недавно правили.

Glob и Grep: разделение труда

Grep построен на ripgrep (rg) — очень быстром поисковике по регулярным выражениям, который уважает .gitignore и пропускает бинарные файлы. Английские блоки на этой странице показывают типовые шаблоны: function.*async находит объявления асинхронных функций, TODO|FIXME|HACK собирает все маркеры-напоминания, а console\.log ловит отладочные вызовы (точка экранирована, чтобы означать буквальную точку, а не «любой символ»). Параметр output_mode управляет тем, что вернётся: content — сами строки с совпадениями, files_with_matches — только пути файлов (быстрее всего для первичного обзора), count — число совпадений. Флаг -i отключает учёт регистра, -C 3 добавляет по три строки контекста вокруг находки, а glob="*.ts" сужает поиск до нужного типа файлов.

Конкретный пример

Допустим, вы просите: «найди, где в компонентах используется useState». Агент сначала применит Glob (src/components/**/*.tsx), чтобы очертить множество компонентов, а затем Grep с фильтром glob="*.tsx" по строке useState — и вернёт список файлов с номерами строк. Главные ошибки новичков: искать regex там, где достаточно простой строки (и наоборот — забыть экранировать спецсимволы вроде ., (, {); запускать Grep без фильтра по проекту с тысячами файлов вместо files_with_matches; и забывать, что для исследования незнакомой кодовой базы лучше делегировать поиск суб-агенту через Task с агентом Explore, чтобы не засорять основной контекст.