Сколько токенов расходуют CLAUDE.md и AGENTS.md и какой длины их делать?
Фиксированного числа нет: файл стоит столько, сколько в нём текста, и он отправляется с каждым сообщением сессии. Anthropic советует держать каждый CLAUDE.md в пределах 200 строк. Codex перестаёт добавлять файлы AGENTS.md, когда они вместе достигают 32 KiB. Оставьте правила, нужные каждый раз, а остальное вынесите.
Codex
AGENTS.md читается один раз при запуске и дальше остаётся в сессии. Общий предел по умолчанию — 32 KiB, и OpenAI советует держать файл небольшим.
При запуске Codex читает ~/.codex/AGENTS.md, затем идёт от корня проекта вниз до текущего каталога, берёт не больше одного файла на уровень и соединяет их в один блок промпта. Когда блок достигает 32 KiB (настройка project_doc_max_bytes), Codex перестаёт добавлять файлы, и всё, что дальше, вообще не читается. В большом проекте вкладывайте файлы: несколько общих правил держите в корне, а правила модуля — в AGENTS.md внутри этого модуля, где они загружаются, только когда вы запускаете Codex оттуда.
Что сказано в официальной документации
Reduce the size of your AGENTS.md. If you work on a larger project, you can control how much context you inject through AGENTS.md files by nesting them within your repository.Codex builds an instruction chain when it starts (once per run; in the TUI this usually means once per launched session).Codex skips empty files and stops adding files once the combined size reaches the limit defined by project_doc_max_bytes (32 KiB by default).Codex concatenates files from the root down, joining them with blank lines. Files closer to your current directory override earlier guidance because they appear later in the combined prompt.Claude
CLAUDE.md целиком загружается в начале каждой сессии. Anthropic советует до 200 строк на файл; /context показывает, сколько занимает ваш.
При запуске Claude Code читает ~/.claude/CLAUDE.md, CLAUDE.md проекта (или .claude/CLAUDE.md), CLAUDE.local.md и такие же файлы в каталогах выше. Файлы в подкаталогах загружаются, только когда Claude читает там какой-нибудь файл. Claude Code отправляет весь разговор с каждым запросом, поэтому это содержимое считается заново с каждым сообщением. Anthropic говорит прямо: более длинные файлы занимают больше контекста и хуже соблюдаются.
Что сказано в официальной документации
CLAUDE.md files are loaded into the context window at the start of every session, consuming tokens alongside your conversation.Size: target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence.Claude Code sends your full conversation with every requestКуда переносить то, что вы убираете из CLAUDE.md
В Claude Code есть два способа загружать инструкции только тогда, когда они нужны. Всё остальное, включая импорты через @, загружается при запуске.
Длинные инструкции для одного процесса — релизов, ревью, миграций базы данных: перенесите их в skill. Skill загружается, только когда используется.
Правила, которые относятся только к определённым файлам: положите их в .claude/rules/ и начните файл с блока paths:. Они загружаются, когда Claude читает подходящий файл.
Заметки для людей: оберните их в HTML-комментарий. Claude Code вырезает блочные комментарии до того, как файл попадает в контекст.
Что сказано в официальной документации
If it contains detailed instructions for specific workflows (like PR reviews or database migrations), those tokens are present even when you're doing unrelated work. Skills load on-demand only when invoked, so moving specialized instructions into skills keeps your base context smaller. Aim to keep CLAUDE.md under 200 lines by including only essentials.Splitting into @path imports helps organization but doesn't reduce context, since imported files load at launch.Block-level HTML comments (<!-- maintainer notes -->) in CLAUDE.md files are stripped before the content is injected into Claude's context. Use them to leave notes for human maintainers without spending context tokens on them.Частые заблуждения
- Чем подробнее CLAUDE.md, тем лучше Claude ему следует
Нет. Anthropic говорит обратное: более длинные файлы занимают больше контекста и хуже соблюдаются, а чем конкретнее и короче инструкции, тем стабильнее Claude им следует. Лишняя длина — постоянная плата с каждого сообщения.
- Если разбить CLAUDE.md на импорты через @, токены экономятся
Не экономятся. Импортированные файлы тоже загружаются при запуске; импорты лишь помогают навести порядок. Токены экономит загрузка по требованию: правила с блоком paths: и skills.
- Claude игнорирует всё, что в CLAUDE.md после 200-й строки
Нет. 200 строк — это ориентир, а не обрезка: Claude Code загружает весь файл, если он не больше 4 MiB, и каждая лишняя строка стоит токенов. Правило «первые 200 строк или 25KB» относится к MEMORY.md, файлу автоматической памяти. Обрезает на самом деле Codex: он перестаёт добавлять файлы AGENTS.md, когда они вместе достигают 32 KiB.
Советы
- Claude Code: введите /context, чтобы увидеть, сколько занимают Memory files и какие файлы загружены.
- Claude Code: введите /memory, чтобы открыть эти файлы и сократить их. Правки действуют со следующей сессии; после /compact Claude Code перечитывает CLAUDE.md из корня проекта с диска.
- Пройдите файл строка за строкой. Если правило нужно не каждый раз, удалите его или вынесите. Оставьте команды сборки, соглашения, структуру проекта и правила «делай так всегда».
- Codex: общие для проекта правила держите в корневом AGENTS.md, а правила модуля — в AGENTS.md внутри этого модуля.
- Codex: запустите codex --ask-for-approval never "Summarize the current instructions.", чтобы убедиться, что прочитано именно то, что вы задумали.
- Пользуетесь обоими инструментами — держите один AGENTS.md. Свежие версии Claude Code читают его напрямую, когда в проекте нет CLAUDE.md; если CLAUDE.md тоже есть, напишите в нём одну строку: @AGENTS.md. Импортированное содержимое всё равно стоит токенов, поэтому держите AGENTS.md коротким.