Claude Code는 파일을 읽을 수 있습니다. Obsidian은 파일을 저장합니다. 둘을 합치면 볼트의 모든 것 --- 모든 노트, 모든 웹 클립, 모든 저장된 기사를 아는 AI 연구 보조자가 생깁니다.

이 가이드는 Claude Code를 Obsidian 볼트에 연결하고 전체 지식 베이스에 걸쳐 질문하는 방법을 보여줍니다.

이 조합이 작동하는 이유

Obsidian은 컴퓨터의 폴더에 있는 Markdown 파일로 모든 것을 저장합니다. Claude Code는 접근 권한을 준 모든 폴더를 읽을 수 있습니다. Claude Code를 Obsidian 볼트로 지정하면:

Claude가 수천 개의 노트를 검색 가능
Markdown을 기본으로 이해 (제목, 링크, 태그, frontmatter)
소스를 교차 참조하고 놓쳤을 연결을 찾을 수 있음
새 노트 작성 및 기존 노트 업데이트 가능
채팅 창에 들어가는 것만이 아닌 지식의 전체 컨텍스트 보유

이것이 Andrej Karpathy가 AI 연구를 위해 설명한 설정입니다 --- LLM이 연구할 수 있는 개인 위키. Obsidian + Claude Code는 가장 실용적인 구현입니다.

1단계: AI를 위한 볼트 설정

기존 Obsidian 볼트는 아마 그대로 작동합니다. 그러나 몇 가지 정리 팁이 Claude가 더 잘 작동하도록 도움을 줍니다:

설명적인 파일명 사용. meeting-notes-2026-04-12.md가 untitled-3.md보다 낫습니다. Claude는 검색할 때 파일명을 스캔합니다.

frontmatter 사용. YAML frontmatter의 태그, 날짜, 설명이 Claude가 각 노트가 무엇에 관한지 이해하는 데 도움을 줍니다:

---
title: React Server Components Deep Dive
tags: [react, architecture, frontend]
date: 2026-04-10
source: https://example.com/article
---

날짜가 아닌 주제별로 정리. research/, projects/, references/ 같은 폴더가 연도순 정렬보다 Claude에게 더 유용합니다.

2단계: Save로 볼트에 웹 콘텐츠 공급

대부분의 Obsidian 볼트의 가장 큰 한계는 수동으로 타이핑한 것만 포함한다는 것입니다. 최고의 지식은 웹 전체에 흩어져 있습니다 --- 기사, 문서, YouTube 동영상, 트윗, Reddit 스레드.

Save는 어떤 웹페이지든 깨끗한 Markdown으로 변환하는 Chrome 확장 프로그램입니다. 페이지를 저장하면 Markdown 파일이 Save Vault 폴더로 갑니다. 그 폴더를 Obsidian 볼트에 심링크하면, 저장하는 모든 웹페이지가 검색 가능한 Obsidian 노트가 됩니다.

Save가 캡처하는 것:

기사 및 블로그 게시물
YouTube 동영상 (전체 자막)
Twitter/X 스레드
Reddit 게시물 및 토론
문서 및 API 참조
학술 논문
Confluence 및 위키 페이지

각 저장은 적절한 frontmatter가 있는 깔끔한 .md 파일입니다 --- Obsidian과 Claude를 위해 준비됩니다.

3단계: Claude Code 연결

터미널을 열고 볼트 디렉토리에서 Claude Code 시작:

cd /path/to/your/obsidian-vault
claude

그게 전부입니다. Claude Code는 이제 볼트의 모든 파일에 접근합니다. 무엇이든 물어보세요:

“배포 전략에 대해 저장한 기사의 핵심 사항은 무엇인가요?”
“React 성능과 관련된 모든 노트를 찾고 주요 패턴을 요약해주세요”
“지난주 회의 노트와 제품 로드맵 사이에 어떤 연결이 있나요?”
“가격 프레임워크에 대해 저장한 모든 것의 요약 문서를 만들어주세요”

4단계: 항상 켜진 접근을 위한 MCP 사용

Claude Code 대신 Claude Desktop을 사용한다면 파일시스템 MCP 서버를 설정하세요:

{
  "mcpServers": {
    "obsidian-vault": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/obsidian-vault"
      ]
    }
  }
}

이제 Claude Desktop은 어떤 대화 중에도 요청에 따라 볼트를 읽을 수 있습니다. Save에는 Claude에게 저장된 웹 페이지에 직접 접근을 제공하는 자체 MCP 서버도 있습니다.

실제로 어떻게 보이는가

월요일: Save를 사용하여 경쟁사 가격 전략에 관한 3개의 기사를 저장합니다. 자동으로 Obsidian 볼트에 착지합니다.

수요일: 고투마켓 관련 컨퍼런스 YouTube 동영상 자막을 저장합니다. 컬렉션에 합류합니다.

금요일: 볼트에서 Claude Code를 열고 묻습니다: “이번 주 저장한 모든 것을 바탕으로, 새 제품에 어떤 가격 전략을 고려해야 할까요?”

Claude가 4개의 문서를 모두 읽고, 교차 참조하고, 일반적인 학습 데이터가 아닌 당신의 큐레이션된 연구에 근거한 답을 제공합니다.

시간이 지남에 따라: 볼트가 수백 개의 노트와 저장된 페이지로 성장합니다. Claude는 전체 도메인을 아는 연구 보조자가 됩니다. 더 많이 저장할수록 더 스마트해집니다.

복리 효과

이 설정은 복리가 됩니다. 새 노트와 저장된 웹페이지가 Claude를 더 유용하게 만듭니다. 몇 달 후:

읽은 모든 것의 검색 가능한 아카이브 보유
Claude가 전체 컬렉션에서 종합하여 질문에 답할 수 있음
Obsidian 볼트가 진정한 세컨드 브레인이 됨 --- AI가 실제로 읽을 수 있는 것
잊혀진 북마크와 탭 쌓기에 지식을 잃는 것을 멈춤

시작하기

Save 설치로 웹 페이지를 Markdown으로 클리핑 시작
Obsidian 볼트 내부 또는 옆에 Save Vault 폴더 설정
볼트에서 Claude Code 열기: cd vault && claude
지식 베이스에 대한 질문 시작

최고의 AI 지식 베이스는 실제로 구축한 것입니다. Save + Obsidian + Claude Code가 그것을 손쉽게 만듭니다.