Claude Code의 Code Review는 "AI가 PR을 승인해주는 기능"이 아니라, 사람이 리뷰를 시작하기 전에 버그 냄새가 나는 지점부터 먼저 밝혀주는 PR 리뷰 보조에 가깝습니다. PR 물량이 늘면서 생긴 리뷰 병목을, 자동 승인이 아니라 리뷰 우선순위 재정렬로 풀겠다는 접근이죠. 이번 글에서는 동작 방식, 비용·운영 감각, 그리고 실제 팀에서 어디에 쓰면 좋은지까지 핵심만 정리해봅니다.
사람이 리뷰하기 전에 AI가 리뷰를 하게 하세요. 그렇게 할 때 리뷰 병목을 줄일 수 있습니다.
Claude Code Code Review란? "스타일 지적" 대신 "버그 먼저"
기존 자동 리뷰 봇이 흔히 빠지는 함정은, 맞는 말 같지만 당장 도움이 안 되는 코멘트를 남발해 신뢰를 잃는 겁니다. Anthropic은 이 문제를 정면으로 피했습니다. Code Review의 초점은 스타일·취향이 아니라, "발견되면 거의 무조건 고쳐야 하는" 로직 오류와 실제 버그입니다.1 즉 실제 코드 로직만 다룬다는 것입니다.
또 하나 중요한 경계선도 분명합니다. Code Review는 PR을 approve 하지 않습니다. 최종 승인 책임은 인간 리뷰어에게 남겨둔 설계예요.1 자동화가 강해질수록 책임 소재가 흐려지기 쉬운데, Anthropic은 승인 권한에서 선을 그었습니다. PR은 인간이 합니다!
멀티 에이전트 PR 리뷰는 어떻게 돌아가나 (병렬 검사 + 랭킹)
PR이 열리면 클라우드에서 여러 에이전트가 동시에 투입됩니다. 각자 다른 유형의 문제(로직, 회귀 가능성 등)를 맡아 살피고, 결과를 모아 중복을 줄이고 중요도를 매겨 PR 코멘트로 남깁니다.1
속도보다 깊이를 택한 것도 특징입니다. 평균 리뷰 시간은 약 20분이고, PR이 복잡할수록 더 깊게 확장됩니다.1 특히 "바뀐 파일만 보고 끝"이 아니라, 필요하면 코드베이스를 가로질러 상호작용을 추적할 수 있다는 점을 강조합니다.1
내부 사용 수치도 공개됐는데, 실질적인 코멘트가 달린 PR 비율이 16% → 54%로 늘었고, 변경 1,000줄 초과 PR에서는 84%에서 버그를 발견(평균 7.5개 이슈)했다고 합니다.1 개발자가 '부정확'으로 표시한 비율은 1% 미만으로 보고됐습니다.1
가격(토큰 과금)과 운영 포인트: "모든 PR"보다 "비싼 곳에만"
과금은 토큰 기반이며 평균 리뷰 1회 $15~$25 수준으로 언급됩니다.1 게다가 느립니다(평균 20분). 그래서 운영의 정답은 보통 하나입니다. "전 PR 상시 적용"이 아니라, 큰 PR·핵심 모듈·릴리즈 직전·온콜 위험 구간처럼 비싸게 검증할 가치가 큰 곳에 붙이는 방식이 자연스럽습니다. 비싸기는 하네요.
관리자는 저장소(Repo)별로 켜고 끌 수 있고, 월별 비용 상한(cap)과 대시보드로 사용량을 추적할 수 있습니다.1 이 "레포 단위 토글"이 현실적인 이유는, 팀마다 코드 성격도 다르고 비용 민감도도 달라서 결국 전사 일괄 적용은 싸움(과금·기준·노이즈)으로 번지기 때문입니다.
시사점: 리뷰 자동화가 아니라, 리뷰 '순서'를 바꾸는 도구
Code Review를 한 문장으로 요약하면 "사람 리뷰를 대체하는 봇"이 아니라 "사람 리뷰가 더 비싼 판단에 시간을 쓰게 만드는 필터"입니다. 승인 버튼은 인간이 누르고, AI는 그 전에 위험 신호를 먼저 보여줍니다. 기억하세요. 사람은 가장 비싼 자원이므로 AI가 리뷰하고 마지막에 검토하세요.
도입을 고민한다면, 먼저 팀에 이렇게 질문해보세요. "우리는 리뷰 시간을 어디에 가장 많이 쓰고, 어디에서 가장 자주 놓치나?" 답이 "큰 PR의 교차 파일"이나 "AI가 만든 그럴듯한 코드의 함정"이라면, Code Review는 꽤 설득력 있는 선택지입니다. 반대로 작은 PR이 대부분이고 린터/테스트가 이미 촘촘하다면, 더 가벼운 GitHub Action류로도 충분할 수 있습니다.
참고
1Anthropic launches a multi-agent code review tool for Claude Code
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.