클로드가 쓰는 코드를 어떻게 검수할까

핵심 요약

• Claude Code는 자체 코드의 90%를 클로드가 작성하는데, 6~9월 사이 병합된 PR은 2배 이상 늘었으면서 되돌려진 코드는 40% 이상 감소했다.
• 수동 라인 바이 라인 검수는 불가능해졌으므로, 대부분의 검수를 자동화 도구로 옮기고 인간의 시간을 고위험·고판단 영역에만 집중했다.
• PR 오픈 전 테스트, 빌드, 스크린샷 비교 같은 검증 작업을 클로드가 수행하고, PR이 열리기 전에 클로드 에이전트 리뷰어가 한 번 이상 점검해 대부분의 루틴 실수를 미리 잡는다.
• 공개된 Code Review 도구는 PR의 diff를 저장소 전체와 비교하며, 여러 에이전트가 버그를 동시에 찾아 투표로 실제 결함만 필터링해 인라인 코멘트로 표시한다.
• 보안 검수도 자동화되어 있고, 일반적인 린트·타입 체크·테스트·빌드 등 수십 개 체크가 인간이 보기 전에 실행된다.
• 변경사항의 위험도를 자동 분류하고, 신뢰할 수 있는 저자만 경량 경로 허용, 에이전트 승인은 인간 승인으로 계산되지 않으며, 각 승인은 특정 커밋에만 유효하다.
• 마지막 방어선은 병합 큐로 두 PR이 각각 통과해도 함께 main을 깨는 것을 방지하고, 주간 온콜과 인시던트 대시보드가 실패한 코드를 빠르게 감지한다.
• 과거 인시던트를 야기한 PR들을 수집해 매일 검수 도구를 평가하고, 에이전트 리뷰어의 거짓양성을 측정해 노이즈를 제어한다.
• 에이전트 리뷰어와 작성자가 50회 이상 주고받으면서 수렴하지 않는 문제를 해결하기 위해 재검수 라운드를 제한하기 시작했다.
• 일부 엔지니어는 클로드로 코드 설명서를 작성받아 학습하며, 팀은 느슨한 소유권과 공개된 Slack 채널로 코드 이해를 전파한다.
• 검수가 뭔가를 놓치면 CLAUDE.md, 스킬, 신규 체크로 피드백을 코드화해 같은 문제 재발을 방지한다.
• 목표는 대부분의 PR이 인간 한 명 이하의 개입으로 병합되면서 되돌림과 인시던트 비율을 올리지 않는 것이다.