Cursor и Obsidian: ИИ-агент для работы с заметками в хранилище

Obsidian хранит заметки обычными Markdown-файлами в папке на диске, и это открывает простой путь: если открыть эту папку в редакторе с агентом, ИИ получит доступ ко всем заметкам сразу. Связка «cursor ai obsidian» нужна тем, у кого накопились сотни заметок без тегов, с битыми ссылками и неразобранными дневниками. Ниже: как открыть хранилище, как задать агенту правила, какие задачи ему можно поручать и как не испортить структуру.

Cursor AI и Obsidian: почему хранилище подходит для агента

Хранилище (vault) в Obsidian — это обычная папка. Внутри лежат файлы .md, вложения и служебная папка .obsidian с настройками. Никакой закрытой базы данных нет, поэтому Cursor, Claude Code или Codex читают и правят заметки так же, как исходники проекта. Obsidian при этом может оставаться открытым: когда файл на диске меняется, программа обычно подхватывает изменения сама.

Две особенности заметок, о которых агент должен знать:

• связи записываются как [[Название заметки]] или [[Заметка|подпись]], и при переименовании файла вручную такие ссылки ломаются;
• свойства лежат в блоке frontmatter в начале файла между строками ---: теги, даты, алиасы.

Если ИИ нужен прямо внутри окна Obsidian, это другая задача, её разбирает статья про ИИ-плагин для Obsidian↗. Здесь речь о внешнем агенте, который работает с папкой.

Подготовка: страховка и правила

Агент меняет много файлов за один заход, поэтому сначала страховка.

1. Сделайте копию хранилища или превратите его в git-репозиторий: git init, затем git add -A и первый коммит. После работы агента вы увидите точный дифф и сможете откатить любую правку.
2. Закройте от агента то, что ему видеть не нужно: личные дневники, финансы, пароли. В Cursor для этого есть файл игнорирования, его точное имя и синтаксис проверьте в документации Cursor. Самый надёжный способ проще: держать приватные заметки вне открытой папки.
3. Положите в корень хранилища файл с правилами. Cursor читает правила из .cursor/rules и файла AGENTS.md (подробнее в статье про правила Cursor↗), Codex ищет AGENTS.md, Claude Code читает CLAUDE.md. Один и тот же текст правил можно положить в оба файла.

Пример правил для хранилища:

## Правила для хранилища заметок

- Папку .obsidian не трогать.
- Ссылки между заметками пиши в формате [[Название]]. Файлы не переименовывай и не перемещай без моей команды.
- Frontmatter: поля tags (список), created (YYYY-MM-DD), status. Существующие поля не удаляй.
- Теги — только из файла Теги.md. Новый тег предлагай списком, не добавляй сам.
- Сначала покажи план правок списком файлов, меняй только после подтверждения.
- Не придумывай факты. Если в заметке чего-то нет, так и пиши.

Последние два пункта важнее остальных: план до правок и запрет на выдумывание.

Как подключить модели Zukko

В Cursor: Settings → Models, включите свой OpenAI-ключ fetch_..., включите подмену Base URL и укажите https://api.zukko.pro/v1. Имя модели для Claude берите из документации по Cursor↗: Cursor не принимает имя, которое уже знает, и у популярных моделей есть вторые имена, например cursor-sonnet-5 для Claude Sonnet 5. Модели GPT и дешёвые линейки можно вводить обычными id, например gpt-6.1-sol. Подмена провайдера в Cursor может зависеть от вашего тарифа, актуальные условия смотрите на сайте Cursor.

Для Claude Code достаточно перейти в папку и запустить агента:

cd ~/Documents/MyVault
claude

Ключ задаётся переменными ANTHROPIC_BASE_URL=https://api.zukko.pro и ANTHROPIC_AUTH_TOKEN=fetch_... (подробно в документации по Claude Code↗). Для Codex аналогично: cd в хранилище и codex, а провайдер прописан в ~/.codex/config.toml. Тогда запрос «codex obsidian» превращается в ту же схему: папка заметок плюс файл AGENTS.md в корне.

Примеры использования: что поручать агенту

Задачи для «cursor ai примеры использования» в хранилище бывают механические и смысловые. Механические безопаснее.

Разметка. «Просмотри заметки в папке Проекты. В тех, где нет frontmatter, добавь поля tags и created. Теги бери только из Теги.md. Список файлов покажи до правок».

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

Недельная сводка. «Прочитай дневниковые заметки за последние семь дней в папке Daily и собери сводку: что сделано, что осталось, какие решения приняты. Сохрани в новую заметку Недельная сводка 2026-10-18. Каждый пункт сопровождай ссылкой на исходную заметку».

Проверка ссылок. «Найди ссылки [[...]], ведущие на несуществующие заметки, и выведи список с файлами, где они встречаются».

Дробление длинной заметки. Агент предлагает разбить файл на атомарные заметки со ссылками, а создаёт их только после вашего согласия.

Смысловые задачи (переписать, объединить, сократить) делайте на копии заметки или в отдельной ветке git. Ошибка здесь незаметна: текст остаётся гладким, а смысл может сдвинуться.

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

• Переименования. Obsidian сам обновляет ссылки, когда вы переименовываете файл в его интерфейсе. Агент работает с файлами напрямую, ссылки он обновит, только если вы это потребуете. Проще запретить переименование и делать его вручную.
• Синхронизация. Если хранилище синхронизируется через облако или сервис синхронизации, не запускайте массовые правки в момент синхронизации: проще получить конфликт версий. Дождитесь окончания синхронизации, закоммитьте, потом работайте.
• Дифф после каждой задачи. Открывайте git diff и смотрите выборочно. Одна проверка за задачу окупается.
• Чувствительное. Всё, что агент читает, уходит модели. Если в хранилище есть личные данные, исключите их из папки или замаскируйте перед отправкой.

Сколько это стоит

Цены на 18 октября 2026, за 1M токенов. Для claude-sonnet-5 вход $0.4, выход $2. Пример: агент размечает 40 заметок по 1 500 токенов, то есть читает 60 000 токенов и пишет 5 000.

Стоимость = 60 000 × 0.4 / 1 000 000 + 5 000 × 2 / 1 000 000 = 0.024 + 0.010 = $0.034.

Для deepseek-v4.1-flash (вход $0.013, выход $0.038): 60 000 × 0.013 / 1 000 000 + 5 000 × 0.038 / 1 000 000 = 0.00078 + 0.00019 ≈ $0.001.

Это нижняя оценка: агент на каждом шаге отправляет модели накопленную переписку, так что реальный расход выше. Замерьте его на своей задаче в разделе «Использование» кабинета и поставьте ключу дневной лимит. Актуальные цены: GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

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

Можно ли оставить Obsidian открытым, пока работает агент?

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

Cursor, Claude Code или Codex: что выбрать?

Для хранилища все три работают одинаково, потому что работают с папкой. Cursor удобен, если хочется видеть правки диффом в редакторе. Claude Code и Codex живут в терминале. Попробуйте на копии хранилища и сравните расход и результат.

Не испортит ли агент ссылки между заметками?

Может, если ему разрешить переименования и перемещения. Запретите их в правилах, требуйте план до правок и проверяйте дифф.

Как попробовать без больших затрат?

Создайте ключ в кабинете Zukko↗, поставьте ему дневной лимит в несколько долларов и начните с копии хранилища на дешёвой модели.