Codex CLIでコードレビューを自動化する実践ガイド

⚡ 3秒でわかる！この記事のポイント

Codex CLIでGit diffを解析し、レビューコメントを自動生成できる
GitHub Actionsと連携してPR作成時に自動レビューを実行可能
セキュリティ・パフォーマンス・可読性の重み付けをカスタマイズできる

コードレビューは品質担保に不可欠ですが、レビュー待ち時間がボトルネックになりがちです。特にSES現場では、レビュアーが忙しく数日待ちになることも珍しくありません。

OpenAI Codex CLIを使えば、コードレビューの一次チェックを自動化し、レビュー品質の底上げとリードタイムの短縮を同時に実現できます。この記事では、Codex CLIによるコードレビュー自動化の実践手順を解説します。

この記事でわかること

Codex CLIでコードレビューを自動化するメリット
Git diffをCodex CLIに渡すワークフロー
レビュー観点のカスタマイズ方法
GitHub Actionsとの連携手順
レビュー精度を上げるプロンプト設計

Codex CLIでコードレビューを自動化するメリット

レビュー待ち時間の削減

人間のレビュアーに依存すると、PRがマージされるまで数時間〜数日かかることがあります。Codex CLIによる自動レビューを一次フィルターとして導入すれば、

明らかなバグや型エラーを即座に検出
コーディング規約違反を自動指摘
レビュアーは設計判断やビジネスロジックに集中できる

レビューのリードタイムを平均50%短縮したというチームの報告もあります。

一貫した品質基準の適用

人間のレビューは、レビュアーの経験や当日のコンディションに左右されがちです。Codex CLIは常に同じ基準でレビューを行うため、品質のばらつきを抑えられます。

Git diffをCodex CLIに渡すワークフロー

ステージング差分の解析

ローカル環境でのレビュー手順は以下の通りです。

# ステージング済みの差分をCodex CLIに渡す
git diff --staged | codex review --stdin

# 特定のコミット範囲を指定
git diff HEAD~3..HEAD | codex review --stdin

# ファイル指定でのレビュー
codex review src/components/UserForm.tsx

PR単位のレビュー実行コマンド

PR全体をレビューする場合は、mainブランチとの差分を取得します。

# mainブランチとの差分をレビュー
git diff main...HEAD | codex review --stdin --format=markdown

# レビュー結果をファイルに保存
git diff main...HEAD | codex review --stdin > review-report.md

Codex CLI完全ガイドで基本的なセットアップ方法を確認してください。

レビューの観点をカスタマイズする

セキュリティ・パフォーマンス・可読性の重み付け

Codex CLIでは、レビュー観点に優先順位をつけることができます。

codex review --focus="security:high,performance:medium,readability:medium" \
  src/api/auth.ts

各観点の具体的なチェック項目は以下の通りです。

観点	チェック項目例
セキュリティ	SQLインジェクション、XSS、認証バイパス、秘密情報のハードコード
パフォーマンス	N+1クエリ、不要なre-render、メモリリーク、重い計算のメインスレッド実行
可読性	命名規則、関数の長さ、コメントの過不足、マジックナンバー

プロジェクト固有ルールの設定ファイル

プロジェクトのルートに .codex-review.yml を配置してルールを定義できます。

rules:
  - name: "console.log禁止"
    pattern: "console.log"
    severity: error
    message: "console.logは本番コードに含めないでください。loggerを使用してください。"
  - name: "any型禁止"
    pattern: ": any"
    severity: warning
    message: "any型の使用は避け、具体的な型を定義してください。"

GitHub Actionsとの連携

PR作成時の自動レビューワークフロー

GitHub ActionsでPR作成時にCodex CLIレビューを自動実行する設定例です。

name: Codex Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Install Codex CLI
        run: npm install -g @openai/codex-cli
      - name: Run Review
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          git diff origin/main...HEAD | codex review --stdin \
            --format=github-pr-comment > review.md
      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const body = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: body
            });

レビューコメントの自動投稿

上記の設定により、PRに自動でレビューコメントが投稿されます。Codex CLIチームワークフローで、チーム全体への展開方法を解説しています。

レビュー結果の精度を上げるプロンプト設計

Codex CLIのレビュー精度は、プロンプト設計で大きく変わります。

効果的なプロンプトの構造

以下のコード変更をレビューしてください。

コンテキスト:
- プロジェクト: ECサイトのバックエンドAPI
- フレームワーク: NestJS + TypeScript
- 重要な観点: セキュリティ（決済処理を含む）

レビュー形式:
- 重大度: Critical / Warning / Info に分類
- 各指摘に修正案を含める
- 良い点も1つ以上コメントする

避けるべきプロンプト

「レビューして」だけの漠然とした指示
コンテキストなしでのレビュー依頼
一度に大量のファイルを渡す（500行以下に分割推奨）

Codex CLIテスト自動化の記事も、品質向上の参考になります。

Claude Code / Antigravityとのレビュー比較

2026年現在、コードレビュー自動化に使えるAIツールは複数あります。

ツール	強み	レビュースタイル
Codex CLI	GitHub連携が強力、カスタマイズ性高い	定量的・ルールベース
Claude Code	コンテキスト理解が深い、大規模リファクタリング	設計レベルのフィードバック
Antigravity	IDE統合でリアルタイムレビュー	インライン提案

チームの開発フローに合わせて、複数ツールを組み合わせるのが最も効果的です。Claude Codeコードレビューガイドも参考にしてください。

コードレビュー自動化のワークフロー図解