옵시디언과 클로드 코드(Claude Code) — 챗봇 복붙을 넘어 내 볼트에서 일하는 AI 비서로
챗봇 복붙을 넘어 AI가 내 볼트 안에서 직접 일하게 만드는 법. 클로드 코드 설치와 첫 명령 4단계, CLAUDE.md 규칙, 비용 이야기와 3중 안전 수칙까지 목회자 눈높이로 안내합니다.
조성현 · 사역자 · AI 윤리 · 옵시디언 PKM 강사
강의에서 목사님들을 만나다 보면, 옵시디언에 기록이 어느 정도 쌓인 분들이 공통으로 던지는 질문이 있습니다. "이 자료를 AI한테 어떻게 넘기죠? 매번 복사해서 붙여넣기가 너무 번거로운데요." 저는 그때마다 같은 답을 드립니다. 자료를 AI에게 가져가는 시대는 끝나가고 있고, 이제는 AI를 내 자료 안으로 데려오는 시대라고요. 지금까지 우리는 챗GPT나 클로드에게 "질문하러 가는" 방식으로 AI를 썼습니다. 그런데 진짜 변화는 질문이 아니라, AI가 내 데이터 창고 안에 들어와 내가 시키는 일을 하게 만드는 데서 시작됩니다. 이 글은 그 전환을 실제로 만들어 주는 도구, 클로드 코드(Claude Code)를 옵시디언 볼트에 연결하는 전 과정을 다룹니다. 어드밴스 과정에서 목사님들과 함께 밟는 순서 그대로입니다.
왜 챗봇 복붙이 아니라 에이전트인가
강의에서 자주 드는 비유가 있습니다. claude.ai 웹사이트에서 AI를 쓰는 것은 마트에 직접 가서 자문을 구하고 짐을 들고 오는 것과 같습니다. 필요한 자료를 내가 골라 들고 가고, 결과도 내가 받아 들고 옵니다. 한 단계 나아간 클로드 데스크탑은 비서가 우리 집에 들어와 일하는 것과 비슷합니다. 다만 열쇠는 여전히 내 손에 있고, 나는 옆에서 작업을 지켜봅니다. 그리고 클로드 코드는 비서에게 서재 열쇠를 통째로 맡기는 단계입니다. 비서가 서재에 들어가 지난 설교와 묵상을 직접 찾아 종합하고, 정리하고, 보고합니다.
이 차이가 만드는 실질적인 변화는 이렇습니다. 챗봇에게는 "요셉 이야기로 설교 개요를 잡아 줘"라고밖에 못 묻습니다. 일반 지식으로 답이 돌아옵니다. 그런데 볼트에 연결된 클로드 코드에게는 이렇게 물을 수 있습니다. "내가 요셉 본문으로 설교한 적이 있는지 볼트에서 찾아보고, 그때 어떤 예화를 썼는지, 이번에 겹치지 않으려면 어떤 방향이 좋을지 정리해 줘." AI가 일반 지식이 아니라 내 목회 기록 위에서 일하기 시작하는 것입니다. 설교 준비에 AI를 쓰는 다섯 단계에서 다뤘던 "내 기록 연결"이 자동으로 일어나는 셈입니다.
에이전트라는 말이 어렵게 들리실 수 있지만, 핵심은 하나입니다. 질문에 답만 하는 프로그램이 아니라 내 컴퓨터 안에서 파일을 직접 읽고, 만들고, 옮기는 일꾼이라는 것. 코딩을 몰라도 됩니다. 저 역시 개발자가 아니지만, 출석 체크 시스템도 강의 대시보드도 전부 한국어 명령만으로 만들었습니다. 아이디어와 데이터만 있으면 누구나 구현할 수 있는 시대가 이미 와 있습니다.
큰 그림 — 3단계 워크플로우
연결 방법으로 들어가기 전에, 전체 지도를 먼저 보여 드리는 것이 순서일 것 같습니다. 어드밴스 과정 전체가 이 세 단계 위에 서 있습니다.
1단계, 옵시디언은 기록입니다. 설교·묵상·심방 기록이 마크다운 파일로 분류되어 쌓이는 곳입니다. 목표는 한 문장입니다 — "나도 찾을 수 있는 데이터, AI도 찾을 수 있는 데이터." 이 기본기가 없으면 뒤의 모든 것이 무너집니다. 분류 없는 볼트에 AI를 들이면 쓰레기를 넣고 쓰레기를 받는 자동화가 될 뿐입니다.
2단계, 클로드 코드는 작업입니다. 그 기록 위에서 일하는 손입니다. 수백 편의 한글·PDF 설교를 마크다운으로 일괄 변환하고, 메모를 분류해 제자리에 넣고, 흩어진 기록을 종합해 보고합니다.
3단계, 오픈클로(OpenClaw) 같은 원격 에이전트는 자동 반복입니다. 컴퓨터 앞이 아니어도, 메신저로 명령을 보내면 집에 있는 비서가 알아서 일합니다. 매일 밤 정해진 작업이 자동으로 돌아가게 할 수도 있습니다. 다만 여기는 성격이 다릅니다. 클로드 코드가 관리인이 상주하는 아파트라면, 오픈클로는 모든 수리와 관리를 직접 해야 하는 단독주택입니다. 자유는 크지만 손이 많이 갑니다. 그래서 순서가 중요합니다 — 아파트 생활, 즉 클로드 코드가 손에 익은 다음에 이사를 고민해도 늦지 않습니다.
이 글은 그중 2단계, 클로드 코드까지를 다룹니다.
시작하는 법 — 설치에서 첫 명령까지
설치는 터미널 한 줄입니다. 맥이라면 검색(Cmd+Space)으로 "터미널"을 열고, 공식 설치 명령 한 줄을 붙여넣고 엔터를 치면 끝입니다. 설치가 끝났다는 메시지가 뜨는데도 claude를 쳤을 때 "command not found"가 나오면 당황하지 마세요. 십중팔구 경로(PATH) 연결 문제이고, 안내된 경로 설정 명령을 한 번 더 실행하거나 터미널을 완전히 껐다 켜면 잡힙니다. 윈도우는 PowerShell을 쓰는 별도 절차가 있는데, 원리는 같습니다.
첫 실행에서는 설정 마법사가 뜹니다. 터미널에 claude라고 치면 테마 선택(다크 모드 권장), 계정 연결 순서로 진행됩니다. 계정 연결에서 Subscription(구독)을 선택하면 브라우저가 열리며 클로드 계정으로 로그인되고, 나머지 권장 설정은 엔터로 통과하면 됩니다.
어느 폴더에서 여느냐가 곧 권한 범위입니다. 이것이 클로드 코드의 가장 중요한 원리입니다. 별도의 "옵시디언 연동 설정" 같은 것은 없습니다. 볼트 폴더로 이동해서 열면 볼트 전체가 작업 범위가 되고, 그 안의 작은 폴더에서 열면 그 폴더만 작업 범위가 됩니다. 그래서 처음에는 볼트 전체가 아니라 작은 폴더 하나, 심지어 파일 하나부터 시작하시길 권합니다. 비서에게 처음부터 집 전체 열쇠를 주지 않는 것과 같습니다.
첫 명령은 4박자입니다. 경로 주기 → 분석 → 권한 승인 → 번호별 조치.
내 옵시디언 볼트는 여기에 있어: [폴더 경로 붙여넣기]
이 경로 안에 뭐가 있는지 확인해 줘.
분석 중 권한 요청이 뜨면 엔터로 승인합니다. 분석이 끝나면 클로드가 "조치가 필요한 항목이 1·2·3번 있습니다" 식으로 보고하는데, 그때 이렇게 답합니다.
1번부터 조치해 줘. 끝나면 결과를 보여 주고 멈춰.
한 번에 다 시키지 말고 번호별로 실행해 결과를 즉시 확인하는 습관이 중요합니다. 명령은 전부 한국어로, 컴퓨터를 모르는 친구에게 설명하듯 하면 됩니다. 이 단순해 보이는 "이 폴더 분석해 줘" 한 줄이 사실 모든 자동화의 출발점입니다.
터미널 화면이 부담스러우면 클로디안(Claudian)이 있습니다. 옵시디언 안에 클로드 코드의 채팅 패널을 띄워 주는 플러그인입니다. 노트를 멘션으로 바로 끌어와 명령할 수 있어서, 옵시디언을 떠나지 않고도 같은 일을 시킬 수 있습니다. 묵상 노트 하나와 디자인 파일 하나를 언급하며 "이 둘을 합쳐 묵상 카드를 만들어 줘"라고 하면 그 자리에서 결과물이 생성되는 식입니다. 다만 원리를 이해하려면 터미널에서 한 번은 직접 열어 보시길 권합니다.
CLAUDE.md — 내 볼트의 사용 설명서
클로드 코드는 작업을 시작할 때 CLAUDE.md라는 파일을 항상 먼저 읽습니다. 저는 이것을 헌법이라고 부릅니다. 모든 작업이 이 문서를 전제로 시작되기 때문입니다. 연결 직후, 다른 무엇보다 먼저 이 한 줄로 시작하세요.
CLAUDE.md 파일이 있는지 확인해 줘. 있으면 보여 주고 없으면 만들어 줘.
그리고 첫 규칙으로 "파일 삭제는 절대 내 허락 없이 하지 않는다,
삭제할 때도 영구 삭제가 아니라 휴지통으로 보낸다"를 적어 줘.
두 번째로 적어 둘 것은 볼트의 위치입니다. "내 옵시디언 볼트 경로는 여기다"라고 등록해 두면, 다음부터는 "옵시디언 어디에 넣어 줘"라고만 말해도 알아서 그 폴더를 찾아갑니다.
그리고 여기서부터가 이 파일의 진짜 재미입니다. 클로드가 실수할 때마다 "방금 그건 하지 마. CLAUDE.md에 기록해 둬"라고 명령하면, 그 규칙이 파일에 쌓이고 다음 세션부터 자동으로 적용됩니다. 폴더 구조, 분류 규칙, 하지 말아야 할 것들이 쌓여 갈수록 내 볼트를 점점 더 잘 아는 비서가 됩니다. 헌법이 아니라 사용 설명서라고 불러도 좋겠습니다 — 내 서재를 어떻게 다뤄야 하는지 비서에게 남기는 문서이니까요.
비용 이야기 — 커피머신 비유
돈 이야기를 안 하고 넘어갈 수 없습니다. AI를 쓰는 결제 방식은 크게 둘입니다. 커피에 비유하면, 마실 때마다 카페에 가서 주문하는 것이 웹사이트 방식이라면, API 키는 집에 커피머신을 들이는 것입니다. 통로를 하나 만들어 두고 뽑아 마시는 만큼만 계산합니다. 안 쓰면 돈이 안 나가지만, 많이 쓰면 그만큼 나갑니다.
클로드 코드는 조금 다릅니다. API 방식도 되지만, 옵시디언 자동화처럼 작업량이 많은 초기에는 구독제가 정답입니다. 기본 구독으로도 이 글에서 다룬 수준의 자동화는 충분히 가능하고, 상위 모델을 자유롭게 쓰는 상위 요금제는 자동화를 본격화하는 시기에만 한시적으로 올렸다가 다시 내리는 패턴을 권합니다. 저는 구독료 대비 몇 배 가치의 작업을 매달 뽑아 쓰고 있지만, 이것이 모두에게 정답은 아닙니다. 분명한 것은 AI 구독료가 이제 가계 고정 지출의 한 항목으로 들어오는 시대라는 것, 그래서 가족과 상의가 필요한 결정이라는 것입니다. 부담스러우면 지금은 개념만 익혀 두고, 나중에 시작하셔도 됩니다.
안전 수칙 — 열쇠를 맡기기 전에
권한이 강한 도구일수록 실수 한 번의 파장이 큽니다. 수십 년의 설교와 묵상이 담긴 볼트라면 더욱 그렇습니다. 강의에서 제가 반복해서 당부하는 3중 안전망입니다.
첫째, 본격 작업 전에 반드시 백업하세요. 외장 하드든 클라우드든, 원본과 다른 위치에 사본을 둡니다. 명령을 잘못 내려 파일이 엉키는 사고는 초보 단계에서 가장 흔한 손실이고, CLAUDE.md의 삭제 금지 규칙도 100%를 보장하지는 않습니다. 백업이 진짜 보험입니다. 그리고 역설적으로, 백업이 있어야 마음 놓고 실험할 수 있습니다.
둘째, 작업 단위를 점진적으로 키우세요. 한 개 → 열 개 → 이백 개 순서입니다. 먼저 파일 한 편만 시켜 보고 결과를 확인합니다. 마음에 안 들면 "그렇게 하지 말고 이렇게 해 줘"로 보정합니다. 그 한 편이 표준 틀이 되면 열 개를 시키고, 열 개가 균질하면 그때 전체를 맡깁니다. 한 번에 이백 편을 던지면 AI도 작업 기억이 쌓이면서 뒤로 갈수록 실수가 늘어납니다. 급하게 가면 결국 다시 해야 합니다.
셋째, CLAUDE.md 헌법을 지키세요. 삭제 금지, 휴지통 경유. 앞에서 적은 그 두 줄이 모든 자동화의 전제 조건입니다.
이것이 열어주는 것들
연결 자체는 이렇게 단순합니다. 진짜 이야기는 그 위에서 시작됩니다. 서랍에 잠들어 있던 한글·PDF 설교 수백 편을 마크다운으로 일괄 변환해 볼트에 들이는 것, 설교 한 편에서 한 주 분량의 묵상 자료를 만들어 내는 것, 심방 녹음을 정돈된 심방일지로 자동 정리하는 것까지 — 전부 같은 원리의 응용입니다.
조금 더 나아가면 **스킬(Skill)**이라는 개념을 만나게 됩니다. 자주 하는 작업을 위해 정교하게 깎아 놓은 프롬프트의 패키지인데, 한 번 잘 만들어 두면 슬래시 한 번으로 호출하는 평생 자산이 됩니다. 그 위에 관점과 역할을 입힌 **에이전트(Agent)**를 두면, 같은 자료를 여러 신학적 관점으로 통과시켜 보는 구성도 가능합니다. 이런 것들이 한 번에 되지는 않습니다. 저도 한 명령이 자리 잡기까지 열 번쯤 시행착오를 거치는 일이 흔합니다. 그런데 그 과정 자체가 훈련이고, 그렇게 깎인 도구는 온전히 내 것이 됩니다.
기록 체계부터 AI 에이전트까지의 전체 그림은 목회자를 위한 옵시디언과 AI 에이전트 소개 페이지에 정리해 두었습니다. 옵시디언 기본기부터 클로드 코드, 원격 에이전트까지 단계별로 함께 밟아 가는 과정은 전체 강의에서, 교회·노회 단위로 함께 배우고 싶으시다면 단체 세미나에서 확인하실 수 있습니다. 열쇠를 맡길 준비가 되셨다면, 작은 폴더 하나부터 시작해 보세요.