Как разобрать чужую кодовую базу в Claude Code без перегрузки контекста: пошаговый алгоритм

Официальный сценарий Anthropic по исследованию архитектуры, поиску зависимостей и трассировке логики от фронтенда до базы данных. При первом переходе в незнакомый проект разработчики часто пытаются скормить ИИ-ассистенту репозиторий целиком или открывают десятки файлов подряд. В больших проектах это забивает контекстное окно служебным кодом, расходует лимиты токенов и приводит к галлюцинациям модели уже к десятому сообщению.

В официальной документации Claude Code компания Anthropic опубликовала сценарии Common workflows — алгоритмы для первого знакомства с кодовой базой, трассировки архитектурных связей и безопасного планирования изменений. Вместо ручного чтения файлов по алфавиту старт начинается в корне репозитория с запуска консольного агента: Первый запрос направлен не на решение задачи, а на построение ментальной модели системы: После получения верхнеуровневой карты исследование переходит к конкретным цепочкам выполнения. Попытка задать общий вопрос вроде «как всё устроено» приводит к абстрактному ответу, поэтому запросы формулируются вокруг конкретного пути данных: Такой подход ограничивает чтение кода только файлами, задействованными в конкретном сценарии, сохраняя до 80% рабочего контекста свободным для дальнейшей работы. Когда необходимо проверить сложную подсистему (например, механизм инвалидации кэша или алгоритм расчета тарифов), последовательное чтение десятков файлов перегрузит историю диалога. Для таких задач Anthropic предусмотрела изоляцию через субагентов. Если цель знакомства с репозиторием — подготовить доработку или исправить ошибку, перед внесением правок включается режим планирования (Plan Mode): Переключить режим можно и в активной сессии через сочетание клавиш Shift + Tab. В строке состояния отображается индикатор ⏸ plan mode on. Чтобы не тратить контекст на повторные объяснения архитектуры при следующих запусках, полученные выводы фиксируются на диске и в истории сессий: Пошаговая инструкция по созданию Markdown-манифестов с ограничением инструментов, маршрутизацией на дешевые модели и лимитом описаний в 15 000 токенов.

Источник: vc.ru — vc.ru/ai/3240812-kak-issledovat-kodovuyu-bazu-v-claude-code