Cmd. /ultrareview
클라우드 샌드박스에서 멀티에이전트로 깊은 코드 리뷰를 수행하는 명령(현재 권장 호출은 /code-review ultra, /ultrareview는 별칭)
핵심 요약
- cloud deep review,
/code-review ultra권장 alias - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
cloud deep review, /code-review ultra 권장 alias
/ultrareview [PR or branch]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 별칭 |
| 상태 | 조건부 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
권장 호출은 /code-review ultra입니다. Pro·Max의 무료 3회 이후 usage credits가 필요합니다.
사용 예
/code-review ultra# 현재 브랜치 ↔ 기본 브랜치 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 | 보안 관점 집중 리뷰 | 보안 게이트가 목적일 때 |
실행 결과와 유지 범위
클라우드 샌드박스에서 심층 검토를 실행합니다. 포함된 무료 실행을 소진하면 usage credits가 필요합니다.
/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을 대상으로 실행할 수 있습니다.
리뷰 실행
별도 tuned 설정이 없는 모델의 /code-review는 많은 review subagent 대신 간결한 inline prompt를 사용합니다(v2.1.274). claude -p 등 확인을 받을 수 없는 실행은 base branch·shared history가 없을 때 전체 저장소 리뷰를 거절합니다. 사용자가 직접 실행한 claude ultrareview는 전체 저장소 fallback 동의로 취급하지만, Claude가 도구로 대신 실행한 경우에는 거절합니다. 첫 커밋 리뷰는 대화형 확인이 필요합니다(v2.1.277).
댓글 게시 동작
/ultrareview --post는 findings가 도착하면 PR 댓글을 직접 게시하고 링크를 출력합니다. 게시를 위한 두 번째 cloud session은 만들지 않습니다. PR에 결과를 공개하려는 경우에만 --post를 사용하세요.
공식 Changelog · 2026-09-12 KST
주의사항
- 호출 방식: 권장 표기는
/code-review ultra이며/ultrareview는 제거되지 않고 별칭으로 유지됩니다(rename이 아닌 alias). - 무료 실행 횟수: Pro·Max는 계정당 1회성 무료 3회(갱신되지 않음), Team·Enterprise는 무료 제공 없음. 무료 횟수 소진 후에는 usage credits로 과금되며 변경 규모에 따라 보통 회당 약 $5~$25입니다. 원격 세션이 시작되면 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)을 활성화한 조직에서도 사용할 수 없습니다. - 클라우드 기반: 로컬 세션 컨텍스트와 별개인 원격 샌드박스에서 동작하므로 저장소 상태를 번들링하거나 클론해 업로드합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록