Claudian-옵시디언에서 Claude Code 사용하기

회사에서 Claude Code를 결제해줘서 최근 유용하게 사용 중이다.
그러다 보니 예전부터 미뤄왔던 옵시디언 정리를 하고 싶다는 생각이 들었다. 개발 내용 문서화도 하고, 개인 정리도 하고 싶었는데 문제가 하나 있었다.

Claude Code와 옵시디언을 연동해주는 플러그인이 없더라.
그래서 어쩔 수 없이 옵시디언의 bash 플러그인을 이용해서 별도로 창을 띄워서 사용했었다. 솔직히 좀 불편했다. 설정도 귀찮고, 매번 창을 따로 열어야 하고...

그러던 중에 우연히 발견한 게 바로 Claudian이다!

Claudian

Claudian은 옵시디언 플러그인인데, Claude Code를 옵시디언 안에서 바로 사용할 수 있게 해준다. 쉽게 말해서 옵시디언 Vault가 Claude의 작업 디렉토리가 되는 것이다.

처음 봤을 때 "오, 이거다!" 싶었다. bash 플러그인으로 별도 창 띄우는 것보다 훨씬 간편하고 설정도 편해 보였다.

실제로 써보니까 꽤 괜찮은 기능들이 많다.

Features

• 파일 읽고 쓰기: Vault 안의 모든 파일을 읽고 쓸 수 있다. 에이전트처럼 알아서 동작한다.
• 이미지 분석: 드래그 앤 드롭이나 붙여넣기로 이미지를 넣으면 분석해준다. Vision API를 쓰는 것 같다.
• 인라인 편집: 노트 안에서 직접 텍스트를 수정할 수 있다. 단어 단위로 diff를 미리 보여줘서 뭐가 바뀌는지 확인 가능하다.
• 자동 컨텍스트: 현재 열려있는 노트를 자동으로 컨텍스트로 넣어준다.
• @ 멘션: @ 문법으로 특정 파일만 선택적으로 포함시킬 수 있다.
• 태그 기반 제외: 민감한 노트는 태그로 제외시킬 수 있다.
• 에디터 선택 영역: 특정 부분만 하이라이트해서 컨텍스트로 쓸 수 있다.
• 외부 디렉토리 접근: Vault 밖의 파일도 접근 가능하다.
• 커스텀 인스트럭션: #으로 시작하면 시스템 프롬프트를 커스터마이즈할 수 있다.
• 슬래시 커맨드: /command 형태로 재사용 가능한 명령어를 만들 수 있다. 인자도 넣을 수 있다.
• 스킬 모듈: Claude Code의 스킬 아키텍처랑 호환된다.
• MCP 서버 연결: Model Context Protocol 서버에 연결 가능하다.
• 모델 선택: Haiku, Sonnet, Opus 중에서 선택할 수 있다.
• Plan 모드: 실행하기 전에 솔루션을 먼저 탐색해본다.

자세한건 직접 사용해보면서 습득하는게 빠른것 같다

Installation

설치 방법은 세 가지가 있다.

1. Release에서 직접 다운로드(추천)

GitHub Release에서 파일 세 개(main.js, manifest.json, styles.css)를 받아서 .obsidian/plugins/claudian/ 폴더에 넣고 설정에서 활성화하면 된다.

2. BRAT 사용

BRAT 플러그인을 설치하고 레포지토리 URL을 추가하면 자동으로 설치되고 업데이트도 관리해준다. 이게 제일 편한 것 같다.

3. 소스에서 빌드

개발자라면 직접 클론해서 빌드할 수도 있다.

# 플러그인 폴더로 클론
git clone https://github.com/YishenTu/claudian .obsidian/plugins/claudian
cd .obsidian/plugins/claudian

# 빌드
npm install
npm run build

Settings

설정 옵션이 꽤 다양하다.

• 사용자 이름 설정 (인사말용)
• 태그 기반 필터링
• 미디어 폴더 지정
• 커스텀 시스템 프롬프트
• 자동 스크롤 토글
• 대화 제목 자동 생성

모드	설명
YOLO	자동으로 모든 작업 승인 (위험할 수 있음)
Safe	매번 승인 필요 (권장)
Plan	실행 전에 계획 먼저 검토

그 외에도:

• Bash 커맨드 블랙리스트 (정규식 지원)
• Export 경로 제한 (기본: Desktop, Downloads)
• 사용자 Claude 설정 통합
• 커스텀 MCP 서버 설정
• Claude Code 플러그인 관리
• 환경 변수 구성
• CLI 경로 지정

보안 관련해서도 꽤 신경 쓴 것 같다.

• Claude의 파일 접근은 Vault로 제한된다 (symlink 검증 포함)
• 외부 쓰기는 설정한 export 경로로만 가능하다
• 모든 설정과 상호작용은 vault/.claude/에 로컬 저장된다
• 세션 데이터는 ~/.claude/projects/에 저장된다
• 입력, 첨부 파일, 툴 출력은 API 제공자(기본 Anthropic)로 전송된다

Requirements

시작하기 전에 필요한 것들:

• Claude Code CLI 설치 (네이티브 설치 추천)
• Obsidian 1.8.9 이상
• 데스크톱 환경 (macOS, Linux, Windows)
• Claude 구독 또는 Anthropic API 접근 권한

Summary

옵시디언 쓰면서 Claude Code도 쓰고 있다면 Claudian은 거의 필수 플러그인이라고 할 수 있다. 설치도 간단하고, 설정도 직관적이고, 기능도 강력하다.

특히 문서화 작업이나 개인 노트 정리할 때 AI 도움을 받고 싶다면 정말 추천한다. BRAT으로 설치하면 업데이트 관리도 자동으로 되니까 한번 써보길 바란다!

GitHub - YishenTu/claudian: An Obsidian plugin that embeds Claude Code as an AI collaborator in your vault