codebase-search — субагент для Claude Code: поиск кода и файлов
Субагент codebase-search ищет, где в проекте лежит нужная логика, и возвращает абсолютные пути с объяснением потока.
лицензия не указана ★ 1 064 обновлён 2026-01-21
.claude/agents/codebase-search.mdЧто делает codebase-search
Субагент отвечает на вопросы «где это лежит» и «кто это вызывает». Первым делом он запускает несколько инструментов сразу (Grep, Glob, LSP), а не по очереди, поэтому один запрос покрывает и текстовые совпадения, и определения символов.
Работает он на модели haiku и только читает: создать, изменить или удалить файл не может. За правки отвечает основной агент, а этот приносит карту места. Внутри есть доступ к MCP-серверам context7, exa и grep-app — через последний ищутся примеры в публичных репозиториях GitHub. Таким результатам доверять сразу не стоит: они бывают из других версий библиотек, и агент сверяет их с локальным поиском.
Ответ всегда заканчивается блоком <results> с абсолютными путями, разбором найденного и подсказкой, что делать дальше.
Какие задачи решает
- найти, где реализована авторизация
- собрать все места вызова функции перед рефакторингом
- понять, какие файлы отвечают за обработку платежей
- получить абсолютные пути, по которым сразу переходишь в редакторе
- посмотреть, как ту же задачу решили в открытых репозиториях
Примеры запросов агенту
- Найди, где реализована аутентификация, и объясни поток
- Собери все файлы, где вызывается
validateUser - Покажи, какие файлы обрабатывают платежи
Как установить codebase-search
Вручную: положить файлы
.claude/agents/codebase-search.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/codebase-search.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/codebase-search.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о codebase-search
Как установить codebase-search в Claude Code?
Файл агента кладут в проект по пути .claude/agents/codebase-search.md.
Что делает codebase-search?
Ищет файлы и реализации по запросу и отвечает абсолютными путями, коротким разбором и следующими шагами.
Что нужно для поиска по GitHub?
Примеры из публичных репозиториев идут через MCP-сервер grep-app, рядом подключены context7 и exa. Без этих серверов останутся локальные Grep, Glob и LSP.