Почему ваш AI-агент тупит и как это починить одним файлом

Привет! Меня зовут Дмитрий Косик. Я не разработчик, а энтузиаст который вникает в новую для себя движуху. Об этом я пишу в своем ТГ.

Подписывайся там много полезного

t.me

Косик Дмитрий | Торговец Кодом

CLAUDE.md работает только в Claude Code. Это инструмент для работы с проектами через терминал или например в расширение VS Code

Где НЕ работает:

Claude Desktop (приложение на компьютере) нет, там другой формат
claude.ai в браузере нет
ChatGPT, Cursor, любые другие AI нет

Если вы пользуетесь только Claude Desktop для общения и вопросов — CLAUDE.md вам пока не нужен. Он для тех, кто использует AI для работы с проектами: сайтами, автоматизациями, ботами.

Представьте вы наняли ассистента. В первый день объясняете ему все про бизнес: что за проект, кто клиенты, какие правила, что нельзя делать. На второй день он все забыл. На третий снова. Каждый день с нуля.

CLAUDE.md это записка, которую ассистент читает каждое утро перед работой, один раз написали и он всегда в курсе.

Технически это обычный текстовый файл в папке вашего проекта. Ничего устанавливать не нужно. Агент находит его сам и читает автоматически.

Способ 1 - вручную

Откройте папку вашего проекта
Создайте файл с названием CLAUDE.md
Напишите четыре вещи (ниже покажу что именно)

Никаких настроек, регистраций, конфигов.

Способ 2 - через агента

Еще проще

Откройте Claude Code в папке проекта
Скажите "Создай CLAUDE.md для этого проекта"
Агент сам изучит файлы, поймет структуру и напишет первую версию

Агент за минуту сканирует все файлы и собирает файл который на 80% готов, оставшиеся 20% ваши специфические правила.

В 2-3 предложения: что делает, для кого.

## Проект Интернет-магазин кофейного оборудования. Сайт + телеграм-бот для заказов. Клиенты — кофейни и рестораны.

Команды, которые нужно выполнить чтобы проект заработал.

## Запуск python server.py # Сайт откроется на http://localhost:3000

Какие папки за что отвечают, но не все, а только основные

## Структура pages/ — страницы сайта bot/ — телеграм-бот database/ — все что связано с базой данных

Самая ценная часть. Вещи, которые агент должен помнить всегда.

## Правила - Все цены в рублях, без копеек - Бот отвечает на "ты", не на "вы" - Заказы старше 30 дней автоматически отменяются - Не менять файл config.py — там настройки продакшена

Вот сокращенная версия файла из моего проекта системы управления контентом:

# CLAUDE.md ## Проект Система управления контентом для канала "Торговец Кодом". Дашборд с канбан-доской + файлы статей. ## Запуск python content_dashboard/server.py # Дашборд на http://localhost:8080 ## Структура content_dashboard/server.py — сервер content_dashboard/dashboard.html — интерфейс content-log/ — все статьи по папкам (vc/, telegram/, dzen/) ## Правила - Статья для VC = папка с тремя файлами: текст + превью + обложка - Нумерация: 01-название, 02-название и так далее - При написании текстов — живой язык, без канцелярита

47 строк. Агент читает их за секунду и сразу знает все что нужно

Два способа:

Вручную - открыли файл, дописали правило, сохранили. В следующей сессии агент его прочитает.

Через агента - сказали "Запиши в CLAUDE.md что цены мы всегда округляем вверх", агент сам откроет файл, допишет правило, сохранит. Я делаю так в 90% случаев проще сказать чем открывать файл руками.

Когда вносить изменения:

Агент сделал ошибку скажите ему записать правило чтобы не повторял
Изменилась структура проекта обновите секцию "Структура"
Появилось новое правило в бизнесе допишите в "Правила"

Получается что файл растет вместе с проектом.

CLAUDE.md не пишется один раз навсегда

Мой совет: когда агент делает ошибку не просто исправляйте, а скажите ему "запиши это в CLAUDE.md". Он сам добавит правило и больше не повторит.

Частый вопрос "Я закрыл окно, агент все забыл. Как сделать чтобы помнил?"

В Claude Code три уровня памяти:

Начните с CLAUDE.md. Memory работает сама. Handoff добавите когда задачи станут длиннее одной сессии.

Конкретный сценарий. Вы работаете с агентом над задачей, сделали половину, нужно уходить.

Один файл в корне достаточно для большинства случаев, но если проект состоит из нескольких частей (сайт + бот + админка), можно сделать отдельный CLAUDE.md в каждой папке

мой-проект/ ├── CLAUDE.md # Общее: что за проект, как устроен ├── сайт/ │ └── CLAUDE.md # Правила для сайта ├── бот/ │ └── CLAUDE.md # Правила для бота └── админка/ └── CLAUDE.md # Правила для админки

Агент прочитает общий файл + файл из той папки, где сейчас работает. Так он не грузит себе правила бота когда работает с сайтом.

"Пиши качественно" бесполезно, агент и так старается (отвечаю)
Файл на 500 строк слишком много, агент утонет. 50-100 строк идеально
Копипаста из ChatGPT не просите ChatGPT "напиши мне CLAUDE.md". Получится шаблон ни о чем, пишите своими словами про свой проект или попросите самого Claude Code он хотя бы видит ваш проект

CLAUDE.md это самый простой способ сделать AI-агента полезным. Текстовый файл, 5 минут на создание, ноль настроек. Четыре секции: проект, запуск, структура, правила.

Начните с 10 строк. Допишите правило когда агент ошибется. Через месяц у вас будет файл на 50 строк и агент который работает предсказуемо.

А если не хотите писать сами просто скажите агенту "создай CLAUDE.md" - изи катка получается)

Я пишу про вайбкодинг, OpenClaw и AI-автоматизацию в своем ТГ канале.

Подписывайтесь, там много полезного

t.me

Косик Дмитрий | Торговец Кодом

Почему ваш AI-агент тупит и как это починить одним файлом

Первое! где это работает, а где нет

Что это такое простыми словами

Как создать

Что писать: четыре секции

1. О проекте

2. Как запустить

3. Что где лежит

4. Правила

Мой реальный пример

Как вносить изменения в файл

Как файл растет со временем

Как работает память между сессиями

Как управлять передачей контекста

Если проект большой

Чего не нужно писать

Итого