Claude Code에 숨겨진 멀티 에이전트 시스템 오픈소스로 공개 (CC Mirror)
(aisparkup.com)배경
- Anthropic의 Claude Code에 완성된 멀티 에이전트 ‘팀 모드’ 기능이 존재
- 공식적으로 비활성화된 상태 (기능 플래그로 제어됨)
- 개발자 Numman Ali가 코드 분석 중 발견
- 오픈소스 프로젝트 CC Mirror로 활성화 및 패키징
CC Mirror 주요 기능
- 기존 Claude Code 복사본 생성 (완전 격리)
- 팀 모드 기본 활성화
- 외부 의존성 없음 (JSON 파일 + 기본 도구만 사용)
- 여러 AI 제공자 지원 (Anthropic, Z.ai, MiniMax, OpenRouter 등)
설치 및 사용
-
한 줄 설치 예시:
npx cc-mirror quick --provider mirror --name mclaude -
실행 명령어:
mclaude(팀 모드 포함 Claude 사용) -
다른 제공자 예시:
- Z.ai:
--provider zai --api-key "$Z_AI_API_KEY" - OpenRouter:
--provider openrouter --api-key "$OPENROUTER_API_KEY"
- Z.ai:
팀 모드 핵심 도구 (Claude가 사용)
- TaskCreate: 작업 생성 및 의존성 설정
- TaskGet: 작업 상세 조회
- TaskUpdate: 상태 변경/댓글 추가
- TaskList: 전체 작업 목록 보기
작동 방식
- Claude가 ‘Conductor(지휘자)’ 역할
- 복잡한 요청 → 작업 그래프로 자동 분해
- 백그라운드 에이전트 생성 → 병렬 실행
- 의존성 관리 (“blockedBy”로 대기/자동 시작)
- 작업 소유자 지정 → 충돌 방지
- 프로젝트별 자동 격리 (폴더 기반 팀 생성)
예시: “할일 관리 REST API 만들기”
-
일반 Claude Code: 순차적 처리 (스키마 → 라우트 → 테스트)
-
CC Mirror: 병렬 처리
- Task 1: 데이터베이스 스키마
- Task 2: API 라우트 (Task 1 의존)
- Task 3: 테스트 (독립)
- Task 1/3 병렬 실행 → Task 1 완료 시 Task 2 자동 시작
- 최종 결과 통합
수동 관리 명령어
-
npx cc-mirror tasks: 열린 작업 확인 -
npx cc-mirror tasks show [ID]: 작업 상세 보기 -
npx cc-mirror tasks graph: 의존성 그래프 시각화 -
npx cc-mirror tasks update [ID] --status resolved: 완료 처리
중요성
- 멀티 에이전트 시스템 간단 구현 가능 (복잡한 브로커 불필요)
- AI가 효과적인 오케스트레이션 보여줌
- Anthropic이 준비했으나 미활성화 → 커뮤니티가 활용
- AI 도구 생태계 패턴: 숨겨진 강력 기능 커뮤니티 발견
출처
- CC Mirror GitHub (numman-ali/cc-mirror)