Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# 한 브랜치에서 Claude Code Ultrareview를 실행하고 지적 사항 검증하기

> Claude Code 클라우드 검토를 한 번 실행하기 전에 저장소 업로드와 크레딧을 확인하고, 사람이 병합을 결정하기 전 지적 사항을 브랜치와 대조하는 문서 기반 안내입니다.

By BIG CHANGE Editorial

Published: 2026-10-20T11:00:41.997Z
Updated: 2026-10-20T11:00:41.997Z
Canonical: https://bigchange.ai/blog/claude-code-ultrareview-branch-findings-guide

![Conceptual charcoal illustration of an orange network cable connecting a desktop computer tower to a wall port.](https://bigchange.ai/api/media/file/ultrareview-repository-upload-boundary-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code의 Ultrareview는 사람이 병합을 결정하기 전 기존 Git 브랜치를 Anthropic 클라우드에서 조사할 수 있습니다. 중요한 질문은 버그를 찾는지에만 그치지 않습니다. 저장소의 어떤 내용이 기기를 떠나는지, 실행 비용은 얼마인지, 각 지적을 코드로 검증할 수 있는지도 봐야 합니다. 이 안내는 큰 브랜치를 검토할 권한이 있고 조직 규칙에 따라 저장소를 업로드할 수 있는 사람을 위한 것입니다. 내용은 [Anthropic의 현재 연구 미리보기 설명서](https://code.claude.com/docs/en/ultrareview)를 따릅니다. BIG CHANGE는 명령을 실행하거나 지적 사항을 테스트하지 않았습니다.

## 큰 변화

- **달라진 점:** `/code-review ultra`는 현재 브랜치를 기본 브랜치 또는 지정한 기준과 비교해 클라우드에서 검토하며, 스테이징된 변경과 커밋하지 않은 변경도 포함합니다.
- **중요한 이유:** 기존 변경에서 파일별 문제를 돌려줄 수 있지만, 브랜치 방식은 저장소 상태도 업로드합니다. 눈에 보이는 diff만으로 기기를 떠나는 내용을 판단할 수 없습니다.
- **살펴볼 점:** 이용 가능 여부, 업로드 범위, 일회성 무료 실행 횟수, 사용 크레딧 추정치는 바뀔 수 있습니다. 지적 사항은 여전히 로컬 검증이 필요하며, 지적이 없는 검토도 브랜치에 버그가 없다는 증거는 아닙니다.

### 1. 브랜치와 원래 확인 방법 정하기

변경이 들어 있는 저장소에서 시작하세요. 현재 브랜치, 의도한 기준, 수용 조건, 프로젝트의 기존 테스트 또는 빌드 명령을 기록합니다. 추적 파일의 스테이징된 수정과 커밋하지 않은 수정까지 전체 diff를 살펴보세요. 기준을 지정하지 않으면 현재 브랜치를 기본 브랜치와 비교하고, 다른 기준을 지정하면 비교 대상이 바뀝니다. 지적 사항을 고친 후 같은 확인을 반복하도록 최초 결과를 보관합니다.

정말 검토하려는 브랜치인지 확인하세요. 비교 결과가 비어 있으면 거부됩니다. 첫 커밋이거나 공통 병합 기준이 없는 브랜치는 설명서의 확인 절차와 한도에 따라 모든 추적 파일이 대상이 될 수 있습니다. 의도한 검토가 아니라면 시작 전 브랜치나 기준을 수정하세요. 현재 문서상 기본 한도는 변경 파일 500개와 변경 줄 8,000개이며, 실제 거부 메시지가 적용 중인 한도를 알려줍니다.

### 2. 저장소를 클라우드로 보내도 되는지 결정하기

[Anthropic의 업로드 규칙](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github)은 전체 복제 번들을 **모든 브랜치**의 저장소 기록과 추적 파일의 커밋하지 않은 변경으로 설명합니다. 추적하지 않는 파일은 의도적으로 추가하지 않는 한 제외됩니다. 네이티브 Windows에서는 파일명이 자격 증명처럼 보여도 추적 파일의 커밋하지 않은 수정이 업로드됩니다. macOS, Linux, WSL에서는 일부 민감한 미커밋 수정을 생략하지만 커밋된 내용은 기록에 남습니다. 코드 정책에 따라 저장소 기록과 추적 수정을 조사하세요. 어느 쪽에든 업로드 권한이 없는 내용이 있다면 보존한 채 멈춥니다. 검토 diff가 작다는 사실만으로 이 결정을 내릴 수는 없습니다.

문서의 번들 한도는 100 MB 미만입니다. 더 크면 Claude Code가 현재 브랜치, 이어서 기록을 합친 작업 트리 스냅샷으로 대체하거나 실패할 수 있습니다. 대체 방식을 수락하기 전 실제 범위를 확인하세요. `github.com`의 pull request 검토는 별도 경로로, 로컬 작업 트리를 업로드하는 대신 클라우드 샌드박스가 연결된 GitHub 계정으로 PR을 복제합니다.

계정 자격도 확인하세요. Ultrareview는 `claude.ai` 로그인이 필요하며 API key만으로는 인증할 수 없습니다. 현재 설명서는 Bedrock, Google Cloud Agent Platform, Microsoft Foundry, Zero Data Retention 및 HIPAA 구성을 제외하며, 고객 관리 암호화 키도 사용을 막습니다. 일부 제외 조건에서는 명령이 대신 **로컬** 검토를 실행합니다. 클라우드를 쓸 수 없으면 결과 종류를 정확히 표시하세요. 별도의 [로컬 `/code-review` 워크플로](https://code.claude.com/docs/en/code-review-local)를 승인받은 로컬 검토에 사용할 수 있습니다.

### 3. 시작 대화상자를 읽고 한 번의 실행 승인하기

검토할 브랜치의 대화형 Claude Code 세션에서 입력하세요.

```text
/code-review ultra
```

검토한 다른 기준, 예를 들어 `develop`를 쓸 때는 다음을 입력하세요.

```text
/code-review ultra develop
```

명령의 대상은 경로가 아니라 브랜치 비교입니다. 대화상자의 브랜치, 기준, 변경 파일 및 줄 수, 남은 무료 횟수, 예상 사용 크레딧을 2단계에서 확인한 업로드 범위와 함께 읽으세요. 비교, 업로드 권한, 추정치가 맞지 않으면 멈춥니다. 명령은 호출하고 확인한 뒤에만 시작합니다.

Anthropic은 현재 Pro 및 Max 계정에 세 번의 **일회성** 무료 실행을 안내합니다. 이후 실행은 설명서에 따르면 보통 5\~25달러 상당의 사용 크레딧을 쓰며, 계정의 시작 시점 추정치가 판단 기준입니다. 유료 검토에는 사용 크레딧 활성화가 필요합니다. 클라우드 세션이 시작되면 한 번으로 계산합니다. 무료 실행을 중지해도 횟수는 소모되며, 유료 작업은 실행된 부분만큼 청구될 수 있습니다. 기능, 가격, 이용 가능 여부는 연구 미리보기 조건이므로 여기의 고정 금액으로 예산을 정하지 말고 현재 대화상자를 확인하세요.

### 4. 같은 실행을 추적하고 각 지적 사항 조사하기

설명서는 검토가 보통 15\~25분 걸리며 백그라운드에서 진행된다고 안내합니다. `/tasks`를 사용해 진행 중이거나 끝난 검토를 확인하고, 세션 알림에서 지적 사항을 봅니다. 터미널이 조용하다고 두 번째 검토를 시작해서는 안 됩니다. 검토를 중지하면 부분적인 지적 사항도 반환되지 않습니다. 세션이 보이지 않으면 중지, 보관, 삭제 여부와 로그인 계정 변경 여부를 확인하세요. 비대화형 명령이 시간 초과되어도 클라우드 실행은 살아 있을 수 있습니다. 다른 무료 또는 유료 실행을 고려하기 전 원래 실행의 상태부터 확정합니다.

각 지적에서 인용한 파일과 위치를 여세요. 주장을 의도한 동작과 비교하고 재현할 수 있다면 해당 부분의 확인을 실행합니다. 수정, 오탐, 수용한 절충안, 미해결 질문을 근거 코드 및 확인 결과와 함께 기록하세요. Claude가 수정을 제안하면 수락하기 전에 diff를 봅니다. Anthropic은 검토 에이전트가 보고된 문제를 검증한다고 설명하지만, 공급업체의 설명이 직접 확인을 대신하지는 않습니다. 지적 없이 완료된 검토는 검토 결과이지 버그가 없다는 증거가 아닙니다.

### 5. 최종 브랜치를 바탕으로 병합 결정하기

수정 후 의도한 기준에 대한 최종 diff 전체를 봅니다. 원래 수용 명령과 지적 평가에 사용한 표적 확인을 다시 실행하고, 실패를 포함해 실제 결과를 기록하세요. 실패하거나 문제가 남은 브랜치는 소유자가 다음 조치를 결정할 때까지 병합하지 않습니다. 사람 검토자 또는 소유자가 병합을 결정합니다. 추가 Ultrareview는 무료 횟수나 크레딧을 별도로 소모하는 독립 실행이므로, 변경된 코드에 필요할 때만 정당합니다.

이것은 이미 개발한 브랜치에 대한 클라우드 검토 단계입니다. 설계, 구현, 브랜치 검토의 더 넓은 흐름은 BIG CHANGE의 [Superpowers 안내](https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide)를 보세요.

## 출처 및 추가 읽을거리

- [Anthropic, 「ultrareview로 버그 찾기」](https://code.claude.com/docs/en/ultrareview)는 명령, 브랜치와 기준 범위, 계정 제한, 대화상자, 가격, 작업 추적, 한도, 지적 사항을 설명합니다. 연구 미리보기 제품 설명서이며, BIG CHANGE가 검토를 실행했거나 특정 브랜치가 안전하다는 증거는 아닙니다.
- [Anthropic, 「클라우드에서 Claude Code 사용하기」](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github)는 번들, 기록, 플랫폼별 추적 파일 처리, 추적하지 않는 파일, 크기별 대체 방식을 설명합니다. 독자는 업로드 전 실제 저장소와 정책을 확인해야 합니다.
- [Anthropic, 「/code-review로 로컬 검토하기」](https://code.claude.com/docs/en/code-review-local)는 클라우드 검토를 쓸 수 없거나 필요하지 않을 때의 별도 로컬 경로를 설명합니다. 결과를 Ultrareview 지적 사항으로 보고해서는 안 됩니다.

## Sources

- [ultrareview로 버그 찾기 — Claude Code Docs](https://code.claude.com/docs/en/ultrareview) — 클라우드 명령, 범위, 계정 제외 조건, 대화상자, 한도, 크레딧, 작업 추적, 지적 사항의 일차 자료입니다. 특정 검토가 실행되거나 버그를 찾았다는 사실을 증명하지 않습니다.
- [클라우드에서 Claude Code 사용하기 — Claude Code Docs](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github) — 전체 복제 기록, 추적 및 비추적 수정, 플랫폼별 민감 파일 처리, 번들 크기와 대체 규칙의 일차 자료입니다. 독자의 업로드 권한을 확정할 수는 없습니다.
- [/code-review로 로컬 검토하기 — Claude Code Docs](https://code.claude.com/docs/en/code-review-local) — 별도 로컬 워크플로의 일차 자료이며, 완료된 클라우드 Ultrareview로 표현해서는 안 됩니다.