Claude Code Ultraplan 완벽 가이드: 클라우드에서 계획하고 원하는 곳에서 실행하기

Claude Code Ultraplan은 CLI의 plan mode를 클라우드로 확장한 기능으로, Opus 4.6이 최대 30분간 코드베이스를 병렬 탐색하여 구조화된 구현 계획을 생성하고 브라우저에서 섹션별 리뷰를 가능하게 합니다.

Claude Code를 사용하는 개발자라면 plan mode를 이미 알고 있을 것입니다. 복잡한 작업 전에 AI가 계획을 세우고 승인을 받는 방식이죠. 하지만 plan mode에는 두 가지 불편함이 있었습니다. 계획을 생성하는 동안 터미널을 사용할 수 없고, 피드백은 전체 계획에 대해서만 가능했습니다.

2026년 4월 출시된 Ultraplan은 이 문제를 근본적으로 해결합니다. 계획 생성을 클라우드로 옮겨 터미널을 자유롭게 쓸 수 있고, 브라우저에서 섹션별 코멘트와 수정 요청이 가능합니다.

Ultraplan이란 무엇인가

Claude Code Ultraplan은 CLI의 계획 작업을 Claude Code on the Web 세션(plan mode)으로 넘기는 새로운 기능입니다. 현재 Research preview 상태이며, Claude Code v2.1.91 이상에서 사용할 수 있습니다.

핵심 동작 방식은 다음과 같습니다:

1. 터미널에서 Ultraplan을 요청합니다
2. Opus 4.6 모델이 클라우드에서 코드베이스를 병렬 에이전트로 탐색합니다
3. 최대 30분간 구조화된 구현 계획을 생성합니다
4. 브라우저(code.claude.com)에서 계획을 리뷰합니다
5. 웹에서 바로 구현하거나, 터미널로 텔레포트할 수 있습니다

opusplan 모델과의 관계: /model opusplan은 로컬에서 Plan mode에 Opus를, 실행에 Sonnet을 자동 전환하는 설정입니다. Ultraplan은 이를 클라우드로 확장한 것으로, 계획은 클라우드 Opus 세션에서, 실행 위치는 사용자가 선택합니다.

Ultraplan이 해결하는 3가지 문제

1. Targeted Feedback (섹션별 피드백)

기존 plan mode에서는 계획 전체에 대해서만 "승인/거절"할 수 있었습니다. Ultraplan은 브라우저에서 각 섹션에 인라인 코멘트를 달고, 이모지 반응을 남기고, 특정 부분만 수정 요청할 수 있습니다.

"인증 모듈 부분만 다시 작성해줘"처럼 세밀한 피드백이 가능해진 것입니다.

2. Hands-off Drafting (비동기 계획 생성)

Ultraplan은 클라우드에서 계획을 생성하므로, 그 동안 터미널은 자유롭게 사용할 수 있습니다. 다른 브랜치에서 버그를 고치거나, 테스트를 실행하거나, 코드를 작성할 수 있죠.

3. Flexible Execution (유연한 실행)

계획이 완성되면 두 가지 실행 경로를 선택할 수 있습니다:

• 웹에서 구현: 클라우드에서 바로 코드를 작성하고 PR을 자동 생성
• 터미널로 텔레포트: 계획만 로컬로 가져와서 원하는 환경에서 실행

Ultraplan 시작하기

전제 조건

3가지 실행 방법

방법 1: /ultraplan 커맨드

/ultraplan 인증 시스템을 JWT에서 세션 기반으로 마이그레이션해줘

가장 직관적인 방법입니다. 슬래시 커맨드로 바로 Ultraplan을 시작합니다.

방법 2: 프롬프트에 키워드 포함

ultraplan으로 데이터베이스 스키마 리팩토링 계획을 세워줘

일반 프롬프트에 "ultraplan" 키워드만 넣으면 자동으로 Ultraplan 모드가 활성화됩니다.

방법 3: Plan mode에서 전환

로컬 plan mode에서 계획이 생성된 후, 승인 다이얼로그에서 **"No, refine with Ultraplan"**을 선택하면 해당 계획이 클라우드로 전송되어 Ultraplan으로 전환됩니다.

실전 워크플로우: 터미널에서 브라우저까지

Step 1: Ultraplan 요청

터미널에서 /ultraplan <프롬프트>를 입력하면, 상태 표시가 시작됩니다:

• ◇ ultraplan — 코드베이스 탐색 + 계획 초안 작성 중
• ◇ ultraplan needs your input — 확인 질문 있음 (터미널에서 응답)
• ◆ ultraplan ready — 브라우저에서 리뷰 가능

Step 2: 브라우저 리뷰

ultraplan ready 상태가 되면 code.claude.com에서 계획이 열립니다. 여기서 할 수 있는 것들:

• 인라인 코멘트: 특정 섹션에 질문이나 수정 요청
• 이모지 반응: 좋은 부분에 빠른 피드백
• 섹션별 수정: "이 부분만 다시 써줘" 요청

Step 3: 실행 위치 선택

리뷰가 완료되면 두 가지 선택지가 나타납니다:

Option A — 웹에서 실행 "Approve Claude's plan and start coding"을 선택하면, 클라우드에서 계획대로 코드를 구현하고 자동으로 PR을 생성합니다.

Option B — 터미널로 텔레포트 "Approve plan and teleport back to terminal"을 선택하면, 계획이 터미널로 전송됩니다. 터미널에서 다시 세 가지 선택이 가능합니다:

• Implement here (현재 세션에서 구현)
• Start new session (새 세션에서 구현)
• Cancel (취소)

Plan Mode vs Ultraplan 비교

내부 동작: 병렬 에이전트 탐색

Ultraplan은 단순히 계획을 세우는 것이 아닙니다. 소스 코드 분석에 따르면, 내부적으로 병렬 에이전트 3개가 동시에 코드베이스를 탐색합니다:

1. 아키텍처 분석 에이전트 — 프로젝트 구조, 의존성, 패턴 파악
2. 수정 대상 파일 탐색 에이전트 — 변경이 필요한 파일과 함수 식별
3. 리스크/엣지 케이스 식별 에이전트 — 잠재적 문제와 호환성 이슈 감지

이 병렬 탐색 후, Critique 에이전트가 생성된 계획을 한 번 더 리뷰하고 피드백을 반영합니다. 30분 타임아웃(ULTRAPLAN_TIMEOUT_MS = 30 * 60 * 1000)이 설정되어 있습니다.

실전 팁: Ultraplan 품질 높이기

Steve Kinney의 실전 경험에서 가져온 핵심 팁입니다:

CLAUDE.md 정리가 핵심

Ultraplan의 계획 품질은 CLAUDE.md(프로젝트 설정 파일)의 품질에 직결됩니다. 프로젝트 구조, 컨벤션, 중요한 패턴이 명확하게 기술되어 있을수록 더 정확한 계획이 나옵니다.

프롬프트를 구체적으로

"리팩토링해줘"보다 "인증 모듈을 JWT에서 세션 기반으로 마이그레이션하되, 기존 API 호환성을 유지해줘"처럼 구체적인 맥락과 제약 조건을 포함하세요.

브라우저 리뷰를 적극 활용

Ultraplan의 가장 큰 장점은 섹션별 피드백입니다. 전체를 다시 생성하기보다, 문제가 있는 부분만 코멘트로 수정 요청하는 것이 효율적입니다.

주의사항과 한계

• Research preview: 현재 프리뷰 상태이므로 동작이나 기능이 변경될 수 있습니다
• GitHub 필수: GitHub 리포지토리가 연결되어 있어야 작동합니다
• 클라우드 제한: Bedrock, Vertex AI, Foundry 인프라에서는 사용할 수 없습니다
• Remote Control 동시 사용 불가: 같은 claude.ai/code 인터페이스를 사용하므로 Remote Control과 동시에 쓸 수 없습니다
• 로컬 환경 제한: 클라우드 세션이므로 로컬 파일 시스템 직접 접근에 제한이 있습니다

자주 묻는 질문 (FAQ)

Ultraplan은 무료인가요?

Claude Code on the Web 계정이 필요합니다. Pro, Max, Team, Enterprise 플랜에서 사용 가능하며, 별도 추가 비용은 없습니다.

Plan mode를 쓰고 있었는데 전환해야 하나요?

반드시 전환할 필요는 없습니다. 간단한 계획은 로컬 plan mode가 더 빠릅니다. 복잡한 리팩토링이나 대규모 기능 개발처럼 계획 생성에 시간이 오래 걸리는 경우에 Ultraplan이 적합합니다.

opusplan과 어떤 차이가 있나요?

/model opusplan은 로컬에서 Plan 단계에 Opus, 실행에 Sonnet을 자동 전환하는 모델 설정입니다. Ultraplan은 계획 자체를 클라우드로 옮겨 비동기 실행과 브라우저 리뷰를 가능하게 한 것으로, opusplan의 클라우드 확장판입니다.

Windows에서도 사용 가능한가요?

네, 사용 가능합니다. 다만 Windows에서 plan mode 위반 버그가 보고된 사례가 있으므로(GitHub #43576), 이슈 발생 시 최신 버전으로 업데이트하세요.

30분 타임아웃이 지나면 어떻게 되나요?

30분 내에 계획 생성이 완료되지 않으면 세션이 종료됩니다. 대부분의 프로젝트에서 10-15분 내에 완료되지만, 매우 큰 모노레포의 경우 시간이 더 걸릴 수 있습니다.

마무리

Claude Code Ultraplan은 plan mode의 진화입니다. 핵심 가치를 한 문장으로 정리하면: 코딩은 터미널에서 계속하고, AI가 클라우드에서 설계를 하고, 리뷰는 브라우저에서 세밀하게, 실행은 원하는 곳에서.

지금 claude --version으로 v2.1.91 이상인지 확인하고, /ultraplan을 입력해보세요. 복잡한 작업일수록 효과가 큽니다.

참고 자료

• Claude Code Ultraplan 공식 문서
• Claude Code 모델 설정 문서
• Steve Kinney - Claude Ultraplan 실전 가이드
• AI Productivity - Ultraplan Planning Mode