← Все гайды

Вдвоём · Гайды

CLAUDE.md: что это за файл и зачем он нужен Claude Code

⏱ 6-7 минут чтения 🗂 Навык
1
~2 минуты

Агент каждый раз начинает с нуля. Вот зачем нужен этот файл

Каждая новая сессия Claude Code, когда ты открываешь терминал и запускаешь claude, начинается для него как чистый лист. Он не помнит вчерашний разговор, не знает, что ты уже рассказывал про свой проект вчера, и не в курсе, какие у тебя правила.

Чтобы не объяснять одно и то же заново в каждой сессии, Claude Code умеет читать специальный файл по имени CLAUDE.md. Он лежит в корне проекта, и в начале каждой сессии агент подхватывает его автоматически, тебе не нужно ничего вставлять в чат руками.

Это обычный текстовый файл в формате Markdown, в котором своими словами описано: что это за проект, из чего он состоит, какими командами его запускать и проверять, и каких правил агенту стоит держаться. Чем лучше этот файл, тем меньше агент гадает и тем реже делает не то, что ты имел в виду.

✓ Если ты никогда не создавал CLAUDE.md, ничего страшного не произошло: Claude Code прекрасно работает и без него, просто ему придётся каждый раз заново разбираться в структуре папок.
2
~2 минуты

Как создать файл за одну команду

Руками писать CLAUDE.md с нуля не обязательно. Проще всего попросить сам Claude Code составить черновик, а потом поправить его под себя.

  • Зайди в папку своего проекта в терминале и запусти claude.
  • Введи команду /init.
  • Claude Code сам пройдётся по файлам проекта, посмотрит, на чём он написан, и предложит черновик CLAUDE.md.
  • Прочитай черновик и убери то, что звучит странно или неточно, ты знаешь свой проект лучше.
терминал
claude
/init
Изучаю структуру проекта...
Нашёл: Node.js, Telegram-бот, папка handlers/
Черновик CLAUDE.md готов, сохранить в корне проекта?
// дальше просто подтверждаешь и открываешь файл, чтобы поправить

Если проект совсем новый и файлов в нём ещё почти нет, черновик получится коротким, это нормально. Можно дописать файл вручную прямо сейчас или вернуться к этому через пару дней, когда появится, что в нём зафиксировать.

3
~2 минуты

Что обязательно положить внутрь

Файл не обязан быть длинным и подробным. Важнее, чтобы в нём была база, без которой агент точно будет ошибаться.

РазделЗачем
Что это за проектОдно-два предложения: Telegram-бот для записи клиентов, сайт-визитка, личный трекер привычек.
На чём написанЯзык и основные библиотеки, чтобы агент не предлагал что-то несовместимое со стеком.
Команды запуска и проверкиКак запустить проект локально, как прогнать тесты, если они есть. Агент сам выполнит эти команды.
Структура папокГде лежит код, где конфиги, где секреты, чтобы агент не лез куда не надо.
Жёсткие правилаНапример: «не трогай файл .env», «не удаляй папку data/», «перед изменением базы спроси меня».

Секреты, пароли и ключи API в CLAUDE.md писать нельзя: этот файл обычно попадает в Git и может уйти в публичный репозиторий. Про это подробно в гайде как не слить ключи и пароли.

4
~2 минуты

Частые ошибки новичков с этим файлом

Слишком длинный файл Содержимое CLAUDE.md загружается в начало каждой сессии целиком. Если файл на несколько тысяч строк, агент хуже следует важным правилам, потому что они теряются среди второстепенных деталей. Ориентир, который советует сама Anthropic, это примерно до 200 строк.
Свалка хотфиксов Когда агент один раз делает что-то не так, велик соблазн тут же дописать в файл запрет именно на этот случай. Через месяц таких строк набирается полсотни, и они начинают противоречить друг другу. Лучше периодически перечитывать файл и объединять похожие правила.
Файл написан один раз и забыт Проект меняется: появляются новые папки, меняются команды запуска. Если файл не обновлять, агент начинает ориентироваться на устаревшую картину и путается в том, что из описанного ещё актуально.
✓ CLAUDE.md не защищает от ошибок железно, это не запрет, а сильная подсказка. Для действий, которые должны работать без исключений (например, не удалять продакшн-базу), одного файла недостаточно, нужна более жёсткая настройка доступа агента.
5
~2 минуты

Мини-шаблон, который можно взять за основу

Вот пример короткого CLAUDE.md для типичного первого проекта новичка, Telegram-бота. Скопируй и замени под свой случай.

CLAUDE.md
# Проект
Telegram-бот для записи клиентов на услуги. Node.js, библиотека grammY.
# Команды
Запуск: npm run dev
Тесты: npm test
# Структура
handlers/ - обработчики команд бота
db/ - работа с базой данных
# Правила
Не трогай файл .env и не выводи его содержимое в чат
Перед изменением схемы базы данных спроси меня
Объясняй, что сделал, простыми словами, я не программист

Такого шаблона достаточно, чтобы агент перестал задавать одни и те же вопросы в начале каждой сессии. Остальное можно дописывать по мере того, как проект растёт и ты замечаешь, что агент снова и снова наступает на одни и те же грабли.