Daniel Vision School Korea · ▶ 영상 보기

옵시디언이 클로드 코드를 만나다
초보도 전문가처럼 쓰는 법

핵심 메시지

터미널을 몰라도 괜찮다.
CLAUDE.md 하나로 AI에게 볼트 운영 규칙을 주면 — Claude Code가 노트 수집·분류·연결을 자동으로 처리한다.
사람은 "무엇을 저장할지"만 결정하면 된다.

1
왜 Obsidian + Claude Code인가

Obsidian은 뛰어난 저장소지만 노트를 체계적으로 연결하고 유지하는 작업이 번거롭다. Claude Code는 자연어 명령으로 파일을 생성·수정할 수 있는 AI CLI다. 이 둘을 연결하면 "두뇌(AI) + 창고(Obsidian)"가 된다.

URL / 메모 입력
→
Claude Code
→
Obsidian 노트 자동 생성
→
링크·분류 완성
역할담당설명
저장소 (Storage)Obsidian마크다운 파일, 링크, 폴더 구조
인텔리전스 (AI)Claude Code내용 분석, 분류, frontmatter 생성, 연결 제안
규칙서 (Schema)CLAUDE.md폴더 구조, 금지 사항, 템플릿 정의
카탈로그 (Index)20-MOC/index.md전체 노트 목록 — LLM이 세션마다 읽음
2
CLAUDE.md — AI에게 주는 운영 설명서

Claude Code는 세션 시작 시 볼트 루트의 CLAUDE.md를 자동으로 읽는다. 이 파일에 규칙을 적어두면 AI가 매번 같은 방식으로 동작한다.

## 세션 시작 체크리스트
1. CLAUDE.md 읽기
2. 20-MOC/index.md 읽기 (전체 노트 파악)
3. 99-System/log.md 최근 5개 항목 확인
4. 요청 유형 파악 (Ingest / Query / Lint)
3
3가지 핵심 사용 패턴

📥 Ingest

URL·메모·파일을 주면 요약 + frontmatter + 링크까지 자동 생성. YouTube, 웹 기사, PDF 모두 처리.

🔍 Query

"KV Cache 내 노트 찾아줘" → 내 볼트 내용 기반으로 답변. 인터넷이 아닌 나만의 지식 DB 활용.

🏥 Lint

고아 노트, 모순 내용, 오래된 정보 자동 탐지. 삭제·병합·업데이트 권고만 하고 실행은 사람이 결정.

4
볼트 폴더 구조 설계 원칙
폴더역할Claude 권한
00-Inbox/미분류 임시 저장생성 가능
10-Notes/개념 1개 = 노트 1개 (Wiki 핵심)생성·수정
20-MOC/주제 허브 탐색 진입점생성·수정
10-Sources/원본 소스 — 절대 불변읽기 전용
40-Projects/진행 중 과제 (기한+결과물 있는 것)생성·수정
99-System/운영 파일 (log, 템플릿, 스킬)제한적 수정
5
초보자가 막히는 4가지 포인트

⚠️ AI가 뭔가 잘못 수정

CLAUDE.md에 금지 사항을 명시하면 해결. "10-Sources/ 수정 금지" 한 줄로 방지 가능.

⚠️ 노트가 많아 못 찾겠다

20-MOC/index.md 정기 갱신을 요청. Ingest마다 자동 업데이트 설정 권장.

⚠️ AI가 뭘 했는지 모른다

99-System/log.md를 append-only로 운영. 모든 세션 이력이 누적 기록됨.

⚠️ 다음 세션에 맥락 소실

세션 시작 체크리스트(CLAUDE.md + index.md 읽기)를 CLAUDE.md에 명시하면 해결.

6
알고 써야 하는 한계
7
시청 후 바로 실행할 5단계
1
Claude Code 설치 + API 키 설정npm install -g @anthropic-ai/claude-code → ANTHROPIC_API_KEY 등록
2
CLAUDE.md 작성볼트 루트에 폴더 구조·규칙·금지 사항 명시 (가장 중요한 단계)
3
20-MOC/index.md 생성기존 노트 목록 정리 — Claude가 세션마다 읽는 카탈로그
4
첫 URL Ingest 테스트"이 YouTube 요약해서 볼트에 저장해줘" 명령으로 첫 자동화 경험
5
정기 Lint 루틴 설정월 1회 "볼트 건강검진 해줘" → 고아 노트·모순 탐지로 볼트 품질 유지

← 전체 리포트 목록  |  ▶ 원본 영상 보기