Claude Code에서의 다중 에이전트 시스템: 배포

단일 AI 에이전트에서 다중 에이전트 시스템으로: 실제 운영 사례

개발자는 프로덕션 서버에서 작업을 자동화하기 위해 클로드 코드(Claude Code)를 사용하기 시작했다. 하지만 문제는 파일 및 네트워크 작업에 대한 지속적인 권한 요청이었다. --dangerously-skip-permissions 플래그는 도움이 되었지만, 에이전트는 구성 설정을 자율적으로 수정할 수 없었다.

자율성은 tmux 세션 유지와 systemd 자동 시작을 통해 달성되었다. systemd 서비스 파일은 실패 후 재시작을 보장하고, 파일에서 컨텍스트를 로드했다:

[Unit]
Description=Claude Code Agent
After=network.target

[Service]
Type=simple
User=ubuntu
ExecStart=/usr/local/bin/claude --dangerously-skip-permissions ...
Restart=always
RestartSec=5

제한된 권한을 가진 에이전트는 블로그 작업을 처리했지만, 고립된 상태였다.

에이전트 간 협업으로 제한 극복

클로드 코드의 두 개의 인스턴스가 승인 버블을 해결했다: 하나는 작업을 요청하고, 다른 하나는 tmux를 통해 승인했다. 이로써 인간의 개입이나 API 키 의존도를 완전히 제거했다. 클로드 맥스 구독은 사용량 제한을 커버하며, API 호출 시 토큰 소모 없이 작동한다.

텔레그램과의 통합 과정에서 충돌이 발생했다. 공식 MCP 서버는 능동적 메시지 전송을 지원하지 않았고, Telethon은 폴링 문제를 일으켰다. 해결책은 send-keys와 직접 claude {text} 명령어를 활용한 tmux 기반 메시지 버스였다.

확장의 기반: 메시지 버스 아키텍처

Bun + Hono + Redis Streams 기반의 메시지 버스는 소비자 그룹을 통해 최소 한 번 이상 전달을 보장했다. 각 에이전트는 독립적인 그룹을 가지며, 메시지는 확인될 때까지 유지된다.

보안:

• 관리용 관리자 토큰
• 각 에이전트별 운영 토큰
• 1시간 유효기간, 단일 사용만 가능한 초대 토큰

라우팅:

• 직접 전송 — 특정 에이전트로
• 방송 — 모든 에이전트로
• 역할 기반 — 역할에 따라

SSE를 지원해 실시간 업데이트를 가능하게 하며, 주제 채널 기반의 pub/sub와 공유 저장소를 통한 첨부파일 전송도 가능하다. from 필드는 토큰에서 자동으로 채워진다.

나루토 인물 아키텍처를 활용한 역할 분담

에이전트들은 나루토 세계관의 인물 이름을 따서 역할을 명확히 하고, 인간 운영자와 구분했다:

• 나루토: 오케스트레이터, 작업을 할당
• 사스케: 텔레그램 사용 계정, 그룹 모니터링
• 이타치: WSL 기반 콘솔 클로드 코드, 복잡한 작업 처리
• 시카마루: 클로드 데스크톱 오퍼스 전략 자문가

인프라 에이전트:

• 카카시 (손넷): 팀 리더
• 가이: 빠른 작업 처리
• 시노: 품질 보증 책임자
• 힌아타: 테스트 담당
• 이비키: 보안 감사
• 카바 + 아카마루: 모니터링
• 미라: 외부 시스템 접근
• 지라이야: 로그 및 지식베이스 관리

통합 시스템: 요노테, 야ndex 트래커, 야ndex 캘린더, 비트릭스24

다중 에이전트 환경에서의 훈련 위임

초기에는 에이전트들이 독립적으로 작업을 수행하며 위임을 무시했다. 반복적인 프롬프트 엔지니어링을 통해 위임 능력이 발전했다:

• 나루토는 작업을 할당하기 전 팀의 준비 상태를 확인한다.
• 카카시는 간단한 작업을 가이에게 위임한다.

행동 패턴은 인간의 관리 방식과 유사하다: 위임은 명시적인 훈련이 필요하며, LLM의 경우 자동 실행이 가장 쉬운 길이다.

최종 아키텍처와 한계점

시스템: 12개의 에이전트, 로그, 알림, 메시지 검색, 리마인더 기능을 갖춘 웹 관리 대시보드. 1주일 만에 자체 개발, 총 67개 커밋.

구현되지 않은 기능: 전화 통화, 캡차 회피, 영상 통화용 아바타

핵심 교훈:

• 다중 에이전트 시스템은 실제 문제 해결에서 자연스럽게 성장한다.
• tmux + send-keys는 MCP 프로토콜보다 우수하다.
• 에이전트 간 상호 승인은 인간 개입 의존도를 제거한다.
• 클로드 맥스 구독은 API 비용을 줄인다.
• 위임은 인간과 마찬가지로 반복적 훈련이 필요하다.

— Editorial Team