클로드 코드, PR마다 자동 리뷰하는 두 가지 방법 공개

Code Review는 클로드 깃허브 앱을 통해 풀리퀘스트를 검토하고 결과를 해당 코드 줄에 인라인 코멘트로 남기는 서비스예요. 조직 관리자가 클로드 코드 관리자 설정에서 기능을 켜고 클로드 깃허브 앱을 설치한 뒤, 어떤 저장소를 지켜볼지와 언제 실행할지를 골라요. 풀리퀘스트가 열릴 때, 모든 푸시마다, 혹은 누군가 "@claude review"라고 댓글을 달 때 중에서 고를 수 있어요. 리뷰는 앤스로픽 인프라에서 돌아가는 여러 리뷰 에이전트가 맡는데, 변경분을 전체 코드베이스와 비교해 분석하고 심각도별로 태그를 붙여 인라인 코멘트로 남기고, 체크 실행 결과에는 요약 표도 함께 붙여요. 중복은 걸러내고 우선순위를 매겨서, 개발자가 사소한 지적 더미 대신 실제로 봐야 할 몇 개만 받아보게끔 설계됐어요. 이 서비스는 현재 팀과 엔터프라이즈 플랜에서 연구 프리뷰로 제공되고 있어요.

승인도 자동 수정도 하지 않는다

여기서 눈여겨볼 대목은 Code Review가 무엇을 하지 않는가예요. 이 서비스는 풀리퀘스트를 승인하거나 막는 결정을 절대 내리지 않아요. 판단은 항상 사람 몫으로 남겨둬요. 발견한 문제를 자동으로 고쳐주지도 않고, 지적 사항을 게시하는 데서 서비스가 끝나요. 실제로 그 지적을 코드에 반영하려면 개발자가 자기 터미널에서 "/code-review" 명령으로 diff를 다시 검토하고, "--fix" 플래그를 붙여 작업 트리에 수정을 적용해야 해요. 자동 검토는 여기까지고, 그다음은 사람이 확인하고 실행해야 완성되는 구조예요.

검토를 넘어서는 일은 GitHub Action으로

리뷰를 넘어 댓글 지시로 코드를 고치거나, 정기적으로 리포트를 뽑거나, 특정 깃허브 이벤트에 반응하는 작업까지 하려면 Claude Code GitHub Action을 직접 붙여야 해요. 설정은 클로드 코드 안에서 "/install-github-app" 명령을 실행하는 것으로 시작하는데, 이 명령을 쓰려면 저장소 관리자 권한이 있어야 해요. 명령을 실행하면 깃허브 앱 설치와 저장소에 앤스로픽 API 키 시크릿 등록까지 안내를 따라가면 끝나요.

액션 이름은 "anthropics/claude-code-action@v1"이고, 여기 들어가는 값은 다음과 같아요. 필수값인 앤스로픽 API 키, 기본값이 "secrets.GITHUB_TOKEN"인 깃허브 토큰, 댓글에서 액션이 반응할 문구를 정하는 트리거 문구(기본값은 "@claude"), 실행할 지시를 담는 프롬프트, 그리고 클로드 코드로 그대로 전달되는 CLI 인자 문자열인 클로드 인자예요. 베드록이나 버텍스를 쓰는 조직이면 제공자를 그쪽으로 바꿀 수도 있어요.

그대로 옮겨 쓰는 워크플로 예시

이 값을 ".github/workflows/claude.yml"에 넣으면, 풀리퀘스트와 이슈 댓글에서 "@claude"를 기다리는 워크플로가 돼요. 누군가 풀리퀘스트에 "@claude implement the spec in the linked Linear issue"라고 쓰면 액션이 이를 집어 들어 클로드가 커밋을 올리고 무엇을 했는지 댓글로 남겨요. 매일 오전 9시(UTC)에 크론이 실행돼 클로드가 결과를 정리해 올리는 일일 리포트 워크플로도 같은 방식으로 짤 수 있고, "workflow_dispatch" 트리거를 넣어두면 액션 탭에서 수동으로도 실행할 수 있어요.

세부 동작은 클로드 인자 줄에서 조정해요. 영상에서는 예시로 "max-turns"를 5로 잡아 에이전트가 도는 횟수에 상한을 걸고, "permission-mode"를 "don't ask"로 둬서 사람 확인 없이 진행되는 무인 모드로 돌리고, 읽기 전용 리포트 작업이면 "allow-tools"를 그 작업에 필요한 만큼만 열어주는 식으로 값을 맞췄어요.

두 방식 비교

항목	Code Review (관리형)	GitHub Action (직접 설정)
설정 주체	조직 관리자가 설정에서 켬	저장소 관리자가 직접 설치
실행 범위	PR 리뷰만	리뷰 이후 작업 전반(구현, 리포트, 이벤트 대응)
승인·차단 권한	없음	워크플로 설계에 따라 다름
자동 수정	없음, 로컬에서 /code-review --fix	프롬프트에 따라 커밋까지 가능
이용 조건	팀·엔터프라이즈 플랜 연구 프리뷰	저장소 관리자 권한과 API 키 필요

에디터의 시선

이번 강좌가 보여주는 건 앤스로픽이 코드 리뷰 자동화를 두 층으로 쪼갠 방식이에요. 위층은 켜기만 하면 되는 관리형 서비스로 진입장벽을 낮추고, 아래층은 클로드 인자와 워크플로 이벤트까지 직접 만지는 오픈형 액션으로 자유도를 준 거예요. 이런 이층 구조는 앞서 살펴본 /design 스킬이나 플러그인 마켓플레이스에서도 반복된 패턴이에요. 클로드 코드는 기능을 낼 때마다 초보자용 원클릭 경로와 숙련자용 세부 조정 경로를 함께 내놓는 쪽으로 굳어지고 있어요.

예전 세대의 코드 리뷰 봇들은 대개 규칙 기반으로 스타일 위반이나 린트 오류를 잡아내는 데 머물렀어요. 이번 Code Review는 전체 코드베이스를 놓고 변경분을 분석해 심각도로 정렬한다는 점에서 한 단계 더 들어갔지만, 그 대신 승인·차단 권한과 자동 수정 권한을 스스로 걷어냈다는 점이 눈에 띄어요. 능력을 키운 만큼 권한은 오히려 좁혀 쥔 셈인데, 이건 안전장치라기보다 아직 신뢰가 다 쌓이지 않은 기능에 대한 현실적인 설계로 보여요.

국내 개발팀 입장에서는 두 경로를 나눠서 쓰는 게 합리적이에요. 처음 도입할 때는 팀·엔터프라이즈 플랜에서 관리형 Code Review부터 켜서 인라인 코멘트가 얼마나 유용한지 몇 주 지켜보고, 정작 필요한 게 리뷰를 넘어선 자동화, 예를 들어 이슈 댓글로 구현까지 맡기거나 정기 리포트를 뽑는 일이라면 그때 GitHub Action으로 넘어가는 순서가 자연스러워요. 액션을 붙일 때는 max-turns로 무한 루프를 막고 allow-tools를 작업 범위만큼만 열어두는 습관을 처음부터 들이는 게, 나중에 권한 범위를 되돌리는 것보다 훨씬 수월해요.

앞으로 몇 주 안에는 이 관리형 서비스가 연구 프리뷰 딱지를 떼고 요금제 범위를 넓히거나, 자동 수정 옵션이 추가될 가능성이 있어요. 다만 풀리퀘스트 승인 권한을 AI에 넘기는 결정은 그보다 훨씬 늦게, 훨씬 조심스럽게 올 거예요.