Obsidian + Claude Code 101
@ai_longreadsСистема ведения заметок с помощью ИИ: как превратить хранилище Obsidian в живую базу знаний, которой управляет Claude Code
Это AI-перевод статьи, сделанный каналом Про AI: Лучшие Статьи и Исследования.
Obsidian + Claude Code 101
obsidian + claude code 101 Автор: Heinrich Оригинальный текст:
Последний год я строил операционную систему для мышления с помощью ИИ. Claude Code работает с моими хранилищами Obsidian.
Он извлекает ключевые концепции, связывает их с тем, что вы уже поняли, и строит живое представление вашего мышления.
Теперь я работаю только в хранилище.
Markdown-файлы знают всё, что я обнаружил — аккуратно структурированное и с автоматической инъекцией ситуационного контекста для обучения в контексте (in-context learning).
Я использую индекс хранилища, который помогает агенту решать, какие заметки подгружать — тот же паттерн, по которому Claude Code решает, какие навыки загружать.
(Если подумать, каждая заметка — это, в каком-то смысле, навык... тщательно отобранное знание, которое инжектируется, когда это уместно.)
Более глубокая мысль в том, что хранилище кодирует то, как вы думаете, а не только то, о чём вы думали. Методология становится частью системы.
Это всё просто markdown-файлы, вы полностью владеете ими. Это ИИ как партнёр по мышлению, а не как помощник для написания текстов.
Знание = код?
Я понял: базы знаний и кодовые базы имеют много общего.
Это папки с текстовыми файлами, между которыми есть связи, у них есть соглашения и паттерны, и обе выигрывают от агентов, которые могут по ним навигировать и работать с ними.
Vibe coding (разработка в свободном стиле) изменил то, как мы пишем софт, позволяя ИИ заниматься реализацией, пока вы сосредоточены на направлении — и тот же сдвиг применим к работе со знаниями.
Вы больше не делаете заметки. Вы управляете системой, которая делает заметки.
Что такое хранилище?
Хранилище — это папка с markdown-файлами, которые ссылаются друг на друга:
my-vault/ ├── 00_inbox/ # зона захвата, без трения ├── 01_thinking/ # ваши заметки и синтез │ └── notes/ # отдельные заметки ├── 02_reference/ # внешние знания │ ├── tools/ # документация инструментов │ ├── approaches/ # методы и паттерны │ └── sources/ # внешние источники ├── 03_creating/ # контент в работе │ └── drafts/ ├── 04_published/ # архив готовых работ ├── 05_archive/ # неактивный контент ├── 06_system/ # шаблоны и скрипты ├── CLAUDE.md # учит ИИ вашей системе └── attachments/ # изображения и файлы
Файлы соединяются с помощью [[вики-ссылок]], которые строят сеть идей.
Когда вы пишете [[качество — это сложная часть]] в одной заметке, создаётся кликабельная ссылка на другую заметку с таким названием.
Агент может следовать по этим ссылкам, перепрыгивая между связанными идеями и обнаруживая связи, о которых вы забыли.
Как писать хорошие заметки
Важно, как вы пишете эти ссылки.
Большинство людей ставят ссылки внизу как сноски. Вместо этого вплетайте ссылки в предложения.
Не пишите «это связано с качеством, см.: заметка-о-качестве». Пишите «потому что [[качество — это сложная часть]], нам нужно сосредоточиться на курировании».
Ссылка становится частью вашей мысли, и агент может следовать вашему рассуждению, следуя по ссылкам.
Также пишите заметки, которые самодостаточны и композабельны.
Если кто-то попадает на заметку по ссылке, ему не нужно сначала читать пять других заметок, чтобы понять её.
Думайте о заметках как о кубиках Lego.
Каждый завершён сам по себе, но они соединяются, чтобы строить большие структуры.
Когда ваши заметки работают так, сама сеть становится ценной.
Дело в том, что ИИ автоматически не понимает вашу философию. Вы должны его научить.
Наблюдение за тем, как ИИ полностью игнорирует мои принципы, научило меня этому на горьком опыте.
Когда вам нужно научить Claude тому, как вы думаете, вы осознаёте, сколько неявного знания носите с собой. Внезапно приходится всё текстуализировать.
Мой CLAUDE.md сейчас около 2000 строк, потому что я постоянно уточняю, что работает, а что нет.
Каждому хранилищу нужна своя философия
Вот что большинство гайдов делают неправильно. Они дают вам систему и говорят «следуйте этому», но каждое хранилище служит разным целям и требует разных принципов.
То же самое с кодовыми базами, на самом деле.
Вы бы не использовали одинаковую структуру папок для CLI-инструмента и веб-приложения.
Я использую несколько хранилищ. Одно — для размышлений об ИИ и управлении знаниями, это пример, которым я поделюсь.
Другое — для работы, отслеживает проекты и клиентов с совершенно другими правилами. Философия меняется в зависимости от цели.
Один и тот же базовый паттерн, разные правила. Паттерн такой:
- Markdown-файлы со ссылками, которые любой ИИ может читать
- Файл CLAUDE.md, который учит агента вашей конкретной системе
- Структура, позволяющая агенту быстро ориентироваться
- Соглашения, записанные как инструкции, чтобы ИИ оставался последовательным
Что входит в эти инструкции — полностью зависит от вашей цели.
Что это может быть
Рабочее хранилище может делать акцент на:
- Сначала захват, структура потом
- Папки проектов со встречами и результатами
- Контекст клиента для потребления ИИ
Исследовательское хранилище может делать акцент на:
- Отслеживание источников и цитирование
- Литературные заметки
- Проверка утверждений
Творческое хранилище может делать акцент на:
- Захват и инкубация идей
- Прогрессия черновиков
- Организация референсов
Пример хранилища для мышления
Хранилище, которым я делюсь, фокусируется на развитии понимания. Философия исходит из файла CLAUDE.md:
Я чувствую разницу, когда хранилище хорошо поддерживается versus когда полно шума. Глубина важнее широты.
Вот фрагмент из CLAUDE.md, чтобы подчеркнуть это:
глубина важнее широты. качество важнее скорости. токены бесплатны. это не про эффективность. это про превосходство. когда вы берётесь за задачу, вы обязуетесь понять её полностью и оставить работу, на которой будущие агенты смогут строить.
Как Claude находит вещи
Когда Claude начинает сессию, ему нужно понять, что существует, не читая каждый файл.
Это невозможно с тысячами заметок. Поэтому моя система имеет слои, позволяющие агенту быстро ориентироваться:
"hooks": {
"SessionStart": [{
"hooks": [{
"type": "command",
"command": "tree -L 3 -a -I '.git|.obsidian' --noreport"
}]
}]
}- Claude видит структуру папок. Хук автоматически показывает, какие папки и файлы существуют при старте сессии
- Индексный файл, который перечисляет каждую заметку с описанием в одно предложение. Claude может просканировать 50 заметок за секунды, не открывая их
- Тематические страницы (MOC), которые ссылаются на связанные заметки — они действуют как оглавления для каждой темы
Они также содержат заметки, которые Claude оставляет себе о том, что узнал при обходе графа, оставляя хлебные крошки для будущих сессий.
ИИ начинает широко, сужается до релевантного, затем следует по ссылкам, чтобы построить понимание.
Основные принципы
Это правила, которые работают для моего хранилища мышления. Другие типы хранилищ могут требовать других:
- Можно ли на эту заметку сослаться из другого места, и она всё ещё будет иметь смысл? Если ссылка на неё заставляет сначала объяснять три другие вещи — разбейте её. Это композабельность.
- Я перестал называть заметки как темы и начал называть их как утверждения. Вместо «мысли об ИИ-слопе» вы пишете «качество — это сложная часть». Когда вы ссылаетесь на неё, название естественно становится частью предложения (это также заставляет Claude думать по-другому при построении предложений, что, я считаю, полезно, потому что требует понимания).
- Инсайт о том, что отдельные заметки менее важны, чем их связи. Заметка со множеством входящих ссылок ценнее изолированной заметки, потому что каждая ссылка создаёт новый путь чтения. Сеть — это и есть знание.
Как агент работает
Каждая задача начинается с ориентирования. Claude сканирует структуру, проверяет индекс на релевантные заметки, читает тематическую страницу перед внесением изменений.
Он следует по ссылкам, чтобы построить понимание, и не вносит изменений без контекста.
Когда Claude обнаруживает что-то полезное о навигации по теме, он записывает это на тематической странице.
Будущие сессии читают эти заметки и учатся на прошлой навигации. Так хранилище запоминает, как думать через само себя.
Иногда две заметки интересно взаимодействуют. Claude создаёт новую заметку, фиксирующую инсайт, который возникает от их комбинации.
Каждый новый захват запускает поиск связанных заметок. Claude добавляет ссылки с контекстом.
Архитектура папок
vault/ ├── 00_inbox/ # зона захвата ├── 01_thinking/ # ваши заметки и тематические страницы │ ├── knowledge-work.md # пример тематической страницы │ └── notes/ # отдельные заметки ├── 02_reference/ # материалы от других ├── 03_creating/ # черновики в работе ├── 04_published/ # готовые работы ├── 05_archive/ # старые материалы └── 06_system/ # шаблоны и конфиг
Эта структура работает для персонального хранилища мышления. Рабочее хранилище может иметь проекты и клиентов.
Суть не в конкретных папках, а в том, что расположение в папке говорит вам, что это такое.
Markdown — это система. Инструменты вроде Obsidian — просто окна в неё. Хранилище переживёт исчезновение любого приложения.
Всё это простой текст, который любой редактор может читать и любой ИИ может обрабатывать. Вы полностью владеете своими данными.
Как начать
- Создайте папку с подпапками, соответствующими вашей цели. Подумайте о том, что вам действительно нужно организовать
- Напишите CLAUDE.md, объясняющий вашу систему. Начните просто и развивайте по мере того, как узнаёте, что работает
- Позвольте Claude работать. Захватите что-нибудь и попросите Claude найти связи. Позвольте ему навигировать, обнаруживать отношения и предлагать, куда что относится
ВСЕГДА проверяйте, что он производит, и редактируйте на качество.
Вы больше не делаете заметки, а направляете систему, которая делает заметки. Ваша работа становится суждением — то есть решением, что важно.
Роль человека эволюционирует от писателя к редактору, от создателя к куратору.
TL;DR
- Vibe coding (разработка в свободном стиле) изменил то, как мы пишем софт. Vibe note-taking (ведение заметок в свободном стиле) меняет то, как мы думаем
- Хранилище — это просто markdown-файлы, которые ссылаются друг на друга
- У больших языковых моделей нет памяти, поэтому хранилища дают им её
- CLAUDE.md учит ИИ тому, как работает ваша система
- Каждому хранилищу нужна своя философия, основанная на цели
- Что остаётся постоянным: markdown, ссылки, ИИ работает, пока вы обеспечиваете суждение
Если хотите посмотреть, как это развивается — следите. Скоро выложу свои заметки в открытый доступ.
Heinrich
Подпишитесь на канал и каждый день читайте лучшие материалы про AI переведенные на русский!
Нашли интересную статью для перевода? Пришлите нашему боту: @ailongreadsbot