Claude Code의 Ultraplan 해설 — 클라우드에서 계획하고, 원하는 곳에서 실행하기

서론: 플랜 모드(Plan Mode)의 장벽

Claude Code의 **플랜 모드 (Plan Mode)**를 사용해 본 적이 있는 분들은 많을 것입니다. 구현 전에 파일 구성이나 방침을 정리하고, 승인한 뒤에 착수한다. 합리적인 워크플로우입니다. 하지만, 이런 상황에서 막히지 않나요?

계획에 10분이 걸리는데, 그동안 터미널을 사용할 수 없다. Web UI로 코멘트를 달거나, 팀원들에게 보여줄 수 있다면 좋을 텐데.

로컬의 플랜 모드는 '계획'과 '실행'이 동일한 터미널에 갇혀 있습니다. 계획 중에는 다른 작업을 할 수 없고, 리뷰도 텍스트 기반의 주고받기로 제한됩니다. 이 장벽을 허무는 것이 Ultraplan입니다.

한마디로 요약하자면, Ultraplan은 다음과 같은 기능입니다.

Ultraplan은 Claude Code의 계획 단계(Planning Phase)를 클라우드로 옮겨, 풍부한 Web 에디터에서 리뷰 및 편집한 후, 클라우드나 로컬 중 원하는 곳에서 실행할 수 있는 기능입니다.

로컬 플랜 모드가 "빠름·간편함·터미널 점유"인 반면, Ultraplan은 "심도 있음·시각적·터미널 해방"이라는 위치를 차지합니다.

핵심은 「계획과 실행의 분리」

이 섹션에서는 로컬 플랜 모드의 한계가 무엇인지, 그리고 Ultraplan이 그것을 어떻게 해결하는지 정리합니다.

로컬 플랜 모드에서는 계획의 작성·리뷰·실행이 모두 동일한 터미널 세션에서 완결됩니다. 간편하지만, 계획이 커질수록 다음과 같은 문제가 발생합니다.

터미널 점유: 계획을 짜는 동안 다른 작업을 할 수 없음 -
리뷰 경험의 한계: 텍스트 기반의 주고받기로는 특정 섹션에 대한 부분적인 피드백을 하기 어려움 -
공유의 장벽: 팀원에게 계획을 보여주고 의견을 구할 수단이 없음

Ultraplan은 이를 클라우드에서 계획 → Web에서 리뷰 → 실행 장소 선택이라는 3단계로 해결합니다.

메커니즘: 클라우드 계획 → Web 리뷰 → 실행

/ultraplan을 실행하면 다음과 같은 흐름이 클라우드상에서 동작합니다.

CLI로부터 프롬프트 전송
↓
【클라우드 계획 단계】
...

로컬 플랜 모드와의 비교

"평소 쓰던 플랜 모드로 충분하지 않을까?"라고 생각할 수도 있습니다. 판단 기준은 변경의 규모와 리뷰의 필요성입니다.

로컬 플랜 모드	Ultraplan
계산 장소	로컬 터미널
...	...

로컬 플랜 모드가 적합한 상황: 소~중규모의 변경, 즉시 구현에 들어가고 싶을 때, 오프라인에서 작업하고 싶을 때.

Ultraplan이 적합한 상황: 대규모 리팩터링(Refactoring)의 방침 결정, 여러 접근 방식의 비교 검토, 팀원에게 계획을 보여주고 피드백을 받고 싶을 때.

사용법

여기서는 기동부터 리뷰·실행까지의 일련의 조작을 4단계로 설명합니다.

Step 1: Ultraplan 기동하기

기동 방법은 3가지가 있습니다.

방법	예
슬래시 명령어	/ultraplan 인증 모듈을 리팩터링해줘
...	...

슬래시 명령어든 키워드든 동작은 같습니다. 프롬프트에 "ultraplan"을 포함하는 것만으로 클라우드 세션이 시작됩니다.

Step 2: 상태 확인하기

클라우드에서 계획이 진행되는 동안, CLI에는 상태가 표시됩니다.

상태	의미
◇ ultraplan	리서치·계획 초안 작성 중
◇ ultraplan needs your input	질문 있음. 입력 대기 중
◆ ultraplan ready	계획 완료. 리뷰 가능

완료되면 알림이 오므로, 세션 URL을 열어 리뷰로 진행합니다.

Step 3: Web에서 리뷰·코멘트하기

브라우저에서 세션 URL을 열면 계획이 Web 에디터에 표시됩니다. 로컬의 텍스트 기반 주고받기와는 달리, 다음과 같은 조작이 가능합니다.

인라인 코멘트 (Inline Comment): 계획의 특정 섹션에 직접 코멘트를 달아 핀포인트로 수정 지시 -
이모지 반응: 각 섹션에 승인·우려를 시그널링 -
아웃라인 사이드바: 계획 전체의 구조를 네비게이션

Step 4: 실행 옵션 선택하기

계획이 만족스럽다면, 먼저 클라우드에서 실행할지 아니면 로컬로 되돌릴지를 선택합니다.

선택	설명	적합한 케이스
클라우드에서 실행	클라우드 세션에서 그대로 구현하고 PR을 생성	GitHub 상에서 완결되는 변경
터미널로 텔레포트	계획을 로컬로 다시 보냄	로컬 환경에 의존성이 있는 변경

"텔레포트"를 선택하면, 터미널 측에서 추가로 3가지 선택지가 표시됩니다.

서브 선택지	설명
Implement here	현재 세션에서 계획을 실행
...

요구사항 및 제약 사항

도입 전에 확인해야 할 버전, 인증, 환경 조건을 정리합니다. Ultraplan은 Ultrareview와 마찬가지로 "Claude Code on the web" 인프라 위에서 동작하기 때문에 환경에 제약이 있습니다.

버전 요구사항

조건	최소 버전
기본 동작	v2.1.91
클라우드 환경 자동 생성	v2.1.101 (권장)

이용 가능한 환경

환경	이용 가능 여부
Claude.ai 직접 인증 (Pro / Max)	이용 가능
...

기타 요구사항

• GitHub에 호스팅된 리포지토리(Repository)가 필요
• Claude Code on the web 계정이 필요

"ultra" 패밀리의 전체 모습

Ultraplan 외에도 "ultra"라는 이름이 붙은 기능이 2개 더 있습니다. 어떤 것을 언제 사용할지에 대한 판단 기준을 정리합니다.

기능	목적	단계	실행 장소
ultraplan	설계·계획	구현 착수 전	클라우드
ultracode	멀티 에이전트 (Multi-agent) 실행	구현 중	로컬
ultrareview	딥 코드 리뷰 (Deep Code Review)	머지(Merge) 전	클라우드

ultracode와의 차이점

ultracode는 다이내믹 워크플로 (Dynamic Workflow)를 사용하여 최대 1,000개의 에이전트를 실행하는 기능입니다 (동시 병렬은 최대 16개). 대규모 구현 태스크를 위한 것으로, 계획이 아닌 실행을 담당합니다.

"ultraplan으로 설계 → ultracode로 대규모 구현 → ultrareview로 최종 확인"이라는 흐름이 ultra 패밀리가 상정하는 개발 사이클입니다.

실전 Tips

Ultraplan을 효과적으로 사용하기 위한 구체적인 패턴을 소개합니다.

대규모 리팩터링(Refactoring)의 방침 결정

여러 가지 접근 방식(단계적 이행 vs. 일괄 교체, 라이브러리 A vs. B)을 비교하고 싶을 때, Ultraplan으로 각 안의 장단점을 나열하여 계획하고, Web UI를 통해 팀원들에게 코멘트를 받으면 방침 결정이 훨씬 매끄러워집니다.

로컬 플랜에서의 승격

처음에는 로컬의 플랜 모드에서 가볍게 뼈대를 만들고, "이것은 더 깊이 있는 탐구가 필요하다"고 판단되면 클라우드로 승격하는 단계적인 접근 방식도 유효합니다.

계획의 저장 및 재사용

취소(Cancel)를 선택하면 계획이 파일로 저장됩니다. 훗날의 세션에서 해당 파일을 참조하며 구현에 착수하거나, 다른 문맥에서 계획을 재사용할 수 있습니다.

트러블슈팅

Ultraplan 이용 시 자주 발생하는 문제와 대처법을 정리합니다.

증상	원인	대처
/ultraplan이 Unknown command로 나타남	Claude Code 버전이 낮거나, Vertex AI / Bedrock을 통해 이용 중임	claude --version으로 v2.1.91 이상인지 확인. 클라우드 제공업체(Cloud Provider)를 통해 이용하는 경우 Ultraplan 자체가 비활성화되므로, Claude.ai 직접 인증으로 전환
클라우드 세션이 시작되지 않음	Claude Code on the web 계정이 설정되지 않았거나, GitHub 리포지토리가 아님	Claude.ai 계정에 로그인되어 있는지 확인 (claude 명령어로 인증 상태 확인 가능). 로컬 전용 리포지토리는 GitHub에 푸시한 후 실행
계획이 도중에 멈춤 (needs your input 상태 유지)	Claude가 구현 방침에 대해 판단할 수 없어 질문하는 중임	세션 URL을 브라우저에서 열고 질문에 답변함
텔레포트(Teleport) 후 로컬에 계획이 반영되지 않음	CLI 세션이 종료됨	텔레포트는 실행 중인 CLI 세션으로 계획을 다시 보냅니다. 세션을 닫았다면, 저장된 계획 파일을 새로운 세션에서 불러오십시오

요약

Ultraplan은 Claude Code의 계획 단계(Planning phase)를 클라우드로 옮겨, 풍부한 Web 에디터에서 리뷰한 후 원하는 곳에서 실행할 수 있는 기능입니다.

로컬 플랜 모드(Local plan mode)와의 위치를 정리하면 다음과 같습니다:

로컬 플랜 모드: 간편하고 빠름. 소〜중규모 변경에 적합
Ultraplan: 깊이 있고 시각적임. 대규모 설계 및 팀 리뷰에 적합

ultra 패밀리 전체의 개발 흐름은 다음과 같은 사이클로 이루어집니다.

설계 → ultraplan으로 계획을 리뷰
↓
구현 → ultracode로 대규모 병렬 실행 (또는 일반적인 구현)
...

리서치 프리뷰(Research preview) 단계이지만, Pro / Max 사용자는 지금 바로 시도해 볼 수 있습니다. 큰 변경을 하기 전에 /ultraplan으로 계획을 세워보세요.

Discussion