🍊 기초(LV12)#옵시디언#Obsidian#Claude Code#클로드코드#MCP#AI연결#세컨드브레인
7분·2026. 4. 11.·조회 25
오늘도 AI 한입 하세요 🍊
새 아티클이 발행되면 이메일로 알려드릴게요.
댓글을 남기려면 로그인이 필요합니다.
아직 댓글이 없습니다. 첫 댓글을 남겨보세요!
옵시디언(Obsidian)은 AI가 직접 읽고 쓸 수 있는 로컬 메모앱입니다. 노션과 비교하며, 옵시디언이 AI 시대 세컨드브레인으로 최적인 이유를 정리했습니다.
MCP(Model Context Protocol)란 AI에게 도구 사용 권한을 주는 표준입니다. API와의 차이, Claude·ChatGPT에서 MCP를 쓰는 법까지 비개발자 눈높이로 설명합니다.
터미널 뜻, CLI란 무엇인지부터 맥 터미널 여는 법, 첫 명령어 실습까지. Claude Code, Codex 같은 AI 도구를 쓰려면 터미널을 알아야 합니다.
클로드 코드 사용량을 /context와 /usage 명령어로 진단하고, 토큰이 빨리 소진되는 원인을 분석해 비용을 아끼는 실전 팁까지 정리합니다. 서브에이전트 남용·긴 세션 등 리밋이 걸리는 패턴별 대응법과 요금제 비교 포함.
클로드 코드(Claude Code)에게 매번 '이 프로젝트는 이렇고, 답변은 이렇게...' 반복 설명하고 계신가요? CLAUDE.md 파일 하나면 한 번만 세팅하고 끝입니다. 비개발자도 5분이면 따라할 수 있는 CLAUDE.md 설정법과 실전 템플릿, 웹에서 쓰는 Claude Projects까지 한 번에 정리했습니다.
엑셀 함수도, 매크로도, 파이썬도 배울 필요가 없습니다. 터미널에서 Claude Code를 열고 엑셀 파일을 넘긴 다음 하고 싶은 일을 말로 설명하면, 파일을 직접 읽고 수정하고 저장까지 해줍니다. 실전 예제 3가지로 보여드립니다.
클로드 코드(Claude Code)에게 매번 같은 커밋·PR·배포 지시를 반복하고 계신가요? 클로드 코드 스킬(Claude Code Skill)을 직접 만들면 /commit, /pr, /deploy 같은 한 단어 명령으로 반복 업무를 끝낼 수 있습니다. 슬래시 커맨드와의 통합, 5분 핸즈온, 자동 호출 트리거, 인자 처리, 실시간 컨텍스트 주입까지 한 번에 정리합니다.
클로드 코드에서 매번 같은 프롬프트를 복붙하고 계신가요? 슬래시 커맨드로 단축키처럼 줄이고, 복잡한 작업은 스킬로 묶어 AI가 알아서 호출하게 만드는 법을 한 번에 정리했습니다.
둘 다 AI인데 어떻게 다를까요? 코딩, 글쓰기, 분석 등 상황별로 어떤 AI를 선택해야 하는지 실전 비교로 정리했습니다.
설치 끝내고 막막해진 순간
설치는 10분이면 끝났습니다. 노트 몇 개도 써봤습니다. 그런데 막상 "AI가 내 노트를 직접 읽는다"는 부분이 어떻게 작동하는 건지, 구체적으로는 감이 안 옵니다.
ChatGPT에 복사-붙여넣기를 하라는 건가요? 그럴 거면 굳이 옵시디언을 쓸 필요도 없을 텐데요.
이 글은 그 연결 부분을 채웁니다. 결론부터 말씀드리면, 옵시디언 볼트에서 클로드 코드를 실행하면 됩니다.
볼트(Vault)가 뭐냐고요. 옵시디언에서 노트들이 저장되는 폴더를 부르는 이름입니다. 옵시디언을 처음 실행했을 때 "어디에 저장할까요?"라고 물어본 그 위치가 볼트입니다. 예를 들어 문서/내 노트/ 같은 폴더죠. 일반 폴더와 다른 점은 딱 하나, 옵시디언이 그 안의 .md 파일들을 노트로 인식한다는 것뿐입니다.
이 볼트 폴더에서 클로드 코드를 실행하기만 하면, 별도의 MCP 서버 설치도, API 키도, 복잡한 설정도 필요 없이 AI가 내 노트를 읽습니다.
클로드 코드와 클로드 데스크탑이 다릅니다
많은 분들이 이 부분을 헷갈려 하십니다. 같은 클로드인데, 어떤 건 MCP가 필요하고 어떤 건 안 필요한가?
핵심부터 정리하면 이렇습니다. 클로드에는 두 가지 버전이 있고, 옵시디언 연결 방식이 완전히 다릅니다.
클로드 데스크탑은 채팅 앱입니다. 맥이나 윈도우에 설치하면 ChatGPT처럼 대화창이 뜨는 그 앱이요. 이 앱은 기본적으로 내 컴퓨터의 파일에 접근할 수 없습니다. 채팅창만 있고, 파일 시스템과는 분리되어 있습니다. 그래서 옵시디언 노트를 읽게 하려면 별도로 옵시디언 MCP 서버를 설치하고, claude_desktop_config.json이라는 설정 파일을 수정해서 "이 서버를 통해 옵시디언 볼트에 접근하라"고 알려줘야 합니다. 여기서 MCP(AI가 외부 도구와 연결될 때 쓰는 표준 규칙)가 필요한 겁니다.
클로드 코드는 다릅니다. 터미널에서 실행되는 AI 도구인데, 원래부터 "내가 실행된 폴더 안의 파일들을 자유롭게 읽고 쓸 수 있도록" 설계되었습니다. 파일 읽기·쓰기·검색 도구가 내장되어 있어서, 별도의 MCP 서버 없이도 폴더 안의 모든 파일에 접근합니다. 옵시디언 볼트 폴더에서 claude만 치면 끝나는 이유입니다.
그림으로 보면 차이가 명확합니다. 위쪽은 클로드 데스크탑의 경로입니다. 채팅 앱에서 옵시디언 볼트까지 가려면 중간에 설정 파일 수정과 MCP 서버라는 거쳐야 할 단계가 있습니다. 아래쪽 클로드 코드는 이 중간 과정이 전부 생략됩니다. 파일 도구가 이미 내장되어 있으니 볼트 폴더에서 실행만 하면 됩니다.
이 부분이 헷갈리는 진짜 이유 구글에서 "옵시디언 MCP 설정"으로 검색하면 대부분 클로드 데스크탑 기준의 복잡한 JSON 설정 글이 나옵니다. 그래서 "아, MCP는 어려운 거구나" 하고 겁먹게 됩니다. 하지만 클로드 코드를 쓰신다면 그 설정이 전혀 필요 없습니다. 이 글은 클로드 코드 기준입니다.
복잡한 JSON 파일 수정을 각오하고 오신 분이라면, 오히려 좋은 소식입니다. 그 과정이 필요 없습니다.
준비할 게 두 가지입니다.
첫 번째는 옵시디언 볼트입니다. 앞서 설명한 그 폴더입니다. 지금 내 컴퓨터 어디에 있는지 모르시겠으면, 옵시디언을 열고 왼쪽 상단의 볼트 이름을 우클릭하거나, 설정 → "About" 탭에서 경로를 확인할 수 있습니다.
두 번째는 클로드 코드입니다. 아직 안 깔았다면 설치부터 해야 합니다. 설치 방법과 기본 사용법은 앞서 쓴 글을 참고해주세요.
클로드 코드 처음 시작하기이 두 가지가 준비됐다면 이제 연결만 하면 됩니다.
이게 전부입니다
맥에서는 스팟라이트(Cmd+Space)로 "터미널"을 검색해서 엽니다. 윈도우에서는 시작 메뉴에서 "PowerShell"이나 "명령 프롬프트"를 엽니다.
처음 여는 거라면 검은 화면에 깜빡이는 커서가 낯설게 느껴질 수 있습니다. 너무 긴장할 필요 없습니다. 여기서는 딱 두 가지 명령어만 씁니다.
터미널이 처음이라면 터미널이 뭔지, 명령어는 어떻게 동작하는지 더 알고 싶으시면 아래 글을 참고해주세요. 이 글을 읽는 데는 이 섹션의 설명만으로도 충분합니다. 👉 터미널이 뭔가요? — Claude Code 쓰려면 꼭 알아야 합니다
cd 명령어를 씁니다. "change directory", 즉 폴더 이동의 줄임말입니다. 이동할 폴더 경로를 같이 적습니다.
옵시디언 볼트가 문서/내 노트/라는 폴더라면 이렇게 칩니다.
cd ~/Documents/내\ 노트~는 "내 사용자 홈 폴더"를 의미하는 약속된 기호입니다. 폴더 이름에 공백이 있으면 그 앞에 \를 붙여줘야 합니다.
더 쉬운 방법도 있습니다. 파인더(맥) 또는 탐색기(윈도우)에서 옵시디언 볼트 폴더를 찾은 뒤, 터미널에 cd 를 치고 폴더를 터미널 창으로 드래그하면 경로가 자동으로 입력됩니다.
이동이 잘 됐는지 확인하려면 pwd 명령어를 칩니다. "print working directory", 즉 지금 내가 있는 폴더 출력의 줄임말입니다. 경로가 제대로 표시되면 성공입니다.
볼트 폴더로 이동한 상태에서 이렇게 칩니다.
claude끝입니다. 이제 클로드 코드가 실행되고, 현재 폴더(옵시디언 볼트)의 내용을 읽고 쓸 수 있는 상태가 됩니다. 이전까지 터미널에서 치던 명령어와는 성격이 다릅니다. 지금부터 치는 건 컴퓨터가 아니라 클로드(AI)에게 하는 말입니다.
연결이 됐는지 확인하는 법
클로드 코드가 실행되면 대화를 입력할 수 있는 창이 뜹니다. 아래 영상에서 실제로 볼트에 연결하고 노트를 읽는 과정을 볼 수 있습니다.
이렇게 물어보세요.
이 폴더에 있는 .md 파일들을 읽어서 어떤 내용들이 있는지 요약해줘.
몇 초 안에 이런 식으로 답이 옵니다.
현재 볼트에 다음과 같은 노트가 있습니다.
- 01-회의록/주간회의-04-08.md — 지난주 마케팅 예산 논의
- 02-프로젝트/프로젝트-기획서.md — Q2 AI 콘텐츠 플랫폼 기획
- 03-아이디어/블로그주제.md — 블로그 글감 10개
- 할일-목록.md — 이번 주 할 일 체크리스트
여기까지 되면 연결 성공입니다. 지금부터는 AI가 당신의 노트를 직접 읽고 있는 겁니다.
이미지 속 Glob과 Read라는 단어가 보이시죠. 이건 클로드 코드가 파일을 다룰 때 내부적으로 쓰는 도구 이름입니다.
Glob과 Read가 뭔가요
Glob은 파일 이름 패턴으로 파일들을 찾아내는 도구입니다. 예를 들어**/*.md라고 하면 "볼트 안의 모든 마크다운 파일"이라는 뜻입니다.Read는 그렇게 찾은 파일의 내용을 실제로 읽어들이는 도구입니다. 클로드는 질문을 받으면 먼저 Glob으로 관련 파일을 찾고, 그 파일들만 Read로 읽습니다. 볼트 전체를 무작정 로딩하지 않기 때문에 노트가 수천 개여도 빠른 이유입니다.
매번 복사-붙여넣기 하지 않아도 되는 순간들
이 연결이 실제로 어떻게 유용한지, 세 가지 시나리오를 보여드립니다.
01-회의록 폴더에서 지난 2주 동안 작성된 노트를 전부 읽고, 확정된 결정사항만 뽑아서 정리해줘.
클로드가 폴더를 돌면서 각 회의록을 읽고, "결정됨", "확정", "하기로 함" 같은 표현을 찾아서 정리합니다. 수십 개 회의록에서도 몇 초면 끝납니다. 사람이 일일이 열어서 찾을 필요가 없어집니다.
화면에 보이는 Glob(pattern: "01-회의록/*.md")는 "01-회의록 폴더 안의 모든 .md 파일을 찾아라"는 명령입니다. 그 다음 Read가 찾은 파일들을 하나씩 읽어들입니다. 이 두 도구의 조합이 클로드 코드의 기본 작동 방식입니다.
방금 우리가 나눈 미팅 내용을 정리해서 01-회의록 폴더에 새 노트로 저장해줘. 파일명은 주간회의-.md로.
클로드가 Write 도구로 새 파일을 직접 만들고, 대화 내용을 마크다운 형식으로 저장합니다. 제목, 논의 사항, 결정사항, 다음 할 일 섹션까지 알아서 구성합니다. 이 파일은 옵시디언에서 바로 열어볼 수 있습니다. 미팅이 끝나자마자 노트가 쌓이는 흐름이 만들어집니다.
Write가 뭔가요 앞서 설명한 Glob/Read와 짝을 이루는 또 다른 내장 도구입니다.
Glob은 파일 찾기,Read는 파일 내용 읽기,Write는 파일을 새로 만들거나 덮어쓰는 도구입니다. 클로드가 "이 노트를 저장해줘"라고 요청받으면 Write 도구를 써서 실제로.md파일을 생성합니다.
02-프로젝트 폴더에 있는 기획서 중에서 AI 관련된 것들을 먼저 읽고, 그걸 참고해서 새 프로젝트 제안서 초안을 작성해줘.
클로드가 관련 노트를 찾아서 읽은 뒤, 당신의 작성 스타일과 이전 프로젝트 맥락을 반영한 제안서를 만들어줍니다. 이게 바로 쌓을수록 똑똑해진다의 실체입니다. 노트가 쌓여 있을수록, AI가 만들어주는 초안의 품질이 올라갑니다. 새로운 제안서를 쓸 때마다 "지난번에 어떻게 썼더라?"를 찾지 않아도 됩니다. 클로드가 알아서 과거 맥락을 가져옵니다.
Grep이 뭔가요 이미지에서
Grep(pattern: "AI", path: "02-프로젝트/")라는 표현이 보이셨을 겁니다. Grep은 파일 내용 안에서 특정 단어를 검색하는 도구입니다. 여기서는 "02-프로젝트 폴더 안의 파일들 중에서 'AI'라는 단어가 포함된 것들을 찾아라"는 뜻입니다. 앞서 설명한 Glob(파일 이름으로 찾기)이 파일 제목을 훑는 도구라면, Grep은 파일 안쪽 본문을 훑는 도구입니다. 클로드는 이 두 도구를 상황에 따라 골라 씁니다.
몇 가지 조심할 점이 있습니다.
"이 노트를 이렇게 고쳐줘"라고 하면 실제로 파일이 바뀝니다. 다행히 클로드 코드는 파일을 수정하거나 새로 만들기 전에 "이 내용으로 저장할까요?"라고 사용자 승인을 한 번 요청합니다. 그래서 엉뚱한 수정이 자동으로 일어나지는 않습니다. 그래도 중요한 노트라면 옵시디언 볼트를 주기적으로 백업하거나, 아이클라우드(iCloud)/드롭박스(Dropbox)/Git 같은 도구로 버전 관리를 해두시길 권합니다. 실수로 승인해도 복구가 가능해집니다.
볼트에 비밀번호, 개인정보, 계약서 같은 내용이 있다면 클로드가 그걸 읽고 대화 내용에 포함시킬 수 있습니다. 그렇다고 볼트를 여러 개로 나누는 건 권하지 않습니다. 옵시디언에서 볼트를 전환하려면 매번 창을 닫고 다시 열어야 해서, 노트 간 연결이 끊기고 관리가 번거로워집니다. 드롭박스(Dropbox)나 아이클라우드(iCloud)로 동기화하면 기술적으로는 여러 볼트도 가능하지만, 결국 왔다 갔다 하는 번거로움은 같습니다. 대신 같은 볼트 안에서 민감한 파일만 별도 폴더(예: 99-개인/)에 넣어두고, 클로드에게 "99-개인 폴더는 읽지 마"라고 지시하면 됩니다.
앞서 설명한 Glob과 Grep으로 질문과 관련된 파일을 먼저 찾은 뒤, 그 파일들만 실제로 Read로 읽어들입니다. 볼트에 노트가 수천 개 있어도 한꺼번에 로딩하지 않기 때문에 실질적으로 속도가 느려지지 않습니다.
이 섹션은 클로드 데스크탑(채팅 앱) 사용자를 위한 안내입니다. 클로드 코드로 연결한 분은 넘어가셔도 됩니다.
클로드 데스크탑은 파일 접근 기능이 없어서, 별도의 옵시디언 MCP 서버를 설치해야 합니다.
1단계. 클로드 데스크탑 앱에서 설정(⚙) → 개발자 → 구성 편집 버튼을 누르면 설정 파일이 텍스트 편집기로 바로 열립니다. 이 방법이 가장 간단합니다.
만약 이 메뉴가 안 보이면, 파인더에서 직접 찾을 수도 있습니다. 맥에서는 파인더를 열고 Cmd+Shift+G를 누른 뒤 아래 경로를 붙여넣으면 됩니다.
~/Library/Application Support/Claude/
이 폴더 안에 claude_desktop_config.json 파일이 있습니다. 윈도우에서는 %APPDATA%\Claude\ 폴더입니다. 파일을 우클릭 → "다음으로 열기" → 텍스트 편집기(맥) 또는 메모장(윈도우)을 선택합니다. 브라우저나 미리보기로 열면 수정이 안 됩니다.
파인더에서 파일을 찾았다면 우클릭 → 다음으로 열기 → 텍스트 편집기를 선택합니다. 위 스크린샷처럼 보이면 맞습니다.
2단계. 파일을 열면 이미 preferences 같은 내용이 들어 있습니다. 여기에 mcpServers 부분을 추가합니다. "여기에 내 볼트 경로" 부분을 본인의 옵시디언 볼트 경로로 바꿔야 합니다.
내 볼트 경로를 모르겠다면, 이 글 앞부분에서 다룬 클로드 코드에게 물어보는 게 가장 빠릅니다. 터미널에서 claude를 실행한 뒤 이렇게 말하세요.
내 컴퓨터에서 옵시디언 볼트 경로 찾아줘
클로드 코드가 파일 시스템을 검색해서 바로 알려줍니다.
맥의 경우 대부분 /Users/사용자이름/Documents/Obsidian Vault 형태입니다. 나온 경로를 그대로 복사해서 아래 JSON의 해당 자리에 붙여넣으면 됩니다.
{
"preferences": {
"menuBarEnabled": false,
"quickEntryShortcut": "off",
"coworkScheduledTasksEnabled": true,
"sidebarMode": "task",
"coworkWebSearchEnabled": true
},
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "obsidian-mcp", "여기에 내 볼트 경로"]
}
}
}기존 preferences 블록의 닫는 중괄호(}) 뒤에 쉼표(,)를 찍고, 그 아래에 "mcpServers" 블록을 붙여넣는 구조입니다. 기존 내용을 지우면 안 됩니다.
3단계. 저장한 뒤 클로드 데스크탑 앱을 Cmd+Q(맥) 또는 완전히 종료했다가 다시 엽니다. 설정 → 개발자 화면에서 obsidian 서버 옆에 running(초록색)이 보이면 연결 성공입니다. 빨간색 failed가 뜨면 볼트 경로가 잘못되었거나 npx가 설치되지 않은 경우입니다.
연결이 잘 되었는지 확인하려면 대화창에서 이렇게 물어보세요.
obsidian MCP 도구를 사용해서 내 볼트에 어떤 노트들이 있는지 검색해줘
처음 실행하면 아래처럼 "이 작업에 허용" 팝업이 뜹니다. 모든 작업에 허용을 누르면 이후부터는 묻지 않습니다.
노트 목록이 나오면 정상입니다.
볼트 구조뿐 아니라 개별 노트의 내용도 읽을 수 있습니다.
처음에 타임아웃이 나더라도 다시 시도하면 되는 경우가 많습니다. 이제 클로드 데스크탑에서도 옵시디언 노트를 읽고 쓸 수 있습니다.
클로드 코드와 비교하면 확실히 단계가 많습니다. JSON 파일을 직접 수정해야 하고, 경로를 정확히 넣어야 하고, 앱을 재시작해야 합니다. 게다가 MCP 서버가 running으로 표시되더라도 실제 도구 호출에서 타임아웃이 나거나 연결이 끊기는 경우가 있습니다. 옵시디언 MCP 서버는 앤트로픽(Anthropic)이나 옵시디언 공식이 아닌 커뮤니티가 만든 패키지이기 때문에, 버전에 따라 동작이 불안정할 수 있습니다.
클로드 코드에서는 이 과정이 전부 생략됩니다. MCP 서버를 거치지 않고 파일을 직접 읽기 때문에 연결 오류가 발생할 일이 없습니다. 이 글에서 "MCP 설정 필요 없음"이라는 말을 반복한 것도 그 이유입니다.
옵시디언과 클로드 코드의 연결은 별도의 MCP 서버 설치 없이 claude 명령어 하나로 끝납니다. 볼트 폴더로 이동해서 실행하면, 그 순간부터 AI가 내 노트를 읽는 상태가 됩니다.
이전 글에서 말씀드린 것처럼, AI 활용의 핵심은 프롬프트 기법이 아니라 내 맥락을 쌓는 것입니다. 옵시디언에 쌓아둔 노트가 바로 그 맥락이고, 이 연결 방법이 그 맥락을 AI에게 전달하는 회로입니다.
회의록, 기획서, 메모, 아이디어 — 지금까지 쌓아온 모든 기록이 이제 AI의 업무 자료가 됩니다.
다음 글에서는 이 연결을 더 똑똑하게 활용하는 방법을 다루겠습니다. 매일 자동으로 노트를 정리하고, 주간 리포트를 AI가 대신 써주는 워크플로우까지요.