사용법 — Claude Code Orchestration

🎓 BEGINNER 초보자 모드

✅ 추천 대상: CCO를 처음 사용하는 분 / 각 단계를 직접 확인하며 진행하고 싶은 분

🔵모든 단계마다 사람의 승인(Confirm)을 기다립니다. 실수를 방지하고 전체 흐름을 이해하며 진행할 수 있습니다.

🔵각 스텝 완료 후 상세 가이드 메시지와 다음 단계 안내가 표시됩니다.

🔵실행 전 파라미터(에이전트·우선순위·타임아웃)를 한 번 더 검토하는 단계가 포함됩니다.

⛔자동 연속 실행은 비활성화되어 있습니다. 각 단계를 직접 Next ▶ 로 진행해야 합니다.

⛔병렬 태스크가 최대 2개로 제한됩니다.

💡

사용법: Settings → Execution Mode → Beginner 선택 → Save Mode. 이후 Execution의 State Machine에서 Next State ▶를 직접 눌러 단계를 진행합니다.

⚡ PRO 전문가 모드

✅ 추천 대상: CCO 사용 경험자 / 속도와 자동화를 최우선으로 하는 분

🟣Planning → Execution → Review 전 흐름이 중단 없이 자동으로 연속 실행됩니다.

🟣중간 확인 단계가 제거되어 처리 속도가 최대 3배 빨라집니다.

🟣최대 6개 에이전트가 완전 병렬 실행되어 동시에 여러 태스크를 처리합니다.

🟣오류 발생 시 자동으로 3회 재시도한 후 실패로 처리합니다.

⚠️수동 확인 없이 즉시 실행되므로 플랜을 충분히 검토한 후 사용하세요.

⚡

사용법: Settings → Execution Mode → Pro 토글 ON → Save Mode. 이후 Planning에서 Run Plan을 누르면 모든 단계가 자동으로 완료됩니다.

🔄 모드 전환 방법

1→ 상단 메뉴 Settings 클릭

2→ 좌측 사이드바 Mode 항목 선택

3→ 중앙의 Beginner ↔ Pro 토글을 원하는 모드로 전환

4→ Save Mode 버튼 클릭 — 즉시 적용됩니다

항목	🎓 Beginner	⚡ Pro
단계 승인	수동 확인 ✅	자동 스킵 ⚡
병렬 에이전트	최대 2개	최대 6개 (무제한)
자동 재시도	수동 Retry	자동 3회
처리 속도	느림 (안전)	최대 3배 빠름
추천 상황	학습 · 소규모 프로젝트	대규모 · 반복 작업

🎯

Claude Code Orchestration이란?

CCO는 여러 Claude AI 에이전트를 동시에 조율하여 복잡한 소프트웨어 개발 작업을
자동화하는 오케스트레이션 플랫폼입니다. Planning → Execution → Review 흐름으로
AI 에이전트들이 협력하여 작업을 완료합니다.

1

Settings에서 API 키 설정

상단 메뉴의 Settings → API 설정으로 이동하여 Gemini API 키를 입력합니다. 키는 암호화되어 로컬에 저장됩니다.

2

에이전트 구성 확인

Agents 탭에서 사용 가능한 에이전트(Planner, Executor, Reviewer 등)의 상태를 확인하고 필요하면 추가합니다.

3

작업 계획 수립

Planning 탭에서 새 계획을 생성합니다. 목표를 자연어로 입력하면 AI가 단계별 실행 계획을 자동 생성합니다.

4

실행 및 모니터링

Execution 탭에서 계획을 실행하고, 실시간 로그와 진행률을 확인합니다.

5

결과 분석

Analytics 탭에서 성공률, 응답 속도, 에이전트별 성과 지표를 확인합니다.

💡

팁: Dashboard의 실시간 수치를 보면서 전체 시스템 상태를 한눈에 파악하세요. Active Agents 수와 Success Rate가 핵심 지표입니다.

구성요소	설명	업데이트 주기
Active Agents	현재 작동 중인 에이전트 수	실시간
Tasks Running	진행 중인 태스크 총 수	실시간
Success Rate	태스크 성공률 (%)	1분마다
Avg. Latency	평균 응답 지연 시간 (ms)	30초마다
Weekly Activity	지난 7일 태스크 실행량 차트	시간마다
Recent Events	최근 시스템 이벤트 타임라인	실시간

ℹ️

Running Tasks 테이블에서 각 태스크의 상태(Running / Waiting / Retry)를 확인할 수 있으며, View All 버튼으로 Execution 페이지의 전체 목록으로 이동할 수 있습니다.

①

새 계획 생성

+ New Plan 버튼을 클릭하고 목표를 자연어로 입력합니다.
예: "사용자 인증 모듈을 JWT 기반으로 리팩토링"

②

계획 검토 및 수정

AI가 생성한 단계별 계획을 검토합니다. 각 스텝을 클릭해 내용을 편집하거나 순서를 변경할 수 있습니다.

③

Execution으로 전송

계획 카드 하단의 Run Plan 버튼으로 즉시 실행하거나, Schedule로 예약 실행을 설정합니다.

# Planning 입력 예시

목표: "Express.js API 서버에 rate limiting 추가"

생성 계획:
  Step 1 │ 분석   → 현재 라우트 구조 파악
  Step 2 │ 설치   → express-rate-limit 패키지 추가
  Step 3 │ 구현   → 미들웨어 작성 및 적용
  Step 4 │ 테스트 → 단위 테스트 + 부하 테스트
  Step 5 │ 배포   → PR 생성 및 리뷰 요청

탭	기능
Queue	실행 대기 중인 태스크 목록. 우선순위 조정 가능
Running	현재 실행 중인 태스크와 실시간 진행률 표시
Completed	완료된 태스크 이력과 결과 요약
Logs	에이전트별 실시간 터미널 로그 스트림

⚠️

Retry 상태란 에이전트가 일시적 오류로 재시도 중임을 의미합니다. 3회 이상 재시도 시 Failed로 전환되며 알림이 발송됩니다.

# 실행 로그 예시 (Logs 탭)

[10:42:03] Planner-01  START   코드 분석 및 계획 수립
[10:42:05] Planner-01  INFO    파일 23개 스캔 완료
[10:42:11] Executor-02 START   단위 테스트 자동 생성
[10:42:18] Executor-02 INFO    테스트 파일 4개 생성
[10:42:20] Executor-02 DONE    성공률 100% (12/12 pass)

에이전트 유형	역할	주요 능력
Planner	작업 계획 수립	코드 분석, 의존성 파악, 단계 분해
Executor	실제 코드 작업 수행	파일 편집, 명령 실행, 테스트 생성
Reviewer	코드 리뷰 및 품질 검사	PR 리뷰, 보안 취약점 탐지, 스타일 검사
Analyzer	데이터 및 로그 분석	성능 분석, 버그 추적, 보고서 생성

💡

오케스트레이션 다이어그램에서 에이전트 간 데이터 흐름을 시각적으로 확인할 수 있습니다. 각 에이전트 카드를 클릭하면 상세 로그와 현재 처리 중인 태스크를 볼 수 있습니다.

①

기간 선택

상단의 7D / 30D / 90D 탭으로 분석 기간을 변경합니다.

②

지표 확인

Task Throughput(처리량), Error Rate(오류율), Token Usage(토큰 사용량), Cost Estimate(비용 추정)을 확인합니다.

③

보고서 내보내기

Export CSV 버튼으로 분석 데이터를 스프레드시트로 내보낼 수 있습니다.

설정 항목	내용
API 설정	Gemini API 키 입력, 모델 선택 (Gemini 2.0 Flash / Pro / Ultra)
에이전트 설정	최대 동시 에이전트 수, 타임아웃, 재시도 횟수
알림 설정	태스크 완료/실패 시 Slack/이메일 알림 설정
테마	다크/라이트 모드, 색상 테마 선택
데이터 보존	로그 보존 기간, 자동 정리 일정 설정

⚠️

API 키는 절대로 공유하지 마세요. Settings 페이지는 인증된 사용자만 접근 가능하도록 설정하는 것을 권장합니다.

G D Dashboard로 이동

G P Planning으로 이동

G E Execution으로 이동

G A Agents로 이동

Ctrl K 커맨드 팔레트 열기

N 새 계획 / 태스크 생성

R 현재 페이지 새로고침

? 단축키 도움말 표시

Settings → 에이전트 설정에서 해당 에이전트를 재시작해보세요. 문제가 지속되면 API 키 유효성을 확인하고, 할당량(Quota)이 초과되지 않았는지 Google AI Studio 콘솔에서 확인하세요.

Execution → Logs 탭에서 해당 태스크의 오류 메시지를 확인하세요. 주로 API Rate Limit 초과, 네트워크 타임아웃, 또는 잘못된 명령 입력이 원인입니다. 태스크를 수동으로 취소하고 계획을 수정한 후 재실행하세요.

Analytics → Token Usage 에서 일별/주별 토큰 소비량을 모니터링할 수 있습니다. Settings에서 최대 동시 에이전트 수와 모델(Haiku는 저비용, Opus는 고성능)을 조정하여 비용을 최적화하세요.

Planning 탭에서 완료된 계획도 편집 후 Re-run 버튼으로 재실행할 수 있습니다. 이전 실행 이력은 별도로 보존되어 Analytics에서 비교 분석이 가능합니다.

Dashboard는 기본적으로 캐시된 데이터를 표시합니다. Recent Events 카드의 Refresh 버튼을 클릭하거나 키보드 단축키 R을 눌러 강제 갱신하세요.

사용법 매뉴얼