codebase-explorer — субагент для Claude Code: обзор проекта
Исследует незнакомый проект: находит стек, архитектуру, точки входа и поток данных. По запросу сохраняет выводы в CLAUDE.md.
npx claude-code-templates@latest --agent development-tools/codebase-explorerЧто делает codebase-explorer
Субагент читает файлы проекта и историю Git, затем разбирает архитектуру, зависимости, маршрутизацию, слой данных и используемые паттерны. Результат оформляет как структурированную модель проекта: с ключевыми каталогами, точками входа, рабочими командами и замеченными особенностями.
После обзора он может спросить, нужно ли создать CLAUDE.md с контекстом для будущих сессий; если вы согласитесь, файл появится в корне проекта. Для работы ему доступны Read, Write, Edit, Bash, Grep и Glob. Он ориентируется на существующие файлы и пропускает отсутствующие, а найденный CLAUDE.md сначала читает и предлагает обновить, а не заменить.
Какие задачи решает
- разобраться в архитектуре только что клонированного проекта
- найти точки входа и маршруты приложения
- составить карту зависимостей и слоя данных
- сохранить сведения о проекте в
CLAUDE.md
Примеры запросов агенту
- Разбери этот проект и объясни, как он устроен.
- Я только что клонировал репозиторий. Найди архитектуру и точки входа.
- Составь обзор проекта и предложи сохранить его в
CLAUDE.md.
Как установить codebase-explorer
1Через claude-code-templates
npx claude-code-templates@latest --agent development-tools/codebase-explorer2Вручную: положить файлы
.claude/agents/codebase-explorer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/codebase-explorer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/codebase-explorer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о codebase-explorer
Как установить codebase-explorer в Claude Code?
Выполните npx claude-code-templates@latest --agent development-tools/codebase-explorer. Файл субагента размещается по пути .claude/agents/codebase-explorer.md.
Что делает codebase-explorer?
Он исследует файлы проекта и собирает структурированный обзор стека, архитектуры, зависимостей и потока данных. По вашему согласию создаёт CLAUDE.md в корне.
Что произойдёт, если в проекте уже есть CLAUDE.md?
Субагент сначала прочитает существующий файл и предложит обновить его, а не заменять.
