Файли CLAUDE.md і пам’яті в Claude Code: пояснення

Claude Code використовує файли Markdown для інструкцій і пам’яті. Інструкції ти даєш в CLAUDE.md. Власні нотатки він веде у файлах пам’яті. А коли ти просиш, він пише плани, специфікації та звіти як файли .md у твоєму проєкті. Ця сторінка показує, де лежить кожен файл і як зручно їх читати.

Файли, які читає Claude Code

ФайлДеДля чого
Інструкції користувача~/.claude/CLAUDE.mdТвої вподобання в кожному проєкті
Інструкції проєкту./CLAUDE.md або ./.claude/CLAUDE.mdПравила команди, спільні через Git
Локальні інструкції./CLAUDE.local.mdТвої власні нотатки до одного проєкту; додай його до .gitignore
Правила.claude/rules/*.md (один проєкт) або ~/.claude/rules/ (усі проєкти)Одна тема на файл; можна обмежити певними шляхами

Як вони завантажуються. Claude Code читає CLAUDE.md і CLAUDE.local.md у теці, з якої ти його запускаєш, і в кожній теці вище. Вони поєднуються, а не замінюються: від верхньої теки вниз, тож файл у теці, з якої ти запускаєш, читається останнім. CLAUDE.md у підтеці завантажується, коли Claude починає працювати з файлами там.

Імпорти. Рядок на кшталт @docs/style.md підтягує інший файл у твій CLAUDE.md.

Тримай його коротким. У документації радять менш ніж 200 рядків на один CLAUDE.md. Правила за темами перенеси у .claude/rules/.

AGENTS.md

Якщо в проєкті є AGENTS.md (файл, який читають Codex та інші агенти) і немає CLAUDE.md чи CLAUDE.local.md, Claude Code читає натомість AGENTS.md. Якщо є обидва, за замовчуванням він читає лише CLAUDE.md. Щоб використовувати один файл для обох, імпортуй його: додай @AGENTS.md у свій CLAUDE.md. Більше про AGENTS.md: сторінка про Codex.

Автоматична пам’ять: нотатки, які Claude пише сам

Автоматична пам’ять увімкнена за замовчуванням. Працюючи, Claude Code зберігає нотатки про тебе, твої відгуки, проєкт і про те, де що знайти. Вони лежать у:

~/.claude/projects/<project>/memory/

MEMORY.md там є індексом; перші 200 рядків (або 25 КБ) завантажуються на початку кожного сеансу. Автоматичну пам’ять можна вмикати й вимикати командою /memory.

Це звичайні файли Markdown, які можна читати й редагувати. Перевіряй їх час від часу: хибна нотатка впливає на кожен новий сеанс, доки ти її не виправиш чи не видалиш.

Читання цих файлів на Mac

На Mac, PilcrowMD (безкоштовно, бета):

PilcrowMD для Mac (бета) · Більше про читання файлів агентів

Поширені запитання

Claude ігнорує мій CLAUDE.md. Чому? Виконай /context у сеансі й перевір, що файл зазначено серед файлів пам’яті. Довгі або суперечливі файли виконуються менш надійно.

Чи слід додавати CLAUDE.local.md до Git? Ні, він призначений для твоїх власних нотаток. Додай його до .gitignore.

Чи можна читати ці файли на телефоні? Якщо тека проєкту синхронізується з Google Drive, додай її в «Мої теки» в PilcrowMD для Android. Відкрий нотатку, щоб побачити її найновішу версію; на Android немає живого перезавантаження.

Також для Mac: PilcrowMD для Mac (бета)