서론: Ultrareview란 무엇인가

Claude Code에서 코드 리뷰를 요청하려고 하면, 비슷한 이름의 명령어가 여러 개 나와 혼란스러울 때가 있습니다.

/review

와 /code-review

는 같은 것인가? /ultrareview

와 /code-review ultra

는? claude ultrareview

라는 서브 커맨드(subcommand)도 있고, GitHub에 봇이 댓글을 다는 Code Review라는 것도 따로 존재하며...

본 기사에서는 먼저 Ultrareview의 구조·사용법·요금·제약을 해설하고, 그 후에 유사한 기능과의 차이점을 정리합니다.

한마디로 요약하자면, Ultrareview는 다음과 같은 기능입니다.

/code-review ultra

는 Anthropic의 클라우드 상에서 여러 AI 리뷰어(reviewer)가 병렬로 버그를 찾고, 발견한 버그를 별도의 공정에서 독립적으로 "재현·검증"한 뒤에 보고하는, Claude Code의 머지(merge) 전 딥 코드 리뷰(deep code review) 기능입니다.

로컬에서 동작하는 기존의 /code-review

가 "빠름·얕음·거의 무료"인 것에 반해, Ultrareview는 "느림·깊음·유료"라는 위치에 있습니다. 이름은 비슷하지만, 완전히 다른 도구라고 생각하는 것이 정확합니다.

핵심은 "2단계 구조" — LLM 리뷰의 약점을 구조적으로 해결

일반적인 LLM 코드 리뷰에는 두 가지 구조적인 약점이 있습니다.

할루시네이션 (Hallucination): 그럴듯하지만 실재하지 않는 지적을 보고함 -
스타일 노이즈 (Style noise): 명명 규칙(naming) 선호도나 포맷 등, 가치가 낮은 지적으로 인해 노이즈가 증가함

Ultrareview는 이를 **탐지 단계 (detection phase)**와 **검증 단계 (verification phase)**의 2단계 구조로 구조적으로 해결합니다.

메커니즘: 탐지 → 독립 검증 파이프라인

/code-review ultra

를 실행하면 다음과 같은 파이프라인이 클라우드 상에서 동작합니다.

리포지토리를 번들링(bundle) → 원격 샌드박스(remote sandbox)에 업로드
↓
【탐지 단계 (병렬)】
...

탐지 단계에서는 다수의 에이전트(agent)가 다각적으로 동일한 차이점(diff)을 병렬 탐색합니다. 단일 패스(single pass) 리뷰가 놓치기 쉬운 복잡한 상태 전이(state transition)나 엣지 케이스(edge case)의 조합을 관점을 분산시켜 포착합니다.

검증 단계가 Ultrareview의 최대 특징입니다. 어떤 에이전트가 "버그가 있다"라고 보고하더라도, 별도의 공정에서 독립적으로 재현·검증할 수 없다면 보고되지 않습니다. 이를 통해 스타일 제안이나 할루시네이션이 아닌 실재하는 버그로만 결과가 압축됩니다.

리뷰는 원격 샌드박스에서 완전히 실행되므로, 로컬 머신의 리소스를 소비하지 않습니다. 리뷰 중에도 터미널에서 다른 작업을 할 수 있습니다.

사용법

Step 1: 현재 브랜치를 리뷰하기

커밋된 것과 커밋되지 않은 것을 모두 포함하여, 기본 브랜치(default branch)와의 차이점이 리뷰 대상이 됩니다.

> /code-review ultra

Step 2: PR을 지정하여 리뷰하기

PR 번호를 전달하면, 원격 샌드박스가 GitHub에서 직접 클론(clone)하여 리뷰합니다. 로컬의 워킹 트리(working tree)는 사용하지 않습니다.

> /code-review ultra 1234

Step 3: 탐지한 findings를 자동 적용하기

--fix

를 붙이면, 발견한 문제를 세션으로 돌아온 시점에 워킹 트리(working tree)에 적용합니다.

> /code-review ultra --fix

Step 4: 결과 확인하기

리뷰는 보통 5~10분 내에 완료됩니다. /tasks

로 진행 상황을 확인할 수 있으며, 완료되면 세션 내에 알림으로 결과가 표시됩니다. 각 탐지 결과에는 파일 위치와 문제 설명이 포함되어 있으므로, 그대로 Claude에게 수정을 요청할 수 있습니다.

요금

Ultrareview는 플랜에 포함된 사용량과는 별개로, 추가 사용량 (usage credits) 으로 청구되는 프리미엄 기능입니다.

어디에 사용해야 하는가 — 비용 대비 효과의 판단 기준

1회 $5~$20의 비용을 어떻게 생각할 것인가의 문제인데, "운영 환경에서 버그가 발생했을 때 $20 이상의 손실이 발생하는 변경 사항"으로 범위를 좁히는 것이 정석입니다.

구체적으로는 다음과 같은 변경 사항이 Ultrareview의 진가를 발휘하는 상황입니다.

인증·인가 (Authentication/Authorization): 로그인, 세션 관리, 권한 체크 -
DB 마이그레이션 (DB Migration): 스키마 변경, 데이터 이관 -
결제·과금 (Payment/Billing): 금액 계산, 청구 로직

반대로, 문서 수정이나 CSS 조정과 같은 경미한 PR (Pull Request)은 기존의 /code-review로도 충분합니다.

제약 사항 — 이 부분이 가장 중요합니다

Ultrareview는 "Claude Code on the web" 인프라 위에서 동작하기 때문에, 인증과 실행 환경에 큰 제약이 있습니다.

Claude.ai 인증 필수

API 키만으로 로그인한 경우에는 실행할 수 없습니다. /login을 통해 Claude.ai 계정에 별도로 로그인해야 합니다. 평소 Vertex AI (Anthropic Vertex SDK)나 Bedrock을 통해 메인으로 이용하는 환경에서는, 결제와 인증이 별도의 체계로 운영된다는 점에 주의하십시오.

일부 환경에서는 이용 불가

코드가 클라우드로 업로드됨

브랜치 모드(Branch mode)에서는 리포지토리의 차이점(diff)이 번들링되어 Anthropic의 원격 샌드박스(Remote Sandbox)로 업로드됩니다. PR 모드에서는 샌드박스가 GitHub에서 직접 클론(Clone)합니다. 어느 경우든 소스 코드가 Anthropic 측 인프라로 전송되므로, 사내 데이터 반출 및 보안 정책 확인이 전제되어야 합니다.

CI / 스크립트를 통한 자동 실행

claude ultrareview는 /code-review ultra와 동일한 리뷰를 대화형 세션 없이 실행하는 CLI 서브 커맨드(Subcommand)입니다. 리뷰가 완료될 때까지 대기하며, 결과를 stdout에 출력합니다.

# 현재 브랜치를 리뷰
claude ultrareview
# PR을 지정하여 리뷰
...

종료 코드(Exit code)로 리뷰 결과를 판정할 수 있습니다.

CI 연동 예시

GitHub Actions에서 머지(Merge) 전에 Ultrareview를 실행하는 설정 예시입니다.

name: Ultrareview
on:
  pull_request:
    ...

유사한 기능과의 차이점

Claude Code에는 리뷰 관련 기능이 여러 개 있으며, 이름도 비슷합니다. 또한 "Dynamic Workflow로 자체 리뷰를 구성하는" 선택지도 있습니다. 여기서 전체적인 모습을 정리합니다.

Dynamic Workflow로 직접 만든 리뷰와의 차이

Dynamic Workflow는 범용 멀티 에이전트 (Multi-agent) 기반입니다. 스크립트를 작성하면 리뷰 용도로도 사용할 수 있지만, Ultrareview와는 설계 사상이 다릅니다.

가장 큰 차이점은 검증 공정(Verification process)이 내장되어 있는지 여부입니다. Ultrareview는 검출 결과를 독립된 공정에서 재현 및 검증하는 메커니즘이 처음부터 내장되어 있습니다. Dynamic Workflow로 직접 제작할 경우, 검증 단계의 설계(어떻게 독립성을 보장할지, 어떤 입도(Granularity)로 재현을 시도할지)는 모두 직접 고민해야 합니다.

반면, 보안 정책상 코드의 외부 전송이 금지되어 있거나 Vertex AI / Bedrock 환경에서는 Ultrareview를 사용할 수 없기 때문에, Dynamic Workflow로 직접 제작하는 것이 현실적인 선택지가 됩니다. 비용 또한 통상적인 사용량 범위 내에 머물기 때문에, 리뷰를 빈번하게 돌리고 싶다면 직접 제작하는 것이 더 경제적입니다.

전체 명령어 목록

역사적인 경위로 남아 있는 구 명칭도 있습니다.

비교표

Code Review (GitHub App)에 대한 보충 설명

Code Review는 CLI를 거치지 않고 GitHub PR과 직접 통합하는 기능입니다. 관리자가 GitHub App을 설치하면, PR 생성 시나 푸시(Push) 시에 자동으로 리뷰가 실행되며, 발견 사항(findings)이 인라인 코멘트로 게시됩니다. 수동으로 @claude review라고 코멘트하여 트리거하는 것도 가능합니다.

발견 사항(findings)에는 3단계의 중요도가 부여됩니다.

REVIEW.md 파일에서 중요도의 정의, Nit의 상한 수, 스킵할 경로, 리포지토리 고유의 체크 항목 등을 커스터마이징할 수 있습니다.

어떤 상황에서 무엇을 사용할 것인가

개발 플로우에 대입하면 다음과 같은 사이클이 됩니다.

코딩 중 → /code-review로 빠르게 확인
↓
정리 → /simplify로 클린업
...

관련 기능: ultraplan

Ultrareview가 '머지 전의 버그 검출'이라면, ultraplan은 '착수 전의 설계·계획'을 담당하는 클라우드 측의 카운터파트(Counterpart)입니다. CLI를 통해 클라우드 상에 플랜을 생성하고, 웹 에디터에서 팀원들과 리뷰 및 코멘트를 나눈 뒤, 원격(Remote)에서 실행하거나 로컬로 가져오는 흐름으로 사용합니다.

규모가 큰 변경의 경우, "ultraplan으로 설계를 확정 → 구현 → ultrareview로 최종 확인"하는 흐름이 효과적입니다.

요약

Ultrareview (/code-review ultra)는 클라우드 상의 여러 에이전트가 버그를 병렬로 탐지하고, 독립적인 검증을 통해 오탐(False Positive)을 제거한 후 보고하는, 머지(Merge) 전 단계의 딥 코드 리뷰 (Deep Code Review) 기능입니다.

유사한 기능들과의 위치를 한마디로 정리하면 다음과 같습니다:

• /code-review: 로컬에서 빠름. 개발 중 빠른 확인에 적합
• /code-review ultra: 클라우드에서 깊이 있게 분석. 머지 전 중요한 변경 사항에 적합
• /simplify: 버그를 찾지 않음. 코드 정리 전용
• claude ultrareview: /code-review ultra의 CI용 비대화형(Non-interactive) 버전
• Code Review (GitHub App): PR(Pull Request)에 자동으로 댓글을 남김. 팀 운영에 적합

비용 효율적인 사용법은 인증, DB 마이그레이션(Migration), 결제 등 "운영 환경에서 버그가 발생할 경우 $20 이상의 손실이 발생하는 변경 사항"으로 범위를 좁히는 것입니다. 현재 리서치 프리뷰(Research Preview) 단계이지만, Pro / Max 사용자에게는 3회의 무료 실행 권한이 부여되어 있으니 우선 직접 시도해 보시기 바랍니다.

Discussion