내 노트를 전부 읽는 AI가 있다면 — Obsidian x Claude Code 이야기

요약 정리

핵심 내용 (TL;DR)

• Claude Code는 로컬 디렉토리의 파일을 읽고 쓸 수 있는 AI 도구이며, Obsidian 볼트 폴더를 연결하면 수년간 축적한 개인 노트를 맥락으로 활용하는 AI 어시스턴트가 된다.
• CLAUDE.md 파일로 에이전트에게 볼트 구조를 설명하고, 스킬(skills)로 반복 작업을 자동화하며, 에이전트 전용 컨텍스트 파일로 "세컨드 브레인"을 구축할 수 있다.

주요 포인트

• Claude vs Claude Code: Claude는 일반 챗봇, Claude Code는 로컬 파일시스템에 접근하는 에이전트 버전
• Obsidian 연동의 핵심: 볼트 폴더를 Claude Code 작업 디렉토리로 지정 → 노트 전체를 맥락으로 활용
• CLAUDE.md: 세션 시작 시 자동 로딩되는 지시 파일. 볼트 구조, 사용 규칙 등을 정의
• 에이전트 세컨드 브레인: index(학습 기록), orient(최근 작업 현황) 등 에이전트 전용 컨텍스트 파일 구축
• 실용 스킬 예시: /today(오늘 할 일), /content(콘텐츠 아웃라인), /crm(커뮤니티 관리), /close(세션 마무리 및 학습 저장)
• 상담/코칭 활용: 볼트 속 개인 기록을 기반으로 맥락 있는 비즈니스 상담, 자기 성찰 가능
• 주의사항: 개인 생각은 직접 수기로 작성해야 AI가 자기 생성물로 오염되지 않음

---

Obsidian에서 Claude Code 사용하는 법 — 노트 전체를 AI 맥락으로 쓰는 방법 정리

Obsidian에서 Claude Code를 연결하면, 볼트에 쌓인 수년간의 노트를 AI가 전부 맥락으로 활용할 수 있다. CLAUDE.md 설정, 에이전트 세컨드 브레인 구축, 스킬 자동화까지 — Theo Stowell의 실전 경험을 바탕으로 핵심만 정리했다.

나는 Obsidian에 4년치 노트가 쌓여 있다. 업무 회의록, 분석 쿼리 메모, 가끔은 새벽에 끄적인 생각 조각까지. 그런데 이 노트들을 AI가 전부 읽을 수 있다면 어떨까?

Theo Stowell이라는 사람이 바로 이걸 했다. Obsidian 볼트 폴더를 Claude Code에 연결해서, 자기 노트 전체를 맥락으로 쓰는 AI 어시스턴트를 만든 것이다.

Claude Code란? ChatGPT와 뭐가 다른가?

Claude Code는 일반 챗봇이 아니다. 컴퓨터의 특정 폴더에 직접 접근해서 파일을 읽고 쓴다. Obsidian 볼트가 결국 마크다운 파일이 담긴 로컬 폴더니까, Claude Code를 그 폴더에 열면 — 끝이다. 내가 쓴 모든 노트가 AI의 맥락이 된다.

"내가 생산성 관련해서 어떤 점을 힘들어하는지 내 노트 기반으로 알려줘"라고 물으면, 진짜 내 기록을 뒤져서 답한다. ChatGPT에게 같은 질문을 하면 일반적인 생산성 팁이 나오는 것과는 좀 다르다.

CLAUDE.md 설정 방법 — 생각보다 간단하다

핵심은 CLAUDE.md 파일이다. 볼트 루트에 이 파일을 하나 만들어두면, Claude Code가 세션을 시작할 때마다 자동으로 읽는다. 여기에 볼트 구조, 폴더 규칙, 내가 원하는 동작 방식을 써두면 된다.

재미있는 건 이 파일 자체를 Claude에게 만들어달라고 할 수 있다는 점이다. "이 볼트의 구조에 맞는 CLAUDE.md를 만들어줘. 내가 채울 수 있게 질문 형태로"라고 하면, Claude가 알아서 템플릿을 짜준다.

Theo는 여기서 한 발 더 나갔다. 에이전트 전용 파일을 따로 만들었다.

• index: Claude가 나에 대해 학습한 것들의 목록
• orient: 내가 최근에 뭘 하고 있었는지 정리

이건 사람이 읽을 용도가 아니다. Claude가 읽고, 다음 세션에서 "아, 어제 이 분석 작업 하고 있었지"라고 맥락을 이어가기 위한 것이다.

Claude Code 스킬(Skills)로 반복 작업 자동화하기

Theo가 실제로 쓰는 스킬 몇 가지를 보자.

/today는 볼트를 스캔해서 오늘 가장 중요한 작업을 뽑아준다. /content는 아이디어를 넣으면 볼트의 제텔카스텐에서 관련 노트를 찾아 개인적인 관점이 반영된 콘텐츠 아웃라인을 만든다. /crm은 Obsidian 안에 구축한 커뮤니티 CRM을 읽고 "지금 이 사람에게 DM 보내면 좋겠다"고 추천한다.

가장 중요한 건 /close다. 세션을 마무리하면서 대화 내용을 요약하고, index와 orient 파일을 업데이트한다. 다음에 /today를 실행하면 이전 세션의 맥락이 살아있는 이유다.

AI 상담과 비즈니스 코칭 — 맥락이 있으면 달라진다

보통 AI한테 고민 상담을 하면 "자기 관리가 중요합니다"류의 뻔한 답이 돌아온다. 근데 Obsidian 볼트에 수년간 쓴 개인 기록이 있고, Claude Code가 그걸 전부 읽었다면? 이야기가 달라진다.

Theo는 Claude Code를 비즈니스 컨설턴트로도 쓴다고 했다. 내가 어디서 같은 실수를 반복하는지, 어떤 패턴으로 결정을 미루는지 — 내 노트에 다 드러나 있으니까.

단, 주의할 점이 하나 있다. 볼트에 AI가 생성한 텍스트가 너무 많아지면, AI가 자기 글을 읽고 다시 자기 식으로 답하는 순환에 빠진다. 개인적인 생각은 직접 써야 한다.

데이터 분석가로서 드는 생각

이 글을 읽으면서 든 생각은 — 이게 분석 업무에도 먹힌다는 거다. 분석 쿼리, 회의 메모, 실험 결과 노트가 쌓인 볼트에 Claude Code를 연결하면, "지난달에 비슷한 분석 했었는데 그때 쿼리 어떻게 짰지?"라는 질문에 실제 내 기록 기반으로 답할 수 있다. Obsidian이 로컬 마크다운이라는 점이 이런 활용에 딱 맞는다.

원문: The TL;DR of Claude Code Inside Obsidian — Theo Stowell

---