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

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

2026년 4월 출시된 Ultraplan은 이 문제를 근본적으로 해결합니다.

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. 웹에서 구현하거나 터미널로 텔레포트

3가지 핵심 장점

Targeted Feedback

기존 plan mode: 전체 계획 승인/거절만 가능 Ultraplan: 섹션별 인라인 코멘트, 이모지 반응, 부분 수정 요청

Hands-off Drafting

계획 생성이 클라우드에서 진행되므로 터미널은 자유롭게 사용 가능합니다.

Flexible Execution

• 웹에서 구현 → PR 자동 생성
• 터미널로 텔레포트 → 로컬에서 실행

시작하기

전제 조건

• Claude Code v2.1.91+
• code.claude.com 계정 (Pro/Max/Team/Enterprise)
• GitHub 리포지토리 연결
• Bedrock/Vertex AI/Foundry 미지원

실행 방법

# 방법 1: 슬래시 커맨드
/ultraplan 인증 시스템을 JWT에서 세션 기반으로 마이그레이션해줘

# 방법 2: 키워드 포함
ultraplan으로 데이터베이스 스키마 리팩토링 계획을 세워줘

# 방법 3: Plan mode에서 전환
# 승인 다이얼로그에서 "No, refine with Ultraplan" 선택

내부 동작: 병렬 에이전트

30분 타임아웃 내에 3개 병렬 에이전트가 동시 동작합니다:

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

이후 Critique 에이전트가 계획을 한 번 더 리뷰합니다.

Plan Mode vs Ultraplan

실전 팁

CLAUDE.md 정리: 프로젝트 구조, 컨벤션, 패턴이 명확할수록 계획 품질 향상

구체적 프롬프트: "리팩토링해줘"보다 "인증 모듈을 JWT에서 세션 기반으로 마이그레이션, API 호환성 유지" 수준의 구체성

섹션별 피드백 활용: 전체 재생성보다 문제 부분만 코멘트로 수정 요청

마무리

Ultraplan은 plan mode의 클라우드 확장판입니다. 코딩은 터미널에서, 계획은 클라우드에서, 리뷰는 브라우저에서, 실행은 원하는 곳에서.

복잡한 리팩토링이나 대규모 기능 개발에서 특히 효과적입니다.

---

출처: Claude Code Ultraplan 공식 문서