Что агент видит при старте
Claude Code не загружает весь репозиторий в контекст сразу. Вместо этого он:
- Читает
CLAUDE.md из корня (и вложенных папок) — это первое, что попадает в контекст.
- Учитывает
.gitignore — node_modules, .next, dist и прочее не индексируются.
- Сэмплирует структуру: смотрит дерево файлов, открывает то, что релевантно вашему запросу, по мере необходимости (lazy reading).
Поэтому в гигантском монорепо агент не «захлёбывается»: он подтягивает файлы прицельно под задачу.
Спрашиваем об архитектуре
Хороший первый запрос в незнакомом проекте:
Опиши архитектуру: где точка входа, как организованы слои, где бизнес-логика и где доступ к БД. Назови ключевые файлы.
Агент пройдёт по дереву, откроет точки входа, конфиги, схему БД и даст карту. Дальше уточняйте по конкретным модулям.
Чтение нескольких файлов сразу
Можно явно направить внимание:
Прочитай src/auth/*.ts и объясни, как устроен поток логина от роута до сессии.
Агент откроет все совпадения и проследит цепочку вызовов между файлами — то, чего автодополнение не умеет.
Сужение области: include / exclude
Когда репозиторий большой или есть «шумные» директории, ограничьте область:
claude --include "src/**" --exclude "**/*.test.ts" --exclude "legacy/**"
--include — белый список путей, в которых агенту разрешено работать и читать.
--exclude — чёрный список: сгенерированный код, вендоринг, легаси, который не нужно трогать.
Это и ускоряет работу, и снижает риск, что агент уйдёт править не то.
Большие репозитории: практика
- Сначала спросите про высокоуровневую структуру, потом углубляйтесь — не просите «прочитай весь проект».
- Указывайте конкретные пути и модули в запросе — это резко сокращает лишнее чтение.
- Держите актуальный
CLAUDE.md с картой проекта (об этом — следующий урок): агент будет ориентироваться без повторного сканирования.
.gitignore — ваш друг: если build-артефакты и кэши в нём, агент их не тронет.
Почему это важно
Контекст модели конечен. Чем точнее вы направляете чтение (пути, include/exclude, CLAUDE.md), тем больше «бюджета» остаётся на саму задачу, а не на блуждание по файлам. Управление вниманием агента — ключевой навык в больших кодовых базах.