Claude и Obsidian: как работать с заметками через Claude Code

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

Что именно связывается и чего ожидать

Хранилище Obsidian, или vault, является папкой на локальном диске, а основной формат заметок в ней это .md. Это прямо описано в справке о хранилищах Obsidian и справке об импорте Markdown. Поэтому Claude Code не обязан знать внутренний интерфейс Obsidian: ему достаточно доступа к выбранной папке и понятного задания.

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

Правило первой сессии: сначала только карта папок и план изменений, затем пробная правка одной копии заметки, и лишь после проверки работа с остальными файлами.

Карта результата перед началом

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

• Обязательные условия: папка полностью загружена на компьютер, у вас есть отдельная резервная копия, Obsidian и Claude Code открывают одно и то же хранилище.
• Обязательные шаги: ограничить область, описать формат заметок, получить план, разрешить маленькую пробную правку, проверить её в Obsidian, затем расширять объём.
• Проверка: открыть изменённые заметки, пройти по внутренним ссылкам, выполнить поиск по старым названиям и сравнить список файлов до и после.
• Частые сбои: агент открыт не в той папке, облачный диск выгрузил часть файлов, синхронизация создала конфликтные копии, правило именования сформулировано неоднозначно.
• Граница метода: не загружайте чужие конфиденциальные записи, персональные данные и закрытые рабочие материалы, если у вас нет разрешения на такую обработку.

Подготовьте хранилище без риска

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

1. Узнайте точный путь к vault через переключатель хранилищ Obsidian или системный проводник.
2. Сделайте отдельную копию всей папки. Синхронизация полезна между устройствами, но не заменяет снимок состояния перед массовой правкой.
3. В Claude Code откройте именно папку vault. Если используете терминал, сначала перейдите в неё командой cd, затем запустите claude. Официальный быстрый старт Claude Code строится на том же принципе: агент работает из каталога проекта.
4. Попросите только перечислить папки, типы файлов и возможные риски. Не разрешайте менять заметки на этом шаге.
5. Выберите одну некритичную заметку, создайте её копию и испытайте правило форматирования на ней.

По теме: Claude для вайбкодинга: проект по шагам в 2026

Запишите правила в CLAUDE.md

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

# Правила хранилища Obsidian
- Меняй только файлы .md в папке Inbox.
- Не изменяй папку .obsidian и вложения.
- Не переименовывай файлы без отдельного подтверждения.
- Сохраняй YAML-свойства и внутренние ссылки [[...]].
- Перед записью покажи список затрагиваемых файлов.
- После записи перечисли старые и новые заголовки.

Это не технический запрет, а контекст для поведения агента. В официальной документации Anthropic подчёркнуто, что инструкции в CLAUDE.md направляют работу, но не заменяют жёсткие разрешения. Поэтому для первой задачи полезен режим планирования и ручное подтверждение записи. Подробнее об этом есть в разборе файла CLAUDE.md и статье про управление контекстом Claude.

Дайте первую задачу с проверяемым выходом

Безопасный пример: «Прочитай только папку Inbox. Найди заметки без заголовка первого уровня. Составь таблицу: путь, предложенный заголовок, причина. Ничего не меняй». После проверки таблицы второе задание может разрешить правку двух файлов и потребовать отчёт по каждой замене.

Для объединения дублей не просите «навести порядок во всём vault». Дайте правило выбора: две заметки считаются кандидатами на объединение только при совпадении предмета, периода и назначения. Если совпали лишь отдельные слова, Claude должен оставить их раздельно и предложить ссылку между ними.

Если вам сначала нужно понять сам инструмент, начните с материала что такое Claude Code. Для проверки доступности и конфигурации пригодится чек-лист Claude.

По теме: Claude Context: как управлять чатом, Projects и Claude Code

Как проверить результат после правки

1. Откройте изменённые файлы через список Obsidian, а не только в отчёте Claude.
2. Проверьте YAML-свойства, заголовок первого уровня, внутренние ссылки и встраивания.
3. Найдите старые имена через поиск по всему vault. Остаток старой ссылки означает, что переименование нельзя считать завершённым.
4. Сравните резервную копию и рабочую папку. Убедитесь, что .obsidian, картинки и несогласованные каталоги не изменились.
5. Откройте граф или обратные ссылки только как дополнительную проверку. Главный критерий: нужная заметка открывается, ссылка ведёт к ней, а содержание не потеряно.

Диагностика частых сбоев

• Claude не видит заметки: проверьте, что открыт корень vault, а файлы действительно загружены на диск.
• Появились дубликаты с пометкой conflict: остановите Claude, дождитесь окончания синхронизации и сравните версии вручную.
• Сломались внутренние ссылки: верните файлы из копии, затем повторите переименование маленькой группой с поиском всех вхождений старого имени.
• Изменился служебный каталог .obsidian: откатите его отдельно и добавьте явный запрет в CLAUDE.md.
• Большое хранилище не помещается в контекст: работайте папками, сначала создавайте индекс файлов, затем анализируйте выбранный набор.

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

Частые вопросы

Нужен ли специальный плагин Claude для Obsidian?

Нет, для работы с обычными заметками достаточно открыть локальную папку vault в Claude Code. Плагин может добавлять удобство, но создаёт ещё один уровень доступа и доверия.

Можно ли дать Claude доступ только к одной папке?

Да. Откройте нужный подкаталог как рабочую область или начните с инструкции читать только его. Для надёжной границы используйте разрешения файловой системы и режим планирования, а не только текстовое пожелание.

Сохранит ли Claude внутренние ссылки Obsidian?

Сохранит, если вы явно запретите менять синтаксис [[...]] и проверите все старые имена после переименования. Автоматической гарантии совместимости нет.

Можно ли обрабатывать всё хранилище сразу?

Технически возможно, но безопаснее идти папками. Маленькая пробная партия показывает, понимает ли агент ваши свойства, шаблоны и правила ссылок.