firstintent/ccteam

ccteam – 여러 코딩 에이전트 LLM 오케스트레이션

개요 – ccteam은 Rust 기반 데몬으로, 여러 코딩 어시스턴트 모델(Claude Code, OpenAI Codex, xAI Grok, Moonshot Kimi, DeepSeek Harness, Pi)을 단일 '팀'으로 함께 실행할 수 있게 해줍니다. 각 공급업체 CLI의 ID 및 인증, 에이전트 간 프롬프트 및 도구 호출 라우팅, 모델별 사용량을 기록하는 비용 원장, 디스패치된 작업이 (최소 한 번) 전달되고 중지될 수 있음을 보장하는 얇은 '연결 조직'을 제공합니다.

사용 방법

1. 공급업체 CLI 설치 이미 보유한 것(Claude Code, Codex 등)에 로그인합니다.
2. ccteam 데몬 시작 (ccteam start). :7331에서 웹 서버를 실행하고 LAN URL을 출력합니다.
3. 팀 제어 모든 디바이스에서:
   • Telegram/Lark/Slack 봇(명령은 / 또는 !로 시작),
   • 가벼운 웹 콘솔(채팅 스타일 UI), 또는
   • REST API(/api/v1)를 통한 프로그래밍 방식.
4. 세션 생성 – 세션은 단일 LLM 인스턴스입니다. 여러 개를 생성할 수 있습니다. 예:

   /new codex effort=high   # Codex 워커 시작
   /new grok                # Grok 워커 시작
   

5. 오케스트레이션 자연어를 입력하거나(LLM이 내부적으로 agent/agent_read를 호출) 플로우를 작성합니다 – agent(), parallel(), pipeline() 등을 사용하여 결정론적 워크플로우를 정의하는 작은 JavaScript 파일입니다.
6. 모니터링 팀 페이지에는 부모→자식 위임, 모델 사용량, 달러 비용의 라이브 그래프가 표시됩니다. 콘솔에는 세션별 컨텍스트, 턴 로그, 비용 상한 알약도 표시됩니다.

핵심 개념

• 세션 – 실행 중인 LLM 인스턴스(예: Claude Code 세션). 턴을 받고 자식 세션을 생성할 수 있습니다.
• 플로우 – agent 호출 시퀀스를 프로그래밍 방식으로 정의하는 JS 스크립트. 실행은 저널링되며 데몬 재시작 후 재개할 수 있습니다.
• 정책 훅 – 모든 위임을 승인 또는 거부할 수 있는 선택적 실행 파일(.ccteam/hooks/pre-agent). 할당량 또는 보안 검사에 유용합니다.
• MCP 도구 – 6개의 내장 원격 프로시저 호출(agent, agent_read, agent_stop, status, chat_send_file 및 디스커버리 별칭). 모든 세션 또는 외부 에이전트가 호출할 수 있습니다.
• 위성 – 조인 토큰을 통해 데몬에 등록하는 보조 머신. 단일 콘솔에서 모든 것을 제어하면서 다른 호스트에서 무거운 모델(예: GPU 지원 Claude)을 실행할 수 있습니다.

중요성

• 각 공급업체의 강점 활용 – 계획에는 Claude, 장기 실행 코드 생성에는 Codex, 빠른 답변에는 Grok, 저렴한 대량 작업에는 Kimi 등.
• 비용 투명성 – 모든 턴이 모델 이름과 가격으로 기록되므로 일일 상한을 설정하고 비용이 정확히 어디에 사용되는지 확인할 수 있습니다.
• 통합 UI – 터미널을 전환할 필요 없이 Telegram, Slack 또는 브라우저에서 수십 개의 병렬 세션을 관리할 수 있습니다.
• 확장 가능 – 자신의 스킬, 페르소나, 사용자 정의 정책 훅을 추가할 수 있으며 OpenAPI 사양을 통해 다른 자동화에서 ccteam을 호출할 수 있습니다.

일반적인 워크플로우 예시

# Telegram에서
/cd my-project               # 프로젝트 선택
/new codex effort=high       # Codex 워커 시작
/new grok                    # Grok 워커 시작
@s2 run the test suite       # Codex 세션(s2)에 직접 주소 지정
/status                      # 실행 중인 모델과 지금까지의 비용 확인

또는 플로우로(branch-review.flow.js):

const review = agent({vendor:"claude", title:"review", task:"review PR #42"});
const impl   = agent({vendor:"codex",  title:"impl",   task:"implement changes"});
await parallel(review, impl);

ccteam flow run branch-review.flow.js --budget 5로 실행합니다.

결론 – ccteam은 새로운 LLM이 아니라, 여러 코딩 어시스턴트 모델을 조정된 팀으로 취급할 수 있게 하는 오케스트레이션 계층으로, 단일 제어 표면, 비용 회계, 안전 훅을 제공합니다.

---

필드

• 저장소: https://github.com/firstintent/ccteam
• 라이선스: MIT
• 주요 언어: Rust(CLI/데몬) + JavaScript(플로우용)/ Node(DSH 플러그인용).
• 플랫폼: macOS, Linux, Windows(WSL) — 바이너리 배포, sudo 불필요.
• 대상 사용자: 이미 하나 이상의 코딩 어시스턴트 CLI를 사용 중이고 함께 오케스트레이션하려는 개발자, 또는 공유 비용 인식 콘솔이 필요한 팀.
• 상태: 적극적으로 유지 관리됨(CI 배지, 설치 스크립트, 문서).