나는 Claude Code를 Obsidian CLI와 연결했고 마침내 5년간의 노트를 정리했다
수년간의 좋은 의도와 혼돈으로 가득한 금고 후, 어느 오후 클로드 코드와 함께 한 시간은 어떤 플러그인도 할 수 없었던 일을 해냈다.
만약 당신이 1년 이상 Obsidian을 노트 작성에 사용해왔다면, 아마 비밀이 있을 것입니다. 당신의 금고는 엉망일 가능성이 높습니다. 제 금고는 단순히 엉망인 수준이 아니라, '제목 없음' 노트와 고아 태그가 무덤처럼 가득 차 있어서 두 번째 두뇌라기보다는 인지적 부담처럼 느껴졌습니다.
사랑스럽고 엉뚱한 재난이 아니다. 진짜 재난이다. 5년 동안의 노트가 800개가 넘는 파일에 흩어져 있었고, 고아가 된 첨부 파일, 일관되지 않은 이름, 나중에 보니 아무 의미도 없었던 태그, 서로 모순된 폴더들이 있었다. 그리고 내 그래프는 지식의 네트워크라기보다는 점과 선으로 표현된 공황 발작처럼 보였다.
나는 모든 접근 방식을 시도해봤다. 템플릿들. 심지어 몇몇 최고의 플러그인들도. 내가 2년 전에 시작했지만 몇 시간 만에 포기한 완전한 재구성. 거의 이해하지 못한 Dataview 설정. 어느 것도 효과가 없었다, 문제는 구조가 아니라, 거기에 도달하기 위해 필요한 방대한 수정량 때문이었다.
그런 다음 올해 초, 나는 뭔가 다른 것을 시도했습니다: 다른 사람들이 했던 것처럼 문제를 Claude Code에 넘기고, 몇 가지 Obsidian CLI 명령과 결합하여, 내가 5년 동안 해내지 못했던 것을 약 90분 만에 하는 것을 지켜보았습니다.
클로드 코드(Claude Code)란 무엇이며, 메모 작성에 왜 중요한가요?
채팅창이 아닌 터미널에서 작동하는 AI
아직 접해보지 않았다면, Claude Code는 Anthropic의 커맨드 라인 AI 도구입니다. Claude의 더 전통적인 인터페이스와 달리, Claude Code는 터미널에서 직접 작동하며, 로컬 시스템에서 파일을 읽고, 코드를 작성 및 편집하며, 사용자가 모든 프롬프트를 관리하지 않아도 다단계 작업을 자율적으로 실행합니다.
마지막 부분이 Claude Code를 다르게 만드는 점입니다. 대부분의 AI 도구들은 사용자가 계속 관여하며 정보를 주고받아야 합니다. Claude Code는 목표를 설정하고 디렉토리에 접근할 수 있게 하며, 체계적으로 문제를 해결하도록 신뢰할 수 있습니다. 그것은 챗봇이 보는 방식이 아니라 개발자가 보는 방식으로 파일 시스템을 봅니다.
노트 보관소를 재정리하는 것과 같은 작업에서는, 그 구분이 매우 중요합니다.
Claude Code를 당신의 Obsidian 금고에 연결하는 방법
왜 notesmd-cli가 이 작업에 적합한 도구인지
이를 위해 저는 notesmd-cli를 사용했습니다. Obsidian이 2026년 초에 공식 CLI를 출시했지만, 현재로서는 저에게는 사용할 수 없습니다. notesmd-cli는 사실상의 커뮤니티 표준이며, 무료이고 단일 Homebrew 명령으로 설치할 수 있으며, 많은 작업을 처리합니다: 63개의 '제목 없음' 노트 일괄 이름 변경, 지저분한 태그를 표준화하기 위한 frontmatter 편집, Obsidian 앱을 열어 둘 필요 없이 파일 이동까지 가능합니다.
두 도구의 결합은 진정으로 유용한 것을 만들어냅니다: 당신의 금고에 있는 모든 노트를 읽고 내용을 이해한 후, 각 결정을 지켜볼 필요 없이 이름을 바꾸고, 태그를 달고, 이동하고, 링크를 연결하는 AI입니다.
볼트 정리를 위한 Claude 코드 프롬프트를 구조화하는 방법
당신이 통제할 수 있도록 해주는 3단계 접근법
저는 Claude Code에게 꽤 구체적인 요약을 주었고, 그것을 단계별로 나누었습니다:
- 1단계: 금고를 감사합니다. 그 안에 무엇이 있었는지, 파일 이름, 기존 태그, 폴더 위치, 대략적인 내용 범주 등을 목록화한 다음, 아무 것도 건드리기 전에 요약 보고를 합니다.
- 2단계: 실제로 발견된 내용을 기반으로 폴더 구조와 태그 분류 체계를 제안하세요, 내가 생각했던 것이 아니라.
- 3단계: 재조직화를 파일별로 실행하고, 내가 나중에 검토(필요 시 되돌릴 수 있도록)할 수 있도록 모든 변경 사항을 기록했습니다. 나는 작가지 도박사는 아닙니다. 다섯 년간의 연구를 LLM에게 마음대로 삭제하게 두지 않으려 했습니다. 나는 Claude에게 먼저 엄격한 '보기만 하고 건드리지 말라' 프로토콜을 따르게 했습니다.
클로드 코드가 847개의 노트를 분석했을 때 발견한 것
내 금고를 보는 방식을 바꾼 카테고리 분류
첫 번째 단계가 끝난 후 Claude Code가 반환한 요약은 정말 겸허하게 만드는 것이었습니다. 제가 만든 847개의 노트 중 약 340개에는 태그가 없었고, 다른 200개는 제가 일관되지 않게 적용한 태그를 사용했습니다. 또 14개의 서로 겹치는 용도의 폴더가 있었고, 63개의 파일은 'Untitled Note'의 변형 이름으로 되어 있었습니다. 마지막으로 11개는 비어 있었습니다.
나도 나쁘다는 건 알았지만, 그렇게 심한 줄은 몰랐어.
제가 가장 유용하다고 느낀 것은 감사 보고서가 제공한 범주 세분화였습니다. 이 보고서는 제 노트의 실제 텍스트를 기반으로 금고 안에 있는 일곱 개의 명확한 콘텐츠 클러스터를 식별했습니다: 전문 글쓰기, 개인 일기, 여행 조사, 기술 참조, 책 및 미디어 노트, 건강 추적, 그리고 기타 잡다한 항목. 저는 이러한 항목들이 대략적으로 동등한 것으로 제 금고를 정신적으로 정리했습니다. 그러나 그렇지 않았습니다. 전문 글쓰기와 기술 참조가 전체의 약 60%를 차지했습니다.
클로드 코드가 폴더 구조를 처음부터 구축한 방법
근거 기반 조직이 의도 기반 조직보다 우수한 이유
클로드 코드가 제안한 분류 체계는 내가 직접 설계한 어떤 것보다도 더 깔끔했는데, 바로 그것이 의도보다는 증거에 기반했기 때문이었다.
일곱 개의 상위 폴더가 콘텐츠 클러스터와 일치하는 평평한 폴더 구조를 제안하면서 소문자와 하이픈이 포함된 일관된 태그 체계를 사용했습니다. 11개의 비어 있는 파일은 내 확인을 받아 삭제 대상으로 표시했습니다. 또한 63개의 제목 없는 노트를 그 카테고리를 추측하기보다는 단일 검토 폴더로 옮길 것을 제안했는데, 이는 올바른 판단이었습니다.
나는 제안서에 두 가지 수정을 했습니다: 여행 폴더를 '여행 계획'과 '여행 추억'으로 나누었습니다. 2022년 항공편 확인 번호 목록은 잡동사니이지만, 카리브해 어딘가의 일몰에 대한 감각적 묘사는 자원이 되기 때문입니다.
그럼 나는 그것에 승인 신호를 줬다.
클로드 코드가 당신의 금고를 재구성할 때 실제로 일어나는 일
나에게 실행할 자신감을 준 변경 로그
나는 내내 그것이 작동하는 것을 본 척하지는 않을 것이다. 나는 커피를 만들고, 몇 개의 이메일에 답장하고, 소셜 네트워킹을 좀 하다가 다시 돌아왔다. 내가 돌아왔을 때 발견한 것은 변경 로그였는데, 클로드 코드가 내 금고 루트에 생성한 일반 텍스트 파일로, 수행된 모든 작업을 기록하고 있었다.
그 후 처음으로 Obsidian에서 열어본 금고는 즉시 달라 보였다. 쓸모없다고 포기했던 그래프 뷰는 이제 클러스터를 보여주었다; 실제로 읽을 수 있는 클러스터였다. 내가 승인했던 일곱 개의 콘텐츠 카테고리는 시각화에서 느슨한 이웃처럼 보였다.
저는 변경 로그를 검토하고, 이동 사항을 샘플 확인하며, 11개의 빈 파일 삭제를 확인하는 데 약 30분을 보냈습니다. 다르게 옮기고 싶은 파일 세 개를 찾았고, 그것이 전부였습니다.
Obsidian 조직을 위해 Claude Code를 사용하는 실제 한계
당신이 여전히 스스로 해야 할 세 가지 일
내가 경험한 한계에 대해 솔직해지는 것이 가치가 있다.
예를 들어, Claude Code는 진정으로 모호한 노트를 해결하지 못했습니다. 내용이 없는 짧은 기사 조각, 설명이 없는 이름 목록. 이러한 것들은 기본적으로 잡동사니 폴더에 들어갔는데, 이는 올바른 동작이었습니다. 또한, 저는 여전히 실제로 불분명한 40개의 노트를 처리해야 합니다.
내가 쓴 것의 질을 향상시키지도 못했다. 잘 배치된 파일에 표현된 무질서한 사고는 여전히 무질서한 사고다. 조직화는 유용한 저장소의 전제 조건이지 더 나은 노트의 대체물이 아니다.
Obsidian CLI 설정은 터미널 사용에 어느 정도 익숙함이 필요합니다. 이것은 플러그 앤 플레이 과정이 아니며, 커맨드 라인에서 작업하는 데 익숙하지 않다면 설정 과정에서 마찰이 실제로 있습니다. 이것은 아직 주류 소비자 워크플로우는 아니지만, 저는 단 몇 달 안에 가능할 것이라고 확신합니다.
클로드 코드가 옵시디언 플러그인이 실패하는 곳에서 성공하는 이유
제가 이전에 시도했던 모든 플러그인 기반 솔루션은 조직적인 부담을 다시 제게 떠넘겼습니다. 저는 여전히 수백 가지의 세부 결정을 내려야 했고, 그때마다 필요한 노력은 제 인내심을 초과했습니다.
클로드 코드는 단지 스스로 할 수 있는 도구를 제공하는 것이 아니라, 대규모로 의사결정을 수행하기 때문에 판도를 바꿉니다. 감사-제안-실행 구조는 모든 개별 선택의 세부 사항에 관여하지 않고도 감독을 제공해 줍니다.
또한 그것이 당신의 노트를 텍스트로 읽는다는 사실에도 의미가 있습니다: 메타데이터도, 파일 이름도 아니라 실제 내용입니다. 이것이 사려 깊은 인간 비서가 작업에 접근하는 방식이며, 세 년 전 밤늦게 당신이 이름을 붙인 것이 아니라 노트의 실제 내용이 무엇인지를 반영한 결과를 만들어냅니다.
클로드 코드가 당신의 옵시디언 금고에 적합한가요?
만약 당신이 장기적으로 오브시디안을 사용해 왔고, 수동으로 관리하기에는 너무 커진 금고를 가지고 있다면, 예 — 단, 몇 가지 조건이 있습니다.
당신은 터미널에서 편안하게 작업할 수 있어야 하며, 그렇지 않다면 거기까지 갈 수 있을 정도로 배우겠다는 의지가 있어야 합니다. 단계적인 접근 방식을 취하고 실행 전에 감사 검토 단계를 건너뛰지 말아야 합니다. 그리고 시작하기 전에 금고를 백업해야 하는데, 이는 말할 필요도 없지만 반드시 언급할 필요가 있습니다.
저에게는 재조직화 프로젝트가 실제로 완료된 것이 처음이었습니다. 수년 만에 처음으로, 나는 한 챕터를 위한 연구 자료를 '공황 발작' 그래프 뷰가 나를 조롱하지 않고 실제로 찾을 수 있습니다. 나는 단순히 폴더를 정리한 것이 아니라, 내 정신 공간을 되찾은 것입니다.