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/에 저장 후 알려주기