Инструменты разработчика 27.08.2026 чтения обновлено 10.08.2026

Claude + Obsidian: как собрать второй мозг на своих заметках

Как подключить Claude к Obsidian: через Claude Code в папке vault или MCP-сервер. Пошаговый гайд с командами, CLAUDE.md и реальными сценариями.

Андрей Сарапулов редактор

Claude + Obsidian: как собрать второй мозг на своих заметках

Почему именно Obsidian

Большинство приложений для заметок хранят данные в проприетарных форматах или в облаке сервиса. Notion – база данных на серверах Notion. Evernote – своя экосистема с экспортом, который всегда немного кривой. Obsidian устроен иначе: каждая заметка – это обычный .md-файл в папке на вашем диске. Никакой скрытой базы данных, никакой привязки к платформе. Открываете папку в любом редакторе – видите все файлы.

Для связки с ИИ это принципиально важно. Claude Code работает с файловой системой напрямую, а чат-версия Claude через MCP тоже читает и пишет обычные текстовые файлы. Добавьте к этому систему двунаправленных ссылок – и агент читает не только отдельные файлы, но и видит, как идеи связаны друг с другом. Граф связей, теги, фронтматтер – всё это метаданные, которые помогают Claude ориентироваться в базе и давать точные ответы с указанием источника.

Ещё один аргумент – приватность данных под вашим контролем. Файлы лежат локально, вы сами решаете, что передавать в контекст модели, а что исключить. Это особенно актуально, если в хранилище есть рабочие документы или личные записи, которые не должны уходить в облако без вашего ведома.

Способ 1: Claude Code в папке хранилища

Это самый прямой путь. Claude Code – агентный инструмент командной строки, который запускается в любой директории и работает с файлами внутри неё. Вы просто открываете терминал в папке вашего vault – и агент видит все .md-файлы, может их читать, редактировать, создавать новые и проставлять между заметками.

Если Claude Code у вас ещё не установлен, сначала пройдите по гайду по установке – там всё расписано по шагам. После установки достаточно одной команды в терминале:

cd ~/Documents/my-vault
claude

Агент запустится в контексте вашего хранилища и сразу сможет отвечать на вопросы по заметкам, искать нужные файлы и вносить правки.

Файл CLAUDE.md: инструкция для агента

Главный инструмент настройки – файл CLAUDE.md в корне vault. Claude Code автоматически читает его при каждом запуске и использует как системный промпт. Именно здесь вы описываете правила работы с вашей базой: структуру папок, формат заметок, соглашения по именованию файлов и тегам.

Минимальный рабочий CLAUDE.md для личной базы знаний выглядит примерно так:

# Правила работы с хранилищем

## Структура папок
- 00-inbox/ – необработанные заметки и черновики
- 10-projects/ – активные проекты
- 20-areas/ – постоянные темы и зоны ответственности
- 30-resources/ – справочные материалы
- 50-daily/ – ежедневные заметки

## Формат заметок
Каждая заметка начинается с YAML-фронтматтера:
---
tags: [тег1, тег2]
date: YYYY-MM-DD
status: draft | active | archived
---

## Ссылки
Используй  для связей между заметками.
В конце каждой заметки добавляй раздел ## Связанные заметки.

## Язык
Заметки на русском. Имена файлов – латиница, через дефис.

После того как CLAUDE.md создан, агент будет соблюдать эти правила при любых операциях с файлами – не нужно каждый раз объяснять структуру заново.

Примеры запросов к агенту

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

Найди все заметки, где упоминается [тема], и собери краткое резюме с указанием файлов.

Создай заметку-конспект по этому тексту: [вставить текст].
Используй шаблон из папки _templates/note.md.

Проверь заметки в папке 00-inbox/ и предложи, в какие разделы их переместить.
Расставь теги согласно правилам из CLAUDE.md.

Найди заметки, которые тематически связаны, но не имеют  друг на друга.
Предложи, какие связи добавить.

Важный момент: перед первым запуском с правами на запись сделайте резервную копию хранилища или инициализируйте git-репозиторий внутри vault командой git init. Агент будет реально изменять файлы, и если что-то пойдёт не так при массовой правке, откат через git займёт секунды. Это не перестраховка – это просто хорошая практика при любой автоматической работе с файлами.

Ещё один нюанс – файл .claudeignore в корне vault. Он работает по принципу .gitignore: перечисляете в нём папки и файлы, которые агент не должен трогать. Например, папку с вложениями и изображениями, шаблоны, архив старых заметок. Это ограничивает контекст до действительно нужных файлов и снижает риск случайных правок.

Способ 2: чат Claude через MCP

Если терминал вам не близок или вы хотите работать с хранилищем прямо из интерфейса чата, есть второй путь – подключить Claude Desktop к vault через MCP. MCP (Model Context Protocol) – это стандартный протокол, который позволяет Claude обращаться к внешним источникам данных: файлам, базам данных, API. Для Obsidian существует два практичных варианта MCP-подключения, и они решают немного разные задачи.

Оба варианта требуют Claude Desktop – десктопного приложения, а не браузерной версии claude.ai. Скачать его можно на сайте Anthropic. После установки конфигурация MCP-серверов прописывается в файле ~/.claude/settings.json (macOS/Linux) или в аналогичном пути на Windows. Подробнее о том, как устроена эта конфигурация, написано в гайде по MCP-серверам для Claude Code.

Сервер файловой системы (Claude Desktop)

Самый простой вариант – встроенный MCP-сервер файловой системы. Он даёт Claude Desktop доступ к любой папке на вашем диске, включая vault Obsidian. Никаких дополнительных плагинов в Obsidian устанавливать не нужно – агент читает и пишет .md-файлы напрямую через файловую систему.

Чтобы подключить vault, откройте файл настроек Claude Desktop и добавьте в секцию mcpServers следующее:

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents/my-vault"
      ]
    }
  }
}

Путь к vault укажите свой. После перезапуска Claude Desktop в чате появится доступ к файлам хранилища: можно читать заметки, создавать новые, переименовывать и перемещать файлы. Этот способ работает без интернета и без запущенного Obsidian – агент работает напрямую с папкой. Из ограничений: нет понимания метаданных Obsidian, поиск идёт по содержимому файлов без учёта тегов и фронтматтера.

MCP-сервер Obsidian (Local REST API, теги и фронтматтер)

Второй вариант сложнее в настройке, но даёт Claude понимание внутренней логики Obsidian – тегов, фронтматтера, обратных ссылок. Он строится на плагине Local REST API для Obsidian и MCP-сервере, который общается с этим API.

Сначала установите плагин в самом Obsidian: откройте «Настройки» → «Сторонние плагины» → «Обзор», найдите Local REST API и включите его. Плагин поднимает локальный HTTP-сервер на порту 27123 и генерирует API-ключ – он понадобится для конфигурации MCP.

Затем добавьте MCP-сервер в настройки Claude Desktop:

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": ["-y", "@obsidian/mcp-server"],
      "env": {
        "OBSIDIAN_API_KEY": "ваш-ключ-из-плагина",
        "OBSIDIAN_PORT": "27123"
      }
    }
  }
}

После перезапуска Claude Desktop получает доступ к полноценному поиску по заметкам с учётом тегов, может читать граф ссылок, фильтровать заметки по статусу во фронтматтере и получать бэклинки. Это особенно полезно, если ваша база хорошо размечена: агент находит нужные заметки точнее, чем при простом поиске по тексту. Единственное условие – Obsidian должен быть запущен, иначе Local REST API не отвечает.

Пять сценариев для второго мозга

Подключить Claude к Obsidian – это только половина дела. Важнее понять, какие задачи эта связка решает лучше всего. Вот пять сценариев, которые реально меняют работу с базой заметок.

Поиск и ответы по своей базе

Это самый очевидный сценарий, но и самый ценный. Встроенный поиск Obsidian ищет по точному совпадению слов – если вы написали «продуктивность», а ищете «эффективность», он ничего не найдёт. Claude ищет по смыслу: понимает синонимы, контекст, связанные идеи.

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

Еженедельные и ежедневные дайджесты

Если вы ведёте ежедневные заметки или регулярно добавляете новые материалы в inbox, агент может собирать из них структурированные обзоры. Один запрос раз в неделю – и у вас готовый дайджест: что нового появилось в базе, какие темы развивались, какие задачи остались открытыми.

Для разработчиков это особенно удобно в связке с базой знаний проекта: агент читает заметки за неделю, выделяет принятые архитектурные решения, фиксирует изменения в подходах. Такой дайджест можно сохранять прямо в vault как отдельную заметку в папке daily/ – и через месяц у вас будет хроника того, как менялось мышление по проекту.

Наведение порядка: теги, ссылки, дедупликация

Со временем любая база заметок обрастает хаосом: заметки без тегов, дубли одной и той же идеи в разных папках, файлы в inbox, до которых руки не доходят неделями. Claude справляется с этим за один сеанс.

Попросите агента проверить папку inbox и предложить теги и разделы для каждой заметки – он пройдётся по файлам и выдаст список предложений, которые вы можете принять или скорректировать. Или попросите найти заметки на похожие темы и предложить, какие из них стоит объединить. Агент не удаляет файлы сам по себе – он предлагает варианты, а решение остаётся за вами. Это разумный баланс между автоматизацией и контролем.

Конспекты по вашему шаблону

Вы нашли статью, посмотрели лекцию, прочитали главу книги. Обычно это заканчивается тем, что материал сохраняется «на потом» и больше не открывается. Claude превращает этот процесс в структурированную заметку за минуту.

Вставляете текст или расшифровку – агент создаёт заметку по вашему шаблону из папки _templates/. Если шаблон предполагает разделы «Ключевые идеи», «Цитаты», «Связанные заметки» и «Вопросы для размышления» – именно так заметка и будет оформлена. Фронтматтер с тегами и датой агент заполнит сам. Через полгода такой работы в базе накапливается слой структурированных конспектов, по которым Claude отвечает на вопросы с точными цитатами и ссылками на источники.

Автосвязывание заметок

Один из самых трудоёмких аспектов ведения базы в Obsidian – поддерживать актуальные между заметками. Когда заметок сотни, вы физически не помните, что написали три месяца назад и как это связано с тем, что пишете сегодня.

Агент решает эту задачу системно: читает выбранную заметку, ищет по всему vault тематически близкие файлы и предлагает список ссылок для добавления. Можно запустить этот процесс сразу для всей базы – агент пройдётся по каждому файлу и составит карту потенциальных связей. После вашего одобрения он проставит в нужных местах. Граф связей в Obsidian из разрозненных точек превращается в плотную сеть – и именно по этой сети Claude потом строит смысловой поиск.

Как не сломать хранилище

Первое правило работы с агентом в vault – резервная копия перед любым экспериментом. Самый удобный способ – инициализировать git-репозиторий прямо внутри папки хранилища: git init в корне vault, затем первый коммит со всеми файлами. Дальше достаточно делать коммит перед каждой сессией с агентом. Если что-то пойдёт не так при массовой правке – git checkout . откатит все изменения за секунды. Это не параноя, а базовая гигиена при любой автоматической работе с файлами.

Если вы пользуетесь синхронизацией – Obsidian Sync, iCloud или Dropbox – будьте аккуратны с массовыми операциями. Когда агент за один сеанс переименовывает или перемещает десятки файлов, синхронизатор может не успеть обработать очередь изменений и создать конфликты версий. Практичное решение: запускать массовые правки, когда Obsidian Sync отключён или когда вы точно знаете, что работаете с одного устройства. После завершения – дать синхронизатору время нагнать изменения, прежде чем открывать vault на другом устройстве.

Отдельный вопрос – приватность. Когда Claude обрабатывает заметки, их содержимое уходит в облако Anthropic для обработки. Если в хранилище есть чувствительные данные – пароли, токены, личная переписка, конфиденциальные рабочие документы – стоит либо вынести их в отдельный vault, который агент не видит, либо добавить соответствующие папки в .claudeignore. Это не технический недостаток связки, а просто осознанный выбор: вы сами решаете, что попадает в контекст модели.

Ещё один практичный совет – начинать с небольших операций, а не сразу запускать агента на весь vault. Попросите его разобрать одну папку, создать несколько заметок, расставить теги в десятке файлов. Посмотрите на результат, убедитесь, что агент правильно понял правила из CLAUDE.md, и только потом масштабируйте. База заметок – это то, что вы строили месяцами, и торопиться с автоматизацией не нужно.

Вопросы и ответы

Нужен ли платный Obsidian?

Нет. Базовая версия Obsidian полностью бесплатна для личного использования и включает всё необходимое для связки с Claude: локальные файлы, плагины сообщества, в том числе Local REST API. Платить придётся только если вам нужна официальная синхронизация между устройствами через Obsidian Sync – это отдельная подписка от $4 в месяц. Но для работы с Claude она не обязательна: синхронизировать vault можно через iCloud, Dropbox или git.

Плагины сообщества, включая Local REST API для MCP-подключения, устанавливаются бесплатно прямо из интерфейса Obsidian. Единственное, что нужно сделать – отключить «Безопасный режим» в настройках сторонних плагинов, после чего открывается каталог со всеми доступными расширениями.

Сколько стоит со стороны Claude?

Claude Pro стоит от $20 в месяц – это минимальный тариф для доступа к Claude Code и расширенным возможностям чата. Альтернатива – работать через API Anthropic напрямую, тогда платите только за фактически использованные токены, без фиксированной подписки. Для разовых экспериментов API может оказаться дешевле, для ежедневной работы с базой заметок Pro-подписка обычно выгоднее.

Для пользователей из России оплата доступна через зарубежную карту – подробнее об этом читайте в разделе Оплата зарубежных сервисов.

Можно обойтись без терминала?

Да. Если работа в командной строке вам не близка, используйте Claude Desktop с MCP-сервером файловой системы – это полноценный чат-интерфейс с доступом к vault. Устанавливаете Claude Desktop, прописываете путь к папке хранилища в конфигурации, перезапускаете – и дальше работаете через обычный чат. Никакого терминала, никаких команд.

Единственное, от чего придётся отказаться в этом случае, – некоторые возможности Claude Code: запуск агентных сценариев через командную строку, файл CLAUDE.md как системный промпт, автоматизация через cron. Для большинства задач с заметками – поиска, конспектирования, наведения порядка – чат-интерфейс с MCP справляется вполне достаточно.

Заменяет ли это встроенный поиск Obsidian?

Не заменяет, а дополняет – и это принципиальная разница. Встроенный поиск Obsidian быстрый и точный: он мгновенно находит точное вхождение слова или фразы в любом файле. Claude работает иначе – он понимает смысл запроса и находит тематически близкие заметки, даже если нужное слово в них не встречается буквально.

Кроме того, Claude ещё и действует: создаёт заметки, расставляет теги, проставляет ссылки, собирает дайджесты. Встроенный поиск Obsidian этого не умеет – он инструмент навигации, а не работы с контентом. Удобнее всего использовать оба инструмента по назначению: быстрый поиск конкретного файла – через Obsidian, смысловые запросы и операции с базой – через Claude.