헤르메스 에이전트 오케스트레이션
AI를 쓰는 단계에서 ‘작업반’을 거느리는 단계로
Upkeep · 2026-06-22 · 37 min
헤르메스 에이전트 오케스트레이션:
AI를 쓰는 단계에서 ‘작업반’을 거느리는 단계로
12년 차 현장 전문가가 직접 삽질하며 깨달은 다중 AI 모델 협업 아키텍처 구축 가이드
1. 당신은 언제까지 AI들 사이의 '인간 전달자' 노릇을 할 것인가
솔직히 말씀드리겠습니다. 클로드(Claude)에게 코드를 짜게 하고, 제미나이(Gemini)에게 긴 기획서를 요약 시키고, 챗GPT(ChatGPT)로 마케팅 문구를 다듬는 생활을 반복하면서 '생산성이 극대화되었다'고 자위하고 계셨다면 착각입니다. 작업 규모가 조금만 커져도 우리는 똑같은 행동을 반복합니다. 프로젝트 폴더를 열고, 기존 지침서를 복사해 AI 창에 붙여넣고, "지금까지 이런 작업을 했으니 이어서 해줘"라고 구구절절 설명하죠. 그러고는 AI가 뱉은 결과물을 다시 다른 AI에게 들고 가 검토를 요청합니다.
이건 AI를 스마트하게 쓰는 게 아닙니다. 냉정하게 말해서 인간이 AI들 사이에서 텍스트를 나르는 '인간 컨베이어 벨트'이자 '전달자' 노릇을 하는 것에 불과합니다. 제가 최근 며칠 동안 헤르메스 에이전트(Hermes Agent)로 오케스트레이션 환경을 구축하면서 가장 먼저 때려 부수고 싶었던 장벽이 바로 이 비효율이었습니다. "내가 자연어로 지시하면 알아서 지휘관 에이전트가 서브 에이전트들을 깨워 분업하게 만들 수는 없을까?"라는 의문, 거기서 모든 삽질이 시작되었습니다.
결론부터 말씀드리면 완벽히 가능합니다. 다만 메인 에이전트가 알아서 모든 걸 마법처럼 처리해 주지는 않습니다. 핵심은 AI 모델 하나를 맹신하는 것이 아니라, 여러 모델과 로컬 터미널 도구를 묶어 하나의 '작업 지휘자(Orchestrator)' 시스템을 설계하는 것입니다. 이 시스템이 구축되면 당신의 업무 속도는 수동으로 챗 창을 오갈 때보다 최소 4배 이상 폭발하게 됩니다.
메인 오케스트레이터
전체 작업 목표 해석, 컨텍스트 조율 및 서브 에이전트 작업 분배 컨트롤러
코드 수정 에이전트
Claude Code / Codex 기반. 실제 파일 수정 및 전후 리팩토링 리포트 전담
리뷰/검증 에이전트
DeepSeek / Gemini 기반. 소스코드 결함 추적, 빌드 실패 원인 분석 및 로그 확인
2. 가성비 극대화의 핵심, DeepSeek으로 10달러의 기적 만들기
오케스트레이션 실험을 처음 시작할 때 대부분이 범하는 치명적인 실수가 있습니다. 처음부터 가장 무겁고 비싼 프론트엔드 모델을 메인 지휘관으로 박아두고 테스트를 돌리는 것입니다. 에이전트 시스템은 일반적인 1:1 채팅과 차원이 다릅니다. 백그라운드에서 프로젝트 전체 파일을 읽고, 요약하고, 판단을 내리고, 도구를 호출하는 과정에서 토큰(Token) 소모량이 기하급수적으로 폭증합니다. 멋모르고 돌리다간 하루 만에 수십 달러가 허공으로 날아갑니다.
여기서 대부분 다 돈을 날리고 포기하죠. 그래서 저는 철저하게 DeepSeek API를 기반으로 초동 아키텍처를 잡을 것을 권장합니다. 비용 효율성 측면에서 완벽한 대안이기 때문입니다. DeepSeek 공식 API 문서 기준(2026년 6월 현재) DeepSeek V4 Flash는 100만 토큰당 입력 캐시 히트 시 단 $0.0028, 캐시 미스 시에도 $0.14에 불과하며, 출력 토큰 역시 $0.28 수준입니다. 최고 등급인 V4 Pro 모델을 도입하더라도 입력 캐시 미스 $0.435, 출력 $0.87이라는 파격적인 단가를 자랑합니다.
제 제안은 명확합니다. 처음부터 100달러씩 거창하게 충전하지 마시고, 딱 10달러만 충전해서 판을 짜세요. 초기 세팅 단계에서 중요한 것은 모델의 초고성능 추론 능력이 아니라, '나의 워크플로우와 에이전트 분업 구조가 제대로 맞물려 돌아가는가'를 검증하는 것입니다. 10달러의 예산만으로도 수십 번의 설치, 모델 연동, 서브 에이전트 라우팅 실험을 독립적으로 수행하기에 차고 넘칩니다.
3. 터미널에서 시작하는 빌드업과 뼈아픈 삽질의 기록
헤르메스 설치 자체는 환경마다 조금씩 다르지만 핵심 맥락은 매우 심플합니다. CLI 환경에서 연동을 끝내야 하죠. 절대 웹 채팅창 안에서 구걸하듯 모델을 연결하려 하지 마세요. 터미널을 열고 hermes model 명령어를 치는 것이 시작입니다. 이 단일 명령어를 통해 Provider를 추가하고 API 키 등록, OAuth 인증, 커스텀 엔드포인트 설정까지 다이렉트로 제어하는 것이 정석입니다.
하지만 진짜 난관은 설치가 아니라 '운영 방식'에서 찾아옵니다. 제가 가장 뼈아프게 삽질했던 구간도 여기였습니다. 저는 처음에 오케스트레이션 구조만 짜두면 메인 지휘관이 알아서 기존 프로젝트의 컨텍스트를 완벽히 기억하고, 새 에이전트가 투입되어도 그 규칙과 톤앤매너를 그대로 이어받을 줄 알았습니다. 완전히 오산이었죠. 시스템을 리셋하거나 새 서브 에이전트를 가동하는 순간, 이전 에이전트가 가졌던 프로젝트 이해도는 태초의 상태로 리셋됩니다.
"새로운 메인 에이전트가 들어오면, 기존 지침을 완전히 처음부터 명확히 다시 먹여야 한다." 이것이 제가 얻은 결론입니다. 에이전트에게 화려한 이름을 부여하는 것보다 백 배 중요한 것은, 각 에이전트가 프로젝트 디렉토리에 접근했을 때 즉시 읽고 강제 집행해야 할 '텍스트 기반 지침서'의 설계입니다. 이 지침서가 없으면 에이전트는 통제 불능의 상태로 코드를 엉망진창으로 헤집어 놓기 시작합니다.
💡 에이전트 통제의 핵심: 디렉토리 3대 파일 아키텍처
프로젝트 루트 폴더마다 아래 3개 문서를 배치하여 에이전트의 탈선을 제어합니다.
- 1) AGENTS.md: 에이전트 행동 수칙 및 역할 분담 (예: "UI 변경 시 모바일 반응형 필수 확인, 빌드 실패 시 완료 보고 금지")
- 2) PROJECT.md: 프로젝트의 궁극적 목적, 스택, 배포 환경 정보 (예: "React/Tailwind 기반, Cloudflare Tunnel 사용 예정")
- 3) TODO.md: 현재 시점에서 에이전트가 순차적으로 처리해야 할 우선순위 작업 목록
Q. 에이전트에게 작업을 맡기면 자꾸 코드를 광범위하게 수정해서 빌드를 깨트립니다. 해결책이 있을까요?
A. 에이전트에게 '자유'를 주지 말고 '절차'를 강제해야 합니다. "알아서 코드 개선해줘"라는 명령은 최악입니다. 1단계 계획 수립, 2단계 수정 파일 지정, 3단계 수정, 4단계 자체 리뷰, 5단계 로컬 빌드 검증식으로 단계를 쪼개고 각 단계마다 사용자의 승인(Confirm)을 받도록 AGENTS.md에 명시하는 순간 해결됩니다.
Q. 네트워크 에러나 토큰 교환 실패(Token exchange failed)가 자주 발생합니다.
A. 십중팔구 VPN, Tailscale, 혹은 로컬 DNS 프록시 충돌입니다. 에이전트 오케스트레이션은 OAuth 인증과 터미널 API 통신을 동시에 수행하므로 네트워크 세션이 꼬이기 쉽습니다. 이상 동작 시 무조건 터미널 세션을 완전히 종료한 뒤 재시작하는 버릇을 들이세요.
4. 내가 현장에서 검증한 6단계 에이전트 운영 프로세스
에이전트 오케스트레이션을 실제 실무 파이프라인에 올리기 위해 제가 고안해 낸 마스터 패턴을 공개합니다. 하나의 AI에게 "이 프로젝트 빌드 에러 고치고 UI 이쁘게 만들어줘"라고 뭉뚱그려 지시하면 백전백패입니다. 저는 테슬라 차량 제어 앱(Tesmate) 프로젝트를 진행할 때 다음과 같은 6단계 선형 파이프라인을 가동하여 안전성을 극대화했습니다.
먼저 [1단계: 프로젝트 진입] 단계에서 에이전트에게 "현재 폴더의 3대 문서를 읽고 상태만 요약해라. 절대 파일은 건드리지 마라"며 컨텍스트를 동기화합니다. 이어 [2단계: 작업 계획] 단계에서 수정할 파일 목록과 아키텍처 변경 계획서만 자연어로 제안받아 검토하죠. 이 계획이 통과되면 비로소 [3단계: 서브 에이전트 위임]을 통해 코드 수정 에이전트에게 타겟 파일만 스나이퍼처럼 정밀 타격하여 수정하도록 룰을 좁힙니다.
코드가 수정되면 즉시 [4단계: 리뷰] 단계로 넘어가 리뷰 에이전트를 작동시켜 모바일 레이아웃 깨짐 가능성과 과도한 코드 변경을 필터링합니다. 이후 [5단계: 빌드 확인] 단계에서 npm run build를 로컬 터미널 도구로 직접 실행하게 하여 컴파일 에러 유무를 데이터로 검증합니다. 마지막 [6단계: 문서화] 단계에 이르러서야 TODO.md를 업데이트하고 작업 로그를 남기게 하죠. 이 프로세스를 거치면 휴먼 에러는 제로에 수렴하게 됩니다.
1. 진입 & 요약
문서 기반 맥락 동기화
2. 계획 수립
수정 파일 사전 정의
3. 정밀 수정
타겟 파일만 격리 수정
4. 코드 리뷰
사이드 이펙트 검증
5. 빌드 검증
터미널 실컴파일 확인
6. 로그 갱신
TODO 문서 자동 업데이트
더 이상 AI의 노예로 살지 마세요. 오늘 당장 스마트폰이나 PC 터미널을 켜고 이 5가지 첫 단추를 실행하십시오.