Markdown 버전

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

# Claude Code 팀은 변경 위험에 따라 사람의 검토를 배정한다

> Anthropic이 Claude Code 팀의 검토 절차와 내부 되돌리기 지표를 설명했다. 공개 검토 서비스는 발견 사항을 제공하며, 테스트·사람의 승인·복구는 여전히 각 팀이 설정해야 한다.

By BIG CHANGE Editorial

Published: 2026-10-17T05:58:13.542Z
Updated: 2026-10-17T05:58:13.542Z
Canonical: https://bigchange.ai/blog/claude-code-team-review-risk-approval-workflow

![Conceptual charcoal illustration of one reviewer seen from behind, examining indented code rows with orange marks on a supported physical monitor.](https://bigchange.ai/api/media/file/claude-code-human-review-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; not an Anthropic office, product screenshot or record of a hands-on test.

Anthropic의 Claude Code 팀은 6월부터 9월 사이 병합된 풀 리퀘스트 수가 두 배를 넘었고, 되돌린 비율은 40% 넘게 줄었다고 밝혔다. [10월 15일 설명](https://claude.dev/blog/solving-code-review-at-anthropic/)에서는 Anthropic의 주 모노레포와 분리된 저장소에서 위험에 맞춰 사람의 승인을 조정하는 방식을 소개한다. 이는 팀 자체 지표이며 무엇이 개선을 일으켰는지 입증하지는 않는다.

엔지니어링 책임자는 공개된 [Code Review 서비스](https://code.claude.com/docs/en/code-review)로 발견 사항을 모으면서 병합 요건은 직접 정할 수 있다. 서비스는 의심되는 결함을 보고하고, 어떤 검사와 사람이 변경 사항의 배포를 허용할지는 팀이 결정한다.

## 큰 변화

- **달라진 점:** AI 검토는 제안된 변경과 주변 코드를 살펴보고, 의심되는 버그를 검증한 뒤 검증을 통과한 발견 사항을 관련 줄 옆에 표시할 수 있다. 에이전트가 코드를 만들어 내는 상황에서 엔지니어링 팀에 검토 근거를 하나 더 제공한다.
- **중요한 이유:** 공개 검토 서비스는 코드를 실행하지 않고 읽으며 배포 권한을 부여하지 않는다. 테스트와 저장소 승인 규칙은 엔지니어링 책임자가 별도로 설정해야 한다.
- **지켜볼 점:** 검토 빈도는 지출에 영향을 주고 예산 한도 때문에 검토가 건너뛰어질 수 있다. 서비스를 도입하는 팀은 검토가 끝났고 문제가 발견되지 않은 경우와 검토가 아예 실행되지 않은 경우를 구분해야 한다.

## 내부 절차는 위험에 따라 승인 요건을 정한다

이 [Claude Code 팀의 절차](https://claude.dev/blog/solving-code-review-at-anthropic/#layer-by-layer)는 테스트, 에이전트 검토, 보안 검토, 지속적 통합을 결합한다. 단계적 배포 전에 병합 대기열을 거치며, 기능 플래그와 롤백으로 복구한다.

신뢰하는 작성자에게 적용하는 승인 정책은 다음과 같다.

| 변경 위험 | 자동 검사 후 필요한 사람의 승인 |
| --- | --- |
| 낮음: 문구와 내부 전용 기능 포함 | 없음 |
| 중간: 일반적인 제품 변경 포함 | 한 명 |
| 높음 및 검토자 두 명이 필요하도록 지정한 경로 | 두 명 |

에이전트를 지휘하는 사람은 필요 인원에 포함되지만 에이전트의 승인은 포함되지 않는다. 승인은 특정 커밋에 적용된다. 세 차례 검토가 끝나면 검토자가 작성자에게 접근법을 다시 생각해 달라고 요청한다. 이후 검토는 새 diff로 범위를 좁힌다. 되돌리기와 사고는 관리 지표로 쓰이지만, 지표가 나빠질 때 승인 요건을 자동으로 강화하는 장치는 아직 없다.

## 공개 검토 서비스가 하는 일

현재 [Code Review 설명서](https://code.claude.com/docs/en/code-review)는 여러 에이전트가 Anthropic 인프라에서 diff와 주변 코드를 읽는다고 설명한다. 검증 단계가 제안된 발견 사항을 확인한 뒤 서비스가 중복을 없애고 심각도를 매겨 댓글과 검사 실행 결과를 게시한다. 코드를 빌드하거나 실행하지 않고 읽는다. 이 검사 실행은 풀 리퀘스트를 실패 처리하지 않으며 서비스는 이를 승인하거나 차단하지도 않는다.

이용하려면 Team 또는 Enterprise 조직과 GitHub 저장소가 필요하다. 설명서는 Zero Data Retention, HIPAA 구성 또는 고객 관리 암호화 키를 쓰는 조직을 제외한다. 독점 소스 코드를 검토에 보내기 전에 살펴야 할 제한이다. BIG CHANGE는 문서를 검토했으며 이 작업 흐름을 배포하거나 시험하지 않았다.

이 [설정 안내](https://code.claude.com/docs/en/code-review-setup)는 Claude 조직의 Owner, 앱 설치와 연결을 맡을 GitHub 조직 소유자, 저장소 추가에 필요한 쓰기 권한을 요구한다. 앱은 검토 자체가 사용하는 것보다 넓은 권한을 요청한다. 관리자는 Quick, Standard, Deep 검토와 함께 풀 리퀘스트마다 한 번, push마다 또는 요청할 때 실행할지를 고른다. 자동 검토는 초안과 포크를 건너뛰며 쓰기 권한이 있는 사람은 수동으로 요청할 수 있다.

## 지침과 규칙 집행은 역할이 다르다

이 [사용자 지정 설명서](https://code.claude.com/docs/en/code-review-customize)는 `CLAUDE.md` 파일이 제공하는 프로젝트 맥락과 `REVIEW.md` 파일이 정하는 검토 전용 우선순위·제외 항목을 구분한다. 서비스는 대상(base) 브랜치나 기본(default) 브랜치에서 검토 지침을 읽으며 제안된 변경 자체에서는 읽지 않는다. 로컬 `/code-review` 명령은 `CLAUDE.md` 파일을 읽지만 `REVIEW.md` 파일은 읽지 않는다. 따라서 두 도구에 공통으로 적용할 지침은 `CLAUDE.md` 파일에 넣어야 한다.

저장소 규칙이 요건을 집행한다. [GitHub의 브랜치 보호 문서](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)는 필수 상태 검사, 코드 소유자 승인, 검토 대화의 해결을 설명한다. 검토한 diff가 달라지면 승인을 무효화하는 기능도 지원한다. 관리자에게도 규칙을 적용하지 않는 한 관리자는 보통 보호를 우회할 수 있다. 따라서 엔지니어링 책임자는 검토 서비스의 댓글과 함께 실제 적용 규칙과 우회 권한을 확인해야 한다.

문서에 따르면 공개 검토 서비스는 애플리케이션 테스트 통과나 필수 사람 승인 어느 쪽도 제공하지 않는다. 이 기록들을 분리하면 병합에 어떤 근거가 쓰였는지 확인할 수 있다.

## 실제로 실행된 검토를 측정하라

[Code Review 과금](https://code.claude.com/docs/en/code-review-costs)은 사용 크레딧을 통해 토큰을 기준으로 계산하며 요금제에 포함된 사용량과 별개다. Anthropic은 검토 한 건당 고정 가격을 공개하지 않는다. 비용은 검토 깊이, 변경과 주변 코드, 검증이 필요한 발견 사항에 따라 달라진다. push마다 검토하면 같은 풀 리퀘스트의 검토 횟수가 늘어난다.

비용 설명서는 제한된 시범 도입, 월 지출 한도, 저장소의 평균 비용 측정을 권한다. 서비스 한도, 조직 한도 또는 크레딧 잔액이 소진되면 검토를 건너뛸 수 있으며 남은 액수가 예상 검토 비용보다 적을 때도 마찬가지다. 건너뛴 검토는 원인을 설명하는 댓글을 남긴다.

시범 도입 중에는 의도한 검토 서비스가 의도한 변경에 실행됐는지, 필수 테스트와 사람의 승인이 여전히 적용되는지, 잘못된 배포를 되돌릴 수 있는지 확인해야 한다. 다른 곳에서도 이점이 있는지 입증하려면 도입 팀 자체의 검토·되돌리기·사고 기록이 필요하다. BIG CHANGE의 이전 [코드 산출과 완료된 작업에 관한 기사](https://bigchange.ai/blog/ai-coding-agents-review-output-study)는 별개의 기업 연구를 다룬다.

## 출처 및 추가 읽을거리

- [Claude Code 팀이 코드 검토를 하는 방법](https://claude.dev/blog/solving-code-review-at-anthropic/) (2026년 10월 15일). 회사의 설명과 내부 지표.
- [Code Review](https://code.claude.com/docs/en/code-review). 현재 서비스 동작과 접근·데이터 제한. 2026년 10월 17일 확인.
- [Code Review 설정](https://code.claude.com/docs/en/code-review-setup). 필요한 역할, 저장소 접근, 검토 깊이와 실행 제어. 2026년 10월 17일 확인.
- [Code Review 사용자 지정](https://code.claude.com/docs/en/code-review-customize). 지침 파일과 브랜치 선택 규칙. 2026년 10월 17일 확인.
- [보호 브랜치 소개](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches). GitHub가 문서화한 병합 요건과 우회 동작. 2026년 10월 17일 확인.
- [Code Review 비용과 사용량](https://code.claude.com/docs/en/code-review-costs). 과금, 시범 도입 비용 추정, 검토 생략 조건. 2026년 10월 17일 확인.

## Sources

- [Claude Code 팀이 코드 검토를 하는 방법](https://claude.dev/blog/solving-code-review-at-anthropic/) — 회사의 설명과 내부 지표.
- [Code Review](https://code.claude.com/docs/en/code-review) — 현재 서비스 동작과 접근·데이터 제한. 2026년 10월 17일 확인.
- [Code Review 설정](https://code.claude.com/docs/en/code-review-setup) — 필요한 역할, 저장소 접근, 검토 깊이와 실행 제어. 2026년 10월 17일 확인.
- [Code Review 사용자 지정](https://code.claude.com/docs/en/code-review-customize) — 지침 파일과 브랜치 선택 규칙. 2026년 10월 17일 확인.
- [보호 브랜치 소개](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) — GitHub가 문서화한 병합 요건과 우회 동작. 2026년 10월 17일 확인.
- [Code Review 비용과 사용량](https://code.claude.com/docs/en/code-review-costs) — 과금, 시범 도입 비용 추정, 검토 생략 조건. 2026년 10월 17일 확인.