[Claude Code] 옵시디언 볼트 세팅, AI가 내 기존 노트를 읽고 나 대신 설계해줬다.
구요한님과 이태극님의 옵시디언 1주차 템플릿을 활용하여 만들었습니다.
한줄 요약
Claude Code가 기존 두 볼트를 탐색해 나를 파악하고, 인터뷰 → 시스템 파일 → 볼트 세팅까지 한 세션에 84개 파일 + 35개 폴더를 자동 완성했습니다.
이런 분들께 도움돼 요
옵시디언을 쓰고 있는데 폴더 구조가 쓰다 보니 만들어진 거라 체계가 없다고 느끼는 분
PARA, 제텔카스텐, Johnny Decimal 등 여러 방식을 섞다가 결국 엉켜버린 분
AI한테 "내 노트 정리해줘" 요청하고 싶은데 볼트 구조가 없어서 못 쓰고 있는 분
소개: 시도하고자 했던 것과 그 이유
문제 상황 (Before)
저는 옵시디언 볼트를 두 개 운영하고 있었습니다.
pkm볼트 — Johnny Decimal 구조, 비즈니스 프로젝트 중심(2026년 자료)
이림/진여진님이 19기에 제공해주신 PKM템플릿 활용한 옵시디언 볼트컴퓨터 화면에 한국어 스크린샷
Goldentiger볼트 — 씨앗노트 PARA 구조, 지식·학습 중심(2025년 자료)
세자녀 아이들에게 가르치기 위한 씨앗노트로 구성했던 옵시디언 볼트
문제는 두 볼트가 완전히 따로 놀고 있었다는 겁니다. 같은 주제의 노트가 두 곳에 분산되고, Claude Code는 pkm 볼트만 보고 있어서 Goldentiger에 있는 지식을 전혀 못 쓰는 상황이었습니다.
더 근본적인 문제는, 두 볼트 모두 쓰다 보니 만들어진 구조라 처음부터 설계한 게 아니었다는 거예요. "이 노트는 어디에 넣지?" 하는 질문이 매번 발생했고, 그 고민 자체가 노트 쓰기를 방해했습니다.
시작하게 된 계기
지피터스 21기 스터디 볼트를 새로 만들 기회가 생겼습니다. 어차피 새 볼트라면, 이번엔 처음부터 제대로 설계하자고 결심했습니다. CMDS(커맨드스페이스) 프레임워크 기반으로, 나에게 맞는 구조를 정밀하게 만들고 싶었어요.
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
도구: Claude Code (CLI)
모델: Claude Sonnet 4.6
특이사항: 코드를 한 줄도 직접 쓰지 않음. 자연어 지시만 사용
AI와 협업한 과정
1단계 — AI가 내 기존 볼트를 읽고 나를 파악하게 했다
볼트 세팅의 첫 단계는 나에 대한 인터뷰(12개 질문)를 작성하는 것이었습니다. 그런데 직접 쓰려니 막막했어요. 그래서 이렇게 요청했습니다:
"D:\Projects\pkm" 과 "D:\Projects\Goldentiger" 두 개의 옵시디언 볼트 경로를 참고하여 인터뷰 답변을 작성해줘.
Claude Code가 두 볼트를 탐색했습니다. 프로젝트 폴더, 노트 파일, 메모, 구독 현황 등을 읽으면서 내 활동 영역·도구·관심사·워크플로우를 스스로 파악했어요.
결과: 내가 한 건 "맞아", "이건 n8n이야(Make 아님)" 같은 확인·수정 뿐이었습니다. 12개 질문 전부 AI가 채워줬어요.
2단계 — 인터뷰 기반으로 시스템 파일 5개를 커스터마이징했다
CMDS System Files_Interview.md의 답변을 읽고, 템플릿을 참고하여 나에게 맞는 CMDS 시스템 파일 5개를 볼트 최상위에 만들어줘.
생성된 파일:
CMDS.md— 내 프로필·철학·카테고리 설명 (모든 LLM이 읽는 컨텍스트 파일)CLAUDE.md— Claude Code 전용 기술 가이드AGENTS.md— 기타 AI 에이전트용 가이드🏛 CMDS Head Quarter.md— 카테고리 네비게이션 허브🏛 CMDS Guide.md— 노트 규칙·템플릿 표준
여기서 핵심은 템플릿을 그대로 쓴 게 아니라는 것입니다. 나의 6개 Division(사업·교육·콘텐츠·커뮤니티·투자·성장), 실제 도구(n8n→Python 대체 중, Supabase, TalkBridge 등)에 맞게 카테고리가 전부 재구성됐습니다.
3단계 — 시스템 파일 기반으로 볼트 전체를 세팅했다
볼트 최상위에 있는 CMDS 시스템 파일 5개를 읽고, 그 내용을 기반으로 볼트를 세팅해줘. 폴더 구조, CMDS 카테고리 노트, 인덱스 노트, 템플릿을 만들어줘.
결과:
📁 폴더 35개 생성 (00. Inbox ~ 90. Settings)
📖 1st Level 카테고리 노트 9개
📚 2nd Level 서브카테고리 노트 58개
🏷 인덱스 노트 8개 (데일리노트, 회의록, 인물, 프로젝트, AI대화, 프롬프트, 유튜브대본, 아이디어)
📄 템플릿 9개 (씨앗노트, 회의록, 데일리노트, 유튜브 스크립트, AI 대화 노트 등)
인상적이었던 순간
AI가 기존 볼트에서 "자동화 도구는 Make"라고 파악했는데, 제가 "아니, n8n 로컬 호스팅이야"라고 수정하자 — 즉시 시스템 파일 전체에서 Make를 n8n으로 바꾸고, "현재 Python으로 대체 중"이라는 맥락까지 함께 반영했습니다. 단순 치환이 아니라 맥락을 이해하고 수정하는 걸 보면서 "아, 이게 에이전트구나" 싶었어요.
막혔던 순간과 해결
처음에는 Claude Code가 아닌 Antigravity에서 실행해봤습니다.
GPT-OSS 120B 모델을 선택해서 인터뷰 파일 작성 프롬프트를 실행했는데 — 기존 인터뷰 질문 안에 답을 채워 넣는 게 아니라, 파일 전체를 완전히 다른 내용으로 오버라이트해버렸습니다. 인터뷰 원본 파일이 사라진 거죠.
한국어 텍스트가 있는 화면의 스크린샷
급히 원본 파일을 복사해서 복원한 뒤, Claude Code로 전환해 다시 실행했습니다. Claude Code는 기존 구조를 그대로 유지하면서 **답변:** 항목만 정확히 채워줬어요.
배운 것: "파일을 읽고 채워줘"라는 요청에 모델마다 행동이 다릅니다. 구조 보존이 중요한 작업일수록 모델 선택이 결과를 크게 바꿉니다.
결과와 배운 점
Before vs After
항목
Before
After
소요 시간
며칠 (고민만 해도)
한 세션 (~2시간)
생성된 파일
0개
84개 파일 + 35개 폴더
노트 위치 고민
매번 발생
CMDS 카테고리로 명확
AI 활용 준비도
볼트 구조 없음
시스템 파일로 AI 컨텍스트 완비
결과물
볼트 최상위 구조:
📁 00. Inbox / 10. CMDS Process / 20~90. (8개 폴더)
📖 100 Themes ~ 📖 900 Divisions (9개)
📚 101 Interests ~ 📚 906 개인성장 (58개)
🏷 Daily Notes / Meeting Notes / People / Projects ... (8개)
🏛 CMDS Head Quarter / 🏛 CMDS Guide
CMDS.md / CLAUDE.md / AGENTS.md
배운 점과 나만의 꿀팁
효과적이었던 것
"내 기존 볼트를 읽어서 나를 파악해줘" — AI에게 직접 설명하는 것보다 기존 파일을 탐색하게 하는 게 훨씬 정확하고 빠릅니다
Phase 1(시스템 파일) → Phase 2(볼트 세팅) 분리 — 새 대화에서도 Phase 2를 바로 실행할 수 있어서 세션 길이 부담이 없었습니다
수정은 확인·교정만 — AI 초안을 처음부터 만들려 하지 말고, AI가 만든 걸 검토·수정하는 역할만 하면 됩니다
이렇게 하면 안 돼요 (주의사항)
처음부터 완벽한 구조를 만들려 하지 마세요 — 쓰면서 바뀌는 게 정상입니다
AI가 파악한 내용이 틀릴 수 있습니다 — 반드시 확인·교정하세요 (저도 Make→n8n 수정했습니다)
앞으로의 계획
오픈클로나 나노클로를 세팅할 예정입니다.
카톡이나 메신저로 아이디어나 메세지들을 던지면
알아서 자동으로 체계적인 관리 기준에 따라 정리되게 하고 싶습니다.
시스템 파일(CMDS.md, CLAUDE.md)이 갖춰졌으니, 이제 Claude Code에 이런 요청을 던질 수 있습니다:
"이번 달 AI 대화 노트에서 인사이트 정리해줘"
"AX 전략 관련 노트들 연결해줘"
"씨앗노트 아이디어 중 유튜브 소재가 될 것들 찾아줘"
PKM과 AI 에이전트를 실제로 연결하는 환경을 만드는 게 다음 목표입니다. 볼트 구조 자체가 AI의 작업 기반이 되는 셈입니다.
재사용 가능한 프롬프트
프롬프트 1: 기존 볼트 탐색으로 인터뷰 자동 작성
"[내 볼트 경로1]" 과 "[내 볼트 경로2]" 두 개의 옵시디언 볼트 경로를 참고하여
[인터뷰 파일명]의 답변을 작성해줘.
주의: 해당 폴더 아래에 파일을 추가하거나 삭제하면 안 됨
[볼트 경로]와 [인터뷰 파일명]을 본인 상황에 맞게 변경하세요.
프롬프트 2: 인터뷰 기반 시스템 파일 생성
[인터뷰 파일명]의 답변을 읽고,
[템플릿 폴더명]의 템플릿을 참고하여
나에게 맞는 CMDS 시스템 파일 5개를 볼트 최상위에 만들어줘.
프롬프트 3: 시스템 파일 기반 볼트 세팅
볼트 최상위에 있는 CMDS 시스템 파일 5개
(CMDS.md, CLAUDE.md, AGENTS.md, 🏛 CMDS Head Quarter.md, 🏛 CMDS Guide.md)를 읽고,
그 내용을 기반으로 볼트를 세팅해줘.
폴더 구조, CMDS 카테고리 노트, 인덱스 노트, 템플릿을 만들어줘.
작성일: 2026-03-24
작성자: 황금호랑이 (백성욱)