Как выжать максимум из CoreCode

Как писать CLAUDE.md

Обновлено: 27 октября 2026 г.

CLAUDE.md — это описание проекта, которое Claude Code читает в начале каждой сессии. Если он написан хорошо, Claude перестаёт повторять ошибки; если он длинный и запутанный, он впустую расходует контекст на каждом ходу. Эта страница опирается на официальное руководство Anthropic и объясняет, как это отражается на счёте.

Что такое CLAUDE.md

Обычный Markdown-файл, в котором сказано, что Claude должен знать об этом проекте: как собирать и тестировать, соглашения по коду, структура, правила вида «всегда делай X». Claude Code читает его в начале каждой сессии как контекст.

Это не принудительная конфигурация. Чем конкретнее и короче правила, тем стабильнее Claude им следует; для того, чего нельзя допускать никогда, например правки защищённого каталога, используйте хук PreToolUse.

В Claude Code есть и авто-память: исправления, которые вы даёте, сохраняются в ~/.claude/projects/<project>/memory/. В CLAUDE.md лежат правила, которые пишете вы, в авто-памяти — то, чему учится Claude; оба источника загружаются в каждой сессии.

Где его размещать

При запуске Claude Code читает CLAUDE.md из рабочего каталога и из каждого каталога выше, склеивая их сверху вниз, так что файл, ближайший к месту запуска, читается последним. CLAUDE.md в подкаталоге загружается позже, когда Claude читает или правит файл в этом подкаталоге.

С чего начать

Выполните /init в проекте. Claude проанализирует кодовую базу и напишет CLAUDE.md с командами сборки, инструкциями по тестированию и найденными соглашениями; если файл уже есть, он предложит улучшения вместо перезаписи. Затем добавьте то, что Claude не смог узнать сам.

Что в него класть

Считайте его местом для всего, что вам иначе пришлось бы объяснять снова. Добавляйте строку, когда:

• Claude допускает одну и ту же ошибку второй раз;
• на код-ревью обнаруживается соглашение, которое Claude должен был знать;
• вы вводите то же замечание, что и в прошлой сессии;
• новому коллеге понадобился бы тот же контекст.

Ограничивайтесь фактами, нужными в каждой сессии. Многошаговые процедуры оформляйте как skills, которые загружаются по необходимости, а правила для одной части кодовой базы помещайте в .claude/rules.

Как писать правила, которые работают

Пишите правила, которые можно проверить, а не общие пожелания:

• Коротко. Держите каждый CLAUDE.md короче 200 строк. Длинные файлы занимают больше контекста, и им следуют хуже.
• Структурированно. Группируйте связанные правила под заголовками, списком, а не плотными абзацами.
• Согласованно. Если два правила противоречат друг другу, Claude может выбрать любое. Удаляйте устаревшие записи; начиная с Claude Code v2.1.283 команда /doctor prompt-audit находит устаревшие или противоречащие записи и ссылки на несуществующие файлы.
• Заметки для людей — HTML-комментариями. Строка <!-- note --> в CLAUDE.md удаляется до попадания в контекст, поэтому не тратит токены.

Короткий пример:

# Project

## Commands
- Install: pnpm install (not npm)
- Test: pnpm test, must pass before committing
- Run locally: pnpm dev, port 3000

## Conventions
- TypeScript strict mode, no any
- API handlers in src/api/handlers/, one route per file
- Schema changes only through prisma migrate

Импорт других файлов

Подключайте другие файлы через @path, например See @README and @docs/git-instructions.md. Относительные пути отсчитываются от CLAUDE.md, в котором они указаны, а импорты можно вкладывать до четырёх уровней. `@README` внутри обратных кавычек не импортируется.

Импорты помогают организовать файл, но не уменьшают его стоимость в контексте: импортированное содержимое тоже загружается каждый раз. Когда проект впервые импортирует файл вне своего каталога, Claude Code просит вас подтвердить это.

Разделение по областям через .claude/rules

В крупном проекте разбейте инструкции на тематические файлы в .claude/rules/, например testing.md или api-design.md. Правило без paths загружается при запуске, как CLAUDE.md; правило с paths загружается только тогда, когда Claude работает с подходящими файлами:

---
paths:
  - "src/api/**/*.ts"
---
# API rules
- Validate every endpoint's input
- Return errors as ApiError

Раздел CLAUDE.md, выросший в многошаговую процедуру, можно превратить в skill, который загружается только при использовании; см. руководство по skills.

Если у вас уже есть AGENTS.md

Начиная с Claude Code v2.1.277, Claude читает AGENTS.md напрямую: без CLAUDE.md он читает AGENTS.md, а при наличии CLAUDE.md читает только его. Чтобы использовать один файл в разных инструментах для программирования, добавьте в CLAUDE.md строку @AGENTS.md.

Стоимость и кэширование

• Файл отправляется на каждом ходу. CLAUDE.md, авто-память и правила без paths уходят с каждым запросом. При попадании в кэш они стоят как чтение из кэша, но чем они длиннее, тем дороже обходится промах и повторная запись. Это ещё одна причина держать их короткими.
• Правки в середине сессии ждут. Работающая сессия не видит изменённый CLAUDE.md до /clear, /compact или перезапуска (см. руководство Anthropic по кэшированию в Claude Code). Зато правка не сбрасывает кэш сессии.

Другие способы сэкономить — в разделе Как тратить на Claude Code меньше.

Как убедиться, что файл загружен

• Выполните /context и посмотрите раздел Memory files. Файл, которого там нет, Claude не видит.
• /memory показывает, открывает и редактирует каждый CLAUDE.md и включает или выключает авто-память.

FAQ