본문으로 건너뛰기

GitHub PR에 AI 코드 리뷰 받기 (Codex @codex review)

사람이 리뷰하기 전에 PR의 심각한 문제(P0·P1)를 먼저 걸러 줍니다.

저장소를 Codex에 연결하고 코드 리뷰를 켠 뒤, 필요하면 저장소만의 리뷰 규칙을 적어 둡니다. 그다음 PR 댓글에 @codex review를 남기거나 자동 리뷰를 켜 두면 Codex가 리뷰를 올립니다.

내 내용 넣기

1칸
내 내용 넣기

준비

  • Codex에 연결한 GitHub 저장소
  • Codex 코드 리뷰 설정 접근 권한
  • 자동 리뷰 설정 시 저장소 push 또는 admin 권한

1. 저장소를 Codex에 연결

리뷰받을 GitHub 저장소를 Codex에 연결합니다. 코드 리뷰 설정 화면에서 그 저장소를 고를 수 있으면 됩니다.

2. 저장소의 코드 리뷰 켜기

Codex 설정의 코드 리뷰 화면에서 저장소를 고르고, Review code 아래의 Automatic review를 켭니다.

3. 리뷰 규칙 적기 (선택)

규칙이 다룰 코드에 가장 가까운 AGENTS.md에 ## Code Review Rules 절을 추가하고 ### 머리로 묶습니다. 짧은 규칙 두세 개로 시작하고, 안전한 방법이나 예외도 함께 적습니다. 서식·린트 검사는 CI에 맡깁니다.

터미널에 붙여 넣기
## Code Review Rules

### Database
- ...

기본 브랜치에 파일이 반영되면 적용됩니다.

4. PR 댓글로 리뷰 요청

PR 댓글에 정확히 @codex review를 입력합니다. 이번에 특히 볼 부분이 있으면 뒤에 덧붙입니다.

AI에게 보내기
@codex review for issues in [살펴볼 부분]

댓글에 눈 모양 이모지 반응이 달리고, 이어서 PR의 리뷰 목록에 Codex 리뷰가 올라옵니다.

5. 자동 리뷰 켜기 (선택)

Codex 설정의 Personal preferences에서 Automatic review를 켜고 Review trigger로 실행 시점을 정합니다. 그 뒤로 코드 리뷰가 켜진 저장소는 댓글 없이도 리뷰합니다. 새 PR에 댓글 없이 Codex 리뷰가 달리면 됩니다.

주의

  • 리뷰가 오지 않으면 저장소의 코드 리뷰가 켜져 있는지, PR이 연결된 저장소의 것인지, 댓글이 정확히 @codex review인지 확인합니다.
  • 자동 리뷰가 돌지 않으면 저장소의 Automatic review와 Personal preferences를 둘 다 확인하고, PR 이벤트가 Review trigger와 맞는지 봅니다.
  • 리뷰 규칙은 테스트, 브랜치 보호, 필수 승인을 대신하지 않습니다.
  • 잡음이 되는 규칙은 결과를 보며 고치거나 뺍니다.

업무 분야 · 필요한 기능

이 기능을 가진 도구