Claude Code: 제대로 알고 쓰자(Ultraplan편)

CLI에서 계획을 시작하고, 웹의 Claude Code에서 초안을 작성한 뒤, 원격으로 또는 터미널에서 실행한다

울트라플랜(Ultraplan)은 리서치 프리뷰 단계이며 Claude Code v2.1.91 이상이 필요하다. 피드백에 따라 동작 방식과 기능이 변경될 수 있다.

울트라플랜은 계획 작업을 로컬 CLI에서 웹의 Claude Code 세션으로 넘기며, 해당 세션은 플랜 모드로 실행된다. Claude가 클라우드에서 계획 초안을 작성하는 동안, 사용자는 터미널에서 계속 작업할 수 있다. 계획이 준비되면 브라우저에서 열어 특정 섹션에 댓글을 달고, 수정을 요청하고, 어디서 실행할지 선택한다.

울트라플랜은 터미널이 제공하는 것보다 더 풍부한 검토 화면이 필요할 때 유용하다.

• 세부 피드백: 전체 내용에 답변하는 대신 계획의 개별 섹션에 댓글을 남길 수 있다
• 핸즈오프 초안 작성: 계획이 원격으로 생성되므로 터미널은 다른 작업을 위해 자유롭게 유지된다
• 유연한 실행: 계획을 승인해 웹에서 실행하고 풀 리퀘스트를 열거나, 터미널로 되돌려 보낼 수 있다

울트라플랜을 사용하려면 웹의 Claude Code 계정과 GitHub 저장소가 필요하다. Anthropic의 클라우드 인프라에서 실행되기 때문에 Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry를 사용할 때는 이용할 수 없다. 클라우드 세션은 계정의 기본 클라우드 환경에서 실행된다.

CLI에서 울트라플랜 시작하기

로컬 CLI 세션에서 울트라플랜을 시작하는 방법은 세 가지이다.

• 명령어: /ultraplan 뒤에 프롬프트를 입력해 실행한다
• 키워드: 일반 프롬프트 어디에든 ultraplan이라는 단어를 포함한다
• 로컬 플랜에서: Claude가 로컬 플랜을 완료하고 승인 대화 상자를 표시하면, No, refine with Ultraplan on Claude Code on the web을 선택해 초안을 클라우드로 보내 추가 반복 작업을 진행한다

예를 들어, 명령어를 사용해 서비스 마이그레이션을 계획하려면 다음과 같이 입력한다.

/ultraplan migrate the auth service from sessions to JWTs

명령어 및 키워드 방식은 실행 전에 확인 대화 상자를 표시한다. 로컬 플랜 방식은 해당 선택 자체가 이미 확인 역할을 하므로 대화 상자를 건너뛴다. 원격 제어(Remote Control)가 활성화되어 있으면 울트라플랜이 시작될 때 연결이 해제된다. 두 기능 모두 claude.ai/code 인터페이스를 사용하기 때문에 동시에 하나만 연결할 수 있다.

클라우드 세션이 시작되면 원격 세션이 작업하는 동안 CLI 프롬프트 입력창에 상태 표시가 나타난다.

상태	의미
◇ ultraplan	Claude가 코드베이스를 조사하고 계획을 작성하는 중이다
◇ ultraplan needs your input	Claude에게 명확히 해야 할 질문이 있다. 세션 링크를 열어 응답한다
◆ ultraplan ready	계획이 브라우저에서 검토할 준비가 되었다

/tasks를 실행하고 울트라플랜 항목을 선택하면 세션 링크, 에이전트 활동, Stop ultraplan 액션이 포함된 상세 보기가 열린다. 중지하면 클라우드 세션이 보관되고 상태 표시가 사라진다. 터미널에는 아무것도 저장되지 않는다.

브라우저에서 계획 검토 및 수정하기

상태가 ◆ ultraplan ready로 변경되면 세션 링크를 열어 claude.ai에서 계획을 확인한다. 계획은 전용 검토 화면에 표시된다.

• 인라인 댓글: 문장을 드래그해서 선택하고 Claude가 처리할 댓글을 남긴다
• 이모지 반응: 전체 댓글을 작성하지 않고도 섹션에 이모지로 반응해 승인 또는 우려를 표시한다
• 아웃라인 사이드바: 계획의 섹션 사이를 빠르게 이동한다

Claude에게 댓글을 반영하도록 요청하면, 계획을 수정하고 업데이트된 초안을 제시한다. 실행 위치를 선택하기 전까지 필요한 만큼 반복해서 수정할 수 있다.

실행 위치 선택하기

계획이 완성되면 브라우저에서 Claude가 같은 클라우드 세션에서 구현할지, 아니면 대기 중인 터미널로 계획을 되돌려 보낼지 선택한다.

웹에서 실행하기

브라우저에서 Approve Claude's plan and start coding을 선택하면 Claude가 같은 Claude Code 웹 세션에서 계획을 구현한다. 터미널에 확인 메시지가 표시되고 상태 표시가 사라지며, 작업은 클라우드에서 계속된다. 구현이 완료되면 diff를 검토하고 웹 인터페이스에서 풀 리퀘스트를 생성한다.

터미널로 계획 되돌려 보내기

브라우저에서 Approve plan and teleport back to terminal을 선택하면 사용자 환경에 완전히 접근할 수 있는 로컬 환경에서 계획을 구현한다. 이 옵션은 세션이 CLI에서 시작되었고 터미널이 여전히 폴링 중일 때 표시된다. 웹 세션은 보관되어 병렬로 계속 작업하지 않는다.

터미널에는 Ultraplan approved라는 제목의 대화 상자에 계획이 표시되며 세 가지 옵션이 나타난다.

• Implement here: 계획을 현재 대화에 주입하고 중단한 지점부터 계속한다
• Start new session: 현재 대화를 지우고 계획만을 컨텍스트로 새로 시작한다
• Cancel: 계획을 실행하지 않고 파일로 저장한다. Claude가 파일 경로를 출력하므로 나중에 돌아올 수 있다

새 세션을 시작하면 Claude가 상단에 claude --resume 명령어를 출력하여 이전 대화로 돌아갈 수 있게 해 준다.