An Obsidian plugin that embeds Claude Code/Codex as an AI collaborator in your vault

Claudian – Obsidian 내 AI 기반 코딩 어시스턴트

개요 – Claudian은 다양한 LLM 기반 코딩 에이전트(Claude Code, Codex, Grok Build, OpenCode, Pi, DeepSeek Harness 등)와 볼트에서 직접 대화할 수 있는 Obsidian 커뮤니티 플러그인입니다. 볼트가 에이전트의 작업 디렉토리가 되어 모델이 파일을 읽고, 쓰고, 검색하고, 셸 명령을 실행하고, 다단계 워크플로를 수행할 수 있습니다.

주요 기능

기능	설명
인라인 편집	텍스트를 선택(또는 커서를 놓고)하고 단축키를 누르면 에이전트가 노트를 그 자리에서 편집하고 단어 수준의 diff 미리보기를 제공합니다.
Zen 모드	채팅 UI가 노트 하단의 컴팩트한 컴포저로 접혀서 작성에 집중할 수 있습니다.
슬래시 명령 및 스킬	`/` 또는 `$`를 입력하여 재사용 가능한 프롬프트 템플릿(스킬)을 삽입합니다. 볼트 또는 사용자 범위로 지정할 수 있습니다.
@멘션	프롬프트에서 다른 볼트 파일, 폴더 또는 이전 Claudian 세션을 참조합니다.
사이드 채팅 (`/side` 또는 `/btw`)	메인 채팅을 방해하지 않고 실험을 위한 임시 사이드 대화를 엽니다.
MCP 서버	각 제공자의 네이티브 "Managed Client Protocol" 구성을 통해 외부 도구를 연결합니다.
탭 및 세션 관리자	여러 채팅 탭, 단일 또는 이중 창 레이아웃, 영구 세션 관리.
협업	별도 플러그인(Claudian Collab)이 실시간 다중 사용자 편집을 추가합니다.

지원되는 에이전트(제공자)

Claude Code (Anthropic)
Codex (OpenAI)
Grok Build (xAI)
OpenCode (v2, v1은 2026년 10월에 더 이상 사용되지 않음)
Pi (Earendil Works)
DeepSeek Harness

사용하려는 제공자에 해당하는 CLI 또는 API 구독이 필요합니다.

설치

Obsidian에서 – 설정 → 커뮤니티 플러그인 → 찾아보기 → "Claudian" 검색 → 설치 → 활성화.
소스에서 – <vault>/.obsidian/plugins/claudian에 클론하고 npm install && npm run build를 실행한 다음 Obsidian에서 활성화합니다.

개발 모드는 npm run dev(감시) 또는 npm run build(프로덕션 번들)로 사용할 수 있습니다.

작동 방식(고수준 아키텍처)

src/main.ts – 플러그인 진입점.
core – 제공자에 독립적인 실행 엔진, 프로세스 처리, 프롬프트 인코딩, 도구 추상화.
providers/* – 각 LLM 서비스(Claude, Codex 등)에 대한 어댑터로, CLI 감지, 모델 검색, 기록을 처리합니다.
features/* – UI 구성 요소: 채팅 사이드바, 인라인 편집 모달, 설정 UI 등.
shared 및 utils – 재사용 가능한 UI 구성 요소와 일반 헬퍼.

개인정보 및 데이터 사용

제공자에게 전송되는 것: 프롬프트, 첨부된 파일/이미지, 도구 호출 결과. 대상(Anthropic, OpenAI 등)은 제공자별로 구성할 수 있습니다.
텔레메트리 없음: Claudian은 백그라운드 사용 데이터를 전송하지 않습니다. 네트워크 트래픽은 제공자 또는 MCP 엔드포인트를 명시적으로 호출할 때만 발생합니다.

일반적인 문제 해결 단계

CLI를 찾을 수 없음 – 제공자의 CLI가 시스템 PATH에 있는지 확인하거나(또는 설정 → Claudian → 제공자에서 경로를 수동으로 설정) 확인합니다.
모델 누락 – 제공자 CLI를 업데이트한 다음 제공자의 모델 목록 아래에서 검색을 클릭합니다.
인증 실패 – ANTHROPIC_API_KEY와 같은 환경 변수가 CLI 자격 증명을 덮어쓸 수 있습니다. 플러그인의 환경 설정에서 지우거나 덮어씁니다.
Node / npm 경로 불일치 – CLI가 사용하는 Node 바이너리가 GUI 앱의 환경에서 접근 가능한지 확인합니다(해당 디렉토리를 공유 PATH에 추가).

도움말 / 기여

버그 또는 기능 요청은 GitHub 저장소에 이슈를 열어주세요.
풀 리퀘스트를 환영합니다. CONTRIBUTING.md를 참조하세요. 새 제공자는 허용되지 않습니다 – 유지 관리자가 업스트림에서 추가해야 합니다.

라이선스 및 후원

MIT 라이선스.
Moonshot AI (Kimi)와 Ke Holdings Inc. (BEIKE)가 후원합니다. 프로모션 링크에서 제휴 커미션을 받지 않습니다.

요약: Claudian은 최신 LLM 코딩 에이전트로 구동되는 대화형 코딩 플레이그라운드로 Obsidian 볼트를 변환하며, 완전한 기능의 채팅 UI, 인라인 편집, 확장 가능한 도구 통합을 제공하면서 데이터 흐름을 투명하게 유지하고 텔레메트리가 없습니다.

YishenTu/claudian