Claude и Obsidian работают вместе без особого плагина: в официальном графическом приложении Claude Code выберите локальную папку хранилища. CLI с той же папкой можно использовать как запасной способ; в обоих вариантах агент читает и редактирует Markdown-файлы только в заданных границах. Для безопасной работы понадобятся компьютер, локально доступная папка хранилища, резервная копия и короткие правила, запрещающие массовые переименования без подтверждения.
Что именно связывается и чего ожидать
Хранилище Obsidian, или vault, является папкой на локальном диске, а основной формат заметок в ней это .md. Это прямо описано в справке о хранилищах Obsidian и справке об импорте Markdown. Поэтому Claude Code не обязан знать внутренний интерфейс Obsidian: ему достаточно доступа к выбранной папке и понятного задания.
Связка подходит для разбора структуры, поиска дублей по смыслу, создания оглавления, унификации свойств и аккуратной правки текста. Она не даёт гарантии, что сторонние плагины Obsidian поймут любое изменение. Настройки в .obsidian, базы плагинов, Canvas-файлы и вложения лучше исключить из первой задачи.
Правило первой сессии: сначала только карта папок и план изменений, затем пробная правка одной копии заметки, и лишь после проверки работа с остальными файлами.
Задача и ожидаемый результат
Исходная ситуация: заметки уже лежат в Obsidian, но названия, свойства или связи между ними требуют порядка. Ожидаемый результат: Claude меняет только согласованные .md-файлы, сохраняет смысл и внутренние ссылки, а вы видите точный список правок.
- Обязательные условия: папка полностью загружена на компьютер, у вас есть отдельная резервная копия, Obsidian и Claude Code открывают одно и то же хранилище.
- Обязательные шаги: ограничить область, описать формат заметок, получить план, разрешить маленькую пробную правку, проверить её в Obsidian, затем расширять объём.
- Проверка: открыть изменённые заметки, пройти по внутренним ссылкам, выполнить поиск по старым названиям и сравнить список файлов до и после.
- Частые сбои: агент открыт не в той папке, облачный диск выгрузил часть файлов, синхронизация создала конфликтные копии, правило именования сформулировано неоднозначно.
- Граница метода: не загружайте чужие конфиденциальные записи, персональные данные и закрытые рабочие материалы, если у вас нет разрешения на такую обработку.
Учиться проще, когда уже видели результат. Завтра в 12:00 МСК на бесплатном мастер-классе ИИ-агент на ваших глазах выполняет задачу целиком, а в Claude Code за эфир собирают работающий сервис.
Посмотреть бесплатноПодготовьте хранилище без риска
Закройте незавершённую синхронизацию и убедитесь, что файлы доступны офлайн. Официальная инструкция Obsidian по синхронизации отдельно предупреждает о конфликтах при одновременном использовании нескольких служб и советует держать облачные файлы загруженными на устройство.
- Узнайте точный путь к vault через переключатель хранилищ Obsidian или системный проводник.
- Сделайте отдельную копию всей папки. Синхронизация полезна между устройствами, а снимок состояния перед массовой правкой нужен отдельно.
- В Claude Code откройте именно папку vault. Если используете терминал, сначала перейдите в неё командой
cd, затем запуститеclaude. Официальный быстрый старт Claude Code строится на том же принципе: агент работает из каталога проекта. - Попросите только перечислить папки, типы файлов и возможные риски. Не разрешайте менять заметки на этом шаге.
- Выберите одну некритичную заметку, создайте её копию и испытайте правило форматирования на ней.
По теме: Codex и Obsidian: как работать с заметками без потерь
Запишите правила в CLAUDE.md
Файл CLAUDE.md хранит постоянные инструкции проекта и загружается в начале сессии. Anthropic рекомендует писать конкретные и короткие правила, а не расплывчатые пожелания, что подтверждает документация по памяти Claude Code. Для vault это удобнее длинного повторяющегося сообщения.
# Правила хранилища Obsidian
- Меняй только файлы .md в папке Inbox.
- Не изменяй папку .obsidian и вложения.
- Не переименовывай файлы без отдельного подтверждения.
- Сохраняй YAML-свойства и внутренние ссылки [[...]].
- Перед записью покажи список затрагиваемых файлов.
- После записи перечисли старые и новые заголовки.
Файл задаёт контекст для поведения агента и ничего не блокирует на уровне системы. В официальной документации Anthropic подчёркнуто, что инструкции в CLAUDE.md направляют работу, а жёсткие разрешения настраиваются отдельно. Поэтому для первой задачи полезен режим планирования и ручное подтверждение записи. Подробнее об этом есть в разборе файла CLAUDE.md и статье про управление контекстом Claude.
Теория оживает, когда агент работает на ваших глазах. Завтра в 12:00 МСК на бесплатном мастер-классе ему ставят задачу голосом, он сам находит данные и сводит их в Google-таблицу, а в Claude Code за эфир проходят путь от идеи до сервиса.
Занять местоДайте первую задачу с проверяемым выходом
Безопасный пример: «Прочитай только папку Inbox. Найди заметки без заголовка первого уровня. Составь таблицу: путь, предложенный заголовок, причина. Ничего не меняй». После проверки таблицы второе задание может разрешить правку двух файлов и потребовать отчёт по каждой замене.
Для объединения дублей не просите «навести порядок во всём vault». Дайте критерий: две заметки считаются кандидатами на объединение только при совпадении предмета, периода и назначения. Если совпали лишь отдельные слова, Claude должен оставить их раздельно и предложить ссылку между ними.
Если вам сначала нужно понять сам инструмент, начните с материала что такое Claude Code. Для проверки доступности и конфигурации пригодится чек-лист Claude.
По теме: Cowork или Claude Code: что выбрать для работы в 2026
Как проверить результат после правки
- Откройте изменённые файлы через список Obsidian, а не только в отчёте Claude.
- Проверьте YAML-свойства, заголовок первого уровня, внутренние ссылки и встраивания.
- Найдите старые имена через поиск по всему vault. Остаток старой ссылки означает, что переименование нельзя считать завершённым.
- Сравните резервную копию и рабочую папку. Убедитесь, что
.obsidian, картинки и несогласованные каталоги не изменились. - Откройте граф или обратные ссылки только как дополнительную проверку. Главный критерий: нужная заметка открывается, ссылка ведёт к ней, а содержание не потеряно.
Если что-то пошло не так
- Claude не видит заметки: проверьте, что открыт корень vault, а файлы действительно загружены на диск.
- Появились дубликаты с пометкой conflict: остановите Claude, дождитесь окончания синхронизации и сравните версии вручную.
- Сломались внутренние ссылки: верните файлы из копии, затем повторите переименование маленькой группой с поиском всех вхождений старого имени.
- Изменился служебный каталог
.obsidian: откатите его отдельно и добавьте явный запрет вCLAUDE.md. - Большое хранилище не помещается в контекст: работайте папками, сначала создавайте индекс файлов, затем анализируйте выбранный набор.
Если vault существует только на телефоне или планшете и недоступен как обычная папка для Claude Code, этот способ работать не будет. Не стоит применять его и для автоматической массовой правки без резервной копии, для чужих закрытых материалов и для задач, где сохранность поведения нестандартного плагина важнее скорости редактуры.
Частые вопросы
Нужен ли специальный плагин Claude для Obsidian?
Нет, для работы с обычными заметками достаточно открыть локальную папку vault в Claude Code. Плагин может добавлять удобство, но создаёт ещё один уровень доступа и доверия.
Можно ли дать Claude доступ только к одной папке?
Да. Откройте нужный подкаталог как рабочую область или начните с инструкции читать только его. Для надёжной границы используйте разрешения файловой системы и режим планирования, а не только текстовое пожелание.
Сохранит ли Claude внутренние ссылки Obsidian?
Сохранит, если вы явно запретите менять синтаксис [[...]] и проверите все старые имена после переименования. Автоматической гарантии совместимости нет.
Можно ли обрабатывать всё хранилище сразу?
Технически возможно, но безопаснее идти папками. Маленькая пробная партия показывает, понимает ли агент ваши свойства, шаблоны и правила ссылок.
Хранилище Obsidian и Claude Code работают вместе. Завтра в 12:00 МСК на бесплатном мастер-классе Яков Юдин показывает агента, который каждый день делает работу за автора: собирает новости, расшифровывает аудио, готовит контент.
Занять место