Obsidian и Claude Code: как подключить агента к заметкам

Obsidian и Claude Code связываются без плагинов: заметки Obsidian лежат обычными Markdown-файлами в папке, и агент читает и правит их так же, как код. Откройте терминал в папке хранилища, запустите claude, и он уже видит все заметки. Остальное (файл с правилами, плагины, скиллы) делает связку удобнее, но не обязательно.

Почему Obsidian и Claude Code вообще дружат

Obsidian хранит заметки в хранилище (в английском интерфейсе vault). По документации это просто папка на диске с подпапками и файлами .md, а настройки лежат рядом в скрытой папке .obsidian. Никакой базы, никакого облака по умолчанию.

Obsidian сам подхватывает изменения, сделанные другими программами. Агент дописал заметку, вы видите её в Obsidian сразу, без перезагрузки.

Сам Obsidian для личного пользования бесплатный. Для связки с агентом платное не нужно: ни синхронизация Sync, ни публикация Publish, ни коммерческая лицензия.

Зачем это всё? Агент каждый раз начинает с чистого листа: по документации Claude Code каждая сессия стартует с пустым контекстом. А в Obsidian у вас уже есть всё, что вы знаете о проекте: идеи, решения, заметки со встреч, тексты. С доступом к ним агент читает ваше решение месячной давности, а не спрашивает заново. Ваш второй мозг становится и его памятью.

Как подключить Obsidian к Claude Code: три шага

1. Запустите агента в папке хранилища

Это та папка, которую вы выбрали, когда создавали хранилище. Откройте в ней терминал и запустите:

cd путь/к/хранилищу
claude

Всё, связка работает. Попросите что-нибудь простое: «найди заметки про клиентов за сентябрь и собери список открытых задач». Агент пройдёт по файлам и ответит.

Если заметок тысячи, не просите «посмотри всё». Называйте папку: «в Проекты/Сайт найди...». Так и быстрее, и лимит Claude Code уходит медленнее.

2. Напишите агенту CLAUDE.md

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

Первую версию соберёт сам агент: команда /init изучит папку и создаст файл. Потом допишите руками. Например:

# Хранилище

- Ничего не перемещай, не переименовывай и не удаляй без спроса.
- Проекты: папка «Проекты», одна заметка на проект.
- Входящие: «Входящие», сюда всё новое.
- Ссылки между заметками в формате [[Название]].
- Устаревшее предложи перенести в «Архив».
- Перед правкой больше трёх заметок покажи план.

Большой файл можно разбить: строка @Проекты/правила.md в CLAUDE.md подключит ещё одну заметку. Если вы работаете и с Codex, ему нужен файл AGENTS.md. Claude Code с версии 2.1.277 тоже читает AGENTS.md, так что можно держать один файл на двоих. Codex ищет его от корня Git-репозитория, поэтому надёжнее, когда хранилище лежит в Git (с плагином Obsidian Git ниже так и будет).

3. Закройте то, что агенту видеть не нужно

В хранилище часто лежит личное: дневник, медицинские документы, пароли (не надо так, но бывает). Запретить агенту читать папку можно в .claude/settings.json внутри хранилища:

{
  "permissions": {
    "deny": ["Read(./Личное/**)"]
  }
}

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

Плагины и скиллы для связки Obsidian и Claude

Если терминал неудобен, ИИ в Obsidian встраивают плагинами. Звёзды и загрузки сверены 12.10.2026.

Claudian: агент прямо в Obsidian

Claudian ставится из каталога плагинов. В Settings откройте Community plugins: если там включён Restricted Mode, сначала нажмите Turn on community plugins, иначе каталог не откроется. Дальше Browse, поиск по названию, Install и Enable. Нужен Obsidian 1.13.0 или новее. Внутри он запускает агента, который у вас уже стоит, так что Claude Code нужен всё равно, а к нему подписка или ключ API. Работает только на компьютере, на телефоне нет.

Скиллы kepano/obsidian-skills

Набор учит агента особенностям Obsidian: ссылкам [[...]], базам Bases, холстам Canvas и официальному CLI. У меня агент без подсказки писал [текст](файл.md) там, где в хранилище приняты [[Название]]. Хватает и строки про формат ссылок в CLAUDE.md, но скиллы надёжнее. Ставится двумя командами прямо в Claude Code:

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

Первая подключает каталог, вторая ставит сами скиллы. Проверить, что они на месте, можно командой /skills.

Как выбирать и ставить скиллы вообще, я разбирал в статье про скиллы для Claude Code.

Obsidian через MCP

Если агент работает не в папке хранилища (например, вы в папке проекта сайта, а заметки лежат отдельно), хранилище подключается как MCP-сервер через плагин Local REST API. Поставьте его из каталога, как Claudian, и скопируйте API-ключ в его настройках (Settings, Local REST API). Потом в терминале:

claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer ВАШ_КЛЮЧ"

Команда из README плагина. Проверьте подключение: в Claude Code наберите /mcp, сервер должен быть в списке подключённых. Не подключается, скорее всего, дело в сертификате: у плагина он самодельный. Новичку проще обойти его через HTTP. Включите в настройках плагина HTTP-сервер (Enable HTTP server), удалите старую запись и добавьте сервер заново по другому адресу:

claude mcp remove obsidian
claude mcp add --transport http obsidian http://127.0.0.1:27123/mcp/ --header "Authorization: Bearer ВАШ_КЛЮЧ"

Второй выход из README: скачать сертификат по адресу https://127.0.0.1:27124/obsidian-local-rest-api.crt и добавить его в доверенные в вашей системе.

И помните, что сервер работает внутри Obsidian: закрыли приложение, хранилище для агента пропало.

По умолчанию сервер подключается только к текущему проекту. С флагом --scope user он будет во всех ваших проектах.

Obsidian CLI

С версии 1.12 у Obsidian есть свой CLI. Включается в Settings, раздел General, пункт Command line interface. Через него агент ищет по хранилищу и создаёт заметки по шаблонам командами вроде obsidian search query="встреча". Нужна установка Obsidian 1.12.7 или новее, и приложение должно быть запущено. Чтобы агент им пользовался, допишите в CLAUDE.md «для поиска по заметкам используй obsidian search» или поставьте скилл obsidian-cli из набора kepano.

Почему мой CLAUDE.md начинается с запрета

У меня в хранилище есть папка с вопросами учеников из чата хаба. Раньше раз в неделю я сам их перечитывал, чтобы понять, какой гайд писать следующим. Теперь прошу агента: «сгруппируй вопросы за неделю по темам и покажи, какие повторяются». Пять минут вместо вечера.

Первая попытка, честно, вышла кривой. В CLAUDE.md не было ни слова про архив, и агент «навёл порядок»: разложил старые вопросы по новым папкам и переименовал их по датам. Ссылки между заметками поехали (разбирался по истории Git, лол). С тех пор первая строка моего CLAUDE.md та же, что в образце выше: ничего не перемещать, не переименовывать и не удалять без спроса.

Так что, если начинать сегодня, то с той же строки в CLAUDE.md и с Obsidian Git. Плагины подождут, пока не начнёт мешать терминал, а MCP, пока заметки не понадобятся агенту в другом проекте.