Суть урока
Каждая сессия с Claude начинается с нуля — если не включена память или файл с правилами, он ничего не помнит о тебе. Ты тратишь время на объяснения, он тратит токены на понимание контекста. Obsidian решает эту проблему: ты строишь базу знаний в markdown-файлах, Claude читает её напрямую и сразу работает в контексте.
Ключевые концепции
- Local-first — файлы на твоём компьютере, не в облаке; данные под твоим контролем
- Markdown = язык AI — Claude читает
.mdнапрямую без конвертации - Граф ссылок — связи между заметками через
[[Название]]образуют нейронную сеть знаний - Hot Cache паттерн — часто нужные данные в отдельной папке, чтобы Claude загружал только их
- MCP filesystem — мост между Claude Code и твоим vault
- Smart Connections — семантический поиск по всему vault, не только по ключевым словам
- Daily Note — ежедневный дневник разработчика с задачами, решениями и стоимостью AI-сессий
Теория
Зачем вообще нужен "второй мозг"
Вот типичная ситуация: ты исследовал рынок недвижимости Эквадора три недели назад. Написал отчёт, запомнил детали. Сегодня клиент задаёт смежный вопрос. Ты начинаешь объяснять Claude контекст — тратишь 15 минут и 2 000 токенов на то, что уже было исследовано.
С базой знаний в Obsidian: открываешь Claude, передаёшь путь к заметке через MCP, задаёшь вопрос. Claude уже в контексте. 30 секунд вместо 15 минут.
Это умножается на количество проектов, на количество клиентов, на месяцы работы. База знаний — это актив который дорожает со временем.
Почему Obsidian, а не Notion или Google Docs
Три причины почему Obsidian выигрывает для AI-разработчика:
Причина 1: Local-first
Файлы живут на твоём компьютере в папке на диске. Нет подписки которую могут закрыть (сам Obsidian бесплатен, в том числе для работы). Нет API который может упасть. Нет вопросов о том кому принадлежат данные. MCP filesystem читает эти файлы напрямую — никаких экспортов, конвертаций, OAuth.
Notion хранит данные на серверах Notion. Чтобы Claude прочитал заметку из Notion, нужно подключение (коннектор или MCP-сервер) с авторизацией. Это лишние шаги, и если сервис недоступен — ты без данных. Подробнее про Notion: Notion AI как командная база знаний.
Причина 2: Markdown = родной язык AI
Все .md файлы — это просто текст с простой разметкой. Claude читает их как обычный текст. Нет парсинга, нет потери форматирования, нет проблем с кодировкой.
Когда агент пишет результат исследования прямо в Obsidian-заметку — он пишет markdown. Когда Claude читает эту заметку через MCP — читает тот же markdown. Один формат везде.
Причина 3: Граф знаний
В Obsidian заметки соединяются ссылками: [[Рынок Куэнки]], [[Клиент — Иванов]], [[Проект — Апартаменты Центр]]. Obsidian строит визуальный граф этих связей. Ты видишь как концепции связаны между собой — как нейронная сеть.
Структура папок для AI-разработчика
Используем систему PARA (Projects, Areas, Resources, Archive) — проверенная структура которая масштабируется:
vault/
├── 00-hot-cache/ ← самые нужные файлы (Claude загружает в первую очередь)
├── 01-inbox/ ← сырые идеи, не разобранные голосовые, быстрые заметки
├── 02-projects/ ← активные проекты (одна папка = один проект)
│ ├── acme-realty/
│ │ ├── CLIENT-BRIEF.md
│ │ ├── market-research.md
│ │ └── meeting-notes/
│ └── academy-course/
├── 03-areas/ ← постоянные области жизни и бизнеса
│ ├── finances.md
│ ├── health.md
│ └── ai-stack.md ← какие инструменты используешь, API ключи (не сами ключи)
├── 04-resources/ ← справочники, исследования, термины
│ ├── ecuador-real-estate/
│ ├── ai-tools/
│ └── code-snippets/
├── 05-archive/ ← завершённые проекты, неактуальное
└── templates/ ← шаблоны заметок
├── daily-note.md
├── project.md
├── meeting.md
└── research.mdПочему такой порядок папок?
Число в начале названия — это приоритет сортировки. 00-hot-cache всегда вверху. Это папка которую Claude читает первой. Туда кладёшь то что нужно почти каждую сессию: текущий контекст проектов, ключевые решения, активные задачи.
Hot Cache паттерн — экономия токенов
Это один из самых практичных паттернов для работы с Claude.
Проблема: vault со временем разрастается. 300 заметок, 500, 1000. Если давать Claude весь vault — это тысячи токенов на навигацию и чтение лишнего. Дорого и медленно.
Решение: папка 00-hot-cache/ с файлами которые нужны в 90% сессий.
Что там держать:
00-hot-cache/
├── CONTEXT.md ← кто ты, какие проекты активны, текущий статус
├── active-projects.md ← 3-5 активных проекта одним файлом
├── decisions-log.md ← последние 10 ключевых решений
├── ai-costs-this-month.md ← сколько потратил на AI, лимит
└── weekly-goals.md ← цели текущей неделиИнструкция Claude в CLAUDE.md проекта:
## Мой vault Obsidian Путь: /Users/you/vault/ При старте сессии — сначала прочитай: - /Users/you/vault/00-hot-cache/CONTEXT.md - /Users/you/vault/00-hot-cache/active-projects.md Эти два файла дадут 80% нужного контекста. Остальное — запрашивай по необходимости.
Экономия: вместо загрузки всего vault (тысячи токенов) — два файла (300-500 токенов). Это 90% экономии токенов на контекст.
Плагины для AI-разработчика
Obsidian поддерживает плагины через встроенный маркетплейс (Настройки → Community Plugins). Список для нашего кейса:
Smart Connections — семантический поиск по vault (проверь в каталоге плагинов, что плагин поддерживается и совместим с твоей версией Obsidian)
Обычный поиск ищет по ключевым словам. Smart Connections понимает смысл. Спросишь "что я знаю о конкурентах?" — найдёт все связанные заметки даже если слово "конкуренты" в них не встречается.
Дополнительно: прямо внутри Obsidian можно задавать вопросы о своих заметках через встроенный AI-чат. Smart Connections встраивается в Obsidian и отвечает на вопросы используя твои файлы как контекст. Это RAG (Retrieval-Augmented Generation) прямо в интерфейсе без настройки.
Copilot — Claude или GPT прямо в Obsidian
Плагин сообщества (не путать с GitHub Copilot) добавляет боковую панель с AI-чатом. Можно задать вопрос используя текущую заметку как контекст. Полезно когда работаешь в Obsidian и хочешь быстро дополнить или переписать заметку через AI без переключения в Claude Code.
QuickAdd — быстрое добавление заметок по шаблону
Нажал горячую клавишу, выбрал шаблон (встреча/идея/исследование), заполнил два поля — заметка создана в нужной папке с правильной структурой. Без QuickAdd каждый раз вручную думаешь куда положить заметку и как её назвать.
Dataview — SQL-подобные запросы по заметкам
Это полноценная база данных поверх markdown-файлов. Если добавляешь в заметки метаданные (frontmatter), Dataview умеет делать выборки:
```dataview TABLE cost_usd, agent, status FROM "02-projects/acme-realty" WHERE status = "complete" SORT cost_usd DESC ```
Результат: таблица всех завершённых AI-задач по проекту с их стоимостью. Прямо в заметке Obsidian.
Примечание на октябрь 2026: в Obsidian есть встроенный core-плагин Bases, который делает похожие табличные выборки по свойствам заметок через интерфейс, без кода. Для простых таблиц начни с него. Dataview остаётся полезным для сложной логики, но его релизов давно не было, поэтому не строй на нём критичное.
Templater — динамические шаблоны
Templater делает шаблоны с логикой. Например, шаблон daily note автоматически вставляет текущую дату, день недели, ссылку на вчерашнюю заметку. Не нужно заполнять руками каждый раз.
---
date: <% tp.date.now("YYYY-MM-DD") %>
week: <% tp.date.now("WW") %>
---
# <% tp.date.now("dddd, DD MMMM YYYY") %>
## Задачи дня
- [ ]
## AI-сессии сегодня
| Задача | Агент | Стоимость |
|--------|-------|-----------|
| | | |
## Решения и заметки
## Идеи в inbox
[[<% tp.date.now("YYYY-MM-DD", -1) %>]] ← вчераCalendar — навигация по дневнику
Добавляет календарь в боковую панель. Клик на дату — открывает daily note за этот день. Простой способ найти что ты делал неделю назад.
Claude + Obsidian: практические паттерны
Паттерн 1: Вопрос к своей базе знаний
Самый простой паттерн. Запускаешь Claude Code в папке vault (или добавляешь её командой /add-dir), для чата без доступа к файлам подключаешь filesystem MCP, говоришь Claude где лежит vault, задаёшь вопрос:
Прочитай мои заметки в /vault/04-resources/ecuador-real-estate/ и ответь: что я знаю о типичных ошибках покупателей в Куэнке?
Claude читает все файлы в папке, синтезирует ответ из твоих же заметок. Это не интернет, не общие знания — это твои собственные наблюдения из твоей базы.
Паттерн 2: Агент пишет в vault
Агент-исследователь получает задачу → выполняет → пишет результат прямо в vault:
## Задача агенту Исследуй текущие цены аренды в Куэнке. Сохрани результат в /vault/04-resources/ecuador-real-estate/rent-prices-2026-10.md Используй шаблон из /vault/templates/research.md
Следующий раз когда нужен этот анализ — он уже есть в vault. Агент читает его, не делает заново.
Паттерн 3: Голос → Заметка
Workflow для идей которые появляются на ходу:
Надиктовал голосовую заметку на телефоне →
Whisper (или приложение для диктовки, например Superwhisper, MacWhisper или Wispr Flow) → транскрибировал в текст →
Текст попадает в /vault/01-inbox/ →
Claude обрабатывает inbox, структурирует заметки по папкамЭто закрывает проблему "умная идея пришла в душе — забыл пока дошёл до компьютера".
Паттерн 4: После встречи — автоматическая заметка
## Инструкция Claude после встречи с клиентом
Пользователь передаёт транскрипт или заметки.
Ты создаёшь в /vault/02-projects/{project}/ файл meeting-{date}.md
Структура: участники, ключевые решения, следующие шаги, дедлайны.
Связываешь ссылками [[]] с существующими заметками по проекту.MCP для работы с Obsidian vault
Сначала важное уточнение: Claude Code и так читает и пишет файлы в папке, где он запущен, а дополнительные папки подключаются командой /add-dir или флагом --add-dir. Поэтому для Claude Code самый простой путь — открыть терминал в папке vault и запустить claude. MCP нужен там, где у ассистента нет прямого доступа к файлам (например, в приложении для чата) или когда нужны возможности, которых нет у обычных файловых операций.
Два способа подключить через MCP.
Способ 1: Filesystem MCP (официальный)
Даёт Claude доступ к папке vault для чтения и записи через MCP.
# Добавить filesystem MCP для vault
claude mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem \
/Users/YOUR_USERNAME/vault
# Проверить что добавлен
claude mcp listПосле подключения Claude может читать и писать файлы в vault напрямую. Заменить YOUR_USERNAME и vault на реальные значения.
Способ 2: Obsidian MCP (community, расширенный)
Даёт дополнительные возможности: поиск по vault, управление тегами, граф ссылок. Таких серверов и плагинов несколько (например, плагины, которые поднимают MCP-сервер прямо внутри Obsidian). Команда подключения зависит от выбранного проекта, формат смотри в его README. Перед установкой проверь, что проект поддерживается и у него нет подозрительных прав: MCP-сервер получает доступ к твоим заметкам.
Такой MCP понимает структуру Obsidian — frontmatter, wiki-ссылки [[]], теги #. Filesystem MCP видит просто текстовые файлы.
Какой выбрать:
| Filesystem MCP | Obsidian MCP | |
|---|---|---|
| Установка | Проще | Сложнее |
| Надёжность | Официальный | Community |
| Поиск | По содержимому файлов | Зависит от выбранного сервера |
| Понимание структуры | Нет | Да (теги, ссылки) |
| Запись файлов | Да | Да |
Начни с самого простого: Claude Code в папке vault, а при необходимости — filesystem MCP. Он официальный и работает сразу.
Daily Note — дневник AI-разработчика
Daily note — заметка которую создаёшь каждый день. Это не дневник эмоций — это операционный журнал.
Что фиксировать:
---
date: 2026-10-09
week: 41
---
# Пятница, 09 октября 2026
## Задачи
- [x] Написать урок для Academy
- [ ] Подключить filesystem MCP к vault
- [ ] Ревью кода для клиента X
## AI-сессии
| Задача | Агент | Модель | Стоимость |
|--------|-------|--------|-----------|
| Урок для Academy | writer | Sonnet | $0.12 |
| Market research | researcher | Sonnet | $0.08 |
**Итого сегодня: $0.20**
## Решения
- Выбрали filesystem MCP вместо Obsidian MCP — официальный, проще
- Стандартная структура PARA для vault
## Идеи
- Можно автоматизировать создание daily note через хук session-start
## Блокеры
- Нужно проверить Superwhisper на M1 для голос → текст
[[2026-10-08]] ← вчера | завтра → [[2026-10-10]]Ссылки на прошлое и будущее внизу — это навигация в Calendar плагине.
Зачем фиксировать стоимость AI-сессий:
Через месяц посмотришь на цифры и поймёшь, сколько в месяц стоит researcher, а сколько writer (суммы в таблицах выше — условные, для примера). Где реально уходят деньги видно из данных, не из ощущений. Это позволяет оптимизировать бюджет.
Шаблон PROJECT заметки
Каждый проект в 02-projects/ начинается с этого файла:
--- project: Acme Realty status: active client: internal started: 2026-10-01 tags: [real-estate, ecuador, content] --- # Проект: Acme Realty ## Что это Контентный проект о недвижимости в Эквадоре для русскоязычной аудитории. ## Текущий статус Фаза 1 — разработка контент-стратегии. ## Ключевые решения - [[2026-10-07]] Выбрали Telegram как основной канал - [[2026-10-08]] Определили brand voice: наблюдатель, не эксперт ## Активные задачи - [ ] Написать 5 постов на запуск - [ ] Настроить Obsidian MCP для автоматических отчётов ## Связанные заметки - [[Рынок недвижимости Куэнки]] - [[Аудитория — русские в Латаме]] - [[Конкуренты — каналы недвижимость]] ## История AI-сессий | Дата | Задача | Стоимость | |------|--------|-----------| | 2026-10-08 | Market research | $0.08 | | 2026-10-09 | Контент-план | $0.05 |
Dataview умеет делать выборку по status: active и показывать все активные проекты на одной странице.
Практика
Шаг 1: Установить Obsidian и создать vault
# Скачать Obsidian: obsidian.md (бесплатно, в том числе для работы)
# Установить через brew:
brew install --cask obsidianЗапустить, создать новый vault в удобном месте (например, ~/vault или ~/Documents/vault). Не в iCloud если не хочешь синхронизации — файлы и так будут в Git.
Шаг 2: Создать структуру папок
# Заменить ~/vault на реальный путь к vault
VAULT=~/vault
mkdir -p $VAULT/00-hot-cache
mkdir -p $VAULT/01-inbox
mkdir -p $VAULT/02-projects
mkdir -p $VAULT/03-areas
mkdir -p $VAULT/04-resources
mkdir -p $VAULT/05-archive
mkdir -p $VAULT/templatesШаг 3: Создать первый CONTEXT.md в hot-cache
cat > $VAULT/00-hot-cache/CONTEXT.md << 'EOF'
# Context — Кто я и что сейчас делаю
## Обо мне
AI-разработчик, строю автоматизации через Claude Code.
Активные проекты: [перечисли]
## Активные проекты
- **Проект 1** — [краткое описание, текущий статус]
- **Проект 2** — [краткое описание, текущий статус]
## Мой AI-стек
- Claude Code (модель выбираю под задачу)
- Obsidian vault для знаний
- Ollama для локальных моделей (приватные данные)
## Текущие цели (неделя)
- [ ] Подключить filesystem MCP
- [ ] Настроить daily note шаблон
EOFШаг 4: Подключить filesystem MCP к Claude Code
# Добавить MCP (замени путь на реальный)
claude mcp add filesystem -- \
npx -y @modelcontextprotocol/server-filesystem \
~/vault
# Проверить
claude mcp listПосле этого в новой сессии Claude Code написать:
Прочитай файл ~/vault/00-hot-cache/CONTEXT.md и скажи что ты узнал о текущем контексте
Claude должен прочитать файл и ответить по его содержимому.
Шаг 5: Установить плагины
В Obsidian: Настройки (Ctrl+, или Cmd+, на Mac) → Community Plugins → Включить → Browse.
Установить в таком порядке:
- Templater — шаблоны с логикой
- Calendar — навигация по daily notes
- Dataview — запросы к заметкам
- QuickAdd — быстрое добавление
- Smart Connections — семантический поиск (опционально, настройки модели смотри в документации плагина)
Для простых таблиц по заметкам попробуй сначала встроенный Bases (Настройки → Core plugins).
Шаг 6: Настроить шаблон daily note
Создать файл templates/daily-note.md с базовой структурой из теории. В настройках Daily Notes (Настройки → Core Plugins → Daily Notes) указать папку для daily notes и шаблон.
С Templater создать более продвинутую версию с автоматической датой и ссылками на соседние дни.
Шаг 7: Первое реальное использование
Взять любую задачу которую сейчас делаешь для клиента или проекта. Создать заметку по шаблону проекта. Подключить Claude через MCP и задать вопрос о содержимом заметки.
Убедиться что работает: Claude читает файл и отвечает используя именно твои данные.
Инструменты и ресурсы
- obsidian.md — скачать Obsidian (бесплатно, в том числе для работы)
- Obsidian Community Plugins — каталог всех плагинов
- Smart Connections — семантический поиск
- Templater — документация плагина
- Dataview — полная документация запросов
- @modelcontextprotocol/server-filesystem — официальный filesystem MCP
- Obsidian MCP — community-серверы и плагины ищи в каталоге плагинов Obsidian и в каталоге MCP; выбирай поддерживаемые проекты
- Superwhisper — голос → текст на Mac (для паттерна голос → inbox); похожие инструменты есть в каталоге Академии: Инструменты
- PARA Method — оригинальная методология структуры vault
Ключевые выводы
TL;DR: Obsidian + filesystem MCP = долгосрочная память для Claude. Ты строишь базу знаний один раз — она работает за тебя во всех будущих сессиях.
Hot Cache паттерн: 2 файла в
00-hot-cache/закрывают 80% потребности в контексте при минимуме токенов.
Local-first выигрывает: markdown файлы на диске — Claude Code читает их напрямую, без API и без OAuth.
Daily Note = операционный журнал: задачи + AI-сессии + решения. Через месяц увидишь паттерны в своей работе которые иначе невидимы.
Начинай минимально: vault + filesystem MCP + один CONTEXT.md. Усложняй когда почувствуешь что нужно.
Что дальше
→ Notion AI как командная база знаний — когда знания нужны не только тебе, но и команде
Отметка хранится только в этом браузере и никуда не отправляется. Мой прогресс