Как Claude Code собирает контекст и где это лежит
Когда стартует сессия, в окно контекста уезжает заметно больше, чем кажется на первый взгляд. Полезно понимать, что туда попадает и из каких источников
До того как ты вообще что-то напишешь, в контекст
уже загружено:
- Системный промпт и описания системных тулз Claude Code
- Содержимое CLAUDE.md - из домашки
(~/.claude/CLAUDE.md), из корня проекта (./CLAUDE.md) и из подпапок если они там есть. Все три уровня собираются в одну иерархию
- Auto-memory - то, что Claude Code сам сохранил о проекте между сессиями
- Имена и описания MCP-инструментов от подключенных серверов
- Метаинформация скиллов. Сами тела SKILL.md не грузятся пока ты скилл не вызовешь, НО метаинфа с описанием каждого скилла загружается сразу, чтобы знать, что их можно вызвать. Если у тебя 30 скиллов, а используешь за сессию ты один - 30 описаний все равно сидят в контексте
Дальше по ходу работы в окно доезжают чтения файлов, ответы Claude и path-scoped правила, которые подгружаются автоматически при чтении соответствующих файлов. Сабагенты при этом работают в отдельном
окне контекста - в основное возвращается только сжатый результат их работы
Чтобы посмотреть, что реально лежит в контексте прямо сейчас - команда /context, она показывает разбивку по категориям с процентами, см. скрин в шапке поста
А что AGENTS.md?
Распространенное заблуждение - что Claude Code читает AGENTS.md как fallback. Пока не читает.
AGENTS.md это открытый стандарт от OpenAI, его поддерживают Codex, Cursor, Amp, Gemini CLI, но Claude Code
автоматически его не подхватит
Issue висит открытой на github с августа 2025и собрала тысячи апвоутов
Если хочется единый источник правды для всех инструментов можно обыграть следующим образом:
- В CLAUDE.md написать одну строку @AGENTS.md - Claude Code умеет импорты и подтянет содержимое
- Сделать симлинк CLAUDE.md → AGENTS.md
- Повесить SessionStart-хук, который пробежится по всем AGENTS.md в репе и закинет их в контекст
На бусти готовили claude code
под питоновские проекты - можно брать за основу
И раз уж речь зашла про экономию контекста - апну пост про rtk, который сжимает вывод команд еще до того
как он попадет в окно
Когда стартует сессия, в окно контекста уезжает заметно больше, чем кажется на первый взгляд. Полезно понимать, что туда попадает и из каких источников
До того как ты вообще что-то напишешь, в контекст
уже загружено:
- Системный промпт и описания системных тулз Claude Code
- Содержимое CLAUDE.md - из домашки
(~/.claude/CLAUDE.md), из корня проекта (./CLAUDE.md) и из подпапок если они там есть. Все три уровня собираются в одну иерархию
- Auto-memory - то, что Claude Code сам сохранил о проекте между сессиями
- Имена и описания MCP-инструментов от подключенных серверов
- Метаинформация скиллов. Сами тела SKILL.md не грузятся пока ты скилл не вызовешь, НО метаинфа с описанием каждого скилла загружается сразу, чтобы знать, что их можно вызвать. Если у тебя 30 скиллов, а используешь за сессию ты один - 30 описаний все равно сидят в контексте
Дальше по ходу работы в окно доезжают чтения файлов, ответы Claude и path-scoped правила, которые подгружаются автоматически при чтении соответствующих файлов. Сабагенты при этом работают в отдельном
окне контекста - в основное возвращается только сжатый результат их работы
Чтобы посмотреть, что реально лежит в контексте прямо сейчас - команда /context, она показывает разбивку по категориям с процентами, см. скрин в шапке поста
А что AGENTS.md?
Распространенное заблуждение - что Claude Code читает AGENTS.md как fallback. Пока не читает.
AGENTS.md это открытый стандарт от OpenAI, его поддерживают Codex, Cursor, Amp, Gemini CLI, но Claude Code
автоматически его не подхватит
Issue висит открытой на github с августа 2025и собрала тысячи апвоутов
Если хочется единый источник правды для всех инструментов можно обыграть следующим образом:
- В CLAUDE.md написать одну строку @AGENTS.md - Claude Code умеет импорты и подтянет содержимое
- Сделать симлинк CLAUDE.md → AGENTS.md
- Повесить SessionStart-хук, который пробежится по всем AGENTS.md в репе и закинет их в контекст
На бусти готовили claude code
под питоновские проекты - можно брать за основу
И раз уж речь зашла про экономию контекста - апну пост про rtk, который сжимает вывод команд еще до того
как он попадет в окно