Codex: Codex GitHub 統合
最終更新:2026-08-31
Codex の GitHub 統合はコアエコシステムの強みであり、Issue から PR までの完全に自動化されたワークフローを実現します。
📋 前提条件: Git と GitHub の基本操作を理解していること
1. 学ぶ内容
- GitHub 統合の設定
- Issue → PR 自動化
- PR レビューとコメント
- ブランチ管理戦略
2. GitHub 統合の設定
(1) Codex の許可
TEXT
📖 参照専用
1. Codex 設定で "Connect GitHub" を選択
2. Codex に GitHub アカウントへのアクセスを許可
3. 許可スコープを選択:
- Public リポジトリ
- すべてのリポジトリ(Private を含む)
- 選択したリポジトリ
(2) CLI 設定
BASH
# GitHub Token
export GITHUB_TOKEN="ghp_xxx"
# または auth.json に設定
cat >> ~/.codex/auth.json << 'EOF'
{
"GITHUB_TOKEN": "ghp_xxx"
}
EOF
3. Issue → PR 自動化
(1) Issue からタスクを作成
TEXT
📖 参照専用
> Fix Issue #15: White screen after user login
# Codex が自動的に:
→ Issue #15 の説明を読み取り
→ ブランチ fix/issue-15 を作成
→ 根本原因を分析
→ コードを修正
→ テストを実行
→ PR #16 を作成
→ Issue #15 をリンク
→ コメント "Fixed in #16"
(2) Issue のバッチ処理
TEXT
📖 参照専用
> Process all Issues labeled "good-first-issue"
# Codex が各 Issue を処理:
→ Issue #12: Fix typo → PR #13
→ Issue #14: Add missing type annotations → PR #15
→ Issue #18: Supplement API documentation → PR #17
▶ 例1:Alice の Issue 処理フロー
TEXT
📖 参照専用
# Alice の GitHub ワークフロー
1. コミュニティが Issue を提出 → "bug" タグを付与
2. Alice が Codex で:"Fix all P1 bugs"
3. Codex が各バグを処理:
- 修正ブランチを作成
- コードを変更
- テストを実行
- PR を作成
- Issue をリンク
4. Alice が PR をレビュー → マージ
5. Issue が自動的にクローズ
処理効率:1人3 Issues/日から15に向上
4. PR 自動化
(1) 自動 PR 作成
Codex がコード修正を完了した後、自動的に PR を作成します:
TEXT
📖 参照専用
PR Title: fix: resolve login white screen issue
Branch: codex/fix-issue-15
Base: main
Changes:
- src/auth/login.ts: Added error boundary handling
- src/components/Login.tsx: Fixed state management bug
- tests/auth.test.ts: Added 3 new test cases
Test Results: ✅ 45/45 passed
(2) PR 説明テンプレート
AGENTS.md で PR 説明フォーマットを定義:
MARKDOWN
## PR ルール
PR 説明には以下を含める:
- 変更の説明
- リンクされた Issue
- テスト結果
- スクリーンショット(UI の変更がある場合)
(3) 自動レビュー
TEXT
📖 参照専用
> Review PR #42
# Codex 出力:
## Code Review Report
### 🔴 Critical
- src/api.ts:45 - SQL concatenation, injection risk
### 🟡 Medium
- src/utils.ts:23 - Unhandled Promise rejection
- src/auth.ts:67 - Overly permissive CORS configuration
### 🟢 Suggestions
- src/models.ts:12 - Type definition can be simplified
- tests/api.test.ts - Missing edge case tests
### Summary
- 1 critical issue must be fixed before merging
- 2 medium issues recommended to fix
- 2 improvement suggestions
5. ブランチ管理
(1) 自動ブランチ命名
TEXT
📖 参照専用
Codex が命名規則に従って自動的にブランチを作成:
- fix/issue-{number}-{description}
- feature/{description}
- refactor/{description}
(2) ブランチ戦略
| 戦略 | 説明 |
|---|---|
| main から | 各タスクが main から新しいブランチを作成 |
| develop から | develop ブランチをベースにタスクを実行 |
| PR から | 既存の PR で修正を継続 |
▶ 例2:Bob のブランチワークフロー
TEXT
📖 参照専用
# Bob のチームは Git Flow を使用
1. Codex が develop から feature ブランチを作成
2. 機能完了後、PR → develop を作成
3. コードレビュー通過 → マージ
4. リリース時:develop → main
6. GitHub Actions 統合
YAML
# .github/workflows/codex-pr.yml
name: Codex PR Review
on:
pull_request:
types: [opened]
jobs:
auto-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Codex Review
run: |
npm install -g @openai/codex
codex --quiet --sandbox readonly \
"Review this PR, output review report" \
> review.md
- name: Comment PR
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
});
❓ よくある質問
Q Codex は Private リポジトリを処理できますか?
A はい、Codex に Private リポジトリへのアクセスを許可する必要があります。GitHub OAuth 認可で "All repos" を選択してください。
Q Codex が作成した PR を直接マージできますか?
A 推奨されません。コード変更を確認し、テストが通過していることを確認してからマージしてください。PR レビューを要求するブランチ保護ルールを設定してください。
Q Codex が特定のリポジトリのみを読み取るように制限するには?
A GitHub OAuth 認可で "Selected repos" を選択し、必要なリポジトリのみを許可してください。
Q Codex は GitHub Actions を操作できますか?
A MCP の GitHub サーバーを通じて Actions のトリガーと監視は可能ですが、ワークフローファイルを直接変更することはできません。
Q 複数の開発者が同じリポジトリで Codex を使用すると競合しますか?
A 異なるファイル/ブランチを変更すれば競合しません。各人は独立した feature ブランチを使用し、同じブランチでの並列操作を避けてください。
📖 まとめ
- GitHub 統合:Issue → 修正 → PR → レビュー → マージ、完全自動化
- PR 自動作成:変更説明、テスト結果を含む
- コードレビュー:多次元 — セキュリティ/パフォーマンス/スタイル
- ブランチ管理:自動命名、ターゲットブランチから作成
- GitHub Actions 統合:PR 時の自動レビュー
📝 練習問題
- 基本 (⭐):GitHub リポジトリを接続し、Codex に Issue から PR を作成させる。
- 中級 (⭐⭐):自動 PR レビューの GitHub Actions を設定する。
- 上級 (⭐⭐⭐):完全な GitHub ワークフローを設計する — Issue → 自動修正 → PR → レビュー → マージ → 通知、フローチャートを描く。