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

(code.claude.com)

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에서 실행

세 가지 실행 방식 지원:
- 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 인터페이스를 점유하므로 동시 사용 불가)

/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 명령어를 상단에 출력