Claude × Obsidian (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

/wiki — 축적된 지식 쿼리
/save — 채팅을 구조화된 위키 노트로 캡처 (백링크, frontmatter 포함)
/autoresearch — 실제 리서치 수행, 위키 항목 출력
Karpathy LLM Wiki 패턴 — 자기 조직화
순수 마크다운, Obsidian 자체 형식 외 플러그인 종속 없음
무료 (MIT)

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-obsidian-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-obsidian-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-obsidian",
        "~/.claude/skills/claude-obsidian"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-obsidian-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-obsidian",
          "~/.claude/skills/claude-obsidian"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add claude-obsidian-skill -- git clone https://github.com/AgriciDaniel/claude-obsidian ~/.claude/skills/claude-obsidian

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Claude × Obsidian

긴 Claude 대화를 제대로 된 위키 항목으로 캡처하는 방법

👤 Obsidian을 사용하는 지식 노동자 ⏱ ~5 min beginner

언제 쓸까: 나중에 다시 필요할 훌륭한 Claude 대화가 있을 때 — 채팅 히스토리에서 사라지게 두지 마세요.

사전 조건

스킬 설치; vault 경로 설정 — env에서 OBSIDIAN_VAULT 설정; git clone으로 설치

흐름

저장

/save the conversation we just had about React Server Components patterns. Title: 'RSC patterns'.✓ 복사됨

→ frontmatter + 백링크가 있는 /Wiki/RSC-patterns.md에 노트 생성됨
링크 확인

Show me what existing notes the new entry links back to.✓ 복사됨

→ 이유가 있는 링크된 노트

결과: 채팅이 /dev/null로 가는 대신 위키에 구조화된 항목 생성.

함정

/save가 너무 긴 노트를 만듦 — 스킬이 기본적으로 약 600단어로 압축합니다; 필요할 때만 --full을 사용하세요

함께 쓰기: obsidian-mcp-tools

모델에게 묻기 전에 위키에 먼저 묻기

👤 오랜 vault 보유자 ⏱ ~5 min beginner

언제 쓸까: 이것에 대해 작성했다는 것을 알 때; 먼저 vault를 확인하세요.

흐름

위키에 묻기

/wiki What did I conclude about RSC error boundaries last quarter?✓ 복사됨

→ 소스 노트에 대한 인용 + 링크
정제

Now extend that conclusion with anything you can verify online today, and update the note.✓ 복사됨

→ 새 날짜가 있는 섹션으로 노트 업데이트됨

결과: 중복되지 않고 더 밀도 높아지는 vault.

함정

업데이트되지 않은 오래된 정보가 위키에 있음 — 스킬이 최종 수정이 6개월 이상 된 것을 오래된 것으로 표시합니다; 검색 시 검토하세요

주제에 대해 소스가 있는 위키 항목을 추가하기 위해 /autoresearch 실행

👤 연구자 / 학생 ⏱ ~30 min intermediate

언제 쓸까: 주제가 새로울 때; 나중에 확장할 수 있는 노트 스타일 요약을 원할 때.

흐름

자동 리서치

/autoresearch 'Mixture of Experts in 2026 — recent open-source results'.✓ 복사됨

→ 섹션, 인용, vault 링크가 있는 노트 생성됨
정제

Trim to focus on practical training implications.✓ 복사됨

→ 정제된 노트

결과: 향후 심층 작업의 출발점이 되는 vault 항목.

함정

인용이 완전히 검증되지 않을 수 있음 — 근거 있는 소스를 위해 last30days-skill 또는 arxiv-mcp-server와 페어링하세요

함께 쓰기: last30days-skill

조합

다른 MCP와 조합해 10배 효율

claude-obsidian-skill + obsidian-mcp-tools

vault 접근은 MCP를, 워크플로는 스킬을 사용

claude-obsidian-skill + last30days-skill

/autoresearch의 소스를 최신이고 근거 있게 만들기

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
/wiki	query	vault 읽기
/save	title?, scope?	유용한 채팅 후
/autoresearch	topic, depth?	새 소스 항목 추가

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: /wiki는 가벼움; /autoresearch는 더 무거움 (5~20k)
금액: 무료
팁: /autoresearch 전에 /wiki를 사용하세요 — 이전 작업을 다시 하지 않아 tokens를 절약합니다

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read filesystem-write

자격 증명 저장: 없음

데이터 외부 송신: /autoresearch가 소스를 가져올 때를 제외하고는 로컬

Vault에 PII가 포함될 수 있습니다 — /save 범위에 대해 신중하게 생각하세요

문제 해결

자주 발생하는 오류와 해결

/save가 vault 외부에 파일을 생성

OBSIDIAN_VAULT 환경 변수를 설정하거나 --vault를 명시적으로 전달하세요

/wiki가 아무것도 반환하지 않음

vault에 일치하는 노트가 최소 1개 있는지 확인하거나 스킬의 인덱스를 재구축하세요

백링크가 resolve되지 않음

위키가 [[Title]] 형식을 사용합니다; 파일 제목이 정확히 일치하는지 확인하세요

대안

Claude × Obsidian 다른 것과 비교

대안	언제 쓰나	단점/장점
obsidian-mcp-tools (MCP)	워크플로보다 빌딩 블록이 필요할 때	MCP가 더 낮은 수준이고 이 스킬이 의견을 인코딩합니다
AgriciDaniel/wp-mcp-ultimate (다른 도메인)	지식 베이스로 WordPress를 사용할 때	다른 플랫폼; 같은 저자

Claude × Obsidian