Как разобрать чужую кодовую базу в Claude Code без перегрузки контекста: пошаговый алгоритм
Официальный сценарий Anthropic по исследованию архитектуры, поиску зависимостей и трассировке логики от фронтенда до базы данных.
При первом переходе в незнакомый проект разработчики часто пытаются скормить ИИ-ассистенту репозиторий целиком или открывают десятки файлов подряд. В больших проектах это забивает контекстное окно служебным кодом, расходует лимиты токенов и приводит к галлюцинациям модели уже к десятому сообщению.
В официальной документации Claude Code компания Anthropic опубликовала сценарии Common workflows — алгоритмы для первого знакомства с кодовой базой, трассировки архитектурных связей и безопасного планирования изменений.
Шаг 1. Первичная карта архитектуры через обзорный промпт
Вместо ручного чтения файлов по алфавиту старт начинается в корне репозитория с запуска консольного агента:
Первый запрос направлен не на решение задачи, а на построение ментальной модели системы:
- Claude Code не считывает все исходники подряд. Агент анализирует структуру каталогов, манифесты сборки (package.json, Cargo.toml, pyproject.toml) и конфигурации контейнеров.
- На основе найденных компонентов модель определяет архитектурный паттерн: монорепозиторий, микросервисы, чистая архитектура или MVC.
- В ответе формируется карта подсистем: точка входа приложения, транспортный слой (REST, GraphQL, gRPC), бизнес-логика и слой доступа к данным.
Шаг 2. Трассировка сквозных сценариев
После получения верхнеуровневой карты исследование переходит к конкретным цепочкам выполнения. Попытка задать общий вопрос вроде «как всё устроено» приводит к абстрактному ответу, поэтому запросы формулируются вокруг конкретного пути данных:
- Поиск точки входа: Where does an incoming API request enter the service, and what middleware stack processes it?
- Сквозная цепочка: Trace the user authentication flow from the route handler down to the session storage in the database.
- Слой валидации: Where do we validate incoming payload schemas, and how are validation errors handled?
- Инфраструктура тестов: Where are integration tests located, and what command runs the test suite locally?
Такой подход ограничивает чтение кода только файлами, задействованными в конкретном сценарии, сохраняя до 80% рабочего контекста свободным для дальнейшей работы.
Шаг 3. Делегирование глубокого поиска субагентам
Когда необходимо проверить сложную подсистему (например, механизм инвалидации кэша или алгоритм расчета тарифов), последовательное чтение десятков файлов перегрузит историю диалога. Для таких задач Anthropic предусмотрела изоляцию через субагентов.
- Субагент запускается в изолированном контекстном окне со своим собственным стеком инструментов чтения (Read, Grep, Glob).
- Внутри своего процесса он открывает и анализирует файлы, не загрязняя основную историю сессии техническими логами чтения.
- После завершения анализа субагент возвращает в основной чат только компактную фактологическую сводку с указанием ключевых файлов и функций.
Шаг 4. Безопасное исследование в режиме планирования
Если цель знакомства с репозиторием — подготовить доработку или исправить ошибку, перед внесением правок включается режим планирования (Plan Mode):
Переключить режим можно и в активной сессии через сочетание клавиш Shift + Tab. В строке состояния отображается индикатор ⏸ plan mode on.
- В режиме планирования Claude Code имеет право только читать файлы и выполнять безопасные поисковые команды.
- Любые попытки изменить код, создать файл или запустить модифицирующую команду блокируются средой исполнения.
- Модель изучает логику и выдаёт пошаговый план изменений со ссылками на затронутые модули, который подтверждается разработчиком перед выполнением.
Шаг 5. Сохранение знаний и управление сессиями
Чтобы не тратить контекст на повторные объяснения архитектуры при следующих запусках, полученные выводы фиксируются на диске и в истории сессий:
- Фиксация в файлах: запрос Save the architecture summary and directory map to ARCH_OVERVIEW.md сохраняет структурированное описание в репозитории.
- Сжатие истории: команда /compact суммирует накопленный контекст диалога, удаляя промежуточные поисковые логи и освобождая окно под следующие задачи.
- Возобновление работы: команда claude --continue возвращает последнюю активную сессию в текущей папке с сохранением всех контекстных выводов, а claude --resume открывает список предыдущих сессий с историей.
- Параллельные ветки: команда claude --worktree feature-refactor разворачивает изолированное рабочее дерево git, исключая конфликт файлов между параллельными задачами.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».