claude-obsidian

claude-obsidian

Obsidian을 위한 AI 세컨드 브레인, Claude Code용으로 제작되었습니다.

소스를 넣으세요. 사용할 때마다 성장하는 연결된 위키를 얻으세요.

설치 ·
볼트 보기 ·
스킬 ·
에이전트 ·
안전성 ·
모드 ·
FAQ

claude-obsidian은 당신이 읽는 것들을 점점 더 유용해지는 지식 베이스로 바꿔줍니다. 논문, 기사, 트랜스크립트 또는 자신의 노트를 볼트에 넣으면, Claude가 이를 읽고 출처가 연결된 노트를 작성하며, 모든 것을 Obsidian에서 탐색할 수 있는 하나의 연결된 지식 그래프로 정리합니다.

캡처. 소스를 inbox/ 에 넣으세요. 원본은 그대로 보존되므로 모든 요약이 출처를 다시 가리킬 수 있습니다.
연결. Claude가 링크된 페이지, 인덱스, 콘텐츠 맵을 작성하여 새로운 아이디어가 쌓이지 않고 그래프에 합류합니다.
질문. 파일을 단 하나도 변경하지 않고, 인용과 함께 볼트가 이미 알고 있는 것으로부터 답을 얻으세요.
저장. 요청할 때 한 번에 하나씩, 보관할 가치가 있는 답변을 노트로 저장하세요.
점검. 상태 점검이 끊어진 링크, 고아 페이지, 빈틈을 퍼지기 전에 찾아냅니다.

모든 것은 컴퓨터의 일반 Markdown 파일로 유지됩니다. 클라우드 데이터베이스도, 종속도, 텔레메트리도 없습니다. 대화하는 AI 도구를 제외하면, 당신이 허락하지 않는 한 아무것도 컴퓨터를 떠나지 않습니다.

볼트 보기
결과물은 AI가 있든 없든 유용하게 유지되는 평범한 Obsidian 볼트입니다: Graph view에서 탐색하거나, Obsidian Canvas에서 맵으로 배치하세요.

Graph view의 연결된 노트 · Obsidian Canvas의 지식 맵

설치

Claude Code , Python 3.11 이상, 그리고 시각적 측면을 위해 Obsidian 이 필요합니다. 두 개의 명령으로 플러그인을 설치하세요:

claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian
그런 다음 볼트로 사용할 폴더를 열고 그곳에서 Claude Code를 시작하세요:

claude # 볼트 폴더에서 Claude Code 시작

/claude-obsidian:wiki # 볼트 설정 (먼저 미리보기를 보여줍니다)
/claude-obsidian:wiki-ingest # inbox/ 의 내용을 연결된 노트로 변환
/claude-obsidian:wiki-query # 노트에서 답변되는 질문하기
/claude-obsidian:save # 좋은 답변을 노트로 보관
/claude-obsidian:wiki-lint # 상태 점검: 끊어진 링크, 고아, 빈틈
Obsidian에서 같은 폴더를 Open folder as vault로 열어 노트가 성장하는 모습을 탐색하세요.

이미 Obsidian 볼트가 있으신가요? /claude-obsidian:wiki 는 노트를 이동하지 않고 이를 채택할 수 있습니다. 설치 가이드에서 자세히 안내합니다.

다른 AI 도구: Codex, OpenCode, Gemini, ZCode, Cursor, Windsurf

claude-obsidian은 Agent Skills 모음이므로 다른 호스트에서도 실행됩니다. 이 저장소의 복사본에서 설정을 미리 본 다음 적용하세요:

git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian
bash scripts/setup-multi-agent.sh --host codex # 미리보기, 아무것도 쓰지 않음
bash scripts/setup-multi-agent.sh --host codex --apply # 스킬 연결
--host opencode , --host gemini 또는 --host zcode 도 같은 방식으로 사용하세요. Cursor와 Windsurf는 워크스페이스가 필요합니다: --host cursor --host windsurf --workspace <folder> --apply . 모든 호스트는 설치 가이드 에서 다룹니다.

Windows

Windows에서는 볼트에 쓰는 모든 작업에 WSL을 사용하세요. 네이티브 Windows는 검사와 미리보기는 가능하지만, 쓰기 대신 명확한 오류와 함께 중단됩니다. Windows 및 WSL 가이드에 자세한 내용이 있습니다.

2.x 또는 3.0.0에서 업그레이드

claude plugin marketplace update agricidaniel-claude-obsidian
claude plugin update claude-obsidian@agricidaniel-claude-obsidian
버전 3.0.0만 agricidaniel-obsidian 이라는 플러그인 이름을 사용했습니다. 그것을 설치했다면, 마켓플레이스 업데이트를 실행한 다음 claude plugin install claude-obsidian@agricidaniel-claude-obsidian 을 실행하고 Claude Code를 재시작하세요. 네임스페이스 마이그레이션 을 참조하세요.

15개의 스킬, 하나의 시스템

평범한 말로 대화하거나, /claude-obsidian:<skill> 로 이름을 지정해 어떤 스킬이든 호출하세요. 그룹을 열어 내부를 확인하세요.

위키 구축 및 사용 (5)

스킬
하는 일

wiki
새 볼트를 설정하거나 당신의 볼트를 채택하고, 준비 상태를 확인하며 요청을 라우팅합니다

wiki-ingest
캡처된 소스를 출처가 기록된 연결된 페이지로 변환합니다

wiki-query
볼트에 이미 있는 것으로부터 답변합니다, 읽기 전용

save
하나의 답변이나 통찰을 노트로 보관합니다, 요청할 때만

wiki-lint
끊어진 링크, 고아 페이지, 누락된 메타데이터, 빈 섹션을 찾습니다

워크플로 확장 (7)

스킬
하는 일

autoresearch
범위가 제한된 웹 리서치, 당신의 동의가 있을 때만, 검토 후 병합

canvas
Obsidian Canvas 보드를 생성하고 업데이트합니다

defuddle
웹 페이지의 깔끔한 Markdown 캡처를 계획합니다; 정리 도구 자체는 선택적 외부 도구입니다

wiki-fold
작업 로그를 짧고 추적 가능한 요약으로 롤업합니다

wiki-mode
새 노트가 정리되는 방식을 설정합니다: Generic, LYT, PARA 또는 Zettelkasten

wiki-retrieve
선택적 재순위화가 있는 로컬 BM25 검색

wiki-cli
공식 Obsidian 명령줄을 통해 읽고 검색합니다

참조 (3)

스킬
하는 일

obsidian-markdown
올바른 Obsidian Markdown: 링크, 임베드, 콜아웃, 속성

obsidian-bases
네이티브 .base 테이블, 카드, 필터, 수식

think
어려운 결정을 위한 구조화된 검토 루프

크루를 만나보세요

스킬 뒤에서 세 개의 에이전트가 무거운 읽기와 점검을 수행합니다. 세 에이전트 모두 읽기 전용 입니다: 초안과 보고서를 돌려주며, 단 한 곳, 트랜잭션 코어만이 볼트에 씁니다.

에이전트
하는 일

wiki-ingest
캡처된 소스 하나를 읽고 페이지 초안을 돌려주며, 각 대상이 가져야 할 해시를 함께 전달합니다

wiki-lint
볼트 린터를 실행하고, 의외의 발견을 재확인하며, 상태 보고서를 반환합니다

verifier
제안된 변경이나 릴리스에 안전한 테스트를 실행하고 발견한 것을 순위화합니다

다음을 위해 제작됨:

많이 읽고 모든 노트가 출처를 다시 가리키길 원하는 연구자와 학생.
비디오, 기사, 책에서 나온 아이디어가 폴더 속에서 길을 잃지 않고 연결되길 원하는 작가와 크리에이터.
프로젝트 지식을 Markdown으로 보관하고, 그것을 검색하고 인용하며 정돈해 줄 AI를 원하는 빌더와 팀.

아무것도 잃지 않습니다

당신의 노트는 중요하므로, 볼트에 대한 모든 변경은 신중한 저장처럼 작동합니다:

먼저 읽기. Claude는 건드릴 모든 노트를 읽고 각각의 지문(SHA-256 해시)을 기록합니다.
하나의 계획, 하나의 적용. 헬퍼는 병렬로 작업할 수 있지만, 초안만 돌려줍니다. Claude는 이를 하나의 계획으로 병합하고, 검사한 뒤, 단일 트랜잭션으로 적용합니다.
무언가 깨지면 되돌리기. 저널이 쓰기 중 백업을 유지합니다. 전원이 중간에 끊기면, transaction recover가 저널로부터 미완성 변경을 롤백합니다.
당신의 편집이 우선. Claude가 계획하는 동안 Obsidian에서 노트를 변경하면, 지문이 더 이상 일치하지 않아 당신을 덮어쓰는 대신 충돌과 함께 쓰기가 중단됩니다.

웹 리서치, Git 체크포인트, 그리고 데이터를 컴퓨터 밖으로 보내는 모든 것은 먼저 당신에게 묻는 별도의 단계입니다.

호기심 많은 분들을 위해: 볼트가 선택되고 보호되는 방식

플러그인은 자신의 폴더나 캐시를 절대 볼트로 취급하지 않습니다. 볼트는 명시적으로 선택됩니다: CLAUDE_OBSIDIAN_VAULT , 가장 가까운 .claude-obsidian.json , 또는 명확히 초기화된 하나의 상위 폴더를 통해. 확실하지 않으면 쓰지 않고 종료합니다.

잠금은 협조하는 로컬 작성자를 조정합니다. 다른 기기와 외부 편집자는 이를 공유하지 않으므로, 특히 Canvas나 Base 파일을 동기화할 때는 백업을 유지하세요. 전체 세부 사항은 트랜잭션 계약 , 출처 계약 , Compound Vault 가이드 를 읽어보세요.

볼트를 당신이 생각하는 방식에 맞게 구성하세요

wiki-mode는 새 노트가 정리되는 방식을, 당신이 이미 선호하는 방식대로 설정합니다. 모드를 전환하면 새 노트가 가는 위치가 바뀌며, 기존 노트는 절대 이동하지 않습니다.

모드
노트 정리 방식

Generic (기본)
소스, 개념, 엔티티, 세션

LYT
콘텐츠 맵과 연결된 원자적 노트

PARA
Projects, Areas, Resources, Archives

Zettelkasten
안정적인 ID, 원자적 노트, 조밀한 링크

방법론 모드 가이드 에 더 있습니다.

작동 방식

캡처. 소스는 inbox/ 로 들어갑니다. claude-obsidian은 요약되기 전에 각 소스의 내용으로 이름이 지정된 손대지 않은 복사본을 유지합니다.
근거. 노트의 각 중요한 주장은 이를 뒷받침하는 소스에 연결됩니다. 약하거나 상충하는 증거는 매끄럽게 덮이지 않고 드러난 채로 남습니다.
복리. 질문, 리서치, 검색, 린트는 볼트가 이미 알고 있는 것을 사용하므로, 모든 세션이 0이 아닌 당신의 노트에서 시작합니다.

이 아이디어는 Andrej Karpathy의 LLM Wiki 패턴 을 따릅니다: 읽을 수 있는 위키를 AI가 유지하게 하되, 들여다볼 수 없는 블랙박스가 아니라.

오늘 읽을 수 있는 것과 없는 것

입력 또는 기능
오늘의 지원

로컬 파일
캡처되어 콘텐츠 주소 지정 복사본으로 보관됨

이미지
가능한 경우 메타데이터, 해시, 크기, 치수

PDF 및 EPUB
메타데이터, 해시, 크기; 아직 내장 텍스트 추출 없음

웹 페이지 및 YouTube
당신이 승인하는 계획으로 준비됨; 가져오기에는 이를 강제하는 별도 러너가 필요

OCR
당신이 구성하는 외부 도구 필요

검색 (BM25)
로컬 및 결정적

재순위화 또는 원격 모델
선택 사항이며, 당신의 명시적 동의가 있을 때만

Obsidian CLI
읽기와 검색에 선택 사항

명령줄 참조

이 저장소의 클론에서, 동일한 코어를 이식 가능한 명령줄로 사용할 수 있습니다: python3 scripts/claude-obsidian.py . 파일을 변경하는 명령은 먼저 계획을 보여주고 계획의 해시로만 적용합니다.

명령
하는 일

doctor --vault PATH
어떤 볼트가 선택되었는지와 준비 상태를 보여줍니다

init PATH
새 볼트를 계획한 다음 생성합니다

adopt PATH
기존 Obsidian 볼트를 계획한 다음 채택합니다

lint --vault PATH
상태 점검을 실행합니다

capture plan / capture apply
로컬 소스를 검사한 다음 복사본을 보관합니다

transaction recover --vault PATH
중단된 쓰기 후 볼트를 복원합니다

bench --queries FILE --vault PATH
당신의 질문으로 검색 품질을 측정합니다

python3 scripts/claude-obsidian.py --help 를 실행하거나, 어떤 명령에든 --help 를 추가하여 모든 옵션을 확인하세요.

FAQ

claude-obsidian이란 무엇인가요?

Obsidian을 위한 무료 오픈소스 AI 세컨드 브레인입니다: 일반 Markdown의 지식 그래프를 구축하는 개인 지식 관리(PKM) 및 AI 노트 작성 시스템입니다. Claude Code 플러그인(그리고 다른 AI 도구를 위한 Agent Skills 모음)으로, 소스를 연결되고 인용된 노트로 바꾸고, 그로부터 질문에 답하며, 시간이 지나도 볼트를 건강하게 유지합니다.

무료인가요?

네. MIT 라이선스이며 구독도 추적도 없습니다. 자신의 Claude Code 플랜으로, 또는 이미 가지고 있는 다른 AI 도구로 사용합니다.

Obsidian이 필요한가요?

아니요, 하지만 결과를 보는 가장 좋은 방법입니다. 볼트는 일반 Markdown이므로 어떤 편집기든 작동합니다. Obsidian은 그 위에 Graph view, Canvas 맵, Bases 테이블을 더합니다.

이것은 Obsidian 커뮤니티 플러그인인가요?

아니요. Obsidian의 커뮤니티 플러그인 목록에서 설치하지 않습니다. 볼트 폴더에서 작동하는 Claude Code 플러그인(그리고 다른 AI 도구를 위한 Agent Skills 모음)입니다. Obsidian은 결과를 일반 볼트로 열며, Obsidian 플러그인은 필요하지 않습니다.

데이터가 컴퓨터를 떠나나요?

볼트는 일반 파일로 컴퓨터에 남습니다. Claude Code에서 작업할 때, Claude가 읽는 노트는 Claude Code에서 여는 다른 모든 것과 마찬가지로 Anthropic의 모델인 Claude로 전송됩니다. 웹 리서치와 원격 모델은 작업에 대해 허용하기 전까지 꺼져 있습니다.

기존 노트를 망가뜨리나요?

그러지 않도록 만들어졌습니다. 볼트를 채택해도 노트를 이동하지 않으며, 모든 변경은 적용 전에 계획으로 표시되고, 중단된 쓰기는 롤백될 수 있습니다. Claude가 노트를 작업하는 동안 당신이 편집하면, 덮어쓰는 대신 쓰기가 중단됩니다. 그래도 평소처럼 백업을 유지하세요.

노트를 저장하는 채팅과 어떻게 다른가요?

대부분의 AI 노트 도구는 텍스트를 저장하고 끝납니다. claude-obsidian은 원본 소스를 보관하고, 모든 주장을 그것에 다시 연결하며, 새 노트를 오래된 노트에 연결하고, 볼트의 끊어진 링크와 빈틈을 점검합니다. 지식이 쌓이지 않고 복리로 늘어납니다.

Codex, Gemini, Cursor와 함께 작동하나요?

네. 스킬은 개방형 Agent Skills 형식을 따릅니다. Claude Code는 전체 플러그인을 받고; Codex, OpenCode, Gemini, ZCode, Cursor, Windsurf는 하나의 설정 스크립트로 동일한 스킬을 연결합니다. I… 참조