Claude Code 옵시디언 연동 자동화 — 말 한마디로 노트가 열리다
소개
2026년 3월 24일, 21기 옵시디언 스터디에서 이태극 스터디장님이 발표해 주셨습니다. 주제는 Claude Code와 옵시디언을 연동해 생산성을 높이는 방법이었습니다. "이거 정말 된다고?" 싶었던 내용이 눈앞에서 시연되는 걸 보고 충격을 받았습니다. 저는 청중으로 참석해 강의를 들으며 핵심 내용을 기록했고, 그 자리에서 바로 한 가지를 실행해봤습니다.
진행 방법
강의를 들으며 핵심 내용을 메모한 뒤, Claude Code와 함께 내용을 정리했습니다. 그리고 강의에서 소개된 방법 중 지금 당장 실행할 수 있는 것 하나를 직접 해봤습니다.
Claude Code와 옵시디언을 연결하면 — 말로 노트를 여는 세상
— 워크스페이스 자동화 / 옵시디언 CLI 연동 / System Files 설계 원칙
1. 한 줄 요약
Claude Code에 말 한마디 하면 옵시디언 노트가 자동으로 열린다. 이것이 이태극님이 발견한 것의 핵심이다.
2. 왜 이 강의가 인상적이었나
저는 옵시디언을 쓰면서 늘 이런 불편함이 있었습니다.
"그 파일이 어디 있었더라?"
파일이 어디 저장되어 있는지 기억이 안 나는 게 일상이었습니다. 그래서 Claude Code에게 "꿈기록 파일 어디 있어?", "지난주에 만든 전자책 관련 노트 찾아줘"라고 물어보면, Claude Code가 폴더를 뒤지고, 저는 기다리고, 그렇게 한참이 지나서야 파일을 열 수 있었습니다. 작은 불편이지만 매번 반복되니 시간도 시간이고 흐름이 끊기는 게 더 큰 문제였습니다.
이태극님의 강의는 그 불편함에 대한 완전한 해결책이었습니다.
특히 기억에 남은 점:
"말 한마디로 노트가 열린다" — 클릭도, 경로 입력도 필요 없다
워크스페이스 자동화 — 프로젝트마다 경로를 기억할 필요가 없어진다
memory → rules 승격 — AI가 스스로 배운 것을 제대로 활용하게 만드는 설계
3. 전반부: 워크스페이스와 옵시디언 CLI 자동화
3-1. 워크스페이스로 경로 전환 자동화
기존에는 터미널에서 Claude Code를 실행할 때마다 긴 폴더 경로를 직접 입력해야 했습니다.
cd C:\Users\정윤영\Documents\1 옵시디언\원샷\원샷
이태극님이 발견한 것 'Local REST API 커뮤니티 플러그인'은 6일 전 발표된 아주 따끈따끈한 것임: 워크스페이스를 미리 만들어두면, 탭 하나 클릭으로 그 폴더가 자동으로 열린다.
마치 자주 가는 식당에 내 자리가 미리 세팅되어 있는 것처럼, 프로젝트별로 작업 공간을 미리 만들어두고 전환하는 방식입니다. 볼트가 3개라면 워크스페이스도 3개, 협업 볼트가 있다면 거기에 하나 더. 경로를 기억할 필요가 사라집니다.
3-2. 말로 데일리 노트 열기
이태극님이 시연한 장면이 가장 인상적이었습니다.
"오늘 데일리 노트 열어줘"
이 한마디에 옵시디언이 자동으로 오늘 날짜 노트를 열었습니다. 클릭도, 검색도 없이.
"BBB 노트 만들어줘"
그러자 오른쪽 패널에 BBB 노트가 즉시 생성되고 옵시디언에서 바로 열렸습니다. 이것이 가능한 이유는 사전에 설정 한 rules 덕분에, 노트가 생성되면 자동으로 옵시디언에 표시되도록 트리거가 연결되어 있기 때문입니다.
3-3. "cs" 단축어로 빠른 접근
"cs"라는 단축어 하나로 Claude Code를 실행하고 볼트에 빠르게 접근하는 방법도 소개해 주셨습니다. 작은 차이지만 하루에 수십 번 반복하면 체감이 다릅니다.
4. 후반부: System Files 설계 원칙
4-1. CLAUDE.md / rules / memory 우선순위
이태극님이 설명한 세 파일의 역할을 직원 교육 매뉴얼로 비유하면:
참조 순서: 로컬 CLAUDE.md → 글로벌 CLAUDE.md → rules(Tr1→Tr2→Tr3)
rules 안의 트리거 구조:
Tr1: 항상 참조되는 규칙
Tr2: 특정 조건에서만 발동
Tr3: 수동으로 발동
4-2. memory에서 rules로 승격하는 이유
AI는 대화하면서 자주 나오는 내용을 memory에 자동으로 기록합니다. 그런데 중요하지 않은 것까지 쌓이면 효율이 떨어집니다.
이태극님의 핵심 제안: 자주 쓰는 내용은 rules로 승격시켜라.
그러면 AI가 매번 기억을 더듬는 게 아니라 명확한 규칙에 따라 일관되게 동작하고, 토큰 사용도 최적화됩니다.
4-3. System Files 5개 문서 통합 섹션화
CMDS 시스템의 5개 문서 를 목적별로 섹션화해서 상황에 따라 필요한 컨텍스트만 참조하는 설계도 제안하셨습니다:
유저에 대한 설명
CMDS 철학
CMDS 프로세스 개요
속성 작성 규칙
아키텍처
모든 규칙을 CLAUDE.md 하나에 몰아넣으면 매번 불필요한 내용까지 읽어야 하므로 비효율적입니다. 목적별로 분리해서 필요한 것만 불러오는 설계가 핵심입니다.
5. 핵심 인사이트
5-1. 도구는 연결될 때 진가가 나온다
Claude Code 하나만 써도 충분히 유용하지만, 옵시디언과 연결되면 차원이 달라집니다. 말로 명령하면 노트가 열리고, 생성되고, 정리됩니다. 두 도구가 연결되는 순간 각각의 합보다 훨씬 큰 가치가 생깁니다.
5-2. 기초 없이 얹으면 혼란만 가중된다
강의를 들으며 "당장 해보고 싶다!"는 마음이 들었지만, 솔직히 말씀드리면 저는 CMDS 5개 항목이 아직 제대로 정리되지 않은 상태입니다. 이태극님의 시스템은 CMDS가 잘 구축된 위에서 진가를 발휘하는 구조입니다.
기초 공사도 안 된 집에 인테리어 자동화 시스템을 얹으면, 나중에 기초 공사할 때 다 뜯어야 하는 상황이 됩니다.
그래서 전체 시스템 구현은 CMDS 기초 정리 이후로 미루기로 했습니다.
하지만 딱 한 가지는 지금 바로 실행했습니다.
5-3. 완전히 구현 못 해도, 오늘 쓸 수 있는 것부터
이태극님의 전체 시스템을 당장 따라 할 수는 없지만, 파일 찾기 문제만큼은 오늘 해결할 수 있었습니다.
6. 오늘 직접 해본 것 — Local REST API 플러그인
강의를 듣고 나서 저는 옵시디언에 Local REST API 커뮤니티 플러그인을 설치했습니다.
이 플러그인 하나로, Claude Code에게 말 한마디 하면 옵시디언 노트가 자동으로 열립니다.
설치는 3단계, 1분이면 됩니다:
옵시디언 → 설정 → 커뮤니티 플러그인 →
Local REST API검색 → 설치 → 활성화옵션 클릭 → 포트번호(27124) 확인 → 그대로 닫기
끝
테스트 결과:
저: "꿈기록 노트 열어줘"
Claude Code: (찾고, 연결하고)
옵시디언: 꿈기록.md 자동으로 열림
이걸 보고 진심으로 소리를 질렀습니다. "브라보!"
7. 앞으로의 계획
1) CMDS 5개 항목 먼저 완성하기
이태극님의 전체 시스템을 제대로 쓰려면 CMDS 기초가 먼저입니다. 지금 가장 급한 것은 여기입니다. 집 기초공사 없이 인테리어부터 하면 안 됩니다.
2) CMDS 완성 후 워크스페이스 + CLI 연동 적용
CMDS가 자리 잡히면 이태극님의 워크스페이스 자동화와 옵시디언 CLI 연동을 순서대로 적용해볼 계획입니다. 데일리 노트 열기, 노트 자동 생성까지.
3) memory → rules 승격 실험
지금도 Claude Code의 memory에 자동으로 내용이 쌓이고 있습니다. 이것을 주기적으로 검토해서 자주 쓰는 것은 rules로 승격하는 정리 습관을 들여볼 생각입니다.
8. 마무리
이태극님의 강의를 들으며 "이게 되면 정말 달라지겠다"는 확신이 들었습니다. 동시에 "기초가 없으면 얹어도 소용없다"는 것도 다시 한번 느꼈습니다.
저는 오늘 전체를 다 하지는 못했지만, 딱 한 가지 — 파일 말로 찾기 — 는 해냈습니다. 매번 Claude Code에게 "이 파일 어디 있어?"라고 물어보고 한참을 기다리던 불편함이, 플러그인 하나로 해결됐습니다.
작은 한 걸음이지만, 이태극님이 보여준 방향으로 가고 있다는 느낌입니다.
"도구는 연결될 때 진가가 나온다. 그리고 연결은 기초가 있어야 단단하다."
결과와 배운 점
배운 점과 나만의 꿀팁을 알려주세요.
옵시디언 파일을 찾을 때마다 클로드코드에 물어서 찾는데 시간이 많이 걸렸다. 이제는 말로 열어달라고 하면 즉시 파일을 열어준다.
앞으로의 계획이 있다면 들려주세요.
CMDS를 빨리 구축해서 옵시디언과 클로드코드 연동 자동화를 해야겠다
도움 받은 글 (옵션)
이태극님 강의
