Claude Code에서 PR 리뷰를 시켜보면 충분히 똑똑하지만, “정말 큰 변경” 앞에서는 한 번 더 단단한 검증이 필요할 때가 있습니다. /ultrareview는 그 자리를 채우려고 등장한 명령입니다. 이름이 거창해서 “그냥 마케팅 아닌가?” 싶지만, 막상 동작 구조를 보면 일반 /review와는 결이 분명히 다릅니다. 이 글에서는 /ultrareview가 정확히 무엇이고, /review와 어떻게 다른지, 비용·시간·세션 영향을 한 번에 정리하고 진짜 쓸 일이 있는 시나리오 6가지를 살펴보겠습니다.
목차
/ultrareview는 어떤 명령인가
/ultrareview는 Claude Code의 멀티 에이전트 클라우드 코드 리뷰 명령입니다. 일반 /review처럼 로컬 세션에서 한 번 훑고 끝나는 게 아니라, Anthropic이 관리하는 클라우드 샌드박스에서 여러 전문 에이전트를 병렬로 띄워 리뷰를 진행한 뒤 결과를 모아 돌려줍니다. 공식 가이드는 Claude Code 공식 문서의 ultrareview 페이지에서 확인할 수 있습니다.
호출 형태는 두 가지입니다.
/ultrareview # 현재 로컬 브랜치를 번들해 클라우드로 보내 리뷰
/ultrareview 1234 # GitHub PR 번호를 지정해 리뷰전자는 GitHub에 푸시하지 않은 로컬 변경분도 리뷰가 가능합니다. 저장소 자체를 번들링해 클라우드로 보내기 때문에 GitHub 리모트 자체가 없어도 됩니다. 후자는 이미 올라간 PR 번호를 받아 그 시점의 diff를 리뷰합니다.
비대화형 환경(예: CI 스크립트)에서는 셸에서 직접 부를 수도 있습니다.
claude ultrareview --json # 결과를 JSON으로 stdout에 출력
claude ultrareview --timeout 600 # 타임아웃 지정일반 /review와 결정적으로 무엇이 다른가
이름 때문에 “더 깊은 /review” 정도로 오해하기 쉽지만, 둘은 구조가 다릅니다.
| 항목 | /review | /ultrareview |
|---|---|---|
| 실행 위치 | 현재 로컬 세션 | Anthropic 관리 클라우드 샌드박스 |
| 에이전트 구조 | 단일 에이전트 1패스 | 여러 전문 에이전트 병렬 + 검증 단계 |
| 오탐 필터 | 없음(직접 판단) | 발견 사항을 별도로 재현·검증 |
| 소요 시간 | 수 초~수 분 | 대체로 수 분~10분대 |
| 세션 영향 | 메인 컨텍스트 사용 | 백그라운드 실행, 메인 대화 영향 적음 |
| 적합한 시점 | 작업 중 빠른 피드백 | 병합 전 신뢰성 게이트 |
핵심은 두 가지입니다. 첫째, 리뷰 에이전트가 분담해서 본다는 점입니다. 보안, 아키텍처, 로직, 스타일 같은 관점이 한 LLM 머릿속에서 뒤섞이는 대신 별도 에이전트가 각각 책임지고 봅니다. 둘째, 발견된 이슈를 다시 검증하는 단계가 있다는 점입니다. “이거 버그 같은데?” 수준에서 끝나지 않고, 별도 검증 에이전트가 실제로 재현 가능한지 확인한 결과만 최종 리포트에 올립니다. 일반 LLM 코드 리뷰가 가진 가장 큰 약점인 오탐(false positive)이 줄어드는 구조입니다.
세션에 영향을 주는가
거의 주지 않습니다. /ultrareview는 메인 세션에서 명령을 받는 즉시 작업을 클라우드 샌드박스로 넘기고, 사용자는 메인 대화에서 다른 작업을 계속할 수 있습니다. 결과가 나오면 메인 세션에 알림이 도착하고, 거기서부터 발견 사항을 하나씩 들여다보거나 수정 명령을 이어서 내릴 수 있습니다. 진행 중·완료된 리뷰들은 /tasks 명령으로 한꺼번에 관리할 수 있습니다.
같은 시리즈의 /loop·/btw와 묶어 정리하면 흐름이 분명해집니다. /btw는 메인 세션 컨텍스트를 읽기 전용으로 살짝 활용하고, /loop는 같은 세션을 주기적으로 깨우며, /ultrareview는 아예 클라우드로 작업을 외주 보내고 결과만 받습니다. “메인 세션 보호”라는 관점에서 보면 셋 다 같은 철학을 공유합니다.
비용과 시간, 현실적인 기대치
공식 안내 기준으로 Pro/Max 구독자에게는 일정 횟수의 무료 한도가 제공되고, 그 이상은 추가 사용량(extra usage)으로 과금됩니다. 정확한 무료 횟수와 단가는 시점에 따라 변경될 수 있으므로, 실행 전 현재 청구 정책을 한 번 확인하시기 바랍니다. Team/Enterprise 플랜은 처음부터 추가 사용량 기반으로 빌링되며, extra usage 옵션이 비활성화된 계정에서는 호출 자체가 막힙니다.
소요 시간은 표준 PR 기준으로 보통 5~10분 안팎입니다. 에이전트가 병렬이라 “여러 관점을 한 번에 본다는 점에서 빠른 것”이지, “/review보다 절대 시간이 빠른 것”은 아닙니다. PR 규모가 크면 더 길어지므로, 자잘한 변경에 매번 돌리기에는 어울리지 않습니다.
진짜 쓸 일이 있는 6가지 시나리오
1. 큰 PR을 머지하기 직전의 품질 게이트
여러 파일에 걸친 기능 PR을 올리고, 동료 리뷰만으로는 자신이 없을 때입니다. /ultrareview 1234로 한 번 돌리면 보안·아키텍처·로직 관점에서 분담해서 봐주므로, 머지 전 마지막 안전망 역할을 합니다.
2. 레거시 코드의 대규모 리팩토링
인증 모듈 교체나 핵심 도메인 모델 재구성 같은 작업은 단일 에이전트가 한 번에 잡기 어려운 엣지 케이스가 많습니다. 멀티 에이전트 분담 + 검증 단계가 가장 빛나는 영역입니다.
3. 메이저 의존성 업그레이드
React 18→19, Node 메이저 버전 점프, ORM 마이그레이션처럼 호환성 영향이 코드 전반에 흩어지는 작업에서 유용합니다. 마이그레이션 가이드를 잘못 따라 한 부분을 검증 에이전트가 잡아주면 비용 대비 효용이 큽니다.
4. 보안·결제·인증 코드 변경
한 번의 오탐도, 한 번의 누락도 비용이 큰 영역입니다. 검증 단계가 있어 “정말 버그인지 확인된 항목”만 올라오므로, 일반 리뷰보다 제보 신뢰도가 높습니다.
5. 외부에 공개될 라이브러리·SDK 릴리즈 직전
릴리즈 후에는 패치 비용이 급격히 늘어나는 코드입니다. 5~10분 투자해 공개 전에 한 번 더 깊게 보는 가치가 있습니다.
6. CI/CD 파이프라인의 비동기 리뷰 자동화
claude ultrareview --json으로 결과를 JSON으로 받아 Slack·이메일·이슈 트래커로 푸시하는 워크플로우를 만들 수 있습니다. 사람이 메인으로 보던 리뷰 부담을 일부 떼어내 비동기로 돌리는 구조입니다.
안 어울리는 경우
- 한두 줄짜리 핫픽스: 일반
/review나 사람이 더 빠릅니다. 5~10분 대기와 비용을 정당화하기 어렵습니다. - 빠른 피드백 루프가 필요한 작업: 코드 짜다가 즉시 의견을 받고 싶을 때는 부적합합니다. 그 자리는 일반 프롬프트나
/btw가 맞습니다. - API 키 단독 인증·Bedrock·Vertex·ZDR 환경:
/ultrareview는 Claude.ai 계정 인증 기반이라 일부 엔터프라이즈 인증 경로에서는 사용할 수 없습니다. 사내 정책에 따라 막힐 수 있으니 사전에 확인이 필요합니다. - 외부 유출이 절대 안 되는 코드: 로컬 브랜치 모드는 저장소를 번들링해 클라우드 샌드박스로 보냅니다. 격리된 VM에서 실행되지만, 그래도 정책상 코드 외부 전송이 금지된 환경이라면 사용해서는 안 됩니다. 비밀 키나 자격증명이 코드에 남아 있지 않은지도 실행 전 한 번 더 확인하시기 바랍니다.
마무리
/ultrareview는 모든 PR마다 돌리는 명령이 아닙니다. “이 변경은 머지되면 되돌리기 비싸다”고 느끼는 순간을 위한 도구에 가깝습니다. 일반 /review·동료 리뷰·테스트로 거를 수 있는 것은 거기서 거르고, 그 위에 한 겹 더 두꺼운 안전망을 깔고 싶을 때 5~10분을 투자하는 식이 가장 합리적입니다. 같은 시리즈의 /loop·/btw와 함께 보면 셋 다 “메인 세션을 깨끗하게 유지하면서 다른 곳에서 일을 시키는” 같은 철학을 공유한다는 점이 보입니다. 다음에 큰 PR을 머지하기 직전이라면, 한 번 /ultrareview로 넘겨두고 그 사이 다른 작업을 이어서 해보시기 바랍니다.
자주 묻는 질문
Q. /ultrareview가 찾은 버그를 곧바로 고치게 시킬 수 있나요?
네. 발견 사항이 메인 세션에 도착한 뒤, “이 항목을 수정해줘”처럼 일반 프롬프트로 이어서 수정 작업을 지시하면 됩니다.
Q. GitHub 리모트가 없는 로컬 전용 저장소에서도 쓸 수 있나요?
가능합니다. 인자 없이 호출한 /ultrareview는 현재 로컬 브랜치를 번들링해 보내기 때문에 GitHub 리모트가 없어도 동작합니다. 단, git 저장소 자체는 초기화되어 있어야 합니다.
Q. /ultrareview 도중 다른 명령을 실행해도 되나요?
됩니다. 백그라운드 작업이라 메인 세션은 자유롭게 사용할 수 있고, 결과가 도착하면 별도 알림으로 합쳐집니다. /tasks에서 진행 상황을 확인하거나 중단할 수도 있습니다.