Claude Code memory: /init, CLAUDE.md и шорткат # — с картинками
Без памяти Claude Code всё забывает между сессиями. Этот разбор запускает /init на реальном проекте Next.js, читает сгенерированный CLAUDE.md, добавляет правило из чата через # и проверяет, что Claude действительно следует ему — каждый шаг сверен по скриншотам.
TL;DR — память Claude Code в четырёх строках
- Запустите /init один раз на проект: Claude сканирует репозиторий — структуру папок, скрипты, управление состоянием — и пишет структурированный CLAUDE.md в корне.
- Этот файл автоматически попадает в контекст каждой сессии, так что написанные там правила формируют весь будущий кодогенерейт.
- Введите # и правило прямо в чате — оно запомнится на месте; выберите, где жить: проектная память (в коммитах), локальная проектная или пользовательская (~/.claude/CLAUDE.md).
- Обновляйте файл, когда меняется структура или стек — устаревшая память ведёт Claude не туда — а любой файл памяти можно снова открыть через /memory.
Claude Code Tutorial #2 - CLAUDE.md Files & /init
Канал:Net Ninja12:18
The CLAUDE.md file
Канал:Claude (official Anthropic channel)3:01
Claude Code's Memory System: The Full Guide
Канал:DIY Smart Code5:05
Manage Claude's memory — Claude Code documentation
Документация:code.claude.com
Кадры взяты из урока Net Ninja о CLAUDE.md (чистая запись VS Code); текст написан независимо и сверен с документацией Anthropic по памяти и официальным разбором CLAUDE.md.
Права на скриншоты остаются у их авторов; они используются с указанием авторства как визуальная документация. Каждый шаг глубокой ссылкой ведёт к точному моменту исходного видео.
От нулевой памяти к проекту, который Claude знает
1 · Генерируем CLAUDE.md через /init
- 1
Начните с /init
Когда впервые приносите Claude Code в проект, запустите /init до любых запросов кода. Тултип говорит точно: инициализирует новый файл CLAUDE.md с документацией кодовой базы. Claude прочитает проект заранее, чтобы будущим сессиям не пришлось.
/init — единственная команда, которую стоит запустить первой в новом репозитории.Смотреть на 0:30 - 2
Посмотрите, как Claude исследует, прежде чем писать
/init не угадывает: он строит собственный список todo — исследовать структуру репозитория, проанализировать package.json и исходники, проверить существующую документацию, затем создать CLAUDE.md с находками. Вы видите, как каждый пункт отмечается в реальном времени, — файл становится суммой реально прочитанного, а не заполненным шаблоном.
Список Update Todos во время инициализации — исследовать, проанализировать, потом писать.Смотреть на 1:42 - 3
Прочтите заголовок с правилами и команды, которые он записал
Сгенерированный файл открывается заголовком с правилами для Claude Code, затем идут Development Commands прямо из package.json — dev, build, lint, start. Именно эта секция не даёт Claude выдумывать собственный воркфлоу: настоящие скрипты уже в его контексте.
Начало файла: правила для Claude Code плюс настоящие npm-скрипты проекта.Смотреть на 2:56 - 4
Проверьте секции архитектуры и структуры
Пролистайте ниже: файл описывает обзор архитектуры (этот проект — блог на Next.js 15 с React 19 и Tailwind), карту Project Structure, где должны жить новые файлы, и заметки Data Persistence для слоя Hygraph CMS. Новые сессии наследуют всё это, не перечитывая ваш репозиторий.
Project Structure с выделенными путями плюс заметка о персистентности Hygraph.Смотреть на 2:30
2 · Добавляем память и доказываем, что она работает
- 5
Докажите, что память меняет поведение
Тест: после добавления «все переиспользуемые hooks лежат в этой папке hooks» в файл, в промпте просят hook предпочтений темы — и прямо говорят: пока нигде не использовать. Todo у Claude показывает создание hook в src/hooks/use-theme, а в конце он добавляет: «hook готов к использованию, но нигде не подключён, как вы и просили». Память на входе — поведение на выходе.
Hook попадает в папку, названную в файле памяти, — и уважает просьбу «пока не подключай».Смотреть на 6:40 - 6
Запомните новое правило через # прямо из чата
Файл можно не править руками. Начните сообщение с # — например, «# при создании новых компонентов страниц всегда добавляй ссылку на страницу в хедер» — Claude Code распознает это как память для хранения и спросит, где её разместить: проектная память, локальная проектная или пользовательская.
Шорткат # и открывающийся выбор из трёх мест назначения.Смотреть на 7:30 - 7
Различайте четыре типа памяти
Таблица в документации Anthropic — это карта: корпоративная политическая память для организаций, проектная память (./CLAUDE.md, в коммитах и на всю команду), пользовательская память (~/.claude/CLAUDE.md, ваши глобальные предпочтения) и локальная проектная память (./CLAUDE.local.md, личная и вне git) — документация помечает её устаревшей в пользу импорта неотслеживаемых файлов из проектной памяти, хотя в пикере опция всё ещё появляется.
Официальная таблица типов памяти: расположение, назначение и с кем делится каждый файл.Смотреть на 10:50 - 8
Убедитесь, что правило попало в файл
Выбор проектной памяти добавляет правило в CLAUDE.md проекта — и вот оно в конце файла: «при создании новых компонентов страниц всегда добавляй ссылку на страницу в хедер». Со следующей сессии эта строка едет в контексте автоматически.
Новое правило сохранено в конце закоммиченного CLAUDE.md.Смотреть на 11:48
3 · Управляем файлами памяти каждый день
- 9
Проверьте память свежей задачей
Теперь попросите страницу About и смотрите план: «Создам новую страницу About и добавлю ссылку на неё в хедер согласно вашей инструкции в памяти», причём «Add About page link to header navigation» — отдельный пункт todo. Правило, записанное через # два шага назад, ведёт задачу, где его ни разу не повторяли. (Честное предупреждение из видео: Claude может добавить ссылки и на страницы, о которых вы не просили — такое расползание объёма обуздывается строчкой в том же файле.)
«…согласно вашей инструкции в памяти» — todo-список доказывает, что правило активно.Смотреть на 9:37 - 10
Откройте любой файл памяти через /memory
Команда /memory перечисляет все файлы памяти с их расположением: закоммиченная проектная память в ./.CLAUDE.md, локальная память с gitignore в ./.CLAUDE.local.md и глобальный пользовательский файл в ~/.claude/CLAUDE.md. Выберите — откроется в редакторе; в файле этого проекта насчитано 11 записей.
Select memory to edit — все три скоупа в одном пикере.Смотреть на 11:22 - 11
Правьте как обычный файл
Claude Code подтверждает «Opened project memory at ./.CLAUDE.md» и открывает файл в VS Code с подсказкой: задайте переменные окружения $EDITOR или $VISUAL, чтобы выбрать другой редактор. От /init до ежедневного ухода память — просто markdown-файл, за актуальностью которого следите вы.
«Opened project memory at ./.CLAUDE.md» — правьте и держите в актуальном состоянии.Смотреть на 12:06
Слои памяти и где живёт каждый файл
Четыре файла, четыре скоупа — выберите правильный, и память Claude Code перестанет быть лотереей:
- 1Проектная память — ./CLAUDE.md в корне репозитория. Отслеживается git, доступна каждому разработчику проекта. Пишите только о проекте: структура, конвенции, команды, фреймворки.
- 2Локальная проектная память — ./CLAUDE.local.md. Личные заметки для этого репозитория (ваши инструменты, ваши шорткаты), остаются неотслеживаемыми. По документации устарела — рекомендуемый паттерн — импорт неотслеживаемых файлов из проектной памяти, — но на момент записи опция всё ещё есть в пикере #.
- 3Пользовательская память — ~/.claude/CLAUDE.md в домашней директории. Ваши глобальные предпочтения на все проекты машины: стиль кода, язык ответов, личные воркфлоу.
- 4За пределами CLAUDE.md — свежие сборки Claude Code добавляют систему автоматической памяти (MEMORY.md и тематические файлы в ~/.claude/projects/), которую Claude ведёт сам, отдельно от файла инструкций, плюс @-импорты, подтягивающие другие документы в контекст. Отключается через CLAUDE_CODE_DISABLE_AUTO_MEMORY=1, если нужны только файлы инструкций.
На каком бы слое вы ни сидели, привычка из видео одна: память — это не «создал и забыл». Меняется структура, пакеты или конвенции — обновляйте файл: устаревшая память хуже отсутствующей, потому что Claude уверенно следует ей.