CLAUDE.md – память и правила для Claude Code

Что такое CLAUDE.md

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

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

1. Задаёт правила – стиль кода, конвенции, запреты

2. Даёт контекст – архитектура проекта, зависимости, quirks

3. Накапливает опыт – каждая ошибка превращается в правило

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

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

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

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

:::tip Совет

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

:::

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

Хороший CLAUDE.md

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

# 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 строк на файл. Длинные файлы расходуют контекст и снижают точность следования инструкциям.

:::

# 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`:

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

:::tip Совет

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

:::

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 файлами:

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

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

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

Борис Черни опубликовал свой workflow в январе 2026 года. Восемь принципов, которые он использует ежедневно при разработке 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` через GitHub Action для автоматического обновления 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 – трогай только то, что нужно. Не вноси новых побочных эффектов

# 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.

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

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

CLAUDE.md – фундамент продуктивной работы с Claude Code. Начните с 10–20 строк: стиль кода, архитектура, частые ошибки. Дополняйте каждый раз, когда Claude делает не то. Через неделю у вас будет CLAUDE.md, который экономит часы и снижает процент ошибок с каждой сессией.

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

Узнай больше на edgelab.su