[옵시디언 02] 클로드 코드와 옵시디언 연결하기
AI에게 노트 작업을 맡기려면 먼저 AI가 우리 볼트에 접근할 수 있어야 합니다. 여기서는 클로드 코드라는 AI 에이전트를 사용해 볼트의 노트를 읽고, 수정하고, 정리하는 작업을 맡겨보겠습니다.
클로드 코드가 무엇인가요?
클로드 코드Claude Code는 Anthropic에서 만든 AI 에이전트입니다. 파일을 읽고 쓰고 수정하는 작업을 사람과 대화하듯 자연어로 지시할 수 있습니다. "이 파일의 오타를 수정해줘", "모든 노트에 생성일 속성을 추가해줘"처럼 말하면 클로드 코드가 직접 파일을 수정합니다.
현재 이런 AI 에이전트는 여러 종류가 있습니다. OpenAI의 코덱스Codex, 구글의 제미나이 CLIGemini CLI 등이 대표적입니다. 그중 클로드 코드가 옵시디언과 잘 맞는 이유는 간단합니다. 옵시디언 볼트는 결국 마크다운으로 작성된 글의 모음이고, 클로드는 다른 AI에 비해 글을 읽고 쓰는 작업에서 강점을 보인다는 평가가 많기 때문입니다. 수백 개의 노트에서 특정 패턴을 찾아 수정하거나, 노트 내용을 분석해서 요약하거나, 메타데이터를 일괄 추가하는 작업을 자연어 한 줄로 처리할 수 있습니다.
클로드 코드와 옵시디언 연결하기
먼저 클로드 코드를 설치하고 여러분의 옵시디언 볼트에 접근할 수 있도록 연동해봅시다.
[바로 실습] 윈도우에서 클로드 코드 설치하기
01 클로드 홈페이지에 접속합니다. 기존 계정이 있다면 로그인하고, 없다면 회원 가입을 합니다.
[link] Claude 링크 claude.ai
02 클로드 코드를 사용하려면 클로드 유료 구독이 필요합니다. 로그인 후 좌측 하단에서 아이디를 선택 후 [Upgrade plan]을 선택합니다. 금액 부담을 최소화하기 위해 프로 플랜으로 월간 구독을 하겠습니다. 가격은 대략 월 32,000원 정도입니다. 이후 신용카드 정보를 입력하고 구독을 진행합니다.
03 이번 단계에서는 터미널을 실행하고 클로드 코드를 설치합니다. 운영체제별로 설치 방법이 다르기에 윈도우 사용자와 macOS 사용자를 나눠서 설명하겠습니다.
먼저 윈도우 환경입니다. 클로드 코드는 자체적으로 Bash라는 터미널 도구를 사용합니다. 그런데 윈도우에서는 이 Bash가 기본적으로 설치되어 있지 않기 때문에 우선 이를 설치할 필요가 있습니다. 이를 설치하는 가장 쉬운 방법은 깃Git을 설치하는 겁니다. 따라서 깃 설치 링크로 이동해서 [Click here to download]를 눌러 설치를 진행해주세요.
[link] 클로드 코드 설치 가이드: code.claude.com/docs/ko/setup
[link] 윈도우 깃 설치 : git-scm.com/install/windows
04 설치가 완료되면 파워셸을 볼트 폴더에서 실행합니다. 윈도우 11에서는 볼트 폴더를 탐색기로 열어서 우클릭을 한 후 [터미널에서 열기]를 선택하면 쉽게 열 수 있습니다.
05 실행된 터미널에선 다음과 같이 입력하여 클로드 코드를 설치합니다. 설치가 완료되면 터미널을 종료합니다.
```terminal
irm https://claude.ai/install.ps1 | iex
```
06 설치가 완료되었다면 클로드 코드를 실행하기 위해 환경 변수를 등록해야 합니다. 윈도우 시작 메뉴에서 ‘환경 변수’라고 검색한 후 [계정의 환경 변수 편집]을 선택합니다.
이후 ➊ [Path]를 선택해 ➋ [편집] 버튼을 누른 후 ➌ [새로 만들기]를 선택하고 ➍ %USERPROFILE%\.local\bin을 입력하여 확인 버튼을 눌러서 저장합니다. 오탈자, 띄어쓰기를 잘 확인해주세요.
이후 볼트 폴더에서 터미널을 다시 실행 후 ‘claude’라 입력했을 때 클로드 코드가 실행되면 정상적으로 클로드 코드 설치가 완료된 겁니다.
[바로 실습] macOS에서 클로드 코드 설치하기
윈도우에서 설치할 때처럼 구독이 필요합니다. 클로드 홈페이지에서 구독을 완료한 후 이 곳을 확인해주세요.
01 볼트 폴더에서 터미널을 실행합니다. Finder에서 볼트 폴더를 우클릭한 후 [서비스 ➝ 폴더에서 새로운 터미널 열기]를 선택하면 볼트 폴더에서 터미널이 실행됩니다.
02 실행된 터미널에선 다음과 같이 입력해 클로드 코드를 설치합니다.
```terminal
curl -fsSL https://claude.ai/install.sh | bash
```
03 설치가 완료되면 환경 변수 등록을 위한 명령을 입력하라는 메시지가 표시됩니다. 해당 명령을 복사하여 터미널에 붙여넣습니다.
[바로 실습] 클로드 코드와 옵시디언 연결하기
01 이 단계부터는 윈도우와 MacOS 모두 동일하게 진행하면 됩니다. 설치가 완료되었다면 다음과 같이 터미널에서 claude라고 입력합니다. 최초 실행 시 테마를 선택하는데 원하는 것을 선택합니다. 선택 후 다음과 같은 로그인 방식을 선택하는 창이 뜹니다. 첫 번째인 [Claude account with subscription]을 선택 후에 열린 웹브라우저에서 승인을 하여 로그인합니다.
02이후 현재 볼트 폴더를 신뢰한다고 선택합니다. 그 후 클로드 코드에서 명령을 입력할 수 있는 상태가 되면 /model을 입력합니다. AI 에이전트의 모델을 설정하는 부분으로 성능에 가장 중요한 역할을 합니다. 현재 클로드는 Opus, Sonnet, Haiku 모델을 지원하고 이 중 Opus가 가장 성능이 좋은 모델입니다. 성능이 좋은 만큼 사용량도 금방 차기에 많이 쓸 수는 없습니다. 프로 플랜을 구독했다면 기본적으로 Sonnet이 선택되었을 텐데 이 책의 실습에서는 Opus를 선택하고 진행하겠습니다.
03 /init을 입력합니다. 이 명령어는 현재 폴더와 파일들을 분석하여 클로드 코드가 우리의 볼트의 구조를 알게 합니다. 중간마다 오른쪽과 같이 권한을 물을 텐데 그때마다 Yes를 선택합니다. 볼트 구조를 파악하느라 시간이 오래 걸릴 수 있습니다.
04 완료되면 볼트 폴더에 CLAUDE.md 파일이 만들어집니다. 이 파일을 지침instructions이라고 합니다. 지침은 클로드 코드와 같은 AI 에이전트가 실행될 때 자동으로 읽는 파일로, 해당 프로젝트의 구조와 맥락을 바로 파악할 수 있게 도와줍니다. CLAUDE.md를 옵시디언에서 열어 읽어보면 우리 볼트 구조를 잘 파악하는 것을 확인할 수 있을 겁니다.
05 실제 유용한 작업을 맡겨보겠습니다. 클로드 코드에서 ‘저번 주 일간 노트 내용을 정리하여 주간 노트에 요약해줘’라고 명령합니다. 완료가 되면 [Ctrl + C]를 2번 눌러 클로드 코드를 터미널에서 종료하겠습니다.
06 저번 주의 주간 노트를 열어봅니다. 기존에 있는 주간 노트 템플릿까지 잘 적용되어 저번 주가 잘 요약된 것을 확인할 수 있습니다.
