옵시디언 노트를 AI에게 학습시키는 법 — Claude Code로 나만의 JARVIS 만들기

Posted on by ehrok

최근 모든 형태의 파일을 마크다운(Markdown)으로 통일해 주는 Microsoft MarkItDown 사용법을 소개한 적이 있습니다. 만약 이렇게 변환한 마크다운 폴더(Vault)를 단순히 자료 보관용으로만 둔다면 가장 중요한 절반을 놓치고 있는 것입니다.

Obsidian과 Claude가 하나의 Vault를 공유할 때 생기는 진짜 시너지

단순히 "옵시디언 뷰어로 자료를 편하게 보고, 필요할 때 클로드한테 파일을 하나씩 올려준다"는 병렬적인 사용 방식을 넘어, 두 시스템이 마크다운 파일 시스템(Vault)을 시스템 단위에서 완전히 공유할 때 폭발하는 시너지는 다음과 같습니다.

1. Claude가 ‘나의 뇌 구조(맥락)’를 통째로 읽고 답변합니다 생짜 원본 PDF나 엑셀을 브라우저 클로드에 올려주면, AI는 그 문서 내용 하나만 단편적으로 이해하고 뻔한 대답만 늘어놓습니다. 하지만 MarkItDown으로 문서들을 마크다운 변환 후 옵시디언에 넣고, 내가 노트 아래에 [[관련 프로젝트]]나 짧은 코멘트를 덧붙였다고 가정해 보겠습니다. 이후 Claude에게 이 Vault 폴더 전체를 연결해 주면, Claude는 단순 문서를 넘어 “이 실장님이 이 문서를 어떤 프로젝트와 연결 지어 고민하고 있는지” 그 맥락과 관계망까지 통째로 파악해서 훨씬 수준 높고 개인화된 기획안을 도출해냅니다.

2. 복사/붙여넣기가 사라진 완벽한 양방향 업무 흐름 (Closed-loop)

  • 기존 방식: 원본 문서 열기 ➡️ 웹 브라우저 띄워 Claude에 파일 업로드 ➡️ 요약 질문 ➡️ 답변 복사 ➡️ 옵시디언 열기 ➡️ 붙여넣고 마크다운 서식으로 재수정…
  • 시너지 방식:
    1. MarkItDown이 들어오는 모든 자료를 마크다운 텍스트로 통일해 폴더(Vault)에 저장합니다.
    2. 에디터 터미널이나 Claude Code 등 폴더를 열 수 있는 로컬 AI 기반 도구를 열고 "오늘 추가된 회의록과 기존 프로젝트 기획안을 종합해 요약 문서를 만들어줘"라고 지시합니다.
    3. AI가 파일들을 분석하고, 지정한 폴더 안에 직접 새로운 .md 파일을 생성하거나 알아서 내용을 수정해 줍니다.
    4. 이후 옵시디언 창을 열어 보기만 하면, 방금 AI가 작성한 문서가 마크다운 서식(표, 헤딩 등)까지 완벽히 깨진 곳 없이 즉시 뷰어에 나타납니다.

3. 언제든 AI를 갈아탈 수 있는 영원한 데이터 주권 노션이나 에버노트는 그 프로그램이 제공하는 AI만 강제로 써야 하고, 내 마음대로 데이터를 통째로 꺼내 다른 다양한 최신 AI에게 먹이기가 구조적으로 매우 힘듭니다. 반면 내 컴퓨터에 Vault 하나를 튼튼하게 구축해두면 이야기가 달라집니다. 옵시디언은 영구적이고 안전한 지식 저장소 및 뷰어로만 남고, Claude(또는 챗GPT 등 어떤 AI든)는 내 저장소의 텍스트 풀을 처리해주는 지능적인 외주 직원으로 역할이 완벽히 분담됩니다. 내일 당장 더 똑똑한 새 AI 모델이 세상에 나오면, 그냥 그 모델에 내 Vault 폴더 경로만 연결해 주면 그만입니다.

결론적으로 토니 스타크의 JARVIS처럼, 나의 관심사와 업무 히스토리를 데이터 레벨에서 통째로 파악하고 있는 단 하나뿐인 맞춤형 지식 파이프라인(AI 비서)을 구축하는 방법을 아래에 단계별로 소개합니다.

주요 특징 (Key Features)

① Obsidian — 텍스트 파일로 이루어진 개인 지식 데이터베이스

Obsidian은 노트 앱이다. 하지만 결정적인 차이가 있다. 모든 노트가 내 컴퓨터에 .md 텍스트 파일로 저장된다. 클라우드에 종속되지 않고, 구독료가 파일을 볼모로 잡지 않는다. 그리고 텍스트 파일이기 때문에 어떤 프로그램도 읽을 수 있다 — AI 포함.

항목 내용
저장 방식 로컬 .md 마크다운 파일
클라우드 의존 없음 (옵션으로 동기화 가능)
파일 이동성 어떤 텍스트 편집기에서도 열림
AI 연동 가능성 ✅ 폴더 경로만 알면 AI가 직접 읽기 가능

② Claude Code — 브라우저 Claude와 완전히 다른 도구

Claude Code는 Anthropic이 만든 터미널 기반 AI 도구다. 브라우저 Claude와 결정적으로 다른 점 하나: 내 로컬 파일을 직접 읽고 수정한다.

브라우저 Claude는 새 탭을 열 때마다 나를 처음 만난 사람처럼 대한다. Claude Code는 Obsidian vault 폴더를 직접 가리키면 수백 개의 파일을 읽고, 내 글쓰기 패턴과 연구 맥락을 파악한 상태로 답변한다.

③ 연결의 마법 — 내 지식이 AI의 컨텍스트가 된다

두 도구를 연결하면 질문의 성격이 달라진다.

일반 AI 질문 Obsidian + Claude Code 질문
“AI 에이전트가 뭐야?” “내가 기록한 AI 에이전트 관련 메모 전체를 읽고 핵심만 정리해줘”
“보고서 초안 써줘” “내 문체와 논리 구조를 그대로 따라서 이번 달 보고서 초안 만들어줘”
“시장 트렌드 알려줘” “내가 6개월간 기록한 시장 분석 노트에서 반복 등장하는 키워드를 추출해줘”

AI가 인터넷에서 답하는 게 아니라 나의 기록에서 답한다.

④ 활용 범위 — 검색 이상의 작업이 가능하다

  • 수백 개 노트에서 특정 주제 요약
  • 오래된 메모와 최근 메모의 아이디어 연결
  • 내 글쓰기 패턴으로 새 초안 생성
  • 연구 공백 지점 파악 (“이 주제에서 내가 다루지 않은 부분은?”)
  • 커스텀 대시보드 및 자동 요약 브리핑 생성

설치 (Installation)

⚠️ 사전 조건 2가지

  1. Claude Code 구독: claude.ai/code에서 설치 (npm install -g @anthropic-ai/claude-code 또는 공식 설치 페이지 참고)
  2. Obsidian 설치: obsidian.md에서 무료 다운로드. 이미 쓰고 있다면 건너뜀.

Step 1. Claude Code 설치

💡 초보자 가이드: ‘터미널’이란 컴퓨터에 명령어를 직접 입력하는 검은 화면이다. Windows는 시작 → PowerShell 또는 cmd, Mac은 Spotlight → Terminal로 열 수 있다. VS Code를 쓴다면 내부 터미널(Ctrl + `)을 쓰는 게 더 편하다.

# npm이 설치되어 있다면 (Node.js 설치 필요)
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

Step 2. Obsidian vault 폴더로 이동 후 Claude Code 실행

💡 초보자 가이드: cd는 "Change Directory"의 약자로 폴더를 이동하는 명령어다. Obsidian에서 설정 → 파일 및 링크 → Vault 위치를 확인하면 내 노트 폴더 경로를 알 수 있다.

# 내 Obsidian vault 폴더로 이동 (경로는 본인 폴더로 변경)
cd "C:/Users/내이름/Documents/MyVault"

# Claude Code 실행
claude

터미널에 claude> 프롬프트가 뜨면 준비 완료다. 이제 이 위치에서 내린 모든 명령은 내 vault 폴더 전체를 컨텍스트로 사용한다.

사용 (Usage)

기본 — 노트 요약 및 검색

💡 초보자 가이드: Claude Code에서는 프롬프트에 질문을 입력하면 된다. 마치 카카오톡 대화창처럼 텍스트를 입력하고 Enter를 누르면 된다. AI가 vault 폴더 안의 파일들을 직접 열어서 읽는다.

# vault 전체에서 특정 주제 요약
"올해 내가 기록한 AI 관련 메모를 모두 읽고 핵심 주제 3가지로 정리해줘"

# 특정 파일 분석
"meeting-notes 폴더에 있는 회의록들을 읽고 Action Item만 추출해줘"

# 키워드 연결
"'프로젝트 파이낸싱'이 언급된 메모를 모두 찾아서 공통 패턴을 알려줘"

아이디어 연결 — 오래된 메모와 최근 메모 잇기

"3개월 이상 된 리서치 노트와 최근 노트를 비교해서
 같은 주제를 다른 방식으로 다룬 경우가 있으면 연결해줘"

"내가 아직 다루지 않은 리서치 공백 지점을 찾아줘"

글쓰기 초안 — 내 문체로 새 문서 생성

가장 강력한 활용법이다. 기존 노트를 학습한 Claude가 내 문체와 논리 구조를 반영한 초안을 생성한다.

"지난 6개월간 내가 작성한 시장 분석 노트를 기반으로
 이번 분기 보고서 초안을 내 문체 그대로 써줘"

"내 블로그 글 스타일을 분석하고,
 [주제]에 대해 같은 톤으로 초안을 작성해줘"

💡 실사용 결과: 기존에 3시간 이상 걸리던 관련 메모 취합·정리·초안 작성 과정이 5분 내로 단축됐다. 노트가 쌓일수록 AI의 분석 정확도도 올라간다.

노트 자동 생성 — Claude가 직접 파일 만들기

"오늘 회의 내용을 바탕으로 YYYY-MM-DD-회의명.md 파일을
 Obsidian 표준 frontmatter와 함께 생성해줘"

"이번 주 리서치 내용을 요약해서 weekly-summary 폴더에 저장해줘"

유의할 점 (Things to Watch Out For)

1. 이미지와 PDF 내부 텍스트는 읽지 못한다

Claude Code는 .md 텍스트 파일을 완벽하게 읽는다. 하지만 노트 안에 첨부된 이미지 속 텍스트나, PDF 파일 내부 내용은 건너뛰는 경우가 많다. 이미지나 PDF의 내용을 AI가 참조하게 하려면 별도 텍스트 변환 작업이 필요하다.

# PDF → Markdown 변환이 필요하다면 MarkItDown 활용
pip install 'markitdown[pdf]'
markitdown 파일.pdf -o 파일.md

2. 복잡한 폴더 구조와 모호한 파일명은 오류를 유발한다

폴더 구조가 지나치게 깊거나 파일명이 메모1.md, untitled.md 같이 모호하면 Claude가 엉뚱한 파일을 참조하거나 찾지 못할 수 있다.

나쁜 예 좋은 예
메모1.md 2026-03-25-PF사업-검토.md
untitled.md crawl4ai-리서치.md
temp/new/draft/ (3단계 이상 중첩) 리서치/AI도구/ (2단계 이내)

파일명에 핵심 키워드를 포함하는 것이 정확도를 높이는 가장 빠른 방법이다.

3. Claude Code는 파일을 수정·삭제할 수 있다

이것이 브라우저 Claude와의 핵심 차이이자 주의사항이다. Claude Code는 실제로 내 파일을 수정하거나 새 파일을 만든다. 처음 사용할 때는 반드시 수정 전 확인을 요청하는 습관을 들이자.

# 명령어에 확인 조건 추가
"파일을 수정하기 전에 어떤 변경을 할지 먼저 알려줘"

4. vault 크기가 클수록 처리 시간이 늘어난다

수천 개의 파일이 있는 vault에서 전체 검색을 요청하면 응답 시간이 길어진다. 폴더를 특정하는 방식으로 범위를 좁히면 빠르다.

# 전체 검색 (느림)
"모든 메모에서 AI 관련 내용 찾아줘"

# 범위 지정 (빠름)
"리서치/AI 폴더 안에서만 검색해줘"

정리 (Summary)

항목 내용
핵심 조합 Obsidian (로컬 .md vault) + Claude Code (터미널 AI 도구)
차별점 AI가 내 축적된 지식을 컨텍스트로 사용 — 매번 설명 불필요
설치 난이도 낮음 — 터미널에서 cd [vault경로] → claude 실행이 전부
가장 강력한 활용 내 문체·논리 구조로 초안 생성 (3시간 → 5분)
지원 파일 형식 .md 텍스트 완벽 지원 / 이미지·PDF 내부 텍스트는 미지원
주의사항 파일명 키워드 포함 필수 / 파일 수정 전 확인 요청 권장
효과 노트가 쌓일수록 AI 정확도 증가 — 데이터가 곧 자산

Obsidian vault에 노트가 쌓여 있을수록 이 조합의 위력은 커진다. vault가 연료고 Claude Code가 엔진이다. 브라우저 AI를 검색 엔진처럼 쓰는 단계에서 벗어나, 내 지식을 증폭시키는 도구로 AI를 쓰고 싶다면 지금 바로 시작할 수 있다.

Claude Code 공식 문서: https://docs.anthropic.com/claude-code Obsidian 공식 사이트: https://obsidian.md