본문으로 건너뛰기

Claude Code를 연결해도 Obsidian 볼트를 가볍게 유지하기 위한 작업

Sunfun

2026.08.01

소개

Claude Code를 Obsidian 볼트에 연결했더니 노트가 아닌 시스템파일이 늘어나기 시작했습니다. 파일을 지우는 데서 끝내지 않고, 볼트·실행환경·임시 작업공간을 분리하고 Windows와 Mac에서 같은 원칙으로 운영하는 구조를 만들고 싶었습니다.

하드드라이브 D에서 주요 프로젝트들을 workspace폴더로 만들고 그 안에, 코칭, 강의, 연구, 개인정보 등등 md파일 뿐 아니라, 워드파일, 엑셀파일, PPT파일 등등을 모두 프로젝트 폴더에 넣고, Visual Code를 연결해서 함께 대화하며 작업하는 일이 많았거든요.

그러다보니 파이썬 호출할때나 스킬이나 프로젝트에 해당하는 지침을 줄 때 각각 시스템파일, 환경파일들이 늘어나면서 용량도 커지고 그래프뷰 시 지저분해지고.. 부작용이 많아짐을 느꼈습니다. 옵시디언 전문가분들은 대부분 하드드라이브와 md파일만 저장하는 저장소를 분리하더라구요.

저는 구분하는게 더 혼란이와서 우선 폴더 하나로 구동시키고 싶었고, 이를 어찌하면 컴팩하게 관리할까 고민해보았습니다.

볼트 안에 제가 직접 만들지 않은 Python 라이브러리, 가상환경, 캐시, 임시 이미지, 실행 스크립트가 생겼습니다. 개발자에게는 익숙한 파일일 수 있지만, 제게는 노트 사이에 갑자기 수천 개의 시스템파일이 나타난 것처럼 보였습니다.

이 파일들은 다음과 같은 부담이 될 수 있었습니다.

  • Obsidian이 노트가 아닌 파일까지 탐색하고 인덱싱함

  • 동기화할 파일 수와 용량이 불필요하게 늘어남

  • 그래프 뷰와 파일 탐색기가 복잡해짐

  • Windows에서 생성된 실행환경이 Mac에는 맞지 않음

  • 어떤 파일이 지식 자산이고 어떤 파일이 임시파일인지 구분하기 어려움

마침 Windows에서 사용하던 볼트를 Mac에서도 이어서 사용하려던 시점이었습니다. 단순히 폴더 몇 개를 삭제하는 것으로는 같은 문제가 반복될 것 같았습니다.

그래서 이번 작업의 목표를 세 가지로 정했습니다.

  1. Claude Code를 사용해도 볼트 안에 시스템파일이 쌓이지 않게 하기

  2. 실제 폴더 구조를 먼저 파악한 뒤 MOC와 type을 최대한 단순하게 정리하기

  3. Windows와 Mac에서 공통 규칙과 장치별 설정을 구분해 적용하기

진행 방법

  1. 삭제하지 않고 현재 상태부터 조사했습니다

삭제하거나 이동하지 말고,
볼트 전체 구조와 실행환경·캐시 흔적을 먼저 조사해줘.
실제 폴더인지 링크인지 구분하고 정리 후보만 알려줘.

이 과정에서 확인한 것은 다음과 같습니다.

  • Python 가상환경과 패키지 폴더가 있었는가?

  • 캐시와 컴파일 파일이 어디에 있었는가?

  • 대량의 미리보기 이미지와 검사 파일이 남아 있었는가?

  • 실제 폴더가 아니라 정션 또는 심볼릭 링크인 항목이 있었는가?

  • 같은 이름과 크기를 가진 중복 후보가 얼마나 있었는가?

이 과정을 거친 뒤 볼트에서 주요 가상환경, 패키지, 캐시 흔적이 발견되지 않는 상태를 확인했습니다.

  1. 볼트와 작업공간을 물리적으로 분리했습니다

문제를 다시 만들지 않으려면 Claude에게 주의를 주는 것만으로는 부족했습니다. 파일이 저장될 장소 자체를 분리했습니다.

[Obsidian 볼트]
노트 · 원본 자료 · 실제 첨부파일 · 최종 결과물

[외부 임시 작업공간]
압축 해제 · 변환 파일 · 미리보기 · 검사 데이터 · 임시 코드

[외부 실행환경]
Python 가상환경 · 설치 패키지 · Node 패키지

Windows와 Mac에는 각각 별도의 임시 작업공간과 실행환경을 만들었습니다. 두 장치는 같은 노트를 동기화하지만 실행환경은 공유하지 않습니다.

이 구성이 중요한 이유는 운영체제마다 실행 파일과 패키지 구조가 다르기 때문입니다. Windows에서 만든 가상환경을 Mac으로 동기화해도 그대로 사용할 수 없고, 오히려 파일 수만 크게 늘어납니다.

패키지가 필요할 때는 현재 폴더에서 단순히 pip install을 실행하지 않고, 볼트 밖에 있는 Python 실행 파일의 전체 경로를 사용하도록 정했습니다.

  1. 생성 결과와 중간산출물을 구분했습니다

AI 문서 작업은 최종 Markdown 한 개를 만들기 위해 여러 임시파일을 생성할 수 있습니다.

예를 들면 다음과 같습니다.

  • PDF 페이지 렌더링 이미지

  • Excel 셀 검사 데이터

  • 미리보기 PNG

  • 압축을 푼 원본 복사본

  • 변환용 스크립트

처음에는 이런 파일이 최종 결과물과 같은 폴더에 남아 있었습니다. 이후에는 작업 중 생성되는 파일은 외부 임시 작업공간에 두고, 사용자가 보존하기로 결정한 최종 결과물만 볼트로 옮기도록 했습니다.

이때도 바로 삭제하지 않고 다음 방식으로 정리했습니다.

최종 결과물과 재사용할 소스 구분
중간산출물을 볼트 밖으로 이동
며칠 동안 문제가 없는지 확인
더 이상 필요하지 않을 때 삭제
  1. 폴더 구조를 먼저 읽고 MOC와 type을 제안받았습니다

볼트의 기술적 문제를 정리한 뒤에는 PKM 구조도 점검했습니다. 처음에는 폴더명, 주제, 출처, 도구, 결과물이 MOC와 type에 섞여 있었습니다. 분류값이 많으면 정교해 보이지만, 새 노트를 만들 때마다 어느 값을 넣어야 할지 고민하게 됐습니다. 그래서 AI에게 바로 분류체계를 만들게 하지 않고, 먼저 현재 폴더 구조와 기존 frontmatter 사용 현황을 읽게 했습니다.

요소

역할

폴더

파일의 실제 보관 위치

type

문서가 수행하는 역할

MOC

주제별 탐색 입구

topics

MOC보다 세부적인 검색어

tags

Obsidian 태그 필터가 필요한 값

이렇게 했더니 옵시디언 프론트메터는 심플해지고, 이를 토대로 비주얼코드에서 어떤 프로젝트를 열어도 불필요한 파일이 제 눈에 안보이니 훨씬 심적 부담이 줄었습니다.

결과와 배운 점

옵시디언 중복파일 삭제는 아직이지만, 이제 노트의 연결을 위한 밑작업을 했다는 생각이 듭니다. 이를 바탕으로 열심히 클로드와 대화나누며 노트를 만들어 나가면 좋겠습니다.

도움 받은 글 (옵션)

지피터스 스터디의 많은 사례글과 스터디에서 나누는 인사이트들을 토대로 개선 중입니다.

5

함께 이야기해요 5

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.08.01
"삭제하지 않고 현재 상태부터 조사했습니다"가 첫 번째 단계라는 게 특히 좋아요. 정리를 결심한 순간 바로 지우는 게 아니라 구조를 먼저 파악한 다음에 움직인 거잖아요. 볼트 / 임시 작업공간 / 실행환경을 물리적으로 분리하고, Windows·Mac 각각 별도 실행환경을 두는 이유를 "운영체제마다 패키지 구조가 달라서 동기화해도 그대로 쓸 수 없다"고 명확히 짚어줘서 비슷한 고민을 가진 분들한테 많이 도움 될 것 같아요. frontmatter를 5요소로 단순화한 것도요. 고롱고롱... 볼트가 가벼워지면 마음도 따라 가벼워지죠 🐾
자연어회계처리 프로필 이미지

옵시디언에서 볼트는 지식과 노트가 담긴 최상의 폴더여야 합니다. 적용하신것처런 지식과 노트를 제외한 쓸대없는걸 빼야하는이유가 볼트 안의 파일은 옵시디언에서 지식과 노트의 저장소로 보기에 다 읽기 때문입니다.

그리고 지금 해논신것에서 볼트안에 index를 하나 만들어졋는지 확인해보시고 업다면 최상위에 index.md를 만들어 옵시디언 관련 명령을 내릴때 index를 읽고 진행하게 하신다면 매우 강력한 지식체계가 될수잇습니다. Index잇으신지 먼저보시고 없다면 만드셔서 연결해보세요!

DECK 프로필 이미지
DECK2026.08.06

볼트 안에 가상환경과 미리보기 파일이 섞이면 정리보다 동기화부터 버거워지기 쉽습니다.

그래서 볼트·임시 작업공간·장치별 실행환경을 나눈 선택이 특히 현실적으로 들렸습니다.

기존 사용 흔적을 읽은 뒤 MOC와 type을 줄인 순서도 ‘새 체계부터 만들기’를 피했고요.

전후 파일 수와 깨진 링크 기록이 남으면 Windows와 Mac을 오갈 때도 점검 기준이 흔들리지 않겠습니다.

꾸
꾸기작2026.08.06

Claude Code를 Obsidian과 연결하면서 볼트를 가볍게 유지하는 방법을 정리한 글이 정말 인상 깊었습니다. "삭제하지 않고 현재 상태부터 조사했다"는 접근이 정말 현실적입니다. 많은 사람들이 문제가 생기면 급하게 폴더를 삭제하려 하는데, 먼저 조사하고 구조를 파악한 후에 해결책을 세운다는 원칙이 정말 좋습니다. Obsidian이 노트가 아닌 파일까지 탐색하고 인덱싱하면서 생기는 부담에 대한 지적도 정말 명확합니다.

볼트와 작업공간을 물리적으로 분리하고, Windows와 Mac에 각각 별도의 임시 작업공간과 실행환경을 만들었다는 부분이 특히 탁월합니다. 운영체제마다 실행 파일과 패키지 구조가 다르다는 점을 고려해 같은 노트는 동기화하되 실행환경은 공유하지 않는다는 설계가 정말 현실적입니다. 패키지가 필요할 때 현재 폴더에서 단순히 pip install을 실행하지 않고 볼트 밖 Python 실행 파일의 전체 경로를 사용하도록 한 부분도 정말 깔끔합니다.

생성 결과와 중간산출물을 구분하는 방식도 정말 좋았습니다. PDF 렌더링 이미지, Excel 검사 데이터, 미리보기 PNG 등 작업 중 생성되는 임시파일은 외부 임시 작업공간에 두고, 최종 결과물만 볼트로 옮기는 원칙이 정말 명확합니다. "며칠 동안 문제가 없는지 확인하고 나서 삭제"한다는 신중함도 정말 실천적입니다.

폴더 구조를 먼저 읽고 MOC와 type을 제안받은 부분도 정말 인상적입니다. 분류값이 많으면 정교해 보이지만 실제로는 새 노트를 만들 때마다 고민하게 된다는 지적이 정말 명확합니다. 폴더는 실제 보관 위치, type은 문서의 역할, MOC는 주제별 탐색 입구로 역할을 명확히 한 부분도 정말 좋습니다. 이 글을 읽으면서 기술적 정리만큼 개념 정리의 중요성을 배웠습니다. 계속 개선해 나가는 모습 응원하겠습니다!

스쿨셰프 프로필 이미지
스쿨셰프2026.08.10

Sunfun 님, Claude Code를 붙인 뒤 볼트에 venv·캐시·미리보기가 섞이던 문제를 “지우기”가 아니라 조사→볼트/임시/실행환경 분리로 푸신 흐름이 또렷했습니다. Windows와 Mac이 노트는 동기화하되 실행환경은 공유하지 않게 한 점, 그리고 중간산출물은 밖으로 두고 최종만 볼트로 옮긴 뒤 며칠 확인 후 삭제하는 여유가 특히 와 닿았습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기