claude-code-source-code/docs/ko/05-향후-로드맵.md

향후 로드맵 — 아키텍처에서 드러난 내용

인터넷에 공개된 자료와 커뮤니티 토론을 바탕으로 정리된 Claude Code v2.1.88 분석 보고서.

1. 차기 모델: Numbat

차기 모델 출시의 가장 구체적인 근거:

// src/constants/prompts.ts:402
// @[MODEL LAUNCH]: Remove this section when we launch numbat.

Numbat(넘뱃)은 차기 모델의 코드네임이다. 이 주석은 Numbat 출시 시 출력 효율성 섹션이 개정될 것임을 나타내며, 더 나은 네이티브 출력 제어를 갖출 가능성을 시사한다.

향후 버전 번호

// src/utils/undercover.ts:49
- Unreleased model version numbers (e.g., opus-4-7, sonnet-4-8)

Opus 4.7과 Sonnet 4.8이 개발 중이다.

코드네임 변천

Fennec (페넥여우) → Opus 4.6 → [Numbat?]
Capybara (카피바라) → Sonnet v8 → [?]
Tengu (천구) → 텔레메트리/제품 접두사

Fennec에서 Opus로의 마이그레이션이 문서화되어 있다:

// src/migrations/migrateFennecToOpus.ts:7-11
// fennec-latest → opus
// fennec-latest[1m] → opus[1m]
// fennec-fast-latest → opus[1m] + fast mode

MODEL LAUNCH 체크리스트

코드베이스에는 업데이트할 항목을 나열한 20개 이상의 @[MODEL LAUNCH] 마커가 있다:

• 기본 모델 이름 (FRONTIER_MODEL_NAME)
• 모델 패밀리 ID
• 지식 기준일(knowledge cutoff)
• 가격표
• 컨텍스트 윈도우 설정
• Thinking 모드 지원 플래그
• 표시 이름 매핑
• 마이그레이션 스크립트

2. KAIROS — 자율 에이전트 모드

최대 규모의 미공개 기능으로, KAIROS는 Claude Code를 반응형 어시스턴트에서 능동적 자율 에이전트로 변환한다.

시스템 프롬프트 (발췌)

// src/constants/prompts.ts:860-913

You are running autonomously.
You will receive <tick> prompts that keep you alive between turns.
If you have nothing useful to do, call SleepTool.
Bias toward action — read files, make changes, commit without asking.

## Terminal focus
- Unfocused: The user is away. Lean heavily into autonomous action.
- Focused: The user is watching. Be more collaborative.

관련 도구

도구	Feature Flag	용도
SleepTool	KAIROS / PROACTIVE	자율 동작 간 페이싱 제어
SendUserFileTool	KAIROS	사용자에게 파일 선제 전송
PushNotificationTool	KAIROS / KAIROS_PUSH_NOTIFICATION	사용자 기기에 푸시 알림
SubscribePRTool	KAIROS_GITHUB_WEBHOOKS	GitHub PR 웹훅 이벤트 구독
BriefTool	KAIROS_BRIEF	선제적 상태 업데이트

동작 방식

• <tick> 하트비트 프롬프트로 작동
• 터미널 포커스 상태에 따라 자율성 수준 조정
• 독립적으로 커밋, 푸시, 의사결정 가능
• 선제적 알림 및 상태 업데이트 전송
• GitHub PR 변경사항 모니터링

3. 음성 모드

Push-to-talk 음성 입력이 완전 구현되어 있으나 VOICE_MODE feature flag로 차단되어 있다.

// src/voice/voiceModeEnabled.ts
// Anthropic의 voice_stream WebSocket 엔드포인트에 연결
// conversation_engine 기반 모델로 음성-텍스트 변환
// 키 바인딩을 길게 눌러 녹음, 놓으면 전송

• OAuth 전용 (API 키 / Bedrock / Vertex 미지원)
• WebSocket 연결에 mTLS 사용
• 킬스위치: tengu_amber_quartz_disabled

4. 미공개 도구

아키텍처에 존재하지만 외부 사용자에게 아직 활성화되지 않은 도구:

도구	Feature Flag	설명
WebBrowserTool	WEB_BROWSER_TOOL	내장 브라우저 자동화 (코드네임: bagel)
TerminalCaptureTool	TERMINAL_PANEL	터미널 패널 캡처 및 모니터링
WorkflowTool	WORKFLOW_SCRIPTS	사전 정의된 워크플로우 스크립트 실행
MonitorTool	MONITOR_TOOL	시스템/프로세스 모니터링
SnipTool	HISTORY_SNIP	대화 히스토리 잘라내기/축소
ListPeersTool	UDS_INBOX	Unix 도메인 소켓 피어 탐색
RemoteTriggerTool	AGENT_TRIGGERS_REMOTE	원격 에이전트 트리거
TungstenTool	ant 전용	내부 성능 모니터링 패널
VerifyPlanExecutionTool	VERIFY_PLAN env	계획 실행 검증
OverflowTestTool	OVERFLOW_TEST_TOOL	컨텍스트 오버플로우 테스트
SubscribePRTool	KAIROS_GITHUB_WEBHOOKS	GitHub PR 웹훅 구독

5. Coordinator 모드

멀티 에이전트 조율 시스템:

// src/coordinator/coordinatorMode.ts
// Feature flag: COORDINATOR_MODE

공유 상태와 메시징을 통한 다수 에이전트 간 조율된 작업 실행을 지원한다.

6. Buddy 시스템 (가상 펫)

완전한 펫 동반자 시스템이 구현되어 있으나 아직 출시되지 않았다:

• 18종: duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk
• 5단계 희귀도: Common (60%), Uncommon (25%), Rare (10%), Epic (4%), Legendary (1%)
• 7종 모자: crown, tophat, propeller, halo, wizard, beanie, tinyduck
• 5가지 스탯: DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK
• 1% 반짝이 확률: 모든 종의 Sparkle 변형
• 결정론적 생성: 사용자 ID 해시 기반

출처: src/buddy/

7. Dream Task

백그라운드 기억 통합 서브에이전트:

// src/tasks/DreamTask/
// 백그라운드에서 동작하는 자동 드리밍 기능
// 'tengu_onyx_plover' feature flag로 제어

유휴 시간 중 AI가 자율적으로 기억을 처리하고 통합할 수 있게 한다.

요약: 세 가지 방향

1. 신규 모델: Numbat (차기), Opus 4.7, Sonnet 4.8 개발 중
2. 자율 에이전트: KAIROS 모드 — 무인 운영, 선제적 행동, 푸시 알림
3. 멀티모달: 음성 입력 준비 완료, 브라우저 도구 대기 중, 워크플로우 자동화 예정

Claude Code는 코딩 어시스턴트에서 상시 가동 자율 개발 에이전트로 진화하고 있다.