claude-obsidian의 개요
claude-obsidian은 Claude Code 플러그인이자 Python CLI로, 받은편지함 폴더에 넣은 자료를 링크와 인용이 있는 Obsidian 페이지로 바꾼 뒤, 볼트에 이미 있는 내용으로 질문에 답합니다. Andrej Karpathy의 "LLM Wiki" 패턴을 따르며, generic, LYT, PARA, Zettelkasten 네 가지 레이아웃 중 하나로 노트를 정리합니다.
스킬 15개와 에이전트 3개를 제공하며, wiki, wiki-ingest, wiki-query, wiki-lint와 동의를 거쳐야 실행되는 autoresearch 스킬이 있습니다. 모든 쓰기는 계획으로 먼저 보여 주고, 그 계획의 해시가 있을 때만 되돌릴 수 있는 기록된 트랜잭션 안에서 적용됩니다. 같은 스킬이 설정 스크립트를 통해 Codex, OpenCode, Gemini, ZCode, Cursor, Windsurf에서도 실행됩니다.
Claude Code가 claude-로 시작하는 이름을 예약하기 때문에 3.0.0 버전은 잠시 플러그인 이름을 agricidaniel-obsidian으로 바꿨고, v3.0.1이 같은 날 원래 이름을 되살렸습니다.
claude-obsidian, 쓸 만한 가치가 있습니까?
Claude Code가 Obsidian 볼트를 관리하게 하는 방법 가운데 우리가 찾은 가장 안전 지향적인 방식이며, 그 안전성이 설정을 느리게 만드는 원인이기도 합니다. 저장소 스타는 약 15,700개이고, 2026년 10월 21일에 v3.0.0과 v3.0.1을 냈습니다. 앞의 것은 Claude Code가 이제 claude-로 시작하는 이름을 예약하기 때문에 플러그인 이름을 바꿨고, 뒤의 것은 의도적인 예외로 예전 이름을 되살렸습니다. 자체 릴리스 노트는 Claude Code 검증기가 여전히 이 이름을 예약어로 보고하고 claude plugin tag가 이를 거부한다고 인정하므로, 이후 Claude Code 릴리스가 다시 이름 변경을 강제할 수 있습니다. 비슷한 이름을 쓰는 프로젝트가 여럿 있으며, 이 리뷰는 AgriciDaniel의 것을 다룹니다.
쓰기 경로는 데이터베이스처럼 만들어졌습니다. 볼트는 환경 변수나 .claude-obsidian.json 파일로 명시적으로 고르며, 확실하지 않으면 도구는 쓰지 않고 종료합니다. 변경은 계획되고, 해시로 승인되고, 기록되며, 계획 도중 Obsidian에서 편집하면 충돌로 쓰기가 멈춥니다. README는 잠금이 협조하는 로컬 쓰기 주체들만 조율한다고 솔직히 밝힙니다. 동기화된 기기는 그 밖에 있으므로 백업은 여전히 중요합니다.
읽을 수 있는 범위는 홍보 문구보다 좁습니다. PDF와 EPUB은 텍스트 추출 없이 메타데이터와 해시만 얻습니다. 웹 페이지와 YouTube는 별도 실행기가 필요한 계획이 되고, OCR에는 외부 도구가 필요하며, 네이티브 Windows는 쓰기를 거부하므로 Windows 사용자는 WSL이 필요합니다. 3.0.0부터 맥락 접두어는 더 이상 claude -p로 대체되지 않으며, API나 로컬 Ollama 제공업체를 설정하지 않으면 합성된 상태로 남습니다.
열린 이슈 두 개가 규모 문제를 가리킵니다. 하나는 늘어나는 말뭉치가 출처 및 주장 원장의 16 MB 읽기 상한에 어떻게 맞는지 묻고, 다른 하나는 Windows 세션 훅이 5초 제한 시간에 걸린다고 보고합니다. 아직 어느 쪽도 문서에서 답하지 않았고, 독립 리뷰는 여전히 드물어 대부분 저자의 블로그와 Heatdrop 같은 짧은 디렉터리 소개입니다.
데이터 측면은 깔끔합니다. 텔레메트리가 없고, 디스크에 일반 Markdown이 있으며, Claude Code 자체가 Anthropic으로 보내는 것 외에는 머신 밖으로 나가는 것이 없 습니다. 코딩 세션을 기록하는 claude-mem과 비교하면 이것은 연구 도서관이며, 읽는 자료 자체가 남기고 싶은 대상일 때만 설정의 수고가 보상됩니다.
제 역할을 하는 곳
논문 수백 편을 이미 Obsidian에 정리한 박사과정생
문헌 전반에 질문하고 출처가 인용된 답 얻기
노트를 옮기지 않고 기존 볼트를 그대로 쓰며, 새 자료를 inbox/에 넣고 wiki-ingest와 wiki-query를 실행합니다. PDF는 메타데이터만 나오므로 텍스트를 먼저 추출하거나 붙여 넣어야 합니다. 비용은 Claude Code 요금제뿐입니다.
동기화 서비스로 볼트를 공유하는 2인 리서치 컨설팅사
고객 조사 자료의 링크를 유지하고 끊어진 링크 없애기
wiki-lint가 끊어진 링크, 고아 페이지, 빈 섹션을 보고합니다. 쓰기 잠금은 다른 기기를 다루지 않으므로 각자 백업이 필요하며, 열린 이슈에 따르면 WSL에서 iCloud Drive 위로 트랜잭션을 돌리면 유령 폴더가 생깁니다.
클라우드 노트 데이터베이스를 금지하는 회사의 지식 관리자
파일을 디스크에 둔 채 사내 노트에 AI 어시스턴트 쓰기
볼트는 텔레메트리 없는 로컬 Markdown으로 남고, 웹 조사는 작업마다 동의가 필요합니다. Claude가 읽는 노트는 여전히 회사 Claude 요금제 조건에 따라 Anthropic으로 가며, Windows 직원은 쓰기에 WSL이 필요합니다.
도입 전 확인할 점
- 설정
- claude plugin marketplace add AgriciDaniel/claude-obsidian 후 claude plugin install claude-obsidian@agricidaniel-claude-obsidian을 실행합니다. Python 3.11+가 필요하고, 보기에는 Obsidian이 필요합니다. /claude-obsidian:wiki가 볼트 계획을 미리 보여 주고 승인 후에만 만듭니다.
- 연동
- Claude Code용 전체 플러그인. 같은 Agent Skills가 scripts/setup-multi-agent.sh로 Codex, OpenCode, Gemini, ZCode, Cursor, Windsurf에 연결됩니다. 검색용 선택적 Obsidian CLI. MCP 서버는 아직 없습니다(기능 요청이 열려 있음).
- 데이터와 개인정보
- 볼트는 로컬 Markdown이며, README는 텔레메트리와 클라우드 데이터베이스가 없다고 밝힙니다. Claude가 읽는 노트는 다른 Claude Code 세션처럼 Anthropic으로 보내집니다. 웹 조사와 원격 모델은 작업마다 동의가 필요합니다. MIT이며, 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 유료 버전은 없습니다. 비용은 에 이전트 요금제이며, claude-obsidian 요금이 아니라 수집이나 질의마다 컨텍스트에 끌어오는 노트 수에 따라 늘어납니다.
- 제한
- PDF와 EPUB은 메타데이터만. URL과 OCR에는 외부 실행기가 필요합니다. 네이티브 Windows는 읽기 전용입니다. 원장 읽기 상한 16 MB. 하루에 두 번 플러그인 이름이 바뀐 것은 이름 문제가 정리되지 않았음을 보여 줍니다.
좋은 점
- 사용자가 소유하는 일반 Markdown 볼트, 텔레메트리 없음
- 계획되고 해시로 승인되며 되돌릴 수 있는 쓰기
- 주장이 저장된 출처 사본으로 연결됨
- 웹 조사와 원격 모델은 기본으로 꺼져 있음
아쉬운 점
- PDF나 EPUB 텍스트 추출 없음
- 네이티브 Windows에서는 쓸 수 없어 WSL 필요
- Claude Code가 플러그인 이름을 예약어로 표시
- 원장의 16 MB 상한이 규모 문제로 제기됨
추천 대상
Claude Code가 인용이 있는 연구 위키를 만들고 질의하기를 원하는 Obsidian 사용자.
claude-obsidian 대안
claude-obsidian: 자주 묻는 질문
- claude-obsidian, 쓸 만한 가치가 있습니까?
- claude-obsidian은 노트 볼트를 트랜잭션과 인용이 있는 데이터베이스처럼 다루며, 그래서 믿을 수 있지만 도입은 느립니다. 평점은 5점 만점에 3.8점입니다.
- claude-obsidian의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. 에이전트의 모델 사용료는 직접 냅니다.
- claude-obsidian의 단점은 무엇입니까?
- PDF나 EPUB 텍스트 추출 없음; 네이티브 Windows에서는 쓸 수 없어 WSL 필요; Claude Code가 플러그인 이름을 예약어로 표시; 원장의 16 MB 상한이 규모 문제로 제기됨.
- claude-obsidian에 적합한 사람은 누구입니까?
- Claude Code가 인용이 있는 연구 위키를 만들고 질의하기를 원하는 Obsidian 사용자.
- 팀이나 프로덕션 환경에서 claude-obsidian의 비용은 얼마입니까?
- 유료 버전은 없습니다. 비용은 에이전트 요금제이며, claude-obsidian 요금이 아니라 수집이나 질의마다 컨텍스트에 끌어오는 노트 수에 따라 늘어납니다.
- claude-obsidian에 회사 데이터를 맡겨도 안전합니까?
- 볼트는 로컬 Markdown이며, README는 텔레메트리와 클라우드 데이터베이스가 없다고 밝힙니다. Claude가 읽는 노트는 다른 Claude Code 세션처럼 Anthropic으로 보내집니다. 웹 조사와 원격 모델은 작업마다 동의가 필요합니다. MIT이며, 공개된 보안 권고는 없습니다.
- claude-obsidian의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 claude-mem, notebooklm-py 및 Graphify입니다.
답변 확인일: 2026년 10월 26일.