CLAUDE.md – память и правила для Claude Code, которые экономят твои токены
Как настроить CLAUDE.md, чтобы Claude Code помнил ваш контекст, стиль и правила проекта. Практика от создателя Claude Code.
Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper
Что такое CLAUDE.md
Markdown-файл с инструкциями, которые Claude Code читает в начале каждой сессии. Это не конфиг и не документация – это ваш голос внутри контекста модели.
Три вещи, которые он делает:
1. Задаёт правила – стиль кода, конвенции, запреты
2. Даёт контекст – архитектура проекта, зависимости, quirks
3. Накапливает опыт – каждая ошибка превращается в правило
Борис Черни, создатель Claude Code и Staff Engineer в Anthropic, держит один общий CLAUDE.md на ~100 строк. Обновляет несколько раз в неделю. Принцип простой: «Каждый раз, когда Claude делает что-то неправильно, добавляем в CLAUDE.md, чтобы не повторял».
Где размещать CLAUDE.md
Claude Code поддерживает несколько уровней:
| Уровень | Файл | Назначение |
|---------|------|-----------|
| Глобальный | `~/.claude/CLAUDE.md` | Личные предпочтения для всех проектов |
| Проектный | `./CLAUDE.md` или `./.claude/CLAUDE.md` | Командные правила, коммитятся в git |
| Локальный | `./CLAUDE.local.md` | Личные настройки для конкретного проекта (в `.gitignore`) |
Приоритет: локальный > проектный > глобальный. Если правила конфликтуют – побеждает более специфичный уровень.
Проектный 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 начнёт ошибаться?» Если нет – удаляйте.
Целевой размер – до 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 уровней.
Используйте `@` для разделения ответственности. Один 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 – трогай только то, что нужно. Не вноси новых побочных эффектов
Шаблон CLAUDE.md по методу Бориса Черни
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, который экономит часы и снижает процент ошибок с каждой сессией.
Канал с гайдами и контентом по claude code, выкладываем новости (когда режут лимиты в 10 раз) и какие инструменты через claude реализуем для проектов, канал: https://t.me/claudedevolper