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

> Почему агент плодит дубли и забывает договорённости — и как один файл CLAUDE.md превращает его из джуна-склеротика в человека, который держит проект в голове.

Источник: https://aifirstclub.ru/guides/claude-md-kontekst-proekta · AI First Club · 2026-05-28

Знакомая боль: объяснил агенту, как устроен проект, он сделал хорошо. Через час начал новую задачу — и агент будто впервые видит твой код. Снова дубли, снова игнор договорённостей.

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

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

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

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

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

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

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

> Если новый человек в команде задал бы этот вопрос в первый день, ответу место в `CLAUDE.md`. А если ответ и так виден прямо в коде, писать его не надо.

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

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

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

Контекст агента ограничен. Хороший `CLAUDE.md` его экономит, а не жжёт. Подробнее про это в гайде [как экономить токены](/guides/kak-ekonomit-tokeny).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дальше стоит навести [правила безопасности](/guides/bezopasnost-ii-agenta), чтобы автономность не вышла боком.

> В курсе [«Claude Code: с нуля до Pro»](/courses/claude-code-s-nulya-do-pro) под CLAUDE.md отведён отдельный урок — заводим паспорт проекта по шагам и на живом проекте.

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

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

> **Промпт:**
> Проведи аудит моего CLAUDE.md как строгий редактор. По шагам: 1) найди строки, которые описывают то, что ты и так видишь из кода, — предложи убрать; 2) найди расплывчатые пожелания и переформулируй каждое в проверяемое правило поведения; 3) предложи 3–5 стоп-правил под мой проект: что тебе нельзя делать без моей явной команды (подумай, что здесь страшно сломать); 4) вспомни ошибки, которые ты уже делал в этом проекте, и добавь правила, которые их предотвратят; 5) покажи файл до и после, объясни каждую правку одной строкой. Ничего не сохраняй, пока я не скажу «да».

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

---

В клубе мы разбираем реальные `CLAUDE.md` участников и шлифуем их под конкретные проекты. [Загляни, что внутри](/#inside).

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

### Что такое 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 остаётся фундаментом: это главная точка, где правила пишешь ты сам и целиком видишь, что агент получит.