Claude × Obsidian 연동 패턴 — 2026년 화제성 트렌드

2026-05-13 첫 작성. Jake 노션 페이지 + 외부 리서치 통합. 1순위 목적 🎯 콘텐츠 헌장 “클로드가 혼자 운영” 달성을 위한 운영 토대 강화.

🎯 핵심 발견 — 두 카테고리 상호 보완

연동 도구는 누가 누구를 호출하는가로 크게 두 카테고리로 나뉜다.

A. Skills 패러다임 — Claude → Obsidian (CLI 작업 시)

  • Claude Code가 Obsidian vault 폴더에서 작업할 때 wikilink·frontmatter·callout 같은 Obsidian 문법을 정확히 따르게 가르치는 방식
  • .claude/skills/ 폴더에 markdown skill 파일들을 두면 Claude가 자동 인지
  • 우리 1순위 목적 (“클로드 혼자 운영”)과 직결 — 클로드가 vault 작업을 일관 품질로 수행

B. Plugin 패러다임 — Obsidian → Claude (사이드바 채팅)

  • Obsidian 앱 사이드바에 Claude Code/Codex 등 에이전트 임베드
  • Jake가 Obsidian 열고 노트 안에서 직접 Claude와 대화·편집
  • Inline Edit, @mention, Slash Commands, Plan Mode 등 IDE 같은 경험

두 패러다임은 상호 보완. Skills가 클로드의 vault 이해를 강화하면 자동 작업 품질 ↑. Plugin은 Jake가 직접 vault 안에서 작업할 때 효율 ↑.

📚 화제성 프로젝트 — 6개 핵심

A. Skills 카테고리

1. kepano/obsidian-skills (Obsidian CEO 공식) ⭐ 채택 완료

  • GitHub: https://github.com/kepano/obsidian-skills
  • 별: 14,900+ (2026-01 출시 3개월 만)
  • 만든이: Steph Ango (kepano) — Obsidian CEO
  • 5개 skill:
    • obsidian-markdown — wikilink, embed, callout, frontmatter properties
    • obsidian-bases — .base DB layer (view, filter, formula, summary)
    • json-canvas — .canvas 시각 노트맵 (node, edge, group)
    • obsidian-cli — Obsidian CLI 통해 vault 상호작용
    • defuddle — 웹페이지에서 깔끔한 마크다운 추출
  • 설치 (우리 적용): vault .claude/skills/ 에 5개 폴더 복사 → vault git 동기화로 모든 디바이스 자동 반영
  • 검증 방법: 다음 세션에서 “What skills do you have access to?” → obsidian-* 5개 잡혀야 정상

B. Plugin 카테고리

2. Claudian (YishenTu/claudian) — 가장 핫

  • GitHub: https://github.com/YishenTu/claudian
  • 별: 11,000+
  • 특징: Obsidian 사이드바 채팅으로 Claude Code/Codex 내장. vault를 AI 작업 공간으로 — 파일 읽기/쓰기/편집/검색/터미널 명령
  • 기능: Inline Edit, @mention, Slash Commands, Plan Mode, MCP 지원
  • 평가: “Obsidian을 IDE처럼 만든다”
  • 설치: BRAT 또는 GitHub Release

3. Agent Client (RAIT-09/obsidian-agent-client)

  • GitHub: https://github.com/RAIT-09/obsidian-agent-client
  • 특징: Claude Code + Codex + Gemini CLI 등 여러 에이전트 동시 활용
  • 기능: @노트 언급, Auto-Mention, 터미널 도구 실행
  • 상태: Obsidian 포럼에서 신규 플러그인으로 주목

4. Cortex

  • 특징: Claude Code 에이전트를 vault 안 사이드 패널로 직접 내장
  • 장점: API 키 없이 Claude Pro/Max 구독만으로 사용 가능

5. CAO (Claude AI for Obsidian)

  • 특징: 노트 안에서 직접 Claude와 대화
  • 지원: 공식 Claude 모델 + OpenAI-compatible API
  • 적합 사용자: 채팅 중심 단순 사용자

C. 워크플로 프레임워크 (Karpathy 패턴 구현)

6. AgriciDaniel/claude-obsidian

  • GitHub: https://github.com/AgriciDaniel/claude-obsidian
  • 핵심 슬래시 명령: /wiki /save /autoresearch
  • Hot Cache 패턴 ⭐ 우리에게 가장 필요
    • 세션 종료 시 hot.md 자동 갱신
    • 다음 세션은 hot.md → index.md → 도메인 sub-index 계층 조회
    • Jake가 매일 같은 맥락 다시 설명하는 부담 차단의 핵심
  • 자동 indexing: 사용자 개입 없이 개념/엔티티/소스 자동 분류
  • Append-only log: log.md 매 세션 추가 (감사 추적)
  • Linting: orphan 페이지 + 데드링크 자동 감지

7. eugeniughelbur/obsidian-second-brain (31개 명령 시스템)

  • GitHub: https://github.com/eugeniughelbur/obsidian-second-brain
  • 4 Layer: Operations(21) / Thinking Tools(4) / Context(1) / Research(5)
  • 운영 사이클: 일일 / 주간 / 야간 자동화 / 주간 건강검진
  • Vault-First Research 4단계 ⭐ Jake 부담 ↓ 핵심
    1. vault 스캔 (이미 알고 있는 내용)
    2. 격차 분석 (모르는 영역 식별)
    3. 목표 검색 (격차만 외부에 검색)
    4. 합성 (delta 보고: 새것 / 확인 / 모순)
  • 최고 ROI 명령:
    • /obsidian-ingest — URL 1개 → 5~15 페이지 동시 생성
    • /research-deep — 격차 충전으로 토큰 절약
    • /obsidian-challenge — vault 이력으로 자신의 결정 반박

🧠 Karpathy LLM Wiki 패턴 (개념 토대)

대부분의 위 워크플로 프레임워크가 이 패턴 기반.

핵심 차이 — RAG vs LLM Wiki

  • RAG: 쿼리마다 chunk 검색 → LLM이 매번 처음부터 추론. 누적 X
  • LLM Wiki: long-context LLM이 raw 소스를 직접 받아 wiki 생성·유지·확장. Knowledge compounds like interest

워크플로 5단계

  1. wiki/ 또는 brain/ 폴더 생성
  2. 주제별 마크다운 파일 — LLM 소비 방식 (완전한 문장, 명확한 헤더)
  3. 시스템 프롬프트: “Answer only from the provided wiki content”
  4. 모든 파일 통합: cat wiki/*.md > wiki_export.txt → LLM 입력
  5. 100K 단어 이하면 전체 로딩, 그 이상이면 주제별 선택

우리 vault와의 매핑

  • 우리 06 Claude/Memory/, 04 Knowledge/, 03 Personal/YouTube/ 가 이미 LLM Wiki 토대
  • 다만 자동 ingest·자동 indexing·hot.md 패턴은 미적용 — 도입 검토 항목

🎯 우리 갭 분석 + 적용 우선순위

항목현재 우리베스트 프랙티스적용 ROI진행 상태
Obsidian skillkepano/obsidian-skills 5개 (vault .claude/skills/)kepano/obsidian-skills⭐⭐⭐ 즉시 큼✅ 2026-05-13 설치 완료
Vault-first research6단계 자가 사고 체크리스트에 통합4단계 (스캔→격차→검색→합성)⭐⭐⭐ Jake 부담 ↓✅ 2026-05-13 완료 (quality-charter + session-resume + 자동 메모리 feedback_vault_first_research)
Hot cache06 Claude/Memory/hot.md 신설hot.md (자동 갱신)⭐⭐⭐✅ 2026-05-13 완료 (/session-end skill에 통합)
Challenge / 자기 반박/challenge 글로벌 skill/challenge 명령⭐⭐⭐✅ 2026-05-13 완료 (~/.claude/skills/challenge/)
Slash 명령 시스템/session-end /challenge /ingest /research-deep 4개5~10개 핵심 명령⭐⭐✅ 2026-05-13 4개 도입 (추가는 자연 발생 시)
URL ingest 자동화/ingest 글로벌 skill/ingest 1 URL → 다중 페이지⭐⭐✅ 2026-05-13 완료 (~/.claude/skills/ingest/)
야간 scheduled없음cron + 자동 agent⭐⭐🚧 일정 잡으면
Wiki linting없음orphan/deadlinks 자동 감지⭐🚧 후순위
Plugin 카테고리 (사이드바)없음Claudian / Agent Client옵션Jake 워크플로 결정 후

📋 도입 권고 — 단계별 계획

1단계 — ✅ 완료 (2026-05-13)

  • ✅ kepano/obsidian-skills 설치 (vault .claude/skills/ 5개: obsidian-markdown / obsidian-bases / json-canvas / obsidian-cli / defuddle)
  • ✅ vault git push로 모든 디바이스 자동 동기화 가능 상태

2단계 — ✅ 완료 (2026-05-13)

  • ✅ Vault-first research 4단계 패턴을 [[quality-charter]] 자가 사고 체크리스트 6번으로 통합 (스캔→격차→목표 검색→delta 합성)
  • ✅ session-resume 상단 자가 사고 요약에도 6번 추가
  • ✅ 자동 메모리 feedback_vault_first_research.md 신설 (매 세션 자동 로드, 4단계 + 예외 + 검증 사례)

3단계 — ✅ 완료 (2026-05-13)

  • ✅ 06 Claude/Memory/hot.md 신설 — 직전 세션 캐시 (4 섹션 + 새 룰 max 3개)
  • ✅ /session-end SKILL.md 2-5 섹션 강화 — hot.md 갱신 단계 명시
  • ✅ session-resume.md 상단 안내 — 세션 시작 읽기 순서 4단계 (hot → session-resume → device → charter)
  • ✅ hot.md vs session-resume.md vs quality-charter.md 역할 분담 명확화

4단계 — ✅ 완료 (2026-05-13)

  • ✅ ~/.claude/skills/challenge/SKILL.md — Jake 결정 반박 도구 (vault 스캔 → 충돌 분류 → 자체 비판 단정 근거)
  • ✅ ~/.claude/skills/ingest/SKILL.md — URL → vault 다중 페이지 자동 생성 (Karpathy ingest)
  • ✅ ~/.claude/skills/research-deep/SKILL.md — Vault-first 4단계 명시 실행 (격차 보고 → 외부 검색 → delta)

5단계 — 🚧 보류 (Jake 워크플로 결정 후)

  • Claudian (11K stars) 또는 Agent Client 설치 검토
  • Jake가 옵시디안 안에서 직접 작업 빈도 높으면 즉시 도입 가치
  • 우리 1순위 목적 (혼자 운영)과는 별개의 Jake 편의 도구
  • 결정 트리거: Jake가 vault 안 작업 빈도·필요 정의

6단계 — 🚧 야간 자동화 (장기, Jake 일정 결정 후)

  • cron + scheduled agent — 모순 조정·패턴 합성·linting을 야간에 자동
  • vault 자기 유지 시스템
  • 사전 조건: 5단계 결정 + 자동 실행 환경 (어느 디바이스가 항상 켜져있는지) 정의

🚨 도입 시 주의 사항

Vault 백업 필수

  • 자동 ingest·linting 도구가 잘못 작동하면 vault 손상 가능
  • vault 이미 git 동기화되어 있어서 안전망 있음 — 큰 변경 전 commit 보장

Skills vs Plugin 충돌 가능성

  • Skills는 CLI/외부 클로드의 vault 작업용
  • Plugin은 Obsidian 안 임베드
  • 같이 써도 충돌 없으나 작업 시작 위치(터미널 vs Obsidian)에 따라 발동되는 도구가 다름

Karpathy 패턴 token 비용

  • 100K 단어 이상 vault 풀 로드는 토큰 비용 큼
  • 우리 vault는 이미 수 MB 규모 — 선택적 로딩 (도메인별 선택) 필수

클로드 이미지 인식 한계

  • 기존 룰 그대로 — 시각 자료 검수는 Jake 판단 우선
  • vault 내 이미지·canvas 검수도 같은 룰

🎯 1순위 목적과 직접 연결

이 모든 도구는 🎯 콘텐츠 헌장 1순위 목적 “클로드가 혼자 운영하는 시청자 가치 콘텐츠 자동 제작” 달성의 토대.

특히 Jake가 “매일 같은 맥락 다시 설명하는 부담”으로 표현한 핵심 문제 차단:

  • Hot cache → 다음 세션 즉시 맥락 회복
  • Vault-first research → 이미 알고 있는 내용 재발견 X
  • Obsidian skills → 클로드 자동 작업 품질 ↑
  • /challenge → 자기 이력에서 반박 — 같은 실수 반복 X

관련

  • 🎯 콘텐츠 헌장 (1순위 목적)
  • session-resume · device-home
  • GPT-Image-2-Patterns — 디자이너 협업 패러다임 (다른 도메인의 외부 학습 사례)
  • 외부: D:/ComfyUI_windows_portable/refer/codex_cli_imagegen.md — Codex CLI 작업 트리거
  • 자동 메모리: feedback_codex_brief_format — Codex 의뢰형 brief
  • 첫 적용 사례: vault .claude/skills/ 에 obsidian-skills 5개 설치 (2026-05-13)

그래프 뷰