Claude Code ultrareview 써보니, 아무 커밋에나 쓸 건 아니었다

"버그 하나 놓치면 배포 후에 훨씬 크게 터진다"는 걸 아는 사람이라면 Claude Code의 ultrareview 얘기를 한 번쯤 들어봤을 겁니다. 근데 막상 찾아보면 명령어 이름부터 헷갈립니다. 지금은 /code-review ultra로 이름이 바뀌었고, /ultrareview는 예전 이름을 그대로 쓸 수 있게 남겨둔 별칭이거든요. 저도 처음엔 "왜 문서마다 이름이 다르지" 하면서 한참 헤맸는데, 직접 써보니 이름보다 중요한 건 "이걸 언제 써야 손해가 안 나는가"였습니다. 이번 글에서 실제로 확인한 가격, 소요 시간, 그리고 써보고 느낀 점을 정리해봤어요.

Claude Code 터미널에서 /code-review ultra 명령을 실행하는 화면

 

Claude Code ultrareview란, 로컬 리뷰와 뭐가 다른가

/code-review ultra는 Claude Code on the web 인프라 위에서 도는 딥 코드 리뷰 기능입니다. 실행하면 저장소 상태를 원격 샌드박스로 올리고, 그 안에서 여러 개의 리뷰어 에이전트 무리를 병렬로 띄워 버그를 찾습니다. 로컬에서 바로 도는 /code-review나 /review <pr>와 비교하면 공식 문서가 밝히는 차이는 세 가지예요.

첫째, 발견한 문제를 에이전트가 독립적으로 재현하고 검증한 뒤에만 최종 리포트에 넣습니다. 그래서 "이거 문제일 수도 있어요" 같은 추측성 지적이 줄고, 스타일 지적보다 실제로 동작에 영향을 주는 버그에 집중하게 됩니다. 둘째, 더 큰 규모의 에이전트 무리가 동시에 코드를 훑기 때문에 중간 강도의 로컬 리뷰가 놓칠 법한 이슈까지 잡습니다. 셋째, 전부 원격에서 돌기 때문에 로컬 자원을 하나도 안 쓰고, 리뷰가 도는 동안 터미널에서 다른 작업을 계속할 수 있습니다.

 

ultrareview 실행 방법: 대화형 명령과 CI용 CLI

인자 없이 /code-review ultra를 실행하면 현재 브랜치와 기본 브랜치 사이의 diff를 리뷰 대상으로 삼습니다. 커밋되지 않은 변경이나 staged 변경도 포함됩니다. /code-review ultra 1234처럼 PR 번호를 넘기면 로컬 워킹트리 대신 GitHub(또는 조직이 연결한 GitHub Enterprise Server)에서 해당 PR을 직접 클론해 리뷰하는 PR 모드로 바뀝니다. 저장소가 너무 커서 번들링이 안 되면 Claude Code가 PR 모드를 쓰라고 안내해주고, PR의 diff 자체가 너무 크면 시작 전에 범위를 좁히라는 안내와 함께 거절됩니다.

CI나 스크립트처럼 대화형 세션 없이 돌리고 싶으면 claude ultrareview 서브커맨드를 씁니다. 원격 리뷰가 끝날 때까지 블로킹하고 결과를 stdout으로 출력하며, 성공하면 종료 코드 0, 실패하면 1을 반환합니다. claude ultrareview origin/main처럼 비교할 베이스 브랜치를 지정할 수도 있고, --json 플래그로 원본 페이로드를, --timeout <분>으로 최대 대기 시간(기본 30분)을 정할 수 있습니다. 이 서브커맨드를 실행하는 순간 그 자체가 과금·약관 동의로 간주된다는 점은 알아두는 게 좋습니다.

/code-review ultra와 claude ultrareview CLI 실행 흐름 비교 다이어그램

 

ultrareview 가격과 무료 횟수, 생각보다 짜다

Pro와 Max 플랜은 계정당 평생 3회 무료 실행을 줍니다. 근데 이 3회, 리필이 안 됩니다. 다 쓰고 나면 매 리뷰가 usage credit으로 과금되는데 변경 규모에 따라 보통 5~20달러 수준이에요. Team과 Enterprise는 아예 무료 실행 없이 바로 usage credit으로 과금됩니다. 원격 세션이 시작되는 순간 1회로 카운트되기 때문에 중간에 중단하거나 실패해도 무료 횟수는 이미 소진됩니다. 다만 유료 리뷰라면 실제로 실행된 부분만큼만 과금된다는 게 그나마 위안이에요.

요구 사항도 확인해두는 게 좋습니다. Claude Code v2.1.86 이상이 필요하고, Claude.ai 계정 로그인이 필수입니다. API 키만으로는 못 씁니다. Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry 경유로 쓰거나 Zero Data Retention을 켠 조직이라면 이 기능 자체를 못 씁니다.

 

소요 시간, 공식 문서와 실사용 후기가 갈린다

공식 문서는 보통 5~10분이 걸린다고 밝히고 있어요. 백그라운드 작업이라 세션을 계속 쓰거나 다른 명령을 시작해도 되고, 터미널을 아예 닫아도 리뷰는 계속 돌아갑니다. /tasks 명령으로 진행 중이거나 끝난 리뷰 목록을 보고 중단할 수도 있는데, 중단하면 그 시점까지의 부분 결과는 반환되지 않습니다.

근데 MindStudio의 실사용 후기는 체감 소요 시간을 10~20분으로 보고합니다. 공식 수치보다 확실히 길게 느껴진다는 거죠. 저도 실제로 돌려보면서 "언제 끝나지" 하고 딴 작업을 하다가 알림이 뜨는 걸 보고 나서야 끝난 걸 알았습니다. 기다리는 동안 다른 일을 병행할 수 있다는 건 확실히 장점이지만, 5~10분이라는 숫자만 믿고 옆에서 기다리고 있으면 좀 답답할 수 있어요.

/tasks 명령으로 ultrareview 진행 상황을 확인하는 화면

 

실제로 써보니: 언제 쓰고 언제 아껴야 하나

MindStudio 쪽 실사용 가이드는 명확한 기준을 제시합니다. "프로덕션 버그 하나의 비용이 20달러를 넘는 커밋에만 아껴 써라"는 겁니다. 결제 흐름, 인증, 데이터베이스 마이그레이션, 출시 직전 코드처럼 실패했을 때 리스크가 큰 변경에만 쓰고, 평소에는 무료인 일반 /review를 쓰다가 결정적인 순간에만 유료인 /code-review ultra를 투입하라는 논리입니다. 시니어 엔지니어 2시간 몸값이면 이미 20달러를 넘기 때문에 고위험 코드에는 경제적으로 타당하다는 거예요.

이 가격 정책 자체를 "유익한 마찰(beneficial friction)"이라고 부르는 시각도 있습니다. /review는 공짜고 /code-review ultra는 진짜 돈이 드니까, 자연히 싼 도구는 평소에 쓰고 비싼 도구는 진짜 중요한 커밋에만 아껴 쓰게 된다는 거죠. 반대로 effloow.com 같은 비교 자료는 변경 규모에 따라 비용이 달라지는 구조를 "팀이 PR당 토큰 비용을 예측할 수 없다"는 약점으로 짚습니다. 같은 과금 구조를 두고 관점이 정반대로 갈리는 셈인데, 저는 개인 프로젝트 기준으로는 전자 쪽에 더 공감했습니다. 아무 커밋에나 돌리면 무료 3회는 순식간에 사라지거든요.

클라우드 샌드박스라서 생기는 한계도 있습니다. 프라이빗 패키지 레지스트리, 로컬 서비스, 하드웨어 의존성, 의도적으로 제한된 시크릿에는 접근하지 못합니다. 그래서 ChatGate 쪽 소개 글은 /code-review ultra를 "최종 승인 권한이 아니라 병합 전 신호(pre-merge signal)" 정도로 보는 게 적절하다고 정리하는데, 저도 이 표현이 제일 정확하다고 느꼈습니다.

 

헷갈리기 쉬운 별개 기능, Anthropic "Code Review"

이름이 비슷해서 자주 혼동되는 게 하나 더 있습니다. Anthropic이 2026년 3월 9일 출시한 "Code Review"라는 기능인데, 이건 /code-review ultra와 완전히 다른 상품입니다. GitHub 저장소에 직접 연결해서 모든 PR을 자동으로 리뷰하는 관리형 서비스로, Claude Code Team/Enterprise 고객 대상 리서치 프리뷰로 제공되고 PR당 15~25달러 수준입니다. /code-review ultra가 Pro/Max 개인 세션에서 사용자가 수동으로 실행하는 것과 대조적이죠.

작동 방식은 비슷합니다. 여러 에이전트가 로직 오류, 경계 조건, API 오용, 인증 결함, 프로젝트별 컨벤션 준수 같은 서로 다른 이슈 유형을 나눠 맡고, 각 발견 사항을 반증(disprove)하려 시도한 뒤에만 PR에 게시합니다. Anthropic은 테스트 기간 동안 "의미 있는 리뷰 코멘트가 달린 PR 비율이 16%에서 54%로 늘었다"고 밝혔고, "엔지니어가 틀렸다고 표시한 발견 사항은 1% 미만"이었다고 합니다. 다만 이 기능도 PR을 직접 승인하거나 막지는 않습니다. 최종 병합 결정은 여전히 사람 몫이에요.

 

AI 코드 리뷰 경쟁 도구와 비교하면 어디쯤일까

가격 구조를 비교한 effloow.com 자료를 보면, 대부분의 경쟁 도구는 사용자당 월정액입니다. CodeRabbit Pro는 연간 결제 기준 사용자당 월 24달러(사용량 기반 애드온 별도), Qodo Teams는 연간 결제 기준 사용자당 월 30달러(사용자당 월 20건 PR 상한), GitHub Copilot Pro는 사용자당 월 10달러지만 2026년 도입된 사용량 기반 과금에서는 리뷰가 크레딧을 소모합니다. 변동 과금인 Anthropic Code Review와는 계산 방식 자체가 다른 셈이죠.

이 자료는 Anthropic Code Review의 강점으로 "이미 Claude Code에 표준화된 조직"과 "복잡한 로직 리뷰에 유리한 멀티 에이전트 구조"를 꼽고, 약점으로는 예측 불가능한 토큰 비용과 아직 전면 공개가 아니라는 점을 지적합니다. PR 건수가 많아 고정 예산이 필요한 팀이나 GitLab·Bitbucket처럼 GitHub가 아닌 플랫폼을 쓰는 팀에는 안 맞는다는 결론이었어요. 참고로 CodeRabbit과 GitHub Copilot Code Review를 직접 비교한 별도 벤치마크(morphllm.com)에서는 CodeRabbit이 F1 스코어 51.5%로 Copilot의 44.5%를 앞섰고, 버그 재현율도 52.5% 대 36.7%로 우세했다고 하는데, 이 벤치마크에는 Claude Code 계열이 포함되지 않았습니다.

 

자주 묻는 질문

Q. `/ultrareview`랑 `/code-review ultra`는 다른 명령인가요?
아닙니다. /code-review ultra가 현재 공식 이름이고 /ultrareview는 이전 이름을 그대로 쓸 수 있게 남겨둔 별칭입니다.

Q. 무료 3회를 다 쓰면 이제 어떻게 되나요?
usage credit으로 과금되고, 변경 규모에 따라 보통 5~20달러 수준입니다. Team/Enterprise는 애초에 무료 실행이 없습니다.

Q. API 키만 있으면 쓸 수 있나요?
안 됩니다. Claude.ai 계정 로그인이 필수이고, API 키만 로그인된 상태라면 /login으로 다시 인증해야 합니다.

Q. 리뷰 도중에 취소하면 무료 횟수가 아깝지 않나요?
아깝습니다. 원격 세션이 시작되는 순간 1회로 카운트되기 때문에 중단해도 무료 횟수는 이미 소진되고, 그 시점까지의 부분 결과도 받을 수 없습니다.

써보고 나서 든 결론은 하나예요. /code-review ultra는 매 커밋마다 돌리는 습관용 도구가 아니라, "이거 하나는 확실히 짚고 넘어가야 한다" 싶은 순간을 위해 아껴두는 도구입니다. 결제·인증·마이그레이션처럼 무거운 브랜치를 앞두고 있다면 남은 무료 횟수부터 /tasks 근처에서 한번 확인해보세요.