Codex로 하는 코드 리뷰: /review, @codex review, 내 규칙

코드 리뷰에서 Codex가 하는 일

• 풀 리퀘스트마다 버그, 빠진 테스트, 위험한 변경을 리뷰하고 GitHub에 인라인 댓글을 답니다.
• 적어 둔 리뷰 규칙을 따르므로, 린터가 이미 확인하는 부분에는 댓글을 달지 않습니다.
• 자기 변경과 다른 에이전트의 변경을 사람에게 가기 전에 리뷰합니다.
• 후속 작업을 추적합니다. 손볼 게 있는 댓글은 잊히지 않고 이슈가 됩니다.

코드 리뷰에 쓰는 Codex 기능

코드 리뷰용 Codex 설정 방법

1. 도구 연결하기

   /review에는 Git 저장소만 있으면 됩니다. GitHub에서 리뷰받으려면 저장소를 Codex에 연결하고 Codex 설정에서 그 저장소의 코드 리뷰를 켜세요.

   # GitHub의 풀 리퀘스트 댓글에서
   @codex review
   @codex review for issues in the database migration

2. AGENTS.md에 규칙 쓰기

   Codex는 일을 시작하기 전에 AGENTS.md를 읽습니다. 먼저 ~/.codex/AGENTS.md를, 이어서 저장소 루트부터 작업 중인 폴더까지의 파일을 읽습니다. 이 일의 규칙을 여기에 넣거나, 길다면 .agents/skills/ 아래 스킬로 만드세요. AGENTS.md 가이드를 참고하세요.

   ## Code Review Rules
   - billing/과 auth/의 새 분기에 테스트가 없으면 짚으세요.
   - SQL 마이그레이션에는 모두 롤백이 있어야 합니다. 없으면 말하세요.
   - 포맷에는 댓글을 달지 마세요. 린터가 맡습니다.
   - 댓글만 다세요. 승인, 변경 요청, 머지는 하지 마세요.

3. 대화형 화면 없이 실행하기

   codex exec 명령은 작업 하나를 실행하고 종료합니다. 진행 상황은 stderr로, 최종 메시지는 stdout으로 나옵니다. -o는 최종 메시지를 파일에도 쓰고 --json은 이벤트를 스트리밍합니다. --sandbox workspace-write를 넘기지 않으면 샌드박스는 읽기 전용입니다.

   # 스크립트나 CI에서 이 브랜치를 main과 비교해 리뷰
   codex review --base main
   
   # 또는 아직 커밋하지 않은 변경
   codex review --uncommitted

4. 일정에 올리기

   ChatGPT 데스크톱 앱이나 웹에서 예약 작업을 만들거나(CLI로는 관리할 수 없습니다), cron에서 codex exec 명령을 실행하세요. Codex를 능동적으로 만드는 방법을 참고하세요.

출처: Codex 문서

한계와 안전

• 댓글을 달 뿐, 변경을 책임지지는 않습니다. 승인과 머지는 사람이 하세요.
• 리뷰는 플랜 사용량을 씁니다. 푸시할 때마다가 아니라 요청할 때나 풀 리퀘스트가 준비됐을 때 리뷰하세요.
• diff와 저장소를 리뷰합니다. 프로덕션 데이터로 테스트할 수는 없습니다.
• Codex는 기본적으로 명령을 샌드박스 안에서 실행합니다. 쓰기는 워크스페이스 안에서만 되고 네트워크는 꺼져 있습니다. danger-full-access는 격리된 러너나 컨테이너에서만 쓰세요.

코드 리뷰에는 Claude Code와 Codex 중 무엇을 쓸까요?

규칙은 그대로 옮겨 쓸 수 있습니다. AGENTS.md에 한 번 쓰고 CLAUDE.md에 @AGENTS.md를 넣으면 두 에이전트가 같은 파일을 읽습니다.

다른 에이전트용 단계별 안내: Claude Code에서 하는 코드 리뷰.

코드 리뷰 담당자 두기

명령어는 누군가 기억해서 실행할 때만 돌아갑니다. Crewmark는 내 Codex 세션을 역할, 숫자로 된 목표, 근무 시간, 하트비트를 갖춘 AI 직원으로 바꿔, 일이 일정에 맞춰 진행되고 보드에 올라오게 합니다.

1. 역할에서 시작하기

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

2. 일을 보드에 올리기

   이 일을 반복 이슈로 추가하세요. 직원이 하트비트에 깨어나 일을 하고 댓글로 보고합니다.

3. 관련 페이지

   모든 PR에 AI 코드 리뷰에서 모든 방법을 비교하고, 보안 리뷰는 취약점을 다룹니다.

자주 묻는 질문