Claude Obsidian은 Claude Code와 Obsidian vault를 결합해 개인 지식 베이스를 대화형으로 운용하는 오픈소스 프로젝트다. Claude가 최근 맥락을 담은 hot cache, 전체 인덱스, 관련 wiki 페이지를 읽고 질문에 답하며, 세션이 끝나면 새로 생긴 지식을 다시 vault에 정리한다.
핵심 아이디어
Claude Obsidian은 llm-knowledge-base 패턴을 개인 Obsidian 환경에 맞춘다. LLM이 raw 자료를 구조화된 wiki로 컴파일하고, 질의 결과를 다시 저장해 지식이 세션마다 누적된다.
| 구성 | 역할 |
|---|---|
wiki/hot.md | 최근 세션과 작업 맥락을 요약한 hot cache |
wiki/index.md | 전체 지식 베이스 탐색용 인덱스 |
| wiki 페이지 | 주제별 구조화 문서 |
| Claude Code 명령 | /wiki, /save, /autoresearch 등 지식 관리 워크플로 |
| Obsidian 플러그인 | 그래프, 캔버스, 시각화, 메모 편집 환경 |
사용 방식
새 vault로 클론해 바로 쓰거나, Claude Code 플러그인으로 설치하거나, 기존 Obsidian vault에 구조를 추가할 수 있다. Claude는 질문을 받으면 hot cache를 먼저 읽고, 인덱스를 훑은 뒤 관련 페이지를 열어 근거 있는 답변을 만든다.
세션 종료 시에는 최근 대화에서 남길 가치가 있는 결정, 조사 결과, 링크를 wiki 문서와 hot cache에 반영한다. 다음 세션은 사용자가 길게 설명하지 않아도 최근 맥락을 이어받는다.
어디에 적합한가
- 연구·학습 노트를 Obsidian에 축적하는 개인 사용자
- Claude Code를 단순 코딩 도구가 아니라 지식 관리 동반자로 쓰려는 사람
- Karpathy식 LLM Wiki, AutoResearch, 파일 기반 RAG 패턴을 로컬 vault에서 실험하려는 팀
관련 문서
- llm-knowledge-base — raw 소스를 구조화된 위키로 컴파일하는 아키텍처
- llm-wikid — AI가 유지하는 Karpathy 스타일 Obsidian 지식 베이스
- autoresearch — 지식과 실험을 반복 축적하는 자율 연구 루프
- claude-code — Claude Code CLI 기반 코딩 에이전트
참고 자료
- AgriciDaniel/claude-obsidian — GitHub 공식 저장소