OpenAI Codex CLI実践テクニック集｜サンドボックス活用・マルチファイル編集・CI連携

前回の入門編では、Codex CLIのインストールから基本操作までを解説しました。今回は実践編として、現場ですぐに使えるテクニックを深掘りします。

サンドボックスの高度な活用法、複数ファイルの一括編集、CI/CDとの連携、そしてSES現場で特に役立つコードレビュー自動化まで、具体的なコマンド例とともに紹介します。

サンドボックスモードを使いこなす

入門編でサンドボックスの基本は理解できたはずです。ここでは実務で差がつくサンドボックスの活用テクニックを解説します。

full-autoモードの実践的な使い方

--full-autoモードは、サンドボックス内でAIが自律的にコード実行・修正・テストを繰り返します。人間が毎回承認する必要がないため、大きなタスクを任せるのに最適です。

codex --full-auto "src/配下のTypeScriptファイルをESLint修正して、テストが通ることを確認して"

このコマンドだけで、Codex CLIは以下を自動で行います。

サンドボックス内での実行なので、万が一AIが暴走してもホスト環境には一切影響しません。結果を確認してから承認すればOKです。

サンドボックスのカスタマイズ

Codex CLIではサンドボックスの挙動をカスタマイズできます。プロジェクトルートにcodex.md（またはAGENTS.md）を配置することで、AIの動作をプロジェクトに合わせて制御できます。

# codex.md

## プロジェクトルール
- テストフレームワーク: vitest
- パッケージマネージャ: pnpm
- コーディング規約: src/ 配下は厳密な型定義を使うこと
- テスト実行コマンド: pnpm test
- 変更禁止: .env*, config/production.*

この設定ファイルにより、AIがプロジェクトの文脈を正確に理解した上でコードを生成します。特にSES現場で複数プロジェクトを掛け持ちする場合、プロジェクトごとにcodex.mdを用意しておくと切り替えがスムーズです。

サンドボックスで安全にDB操作を試す

データベースマイグレーションの検証にもサンドボックスは有効です。

codex --full-auto "Prismaスキーマにuserテーブルのemail_verified カラムを追加して、マイグレーションファイルを生成して"

サンドボックス内でマイグレーションファイルを生成・確認してから本番環境に適用できるため、スキーマ変更のミスを事前に防げます。

マルチファイル編集テクニック

Codex CLIの真価はプロジェクト全体を理解した上での一括編集にあります。単一ファイルの修正なら他のツールでもできますが、依存関係を跨いだ変更はCodex CLIが得意とする領域です。

型定義の変更を全ファイルに反映

codex exec "User型のidフィールドをnumberからstringに変更して、関連する全ファイルを修正して"

Codex CLIは以下を一括で処理します。

• 型定義ファイル（types/user.ts）の修正
• API層のバリデーション更新
• テストのモックデータ修正
• フロントエンドのコンポーネント修正

手作業なら数時間かかる変更が数分で完了します。

API仕様変更の一括対応

codex exec "REST APIのレスポンス形式を { data: T, meta: { total: number } } に統一して。全エンドポイントとテストを修正して"

インポートパスの一括変更

プロジェクト構成の変更時に威力を発揮します。

codex exec "src/utils/ を src/lib/utils/ に移動して、全ファイルのimportパスを更新して"

ファイル移動だけでなく、import文の書き換え、tsconfig.jsonのpaths設定まで依存関係を考慮して一括更新してくれます。

CI/CDパイプラインとの連携

Codex CLIはターミナルで動くため、CI/CDパイプラインへの組み込みが容易です。GitHub ActionsやGitLab CIで自動化する具体的な方法を解説します。

GitHub Actionsでコードレビュー自動化

Codex CLIをGitHub Actionsに組み込むことで、PRごとに自動コードレビューが実行されます。

# .github/workflows/codex-review.yml
name: Codex Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install -g @openai/codex
      - name: Run Codex Review
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          DIFF=$(git diff origin/main...HEAD)
          codex exec "以下のdiffをレビューして、問題点をマークダウンで出力して: $DIFF" > 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: `## 🤖 Codex CLI Auto Review\n\n${body}`
            });

テスト生成の自動化

新しいファイルが追加されたPRに対して、テストが不足していれば自動で生成するワークフローも構築できます。

- name: Generate Missing Tests
  run: |
    NEW_FILES=$(git diff --name-only origin/main...HEAD -- '*.ts' '*.tsx' | grep -v '.test.')
    for file in $NEW_FILES; do
      TEST_FILE="${file%.ts}.test.ts"
      if [ ! -f "$TEST_FILE" ]; then
        codex exec "$file のユニットテストを $TEST_FILE に作成して"
      fi
    done

CI連携時の注意点

SES現場でのコードレビュー自動化

SES現場ではコードレビューの属人化が課題になりがちです。Codex CLIを活用すれば、一定品質のレビューを自動化できます。

レビュー観点の標準化

プロジェクト固有のレビュー観点をcodex.mdに記載しておくことで、AIレビューの品質が安定します。

# codex.md - レビュー観点

## コードレビュー時のチェック項目
1. セキュリティ: SQLインジェクション、XSS、認証漏れ
2. パフォーマンス: N+1クエリ、不要な再レンダリング
3. 可読性: 関数の長さ（50行以上は分割を提案）
4. テスト: カバレッジ不足の指摘
5. 型安全性: any型の使用禁止

ローカルでのセルフレビュー

PRを出す前に、ローカルでCodex CLIによるセルフレビューを実行する習慣をつけましょう。

# コミット前のセルフレビュー
codex exec "git diff --cached のコードをレビューして。セキュリティ・パフォーマンス・可読性の観点で問題点を指摘して"

これにより、レビュアーの負担を減らしつつ、PRの品質を底上げできます。SES現場では「レビュー指摘が少ない＝信頼される」ので、評価アップにも直結します。

チーム展開のステップ

実践コマンドチートシート

現場ですぐコピペできるコマンド集です。

# サンドボックスでリファクタリング
codex --full-auto "src/api/ の重複コードを共通関数に切り出して"

# 型定義から実装を自動生成
codex exec "types/api.ts の型定義に基づいて、APIクライアントを src/api/client.ts に生成して"

# テストカバレッジを向上
codex --full-auto "カバレッジが低いファイルを特定して、テストを追加して80%以上にして"

# ドキュメント自動生成
codex exec "src/ 配下の全exportにJSDocを追加して、README.mdのAPI一覧も更新して"

# セキュリティチェック
codex exec "プロジェクト全体をセキュリティ観点でレビューして。脆弱性があれば修正して"

# パフォーマンス改善
codex exec "src/components/ のReactコンポーネントでメモ化が不足している箇所を特定して修正して"

よくある質問（FAQ）

まとめ

Codex CLIは入門レベルの使い方だけでは真価を発揮しません。サンドボックスの高度な活用、マルチファイル編集、CI/CD連携を組み合わせることで、開発生産性を大幅に引き上げられます。

AIコーディングツールを比較検討したい方は「AIコーディングツール比較2026」も合わせてご覧ください。Codex CLIの基本から学びたい方は「Codex CLI使い方入門」をどうぞ。Claude Codeとの使い分けが気になる方は「Claude Code使い方入門」もおすすめです。

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ