CodeRabbit 후기, GitHub PR 코드리뷰 자동화 도구[무료]

GitHub로 프로젝트를 관리하다 보면 Pull Request 리뷰가 생각보다 손이 많이 갑니다. 코드 몇 줄만 바뀐 PR이면 금방 보면 되는데, 설정 파일이나 CI, 의존성, 테스트 코드가 같이 바뀌면 먼저 이 PR이 정확히 뭘 하려는 건지부터 파악해야 합니다.

 

특히 오픈소스 저장소를 운영하거나 외부 기여를 받기 시작하면 더 그렇습니다. PR을 보자마자 바로 코드부터 읽기보다는, 변경 의도와 영향 범위, 테스트 여부를 먼저 확인해야 하는데 이 과정이 은근히 시간을 잡아먹습니다.

 

이럴 때 붙여볼 만한 도구가 CodeRabbit입니다. GitHub Pull Request에 AI 리뷰어를 붙여주는 서비스라고 보면 됩니다. PR이 올라오면 변경 내용을 읽고 요약을 남기고, 필요한 경우 코드 라인별로 리뷰 코멘트까지 달아줍니다.

 

저도 GitHub 저장소에 직접 설치해서 PR 댓글까지 확인해봤는데, 생각보다 설치가 간단했고 공개 오픈소스 저장소라면 무료로 시작할 수 있어서 정리해둡니다.

 

CodeRabbit은 PR을 먼저 읽어주는 AI 리뷰 서비스

CodeRabbit은 GitHub App 형태로 설치하는 AI 코드리뷰 서비스입니다. 저장소에 설치해두면 Pull Request가 열릴 때 자동으로 변경 내용을 분석하고 리뷰 댓글을 남깁니다.

 

공식 GitHub App 페이지를 보면 기능이 꽤 직관적으로 정리되어 있습니다.

제가 써보면서 가장 쓸 만하다고 느낀 부분은 PR 요약입니다. 변경된 파일을 하나씩 열어보기 전에 CodeRabbit이 먼저 “이 PR은 이런 내용을 바꿨다”는 식으로 정리해줍니다. 단순히 파일 목록만 보여주는 것이 아니라, 변경 목적과 리뷰할 만한 포인트를 같이 잡아주는 쪽에 가깝습니다.

 

물론 코드리뷰 코멘트도 남깁니다. 예외 처리가 부족해 보이는 부분이나 테스트가 필요해 보이는 부분, 코드 스타일상 애매한 부분을 PR 안에서 직접 짚어줍니다. 다만 이 부분은 어디까지나 참고 의견으로 보는 게 맞습니다. AI가 프로젝트 맥락을 항상 정확히 이해하는 것은 아니기 때문입니다.

 

그래도 리뷰를 시작하기 전에 전체 흐름을 잡아준다는 점에서는 꽤 유용합니다. 사람 리뷰어를 대체한다기보다는, 리뷰 전에 한 번 정리해주는 보조 리뷰어라고 보면 이해하기 쉽습니다.

 

실제 GitHub PR에서는 이렇게 보입니다

아래는 실제 PR에 CodeRabbit이 남긴 댓글 화면입니다.

화면에는 Review failed라고 보이는데, 이건 코드가 잘못돼서 실패했다는 뜻은 아닙니다. 아래 메시지를 보면 이유가 나옵니다.

 

Pull request was closed or merged during review

즉, CodeRabbit이 리뷰를 진행하는 중에 PR이 이미 머지되거나 닫혀서 리뷰를 끝까지 진행하지 못했다는 의미입니다. PR을 너무 빨리 머지하면 이런 메시지가 나올 수 있습니다.

 

정상적으로 리뷰가 끝나면 PR 전체 요약, 변경 파일 설명, pre-merge 체크 결과, 리뷰 난이도, 라인별 코멘트 같은 내용이 댓글로 정리됩니다. 작은 PR에서는 요약만으로도 충분하고, 변경 파일이 많은 PR에서는 어디부터 봐야 할지 잡는 데 도움이 됩니다.

 

저처럼 CI 워크플로우나 설정 파일을 추가하는 PR에서도 어느 파일이 추가됐고, 어떤 명령어가 실행되는지 정리해주기 때문에 리뷰 시작점이 훨씬 명확해집니다.

 

GitHub 저장소에 CodeRabbit 설치하는 방법

설치는 GitHub App을 저장소에 추가하는 방식이라 어렵지 않습니다. 먼저 아래 페이지로 들어갑니다.

GitHub · Change is constant. GitHub keeps you ahead.

 

GitHub에 로그인되어 있으면 Install 또는 Configure 버튼이 보입니다. 처음 설치하는 계정이면 Install, 이미 설치한 적이 있으면 Configure가 보일 수 있습니다.

 

설치 과정에서 중요한 부분은 저장소 접근 범위입니다. GitHub App을 설치할 때 모든 저장소에 권한을 줄 수도 있고, 특정 저장소만 골라서 권한을 줄 수도 있습니다.

 

처음 써보는 경우라면 Only select repositories를 고르는 쪽을 추천합니다. 모든 저장소에 한 번에 권한을 주기보다는, 테스트할 저장소나 실제로 PR 리뷰가 필요한 저장소만 선택하는 편이 안전합니다.

대략적인 흐름은 이렇습니다.

CodeRabbit GitHub App 접속
→ Install 클릭
→ Only select repositories 선택
→ 적용할 저장소 선택
→ 권한 확인 후 Install

설치가 끝나면 새 PR을 만들거나 기존 PR에 커밋을 추가했을 때 CodeRabbit이 자동으로 댓글을 남깁니다. 자동 리뷰가 바로 뜨지 않거나 다시 리뷰를 받고 싶다면 PR 댓글에 @coderabbitai review라고 입력하면 됩니다. 전체 리뷰를 다시 요청하고 싶을 때는 @coderabbitai full review를 사용할 수 있습니다.

 

공개 오픈소스 저장소는 무료

가격이 제일 궁금한 부분일 텐데, 현재 CodeRabbit 공식 문서 기준으로 공개 오픈소스 저장소는 무료로 사용할 수 있습니다.

공식 Plans 문서에도 Open source 항목이 따로 있습니다.

 

문서 기준으로 보면 공개 저장소는 신용카드 없이 사용할 수 있고, 공개 오픈소스 프로젝트에는 유료 구독 없이 리뷰 기능이 제공됩니다. 별도로 복잡한 인증을 해야 하는 것은 아니고, 공개 저장소에 CodeRabbit을 설치하면 적용되는 방식입니다.

 

다만 사용량 제한은 있습니다. 문서에서도 OSS 리뷰는 별도의 rate limit을 사용한다고 안내하고 있습니다. 그리고 일부 대시보드나 리포트 기능은 유료 플랜에서만 제공될 수 있습니다.

 

그래서 “공개 오픈소스 저장소라면 무료로 시작할 수 있다” 정도로 이해하는 게 가장 정확합니다. “모든 기능이 영구적으로 무제한 무료”라고 받아들이면 안 됩니다. 서비스 정책은 바뀔 수 있고, 회사 비공개 저장소나 팀 단위 프로젝트에 적용하려면 최신 가격표를 먼저 확인하는 편이 좋습니다.

 

GitHub Actions와 같이 쓰면 더 좋습니다

CodeRabbit은 코드리뷰 도구이고, GitHub Actions는 테스트 자동화 도구입니다. 둘은 역할이 다릅니다.

GitHub Actions는 lint, test, build 같은 명령어가 실제로 통과하는지 확인합니다. 반면 CodeRabbit은 PR의 변경 내용을 읽고, 어떤 의도로 바뀐 것인지, 리뷰할 때 어디를 보면 좋을지 정리해줍니다.

 

둘을 같이 쓰면 PR 관리가 훨씬 편해집니다. 테스트는 GitHub Actions가 기계적으로 확인하고, 변경 내용 요약은 CodeRabbit이 먼저 해주기 때문입니다. 외부 PR을 받을 일이 있는 저장소라면 특히 이 조합이 좋습니다.

 

예를 들어 CI 워크플로우를 추가한 PR에서는 GitHub Actions가 실제 테스트 실행을 맡고, CodeRabbit은 해당 워크플로우가 어떤 브랜치에서 동작하고 어떤 명령어를 실행하는지 요약해줍니다. 사람이 리뷰할 때는 그 요약을 보고 필요한 부분만 더 깊게 확인하면 됩니다.

 

어떤 사람에게 잘 맞나

CodeRabbit은 PR 기반으로 개발하는 저장소에서 효과가 큽니다. GitHub PR을 자주 만들거나, 오픈소스 저장소를 운영하거나, 외부 기여자의 PR을 검토해야 하는 경우라면 꽤 도움이 됩니다.

 

반대로 PR 없이 바로 main 브랜치에 커밋하는 개인 프로젝트라면 체감이 크지 않을 수 있습니다. 변경량이 아주 작고 리뷰 프로세스 자체가 없는 저장소라면 굳이 설치할 필요까지는 없습니다.

 

개인적으로는 GitHub Actions까지 붙여서 PR마다 테스트를 돌리고 있는 저장소라면 CodeRabbit도 같이 붙여볼 만하다고 봅니다. 테스트 결과와 AI 리뷰 요약이 같이 쌓이면 PR을 확인하는 흐름이 훨씬 깔끔해집니다.

 

CodeRabbit은 사람 리뷰를 완전히 대체하는 도구는 아닙니다. 그래도 PR을 열자마자 변경 내용을 정리해주고, 놓치기 쉬운 부분을 한 번 더 짚어준다는 점에서 보조 리뷰어로는 충분히 쓸 만했습니다.

 

저장소가 공개 오픈소스라면 현재 기준 무료로 시작할 수 있으니, GitHub Actions로 테스트와 린트를 돌리고 있는 프로젝트라면 같이 붙여서 써보는 것도 괜찮겠습니다.