옵시디언 클로드 연동 방법 가이드: Claudian으로 나만의 AI 비서 만들기
옵시디언에서 클로드를 직접 사용하는 방법, Claudian 플러그인 설치부터 활용법까지 한 번에 정리했습니다. 터미널 없이 옵시디언 안에서 AI와 대화하는 방법을 지금 바로 확인해보세요.
옵시디언에 열심히 노트를 쌓아왔는데, 이걸 AI한테 물어볼 방법이 없을까 고민해본 적 있으신가요?
터미널에서 Claude Code를 쓰는 방법은 있지만, 매번 파일 경로 입력하고 화면 왔다갔다 하는 게 불편하셨다면 이 글이 딱 맞습니다.
이 글에서는 옵시디언 클로드 연동을 위한 Claudian 플러그인 설치 방법부터, 실제 어떻게 활용하면 좋은지까지 단계별로 안내합니다.
옵시디언 클로드 연동이란? Claudian을 먼저 이해하자
Claudian은 옵시디언(Obsidian) 안에서 Claude Code CLI를 바로 사용할 수 있게 해주는 커뮤니티 플러그인입니다.
쉽게 말해서, 내가 옵시디언에 써둔 노트들을 AI가 직접 읽고 답변해주는 구조예요. 별도의 복잡한 설정 없이 “내가 지난주에 정리한 내용 요약해줘”같은 질문을 자연스럽게 할 수 있게 됩니다.
기존 터미널 방식의 한계
Claude Code를 터미널에서 직접 쓰면 이런 불편함이 있었습니다.
| 불편한 점 | 설명 |
|---|---|
| UI 없음 | 터미널 기반이라 화면 구성이 불편함 |
| 파일 경로 수동 입력 | 참고할 파일마다 경로를 직접 타이핑해야 함 |
| 컨텍스트 스위칭 | 글 쓰다가 터미널로, 다시 옵시디언으로 이동 반복 |
Claudian은 이 세 가지 문제를 한 번에 해결해줍니다.
Claudian이 제공하는 핵심 기능
- 컨텍스트 자동 연결 : 현재 보고 있는 노트가 자동으로 AI 대화에 첨부됨
- 볼트 전체를 작업 공간으로 : 옵시디언 볼트 안의 모든 파일을 AI가 읽고 씀
- @ 멘션으로 파일 참조 : 대화 중에 다른 노트를 빠르게 불러올 수 있음
- 인라인 편집 : 텍스트 선택 후 수정 요청 → 미리보기 → 적용/거절 순서로 진행
옵시디언 클로드 연동 전 준비물 확인
설치를 시작하기 전에 아래 3가지 조건을 먼저 확인해야 합니다.
필수 조건 체크리스트
- Claude Code CLI가 내 컴퓨터에 설치되어 있어야 함
- Claude 구독 또는 Claude Code API를 구독 중이어야 함
- 데스크탑(PC/Mac) 버전 옵시디언을 사용 중이어야 함
모바일 옵시디언에서는 Claudian이 작동하지 않습니다. 반드시 데스크탑 환경에서 진행하세요.
Claude Code CLI 설치가 아직 안 되어 있다면, Claude Code 설치 가이드를 먼저 참고하시길 바랍니다.
옵시디언 클로드 연동 방법 : Claudian 설치 6단계
1단계 : GitHub에서 플러그인 파일 다운로드
현재 Claudian은 옵시디언 커뮤니티 플러그인 탭에서 검색이 되지 않습니다. GitHub에서 직접 파일을 받아야 해요.
Claudian GitHub 릴리즈 페이지에서 아래 3개 파일을 다운로드합니다.
main.jsmanifest.jsonstyles.css
2단계 : 옵시디언 플러그인 폴더에 파일 추가
옵시디언 볼트 폴더 안에 있는 .obsidian/plugins 경로로 이동합니다.
여기에 claudian이라는 새 폴더를 만들고, 위에서 다운받은 3개의 파일을 그 안에 넣어주세요.
폴더 경로 구조는 이렇습니다.
내 볼트 폴더/
└── .obsidian/
└── plugins/
└── claudian/
├── main.js
├── manifest.json
└── styles.css
💡
.obsidian폴더가 보이지 않는 경우, 숨김 폴더가 가려져 있는 상태입니다.
- Mac : Finder에서
Command + Shift + .단축키를 누르면 숨김 폴더가 표시됩니다.- Windows : 파일 탐색기 상단 메뉴
보기 → 숨긴 항목체크박스를 활성화하세요.
3단계 : 옵시디언에서 플러그인 활성화
옵시디언을 열고 설정 → 커뮤니티 플러그인 탭으로 이동합니다.
목록에서 Claudian을 찾아 토글을 켜서 활성화하세요.
💡 목록에 Claudian이 보이지 않으면 옵시디언을 완전히 종료했다가 다시 실행해보세요.
4단계 : Claude CLI 설치 경로 확인
터미널(Mac: Terminal, Windows: PowerShell)을 열고 아래 명령어를 입력합니다.
which claude
명령어 실행 결과로 나오는 경로(예: /usr/local/bin/claude)를 복사해두세요.
5단계 : Claudian 설정에 경로 입력
옵시디언 설정 → Claudian 설정 탭으로 이동한 뒤, 4단계에서 복사한 경로를 붙여넣습니다.
이 과정이 없으면 Claudian이 Claude CLI를 찾지 못해 실행이 안 됩니다.
6단계 : 재시작 후 사용 시작
옵시디언을 완전히 껐다가 다시 켜세요. 이후 cmd + P (Windows는 Ctrl + P)를 누르고 claudian을 검색하면 사용 가능한 명령어 목록이 나타납니다.
Claudian 실전 활용법 : 노트가 쌓일수록 강력해진다
Claudian의 진짜 힘은 볼트에 노트가 많을수록 AI 답변의 질이 높아진다는 점입니다. 단순히 질문에 답하는 게 아니라, 내가 쌓아온 맥락 위에서 대화하기 때문이에요.
노트 초안을 빠르게 완성하는 법
글을 쓰다가 막히는 순간, 굳이 다른 창을 열 필요가 없습니다. 현재 노트를 열어둔 채로 Claudian에게 바로 요청하면 됩니다.
- 개요만 잡아두고 “이 구조대로 본문 채워줘” 요청
- 두서없이 쓴 초안을 붙여넣고 “논리 흐름 다듬어줘” 요청
- 영어 레퍼런스를 @ 멘션으로 첨부하고 “한국어로 내 스타일에 맞게 요약해줘” 요청
인라인 편집 기능 덕분에 AI가 제안한 수정 내용을 미리보기로 확인하고, 마음에 드는 부분만 골라서 적용할 수 있어요.
여러 노트를 연결해서 새 인사이트 뽑기
@ 멘션으로 서로 다른 노트를 동시에 참조시킬 수 있습니다. 예를 들어 경쟁사 A 분석 노트와 경쟁사 B 분석 노트를 함께 첨부하고 “두 회사의 전략 차이점 정리해줘”라고 하면, 따로따로 읽었을 때는 보이지 않던 패턴이 보이기 시작합니다.
노트가 많아질수록 이 연결의 폭이 넓어지는 게 Claudian의 가장 큰 장점입니다.
반복 작업을 템플릿화하기
매주 쓰는 주간 회고, 매월 작성하는 독서 기록처럼 반복되는 포맷이 있다면 템플릿 노트를 하나 만들어두세요. 그 노트를 @ 멘션으로 첨부하고 “이번 주 내용으로 채워줘”라고 하면 포맷 고민 없이 바로 작성이 가능합니다.
| 활용 상황 | Claudian 사용 방법 |
|---|---|
| 초안 작성 | 개요 노트 열고 본문 작성 요청 |
| 노트 간 비교 | @ 멘션으로 복수 노트 첨부 후 분석 요청 |
| 반복 문서 작성 | 템플릿 노트 첨부 후 내용 채우기 요청 |
| 인라인 수정 | 텍스트 드래그 후 수정 요청 → diff 확인 → 적용 |
Cursor처럼 우측 패널로 쓰는 팁
기본 설정에서는 채팅 창이 별도 창으로 열립니다. Cursor처럼 오른쪽 사이드바에 붙여서 쓰고 싶다면 이렇게 하세요.
- 채팅 창을 옵시디언 우측 패널로 드래그 앤 드롭
- 우측 패널 단축키를 Cursor와 동일하게 설정
이렇게 설정하면 글을 쓰면서 오른쪽에서 AI와 대화하는 Cursor와 거의 동일한 환경이 만들어집니다.
옵시디언 클로드 연동 핵심 정리
Claudian 하나로 옵시디언은 단순한 노트 앱을 넘어, 내 기록을 가장 잘 아는 AI 비서와 함께 일하는 공간이 됩니다.
터미널 없이, 파일 경로 입력 없이, 지금 보고 있는 노트를 AI가 바로 참조하는 경험은 생각보다 훨씬 편합니다.
옵시디언을 이미 쓰고 계신다면 지금 바로 6단계 설치를 시도해보세요. 설치 도중 막히는 부분이 있다면 댓글로 남겨주시면 함께 해결해드리겠습니다.
