CLAUDE.md в 2026: как ИИ-агент помнит контекст твоего проекта

Агент тут не глупый. Просто у него нет памяти между задачами. И лечится это одним файлом, CLAUDE.md.

Что такое CLAUDE.md

Это обычный текстовый файл в корне проекта, который агент читает автоматически в начале работы. Считай его памяткой, которую новый сотрудник видит в первый рабочий день: что за проект, какие правила, чего не делать.

Без него каждая сессия начинается с чистого листа. С ним агент сразу знает контекст и не переспрашивает то, на что ты уже отвечал.

Что туда писать

Не пиши роман. Пиши то, что агент не может узнать сам, прочитав код. Рабочий минимум:

• Что за проект — одно-два предложения про суть и цель
• Стек — язык, фреймворк, ключевые библиотеки
• Команды — как запустить, собрать, прогнать тесты
• Конвенции — стиль кода, как называть файлы, на каком языке комментарии
• Чего не делать — грабли, на которые уже наступали

Чего туда НЕ писать

Файл читается в начале каждой сессии и тратит контекст. Раздуешь — станет хуже, а не лучше.

• Не дублируй то, что и так видно в коде
• Не пиши историю изменений — для этого есть гит
• Не складывай туда временные заметки по текущей задаче
• Держи коротко: лучше 30 точных строк, чем 300 общих

Контекст агента ограничен. Хороший CLAUDE.md его экономит, а не жжёт. Подробнее про это в гайде как экономить токены.

Как это выглядит на практике

Простой пример для веб-проекта:

# Проект: лендинг для клуба

Сайт-витрина на Next.js. Цель — трафик и заявки.

## Стек
- Next.js (App Router) + TypeScript + Tailwind
- Контент статей — MDX

## Команды
- Запуск: pnpm dev
- Сборка: pnpm build

## Конвенции
- Коммуникация — русский, код и коммиты — английский
- Не коммитить без явной просьбы

Тридцать секунд работы — и агент перестаёт переспрашивать одно и то же.

Практики команды создателя Claude Code

Борис Черни, создатель Claude Code, выложил в X практики, по которым с агентом работает его собственная команда в Anthropic. По сети ходит вирусный пересказ в виде «готового CLAUDE.md» — честно скажем, это компиляция стороннего разработчика, но собрана она по делу. Вот что из этого стоит примерить к своему файлу:

• План-режим по умолчанию. Любая задача сложнее пары шагов — сначала план, потом код. И отдельное правило на случай беды: пошло не так — остановись и перепланируй, а не дотягивай через силу.
• Черновую работу — субагентам. Объёмный поиск и разведку по коду выноси в субагентов (отдельные копии агента под подзадачи), чтобы рабочая память главного оставалась чистой. Как это устроено — в гайде про субагентов.
• Проверка перед словом «готово». Агенту нельзя закрывать задачу без доказательства: тесты, логи, показанный результат. В пересказе это сжато до вопроса «одобрил бы это опытный инженер?»
• Баги — чини сам. Дали ошибку и логи — разбирайся и исправляй, не проси вести за руку.
• Каждое изменение — минимально возможное. Никаких «заодно отрефакторил полпроекта».

Общая мысль всех пяти пунктов: сильный файл не описывает проект, а управляет поведением. «У нас Next.js» агент видит и сам. А вот «задача от трёх шагов — сначала план и моё ок» меняет каждую твою сессию.

Стоп-правила: чего агенту нельзя без спроса

Отдельный класс правил, который мы в клубе выстрадали на практике. Агент по характеру смелый, и это его сила ровно до момента, когда он «улучшит» то, что трогать было нельзя.

Формула простая: «X — только по моей явной команде». Подумай, что в твоём проекте страшно сломать или нельзя нарушить: платёжный код, юридические тексты, база данных, чужие файлы. Из нашего боевого файла: тексты сайта агент не меняет без команды (смыслы — зона автора), одно запретное слово не пишет нигде, а вот коммитить после каждого законченного куска — наоборот, обязан. Каждый такой пункт — одна строчка, и это самые окупаемые строчки в файле.

Главный принцип

CLAUDE.md — это не «настройка один раз и забыл». Это живой документ. Поймал агента на повторяющейся ошибке, допиши правило. Сменилась команда запуска, поправь. Вот так файл и растёт вместе с проектом.

“

Один файл превращает агента из джуна, который каждый день будто впервые на работе, в сотрудника, который держит проект в голове.

Дальше стоит навести правила безопасности, чтобы автономность не вышла боком.

Промпт: аудит твоего CLAUDE.md

Не переписывай файл руками — поручи это самому агенту, он отлично проводит ревизию собственной памятки. Открой Claude Code в папке проекта и вставь:

Пятнадцать минут на разбор его предложений — и файл начнёт работать на тебя, а не лежать в корне проекта для галочки.

---

В клубе мы разбираем реальные CLAUDE.md участников и шлифуем их под конкретные проекты. Загляни, что внутри.

Частые вопросы

Что такое CLAUDE.md простыми словами?

Это обычный текстовый файл в корне проекта, который агент читает автоматически в начале работы. Считай его памяткой для нового сотрудника: что за проект, какие правила, чего не делать. С ним агент перестаёт начинать каждую сессию с чистого листа.

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

Только то, что агент не узнает сам из кода: суть проекта в паре предложений, стек, команды запуска и тестов, конвенции, грабли, на которые уже наступали. Простой тест: если новый человек в команде задал бы этот вопрос в первый день — ответу место в файле.

Какой длины должен быть CLAUDE.md?

Коротким: лучше 30 точных строк, чем 300 общих. Файл читается в начале каждой сессии и тратит контекст, так что раздутый CLAUDE.md делает работу агента хуже, а не лучше.

Нужно ли обновлять CLAUDE.md после создания?

Да, это живой документ, а не настройка «один раз и забыл». Поймал агента на повторяющейся ошибке — допиши правило, сменилась команда запуска — поправь. Так файл растёт вместе с проектом.

Чем CLAUDE.md отличается от AGENTS.md?

Смысл одинаковый: памятка проекта для ИИ-агента. Разница в том, кто её читает: Claude Code ищет CLAUDE.md, а агенты вроде Codex от OpenAI — AGENTS.md, это открытый стандарт. Содержимое можно переиспользовать почти целиком, принципы из этого гайда работают для обоих.

CLAUDE.md — единственная память агента?

Нет. Claude Code ещё и сам копит заметки о проекте между сессиями (команда /memory покажет, что он записал), а повторяемые процедуры можно оформлять скиллами. Но CLAUDE.md остаётся фундаментом: это главная точка, где правила пишешь ты сам и целиком видишь, что агент получит.