# Шаблон CLAUDE.md: файл, который делает Claude Code вдвое полезнее

> Готовая структура файла-памяти: команды, стек с объяснением «почему», только неочевидная архитектура и живые заметки. Плюс версия для маркетинговых проектов.

Источник: https://blog.uspeshnyy.ru/blog/shablon-claude-md/
Автор: Александр Успешный · blog.uspeshnyy.ru
Опубликовано: 2026-05-14
Теги: Claude, инструменты, система

---

CLAUDE.md — файл, который [Claude Code](/blog/claude-code-dlya-netehnarey/) читает перед каждой сессией: инструкция о вашем проекте, его правилах и особенностях. В [правилах инженера](/blog/claude-code-rukovodstvo-inzhenera/) мы разбирали принципы — кратко, конкретно, с объяснением «почему». Здесь — готовая структура, которую можно скопировать и заполнить.

Файл должен быть **кратким**, **техническим** и **живым**. Помните про лимит: модель надёжно держит порядка 150–200 инструкций, и часть уже занята системными.

## Шаблон для проекта с кодом

```markdown
# Руководство для Claude (Имя Проекта)

## Основные команды
Запускать из корня проекта. Используй эти алиасы, а не гадай.

- Запуск: `npm run dev` (сервер на порту 3000)
- Билд: `npm run build` (строгий режим, падает при ворнингах)
- Тесты: `npm test -- -u` (Jest, обновляет снэпшоты)
- Линтинг: `npm run lint:fix` (обязательно перед коммитом)
- База данных: `docker-compose up -d db` (Postgres, креды в .env.example)

## Стек и стиль
Не объясняй мне, что такое React. Объясняй, как МЫ его используем.

- Стек: Next.js 14 (App Router), Tailwind, Prisma, PostgreSQL.
- Типизация: strict TypeScript. Почему: ловили баги в проде из-за `any`.
  Не используй `any` — используй `unknown` или пиши тип.
- Стили: Tailwind, без кастомных CSS-классов.
- Ошибки: серверные экшены возвращают { success, data?, error? }.
  Почему: чтобы фронт единообразно показывал тосты.

## Архитектура (только неочевидное)
- src/app/api: используем редко, предпочитаем Server Actions.
- src/lib/db.ts: синглтон Prisma-клиента.
- src/components/ui: UI-кит — не менять логику, только стили.
- prisma/schema.prisma: источник правды; после изменений — `npx prisma generate`.

## Процесс
1. Маленькие атомарные правки.
2. Меняешь логику вычислений — добавь юнит-тест.
3. camelCase для переменных, PascalCase для компонентов, kebab-case для файлов.
4. Секреты только через process.env, никакого хардкода.

## Живые заметки
<!-- сюда добавляются правила по ходу работы -->
- Всегда date-fns, не moment.js.
```

## Почему эта структура работает

**Команды.** Ассистент не должен гадать, как запускается ваш проект. Специфические флаги, порядок запуска («сначала Docker, потом сервер») — всё сюда.

**«Почему» рядом с правилом.** «Используй строгую типизацию» — нормально. «…потому что ловили баги в проде» — лучше: зная причину, модель принимает микро-решения, которые вы не успели описать, но которые соответствуют цели.

**Только неочевидное.** «Компоненты лежат в папке components» — мусор, съедающий лимит инструкций. «Мы используем Server Actions вместо API-роутов» — то, что нужно.

**Живые заметки.** Ассистент дважды ошибся в одном месте — правило отправляется в файл (в Claude Code для этого есть клавиша #). Через месяц CLAUDE.md станет честным документом о том, как на самом деле устроен проект.

![Файл-память проекта: команды, стек, архитектура, процесс и живые заметки, слева шкала лимита инструкций](/images/posts/shablon-claude-md-1.webp)

## Версия для маркетингового проекта

От себя: тот же принцип работает без единой строки кода. Вот структура, которую я использую в контент-проектах. А как превратить её в общий документ о бренде, который читают все авторы и модели, и дополнить стоп-словами и проверкой по критериям, — разобрано в статье про [голос бренда в AI-контенте](/blog/golos-brenda-v-ai-kontente/):

```markdown
# Руководство для Claude (Проект/Бренд)

## Кто мы и для кого
- Продукт: [что продаём, одной строкой]
- Аудитория: [кто покупает, их главная боль]
- Позиционирование: [чем отличаемся]

## Голос и стиль
- Обращение на «вы», без канцелярита и слова «уникальный».
- Почему: аудитория — владельцы бизнеса, они чуют продающий пластик.
- Запрещённые слова: [список штампов вашей ниши]
- Термины пишем так: [глоссарий: как называем продукт, фичи, тарифы]

## Факты (источник правды)
- Цифры и кейсы берём ТОЛЬКО из facts.md. Нет в файле — не выдумывай, спроси.
- Цены и сроки: [актуальные, с датой обновления]

## Форматы
- Пост в Telegram: до 800 знаков, крючок в первой строке, один CTA.
- Статья: лид без воды, подзаголовки каждые 3–4 абзаца, вывод + CTA.

## Живые заметки
- Не обещать «результат за неделю» — юристы против.
```

Разница с «просто промптом»: это пишется один раз, читается при каждом запуске и **накапливает** ваши исправления вместо того, чтобы терять их с каждым новым чатом. По сути, это младший брат базы знаний из [методологии 4 слоёв](/blog/ai-sistema-pod-klyuch-metodologiya/) — первый шаг к цифровому двойнику, который делается за вечер.

> Хотите, чтобы такой файл — и вся система вокруг него — были собраны под ваш бизнес? Напишите «система» в [Telegram](https://t.me/uspeshnyy), разберём за 15 минут.