#CLAUDE.md: 65 строк для идеального Claude Code
Как настроить CLAUDE.md за 65 строк, чтобы Claude Code работал как отдел. Практическая инструкция с примерами и рекомендациями для разработчиков.
Почему CLAUDE.md важен для Claude Code
CLAUDE.md — это не просто текстовый файл. Это «руководство для ИИ», которое определяет, как Claude Code будет взаимодействовать с вашим проектом. Без него Claude работает как «черный ящик», а с ним — как отделённая команда. В примерах из практики (например, статья Карпаты) показано, что 65 строк в CLAUDE.md позволяют Claude читать структуру проекта как дерево директорий, автоматизируя рутинные задачи.
Пример конфига:
markdown# CLAUDE.md
## Основные правила
1. Все запросы должны быть структурированными: "Сделай X в директории Y".
2. Не изменяй файлы без явного разрешения.
3. Используй только команды из списка: `git`, `docker`, `npm`.
...
## Автоматизация
- Добавляй скрипты в папку /scripts.
- Указывай, какие файлы можно редактировать: `/etc/nginx/nginx.conf`, `/var/www/html/index.html`.
CLAUDE.md работает как «соглашение» между вами и Claude. Если он отсутствует или неоптимизирован, Claude начинает «гадать», что делать, как в примере из Reddit: качество упало.
Как 65 строк влияют на поведение
65 строк — это не «магическое число». Это результат итеративной оптимизации. Каждая строка должна отвечать за конкретный сценарий. Например, в статье на Habr автор описывает, как каждая строка CLAUDE.md проверяется на критерий: «Если убрать — Claude начнёт ошибаться?».
Практический пример:
markdown# CLAUDE.md
## Запреты
- Не используй команды, не указанные в списке.
- Не изменяй системные файлы без согласия.
## Автоматизация
- При запуске скрипта проверяй, есть ли в /logs ошибки.
- Если ошибка — остановись и уведомь пользователя.
Если строк слишком много (например, 300), Claude начинает «запутываться», как описано в посте на VC.ru. 65 строк — это баланс между детализацией и читаемостью.
Сравнение с реальной жизнью:
CLAUDE.md — как инструкция для механика по ремонту автомобиля. Если в ней 100 шагов, механик потеряется. Если 10 — он может выполнить задачу. Но 65 — это оптимальное количество: достаточно деталей, чтобы не ошибиться, но не слишком много, чтобы не запутаться.
Важно:
- Убедитесь, что каждая строка имеет цель.
- Проверьте, что без неё Claude не сможет выполнить задачу.
- Используйте золотой тест из практики.
Ключевые настройки в 65 строк
Примеры конфигураций
Вот как выглядит минимальный, но эффективный CLAUDE.md на 65 строк. Каждая строка выполняет конкретную функцию: определяет контекст, правила поведения, структуру проекта или автоматизацию.
markdown# Основные параметры
# Проект: Backend-сервис на Python с FastAPI
# Цель: Автоматизация тестирования и деплоя
# Приоритет задач
1. Выполнение тестов (pytest)
2. Генерация отчетов (Jinja2)
3. Деплой на Kubernetes
# Правила поведения
- Если ошибка в тесте — останавливай выполнение, но не ругайся.
- Если запрос неясный — уточняй: "Что именно нужно проверить?"
- Не меняй код без согласия: "Согласен на изменение?"
# Автоматизация
```bash
# Запуск тестов
pytest --cov=app
# Деплой через Helm
helm upgrade my-app ./charts
Иерархия директорий
CLAUDE.md должен находиться в корне проекта. Он читается рекурсивно:
bash# Пример структуры
project-root/
├── CLAUDE.md
├── src/
│ └── app.py
└── tests/
# Пример ошибки и исправление
```markdown
# Неправильно
- "Не работает" — слишком общо.
# Правильно
- "Если API возвращает 500 — проверь логи в /var/log/app.log"
**Источники:**
- [CLAUDE.md по заветам Карпаты](https://vc.ru/ai/2880346-claude-md-i-karpaty-kak-sdelat-claude-code-bolee-effektivnym)
- [10 настроек Claude Code](https://habr.com/ru/articles/1028988/)
---
### Глубокий анализ подхода Карпаты
Андрей Карпаты в своей статье (цитируем [тут](https://vc.ru/ai/2880346-claude-md-i-karpaty-kak-sdelat-claude-code-bolee-effektivnym)) подчеркивал, что 65 строк — это не магический номер. Это результат упрощения:
1. **Устранение избыточности**
Большинство настроек в оригинальных 300 строках были «убедительными», но не критичными. Карпаты советовал тестировать каждую строку: если удалить строку, и Claude начинает ошибаться — она нужна.
2. **Иерархия директорий**
CLAUDE.md в корне проекта позволяет Claude «видеть» структуру без дополнительных указаний. Например, если в `src/` есть `app.py`, то Claude автоматически понимает, что это основной код.
3. **Приоритезация задач**
Карпаты рекомендовал ограничиться 3-5 основными задачами. Это снижает когнитивную нагрузку на модель.
**Пример из практики:**
Форрест Чанг (цитируем [тут](https://uproger.com/claude-md-po-zavetam-karpaty-65-strok-kotorye-prevratili-claude-code-v-adekvatnogo-dzhuna/)) использовал этот подход для снижения ручного кодинга с 80% до 20%. Он добавил в `CLAUDE.md`:
```markdown
# Запрещенные действия
- Не выполняй код без явного запроса.
- Не меняй структуру проекта без согласия.
Это предотвращало «непредсказуемое» поведение модели.
Важно:
Если вы удалите строку о запрещенных действиях, Claude может начать выполнять код без указания — что приведет к ошибкам.
Источники:
Практические шаги по созданию CLAUDE.md
Шаг за шагом: создание идеального CLAUDE.md
1. Создайте файл CLAUDE.md в корне проекта
Файл должен быть в самом верхнем уровне иерархии. Это гарантирует, что Claude будет его читать первым. Пример структуры:
markdown# CLAUDE.md
## Контекст проекта
- Цель: автоматизация CI/CD для микросервисов
- Стек: Docker (v24.03), Kubernetes (v1.28), PostgreSQL (v15)
- Ключевые процессы: деплой через GitHub Actions, мониторинг через Prometheus
## Правила поведения
- При ошибке: не предлагать рефакторинг без контекста
- В ответах: всегда включать примеры кода
2. Определите иерархию директорий
CLAUDE.md должен читать структуру проекта как дерево. Пример:
markdown## Структура проекта
- /backend: микросервисы на Go
- /api: маршруты и валидация
- /frontend: React-приложение
- /components: повторно используемые UI-элементы
Это помогает Claude понимать контекст без дополнительных запросов.
3. Настройте режимы работы
Используйте acceptEdits для контроля изменений. В CLAUDE.md добавьте:
markdown## Режимы
- acceptEdits: true (режим "редактировать")
- guardrails:
- блокировка изменений без тестов
- запрет на удаление кода без документации
Источник: 10 настроек Claude Code, до которых большинство разработчиков не ...
4. Добавьте хуки для предотвращения ошибок
Хуки — это блокировки, которые останавливают Claude от выполнения опасных действий. Пример:
markdown## Хуки
- перед деплоем: запуск тестов в CI
- при изменении базы данных: миграция через Alembic
Если хук не сработает, Claude должен сообщить об этом, а не выполнять рискованные действия.
5. Проверьте каждую строку
Как советует Форрест Чанг из статьи Карпаты:
"Если убрать строку, Claude начнёт ошибаться?"
Удалите всё, что не критично. Например, изначальный шаблон CLAUDE.md может быть 300 строк, но оптимальный — 65.
Частые ошибки при создании CLAUDE.md
1. Слишком длинный файл
Многие разработчики пишут 100+ строк, но это снижает эффективность. Как отмечают в CLAUDE.md по заветам Карпаты:
"65 строк — это максимум. Каждая строка должна быть целенаправленной."
2. Отсутствие иерархии
Файл без структуры читается как «список задач». Например, вместо:
markdown## База данных
- PostgreSQL
- Миграции через Alembic
Пишут:
markdown- PostgreSQL
- Хост: db.example.com
- Пользователь: admin
- Миграции: Alembic (в /migrations)
3. Игнорирование acceptEdits
По умолчанию Claude может предлагать рефакторинг без контекста. Включите acceptEdits: true только в нужных случаях.
4. Отсутствие тестов в хуках
Хуки без автоматизации приводят к ошибкам. Например, если хук "до деплоя: запуск тестов" отсутствует, Claude может Deploy без проверки.
5. Недостаток примеров кода
Claude лучше работает с конкретными примерами. Вместо:
markdown## API
- GET /users
Пишите:
markdown## API
- GET /users:
- Пример запроса: `curl -X GET http://api.example.com/users`
- Ответ: JSON с полями id, name, email
Источник ошибок: Что-то не так - качество Claude Code резко упало
Часто задаваемые вопросы
Почему CLAUDE.md важен для Claude Code?
CLAUDE.md — это «руководство для ИИ», которая определяет, как Claude Code будет взаимодействовать с вашим проектом. Без него Claude работает как «черный ящик», а с ним — как отделённая команда. Например, в примерах из практики (как в статье Карпаты) показано, что 65 строк в CLAUDE.md позволяют Claude читать структуру проекта как дерево директорий, автоматизируя рутинные задачи. Это позволяет избежать ошибок, когда ИИ «гадает», что делать, и делает его поведение предсказуемым.
Как 65 строк влияют на поведение Claude?
65 строк — это результат итеративной оптимизации, где каждая строка отвечает за конкретный сценарий. Например, в примере из статьи на Habr каждая строка проверяется на критерий: «Если убрать — Claude начнёт ошибаться?». Это создаёт строгие правила поведения: запреты на использование не указанных команд, указания на редактируемые файлы и автоматизацию скриптов. Если количество строк меньше или больше, Claude может начать игнорировать важные ограничения или перегружаться информацией.
Что делать, если качество Claude Code резко упало?
Если качество упало, первым делом проверьте CLAUDE.md. Возможно, в нём отсутствуют ключевые правила (например, запреты на изменение системных файлов) или структура стала неясной. В примере из Reddit пользователь отметил, что ИИ начал вешать себя как «раздраженный инженер», потому что CLAUDE.md не содержал чётких инструкций. Нужно пересмотреть файл: убедитесь, что все команды указаны, а также, что каждая строка выполняет конкретную функцию.
Как структурировать CLAUDE.md для максимальной эффективности?
Структурируйте файл по логическим разделам: «Основные правила», «Запреты», «Автоматизация». Например, в примере из статьи Карпаты разделы включают правила поведения, список допустимых команд и указание на редактируемые файлы. Каждая строка должна быть краткой и конкретной, без общих фраз. Также важно использовать иерархию: заголовки (##) для разделов, списки для деталей. Это помогает Claude быстро находить нужные инструкции.
Можно ли использовать CLAUDE.md без соблюдения 65 строк?
Теоретически да, но это снижает эффективность. 65 строк — это не «магическое число», а результат оптимизации. Если убрать строки, которые критически важны (например, запреты на неправильные команды), Claude начнёт ошибаться. Однако если ваш проект прост, можно сократить количество строк, но тогда нужно вручную проверять, не нарушаются ли ключевые правила. Лучше придерживаться принципа: «если строка важна — оставляйте её».
Описание:
CLAUDE.md — это ключевой элемент настройки Claude Code, позволяющий автоматизировать рутинные задачи и снизить ошибки. 65 строк — оптимальное количество для баланса между детализацией и читаемостью.
Внутренние ссылки: