Claude Code와 Codex로 모든 풀 리퀘스트에 AI 코드 리뷰

풀 리퀘스트에 AI 리뷰를 받는 세 가지 방법

Claude Code나 Codex로 풀 리퀘스트 리뷰하는 법

1. Claude Code: /code-review 실행하기

   Claude Code 세션에서 /code-review는 내 브랜치 변경 사항의 버그를 찾아요. PR 번호를 넘기면 그 풀 리퀘스트를 리뷰하고, --comment를 붙이면 결과를 GitHub에 인라인 댓글로 올려요. --fix는 대신 내 작업 트리에 수정을 적용해요. /review는 별칭이에요.

   # Claude Code: 풀 리퀘스트를 리뷰하고 인라인 댓글 달기
   /code-review 142 --comment
   
   # Codex: GitHub의 PR 댓글에서 리뷰 요청하기
   @codex review
   @codex review for issues in the database migration

2. Codex: @codex review 멘션하기

   풀 리퀘스트 댓글에 @codex review라고 쓰면 Codex가 👀로 반응하고 리뷰를 올려요. 원하면 뒤에 집중할 부분을 덧붙이세요. 요청 없이 리뷰받으려면 Codex 설정에서 Automatic review를 켜고 트리거를 고르세요.

3. 리뷰 규칙 적어 두기

   Codex는 코드에서 가장 가까운 AGENTS.md의 ## Code Review Rules 섹션을 읽어요. Claude Code라면 같은 규칙을 CLAUDE.md에 넣으세요. 규칙이 있으면 리뷰가 일관되고, 린터가 이미 다루는 주제로 새지 않아요.

   ## Code Review Rules
   - billing/과 auth/에 새로 생긴 분기에 테스트가 없으면 짚어 주세요.
   - 모든 SQL 마이그레이션에는 롤백이 있어야 해요. 없으면 말해 주세요.
   - 포맷은 댓글로 달지 마세요. 린터가 맡아요.
   - 승인도, 변경 요청도 하지 마세요. 댓글만 다세요.

출처: Claude Code 문서, /code-review로 로컬에서 리뷰하기

AI 리뷰가 하지 않는 일

• 승인이나 차단: Claude의 관리형 Code Review는 풀 리퀘스트를 승인하거나 막지 않아요. 좋은 리뷰 브리프는 직원에게 댓글만 달라고 해요.
• 변경을 책임지는 사람을 대신하기: 버그와 빠진 테스트는 잡아내지만, 제품과 디자인 판단은 사람에게 남아요.
• 모든 것을 보기: GitHub의 Codex는 댓글을 집중시키려고 P0와 P1 이슈만 짚어요. 필요하면 특정 초점을 요청하세요.
• 공짜: 리뷰는 플랜 사용량을 써요. 푸시할 때마다가 아니라 요청할 때나 ready-for-review일 때 리뷰하세요.

Claude Code와 Codex 단계별 안내

에이전트마다 내장 명령어, 연결할 도구, 일정 설정을 정리했습니다: Claude Code 코드 리뷰, Codex 코드 리뷰.

리뷰를 누군가의 업무로 만들기

명령어는 누군가 실행할 걸 기억할 때만 리뷰해요. AI 직원은 그게 업무라서 리뷰해요. Crewmark는 내 Claude Code나 Codex를 하트비트에 깨어나 리뷰를 기다리는 풀 리퀘스트를 맡아 댓글을 다는 엔지니어로 바꿔 줘요.

1. 역할에서 시작하기

   AI 소프트웨어 엔지니어의 브리프에 내 리뷰 규칙을 넣으세요.

2. 리뷰를 보드로 보내기

   리뷰 이슈를 배정하거나, ready로 표시된 열린 풀 리퀘스트를 모두 리뷰하는 반복 이슈를 추가하세요.

3. 엔지니어링의 다른 일

   엔지니어링을 위한 Claude Code와 Sentry 오류 분류를 참고하세요.

자주 묻는 질문