Claude Code로 나만의 옵시디언 볼트 구축과정

21기 옵시디언 스터디에서 CMDS 지식관리 체계를 배우고, 실제로 나에게 맞는 볼트를 처음부터 끝까지 Claude Code와 함께 구축한 사례를 공유합니다.

평소 Claude를 핵심 업무 도구로 활용하고 있고, 옵시디언도 학습과 지식 정리 목적으로 사용해왔습니다. 다만 기존 볼트는 강의 실습용으로 여러 개 흩어져 있어서, 이번 스터디를 계기로 하나의 체계적인 볼트를 새로 만들기로 했습니다.

이번 스터디에서 해야 할 일

스터디에서 진행한 과제는 두 단계로 나뉩니다.

1차: 인터뷰를 통해 나를 소개하기 CMDS 체계 설계의 출발점은 "나는 어떤 사람인가"를 구체적으로 정의하는 것이었습니다. 12개 질문으로 구성된 CMDS_System_Files_Interview.md 파일에 직업, 관심사, 작업 흐름, 도구 환경, 폴더 정리 방식, 기대 목표까지 답변을 채웠습니다.

이 인터뷰 작성 자체도 Claude와 대화하면서 진행했습니다. "내가 어떤 일을 하는지", "어떤 도구를 쓰는지"를 Claude에게 설명하면서 함께 답변을 다듬었고, 이 과정에서 스스로의 작업 패턴을 객관적으로 정리할 수 있었습니다.

2차: 인터뷰 기반으로 CMDS 볼트 구축하기 완성된 인터뷰를 바탕으로 Claude Code에게 볼트 세팅을 맡겼습니다. Phase 1(시스템 파일 생성)과 Phase 2(실제 볼트 구축)로 나뉘어 진행했습니다.

진행 과정 — 6단계 기록

1단계: 인터뷰 작성 (Claude 대화를 통해 답변 채우기)

인터뷰 질문지는 12개 항목으로 구성되어 있습니다.

여기서 핵심은 답변의 구체성이었습니다. "안전 업무를 합니다"가 아니라 "산업안전보건법과 중대재해처벌법 기반의 안전교육 기획, 위험성평가, 전자결재 문서 작성을 합니다"처럼 구체적으로 쓸수록, 이후 Claude Code가 만드는 시스템 파일의 품질이 올라갔습니다.

2단계: Phase 1 — 시스템 파일 5개 생성

Claude Code에게 다음과 같이 요청했습니다:

CMDS System Files_Interview.md의 답변을 읽고,
CMDS System Files_v3/ 폴더의 템플릿을 참고하여
나에게 맞는 CMDS 시스템 파일 5개를 볼트 최상위에 만들어줘.

Claude Code가 인터뷰 전체를 분석하고, 템플릿 5개를 병렬 참조한 뒤, 볼트 최상위에 다음 파일들을 생성했습니다:

이 5개 시스템 파일이 볼트의 설계도 역할을 합니다. 이후 Phase 2에서 이 설계도를 읽고 실제 폴더와 노트를 만들어냅니다.

3단계: Phase 2 — 볼트 전체 구조 세팅

볼트 최상위에 있는 CMDS 시스템 파일 5개를 읽고,
그 내용을 기반으로 볼트를 세팅해줘.
폴더 구조, CMDS 카테고리 노트, 인덱스 노트, 템플릿을 만들어줘.

Claude Code가 4개 에이전트를 병렬로 실행하면서 대량 생성을 수행했습니다:

• Agent 1 — 📖 1st Level CMDS 노트 9개

• Agent 2 — 📚 2nd Level 노트 100~400 시리즈 20개

• Agent 3 — 📚 2nd Level 노트 500~900 시리즈 31개

• Agent 4 — 🏷 인덱스 노트 9개 + 템플릿

최종 생성 결과:

이 과정은 oh-my-claudecode(멀티 에이전트 오케스트레이션 도구)를 활용해서 병렬로 진행해서 실제 대기 시간은 단축됐습니다.

4단계: 플러그인 마이그레이션

새 볼트에 플러그인을 하나씩 설치하는 대신, 기존 볼트에서 통째로 복사하는 방식을 택했습니다.

기존에 설치한 플러그인을 이 볼트로 옮기려면 어떻게 하는 게 좋아?

Claude Code가 같은 상위 폴더에 있는 기존 볼트 4개의 플러그인 현황을 탐색하고, .obsidian/plugins/ 폴더 전체 + community-plugins.json을 복사 실행했습니다.

결과: 44개 플러그인 폴더 일괄 복사 완료

5단계: 설정 오류 수정

플러그인을 통째로 복사하다 보니, 이전 볼트의 경로 설정이 그대로 남아있는 문제가 발생했습니다.

• Periodic Notes의 Daily Note 템플릿 경로가 이전 볼트를 가리키고 있었음

• Claude Code가 periodic-notes 플러그인의 data.json을 직접 읽고 경로를 수정

이런 디테일한 설정 수정까지 AI가 처리해줄 수 있다는 점이 인상적이었습니다.

6단계: 동작 확인

마지막으로 Dataview 플러그인이 정상 동작하는지 확인했습니다. 🏷 인덱스 노트의 Dataview 쿼리가 작동해야 CMDS 체계가 제대로 돌아가기 때문입니다.

Claude Code가 community-plugins.json과 플러그인 폴더 존재 여부를 확인하고, 정상 판정을 내렸습니다.

세션 정보

앞으로 해야 할 일 — 3단계 계획

볼트 뼈대는 완성됐지만, 살을 붙이는 작업이 남아 있습니다.

Phase 3 : 기존 자료 마이그레이션(다음주 할일)

기존에 여러 볼트에 흩어져 있던 옵시디언 자료와, 업무하면서 쌓아온 각종 지식 자료들을 새 볼트로 옮겨야 합니다. 이걸 3단계로 나눠서 접근하려 합니다.

1단계: 중요 파일 → md 변환 핵심 문서(법령 해석, 안전교육 자료, 프로젝트 회고 등)를 마크다운 파일로 변환해서 적절한 CMDS 카테고리에 배치합니다. 이 과정에서 YAML frontmatter와 CMDS 매핑을 하려고 합니다.

2단계: 참고 파일 → 폴더 배치 + 메타데이터 PDF, 이미지, 엑셀 등 변환하기 어려운 파일들은 해당 폴더에 넣어주고, 메타데이터(속성값)를 제공하는 인덱스 노트를 만들어 연결합니다. 파일 자체는 원본 그대로 유지하되, 옵시디언에서 검색/탐색이 가능하도록 하는 것이 목표입니다.

3단계: 나머지 폴더 정리
핵심적인 자료 이외에 참고해야될 자료는 기존 폴더에 집어넣되, 그 폴더의 구조를 정리해서 클로드 코드가 자료들을 로딩할 때 참고할 수 있도록 하게 하려고 합니다.

이 세 단계를 실제 자료를 바탕으로 하나씩 실행해보면서, 궁금한 사항들에 대해서는 스터디 및 ai 에 많이 물어볼 예정입니다.

도움 받은 글/자료

• 21기 CMDS 강의 (구요한 스터디장)

• CMDS System Files v3 템플릿

• Claude Code + oh-my-claudecode