Claude Code와 다중 LLM을 활용한 지능형 워크스페이스 구축 가이드

커뮤니티 반응

작성자의 체계적인 워크플로에 대해 매우 긍정적인 반응이며, 특히 SOUL.md를 통한 페르소나 설정과 CLI 기반의 모델 간 협업 방식에 대해 구체적인 구현 방법을 묻는 질문이 많다.

주요 논점

01찬성다수

단일 모델에 의존하기보다 여러 모델의 강점을 결합하고 세션 기록을 자산화하는 것이 생산성 향상에 필수적이다.

합의점 vs 논쟁점

합의점

AI 모델 간의 컨텍스트 공유를 위해 구조화된 마크다운 파일을 사용하는 방식이 매우 효율적이다.
모델에게 명확한 역할과 한계를 부여하는 페르소나 설정이 협업의 품질을 결정한다.

논쟁점

3개의 유료 구독 모델을 동시에 유지하는 비용 대비 효율성에 대해서는 사용자마다 의견이 갈릴 수 있다.

실용적 조언

처음부터 3개 모델을 쓰기보다 Claude와 리뷰용 모델 1개로 시작하여 워크플로를 익히는 것이 좋다.
SOUL.md 파일은 최소 100줄 이상으로 상세하게 작성하여 모델의 행동 경계를 확실히 정해야 한다.
세션 로그는 한 세션당 20줄 이내로 핵심만 기록하여 컨텍스트가 비대해지는 것을 방지해야 한다.

섹션별 상세

마크다운 기반의 컨텍스트 레이어 구축이 핵심이다. 데이터베이스 대신 CLAUDE.md, PROFILE.md, SESSION_LOG.md와 같은 파일 시스템을 프로토콜로 사용하여 모든 모델이 동일한 프로젝트 맥락과 사용자 선호도를 공유하도록 설계했다. Claude Code는 세션 시작 시 이 파일들을 자동으로 읽어 이전 작업의 결정 사항과 제약 조건을 즉시 파악한다.

모델별 정체성을 정의하는 SOUL.md 파일을 도입했다. 각 모델의 강점, 한계, 미션, 그리고 다른 피어(Peer) 모델들의 존재를 명시한 125줄 가량의 프롬프트를 통해 모델 간 역할 분담을 명확히 했다. 이를 통해 모델이 자신의 권한 밖의 기능을 환각하는 현상을 방지하고 협업 효율을 높였다.

CLI 기반의 상호 호출 메커니즘을 구현했다. 복잡한 API 연동이나 미들웨어 없이 터미널에서 'claude -p' 또는 'codex exec'와 같은 명령어를 사용하여 모델들이 서로를 호출하도록 만들었다. 예를 들어 Claude가 코드를 작성하면 GPT가 독립적인 QA 리뷰어로 참여하여 심각도별로 버그를 분류하고 수정을 요구하는 다회차 리뷰 루프가 가능하다.

bash

codex exec --skip-git-repo-check "Review this function for edge cases"
gemini -m gemini-3-flash-preview -p "Search for recent benchmarks on X"
claude -p "Summarize the last 3 session log entries"

별도의 API 미들웨어 없이 CLI 명령어를 통해 서로 다른 AI 모델을 직접 호출하고 협업시키는 예시

지식의 복리 효과를 위한 세션 클로징 프로세스를 운영한다. 작업 블록이 끝날 때마다 'Session Closer' 에이전트가 실행되어 세션 로그 업데이트, 결정 사항 구조화, Obsidian 호환 마크다운 노트 생성을 수행한다. 3개월간 축적된 50개 이상의 지식 파일은 새로운 아키텍처 결정 시 과거의 유사한 사례를 참조하는 강력한 근거가 된다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 로컬 데이터나 외부 도구에 표준화된 방식으로 접근할 수 있게 해주는 Anthropic의 개방형 프로토콜이다. 이를 통해 서로 다른 AI 모델들이 동일한 데이터 소스를 공유하거나 특정 기능을 수행하도록 연결할 수 있다.
CLI 오케스트레이션(CLI Orchestration): — 터미널 명령줄 인터페이스(CLI)를 통해 여러 AI 모델이나 도구의 실행 순서를 제어하고 데이터를 주고받는 방식이다. API 연동 없이도 셸 스크립트나 직접 명령어로 모델 간 협업을 구현할 수 있다.
컨텍스트 윈도우(Context Window): — AI 모델이 한 번에 처리할 수 있는 텍스트 정보의 양이다. 이 글에서는 마크다운 파일을 통해 세션 간의 맥락을 유지함으로써 제한된 윈도우 내에서 효율적으로 정보를 관리하는 전략을 다룬다.

언급된 도구

Claude Code추천

메인 오케스트레이터 및 복잡한 분석, 코딩 수행

Codex CLI추천

GPT 모델을 통한 코드 리뷰 및 디버깅 실행

Gemini CLI추천

웹 조사 및 구글 워크스페이스 통합 활용

Obsidian추천

축적된 세션 지식 및 결정 사항 시각화/관리