안녕하세요, 마츠오 연구소의 오자키입니다. 25년 졸업생으로 데이터 사이언티스트로 일하고 있습니다.

최근 Obsidian의 Vault를 인간과 AI의 공유 메모리로 삼은 Personal Knowledge Base (PKB = 개인 지식 베이스)에 관한 이야기를 써왔습니다. Claudian Orchestra로 제가 실제로 운용하고 있는 PKB를 소개했습니다.

PKB를 구축함으로써 원활한 컨텍스트 스위칭 (Context Switching)이나 병행 작업 등이 쉬워지며, 이를 극한까지 끌어올리면 업무 효율을 대폭 향상시킬 수 있습니다.

하지만 실제 문제로 PKB 구축 자체가 꽤 힘들며, 특히 본질적인 부분인 자신이 사용하는 각종 도구를 PKB에 연결하는 부분은 자동화하기가 쉽지 않고 원패키지로 제공하기 어렵다는 생각이 들었습니다. 실제로 여러분이 직접 해주셔야 하는 부분이 꽤 많습니다. 보안 관점에서도 그렇고요. 다만, '전부 직접 하세요~'라고 말하는 것은 PKB 관련 글을 써놓고도 문제라고 생각하기에, 템플릿을 clone하는 것부터 Codex의 인증, Hermes의 도입과 외부 도구의 연결까지, 실제로 직접 움직여 구축하는 절차를 하나하나 친절하게 따라가 보려고 합니다. 또한, 이 글은 CLI에 익숙하지 않은 분들도 독자로 상정하고 있으므로, 명령어를 직접 지시하는 것이 아니라 기본적으로 "ChatGPT에게 이렇게 물어보기"라는 형태로 진행하겠습니다.

제가 처음 이 PKB를 만들었을 때는, 제로(0)에서부터 엄청나게 만들고 엄청나게 부쉈습니다. 에이전트의 분담도, 폴더 규약도, 어디에 무엇을 써도 되는지의 경계도 전부 맨땅에 헤딩하며 보냈고, 작동하기까지 상당한 시간을 허비했습니다. 그래서 지난번에 제 Vault에서 개인 정보를 모두 제거한 바닐라(Vanilla) PKB를 템플릿으로 공개했습니다.

이 템플릿을 사용하면 가장 힘든 "토대 만들기" 부분, 즉 에이전트 계약·운용 규칙·skill 군·디렉토리 규약이 처음부터 포함된 상태로 시작할 수 있습니다. 체감상으로는 제로에서 만드는 것에 비해 대략 0.5 정도까지는 미리 진행된 상태에서 스타트할 수 있는 느낌입니다.

그렇다고는 해도, 앞서 언급한 대로 각 도구를 직접 연결해 주셔야 합니다. Codex의 인증도, Hermes의 도입도, 외부 접속 토큰도, 그리고 무엇보다 "매일 돌리며 운용에 정착시키는 것"은 템플릿이 대신해 줄 수 있는 것이 아닙니다. 이 글은 그 실천을 향한 보조 역할을 합니다.

TL;DR

• 할 일
• ChatGPT 앱을 설치한다. (사실 이것이 진정한 시작점입니다)
• ChatGPT에게 물어보며 obsidian과 codex를 준비한다.
• (일단 임의로) Codex에게 부탁하여 Hermes Agent를 준비한다.
• 외부 도구와의 접속도 Codex에게 부탁하여 연결한다.
• 운용한다.

1. 전체상

만들기 시작하기 전에, 완성된 형태와 템플릿이 가져다주는 범위를 확인해 둡니다. 목표로 하는 것은 지난번에 설명한 3단계 동선입니다. 외부 소스를 Inbox/에 가져오고, 그날의 Daily/ 노트 한 장에 집약하며, 영속적인 지식만을 Wiki/ 등 Main DB로 증류(Distill)하는 흐름이 됩니다.

Capture (자동 중심) → Daily (인간의 감사 판면) → Distill (승인 필수)라는 3단계. 인간은 Daily 한 장만 보면 전체를 조율할 수 있습니다.

이 메커니즘 중 어디까지가 템플릿이고 어디서부터가 자신의 업무인지를 구분하면 다음과 같습니다.

이를 운용하는 과정에서, Main DB에 일상의 업무 정보나 당신의 정보가 축적되면 앞서 언급한 바와 같이 커다란 업무 효율화로 이어집니다. 예를 들어, 적절하게 설계된 하네스 (Harness)를 갖춘 CLI Agent와 조합함으로써, 다음과 같은 슬라이드를 간단한 지시만으로 완성할 수 있습니다.

Claudian orchestra를 소개하는 슬라이드를 만들어줘.

이 지시를 받고서,

• 내가 최근에 작성한 Claudian Orchestra 기사를 보러 가서 아키텍처 이미지를 인용
• 기사 집필 당시의 브레인스토밍 (Wall-hitting) 내용을 읽고 컨셉을 이해
• 마츠오 연구실(Matsuo Lab)의 슬라이드 작성 규약을 바탕으로 python-pptx를 사용하여 슬라이드 작성
• Zenn에 공개된 실제 기사의 URL을 웹 검색 (Web search)으로 취득하여 출처를 기재

라는 흐름을 실행해 주었습니다. 당연히 편집 가능한 PowerPoint입니다. 참고로 사용한 것은 Claude code이며, 모델은 Claude opus 4.8입니다.

또한 이것을 그대로 강연 자료로...까지는 아니더라도, 미세 조정량은 줄어들 것이며, 앞으로도 모델·하네스·PKB는 진화해 나갈 것이기에 더욱 좋은 결과물을 만들 수 있을 것으로 예상됩니다.

그렇다고는 해도, 갑자기 이 단계까지 가는 것은 꽤 어렵고 한동안 운용을 지속해야 합니다. 본 기사를 통해서, 우선은 정보를 축적하는 것, 축적하는 것을 자동화하는 것을 목표로 하고 싶습니다. 그 후 제대로 운용을 계속하여, 부디 업무의 대폭적인 효율화에 기여하는 것으로 만들고 싶습니다.

2. 준비물

템플릿은 「코어 에이전트 1개 + Hermes」라는 구성을 취하고 있으며, 코어 에이전트의 기본값은 Codex CLI입니다 (ChatGPT 구독 하나로 구동할 수 있고 도입이 가볍기 때문입니다). 본 기사도 ChatGPT의 Plus 플랜 이상을 계약하고 있다는 전제하에 진행합니다.

자신의 vault는 코어를 Claude Code Orchestra로 교체해 두었지만, 우선은 템플릿 기본값인 Codex로 시작하여 운용이 익숙해지면 교체하거나 자신만의 오리지널 운용을 하는 것이 좋다고 생각합니다. 어느 쪽이든 AI가 읽는 것은 Obsidian이 아니라 파일 그 자체이므로, Vault의 구조는 변하지 않습니다.

3. Level 0: 셋업

이 기사에서는 셋업을 3단계로 나누고 있습니다. 첫 번째 Level 0은 외부 접속 없이 Obsidian과 Codex만으로 작동하는 최소 루프를 구축하는 단계입니다. 여기까지 오면 「인간과 AI가 동일한 Vault를 읽고 쓰는」 상태가 되므로, 이것이 첫 번째 단계가 됩니다.

이 기사에서는 터미널 (CLI)에서의 작업은 가급적 없도록 진행하겠습니다. 할 일은 심플합니다. ChatGPT에게 다음에 무엇을 해야 할지 묻고, 시키는 대로 붙여넣기 한다. 이것뿐입니다. 따라서 진정한 첫걸음은 개발 환경을 정비하는 것이 아니라, ChatGPT 앱을 설치하는 것이 됩니다.

3.1 우선 ChatGPT 앱과 Obsidian을 설치한다

스마트폰이든 PC든 상관없으니, ChatGPT 앱을 다운로드하고 Plus 이상의 플랜을 사용하는 평소 계정으로 로그인해 둡니다. 이후의 Level 0~2는 기본적으로 이 앱에 말을 걸면서 진행합니다. 모르는 것이 있다면 이후의 절차를 전부 건너뛰고 우선 ChatGPT에게 물어봐도 상관없습니다.

더불어, Obsidian을 설치합니다. 기본적으로 Obsidian은 무료로 사용할 수 있는 IDE가 됩니다. 마크다운 (Markdown)을 편집할 수 있는 도구라고 생각하시면 됩니다. 일단 월 4달러 정도의 유료 플랜도 있지만, 이는 Obsidian sync라는 멀티 디바이스에서 동일한 노트를 사용할 수 있게 하는 기능을 해제하기 위한 것이므로, 이번에는 필요하지 않은 것으로 치겠습니다.

3.2 Obsidian의 Vault를 설정한다

Obsidian에서는 특정 폴더 안에서 작업을 합니다. 그것을 vault라고 합니다. 이번에는 vault를 어느 폴더로 할지는 지정하지 않습니다. 원하는 장소에 vault를 만들어도 괜찮습니다. 자세한 해설이나 초기 설정 방법 등은 아래 기사가 알기 쉬우므로 참조해 주세요.

적당한 폴더를 vault로 설정하고 Obsidian을 열면 이렇게 될 것이라고 생각합니다.

3.3 Claudian 플러그인을 설치한다

Claudian에 대해서는 지난 기사에서도 이야기했지만, Obsidian의 커뮤니티 플러그인입니다. 기능을 활성화해 주세요.

그다음, 「閲覧(열람)」 버튼을 통해 Claudian을 검색합니다.

그대로 설치하고 활성화해 주세요. 활성화가 완료되면 다음과 같이 왼쪽 메뉴 바에 로봇 같은 아이콘이 나타나며, 그것을 클릭하면 화면 오른쪽에 Claudian의 채팅 페이지가 펼쳐질 것입니다.

아마 기본적으로는 Claude의 모델 중 하나가 지정되어 있을 것입니다. 따라서 Codex 쪽에서 설정을 변경해야 합니다. 플러그인 설정 페이지에서 Claudian 설정으로 이동할 수 있으므로, 거기서 Codex를 활성화해 주세요. (참고로 이 상태로는 대화할 수 없을 것입니다)

그러면 다음은 ChatGPT 쪽 설정으로 돌아갑니다.

3.4 Codex CLI를 설치한다

ChatGPT 앱을 다운로드했다면, "ChatGPT Work"를 클릭해 주세요. 위와 같은 화면이 나타날 것입니다. 이 화면에 도달하면, 다음 프롬프트를 그대로 집어넣어 주세요.

이 PC에 OpenAI Codex CLI를 설치해 주세요. OS와 기존의 Node.js/npm 환경을 확인하고, 필요하다면 전제 환경을 갖추고, 공식 절차에 따라 Codex CLI를 도입해 주세요. ChatGPT 구독(Subscription)을 통한 로그인 방법을 우선시하고, 마지막으로 `codex --version`과 간단한 실행 확인까지 진행해 주세요. 기존 환경을 망가뜨리지 않도록 진행해 주세요.

그러면 명령어가 자동으로 실행되면서 Codex CLI가 설치될 것입니다. 만약 여기서 문제가 발생하더라도, 그 문제를 해결해 달라고 ChatGPT에게 부탁하면 아마 고쳐줄 것입니다 ()

다음으로 Codex는 최초 실행 시 로그인을 해야 합니다. 죄송합니다! 여기서 CLI가 등장합니다... (눈물)

Windows라면 PowerShell, Mac이라면 **터미널 (Terminal.app)**을 실행하고, 다음 명령어를 입력해 주세요.

codex login

그러면 브라우저가 열리면서 「Sign in with ChatGPT」 인증 화면이 나타납니다. 평소 사용하는 ChatGPT 계정으로 로그인하면 OK이며, API 키를 별도로 준비할 필요는 없습니다 (ChatGPT 구독을 그대로 사용할 수 있습니다).

인증이 끝나면 터미널 쪽으로 돌아와 로그인 완료가 표시됩니다. 이것이 뜨면 인증 성공이며, 인증 정보는 ~/.codex/에 저장됩니다.

3.5 vault 내에 템플릿을 clone한다.

위의 설정이 끝났다면, Claudian 상에서 Codex에게 명령할 수 있는 상태가 되어 있을 것입니다. 우선 .codex 등의 파일을 볼 수 있도록 합니다. Obsidian에서는 기본적으로 md 파일 등 일부 파일만 열람할 수 있으며, 나머지는 숨김 파일로 취급됩니다. 이를 방지하는 플러그인을 설치합니다. 다음 내용을 그대로 Claudian에게 명령해 주세요.

이 vault에 Hidden folder access라는 커뮤니티 플러그인을 넣어줘.

이렇게 하면 Claudian이 알아서 플러그인을 설치해 줄 것입니다. 그럼 준비가 되었으니 템플릿을 가져오겠습니다. 이번에는 git도 사용하지 않는 것을 가정하므로, 다음과 같이 명령해 주세요.

GitHub의 `DeL-TaiseiOzaki/claudian-orchestra-template`라는 리포지토리(Repository)를 이 Vault에 clone해줘. 단,
git clone --depth 1 `DeL-TaiseiOzaki/claudian-orchestra-template` .
rm -rf .git
...

그러면 Claudian이 적절히 템플릿을 clone하여 다음과 같이 전개되어 있을 것입니다. (이때 원래 있던 Welcome.md는 삭제해도 괜찮습니다)

3.6 첫 Daily를 만들고, Persona에게 자신을 알려주기

Obsidian의 데일리 노트(Daily Note)를 만들어 봅시다. 왼쪽 메뉴 바의 달력 같은 아이콘을 누르면 그날의 데일리 노트가 자동으로 생성됩니다. 방금 clone한 템플릿에는 데일리 노트 템플릿도 포함되어 있어, 다음과 같은 것이 만들어질 것입니다.

다음으로, Persona/에 자신의 프로필을 작성합니다. 이곳은 당신이 누구인지, 어떤 프로젝트를 맡고 있는지, 어떤 스타일로 글을 쓰는지와 같은 'AI에게 전달할 자신의 문맥 (Context)'에 대한 단일 진실 공급원 (Single Source of Truth)이 되는 장소입니다. 템플릿의 초안을 자신의 정보로 채워 나갑니다. 직접 작성해도 좋지만, 다음과 같이 Claudian에게 명령하여 함께 만들어 나갈 수도 있습니다.

Persona/에 저 자신의 프로필을 만들어 가겠습니다. Persona/AGENTS.md의 내용을 이해하고, 적절하게 저에게 질문을 한 뒤, 저로부터 이끌어낸 정보를 Persona/ 이하에 정리해 주세요.

이것으로 Level 0는 완료되었습니다.

4. Level 1: Hermes라는 토대 만들기

외부 연결의 토대로서 Hermes Agent (이하 Hermes라고 약칭함)를 추가합니다. 이 템플릿에서 Hermes는 상주형 에이전트(Resident Agent)로 특별히 이용하지 않고, 데이터 수집(Ingestion) 용도로만 이용합니다. Slack, Calendar, GitHub와 같은 외부 소스의 인증을 모두 일괄적으로 담당하며, 로우 데이터 (Raw Data)를 Inbox/로 가져오는 캡처 (Capture) 전담 에이전트 역할을 수행합니다. 한편, 상주형 (게이트웨이 (gateway)가 외부로부터의 메시지를 대기하는) 에이전트이므로, PC와 Hermes가 구동 중이라면 백그라운드에서 정기적인 자동 수집을 수행하도록 크론 잡 (cron job)을 설계하는 것도 가능합니다 (본 기사에서는 범위 외). 물론 Hermes가 아니더라도 유사한 작업은 가능하지만, 상주를 전제로 설계되었다는 점이나 크론 잡을 만들기 쉽다는 점 등의 이유로 채택했습니다. Hermes가 무엇인지에 대한 해설은 Miki 씨가 기사로 작성해 주셨습니다.

4.1 Hermes 설치하기

Hermes Agent Desktop을 사용하여 Hermes를 설치합니다.

상세한 설치 절차는 다음 기사를 참고했습니다.

프로바이더 (Provider) 선택의 경우, 물론 원하는 것을 선택해도 좋지만, OpenAI Codex를 선택하면 사용 중인 구독 플랜을 그대로 사용할 수 있으므로 그렇게 하는 것이 좋을 것 같습니다.

위의 셋업과 함께 설치가 성공적으로 완료되었다면, 다음과 같이 Claudian에게 명령해 주세요.

이 PC에 Hermes Agent가 도입되어 있습니다. 이 Vault가 있는 폴더를 HERMES_HOME으로 설정하여 Hermes Agent를 셋업해 주세요. 완료되면 GETTING-STARTED.md에 적힌 대로 "hermes chat"으로 테스트해 주세요. 추가로 Hermes Console이라는 커뮤니티 플러그인을 이 Vault에 넣어 주세요.

Hermes 자체의 설치 절차는 본체 측에서 업데이트되므로, Codex가 공식 문서를 참조하며 실제로 명령어를 실행하며 진행해 줍니다. 인간이 할 일은 Codex가 확인이나 승인을 요청할 때 응답하는 것뿐입니다. 도입이 끝나면 Hermes는 .hermes 폴더 내에 상태를 가집니다. config.yaml (연결 및 스킬 (skill) 선언), SOUL.md (인격·방침), .env (토큰 보관소), skills/, 인증 정보 등이 이곳에 집약되는 형태입니다.

Hermes Console이 설치되었다면, 다시 플러그인 설정으로 가서 "Download binaries"를 통해 바이너리를 다운로드해 두세요.

4.2 gateway 실행하기

Hermes Console을 실행해 봅시다. Hermes Console을 열면 아마 다음과 같은 터미널이 나타날 것입니다 (죄송합니다, 또 다시...).

여기서 hermes라고 입력하면, Hermes가 올바르게 설치되어 있을 경우 다음과 같이 실행될 것입니다. 여기서 방금 설정한 GPT 모델이 이미 표시되어 있을 것입니다.

Hermes의 수집은 gateway 프로세스가 동작하고 있어야 비로소 돌아갑니다. 이 부분이 멈춰 있으면, 연결 설정은 올바른데 Inbox/에 아무것도 들어오지 않는 상태가 됩니다. 여기서 이 Hermes Console을 통해 Codex에게 "gateway를 실행해 줘"라고 부탁하면, OS에 따른 실행 스크립트를 판단하여 실행해 줍니다.

이 PC 상에 Hermes Agent의 Gateway를 설정해 줘.

설정이 성공적으로 완료되면 다음과 같이 되어야 합니다.

Claudian에게도 접속 테스트를 하라고 말해둡시다.

이것으로 Level 1은 완료되었으며, 「외부에서 Inbox/에 쓸 수 있는 파이프(pipe)」가 준비되었습니다. 다음 Level 2에서 실제 접속을 하나씩 통과시켜 보겠습니다.

5. Level 2: 외부 접속

이 부분이 PKB(Personal Knowledge Base)의 핵심이자, 가장 좌절하기 쉬운 지점입니다. 힘을 내야 할 구간입니다!

5.1 무엇을 연결할 것인가

본 기사에서는 원래 Claudian Orchestra Template이 상정하고 있는 외부 접속 중, 비교적 사용자가 많은 3가지, Google Calendar · Gmail · Slack을 실제로 연결해 보겠습니다.

기본적으로는 모두 Claudian에게 부탁하여 연결해 나갑니다.

5.2 첫 번째: Google Calendar / Tasks

Google Calendar / Tasks는 연결했을 때의 효과를 가장 쉽게 체감할 수 있어 첫 연습으로 딱 좋습니다. 아침 브리핑(briefing)에 오늘과 내일의 일정 및 태스크(Tasks)가 나열되게 되므로, 데일리(Daily) 노트가 단번에 실용적으로 변합니다. 여기서 사용자의 역할은 Claudian에게 지시를 내리는 것과 Google 화면에서 몇 번 클릭하는 것뿐입니다.

먼저 Claudian에게 다음과 같이 부탁합니다.

Google Calendar와 Tasks를 Hermes에 연결하고 싶어. 무엇을 준비해야 하는지 알려줘.

그러면 대부분의 경우, 「Google Cloud Console에서 OAuth 클라이언트를 만들어 달라」는 취지의 안내가 돌아올 것입니다. Google Cloud Console에서 신규 프로젝트를 생성하고, Calendar API와 Tasks API를 활성화한 후, OAuth 동의 화면을 설정하고, 애플리케이션 유형을 「데스크톱 앱」으로 설정하여 OAuth 클라이언트 ID를 발행합니다. 발행된 client_secret.json을 다운로드해 둡니다.

이 과정은 꽤 번거롭지만, Claudian에게 「알기 쉽게 알려줘」라고 계속 말하면 대부분 알려줍니다 ()

사실 이 외에도 Google 계정 관련 정보를 간단하게 가져올 수 있는 방법으로, GWS CLI를 사용하는 방법도 있습니다. 이번 방식보다 작업이 훨씬 수월하므로 시도해 보셔도 좋습니다. 이 기사에서 자세히 설명하고 있습니다.

연결되었는지 여부도 Claudian에게 물어보고 확인하는 것이 안전합니다.

오늘의 일정과 태스크를 가져와서, 연결되었는지 확인해 줘.

제대로 답변이 돌아온다면, 「아침 브리핑 해줘」라고 부탁해 봅니다. 전용 스킬(skill)이 호출되어 데일리 노트의 아침 섹션에 오늘과 내일의 일정 및 태스크가 나열된다면 성공입니다.

5.3 다음은 Gmail

Gmail은 Calendar를 통해 한 번 OAuth 흐름을 경험했다면 두 번째는 훨씬 빠릅니다. 방금 만든 OAuth 클라이언트에 읽기 전용(read-only) Gmail 스코프(scope)를 추가하기만 하면 됩니다.

먼저 Claudian에게 다음과 같이 부탁합니다.

Gmail도 Hermes에 연결하고 싶어. 읽기 전용이면 돼.

Claudian이 방금 만든 OAuth 클라이언트에 gmail.readonly 스코프를 추가하고, 다시 인증 URL을 생성해 줍니다. Calendar 때와 마찬가지로 브라우저에서 허용한 뒤 리다이렉트(redirect) URL을 Claudian에 다시 붙여넣으면 완료됩니다.

이 URL로 인증해 줘. (붙여넣기)

연결 확인은 평소와 같습니다.

오늘 도착한 메일 제목 목록을 가져와서, 연결되었는지 확인해 줘.

「메일 가져오기 해줘」라고 했을 때 Inbox/{날짜}/mail/에 메일 다이제스트(digest)가 쌓여간다면 성공입니다. 제목과 발신자 · 스니펫(snippet)만 가져오도록 설계되어 있어, 본문이나 첨부 파일 자체는 가져오지 않으므로 기밀성이 높은 메일이라도 비교적 안심하고 연결할 수 있습니다.

5.4 마지막으로 Slack

Slack은 앞선 두 가지와 성격이 달라, Slack 측에서 앱을 하나 만드는 작업이 포함됩니다. 손이 조금 더 가지만, Slack은 Hermes에서도 주요 연결 대상입니다.

단, 원래 Hermes에서 상정하는 봇(bot)으로서의 사용법은 이번에 필요하지 않습니다. 원하는 것은 「내가 볼 수 있는 대화를 나 대신 읽는 것」뿐이므로, 봇 토큰(xoxb-...

）이 아니라, 자신의 계정에 연결된 User Token(xoxp-...)만 사용합니다. 이렇게 하면 봇을 채널에 초대하여 돌아다닐 필요도 없어집니다. 아래 내용을 Claudian에게 명령합니다.

Slack을 Hermes에 연결하고 싶습니다. 봇은 사용하지 않고, 저(승인하는 사용자)를 대신하여 대화를 읽는 User Token만으로 연결하고 싶습니다. 무엇을 준비해야 할지 알려주세요.