Claude Code와 Obsidian: 사용자와 에이전트를 위한 하나의 Vault

Claude Code와 Obsidian이 잘 맞는 이유

Obsidian Vault는 텍스트 파일이 담긴 평범한 폴더이며, 중간에 데이터베이스가 없습니다. 그래서 에이전트도 사용자와 똑같이 그 안에서 작업할 수 있습니다.

Claude Code는 터미널, 편집기 또는 데스크탑 앱에서 실행되며 시작한 폴더에서 작업하는 AI 에이전트입니다. 파일을 읽고, 새로 만들고, 기존 파일을 변경하고, 명령을 실행합니다. Vault에서 시작하면 세컨드 브레인 전체가 에이전트 앞에 놓입니다. 회의 메모를 요약하고, 빠진 링크를 추가하고, 자료 모음을 정리하거나, 개요를 첫 초안으로 만들어 알맞은 폴더에 새 노트로 저장합니다.

이것은 Claude Code만의 이야기가 아닙니다. Codex, Cursor, Gemini CLI 등 파일에 접근할 수 있는 다른 에이전트도 같은 방식으로 작동합니다. 반면 브라우저의 채팅은 파일을 직접 복사해 넣지 않는 한 Vault를 보지 못합니다.

Vault에 Claude Code 설정하기

Vault를 작업 디렉터리로 사용

Claude Code는 시작한 폴더에서 작업합니다. Vault가 iCloud Drive에 있다면 터미널에서 예를 들어 다음과 같습니다.

cd ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents/Vault
claude

에이전트가 얼마나 많이 볼지 신중하게 정하십시오. 처음 시도할 때는 한 프로젝트의 폴더 같은 하위 폴더로 충분합니다. 큰 변경을 허용하기 전에 Vault를 백업하십시오. Claude Code는 자신이 편집한 파일은 되돌릴 수 있지만, 터미널 명령으로 일어난 변경은 되돌리지 못합니다. Vault의 Git이나 Time Machine이 이 공백을 메웁니다.

링크된 폴더의 작업에 대한 접근 허용

TandemLoop의 데이터 폴더를 심볼릭 링크로 Vault에 연결하면 실제 위치는 작업 디렉터리 밖에 있으므로, Claude Code는 쓸 때마다 권한을 묻습니다. 그러니 이 폴더에도 접근 권한을 주십시오. 시작할 때 --add-dir로, 실행 중인 세션에서는 /add-dir로, 또는 설정의 additionalDirectories에 영구적으로 추가합니다.

claude --add-dir "<TandemLoop 폴더>"

링크를 만드는 방법과 Mac에서만 되는 이유는 가이드 세컨드 브레인과 할 일 목록 연결하기에서 설명합니다.

CLAUDE.md: Vault의 규칙

Claude Code는 세션을 시작할 때마다 작업 디렉터리와 그 상위 폴더에 있는 CLAUDE.md 파일을 읽습니다. 이 파일에는 에이전트가 Vault에 대해 알아야 할 것과 해도 되는 일이 담깁니다. /init을 실행해 첫 초안을 만든 다음 다듬습니다. Anthropic은 파일을 짧게, 가능하면 200줄 미만으로 유지하고 에이전트가 스스로 알아낼 수 없는 것만 적으라고 권장합니다.

# Vault

Markdown 노트가 담긴 Obsidian Vault. 링크는 위키링크 [[노트]] 형식.

## 폴더
- Notes/: 내 노트, 요청할 때만 변경
- Online Course/: 강의 자료와 결과물
- TandemLoop/: 할 일 앱의 데이터 폴더(링크)

## 규칙
- 묻지 않고 노트를 삭제하거나 이름을 바꾸지 않는다.
- 결과는 알맞은 폴더에 새 노트로 저장한다.
- 파일 맨 위의 속성 구조를 바꾸지 않는다.

## 작업
작업은 먼저 TandemLoop/AGENTS.md를 읽고 그 규칙을 따른다.

다른 에이전트는 보통 CLAUDE.md 대신 AGENTS.md를 읽습니다. Claude Code는 CLAUDE.md를 찾지 못하면 AGENTS.md를 스스로 읽습니다. 둘 다 쓰려면 한 파일에서 @AGENTS.md로 다른 파일을 포함합니다. 에이전트용 안내서의 구성은 가이드 에이전틱 엔지니어링에서 다룹니다.

Obsidian 작업: 체크박스와 Tasks 플러그인

Obsidian은 작업을 체크박스로 다룹니다. - [ ] 2강 대본 쓰기 같은 줄은 미완료 작업이고, [x]이면 완료된 것입니다. 노트 하나 안의 Obsidian 할 일 목록이라면 이것으로 충분합니다.

커뮤니티 플러그인 Tasks는 이를 Vault 전체의 작업 관리로 확장합니다. 마감일, 우선순위, 반복은 마감일을 뜻하는 📅 2026-10-23처럼 줄 안에 기호로 적습니다. 작업을 완료하면 플러그인이 날짜를 추가하고, 반복 작업은 다음 줄을 만듭니다. 코드 블록 안의 쿼리가 모든 노트에서 작업을 모읍니다.

```tasks
not done
due next week
```

이 방식의 장점은 작업이 생긴 곳, 즉 프로젝트 노트와 회의록 안에 바로 있다는 것입니다. Obsidian에 세컨드 브레인을 두는 많은 사람에게는 이것으로 충분합니다.

Tasks 플러그인의 한계

• 미리 알림: Tasks 플러그인 자체는 알림을 보내지 않습니다. 알림은 Reminder 같은 다른 플러그인이 담당하며, 그 문서에 따르면 iPhone과 Android에서는 시스템 알림이 불가능합니다.
• 이동 중 입력: iOS 26부터 Obsidian은 잠금 화면, 제어 센터, 위젯에서 빠른 입력을 제공합니다. 이렇게 입력한 내용은 노트에 텍스트로 들어갑니다. 날짜, 프로젝트, 담당자는 나중에 직접 추가합니다.
• 담당: 줄에는 담당자를 위한 필드가 없습니다. 에이전트와 #agent 같은 태그를 약속할 수는 있지만, ‘검토 필요’ 상태도, 결과나 서로의 질문을 남길 자리도 없습니다.
• 에이전트가 아닌 사용자의 노트: 작업을 완료하거나 보완하려면 에이전트가 사용자의 노트에 있는 줄을 바꿔야 합니다. 작업이 들어 있는 노트가 많을수록 에이전트가 건드리는 파일도 많아집니다.

Claude Code와 Obsidian 작업: 에이전트에게 맡기기

줄 대신 상태, 마감일, 담당자가 있는 독립된 작업을 쓸 수 있습니다. 목표와 수락 기준에 대한 설명, 그리고 에이전트가 한 일을 남기는 기록이 함께 있습니다.

에이전트와 함께 일할 때 이 방식에는 구체적인 장점이 있습니다.

• 에이전트는 사용자의 노트를 건드리지 않고 작업을 변경합니다.
• 담당과 상태가 분명합니다. 작업을 에이전트에게 맡기고, 에이전트가 끝내면 작업이 ‘검토 필요’ 상태로 사용자에게 돌아옵니다.
• 결과와 질문은 내일이면 사라질 채팅 기록이 아니라 작업에 남습니다.

이런 구조를 직접 관리하고 싶은 사람은 없습니다. 에이전트를 위한 안내서와, 파일을 목록, 뷰, 미리 알림으로 바꿔 주는 앱이 필요합니다.

TandemLoop이 돕는 부분: 입력, 뷰, 미리 알림

TandemLoop은 바로 이 방식으로 작동하는 Mac, iPad, iPhone용 할 일 앱입니다. 로컬 또는 iCloud Drive에 있는 데이터 폴더는 Vault의 하위 폴더가 될 수도 있고, 링크로 Vault에 나타날 수도 있습니다. 그러면 에이전트는 노트와 작업을 포함한 Vault 전체에서 일합니다.

• 입력: 빠른 입력, 공유 메뉴, 제어 센터, 단축어, Siri로 실제 작업을 생성하며, 원하면 바로 에이전트에게 맡깁니다.
• 뷰: 목록, 표, 보드, 일정 목록, 캘린더, 멀티 뷰, 대시보드. 담당자나 마감일 등으로 필터링할 수 있습니다.
• 미리 알림: 시간을 포함한 마감일, ‘완료’, ‘나중에’, ‘내일’ 동작이 있는 알림, 홈 화면과 잠금 화면의 위젯.
• 에이전트: 데이터 폴더에는 에이전트용 안내서인 AGENTS.md가 있습니다. 에이전트는 데이터 폴더의 모든 것에 접근할 수 있습니다. 작업, 프로젝트, 영역, 뷰를 생성하고, 변경하고, 이동하며, 자신에게 맡겨진 작업을 처리합니다. 제안을 켜면 새 작업만 수신함에 직접 추가하고 그 밖의 모든 것은 제안으로 저장합니다.
• 반환: 작업을 마쳤거나 사용자에게 무언가 필요하면 작업을 반환합니다. 작업은 ‘에이전트 반환’에, iPhone에서는 ‘반환’ 탭에 나타납니다.

제안부터 반환까지 에이전트와 일을 나누는 방법은 모두 AI 에이전트와 함께 일하기 위한 할 일 앱 페이지에 있습니다. 에이전트 없이 쓰는 전체 기능은 할 일 앱 개요에 있습니다.

워크플로 예시: 수신함 → 에이전트 → 결과

‘온라인 강의’ 프로젝트의 워크플로입니다. 강의 구성안은 Obsidian의 노트이고, 에이전트는 2강 대본의 초안을 써야 합니다.

1. 입력. 출근길에 빠른 입력에 ‘2강 대본 쓰기’를 입력하고, 위임을 ‘초안’으로 해서 에이전트에게 맡깁니다. 작업은 수신함에 들어갑니다.
2. 지시. Mac의 Vault에서 Claude Code를 시작하고 “TandemLoop에서 맡은 작업을 처리해 주세요.”라고 입력합니다. 에이전트는 안내서를 읽고 작업과 강의 구성안을 찾습니다.
3. 작업에 결과 기록. 대본을 Online Course 폴더에 노트로 저장하고, 작업의 기록에 무엇을 했는지 노트 링크와 함께 적습니다.
4. 에이전트 반환. 위임이 ‘초안’이었으므로 에이전트는 작업을 직접 완료하지 않고 검토용으로 반환합니다. Obsidian에서 대본을 읽고 TandemLoop에서 ‘수락’을 선택하거나, 코멘트와 함께 ‘재작업 요청’을 선택합니다.
5. 사용자만 할 수 있는 일. 업로드에 강의 플랫폼의 인증된 계정이 필요하면, 에이전트는 긴 답변 속에 언급하는 대신 ‘강의 플랫폼 접근 권한 확인’을 수신함에 넣습니다.

에이전트가 Mac에서 반복 실행되면, 예를 들어 TandemLoop의 작업자 스킬과 Claude Code의 /loop 10m /tandem-worker로 실행하면, 자리를 비운 동안에도 이런 작업을 처리합니다. 한 번에 하나의 에이전트만 써야 합니다.

어떤 방식이 맞을까

두 방식을 섞어 쓸 수도 있습니다. 작은 일을 위한 체크리스트는 노트에 두고, 에이전트가 처리하는 모든 일은 독립된 작업으로 만듭니다. Getting Things Done으로 작업을 정리한다면 GTD 방법론 가이드에서 에이전트가 맡을 수 있는 단계를 보여 줍니다.