Чердак

CLAUDE.md — инструкции для Claude Code

Обновлено

  1. Где лежит CLAUDE.md
  2. Как создать
  3. Что писать
  4. Как писать, чтобы Claude слушался
  5. CLAUDE.md и авто-память
  6. Нужна ли подписка
  7. Вопросы

CLAUDE.md — файл с инструкциями для Claude Code. Claude читает его в начале каждой сессии: команды сборки, правила кода, устройство проекта. Без него каждая сессия начинается с чистого листа, и одно и то же приходится объяснять заново. Создать файл проще всего командой /init.

Где лежит CLAUDE.md

ГдеДля чегоКто видит
~/.claude/CLAUDE.mdтвои привычки во всех проектахтолько ты
./CLAUDE.md или ./.claude/CLAUDE.mdправила проектавсе, кто работает с репозиторием
./CLAUDE.local.mdличные настройки проекта, добавь в .gitignoreтолько ты
системная папка компанииправила организации от админавсе в организации

Файлы из папок выше рабочей загружаются при запуске, из вложенных — когда Claude в них работает. Если в репозитории уже есть AGENTS.md, Claude Code может читать его вместо CLAUDE.md.

Как создать

  1. Открой проект и запусти claude.
  2. Введи /init. Claude изучит код и напишет черновик: команды сборки и тестов, найденные правила.
  3. Допиши то, чего Claude сам не найдёт, через /memory или в редакторе.
  4. Проверь, что файл подхватился: /context покажет его в списке Memory files.

Если CLAUDE.md уже есть, /init не перезапишет его, а предложит правки.

Что писать

Пиши то, что иначе объяснял бы каждый раз:

  • команды: сборка, тесты, запуск;
  • правила кода, которые не видны из самого кода;
  • где что лежит в проекте;
  • правила вида «всегда делай X перед Y».

Добавляй строку, когда Claude повторил ошибку или ты второй раз пишешь ту же поправку.

Как писать, чтобы Claude слушался

  • Конкретно. «Отступ 2 пробела», а не «форматируй красиво». «Запускай npm test перед коммитом», а не «проверяй изменения».
  • Коротко. Anthropic советует держать файл до 200 строк: длинный тратит контекст, и правила соблюдаются хуже.
  • Без противоречий. Из двух спорящих правил Claude может выбрать любое. Найти устаревшее и противоречивое поможет /doctor prompt-audit.
  • По разделам. Заголовки и списки Claude читает лучше, чем сплошной текст.

Правила для части проекта вынеси в .claude/rules/, длинные процедуры — в skills.

CLAUDE.md — это подсказка, а не запрет. Чтобы Claude точно не сделал какое-то действие, нужен хук PreToolUse, а не строка в файле.

CLAUDE.md и авто-память

CLAUDE.mdАвто-память
Кто пишеттыClaude
Что внутриправила и инструкциитвои поправки, предпочтения, контекст
Сколько загружаетсявесь файлпервые 200 строк или 25 КБ

Авто-память включена по умолчанию, переключатель — в /memory. Claude не записывает туда то, что видно из кода или уже есть в CLAUDE.md.

Нужна ли подписка

CLAUDE.md работает в Claude Code, а тот входит в платные тарифы: от Pro. Claude Pro в Чердаке — 2 490 ₽ в месяц, оплата по СБП, подписка на твой аккаунт. Как поставить Claude Code — в гайде как установить Claude Code, остальные команды — в гайде команды Claude Code.

Вопросы

Что такое CLAUDE.md? Файл с инструкциями, который Claude Code читает в начале каждой сессии.

Где должен лежать CLAUDE.md? В корне проекта или в .claude/. Общие правила для всех проектов — в ~/.claude/CLAUDE.md.

Как создать CLAUDE.md? Командой /init в Claude Code, потом допиши руками.

Почему Claude не выполняет правила из CLAUDE.md? Файл слишком длинный, правило размытое или противоречит другому. Сократи файл и проверь его через /doctor prompt-audit.

Можно ли использовать AGENTS.md? Да, Claude Code может читать его вместо CLAUDE.md.

Купить Claude Pro

Поддержка

Проверка перед входом

Проверяем соединение…