Cmd. /ultrareview
클라우드 샌드박스에서 멀티에이전트로 깊은 코드 리뷰를 수행하는 명령(현재 권장 호출은 /code-review ultra, /ultrareview는 별칭)
핵심 요약
/ultrareview(권장 표기/code-review ultra)는 클라우드 샌드박스에서 멀티에이전트로 브랜치·PR의 버그를 찾는 심화 리뷰입니다.- 로컬
/review와 다른 점은 높은 신호(발견 항목을 독립 재현·검증), 넓은 커버리지, 로컬 리소스를 쓰지 않는다는 세 가지입니다. - Pro·Max는 계정당 무료 3회(갱신 없음)이고 소진 후에는 usage credits로 회당 약 $5~$20 과금되며, 원격 세션 시작 시점에 1회로 카운트됩니다.
- Claude.ai 계정 인증이 필요하고 Bedrock·Vertex AI·Foundry·ZDR 조직에서는 사용할 수 없으며, CI용으로는
claude ultrareview서브커맨드를 씁니다.
명령어 원본 선언
/ultrareview [PR]현재 권장되는 호출 방식은
/code-review ultra이며,/ultrareview는 별칭(alias)으로 계속 동작합니다.
/code-review ultra [PR]공식 설명 요약
/ultrareview(권장: /code-review ultra)는 Claude Code on the web 인프라(클라우드 샌드박스) 위에서 여러 리뷰어 에이전트(multi-agent fleet) 를 병렬로 실행해 브랜치나 PR의 버그를 찾는 깊은 코드 리뷰입니다. 공식 문서상 "research preview" 기능으로 분류됩니다.
로컬 /review와 비교한 핵심 차별점:
- 높은 신호(Higher signal): 보고된 발견 항목을 모두 독립적으로 재현하고 검증하므로 스타일 제안이 아니라 실제 버그에 집중합니다.
- 넓은 커버리지(Broader coverage): 여러 리뷰어 에이전트가 변경분을 병렬로 훑어, 단일 패스 리뷰가 놓치는 문제까지 드러냅니다.
- 로컬 리소스 미사용: 리뷰를 원격 샌드박스에서 전부 돌리므로 진행 중에도 터미널은 다른 작업에 그대로 쓸 수 있습니다.
인자를 생략하면 현재 브랜치와 기본 브랜치의 diff(커밋되지 않은 변경·스테이징 변경 포함)를 리뷰하고, /code-review ultra <PR#> 형태로 특정 GitHub PR을 대상으로 실행할 수 있습니다.
최소 지원 버전
v2.1.86이상에서 사용 가능한 research preview 기능입니다(공식 ultrareview 문서 기준).- 참고:
/code-review스킬에서ultra인자를 포함한 전체 명령 표기는v2.1.154부터 문서화되었으며, 같은 버전부터/simplify가 버그 탐색 없이 정리만 수행하는 별도 리뷰로 분리되었습니다.
사용법
# 현재 브랜치 ↔ 기본 브랜치 diff 리뷰 (권장 표기)
/code-review ultra# 특정 GitHub PR 리뷰
/code-review ultra 1234# 별칭으로도 동일하게 동작
/ultrareview
/ultrareview 1234PR 모드에서는 로컬 워킹 트리를 번들링하는 대신 원격 샌드박스가 PR을 직접 클론합니다. github.com과 Claude Code에 연결된 GitHub Enterprise Server 인스턴스를 지원합니다. 저장소가 번들링하기에 너무 크면 Claude Code가 PR 모드 사용을 안내합니다(브랜치를 push하고 draft PR을 연 뒤 /code-review ultra <PR#> 실행).
실행 전 Claude Code는 리뷰 범위(브랜치 리뷰 시 파일·라인 수 포함), 남은 무료 실행 횟수, 예상 비용을 보여주는 확인 다이얼로그를 띄웁니다. 확인하면 백그라운드로 진행되고 세션은 계속 쓸 수 있습니다. 이 명령은 사용자가 직접 호출할 때만 실행되며, Claude가 알아서 ultrareview를 시작하지는 않습니다.
CI·스크립트용 비대화형 실행
대화형 세션 없이 CI나 스크립트에서 돌리려면 claude ultrareview 서브커맨드를 씁니다. /code-review ultra와 같은 리뷰를 실행하고, 원격 리뷰가 끝날 때까지 블로킹한 뒤 발견 항목을 stdout으로 출력하며, 성공하면 종료 코드 0, 실패하면 1로 끝납니다.
claude ultrareview # 현재 브랜치 ↔ 기본 브랜치 diff
claude ultrareview 1234 # PR 번호 지정
claude ultrareview origin/main # 비교 기준 브랜치 지정| 플래그 | 설명 |
|---|---|
--json | 포맷된 발견 항목 대신 원시 bugs.json 페이로드를 출력 |
--timeout <minutes> | 리뷰 완료를 기다리는 최대 분(기본값 30) |
진행 메시지와 라이브 세션 URL은 stderr로 나가 stdout 파싱을 방해하지 않습니다. 종료 코드는 완료 시 0, 실행 실패·원격 세션 오류·타임아웃 시 1, Ctrl-C 중단 시 130입니다.
좋은 사용 예
- 대규모 리팩터링 PR을 로컬
/review보다 더 깊게(병렬 멀티에이전트 + 독립 검증) 점검 - merge 직전 고위험 보안/성능 회귀를 여러 관점으로 검토
- 로컬 환경이 무거운 분석을 감당하기 어려울 때 클라우드 리뷰로 넘겨 터미널을 비워두기
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/code-review ultra | 클라우드 멀티에이전트 심화 리뷰(=/ultrareview) | 크고 위험한 변경 검토 |
/code-review | 로컬 diff에서 버그·정리 리뷰, --fix로 적용 | 일반 변경 리뷰 |
/review | 현재 세션의 로컬 단일 패스 리뷰 | 빠른 1차 검토 |
/simplify | 버그 탐색 없이 정리만 적용(v2.1.154+) | 클린업 목적일 때 |
/security-review | 보안 관점 집중 리뷰 | 보안 게이트가 목적일 때 |
활용 사례
- release branch merge 전 최종 게이트(검증된 발견 항목만 알림으로 반환)
- 테스트는 통과했지만 회귀 위험이 큰 구조 변경 PR 검토
- 리뷰는 보통 5~10분 소요되며 백그라운드 태스크로 실행됩니다.
/tasks로 진행/완료된 리뷰를 보거나 상세 보기, 진행 중 리뷰 중단이 가능합니다(중단 시 부분 발견 항목은 반환되지 않음).
주의사항
- 호출 방식: 권장 표기는
/code-review ultra이며/ultrareview는 제거되지 않고 별칭으로 유지됩니다(rename이 아닌 alias). - 무료 실행 횟수: Pro·Max는 계정당 1회성 무료 3회(갱신되지 않음), Team·Enterprise는 무료 제공 없음. 무료 횟수 소진 후에는 usage credits로 과금되며 변경 규모에 따라 보통 회당 약 $5~$20입니다. 원격 세션이 시작되면 1회로 카운트되므로, 조기 중단하거나 실패한 리뷰도 무료 횟수를 소모합니다(유료 리뷰는 실행된 부분만 과금).
- usage credits 필수: 무료 횟수 외에는 항상 usage credits로 과금되므로, 계정/조직에서 usage credits가 켜져 있어야 유료 리뷰를 실행할 수 있습니다. 꺼져 있으면 실행이 차단되고 결제 설정으로 안내합니다.
/usage-credits로 현재 설정을 확인·변경할 수 있습니다. - 인증·환경 제약: Claude.ai 계정 인증이 필요합니다(API 키만으로 로그인했다면
/login후 Claude.ai로 인증). Amazon Bedrock, Google Cloud Vertex AI, Microsoft Foundry 사용 시에는 제공되지 않으며, Zero Data Retention(ZDR)을 활성화한 조직에서도 사용할 수 없습니다. - 클라우드 기반: 로컬 세션 컨텍스트와 별개인 원격 샌드박스에서 동작하므로 저장소 상태를 번들링하거나 클론해 업로드합니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Ultrareview: https://code.claude.com/docs/en/ultrareview
- Extra usage for paid Claude plans: https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans