対象コーディング以外でもCodexを活用したい人

達成目標ドキュメント・分析・PM業務の自動化ができる

前提知識 Getting Started完了

所要時間 15分

その他業務

Codexはコーディングだけでなく、ドキュメント生成、コードレビュー、資料分析、PM業務、技術調査など、ソフトウェア開発に関わる幅広い業務を自動化できます。コード以外の活用パターンを紹介します。

ドキュメント自動生成

Codexはリポジトリの構造とコードを分析し、各種ドキュメントを自動生成できます。手動でのドキュメント維持は手間がかかりますが、Codexに任せることで常に最新の状態を保てます。

README自動生成

Terminal

codex "このリポジトリのREADME.mdを作成して。
以下のセクションを含めてください:
- プロジェクト概要
- インストール手順
- 使い方（基本的な例）
- 設定オプション
- 開発環境のセットアップ
- ライセンス"

API Docs自動生成

コードベースからAPIドキュメントを自動生成します。JSDocコメントがない場合でも、コードの構造から推測して生成できます。

Terminal

codex "src/api/ ディレクトリのすべてのエンドポイントについて
APIドキュメントを docs/api.md に生成して。
各エンドポイントには以下を含めて:
- HTTPメソッドとパス
- リクエストパラメータ（型と必須/任意）
- レスポンスの型
- 使用例（curlコマンド）
- エラーレスポンス"

CHANGELOG自動生成

Terminal

codex "前回のリリースタグ v1.2.0 から現在までのコミットを分析して、
CHANGELOG.md を Conventional Commits 形式で更新して。
カテゴリ: Features, Bug Fixes, Breaking Changes, Documentation"

✅ Tip

ドキュメント生成をAutomationsの定期タスクに設定すると、毎週自動でドキュメントが更新され、PRとして提出されます。レビューして承認するだけで常に最新のドキュメントを維持できます。

コードレビュー自動化

CodexとGitHubを連携させることで、PRの自動レビューを実現できます。人間のレビュアーが見るべきポイントを事前に洗い出し、レビュー効率を大幅に向上させます。

PR自動レビューの設定

.github/workflows/codex-review.yml

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

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Codex CLI
        run: npm i -g @openai/codex

      - name: Review PR
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          DIFF=$(git diff origin/main...HEAD)
          codex --approval-mode suggest \
            --quiet \
            "以下のdiffをレビューして。
            セキュリティ、パフォーマンス、可読性の観点から
            問題点と改善案をMarkdownで出力して:
            $DIFF" > review.md

      - name: Post review comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: review
            });

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

AGENTS.mdにレビュー観点を定義しておくと、プロジェクト固有の基準でレビューが実行されます。

AGENTS.md - レビューガイドライン

## Code Review Guidelines

### セキュリティ
- SQLインジェクション対策（Prepared Statement使用）
- XSS対策（ユーザー入力のサニタイズ）
- 認証・認可の適切な実装

### パフォーマンス
- N+1クエリの検出
- 不要な再レンダリングの防止（React.memo, useMemo）
- バンドルサイズへの影響

### コード品質
- 単一責任原則の遵守
- 適切なエラーハンドリング
- テストカバレッジの維持（最低70%）

📝 Note

自動レビューは人間のレビューを置き換えるものではなく補完するものです。機械的なチェック（セキュリティ、パフォーマンス）はCodexに任せ、ビジネスロジックの妥当性は人間がレビューするのが効果的です。

大量資料分析

大量のファイルやデータを分析する際、モデルの特性に応じた2段階ワークフローが効果的です。高速モデルで概要を把握し、高性能モデルで深い分析を行います。

2段階分析ワークフロー

Stage 1: 高速スキャン（o4-mini）

軽量モデルで大量のファイルを素早くスキャンし、重要なファイルや箇所を特定します。コスト効率に優れ、全体像の把握に最適です。

Stage 2: 深い分析（o3 / Claude）

Stage 1で特定された重要箇所に対して、高性能モデルで詳細な分析を実行します。コンテキストを絞ることでトークン効率も向上します。

Stage 1: 高速スキャン

# o4-mini で全ファイルを素早くスキャン
codex --model o4-mini \
  "src/ ディレクトリの全ファイルをスキャンして、
  以下の観点で問題がありそうなファイルをリストアップして:
  - セキュリティ脆弱性
  - パフォーマンスボトルネック
  - deprecated APIの使用
  ファイルパスと問題の概要を JSON で出力して"

Stage 2: 深い分析

# o3 で特定ファイルを詳細分析
codex --model o3 \
  "以下のファイルについて詳細に分析して:
  - src/auth/session.ts: セキュリティ脆弱性の詳細と修正案
  - src/db/queries.ts: N+1クエリの特定と最適化案
  各問題について、修正前/修正後のコード例を含めて"

ログ分析

大量のログファイルから異常パターンを検出する用途にもCodexは有効です。

Terminal

codex "logs/ ディレクトリのアプリケーションログを分析して。
以下をレポートしてください:
1. エラーの発生頻度トップ10
2. エラーのパターン分類
3. 根本原因の推定
4. 対処の優先順位（影響度×頻度）"

⚠️ Warning

大量ファイルの分析はトークン消費が多くなります。まずo4-miniで範囲を絞ってから、o3で深堀りする2段階アプローチを必ず採用しましょう。

PM・非エンジニア向け活用

Codexはコードを書かない職種（PM、デザイナー、ビジネスサイド）にも有用です。リポジトリの内容を自然言語で質問し、要件整理やIssue作成を効率化できます。

要件整理テンプレート

Terminal - 要件定義の支援

codex "以下の機能要件を分析して、実装計画を作成してください:

## 要件
ユーザーがダッシュボードからCSVファイルをエクスポートできる機能

## 出力フォーマット
1. 技術的な実装ステップ（各ステップの見積もり時間付き）
2. 必要なAPI変更
3. UI/UXの変更点
4. テスト計画
5. リスクと注意点"

Issue分解テンプレート

Terminal - 大きなIssueの分解

codex "以下の大きなタスクを、1-2日で完了できるサブIssueに分解して。
各サブIssueにはタイトル、説明、受け入れ基準を含めてください。
依存関係がある場合は明記してください。

## タスク
認証システムをJWTからSession-based authenticationに移行する"

仕様書作成テンプレート

Terminal - 仕様書の自動生成

codex "現在のコードベースを分析して、
以下のセクションを含む技術仕様書を作成して:

システムアーキテクチャ概要（図のテキスト表現含む）
データモデル（ER図相当のテキスト表現）
API仕様一覧
認証・認可フロー
エラーハンドリング方針
デプロイ構成"

✅ Tip

PMがCodexを使う際のポイントは、Suggestモードで実行することです。コードの変更は一切行わず、分析と提案のみを得られます。codex --approval-mode suggest で起動しましょう。

学習・技術調査

Codexの --search モードやコードベース分析機能を使って、技術調査や学習を効率化できます。

Web検索モード

--search フラグを使うと、CodexがWebを検索して最新の情報を取得した上で回答します。

Terminal

# 最新のフレームワーク情報を調査
codex --search "React 19のServer Componentsについて、
React 18からの変更点を整理して。
具体的なコード例も含めてください"

# ライブラリの比較調査
codex --search "Drizzle ORM と Prisma を以下の観点で比較して:
- パフォーマンス
- 型安全性
- マイグレーション管理
- エコシステム・コミュニティ
- 学習コスト
プロジェクトの特性に応じた選択基準も提示して"

コードベース理解

新しいプロジェクトに参画した際、Codexに質問しながらコードベースを理解できます。

Terminal - コードベースの質問

# アーキテクチャの理解
codex "このプロジェクトのアーキテクチャを説明して。
主要なモジュールとその依存関係を図解して"

# 特定の機能の追跡
codex "ユーザー登録のフローを追跡して。
リクエストがフロントエンドからDBに保存されるまでの
全ステップを、関連するファイルパスとともに説明して"

# 設計判断の理解
codex "このプロジェクトで認証にJWTではなくSession-based authが
使われている理由を、コードから推測して説明して"

ライブラリ比較・評価

Terminal

codex --search "以下の条件に合うNode.jsのジョブキューライブラリを3つ提案して:
- Redis使用可
- TypeScript対応
- 優先度付きキュー
- リトライ機能
- ダッシュボードUI

各ライブラリについて:
- GitHub Stars数
- 最終更新日
- 導入例（コードスニペット）
- メリット・デメリット
を整理して"

📝 Note

--search モードはWeb検索を伴うため、sandbox の allow_network = true 設定が必要です。セキュリティの観点から、調査専用のプロファイルを作成するのがおすすめです。