раздел 03

Память проекта: CLAUDE.md

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

Как это работает

Claude Code при запуске в директории ~/project/ ищет CLAUDE.md файлы по цепочке:

~/.claude/CLAUDE.md            <- глобальные правила (ваш стиль, языки)
~/project/CLAUDE.md            <- правила проекта (стек, конвенции)
~/project/frontend/CLAUDE.md   <- правила конкретной части

Всё, что в этих файлах, попадает в контекст автоматически. Не нужно копировать или подгружать через @.

Минимальный CLAUDE.md

# Project: ToDo App

## Stack
- Backend: FastAPI 0.115, SQLAlchemy 2.0, SQLite (dev) / Postgres (prod)
- Frontend: React 19, Vite 6, Tailwind 4, TanStack Query
- Deploy: Docker + docker-compose, прод на Selectel

## Conventions
- Имена API endpoints: kebab-case (/api/get-tasks, не /api/getTasks)
- Все async-handlers возвращают Pydantic-модель явно, без `dict`
- Frontend компоненты - .tsx, без default export

## Commands
- dev backend:  `uvicorn app.main:app --reload`
- dev frontend: `pnpm dev`
- tests:        `pytest && pnpm test`
- deploy:       `./deploy.sh`

## Что НЕ делать
- Не использовать FastAPI Depends для бизнес-логики - только для DI инфраструктуры
- Не писать комментарии типа `# add task to db` - имена функций должны говорить сами

С таким файлом вы больше не пишете "у нас FastAPI и React, имена в kebab-case, для тестов pytest..." в каждом чате.

Что в этом разделе

Мы разберём:

  1. Глобальный vs проектный CLAUDE.md - что писать в ~/.claude/CLAUDE.md (ваш стиль работы), а что в ./CLAUDE.md (правила конкретного проекта).
  2. Команда /init - Claude читает ваш репозиторий и сам предлагает черновик CLAUDE.md. За 30 секунд вы получаете осмысленный стартер.
  3. /remember и auto-memory - сохранение фактов на лету без редактирования файла. Особенно удобно для feedback-памяти ("больше не делай X, потому что Y").
  4. Готовые примеры - копипаст-стартеры для Python, Next.js, монорепо.

Подразделы

01
Глобальный и проектный CLAUDE.md
~/.claude/CLAUDE.md - ваши предпочтения. ./CLAUDE.md - правила конкретного проекта.
02
Команда /init
Claude читает репо и сам предлагает черновик CLAUDE.md - дальше вы редактируете.
03
Команда /remember и auto-memory
Как сохранять факты в память на лету. Когда это лучше, чем редактировать CLAUDE.md.
04
Готовые примеры CLAUDE.md
Python-проект, Next.js, монорепо, AI-команда - копипаст-стартеры.

Полезные ссылки