Claude Code의 Code Review는 PR이 열릴 때마다 여러 AI 에이전트를 동시에 투입해 "대충 훑고 지나가기 쉬운 버그"를 먼저 찾아주는 리뷰 기능입니다. 핵심은 속도 경쟁이 아니라 깊이 있는 검토에 있고, 사람 리뷰어를 대체하지 않고 병목인 리뷰 구간을 보조하는 데 초점이 맞춰져 있습니다. 지금은 Team·Enterprise 대상 연구 프리뷰로 제공되며, PR 크기와 복잡도에 따라 토큰 기반 비용이 발생합니다.1
코드 생산은 폭주하는데, 리뷰는 왜 늘 막힐까?
요즘 팀에서 흔히 보는 장면이 있죠. PR은 쌓이는데 리뷰는 "LGTM"이 빨라지고, 작은 변경이라도 배포 후에 터져서 새벽에 핫픽스하는 루프입니다. Anthropic은 내부에서 엔지니어 1인당 코드 산출량이 1년 사이 200% 늘었다고 밝혔는데1, 이런 상황이면 리뷰가 정성껏 '독서'가 아니라 '스캔'이 되기 쉽습니다.
Code Review는 바로 이 지점을 겨냥합니다. 사람이 리뷰할 때 중요한 판단(설계, 위험도, 트레이드오프)에 집중할 수 있도록, AI가 먼저 버그 냄새가 나는 곳을 최대한 깊게 파서 후보를 올려주는 방식입니다.
Claude Code Code Review는 "빠른 검사"가 아니라 "깊은 리뷰어"다
기존 자동화 도구가 주로 스타일, 린트, 규칙 기반 경고를 잘 잡는다면, Code Review는 더 사람 같은 방향--즉 로직 오류 중심으로 움직입니다. 제품 인터뷰에서는 "개발자가 바로 고칠 수 있는 논리적 문제에 집중해 불필요한 지적을 줄이려 했다"는 맥락도 나왔습니다.2
또 중요한 차이 하나. 이 기능은 PR을 "승인"하지 않습니다. 최종 승인은 여전히 인간의 책임이고, 도구는 사고를 부르는 구멍을 먼저 비춰주는 손전등에 가깝습니다.1
멀티 에이전트가 PR을 읽는 방식: 병렬 탐색 → 검증 → 우선순위
작동 방식은 꽤 "팀 플레이"에 가깝습니다. PR이 열리면 여러 에이전트가 병렬로 코드를 읽고, 각자 버그 후보를 찾습니다. 그 다음 단계에서 서로의 발견을 다시 확인해 허위 경보를 걸러내고, 마지막으로 심각도 기준으로 정리해 PR에 올립니다.1
결과물은 두 가지로 남습니다. 전체 요약 코멘트 하나가 먼저 달리고, 실제로 손봐야 할 지점에는 인라인 코멘트가 붙습니다. PR이 커질수록 더 많은 에이전트가 붙는 식으로 "검토 강도"도 스케일링되며, 평균 리뷰 시간은 약 20분 정도로 안내됩니다.1
재미있는 포인트는 "diff만 보는 게 아니라 맥락을 보려 한다"는 사례입니다. 예를 들어 TrueNAS의 ZFS 암호화 리팩터링 PR에서, 변경분 자체를 넘어 인접 코드에 숨어 있던 타입 불일치 버그까지 잡아냈다고 합니다.1
비용은 비싸지만, 통제 장치는 촘촘하다
이 기능이 매력적이어도 현실은 예산입니다. Code Review는 토큰 기반으로 과금되며 보통 PR 1회 리뷰에 15~25달러 수준(변경 규모에 따라 증가)으로 소개됐습니다.1 그래서 Anthropic은 이걸 "싼 자동화 검사"와 같은 선상에 두지 않고, 더 깊지만 더 비싼 선택지로 분리해 설명합니다.1
대신 관리자 입장에선 운영 통제가 가능합니다. 조직 월간 지출 상한을 걸고, 저장소 단위로 켜고 끄며, 대시보드로 리뷰 수·수용률·총비용을 추적하는 구조입니다.1 즉 "좋지만 비싸다"를 "필요한 곳에만 쓰자"로 풀 수 있게 만든 셈이죠.
시사점
Code Review의 본질은 "코드를 써주는 AI"보다 "코드를 끝까지 의심해주는 AI"에 가깝습니다. 코드 생성 속도가 올라갈수록, 팀이 부족해지는 건 작성 능력보다 검토 능력일 수 있고요.
실무적으로는 모든 PR에 무조건 돌리기보다, 장애 비용이 큰 핵심 서비스나 보안·인증처럼 민감한 영역, 그리고 1,000줄 이상 대형 PR부터 우선 적용하는 전략이 비용 대비 효율이 좋습니다. 깊은 리뷰는 공짜가 아니지만, 한 번의 큰 사고를 막는 순간 "리뷰 20분"과 "새벽 2시 온콜"의 값은 비교가 안 되니까요.
참고
1Bringing Code Review to Claude Code
2Anthropic launches code review tool to check flood of AI-generated code
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.