Файли, які читає 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 (безкоштовно, бета):
- Додай теку проєкту в розділ Мої папки. Файли, які пише Claude Code, як-от плани, специфікації та звіти, з’являються з позначкою N (новий) або U (оновлений). Відкрита нотатка перезавантажується, коли Claude Code або інший застосунок її змінює.
- Підсвітити зміни показує, що змінилося у файлі, який ти вже читаєш: синім додане, помаранчевим вилучене або змінене. Зручно для
MEMORY.mdчи плану, який Claude постійно оновлює. - Порівняти поруч показує дві версії. Якщо історію файлу ввімкнено, Файл › Показати історію… дає змогу повернутися до попередньої версії.
~/.claudeце прихована тека. На панелі відкриття натисни ⌘⇧. (Command-Shift-крапка), щоб показати приховані теки.- Без інтернет-з’єднання; твої нотатки залишаються на твоєму Mac.
PilcrowMD для Mac (бета) · Більше про читання файлів агентів
Поширені запитання
Claude ігнорує мій CLAUDE.md. Чому? Виконай /context у сеансі й перевір, що файл зазначено серед файлів пам’яті. Довгі або суперечливі файли виконуються менш надійно.
Чи слід додавати CLAUDE.local.md до Git? Ні, він призначений для твоїх власних нотаток. Додай його до .gitignore.
Чи можна читати ці файли на телефоні? Якщо тека проєкту синхронізується з Google Drive, додай її в «Мої теки» в PilcrowMD для Android. Відкрий нотатку, щоб побачити її найновішу версію; на Android немає живого перезавантаження.
Також для Mac: PilcrowMD для Mac (бета)