CLAUDE.md: документируем проект для вайбкодинга

Что такое CLAUDE.md

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

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

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

Пример CLAUDE.md

# Проект: интернет-магазин на Next.js

## Стек
- Next.js 15 (App Router), TypeScript
- База: PostgreSQL через Prisma

## Команды
- npm run dev — запуск
- npm run build — сборка
- npm test — тесты

## Правила
- Компоненты — в src/components, стиль camelCase
- Не менять файлы в /legacy без явной просьбы
- Все тексты интерфейса — на русском

Такой файл на 15 строк экономит десятки повторяющихся объяснений и заметно поднимает точность агента.

AGENTS.md для Codex и других

У Codex от OpenAI аналогичный файл называется AGENTS.md — смысл тот же. Если работаете с несколькими агентами, можно держать оба или продублировать содержимое. Подробнее о разнице инструментов — в статье Claude Code или Codex.

Почему без него хуже

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