Codex

• 4 つの入口：ChatGPT サイドバー / `codex` CLI / IDE 拡張 / クラウド実行
• 強み：クラウドサンドボックスに丸ごと展開して自律実行 → PR 作成まで一気通貫
• 弱み：Anthropic 系ほど「途中承認」が細かくない。任せる or 任せない が明確
• 課金：ChatGPT Plus 以上に付随。Cloud 実行は上位プラン推奨

                 得意な用途                        典型シナリオ
─────────── ─────────────────────────── ───────────────────────────
ChatGPT 内   質問 + 小さな変更提案           「この関数の意図を説明して」
CLI         ローカルの対話 / 承認フロー     「テスト書いて」
IDE 拡張     エディタ内で補完 + 会話        エディタから離れずに相談
Cloud       長時間・自律・PR 作成          「依存更新の PR を出しといて」

1. ChatGPT 側で GitHub 連携を許可（Settings → Connectors → GitHub）
2. CLI をインストールしてログイン
3. 対象リポで `codex` 起動、初回はサンドボックスの権限を選択
4. Cloud で使う場合は ChatGPT の「Codex」タブを開き、対象リポを追加

npm install -g @openai/codex
codex login
cd your-project
codex

1. ChatGPT サイドバーから Codex を開く
2. 対象リポと対象ブランチ（例：`main`）を選択
3. 以下のプロンプトを投入し、Auto モードで実行
4. 完了通知を待ち、生成された PR をレビュー → コメントで追加指示 or マージ

「README の Getting Started セクションを読み、実際にセットアップコマンドを走らせて、
 動かない箇所と、動くよう修正した README の diff を含む PR を作って。
 サブタスクの実行ログも PR 説明に貼って。」

                    ┌─── 情報だけ欲しい ────► Ask（変更なし）
                    │
タスクを持って ──┤
                    │                       ┌── 目視で確認したい ─► Code（diff 提示）
                    └── 変更が要る ─────┤
                                            └── 放置して仕上げたい ─► Auto（PR まで）

① 依存アップデート（Cloud + Auto 向き）
「package.json の依存を最新 minor まで更新。CI が緑になるまで直して PR を作って。」

② テスト追加（CLI + Code 向き）
「src/services/billing.ts の未カバー分岐を洗い出し、Vitest でテストを追加して。」

③ バグ再現（Ask → Code の 2 段）
「Issue #88 のスタックトレースから原因仮説を3つ挙げて。」→ 選んで「①の仮説で修正して」

④ 大規模リファクタ（Cloud + Auto）
「src/legacy 配下を、docs/migration-plan.md の方針に沿って段階的に置き換えて。
 フェーズ1（読み取り系）だけ今回の PR に含めて。」

⑤ ドキュメント生成
「public な export に TSDoc を補完。既存のスタイルに揃えて、実装から拾える情報だけで書いて。」

                             Claude Code            Codex
──────────────────────── ─────────────────── ───────────────────
主戦場                    ローカル対話            クラウド自律実行
途中承認                  細かい（diff 単位）     粗い（タスク単位）
複数タスク並走            worktree で自前        Cloud で並列自動
非対話（CI 組込み）       claude -p               codex exec / API
MCP 拡張                  厚い                    限定的
向くタスク                改修 / 議論しながら     まとまった実装 / 定期作業

• ○ Cloud に投げる時は「受け入れ条件」を PR 説明に含めさせる
• ○ Setup Script でテスト実行環境まで整えておく（依存 / DB / env）
• ○ Auto 実行のログは必ず PR に貼らせる（後追い調査で救われる）
• × 認証・秘密鍵の書き換えを Cloud に丸投げ → 秘密の露出リスク
• × 巨大リポの main を Auto → 変更範囲が読み切れなくなる。sub-directory を絞る

codex               # 対話モード
codex exec "..."    # 非対話 1 発実行（CI 向き）
codex login         # 再ログイン
codex --help        # 全コマンド

# クラウド側（ChatGPT UI）
- Setup Script: リポ初期化コマンド（pnpm i など）
- Environment: 実行に必要な env / secrets
- Approvals: PR 作成前に人間確認を挟むか

GitHub 連携 → 最初の Issue 発注 → PR レビューまで。