Claude Code 팀은 변경 내용으로 위험 등급을 매겨 저위험 PR을 사람 승인 없이 병합한다. 판매되는 Code Review는 PR을 승인하지도 막지도 않아 이 구조를 대신하지 못한다. 리뷰 봇보다 등급표·승인 무효화·되돌림률 기준이 우리 쪽에 있는지 먼저 본다.
AI 코드 리뷰를 켠 팀이 다음 분기에 꺼내는 질문은 대개 하나다. 필수 승인 수를 줄여도 되는가.
Anthropic 10월 15일 공개 글은 이 질문에 내부 수치로 답한다. Claude가 Claude Code 코드의 약 90%를 쓰고, Anthropic 모노레포의 하루 병합 건수는 5월 약 2,500건에서 9월 3만 건 이상으로 늘었다. 팀의 목표는 대부분의 PR을 사람 최대 1명(작성자 본인이어도 된다)만 거쳐 병합하되 되돌림과 장애는 늘리지 않는 것이다.
이 글을 "Claude 리뷰가 좋아져서 사람이 빠졌다"로 읽으면 틀린다. 사람 승인을 덜어낸 장치 대부분은 리뷰어 바깥, 팀이 직접 만든 병합 규칙에 있다.
사람 승인 인원은 리뷰 품질이 아니라 변경 내용이 정한다
Anthropic 파이프라인에서 승인 인원을 정하는 것은 분류기다. 첫 분류기가 변경을 읽고 등급을 고르고, 두 번째 분류기가 등급이 낮아도 사람이 더 필요한지 다시 묻는다.
| 등급 | 예 | 사람 승인 |
|---|---|---|
| 저위험 | 문서·문구, 내부 전용 기능, 플래그 뒤의 추가 변경 | 자동 리뷰·보안 검사 통과 시 0명 |
| 중위험 | 일반 제품 변경, 캐시·자동 업데이터·시스템 프롬프트 | 1명 |
| 고위험 | 최고 위험 코드, 항상 2명이 필요한 경로 | 2명 |
소유자가 민감하다고 지정한 경로와 모든 CI 워크플로 파일은 등급과 무관하게 사람이 본다. 가벼운 경로는 저장소 신뢰 목록에 든 작성자에게만 열린다. 에이전트의 승인은 사람의 승인으로 세지 않고, 에이전트가 쓴 PR에서는 에이전트를 지휘한 사람이 필수 리뷰어 한 명으로 계산된다. 승인은 특정 커밋 하나에만 유효하다. 에이전트의 push나 손으로 푼 병합처럼 시스템이 보증하지 못하는 커밋이 올라오면 다시 승인을 받는다.
리뷰 봇 승인이 필수 승인 수에 섞일 때 생기는 구멍은 Copilot의 PR 승인이 병합 조건에 산입되면, 필수 승인 1명 규칙은 사람 0명 규칙이 된다에서 다뤘다. Anthropic은 그 구멍을 규칙 한 줄로 막았다. 남은 빈칸도 있다. InfoQ 10월 29일 보도는 이 글이 CLAUDE.md 변경의 등급을 정하지 않았다고 짚었다. 에이전트 동작을 바꾸는 지시 파일이 문서로 분류되면 저위험 경로로 빠진다.
돈 주고 켜는 Code Review에는 이 관문이 들어 있지 않다
Code Review 공식 문서는 Team·Enterprise 플랜의 Code Review가 PR을 승인하지도 차단하지도 않는다고 적는다. 체크 런은 실패로 끝나지 않고 병합 결정은 팀에 남는다. Anthropic 사내에서는 Code Review와 별도 보안 리뷰의 미해결 지적이 병합을 막고, 지적마다 수정하거나 사유를 달아 닫아야 한다. 같은 리뷰가 사내에서는 관문으로, 판매판에서는 코멘트로 동작한다.
Code Review를 켜는 일과 사람 승인을 줄이는 일은 서로 다른 작업이다.
수치도 바깥 장치와 함께 읽어야 한다. 6월~9월 Claude Code 병합 PR이 두 배 넘게 느는 동안 되돌린 비율은 40% 넘게 줄었다. Claude 리뷰를 붙인 뒤 실질적 지적이 달린 사내 PR은 16%에서 54%로 늘었다. 이 파이프라인에는 기능 플래그, latest 채널을 거쳐 stable로 가는 배포, 최신 main 기준으로 검사를 다시 돌리는 병합 큐가 함께 들어 있다. 리뷰어가 반복 지적한 항목을 git blame으로 따라가 보니 59%는 첫 리뷰 때부터 있던 코드였다.
왕복 횟수도 따로 묶었다. 한 CLI PR이 밤새 50회 넘게 리뷰와 수정을 오간 뒤, 리뷰어는 세 번 왕복하면 작성자에게 접근 방식을 다시 보라고 요청하도록 바뀌었다. 1회 만에 통과하는 비율은 65%에서 78%로 올랐다. 구글도 판정을 모델에 맡기지 않았다. InfoQ 10월 31일 보도에 따르면 PageBreak는 Gemini 에이전트의 취약점 가설을 보안 엔지니어가 짠 검증기로 재현한 뒤에만 제품팀에 넘기고, 그렇게 XSS 500건 이상을 찾았다.
가져갈 것
-
.github/workflows/아래 변경은 위험 등급과 상관없이 사람 1명 승인을 요구하도록 CODEOWNERS와 브랜치 규칙에 걸었는가? - Copilot·Claude 리뷰 봇 계정의 승인이 필수 승인 수에서 빠지는가?
- 에이전트가 쓴 PR에서 에이전트를 지시한 사람이 필수 리뷰어로 기록되는가?
- 브랜치 보호의 "Dismiss stale pull request approvals when new commits are pushed"가 켜져 있어 에이전트 push 뒤 기존 승인이 무효가 되는가?
-
CLAUDE.md·AGENTS.md·시스템 프롬프트 변경을 문서가 아니라 중위험 이상으로 분류했는가? - 승인 인원을 줄이기 전에 지난 분기 되돌린 PR 비율을 숫자로 갖고 있는가?
안 되는 경우
- 감사 절차가 모든 변경에 사람 리뷰를 요구하는 조직은 0명 경로를 열 수 없다. InfoQ가 인용한 댓글은 SOC 2 절차를 예로 들었고, Anthropic 글은 감사 요건을 다루지 않는다.
- 수치는 전부 Anthropic 내부 지표이고 외부 검증이 없다. 되돌림 감소가 리뷰, 플래그, 병합 큐 가운데 어디서 왔는지 글은 나눠 보여주지 않는다.
- Anthropic도 지표가 움직일 때 승인 기준을 자동으로 조이는 서킷 브레이커를 아직 만들지 않았다. 나쁜 병합은 지금 작성자·당직·대시보드가 알아챈다.
- 오픈소스 claude-code-security-review GitHub Action은 README에서 프롬프트 인젝션에 강화되지 않았으니 신뢰하는 PR에만 쓰라고 적는다. 외부 기여 PR이 많은 저장소에서는 이 자동 보안 리뷰를 병합 관문으로 세우기 어렵다.
이번 주에는 리뷰 봇 설정 화면 대신 브랜치 규칙 화면을 연다. 경로별 승인 인원 표 한 장에 지난 분기 되돌림률 기준선을 붙인 뒤에야 사람 승인을 줄일지 논의할 수 있다. 에이전트 도입 범위를 정할 때 함께 물을 질문은 이 PR이 틀렸을 때 누가 몇 분 안에 되돌리느냐이다. 사업영역 →