Память и CLAUDE.md
Контекст проекта
Что такое память Claude Code и как она работает
Память (memory) в Claude Code — это набор текстовых файлов CLAUDE.md, которые автоматически подгружаются в контекст модели в начале каждой сессии. Это не «обучение» модели и не база данных: это обычный Markdown, который Claude читает как постоянные инструкции к проекту. Благодаря этому вам не нужно повторять в каждом запросе, что проект собирается через npm run build, использует TypeScript или что тесты лежат в определённой папке — модель уже знает это из файла памяти. Чем точнее и компактнее CLAUDE.md, тем меньше ошибок и лишних уточняющих вопросов.
Файлы памяти образуют иерархию (hierarchy), показанную ниже. Организационный уровень (managed) задаёт правила для всей компании, пользовательский ~/.claude/CLAUDE.md хранит ваши личные предпочтения для всех проектов, проектный .claude/CLAUDE.md коммитится в git и действует для всей команды, а CLAUDE.local.md — это персональные заметки, которые в git не попадают. Claude Code не выбирает один уровень, а объединяет их все: более специфичные инструкции дополняют общие. Через директиву импорта @path/to/file один файл может подтягивать другие — это и делают блоки @docs/api-conventions.md в примере выше: они разбивают большой CLAUDE.md на модули, чтобы его было проще поддерживать.
Используйте память для стабильных фактов о проекте: команды разработки, структура директорий, код-стайл, важные модули. Команда /memory (см. блок ниже) позволяет быстро дописать новое правило прямо из сессии — например, «всегда используй pnpm вместо npm» — и Claude сам добавит его в нужный файл. Главные ошибки: класть в память секреты и ключи API (файл коммитится в git), оставлять устаревшие инструкции (они вводят модель в заблуждение сильнее, чем их отсутствие) и раздувать файл огромными блоками кода. Держите CLAUDE.md коротким и актуальным, и память станет самой полезной частью настройки Claude Code.
Claude Code загружает инструкции из нескольких уровней. Все уровни объединяются:
Управляется организациейПравила организации, применяемые ко всем проектам сотрудников
~/.claude/CLAUDE.mdВаши персональные предпочтения для всех проектов
.claude/CLAUDE.md или CLAUDE.mdИнструкции для всей команды, коммитятся в git
CLAUDE.local.mdЛокальные настройки, не коммитятся в git
# CLAUDE.md ## Project Overview This is a Next.js 14 e-commerce application with TypeScript. ## Tech Stack - Next.js 14 with App Router - TypeScript 5.3 - Prisma ORM with PostgreSQL - Tailwind CSS + shadcn/ui ## Development Commands ```bash npm run dev # Start development server npm run test # Run Jest tests npm run lint # ESLint check npm run db:push # Push Prisma schema ``` ## Code Conventions - Use functional components with hooks - Prefer server components where possible - Use Zod for validation - All API routes should have error handling ## Directory Structure ``` src/ ├── app/ # Next.js app router ├── components/ # React components ├── lib/ # Utilities and helpers ├── prisma/ # Database schema └── types/ # TypeScript types ``` ## Important Files - src/lib/auth.ts — Authentication logic - src/lib/db.ts — Database client - prisma/schema.prisma — Data model
CLAUDE.md может импортировать другие файлы для модульности:
# CLAUDE.md ## Imports @docs/api-conventions.md @docs/testing-guide.md @.claude/rules/security.md ## Project specific rules ...
💡 Используйте @path/to/file для включения содержимого файла в контекст
Используйте /memory для быстрого добавления информации в память:
✓ Рекомендуется
- • Описание проекта
- • Команды для разработки
- • Структура директорий
- • Код-стайл и конвенции
- • Важные файлы и модули
- • Зависимости и их версии
✗ Не включать
- • Секреты и ключи API
- • Персональные данные
- • Огромные блоки кода
- • Устаревшую документацию
- • Информацию не для Claude
Советы по организации памяти
- 1.Держите CLAUDE.md актуальным — устаревшая информация мешает
- 2.Разбивайте на модули для больших проектов
- 3.Используйте CLAUDE.local.md для персональных настроек
- 4.Коммитьте .claude/CLAUDE.md в git для команды
Частые вопросы
Что такое CLAUDE.md и зачем он нужен?
CLAUDE.md — это текстовый Markdown-файл с постоянными инструкциями для проекта, который Claude Code автоматически подгружает в контекст в начале каждой сессии. В нём описывают команды сборки, структуру директорий, код-стайл и важные модули, чтобы не повторять это в каждом запросе. Это не обучение модели и не база данных, а обычные заметки, которые Claude читает как руководство.
Где хранятся файлы памяти Claude Code?
Память образует иерархию из нескольких уровней. Организационный уровень задаёт правила для всей компании. Пользовательский файл ~/.claude/CLAUDE.md хранит ваши личные предпочтения для всех проектов. Проектный .claude/CLAUDE.md коммитится в git и действует для всей команды. Файл CLAUDE.local.md — для персональных заметок, которые в git не попадают. Claude Code объединяет все уровни сразу.
Как добавить информацию в память Claude Code?
Используйте команду /memory прямо в сессии: введите её, укажите, что нужно запомнить (например, «всегда используй pnpm вместо npm»), и Claude сам допишет правило в нужный файл CLAUDE.md. Также можно отредактировать CLAUDE.md вручную. Через директиву @path/to/file один файл может импортировать другие, разбивая большой CLAUDE.md на модули.
Что нельзя записывать в CLAUDE.md?
Не кладите в память секреты и ключи API — файл коммитится в git и может утечь. Избегайте устаревших инструкций: они вводят модель в заблуждение сильнее, чем их отсутствие. Не раздувайте файл огромными блоками кода и персональными данными. Держите CLAUDE.md коротким и актуальным — так память приносит максимум пользы.
Этот урок — часть структурированного курса по LLM.
Мой путь обучения