이 글은 Claude Code 환경에서 제공되는 Ultraplan 기능을 중심으로, 로컬 CLI와 웹 환경을 넘나들며 계획을 수립하고 실행하는 새로운 개발 워크플로우를 정리합니다. Ultraplan이 왜 등장했는지, 어떤 방식으로 동작하는지, 그리고 기존 터미널 중심 작업과 비교해 어떤 장점이 있는지를 단계별로 설명합니다. 특히 복잡한 계획을 보다 정교하게 검토하고 싶을 때 Ultraplan이 어떤 가치를 제공하는지에 초점을 맞춥니다.
Ultraplan이란 무엇인가
Ultraplan은 로컬 CLI에서 시작한 계획 수립 작업을 클라우드 환경의 Claude Code on the web으로 넘겨, 웹에서 계획을 작성·검토·수정한 뒤 다시 실행 위치를 선택할 수 있게 해주는 기능입니다.
이 기능은 연구 프리뷰 단계에 있으며, Claude Code v2.1.91 이상이 필요합니다. 사용자 피드백에 따라 동작 방식이나 기능은 변경될 수 있습니다. Ultraplan은 로컬 터미널의 작업 흐름을 방해하지 않으면서도, 웹이 제공하는 넓은 검토 화면과 상호작용을 활용할 수 있도록 설계되었습니다.
등장 배경과 필요성
터미널 환경은 빠르고 효율적이지만, 긴 계획이나 구조적인 설계 문서를 검토하기에는 제약이 있습니다. Ultraplan은 이러한 한계를 보완하기 위해 다음과 같은 상황을 염두에 두고 만들어졌습니다.
- 계획 전체가 아닌 특정 섹션에 대해 세밀한 피드백이 필요한 경우
- 계획 초안은 자동으로 생성하되, 개발자는 다른 작업을 병행하고 싶은 경우
- 계획을 바로 실행할지, 웹에서 먼저 검토할지 유연하게 결정하고 싶은 경우
Ultraplan은 계획 수립을 클라우드로 분리함으로써, 터미널은 자유롭게 유지하고 계획 검토는 보다 풍부한 UI에서 진행할 수 있도록 합니다.
Ultraplan의 주요 특징
Ultraplan의 핵심 특장점은 다음 세 가지로 정리할 수 있습니다.
1. 타겟형 피드백
웹 리뷰 화면에서는 계획의 특정 문단을 선택해 인라인 댓글을 남길 수 있습니다. 전체 계획에 대한 일괄 응답이 아니라, 필요한 부분만 정확히 짚어 수정 요청이 가능합니다.
2. 원격 초안 작성
계획은 클라우드에서 생성되므로, 로컬 터미널은 다른 작업에 계속 사용할 수 있습니다. 계획 수립이 끝날 때까지 기다릴 필요가 없습니다.
3. 유연한 실행 선택
검토가 끝난 계획은
- 웹에서 바로 실행해 코드 변경 후 Pull Request를 생성하거나
- 다시 로컬 터미널로 보내 기존 작업 흐름에서 실행할 수 있습니다.
상황에 따라 실행 위치를 선택할 수 있다는 점이 큰 차별점입니다.
Ultraplan 사용을 위한 사전 조건
Ultraplan을 사용하려면 몇 가지 전제 조건이 필요합니다.
- Claude Code on the web 계정
- GitHub 저장소
- Anthropic의 클라우드 인프라 사용 환경
이 기능은 클라우드 기반으로 동작하기 때문에 Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry 환경에서는 사용할 수 없습니다. 클라우드 세션은 계정의 기본 클라우드 환경에서 실행됩니다.
CLI에서 Ultraplan 실행 방법
로컬 CLI에서 Ultraplan을 시작하는 방법은 세 가지입니다.
- 명령어 방식
/ultraplan 뒤에 바로 프롬프트를 입력합니다.
예:
/ultraplan migrate the auth service from sessions to JWTs - 키워드 방식
일반 프롬프트 안에 ultraplan이라는 단어를 포함하면 자동으로 인식됩니다. - 로컬 플랜에서 전환
로컬에서 계획을 생성한 뒤 승인 대화상자에서
No, refine with Ultraplan on Claude Code on the web을 선택하면 클라우드로 전송됩니다.
명령어와 키워드 방식은 실행 전 확인 대화상자가 표시되며, 로컬 플랜에서 전환하는 방식은 이미 사용자의 선택이 확인이므로 대화상자가 생략됩니다.
실행 상태와 진행 흐름 이해하기
Ultraplan이 실행되면 CLI에는 상태 표시가 나타납니다.
- ◇ ultraplan : 코드베이스를 분석하며 계획을 작성 중
- ◇ ultraplan needs your input : 추가 질문이 있어 웹 세션에서 응답 필요
- ◆ ultraplan ready : 계획 검토 준비 완료
/tasks 명령을 통해 Ultraplan 항목을 선택하면 세션 링크, 에이전트 활동, 중지 옵션을 확인할 수 있습니다. 중지 시 클라우드 세션은 아카이브되며, 터미널에는 아무 것도 저장되지 않습니다.
웹에서 계획 검토 및 수정
상태가 ready로 바뀌면 claude.ai에서 전용 리뷰 화면으로 계획을 확인할 수 있습니다. 이 화면에서는 다음 기능을 제공합니다.
- 문단 단위 인라인 댓글
- 이모지 반응을 통한 간단한 승인 또는 우려 표현
- 아웃라인 사이드바를 통한 섹션 이동
댓글을 기반으로 Claude에게 수정 요청을 하면, 새로운 초안이 생성됩니다. 이 과정은 원하는 만큼 반복할 수 있습니다.
실행 위치 선택과 후속 작업
계획이 만족스러우면 실행 위치를 선택합니다.
웹에서 실행
브라우저에서 Approve Claude’s plan and start coding을 선택하면, 동일한 클라우드 세션에서 구현이 진행됩니다. 완료 후 웹 인터페이스에서 변경 내역을 검토하고 Pull Request를 생성할 수 있습니다.
터미널로 되돌리기
Approve plan and teleport back to terminal을 선택하면 계획이 로컬로 전달됩니다. 터미널에서는 다음 옵션을 선택할 수 있습니다.
- Implement here: 현재 대화에 계획을 주입해 계속 진행
- Start new session: 계획만 컨텍스트로 새 세션 시작
- Cancel: 실행하지 않고 파일로 저장
새 세션을 시작하면 이전 대화로 돌아갈 수 있는 claude --resume 명령도 함께 제공됩니다.
Ultraplan은 단순한 자동 계획 생성 기능이 아니라, 계획 수립·검토·실행을 분리하고 연결하는 새로운 개발 흐름을 제안합니다. 터미널의 효율성과 웹의 가시성을 동시에 활용하고 싶은 개발자에게 특히 의미 있는 기능입니다.
앞으로 기능이 안정화되고 개선된다면, 복잡한 마이그레이션이나 구조적 리팩터링과 같은 작업에서 Ultraplan은 계획 품질을 높이고 협업 가능성을 확장하는 중요한 도구로 자리 잡을 수 있을 것으로 기대됩니다.
https://code.claude.com/docs/en/ultraplan
Plan in the cloud with ultraplan - Claude Code Docs
Start a plan from your CLI, draft it on Claude Code on the web, then execute it remotely or back in your terminal
code.claude.com
'인공지능' 카테고리의 다른 글
| Harness로 도메인 맞춤 Claude Code 에이전트 팀을 자동 설계하는 방법 (0) | 2026.04.14 |
|---|---|
| Cursor·Claude Code·OpenAI Codex로 재편되는 AI 코딩 도구 스택의 구조와 의미 (0) | 2026.04.13 |
| HyperAgents: AI 에이전트가 스스로 하네스를 설계하는 시대의 시작 (0) | 2026.04.13 |
| MiniMax M2.7 모델로 살펴보는 AI 자기진화와 차세대 에이전트 기술 (0) | 2026.04.13 |
| 로컬에서 작동하는 오픈소스 AI 동료, Rowboat 기술 개념과 활용 정리 (0) | 2026.04.10 |
