Claude Code 신기능 'Ultraplan' 리뷰 - 터미널 멈춤 없는 클라우드 플래닝(로컬 Plan Mode vs 클라우드 플래닝)
- -
안녕하세요! 갓대희 입니다.
오늘은 Claude Code의 새로운 클라우드 플래닝 기능 Ultraplan을 알아보자.

로컬 터미널에서 30분씩 멈춰 있던 플래닝 작업이 클라우드로 이동하고, 터미널은 자유를 되찾는다?? 라는 컨셉.
그리고 그 이면에는 "커스텀 skill을 쓰면 작동하지 않는다"는 치명적 버그가 숨어 있다.
약간 뜬구름 잡는 느낌일 것 같은데 하기 내용을 통해 살펴보자.
목차
- Ultra Plan / Ultraplan이란 무엇인가
- 시작하기: 가입, 설정, GitHub 연동
- 주요 기능 상세
- 아키텍처: 공개 정보 기반 추정
- 실전 사용 경험과 커뮤니티 반응
- 요금제 및 제한사항
- 대안 비교: Ultraplan vs 로컬 Plan Mode
- 트러블슈팅 Q&A + 결론
1. Ultra Plan / Ultraplan이란 무엇인가
핵심 한 줄: Ultraplan은 Claude Code의 플래닝 작업을 로컬 CLI에서 Claude Code on the web 클라우드 세션으로 오프로드하여, 터미널을 차단하지 않고 강력한 플래닝을 수행하는 기능이다. (출처: 공식 문서)
Claude Code를 쓰다 보면 plan mode에서 터미널이 수 분간 멈추는 경험을 한다. 복잡한 마이그레이션이나 대규모 리팩토링 작업일수록 이 "터미널 병목"은 더 심해진다.
공식 문서에 따르면, Ultraplan은 로컬 CLI에서 플래닝 작업을 Anthropic이 관리하는 클라우드 VM(Claude Code on the web)으로 넘긴다. 클라우드 세션은 plan mode로 실행되며, 그 사이 로컬 터미널은 완전히 자유롭다. 현재 research preview 단계이며, Claude Code v2.1.91 이상이 필요하다.
Ultraplan 실행 상태 모니터링
Ultraplan이 실행되면 CLI 프롬프트에 실시간 상태 표시가 나타난다. (출처: 공식 문서)
◇ ultraplan: Claude가 코드베이스를 분석하고 플랜을 작성 중◇ ultraplan needs your input: 확인이 필요한 질문이 있음 — 세션 링크에서 응답◆ ultraplan ready: 플랜 완성 — 브라우저에서 리뷰 가능
커뮤니티 추정: 플랜 모드 분류
일부 커뮤니티 분석에서는 Ultraplan 내부에 Simple Plan / Visual Plan / Deep Plan 등 복잡도별 모드가 존재한다고 추정하지만, 공식 문서에는 이러한 구분이 명시되어 있지 않다. 공식적으로 Ultraplan은 단일 plan mode 세션으로 설명된다.
Ultraplan과 Max Plan의 관계
"Ultra Plan"이라는 명칭은 두 가지 맥락에서 쓰인다. 하나는 Claude.ai의 유료 구독 플랜인 Max 플랜이고, 다른 하나는 Claude Code의 기능인 Ultraplan(/ultraplan 명령어)이다. 이 글에서는 후자, 즉 Claude Code의 기능에 초점을 맞춘다. Max 플랜의 요금 정보는 6절에서 다룬다.
⚠ 주의: Ultraplan은 공식적으로 research preview 단계이며, 동작과 기능이 피드백에 따라 변경될 수 있다. Claude Code v2.1.91 이상이 필요하며, Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry 환경에서는 사용할 수 없다. (출처: 공식 문서)
2. 시작하기: 가입, 설정, GitHub 연동
필수 조건
Ultraplan을 사용하려면 두 가지 조건이 필요하다.
- Claude.ai 계정: Pro, Max, Team, 또는 Enterprise 플랜 (Free 플랜 불가)
- GitHub 저장소 연동: Ultraplan은 클라우드 VM에서 저장소를 클론하므로 GitHub 연동이 필요하다 (비연동 시 로컬 번들 폴백 존재)
로컬에만 있는 저장소나 커밋되지 않은 변경사항이 많은 저장소에서는 불완전한 컨텍스트로 플랜이 생성될 수 있다.
Ultraplan을 실행하는 세 가지 방법
공식 문서에 따르면 Ultraplan 실행 방법은 세 가지다.
방법 1: 직접 명령어 입력
/ultraplan migrate the auth service from sessions to JWTs
방법 2: 프롬프트 내 키워드 감지
프롬프트 어디에든 "ultraplan"이라는 단어를 포함하면 자동으로 Ultraplan 모드가 활성화된다.
방법 3: 로컬 플랜 완료 후 전환
로컬 플랜 완료 후 승인 다이얼로그에서 "No, refine with Ultraplan on Claude Code on the web"을 선택하면, 로컬 플랜 초안을 클라우드로 보내 더 정교하게 다듬을 수 있다.
진행 중인 Ultraplan 세션 모니터링
Ultraplan 세션이 실행되는 동안 로컬 터미널에서 아래 명령어로 상태를 확인할 수 있다.
/tasks
목록에서 ultraplan 항목을 선택하면 세션 링크, 에이전트 활동, Stop 옵션이 포함된 상세 뷰가 열린다.
3. 주요 기능 상세
클라우드 플래닝 완료 후 실행 선택
⚠ Remote Control 해제: Ultraplan 시작 시 Remote Control이 활성화되어 있으면 자동으로 해제된다. 두 기능이 동일한 claude.ai/code 인터페이스를 점유하므로 동시에 사용할 수 없다. (출처: 공식 문서)
Ultraplan 플래닝이 완료되면 브라우저에서 두 가지 실행 경로를 선택한다.
- 브라우저에서 구현: "Approve Claude's plan and start coding" → 동일한 Claude Code on the web 세션에서 바로 구현 시작
- 터미널로 텔레포트: "Approve plan and teleport back to terminal" → 승인된 플랜이 로컬 터미널로 전달
터미널로 텔레포트를 선택하면, 로컬 CLI에 "Ultraplan approved" 다이얼로그가 표시되며 세 가지 후속 선택지가 제공된다. (출처: 공식 문서)
- Implement here: 현재 대화에 플랜을 주입하고 이어서 구현
- Start new session: 기존 대화를 비우고 플랜만으로 새 세션 시작
- Cancel: 플랜을 파일로 저장하고 나중에 다시 사용
리뷰 인터페이스: 플랜 검토 및 수정 요청
클라우드에서 플랜이 생성되면 브라우저 리뷰 뷰에서 상세하게 검토할 수 있다.
- 인라인 댓글: 특정 문단을 하이라이트하고 수정 요청 댓글 작성 가능
- 이모지 반응: 섹션별로 승인 또는 우려 표시
- 아웃라인 사이드바: 긴 플랜의 섹션 간 빠른 이동
이 인터페이스는 단순히 플랜을 보는 것을 넘어, Claude와 대화하며 플랜을 정교하게 다듬을 수 있게 해준다. 특히 여러 사람이 플랜을 리뷰해야 하는 팀 환경에서 유용하다.
GitHub 연동과 대규모 리팩토링
Ultraplan이 특히 빛을 발하는 시나리오는 대규모 리팩토링이다. Claude Code의 Agent Teams 기능은 복잡한 작업을 서브태스크로 분해하고 병렬 서브에이전트를 스폰한다.

예를 들어 대형 코드베이스 리팩토링 시:
- 에이전트 A: 데이터 모델 업데이트
- 에이전트 B: 테스트 코드 재작성
- 에이전트 C: 문서 업데이트
세 작업이 동시에 진행된다. GitHub 연동을 통해 클라우드 컨테이너가 저장소에 접근하고, 결과를 브라우저에서 검토한 뒤 PR로 병합하는 워크플로우가 가능하다.
Claude Code GitHub Action: GitHub PR과 이슈에서 @claude를 멘션하면 자동으로 Claude Code가 활성화되어 코드 변경을 구현할 수 있다. (GitHub)
4. 아키텍처 : 공개 정보 기반 추정
이 섹션은 공개된 소스코드 유출 분석, 공식 문서, 커뮤니티 역분석을 기반으로 한 추정이다. Anthropic이 공식적으로 확인한 내부 구현 상세가 아니다.
어떻게 클라우드에서 저장소에 접근하는가
공식 문서에 따르면, 클라우드 세션은 GitHub remote에서 현재 브랜치를 클론하여 실행된다. 따라서 로컬에만 있는 커밋은 먼저 push해야 클라우드에서 접근할 수 있다. (출처: Claude Code on the web 문서)
GitHub 연동이 없는 저장소의 경우, 로컬 저장소를 번들로 패킹하여 클라우드에 업로드하는 폴백 메커니즘도 존재한다. 단, 번들 크기 100MB 제한이 있으며 untracked 파일은 포함되지 않는다.
클라우드 세션과 병렬 에이전트 아키텍처
공식 문서에 따르면, 각 클라우드 세션은 격리된 Anthropic 관리 VM에서 실행되며, 리소스 상한은 약 4 vCPU / 16GB RAM / 30GB 디스크이다. (출처: 공식 문서)
2026-03-31 소스코드 유출 분석(참고)에서는 내부적으로 CCR(Cloud Container Runtime)이라는 용어, Opus 4.6 모델 사용, 최대 30분 실행 등이 언급되었으나, 이는 공식 문서에서 확인되지 않는 커뮤니티 역분석 결과이다.
클라우드 환경에서 서브에이전트(Task tool)를 통한 병렬 처리가 가능한 것은 공식 문서에서 확인된다. 이것이 로컬 대비 처리 속도 향상의 원인으로 추정되지만, 구체적인 병렬화 수준은 공식적으로 공개되지 않았다.
하네스 엔지니어링 패러다임

- Prompt Engineering: 단일 프롬프트로 AI에게 요청
- Context Engineering: CLAUDE.md, Rules, Memory 등 컨텍스트를 설계하여 AI 동작 제어
- Harness Engineering: 여러 AI 에이전트를 오케스트레이션하는 시스템 설계
이 관점에서 Ultraplan은 하네스 엔지니어링의 실제 구현체다. 사용자는 단순히 Claude Code를 사용하는 것이 아니라, 클라우드 에이전트 하네스를 운용하는 엔지니어가 된다.
발표자료가 제안하는 2026 AI Developer OS 계층 구조는 다음과 같다.
| 계층 | 도구 | 역할 |
|---|---|---|
| Overlord | Claude Ultraplan, Paperclip | 최상위 오케스트레이션 |
| Command | Claude Code, Anti-gravity | 실행 에이전트 |
| Logic | MCP | 도구 통합 레이어 |
| Core | Flutter, NestJS, TypeScript | 기반 기술 스택 |
한 줄로 요약하면: Overlord가 목표를 정의하고, Command가 코드를 작성하고, Logic이 외부 도구를 연결하고, Core가 실제 결과물을 만든다.
5. 사용 경험과 커뮤니티 반응
속도: 얼마나 빠른가
한국 커뮤니티(GeekNews 등)에서 바이럴된 포스팅 에서는 "로컬 plan mode 5분 30초 vs Ultra Plan 30초 → 약 11배 빠름"을 주장했다.
⚠ 주의: 이 "11배 빠르다" 이 수치는 커뮤니티 포스트의 단일 사례에서 비롯된 것으로, 독립적으로 검증하지 못했다. 영문 기술 블로그들은 "로컬 대비 약 2배 빠른 처리"를 언급하고 있다. 실제 속도 향상은 작업 복잡도, 저장소 크기, 서버 부하에 따라 크게 달라질 수 있다. 직접 테스트로 확인하는 것이 권장된다.
이것이 의미하는 바 : 속도 향상의 본질은 단순한 모델 성능 차이가 아니라, 클라우드 병렬 에이전트 아키텍처에 있다. 같은 작업을 여러 에이전트가 동시에 처리하기 때문에, 복잡한 작업일수록 속도 이점이 커진다.
커스텀 Skill 제한사항: 설계상 제약 + 버그
공식 문서 기준 클라우드 세션에서의 설정 동기화 (출처: 공식 문서)
- 사용 가능: 프로젝트에 커밋된
.claude/skills/,.claude/agents/,.claude/commands/,.claude/rules/,CLAUDE.md - 사용 불가: 유저 레벨
~/.claude/CLAUDE.md,~/.claude/settings.json의 유저 스코프 플러그인,claude mcp add로 추가한 MCP 서버
즉, 프로젝트 저장소에 커밋된 skill과 커맨드는 클라우드에서 정상 작동한다. 작동하지 않는 것은 로컬 머신에만 존재하는 유저 레벨 설정이며, 이는 버그가 아닌 설계상 제한이다.
다만, 이와 별개로 GitHub Issues에 리포트된 실제 버그도 존재한다.
GitHub Issues에는 세 가지 관련 버그가 리포트되어 있다.
버그 1: 커스텀 커맨드/스킬 오작동 (v0.88+)
v0.88 이후 버전에서 사용자 정의 커맨드와 스킬이 올바르게 로드되지 않거나 잘못된 커맨드를 호출하는 문제가 지속 리포트되고 있다. (GitHub Issue #41882) 이는 토큰 낭비와 잘못된 동작으로 이어진다.
버그 2: Ultraplan 승인 후 Plan Mode 위반
Ultraplan 결과를 승인한 후, 모델이 plan mode 제약을 무시하고 소스 파일을 직접 편집하는 버그가 존재한다. (GitHub Issue #43576) 원래는 플랜 파일에 내용을 쓰고 ExitPlanMode를 호출해야 하지만, ultraplan 결과를 받은 후에는 이 규칙이 위반된다.
버그 3: 커스텀 슬래시 커맨드 미인식
~/.claude/commands/ 디렉토리의 커스텀 슬래시 커맨드가 인식되지 않는 문제도 리포트되고 있다. (GitHub Issue #41243)
이것이 의미하는 바: Ultraplan의 클라우드 환경은 저장소 클론에서 시작하므로, 저장소에 커밋되지 않은 유저 레벨 설정(~/.claude/)은 접근할 수 없다. skill이나 커맨드를 클라우드에서 사용하려면, 반드시 프로젝트의 .claude/ 디렉토리에 커밋해야 한다.
커뮤니티 결론: 언제 Ultraplan, 언제 로컬
vyblor 포스트가 정리한 사용 지침은 다음과 같다: "단순 코딩 → Ultraplan, 커스텀 skill 활용 → 로컬 유지".
이는 기술적 현실에 기반한 실용적 판단이다. 현재 버그 상황에서 커스텀 skill 워크플로우는 로컬이 더 안정적이다.
직접 테스트: 로컬 Plan Mode vs Ultraplan 플랜 비교
커뮤니티 후기만으로는 판단이 어려워, 동일한 과제를 두 모드로 직접 실행해 비교했다.
/ultraplan vs 기존 /plan 모드
동일한 과제("autoimprove 파이프라인을 harness-blog-project에 적용")를 두 모드로 실행하여 직접 비교해봤다.
1. /ultraplan 수행

/ultraplan을 실행하면 클라우드에서 실행할지 확인하는 다이얼로그가 나타난다. 안내 내용은 다음과 같다:
- 웹에서 Claude의 플랜을 편집하고, 특정 부분에 댓글을 달 수 있는 인터랙티브 플래닝
- 이 세션의 Remote Control이 해제됨 (두 기능이 같은 claude.ai/code 인터페이스를 점유하므로 동시 사용 불가)
Run ultraplan을 선택하면 클라우드 세션이 시작된다.

원래라면 웹(claude.ai/code)에서 클라우드 에이전트들이 병렬로 작업을 처리해야 한다. 하지만 이번 테스트에서는 예상과 다른 상황이 발생했다.

하필 테스트에 사용한 레포가 무거운 상태였다. 공식 문서에 따르면 비-GitHub 저장소는 bundle 방식(100MB 제한)으로 업로드되는데, 이 제한에 걸리면 클라우드 전송에 실패하고 로컬에서 플래닝이 진행된다. 이 또한 실무에서 충분히 마주칠 수 있는 상황이므로 경험을 공유한다.

2. /plan 모드로 수행
비교를 위해 동일한 과제를 로컬 /plan 모드로도 실행했다.

3. 결과 비교
⚠ 이번 테스트의 특수한 상황
이번 /ultraplan 실행은 레포 용량 초과로 클라우드가 아닌 로컬에서 진행되었다. 따라서 Ultraplan의 핵심 장점인 클라우드 병렬 처리 속도 이점은 이 테스트에 반영되지 않았다.
커뮤니티에서는 정상적으로 웹에서 실행된 경우 "확실히 빠르고, 플랜의 구조화 수준도 높다"는 평가가 주류이다. 속도 면에서 로컬 대비 우위가 있다는 점은 커뮤니티 다수 의견이 일치한다.
이번 비교는 속도를 제외하고, 플랜 퀄리티(내용의 깊이와 실행 가능성) 관점에서 평가한다.
로컬 Plan Mode 결과 요약
핵심 진단: 6-Agent 하네스의 현재 병목은 Writer 에이전트에 집중되어 있다. Writer가 전체 품질 이슈의 약 80%를 차지하며, Evaluator의 피드백 루프가 Writer 수정에 의존하는 구조이므로 Writer 개선이 전체 파이프라인 품질에 직결된다.
우선순위 기반 접근:
- P0 (즉시): Writer 에이전트 프롬프트에 자동 개선 루프 적용 — 과거 QA 리포트 패턴을 분석하여 반복 실패 항목을 Writer 프롬프트에 자동 반영
- P1 (단기): Evaluator → Writer 피드백 경로 최적화 — failure code별 구체적 수정 지시 강화
- P2 (중기): Researcher 에이전트 evidence 품질 개선 — evidence 부족이 Writer 품질 저하의 근본 원인인 경우 대응
특징: 기존 5개 런의 QA 리포트 데이터를 직접 분석하여 "어디가 가장 많이 실패하는가"를 수치로 파악한 뒤 계획을 도출했다. 데이터 기반 의사결정.
Ultraplan 결과 요약
3단계 구조화 접근:
- Phase 1 — 분석: 현재 파이프라인의 SKILL.md, 에이전트 프롬프트, QA 기준 파일을 체계적으로 분석하여 개선 포인트 도출
- Phase 2 — 설계: autoimprove 루프의 Score → Decide → Improve → Iterate 패턴을 하네스에 매핑하는 아키텍처 설계
- Phase 3 — 구현 및 검증: 단계별 구현 후 기존 런과 비교 테스트로 품질 향상 여부 검증
리스크 매트릭스 포함: "자동 개선이 오히려 품질을 저하시킬 위험", "피드백 루프 무한 반복 가능성" 등 예상 리스크와 대응 방안을 사전에 정의했다.
특징: 프로젝트 관리 문서 수준의 체계적 구조. 팀원에게 공유하거나 리뷰를 받기에 적합한 형태.
- 별도의 에이전트에게 결과에 대한 비교도 요청 해 보았다.
비교 평가
| 평가 항목 | 로컬 Plan Mode | Ultraplan |
|---|---|---|
| 문제 진단 깊이 | 우세 — 실제 데이터 기반 병목 분석 | 구조적 분석, 데이터 참조 없음 |
| 실행 가능성 | 우세 — 즉시 실행 가능한 P0/P1/P2 | Phase 구분은 명확하나 구체성 부족 |
| 문서 완성도 | 실무 메모 수준 | 우세 — 리스크 매트릭스, 검증 방법론 포함 |
| 리스크 관리 | 언급 없음 | 우세 — 사전 리스크 정의 및 대응 |
| 컨텍스트 활용 | 우세 — 로컬 파일 직접 읽기 가능 | GitHub 클론 기반, 커밋되지 않은 파일 접근 불가 |
| 종합 | 실행에 강함 | 문서화에 강함 |
결론: "어느 쪽이 더 좋은가"는 목적에 따라 다르다.
- 지금 바로 실행할 계획이 필요하다면 → 로컬 Plan Mode. 프로젝트의 실제 데이터를 분석하고, 로컬 파일(커밋되지 않은 작업 포함)에 접근하여 구체적인 액션 아이템을 도출한다.
- 팀에 공유할 구조화된 계획서가 필요하다면 → Ultraplan. 체계적인 Phase 구분, 리스크 매트릭스, 검증 방법론이 포함된 문서 수준의 산출물을 생성한다.
이상적으로는 Ultraplan으로 큰 그림을 그리고, 로컬 Plan Mode로 실행 세부사항을 채우는 조합이 가장 효과적이다.
- 나의 경우 상기 두개의 플랜을 서로 상호 보완 한 후 그 결과를 토대로 개선작업을 진행 시켰다.
6. 요금제 및 제한사항
⚠ 주의 이 섹션의 가격 정보는 2026-04-08 기준이다. 요금은 언제든 변경될 수 있으므로, 최신 가격은 공식 페이지에서 확인하기 바란다.
Max 플랜 구조
Claude Code Ultraplan을 사용하려면 최소 Pro 플랜이 필요하다. 더 많은 사용량이 필요한 경우 Max 플랜을 고려한다.
| 플랜 | 월 요금 | 사용량 | 주요 특징 |
|---|---|---|---|
| Pro | $20 | 기준 | Claude Code, Ultraplan 기본 접근 |
| Max 5x | $100 | Pro의 5배 | Claude Code 집중 사용자용 |
| Max 20x | $200 | Pro의 20배 | 하루 종일 개발 워크로드용 |
Max 5x와 Max 20x의 기능 세트는 동일하다. 유일한 차이는 사용량 할당량이다. 독립 테스트에 따르면 Max 5x는 5시간 창당 약 225개 메시지, Max 20x는 약 900개 메시지를 처리한다. (이는 공식 수치가 아닌 커뮤니티 측정값이다)
포함 기능 (Max 플랜 기준)
- 멀티모달 채팅
- Claude Code 통합 (터미널 에이전트)
- Cowork 파일 워크플로우
- 메모리 기능
- 신기능 얼리 액세스 (새 모델, 보이스 모드 등)
- 피크 시간 우선 서비스
Ultraplan 제한사항 요약
- GitHub 연동 필수 (로컬 전용 저장소는 번들 폴백, 100MB 제한)
- 유저 레벨 설정(~/.claude/) 미동기화 — 프로젝트에 커밋된 설정만 사용 가능
- research preview 단계 — 피드백에 따라 변경 가능
- Ultraplan 시작 시 Remote Control 자동 해제
- Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry 환경에서 사용 불가
- Claude Code v2.1.91 이상 필요
7. 대안 비교: Ultraplan vs 로컬 Plan Mode
| 비교 항목 | Ultraplan (클라우드) | 로컬 Plan Mode |
|---|---|---|
| 실행 위치 | Anthropic 관리 클라우드 VM | 로컬 터미널 |
| 모델 | 미공개 (공식 문서에 명시 없음) | 설정된 모델 |
| 리소스 | 약 4 vCPU / 16GB RAM / 30GB 디스크 | 로컬 머신 사양 |
| 터미널 차단 | 없음 (터미널 자유) | 있음 (터미널 점유) |
| 커스텀 Skill | 프로젝트 커밋 skill만 지원 (유저 레벨 미지원) | 전체 지원 |
| GitHub 연동 | 필수 | 선택 |
| 로컬 환경 접근 | 미지원 | 지원 |
| 리뷰 인터페이스 | 인라인 댓글, 이모지 반응, 아웃라인 | 터미널 텍스트 기반 |
| 대규모 리팩토링 | 병렬 에이전트로 유리 | 순차 처리 |
| 인터넷 없는 환경 | 사용 불가 | 사용 가능 |
한 줄로 요약하면: Ultraplan은 대규모 복잡한 플래닝에서 클라우드 병렬 처리의 이점을 제공하고, 로컬 Plan Mode는 커스텀 환경과 오프라인 상황에서 안정적이다.
결정 매트릭스: 언제 무엇을 써야 하는가
| 시나리오 | 권장 선택 | 이유 |
|---|---|---|
| 대규모 코드베이스 리팩토링 | Ultraplan | 병렬 에이전트, 긴 처리 시간, 브라우저 리뷰 |
| 유저 레벨(~/.claude/) skill 워크플로우 | 로컬 Plan Mode | 유저 레벨 설정 클라우드 미동기화 |
| 빠른 단일 파일 수정 | 로컬 Plan Mode | Ultraplan 오버헤드 불필요 |
| 팀 플랜 리뷰 필요 | Ultraplan | 인라인 댓글, 이모지 반응 |
| 로컬 파일 시스템 접근 필요 | 로컬 Plan Mode | 클라우드는 GitHub 스냅샷만 접근 |
| 오프라인/VPN 환경 | 로컬 Plan Mode | Ultraplan은 인터넷 필수 |
| 브라우저 리뷰 인터페이스 필요 | Ultraplan | 인라인 댓글, 이모지 반응 지원 |
8. 트러블슈팅 Q&A + 결론
자주 묻는 질문
Q: "Ultraplan이 시작되지 않아요"
A: 두 가지를 확인한다. 첫째, Pro 이상 플랜 계정으로 로그인했는가. 둘째, GitHub 저장소가 연동되어 있는가. 로컬 전용 저장소에서는 Ultraplan이 작동하지 않는다.
Q: "플랜을 승인했는데 Claude가 플랜 파일이 아닌 소스 파일을 직접 편집해요"
A: 알려진 버그다. Ultraplan 승인 후 Plan Mode 제약이 위반되는 문제로, 2026-04-08 기준 미해결 상태다. GitHub Issues #43576에 리포트되어 있다. 임시 해결책으로 Ultraplan 결과를 받은 후 수동으로 플랜 파일을 확인하고 소스 편집 전에 플랜 내용을 검토한다.
Q: "커스텀 skill이 Ultraplan에서 작동하지 않아요"
A: 클라우드 세션은 저장소 클론에서 시작하므로, 프로젝트에 커밋된 .claude/skills/는 정상 작동한다. 작동하지 않는 것은 ~/.claude/ 아래의 유저 레벨 설정이며, 이는 설계상 클라우드에 동기화되지 않는다. skill을 클라우드에서 사용하려면 프로젝트 저장소에 커밋하면 된다. 별도로 v0.88+ 버전에서 skill 로딩 자체의 버그가 리포트되어 있다. (Issue #41882, Issue #41243)
Q: "Ultraplan이 얼마나 빠른가요? 11배라는 말이 사실인가요?"
A: "11배 빠름"은 단일 커뮤니티 사례에서 나온 수치로 독립 검증이 어렵다. 커뮤니티 테스트 기준 "약 2배 빠름"이 더 일반적인 기준치로 보인다. 속도 향상의 본질은 클라우드 병렬 에이전트 아키텍처에 있으며, 작업 복잡도가 높을수록 이점이 커진다.
최종 결론: 지금 당장 써야 하는가
Ultraplan은 강력하지만 아직 완성되지 않은 도구다. 다음 기준으로 결정한다.
지금 쓸 것:
- 대규모 코드베이스 리팩토링이 필요한 경우
- 팀과 함께 플랜을 검토하고 싶은 경우
- 터미널 차단 없이 긴 플래닝이 필요한 경우
아직 기다릴 것:
- 유저 레벨(~/.claude/) skill에 의존하고 프로젝트 커밋이 어려운 워크플로우
- 로컬 파일 시스템에 직접 접근해야 하는 작업
- Bedrock / Vertex AI / Foundry 환경을 사용하는 경우
Ultraplan은 AI 통제력 진화의 세 번째 단계인 하네스 엔지니어링의 실제 구현이다.
현재 research preview 단계이고 제약도 있지만, 방향성은 분명하다. 클라우드 에이전트가 코드베이스를 이해하고 플랜을 세우는 시대가 시작됐다.
참고 자료
'AI > Claude' 카테고리의 다른 글
당신이 좋아할만한 콘텐츠
-
Claude Code 'ultrareview'란 : 멀티 에이전트 코드 리뷰, 어떻게 작동하나 - 회당 $5~$20 추가 과금은 합리적 일까 2026.04.24
-
Claude Code 'Claude Design이란?' 리뷰(1) : Figma 대체재인가, 보완재인가 - 디자인 시스템 설정부터 Claude Code 핸드오프까지 2026.04.23
-
Claude Code NO_FLICKER(깜빡임 없는 풀스크린 렌더링 모드) 리뷰 : 화면 깜빡임과 스크롤 점프가 정말 사라질까 2026.04.02
-
openai/codex-plugin-cc(Claude Code용 공식 Codex 플러그인) : Claude가 코딩하고 Codex가 리뷰한다 2026.03.31
소중한 공감 감사합니다