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


# 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 미지원

### 실행 방법

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

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

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

## 내부 동작: 병렬 에이전트

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

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

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

## Plan Mode vs Ultraplan

| 항목 | Plan Mode | Ultraplan |
|------|-----------|-----------|
| 계획 생성 | 터미널 (동기) | 클라우드 (비동기) |
| 터미널 | 차단됨 | 자유 |
| 피드백 | 전체 승인/거절 | 섹션별 코멘트 |
| 실행 | 터미널만 | 웹 또는 터미널 |
| 타임아웃 | 없음 | 30분 |

## 실전 팁

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

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

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

## 마무리

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

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

---

*출처: [Claude Code Ultraplan 공식 문서](https://code.claude.com/docs/en/ultraplan)*