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.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 начнёт ошибаться?» Если нет – удаляйте.

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

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 – метод Бориса Черни

В интервью и материалах начала 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 по методу Бориса Черни

# 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-агента.

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

Как заставить Claude задавать вопросы, а не гадать

Частая боль: даёшь Claude Code задачу, а он сразу лезет писать код по своей интерпретации – и угадывает не то. Хочется, чтобы агент сначала «проинтервьюировал» тебя: уточнил требования, разобрался в контексте, а только потом действовал. В Claude Code это включается тремя приёмами, и лучший результат даёт их связка.

1. Plan Mode – встроенный режим «сначала разберись». По документации, plan mode заставляет Claude исследовать и предложить план, но не трогать файлы, пока ты не одобришь: он читает код, запускает разведочные команды, пишет план – и показывает его тебе с вопросом, как продолжить. Включается нажатием Shift+Tab (циклом до Plan Mode), префиксом /plan для одного промпта или флагом на старте:

claude --permission-mode plan

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

2. Правило в CLAUDE.md. Поскольку CLAUDE.md – это контекст, который читается в начале каждой сессии, конкретная инструкция «спрашивай при неоднозначности» превращает уточняющие вопросы в поведение по умолчанию – без ручного напоминания каждый раз. Короткое правило:

# Workflow
- Перед реализацией: если требования неоднозначны или не хватает контекста –
  задай уточняющие вопросы, не начинай кодить по догадке.
- Для задач сложнее трёх шагов – сначала план, потом код.

Чем конкретнее формулировка, тем надёжнее Claude ей следует – размытое «уточняй, если что» работает хуже явного правила.

3. Прямой промпт-приём. Самый быстрый способ на один раз – прямо попросить: «Задай мне 5 вопросов о проекте и требованиях, прежде чем начать». Это тот же принцип, что закладывает команда /init, когда интервьюирует твой проект перед генерацией CLAUDE.md.

Один нюанс: если Claude, наоборот, перестал переспрашивать и рвётся выполнять – проверь, не включён ли auto-режим (он специально подавляет уточняющие вопросы ради непрерывной работы). Тонкости команд и режимов – в гайде по командам Claude Code.

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

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

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

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

FAQ

Что такое файл CLAUDE.md и зачем он нужен?

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

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

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

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

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

как заставить клод спросить всё о себе

Самый простой способ – прямой промпт: «Задай мне вопросы о проекте и требованиях, прежде чем начать». Плюс включи Plan Mode (Shift+Tab или /plan) – в нём Claude сначала разбирается и предлагает план, а не пишет код по догадке. А чтобы это стало поведением по умолчанию, добавь в CLAUDE.md правило «спрашивай при неоднозначности».

как заставить Claude задавать уточняющие вопросы

Двумя способами. Разово – попроси прямо в чате уточнить неясные требования перед работой. Постоянно – пропиши в CLAUDE.md инструкцию: «Перед реализацией задай уточняющие вопросы, если требования неоднозначны». CLAUDE.md читается в начале каждой сессии, так что правило действует всегда.

почему Claude сам не задаёт вопросы перед задачей

Обычно потому, что задача кажется ему однозначной, либо включён auto-режим, который намеренно подавляет уточняющие вопросы ради непрерывной работы. Переключись в Plan Mode или default-режим и явно попроси уточнений – тогда Claude соберёт неясности в вопросы, а не в предположения.