Obsidian의 노트를 AI가 직접 읽고 쓰게 하고 싶다. 또한, 스마트폰에서도 메모를 집어넣고 싶다.

이 두 가지를 동시에 충족하려다 보니 몇 가지 걸림돌이 있었습니다. 절차 자체는 공식 README에 적혀 있으므로, 여기서는 README를 읽어도 헷갈렸던 부분과 미리 해결해 둔 설정에 대해서만 작성하겠습니다.

• macOS(MacBook Air) + iPhone
• Obsidian
• Claudian (Obsidian 플러그인. Claude Code를 vault 내에 임베드함)
• Claude Code CLI (이미 VS Code에서 사용하던 것)
• 동기화는 iCloud Drive

설치와 CLI 경로 설정은 README대로 문제없이 통과했습니다. 헤맨 것은 그 다음입니다.

Claudian은 반복되는 작업을 "스킬 (skill)"로 등록할 수 있습니다. 채팅창에서 $를 입력하면 목록이 나오는 바로 그 메커니즘입니다 (/는 슬래시 커맨드, $가 스킬).

여기서 위치가 두 종류가 있어 혼동하기 쉬운 포인트가 됩니다.

문서를 살펴보면 vault/.agents/skills/라는 기술이 눈에 들어오지만, 이것은 Codex / Grok / Opencode / Pi용 공유 장소입니다. Claude 프로바이더를 사용하는 경우의 위치는 다음과 같습니다.

vault/.claude/skills/<스킬명>/SKILL.md

Claudian은 vault를 그대로 에이전트의 작업 디렉토리로 사용하므로, vault/.claude/ 이하가 Claude Code의 프로젝트 스코프(project scope)로 작용하는 구조입니다. 같은 이유로 CLAUDE.md도 vault의 루트 직하에 두어야 합니다. _meta/ 등에 넣으면 읽히지 않습니다.

여러 프로바이더에 대응하는 플러그인이기 때문에, 경로 설명이 나열된 부분에서 혼란스러워지기 쉽습니다.

Claudian은 데스크톱 전용입니다. macOS / Linux / Windows만 지원합니다.

이유를 알면 포기할 수 있습니다. Claudian은 Claude Code CLI를 자식 프로세스 (child process)로 실행하는 구조이기 때문에, Node 실행 환경이 없어 프로세스를 실행할 수 없는 모바일 버전 Obsidian에서는 원리적으로 작동할 수 없습니다. 플러그인의 노력 부족이 아니라 구조상의 제약입니다.

그래서 역할을 나누기로 했습니다.

• 스마트폰 = 넣기만 함 (떠오른 것을 집어넣음)
• Mac = 처리함 (한꺼번에 AI에게 정리시킴)

이것은 타협이 아니라 아마도 올바른 분담일 것입니다. 이동 중에 구조화를 할 수도 없고, 할 필요도 없습니다. "스마트폰에서도 AI를 구동한다"를 포기한 순간, 설계가 깔끔해졌습니다.

참고로, 모바일에서도 채팅할 수 있는 다른 플러그인 (Vault Companion for Claude 등)도 나와 있으므로, 꼭 필요하다면 병용하는 방법도 있습니다.

iOS 버전 Obsidian은 iCloud Drive의 어디에서나 vault를 열 수 있는 것이 아니라, Obsidian 전용 컨테이너만 확인합니다. Mac 측의 실체는 여기입니다.

~/Library/Mobile Documents/iCloud~md~obsidian/Documents/<Vault명>/

Finder에서는 "iCloud Drive" 안의 "Obsidian" 폴더로 보입니다. iCloud Drive 직하나 Documents/에 둔 vault는 iPhone의 Obsidian에서는 보이지 않습니다. Mac 단독으로는 평소처럼 사용할 수 있기 때문에 iPhone을 열기 전까지는 눈치채지 못합니다.

경로에 공백(Mobile Documents)이 있어 터미널에서 다루기 불편하므로, 심볼릭 링크 (symbolic link)를 걸어두면 편합니다.

ln -s ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/<Vault명> ~/vault

단, Obsidian과 Claudian에는 실체 경로를 사용하게 하는 것이 무난합니다. 링크를 통해 열면 플러그인이 설정 파일을 의도하지 않은 장소에 만드는 경우가 있습니다.

이 항목은 실제로 오류를 겪은 것은 아니지만, 구조상 문제가 생길 것 같아 미리 해결해 둔 것입니다.

시스템 설정 → Apple ID → iCloud → iCloud Drive에 "Mac 저장 공간 최적화"가 있습니다. 기본값은 켬(On) 상태입니다.

이 설정이 켜져 있으면, 한동안 열지 않은 파일의 실체가 로컬에서 제거되어 플레이스홀더 (Placeholder) 상태가 됩니다. macOS는 읽기 시점에 자동으로 다운로드를 시도하므로 보통은 투명하게 작동하지만, CLI 도구가 다수의 파일을 한꺼번에 스캔하는 상황에서는 대기 시간이 길어지거나 실패할 가능성이 있습니다.

Claudian은 vault 전체를 검색하거나 grep 하는 것을 전제로 하는 도구이므로, 이 설정은 꺼두는 것이 안심할 수 있다고 판단했습니다. 노트는 텍스트이므로, 꺼두더라도 용량 문제는 발생하지 않습니다.

확인은 터미널에서도 할 수 있습니다.

defaults read com.apple.bird optimize-storage

1이 반환되면 켬(On), 0 또는 에러라면 끔(Off)입니다.

실제로 어디까지 문제가 되는지는 검증하지 않았습니다. 경험하신 분이 있다면 댓글로 알려주세요.

iCloud는 병합(Merge)하지 않습니다. 동일한 노트를 두 기기에서 수정하면, 양쪽 모두를 남겨두고 별도의 이름을 가진 복사본을 만들 뿐입니다. 게다가 알림이 미미하여 알아차리기 어렵습니다.

기술적으로 해결하려고 하면 번거롭기 때문에, 운영 규칙을 통해 발생하지 않도록 했습니다.

스마트폰은 00_Inbox/에 새 파일만 생성합니다. 기존 노트는 편집하지 않습니다.

새 파일이라면 이름이 충돌하지 않으므로, 컨플릭트 (Conflict)가 원리적으로 발생하지 않습니다. 편집은 Mac으로 돌아온 뒤에 합니다. 제약처럼 보이지만, 애초에 스마트폰에서 기존 노트를 구조적으로 편집하고 싶어 하는 일은 거의 없었습니다.

또 한 가지, Mac을 켠 직후에 AI를 실행하지 마세요. iCloud 동기화가 끝나기 전이라면, AI가 오래된 상태의 Inbox를 보게 됩니다. 수십 초만 기다리면 되는 일이지만, 이를 인지하지 못하면 "메모가 사라졌다"라고 착각하게 됩니다.

Claudian은 vault 전체에 접근할 수 있습니다. 편리하지만, 내성(Introspection)이나 개인적인 메모까지 멋대로 읽히는 것은 솔직히 기분이 좋지 않습니다.

그래서 CLAUDE.md에 다음과 같이 작성했습니다.

## 60_Journal/
개인적인 경험, 감정, 내성을 둔다.
명시적으로 지시받지 않는 한, 읽지 않는다 · 검색하지 않는다 · 쓰지 않는다.
...

"읽지 않는다"뿐만 아니라 **"답변을 개선할 목적이라도 참조하지 않는다"**까지 쓰는 것이 포인트였습니다. 전자만 적으면 "도움이 될 것 같아서 보았습니다"라는 상황이 발생할 수 있습니다.

또 하나 효과가 있었던 것은 이것입니다.

사용자가 작성한 주관적인 내용을,
AI의 해석에 의해 객관적 사실로 다시 쓰지 않는다.

AI에게 내성 노트를 다루게 하면, 흔들림이나 망설임을 멋대로 정리된 결론으로 고쳐버립니다. 작성자 본인에게는 그 흔들림이야말로 기록의 핵심이기 때문입니다.

환경을 막 구축한 상태라 아직 노트가 거의 들어있지 않습니다. 운영해 보니 전혀 다른 부분이 문제가 될 것 같다는 생각도 듭니다. 2주 정도 운영해 보고 바뀐 점이 있다면 이어서 작성하겠습니다.

동일한 구성을 구축하려는 분은, 3번(vault의 위치) 만이라도 먼저 확인해 두면 나중에 이동하는 수고를 덜 수 있을 것입니다.