Claude Code와 Obsidian을 결합한 영구적 메모리 레이어 구축

실용적 조언

Claude Code 사용 시 프로젝트 루트에 지침 파일을 두어 반복적인 컨텍스트 주입 비용을 줄이십시오.
복잡한 작업은 여러 개의 전문 서브에이전트에게 병렬로 할당하여 처리 속도를 높이십시오.

섹션별 상세

작성자는 Obsidian 보관소 루트에 _CLAUDE.md 파일을 배치하여 Claude Code의 운영 매뉴얼로 활용했다. 이 파일은 Claude가 부팅될 때마다 읽어 들이는 설정 파일 역할을 수행하며, 기존의 세션 단위 메모리 휘발성 문제를 해결하는 핵심 메커니즘으로 작동한다. 이를 통해 사용자는 매 세션마다 컨텍스트를 재설정할 필요 없이 지속적인 작업 흐름을 유지할 수 있다.

PostCompact 훅을 활용하여 데이터 저장 시 백그라운드 에이전트가 자동으로 실행되는 구조를 설계했다. obsidian-bg-agent.sh 스크립트가 헤드리스 모드로 Claude를 실행하여 표준 입력(stdin)으로부터 JSON 요약을 읽고 보관소의 노트를 업데이트한 뒤 종료된다. 이 방식은 사용자의 개입 없이도 지식 베이스가 실시간으로 최신 상태를 유지하도록 보장한다.

병렬 서브에이전트 아키텍처를 도입하여 작업 효율성을 극대화했다. /obsidian-save 명령어를 실행하면 인물, 프로젝트, 작업, 결정, 아이디어라는 5개의 전용 태스크 에이전트가 동시에 생성되어 각 영역의 데이터를 병렬로 처리한다. 이는 단일 에이전트가 순차적으로 처리할 때보다 응답 속도를 비약적으로 향상시키며 복잡한 데이터 분류를 정교하게 수행한다.

크론(Cron) 스케줄링을 통해 주기적인 지식 관리 자동화를 구현했다. /schedule 기능을 통해 아침, 야간, 주간 단위로 에이전트가 실행되어 지식 베이스의 건강 상태를 점검하고 요약 작업을 수행한다. 별도의 MCP 서버 없이 로컬 파일 시스템과 Bash 스크립트만으로 오프라인 환경에서도 작동하도록 설계되어 인프라 의존성을 최소화했다.

용어 해설

슬래시 명령어(Slash Command): — 터미널이나 챗 인터페이스에서 '/'로 시작하는 명령어를 입력하여 특정 기능을 실행하는 방식이다. Claude Code 내에서 복잡한 워크플로나 에이전트 작업을 즉시 호출하는 인터페이스로 활용된다.
헤드리스 모드(Headless Mode): — 그래픽 사용자 인터페이스(GUI) 없이 백그라운드에서 소프트웨어를 실행하는 방식이다. 이 프로젝트에서는 Claude를 화면 출력 없이 실행하여 파일 시스템 업데이트나 데이터 처리를 자동화하는 데 사용된다.
크론(Cron): — 유닉스 계열 운영체제에서 특정 시간에 특정 작업을 자동으로 실행하도록 설정하는 시간 기반 잡 스케줄러이다. 아침, 야간, 주간 단위로 에이전트를 실행하여 지식 베이스를 관리하는 데 필수적인 역할을 한다.

언급된 도구

Claude Code추천

터미널 기반 AI 코딩 에이전트 및 메인 실행 환경

Obsidian추천

로컬 마크다운 기반 지식 저장소 및 메모리 레이어

Bash중립

에이전트 실행 및 파일 시스템 조작을 위한 스크립트 언어

언급된 리소스

GitHubObsidian Second Brain for Claude Code GitHub