# Claude Code /Ultraplan : 클라우드 기반 계획 수립 도구

> Clean Markdown view of GeekNews topic #28410. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=28410](https://news.hada.io/topic?id=28410)
- GeekNews Markdown: [https://news.hada.io/topic/28410.md](https://news.hada.io/topic/28410.md)
- Type: GN+
- Author: [neo](https://news.hada.io/@neo)
- Published: 2026-04-11T11:16:03+09:00
- Updated: 2026-04-11T11:16:03+09:00
- Original source: [code.claude.com](https://code.claude.com/docs/en/ultraplan)
- Points: 5
- Comments: 0

## Topic Body

- CLI에서 시작한 계획 작업을 클라우드로 넘겨 **클로드 코드 웹**에서 초안을 작성하고, 브라우저에서 검토·수정 후 웹 또는 로컬 터미널 중 원하는 곳에서 실행하는 워크플로를 제공  
- 터미널을 점유하지 않고 **원격에서 계획을 생성**하므로, 초안 작성 중에도 로컬 작업을 계속할 수 있음  
- 브라우저 검토 화면에서 **인라인 코멘트, 이모지 반응, 섹션별 아웃라인**을 통해 전체가 아닌 특정 섹션에 대한 피드백 제공 가능  
- 실행 위치를 브라우저에서 선택할 수 있으며, 웹에서 바로 구현 후 **풀 리퀘스트 생성**하거나 터미널로 계획을 돌려보내 로컬에서 실행하는 두 가지 경로 지원  
- Claude Code v2.1.91 이상 및 **Claude Code on the web 계정과 GitHub 저장소**가 필요하며, Amazon Bedrock·Google Cloud Vertex AI·Microsoft Foundry 환경에서는 사용 불가 (**리서치 프리뷰** 단계)  
  
---  
  
### Ultraplan 개요 및 작동 방식  
  
- 로컬 CLI의 계획 작업을 **Claude Code on the web**의 plan mode 세션으로 위임하는 기능  
- Claude가 클라우드에서 계획 초안을 작성하는 동안, 로컬 터미널은 다른 작업에 자유롭게 사용 가능  
- 계획이 완성되면 브라우저에서 열어 특정 섹션에 코멘트, 수정 요청, 실행 위치 선택 가능  
- 주요 장점 세 가지:  
  - **Targeted feedback**: 전체 답변 대신 계획의 개별 섹션에 코멘트 가능  
  - **Hands-off drafting**: 원격 생성으로 터미널이 자유로움  
  - **Flexible execution**: 웹에서 구현 후 PR 생성 또는 터미널로 복귀 중 선택  
  
### 요구 사항 및 제한  
  
- Claude Code **v2.1.91 이상** 필요 (리서치 프리뷰 단계)  
- Claude Code on the web 계정 및 **GitHub 저장소** 필수  
- Anthropic 클라우드 인프라에서 실행되므로 **Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry** 환경에서는 사용 불가  
- 클라우드 세션은 계정의 기본 cloud environment에서 실행  
  
### CLI에서 Ultraplan 실행 방법  
  
- 세 가지 실행 방식 지원:  
  - **Command**: `/ultraplan` 뒤에 프롬프트 입력 (예: `/ultraplan migrate the auth service from sessions to JWTs`)  
  - **Keyword**: 일반 프롬프트에 `ultraplan` 단어 포함  
  - **From a local plan**: 로컬 플랜 완료 후 승인 다이얼로그에서 "No, refine with Ultraplan on Claude Code on the web" 선택  
- Command·Keyword 방식은 실행 전 **확인 다이얼로그** 표시, 로컬 플랜 경로는 이미 선택 자체가 확인으로 간주되어 다이얼로그 생략  
- **Remote Control**이 활성화된 경우 ultraplan 시작 시 연결 해제됨 (두 기능이 동일한 claude.ai/code 인터페이스를 점유하므로 동시 사용 불가)  
  
### CLI 상태 표시  
  
- 클라우드 세션 실행 중 터미널 프롬프트 입력창에 상태 인디케이터 표시:  
  
| 상태 | 의미 |  
|---|---|  
| `◇ ultraplan` | 코드베이스 분석 및 계획 초안 작성 중 |  
| `◇ ultraplan needs your input` | Claude가 명확화 질문 있음; 세션 링크에서 응답 필요 |  
| `◆ ultraplan ready` | 계획 완성, 브라우저에서 검토 가능 |  
  
- `/tasks` 실행 후 ultraplan 항목 선택 시 세션 링크, 에이전트 활동, **Stop ultraplan** 액션이 포함된 상세 뷰 표시  
- 중단 시 클라우드 세션이 아카이브되고 인디케이터가 초기화되며, 터미널에는 아무것도 저장되지 않음  
  
### 브라우저에서 계획 검토 및 수정  
  
- 상태가 `◆ ultraplan ready`로 변경되면 세션 링크를 통해 claude.ai에서 계획 열람 가능  
- 전용 리뷰 화면에서 제공되는 기능:  
  - **Inline comments**: 특정 구절을 하이라이트 후 Claude에게 코멘트 남기기  
  - **Emoji reactions**: 전체 코멘트 없이 섹션에 승인 또는 우려 표시  
  - **Outline sidebar**: 계획 섹션 간 빠른 이동  
- Claude가 코멘트를 반영해 계획을 수정하고 업데이트된 초안 제시  
- 실행 위치 결정 전까지 **반복적으로 수정 가능**  
  
### 실행 위치 선택  
  
#### 웹에서 실행  
- 브라우저에서 **"Approve Claude's plan and start coding"** 선택 시 동일한 Claude Code on the web 세션에서 바로 구현 시작  
- 터미널에 확인 메시지 표시 및 상태 인디케이터 초기화  
- 구현 완료 후 웹 인터페이스에서 **diff 검토 및 풀 리퀘스트 생성** 가능  
  
#### 터미널로 복귀해 로컬 실행  
- 브라우저에서 **"Approve plan and teleport back to terminal"** 선택 시 로컬 환경에 완전한 접근 권한으로 계획 구현  
- CLI에서 세션을 시작했고 터미널이 아직 폴링 중인 경우에만 표시되는 옵션  
- 웹 세션은 아카이브되어 병렬로 계속 실행되지 않음  
- 터미널에 **"Ultraplan approved"** 다이얼로그와 함께 세 가지 옵션 제공:  
  - **Implement here**: 현재 대화에 계획을 주입하고 이어서 진행  
  - **Start new session**: 현재 대화를 초기화하고 계획만을 컨텍스트로 새 세션 시작  
  - **Cancel**: 계획을 파일로 저장 (실행 없음); Claude가 파일 경로 출력  
- 새 세션 시작 시, 이전 대화로 복귀할 수 있도록 `claude --resume` 명령어를 상단에 출력

## Comments



_No public comments on this page._