Anthropic, Claude Code 코드 검토 절차 공개
- •6월부터 9월까지 Claude Code 병합 요청이 두 배 넘게 늘고, 이후 되돌린 비율은 40% 넘게 하락
- •자동 검사와 위험 등급, 사람의 승인을 결합하고 고위험 변경은 두 명이 검토
- •검토는 최대 세 차례로 제한하고, 사고·수정·되돌림 사례로 검토 의견을 평가
Anthropic의 Claude Code 팀은 에이전트가 작성한 코드가 늘어나는 상황에 맞춘 검토 절차를 설명했습니다. 6월부터 9월까지 Claude Code 코드 저장소에 병합된 요청은 두 배 넘게 늘었고, 이후 되돌린 비율은 40% 넘게 낮아졌습니다. 팀은 검토를 없애지 않고 코드 읽기의 상당 부분을 자동 검사로 옮겼으며, 되돌림이나 사고를 늘리지 않으면서 대부분의 병합 요청에 사람 검토자를 최대 한 명 두는 것을 목표로 삼았습니다. 요청별 사람 승인 수와 의견, 대기 시간을 추적하고 되돌림과 사고를 안전 지표로 살핍니다.
Anthropic의 단일 저장소에서 하루에 반영되는 변경은 5월 약 2,500건에서 2026년 9월 30,000건 초과로 늘었습니다. 팀은 이 속도에서는 사람이 한 줄씩 검토하기 어렵다고 말합니다. 검토는 출시 전 결함을 찾고 코드베이스 지식을 공유하는 역할도 하지만, 현재 절차는 주로 문제 탐지에 초점을 둡니다. 검토는 이제 상시 진행되며 Claude가 사람이 검토하기 전에 많은 변경을 확인하고 수정도 돕습니다.
병합 요청을 열기 전 엔지니어는 테스트, 빌드, 화면 비교처럼 Claude가 실행할 작업을 지정하고 근거를 제시하도록 합니다. 이어 별도의 에이전트가 새로운 맥락으로 코드 변경을 검토합니다. 엔지니어는 버그 검색, 변경 단순화, 전체 동작 확인을 위한 내부 기능도 실행할 수 있습니다. 자동 검토가 같은 문제를 반복해서 지적하면 팀은 관련 기능, 린트 규칙 또는 프로젝트 지침을 업데이트합니다.
모든 병합 요청은 Claude가 전체 저장소와 변경 목적을 기준으로 검토합니다. Claude Code용 Code Review는 Team 및 Enterprise 요금제에서 정식 제공되며, /code-review 명령은 기능이 더 가벼운 로컬 버전을 실행합니다. 연구 프리뷰 출시 후 실질적인 검토 의견을 받은 내부 병합 요청의 비중은 16%에서 54%로 증가했습니다. 1,000줄을 넘는 요청은 대체로 지적 사항이 나오고, 작은 요청은 대체로 문제가 없다는 결과를 받습니다. 관리자는 Quick, Standard, Deep 검토 수준을 선택할 수 있습니다. 다른 에이전트들이 지적 사항을 확인하며, 실제 문제라는 데 충분히 동의할 때만 게시됩니다.
보안 검토, 린트, 유형 검사, 플랫폼 테스트와 빌드도 실행됩니다. 해결되지 않은 버그나 보안 지적이 있으면 병합이 차단됩니다. 분류기가 변경을 위험 등급으로 나눠 자동 검사를 통과한 저위험 변경은 사람 승인 없이 진행할 수 있고, 일반 변경은 한 명, 고위험 변경은 두 명의 승인이 필요합니다. 민감한 경로의 변경에는 항상 사람이 필요하며, 가벼운 검토는 신뢰받는 작성자에게만 적용됩니다. 에이전트가 작성한 변경을 지시한 사람도 필수 검토자로 계산되며, 에이전트 승인은 사람 승인을 대신하지 않습니다.
병합 대기열은 기본 브랜치에 맞춰 검사를 다시 실행합니다. 새 동작은 보통 기능 플래그를 켠 상태로 Anthropic 직원에게 먼저 제공하고, 공개 출시는 최신 채널을 거쳐 안정 채널로 이동합니다. 기능 플래그는 배포 없이 끌 수 있으며 팀은 주간 당직을 운영합니다. 팀은 되돌림이나 사고 비율이 변할 때 승인 요건을 높이는 서킷 브레이커는 아직 없다고 밝혔습니다. 사고와 수정, 되돌림을 검토자 평가용 일일 데이터로 만들고, 사람이 검토 의견을 수정하거나 거부하는지 추적해 불필요한 지적을 측정합니다.
검토가 끝없이 반복되지 않도록 팀은 세 차례 제한, 초기 검토 뒤 변경 부분만 다시 보는 방식, 같은 지적을 반복하지 않는 규칙을 도입했습니다. 한 병합 요청은 밤사이 50회를 넘겨 검토를 반복했으며, 계속 지적된 코드의 약 59%는 검토자의 첫 확인 때부터 이미 존재했습니다. 제품 방향, 위험한 코드와 구조에 대한 결정, 검사 근거, 출시된 변경에 대한 책임은 사람이 맡습니다. 팀은 코드베이스 지식을 공유하는 공식 절차는 없다고 설명했습니다. 직원들은 이해하려는 특정 코드에 대해 Claude에 설명을 요청하며, 몇 분이면 현재 코드 상태를 반영한 답을 얻습니다.