ONEDEV

claudian

AI Coding ToolsEditorTypeScript

★ 15,273주당 +109조회 4

무엇인가

Claudian은 Obsidian 플러그인으로, 노트 편집기 안에 코딩 에이전트 CLI를 붙인다. 별도 터미널 창에서 에이전트를 돌리고 결과 파일을 편집기로 옮기는 흐름을 대체하는 자리다. 자체 모델 호출 계층을 두지 않고, 이미 설치된 에이전트 하네스를 그대로 실행한다.

어떻게 동작하나

리본 아이콘이나 커맨드 팔레트로 채팅 사이드바를 연다. 볼트 루트가 에이전트의 작업 디렉터리가 되므로 파일 읽기·쓰기·검색·bash 실행이 볼트 경로 기준으로 동작한다. 입력창에서 `/`와 `$`는 사용자·볼트 스코프의 프롬프트 템플릿과 스킬을, `@`는 볼트 파일·폴더·Collab 멤버 변경을, `#`는 Collab 티켓을 참조한다. `/instruction`은 채팅 입력에서 추가한 커스텀 지시를 다듬는다. MCP 서버는 각 CLI가 관리하는 네이티브 MCP 설정을 그대로 읽는다. 세션은 단일 패널의 탭 또는 채팅 옆 듀얼 패널 세션 매니저로 관리한다.

무엇과 다른가

터미널에서 같은 CLI를 직접 쓰는 것과의 차이는 편집기 통합이다. 선택 텍스트에 핫키를 누르면 노트 안에서 직접 편집되고 단어 단위 diff 미리보기가 뜬다. 다른 Obsidian AI 플러그인이 자체 API 키와 모델 호출을 내장하는 것과 달리, Claudian은 프로바이더 CLI를 spawn하고 그 CLI의 인증·도구·MCP 구성을 재사용한다. 프로바이더 추가는 플러그인이 아니라 CLI 쪽에서 이루어진다.

어떻게 쓰나

설치는 Obsidian 설정 → 커뮤니티 플러그인 → 찾아보기에서 "Claudian"을 검색해 설치하고 활성화한다. 소스에서 쓸 경우 저장소를 볼트의 plugins 폴더에 클론하고 의존성을 설치해 빌드한 뒤 커뮤니티 플러그인에서 활성화한다. CLI 자동 감지에 실패하면 설정 → Advanced → Claude CLI path에 실행 파일 경로를 넣고, Node.js 경로 문제는 설정 → Environment의 PATH 변수로 해결한다.

전제와 한계

Claude Code CLI, Codex CLI, Grok Build, OpenCode, Pi 중 최소 하나가 설치되어 있어야 하고, OpenRouter·Kimi·GLM·DeepSeek 같은 구독이나 API 프로바이더가 필요하다. Obsidian v1.13.0 이상, 데스크톱(macOS·Linux·Windows) 전용이며 Collab 모드는 Git을 요구한다. 번들 크기가 5MB를 넘어 Obsidian Sync로 플러그인 파일을 동기화할 수 없으므로 기기마다 따로 설치·갱신해야 한다. 새 프로바이더를 추가하는 풀 리퀘스트는 받지 않는다.

관련 논문 4

유사 도구