Claude Code + 옵시디언 연동 가이드

Claude Code에서 옵시디언 볼트를 직접 읽고 쓸 수 있게 설정하는 가이드입니다. MCP 서버 설치 없이, 설정 파일 2개만 수정하면 됩니다.

Step 1. settings.json 수정

Claude Code에게 아래 내용을 그대로 복사해서 붙여넣어 주세요:

~/.claude/settings.json에 아래 2가지를 설정해줘:
1. additionalDirectories에 내 옵시디언 볼트 경로 추가 (볼트 경로: ~/Documents/obsidian/)
2. permissions의 allow에 Read, Write, Edit, Glob, Grep 5개 권한 추가

⚠️ 볼트 경로 부분은 본인 경로로 바꿔서 요청해주세요. 볼트 경로 확인법: 옵시디언 → 좌하단 볼트 이름 클릭 → "볼트 폴더 열기"

완성된 settings.json은 아래와 같은 형태입니다. 직접 수정하거나 제대로 설정됐는지 확인할 때 참고해주세요:

{
  "additionalDirectories": [
    "~/Documents/obsidian/"
  ],
  "permissions": {
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep"
    ]
  }
}

이 설정이 하는 일

• additionalDirectories: Claude Code가 현재 프로젝트 외에 추가로 접근할 수 있는 디렉토리를 지정합니다. 여기에 옵시디언 볼트 경로를 넣으면, 어떤 프로젝트에서 Claude Code를 실행하든 옵시디언 볼트에 접근할 수 있게 됩니다.
• permissions: Claude Code가 파일을 다룰 때 사용하는 도구별 권한입니다. 여기에 허용할 도구를 명시하면, 매번 "이 작업을 허용하시겠습니까?" 팝업 없이 바로 실행됩니다.

각 권한이 하는 일

💡 흔한 실수: Read, Write, Edit만 넣고 Glob, Grep을 빠뜨리는 경우가 많습니다. 5개 전부 넣어야 매끄럽게 동작합니다.

✅ 이 단계까지 하면 Claude Code가 옵시디언 볼트를 읽고 쓸 수 있습니다. 아래 Step 2, 3은 더 똑똑하게 쓰기 위한 설정입니다.

Step 2. 폴더 구조 세팅

옵시디언을 제대로 활용하려면 폴더 구조가 먼저 잡혀 있어야 합니다. Claude Code가 노트를 저장할 때 "어디에 넣을지" 판단하는 기준이 되기 때문입니다.

이것도 Claude Code에게 요청하면 됩니다. 대표적인 노트 정리 기법을 알려주고 골라달라고 하면 됩니다:

"내 옵시디언 볼트에 PARA 구조로 폴더 만들어줘"
"Zettelkasten 방식으로 볼트 초기 세팅해줘"
"최소 구조로 inbox, notes, projects 폴더만 만들어줘"

어떤 구조를 골라야 할지 모르겠다면 아래를 참고해주세요:

💡 정하기 어려우면 최소 구조로 시작하고, 나중에 "PARA로 바꿔줘" 하면 마이그레이션도 해줍니다.

Step 3. CLAUDE.md에 저장 규칙 작성

이게 핵심입니다. CLAUDE.md는 Claude Code가 모든 대화에서 따르는 규칙 파일입니다. 여기에 옵시디언 저장 규칙을 적어놓으면, 매번 설명하지 않아도 알아서 지켜줍니다.

이것도 직접 작성할 필요 없이 Claude Code에게 요청하면 됩니다. 아래 내용을 그대로 복사해서 Claude Code에 붙여넣어 주세요:

내 옵시디언 볼트 구조를 확인해서 ~/.claude/CLAUDE.md에 옵시디언 저장 규칙을 작성해줘.

아래 규칙을 포함해줘:
1. 옵시디언 볼트 경로 명시
2. "정리해줘", "저장해줘", "메모해줘" 등 요청하면 해당 볼트에 저장
3. 각 폴더별 용도와 어떤 내용이 어디에 들어가는지 라우팅 규칙
4. 기존 폴더 안에서 필요하면 하위 폴더를 새로 만들어서 분류
5. 프론트매터에 title, created, tags 필수 포함
6. 판단이 어려운 건 inbox/에 저장 후 알려주기

이 한 번의 요청으로 Claude Code가 볼트 구조를 분석해서 CLAUDE.md를 자동으로 작성해줍니다. 이후 "정리해줘"라고만 해도 내용을 분석해서 알맞은 폴더에 저장하고, 필요하면 하위 폴더도 만들어서 정리해줍니다.

💡 CLAUDE.md는 ~/.claude/CLAUDE.md (글로벌)에 넣어야 어떤 프로젝트에서든 적용됩니다. 프로젝트 폴더 안의 CLAUDE.md에 넣으면 그 프로젝트에서만 동작합니다.

✅ 여기까지 하면 완료입니다. 이제 어떤 프로젝트에서든 "옵시디언에 정리해줘" 하면 알아서 저장됩니다.

바로 해볼 수 있는 것들

설정이 끝나면 바로 테스트해보세요:

"이 내용 정리해서 옵시디언에 저장해줘"
→ 내용 분석 → 맞는 폴더에 .md 생성 → 태그 자동 부여

"옵시디언에서 Docker 관련 노트 찾아줘"
→ 볼트 전체 검색 → 관련 파일 목록 제공

"대화 내용 정리해서 메모해줘"
→ 현재 대화에서 핵심만 추출 → 옵시디언에 저장

"이 내용 canvas로 시각화해줘"
→ 노드+화살표 구조도가 .canvas 파일로 자동 생성
→ 옵시디언에서 열면 시각적 관계 지도 완성

Canvas 활용 (보너스)

옵시디언의 canvas 기능을 Claude Code가 자동으로 생성할 수 있습니다. 텍스트 노트를 시각적 구조도로 바꿔주는 기능입니다.

활용 예시:

• 독서 노트 → 핵심 개념 관계도
• 학습 로드맵 시각화
• 프로젝트 아키텍처 다이어그램
• 콘텐츠 기획 설계판

사용법:

"이 노트 canvas로 시각화해줘"
"클로드 코드 기능을 canvas로 정리해줘"
"프론트엔드 학습 로드맵 canvas로 만들어줘"

Claude Code가 .canvas 파일을 직접 생성하고, 옵시디언에서 열면 바로 시각적 구조도로 볼 수 있습니다.

팁

• 글로벌 CLAUDE.md: ~/.claude/CLAUDE.md에 넣어야 어떤 프로젝트에서든 동작합니다. 프로젝트별 CLAUDE.md에 넣으면 그 프로젝트에서만 적용됩니다.
• 프론트매터 일관성: created, tags를 항상 넣으면 Dataview 플러그인으로 노트를 테이블/리스트로 조회할 수 있습니다.
• inbox 패턴: 분류가 애매한 건 일단 inbox/에 넣고 나중에 정리하면 됩니다. CLAUDE.md에도 "모르겠으면 inbox/"라고 적어놓으면 됩니다.
• 구조 변경: 나중에 폴더 구조를 바꾸고 싶으면 "PARA에서 Zettelkasten으로 바꿔줘" 하면 마이그레이션도 해줍니다.
• 볼트 여러 개: additionalDirectories에 경로를 여러 개 넣을 수 있습니다.

요약

총 3분이면 끝납니다. 3단계 모두 Claude Code에게 요청하면 됩니다.