# CLAUDE.md 2026: память и правила для Claude Code (метод Карпати)

## Что такое CLAUDE.md

Markdown-файл с инструкциями, которые Claude Code читает в начале каждой сессии. Это не конфиг и не документация – это ваш голос внутри контекста модели.

Три вещи, которые он делает:

1. Задаёт правила – стиль кода, конвенции, запреты
2. Даёт контекст – архитектура проекта, зависимости, quirks
3. Накапливает опыт – каждая ошибка превращается в правило

Борис Черни, создатель и глава Claude Code в Anthropic, держит один общий CLAUDE.md компактным (~2.5k токенов). Принцип простой: «Каждый раз, когда Claude делает что-то неправильно, добавляем в CLAUDE.md, чтобы не повторял».

## Где размещать CLAUDE.md

Claude Code поддерживает несколько уровней:

| Уровень | Файл | Назначение |
|---------|------|-----------|
| Глобальный | `~/.claude/CLAUDE.md` | Личные предпочтения для всех проектов |
| Проектный | `./CLAUDE.md` или `./.claude/CLAUDE.md` | Командные правила, коммитятся в git |
| Локальный | `./CLAUDE.local.md` | Личные настройки для конкретного проекта (в `.gitignore`) |

Приоритет: локальный > проектный > глобальный. Если правила конфликтуют – побеждает более специфичный уровень.

:::tip Совет
Проектный CLAUDE.md коммитьте в git – вся команда получает одинаковый контекст. Личные предпочтения – в `CLAUDE.local.md`, чтобы не мешать коллегам.
:::

## Что писать в CLAUDE.md

## Хороший CLAUDE.md

Конкретные, верифицируемые инструкции:

```markdown
# Code style
- Use ES modules (import/export), not CommonJS (require)
- Indent with 2 spaces
- Run `npm test` before committing

# Architecture
- API handlers live in `src/api/handlers/`
- Database migrations in `src/db/migrations/`

# Workflow
- Commit messages in Russian
- Branch naming: feature/, fix/, refactor/
- Never push to main directly
```

## Плохой CLAUDE.md

Размытые инструкции, которые Claude и так знает:

Тест для каждой строки: «Если убрать это – Claude начнёт ошибаться?» Если нет – удаляйте.

:::warning Важно
Целевой размер – до 200 строк на файл. Длинные файлы расходуют контекст и снижают точность следования инструкциям.
:::

```markdown
# Rules
- Write clean code
- Format code properly
- Keep files organized
- Test your changes
```

## Что включать, а что нет

**Включать:**

- Bash-команды, которые Claude не угадает
- Отличия от стандартных конвенций языка
- Инструкции по тестированию
- Конвенции репозитория (naming веток, PR)
- Архитектурные решения проекта
- Quirks dev-окружения
- Частые gotchas

**Не включать:**

- То, что Claude определит сам из кода
- Стандартные конвенции языка
- Детальную API-документацию (лучше ссылку)
- Часто меняющуюся информацию
- Длинные объяснения и туториалы

## Импорт файлов через @

CLAUDE.md поддерживает импорт через `@path/to/file`:

Относительные пути считаются от файла-содержащего импорт. Глубина рекурсии – до 4 уровней (four hops).

:::tip Совет
Используйте `@` для разделения ответственности. Один CLAUDE.md ссылается на отдельные файлы правил – модульность без раздувания основного файла.
:::

```markdown
See @README.md for project overview.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- API spec: @docs/api-spec.md
```

## Модульные правила (.claude/rules/)

Для крупных проектов – директория `.claude/rules/` с файлами по темам:

Файлы с `paths` в frontmatter загружаются только при работе с matching файлами:

```text
.claude/
  CLAUDE.md
  rules/
    python.md        # Загружается всегда
    typescript.md    # Загружается всегда
    api-routes.md    # Загружается только при работе с API
```

```markdown
---
paths:
  - "src/api/**/*.ts"
---
# API Development Rules
- All endpoints must include input validation
- Return 404 for missing resources, not 500
```

## Workflow Orchestration – метод Бориса Черни

В интервью и материалах начала 2026 года Борис Черни описал свой workflow – принципы, которые он использует ежедневно при разработке Claude Code.

## 1. Plan Mode Default

Для любой задачи сложнее трёх шагов – сначала Plan Mode (Shift+Tab дважды). Итерация с Claude до хорошего плана, потом переключение в авто-режим для реализации.

«Хороший план – это критически важно, чтобы избежать проблем на дальнейших этапах.»

Некоторые члены команды Anthropic запускают одного Claude для написания плана, потом второго – для ревью плана «как staff engineer».

## 2. Subagent Strategy

Субагенты для тяжёлой работы. Один субагент – одна задача. Основной контекст остаётся чистым.

Борис запускает 10–15 параллельных сессий: 5 в терминале (отдельные git worktrees) + 5–10 в браузере. Это его «главный productivity unlock».

## 3. Self-Improvement Loop

CLAUDE.md как институциональная память. Когда Claude ошибается – документируешь ошибку, чтобы не повторялась. Борис называет это «Compounding Engineering» – ошибки превращаются в guardrails.

На PR в команде Anthropic разработчик вручную ставит тег `@.claude`, чтобы обновить CLAUDE.md learnings из code review.

## 4. Verification Before Done

«Дайте Claude способ проверить свою работу. Если у Claude есть feedback loop, качество результата вырастет в 2–3 раза.»

- UI – открыть браузер, протестировать
- Backend – bash-команды, тест-сюиты
- Mobile – эмуляторы

## 5. Demand Elegance

После посредственного фикса – промпт Claude: «Зная всё, что ты знаешь сейчас, выброси это и реализуй элегантное решение.»

Но для простых, очевидных фиксов – не усложнять.

## 6. Autonomous Bug Fixing

Баг-репорт = чини сразу. Без микроменеджмента. «Go fix the failing CI tests» – и Claude разбирается сам.

## 7. Task Management

Шестишаговый цикл:

1. Plan – план в tasks/todo.md с чекбоксами
2. Verify Plan – сверка перед началом
3. Track Progress – отмечай выполненное
4. Explain Changes – краткая сводка на каждом шаге
5. Document Results – секция review в todo.md
6. Capture Lessons – обновить learnings после коррекций

## 8. Core Principles

Три базовых принципа, которые Борис закладывает в каждый CLAUDE.md:

- **Simplicity First** – каждое изменение максимально простое. Удаление кода предпочтительнее добавления
- **No Laziness** – корневые причины, не временные фиксы. Стандарт senior-разработчика
- **Minimal Impact** – трогай только то, что нужно. Не вноси новых побочных эффектов

## Шаблон CLAUDE.md по методу Бориса Черни

```markdown
# Project

## Code Style
- [конвенции вашего проекта]

## Architecture
- [ключевые решения, пути, зависимости]

## Workflow
- Plan Mode для задач 3+ шагов
- Verification: [как проверять – тесты, браузер, логи]
- Commit messages: [формат]
- Branch naming: [формат]

## Common Mistakes
- [ошибки, которые Claude делал раньше]

## Testing
- [как запускать тесты]
- [что проверять перед коммитом]
```

## Когда добавлять в CLAUDE.md

Четыре триггера:

1. Claude делает одну и ту же ошибку второй раз
2. Code review ловит то, что Claude должен знать
3. Вы вводите ту же коррекцию, что и в прошлой сессии
4. Новому разработчику нужен тот же контекст

## Автоматическая память Claude Code

Помимо CLAUDE.md, Claude Code ведёт автоматическую память в `~/.claude/projects/<project>/memory/`. Туда записываются коррекции и открытия из ваших сессий.

Автопамять дополняет CLAUDE.md, но не заменяет его. CLAUDE.md – осознанные правила. Автопамять – наблюдения Claude. Если хочется разобраться, как эти слои устроены целиком – от правил до самообучения – посмотрите гайд про [4 слоя памяти AI-агента](/guides/memory-architecture/).

Посмотреть все загруженные файлы памяти: команда `/memory` в Claude Code.

## Следующий шаг

CLAUDE.md – фундамент продуктивной работы с Claude Code. Начните с 10–20 строк: стиль кода, архитектура, частые ошибки. Дополняйте каждый раз, когда Claude делает не то. Через неделю у вас будет CLAUDE.md, который экономит часы и снижает процент ошибок с каждой сессией. Если только ставите агента с нуля, удобно начать с [готового набора для старта Claude Code](/guides/claude-code-starter-kit/) – там CLAUDE.md уже встроен в базовую конфигурацию.

Хочешь разобраться глубже и собрать AI-агента с настроенной памятью? В сообществе EdgeLab мы делаем это на практике – воркшопы, готовые шаблоны, поддержка.

Узнай больше в сообществе EdgeLab Space – edgelab.space

## FAQ

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

### Где размещать CLAUDE.md?
В корне проекта (и при необходимости — глобально в домашней папке для правил на все проекты). Claude подхватывает оба уровня: глобальные правила + проектные.

### Что писать в CLAUDE.md?
Кто ты и что за проект, стиль и язык, что запрещено, ключевые пути и команды. В гайде — шаблон по методу Бориса Черни и как настроить автопамять, чтобы файл пополнялся сам.