AI 코드 리뷰

AI가 PR의 변경 내용(diff)을 읽고 버그, 보안 취약점, 성능·스타일 문제를 코멘트로 짚어 주는 기술이다. 기계적인 문제는 AI가 먼저 거르고, 사람 리뷰어는 설계와 비즈니스 로직에 집중하도록 일을 나눌 때 쓴다.

설치형 도구와 직접 구성, 두 가지 방법

가장 쉬운 방법은 CodeRabbit, GitHub Copilot Code Review처럼 GitHub에 바로 붙는 도구를 쓰는 것이다. 저장소에 연결해 두면 PR이 열릴 때마다 변경 요약과 줄 단위 코멘트가 달린다. Cursor처럼 에디터 안에서 커밋하기 전에 리뷰를 받는 방식도 있다.

직접 만들려면 GitHub Actions에서 PR 이벤트가 들어올 때 diff를 Claude API로 보내고, 응답을 PR 코멘트로 남기게 구성한다. 처음 설정하는 데 시간이 들지만 프롬프트와 검사 범위를 마음대로 정할 수 있다.

팀 규칙을 알려줘야 지적이 정확해진다

아무 설정 없이 쓰면 누구에게나 할 법한 일반적인 지적만 나온다. 팀 코딩 컨벤션, 자주 나는 실수, 꼭 확인할 항목(인증 체크, 입력 검증 등)을 시스템 프롬프트나 도구 설정에 적어 두면 맥락에 맞는 코멘트가 나온다. 자동 생성 파일이나 lock 파일은 검사 대상에서 빼야 쓸데없는 코멘트가 줄어든다.

참고 의견으로 받고, 머지는 사람이 정한다

AI는 문제없는 코드를 문제라고 하거나, diff 밖의 코드와 얽힌 버그를 놓치기도 한다. 그래서 AI 코멘트를 전부 따르기보다 참고 의견으로 받고, 최종 승인은 사람이 하는 팀 문화가 중요하다. AI가 짠 코드가 늘면서 리뷰할 양도 많아졌으니, AI 리뷰는 사람 리뷰를 대신하는 게 아니라 앞에서 한 번 걸러 주는 역할로 두는 게 좋다.

외부 서비스를 쓰면 코드가 그 서비스로 전송된다. 민감한 저장소라면 도입 전에 보안 정책부터 확인해야 한다.

PR의 첫 번째 리뷰어로 둔다

가장 흔한 방식은 PR이 열리면 AI가 먼저 변경 요약과 줄 단위 코멘트를 달고, 사람은 그걸 참고하면서 설계와 요구사항을 보는 것이다. 올리기 전에 에디터에서 미리 리뷰를 받는 쓰임도 많다.