Claude Code + Obsidian: как дать нейросети долгую память

Зачем это нужно

Каждый новый чат с нейросетью начинается с чистого листа. Вы заново объясняете, над чем работаете, как называете папки, о чём договорились в прошлый раз. Знание живёт в вашей голове, а не в инструменте.

Obsidian решает половину задачи: это бесплатная программа для заметок, которая не прячет ваш текст в облаке. Каждая заметка — обычный текстовый файл с расширением .md в папке на вашем компьютере. Такую папку называют хранилищем (в интерфейсе — Vault).

Claude Code решает вторую половину. Это программа для терминала, и она умеет читать, создавать и править файлы в той папке, откуда её запустили.

Сложите два факта — и получите главный вывод этого разбора.

Главное: MCP-сервер вам не нужен

Чтобы ИИ получил доступ к вашим заметкам, ставить не нужно ничего. Ни плагинов Obsidian, ни MCP-серверов, ни ключей API. Достаточно запустить Claude Code внутри папки хранилища — файлы он увидит сам.

Это противоречит половине статей в интернете, но проверяется за минуту. MCP нужен другим программам — Claude Desktop, ChatGPT, Cursor — у которых доступа к вашим файлам нет. К этому вернёмся в конце.

Что такое терминал

Окно, где вы печатаете команды текстом. На Windows это PowerShell: нажмите «Пуск» и наберите «PowerShell». На macOS — Терминал (Программы → Утилиты). Ничего страшного там нет: вы вводите строку и нажимаете Enter.

Шаг 1. Установите Obsidian

Откройте сайт obsidian.md и нажмите Download. Программа бесплатна для личного использования; есть версии для Windows, macOS, Linux, iOS и Android.

Запустите её и выберите «Create new vault» — создать новое хранилище. Укажите пустую папку, например C:\Users\вы\Vault. Запомните этот путь: он понадобится дважды.

Шаг 2. Установите Claude Code

Понадобится подписка Claude — Pro, Max или Team — либо аккаунт Claude Console с оплаченными кредитами. Установка занимает одну команду.

Проверьте, что всё встало: команда claude --version должна показать номер версии. Если у вас уже стоит Node.js 18 или новее, сработает и npm install -g @anthropic-ai/claude-code.

Шаг 3. Запустите ИИ внутри хранилища

Зайдите в папку хранилища командой cd и запустите claude. При первом запуске откроется браузер — войдите в аккаунт. Позже сменить его можно командой /login прямо в сессии.

Проверьте связку сразу: попросите «перечисли, какие заметки лежат в этой папке». Если ИИ их видит — всё готово, дальше только настройка.

Шаг 4. Дайте правила: файл CLAUDE.md

Создайте в корне хранилища файл CLAUDE.md. Claude Code читает его в начале каждой сессии. Внутри — как называть файлы, куда что класть, чего не делать, как выглядит шапка заметки.

Быстрый способ: команда /init внутри сессии создаст черновик, который останется поправить под себя.

Важное ограничение: держите файл короче 200 строк. Он целиком попадает в контекст каждой сессии, и чем он длиннее, тем хуже ИИ следует правилам.

Шаг 5. Включите долгую память

Кроме ваших правил у Claude Code есть авто-память: он сам записывает выводы, которые пригодятся в следующих сессиях. Живёт она не в хранилище, а рядом с настройками программы — в папке ~/.claude/projects/<ваш-проект>/memory/.

Внутри лежит MEMORY.md — краткий указатель, который грузится в начало каждой сессии (первые 200 строк или 25 КБ), и отдельные файлы с подробностями, которые ИИ читает по необходимости.

Команда /memory покажет, что именно загружено, и откроет папку. Всё это обычный markdown: читайте, правьте, удаляйте.

Разница простая: CLAUDE.md пишете вы — это правила. Авто-память пишет ИИ — это его выводы.

Шаг 6. Закройте личное

В хранилище наверняка есть то, что нейросети видеть незачем: паспорта, пароли, дневник. Создайте файл .claude/settings.json внутри хранилища и перечислите запреты в разделе permissions.deny.

Три мифа, которые кочуют по статьям

Материал я собирал по официальной документации и проверял командами, а не пересказом. Три утверждения встречаются почти везде — и все три неверны.

Миф первый: «установите пакет @modelcontextprotocol/server-obsidian». Такого пакета не существует. Проверьте сами: npm view @modelcontextprotocol/server-obsidian отвечает ошибкой 404. Рабочий пакет называется obsidian-mcp, автор Steven Stavrakis, лицензия MIT.

Миф второй: «MCP-серверы прописываются в ~/.claude/settings.json». Нет. У Claude Code для этого отдельные файлы: ~/.claude.json для всех проектов и .mcp.json для одного. Проще вообще не трогать их руками, а выполнить claude mcp add. Файл settings.json отвечает за права и поведение, но не за MCP.

Миф третий: «.claudeignore спрячет секреты». Не спрячет. Claude Code этот файл молча игнорирует — он читает то, что вы считали закрытым. Единственный рабочий способ — permissions.deny.

Если MCP всё-таки нужен

Он понадобится, когда обращаться к заметкам хочется не из Claude Code, а из Claude Desktop, ChatGPT или Cursor: у них доступа к файлам нет. Тогда ставится obsidian-mcp и в конфиг клиента добавляется путь к хранилищу.

Перед первым запуском сделайте резервную копию хранилища. Об этом прямым текстом просит сам автор пакета: сервер умеет не только читать, но и удалять заметки.

Коротко

Obsidian хранит знание в файлах, которые принадлежат вам. Claude Code умеет работать с файлами напрямую. CLAUDE.md объясняет ИИ ваши правила, авто-память копит его собственные выводы, permissions.deny закрывает лишнее. Всё вместе даёт то, чего не даёт ни один чат: ИИ, который помнит ваш контекст завтра.