2026 年版 Codex 完全マスターガイド（開発者向けコース）

私は Claude Code を 12 ヶ月間使いました。その後、Codex に切り替えて 30 日間使いました。

そこでわかったこと

2026 年の Codex の正体

ほとんどの人は今でも Codex を賢いオートコンプリートだと思っています。違います。

• Codex は完全なエージェント型ソフトウェア開発プラットフォームです。コードベースを読み、コードの記述とテスト、プルリクエストのレビュー、Mac デスクトップの操作、ウェブの閲覧、画像の生成、定期的なタスクのスケジュール、そしてセッション間での設定の記憶まで行います。
• この変化には大きな意識の切り替えが必要です。あなたはコードを書く人ではなくなります。眠らないジュニアエンジニアチームが書いたコードをレビューする人になるのです。

ほとんどの開発者は Codex をインストールし、2 週間ほど一行プロンプトを送り、平凡な結果を得て、諦めます。彼らは AGENTS.md を設定しません。Skill を書くこともありません。サブエージェントも使いません。全機能の 5% しか使わず、その 5% でツールを評価しているのです。

このコースでは残りの 95% を扱います。

5 つのインターフェース

何かをインストールする前に、Codex がどこに存在するのかを理解しましょう。どのインターフェースを選ぶかによって、作業の追跡のしやすさやコードの実行場所が決まります。

CLI はスクリプト化されたワークフロー、単一タスク、ヘッドレス自動化に適しています。コードがあなたのマシンを離れるのは、プッシュしたときだけです。オープンソースで Rust 製、macOS、Windows、Linux で動作します。

IDE 拡張機能は、ファイルの正確なコンテキストを伴うインタラクティブな編集に適しています。VS Code、Cursor、Windsurf、JetBrains にインストールできます。CLI の認証情報を使用するため、別途ログインは不要です。

デスクトップアプリは、マルチスレッドワークフロー、アプリ内ブラウザ、Computer Use、Goal モード、Appshots、Automations の拠点です。2026 年 2 月に macOS で、2026 年 3 月 4 日に Windows でリリースされました。

Cloud は、非同期のバックグラウンドタスク、並列 PR、寝ている間に作業を進めるためのものです。タスクは、GitHub リポジトリがあらかじめ読み込まれたサンドボックスコンテナ内で実行されます。ローカルマシンに負荷がかかりません。

アプリ内ブラウザと Computer Use は、UI の検証、フロントエンドの反復、エンドツーエンドテストに使用します。Codex がローカル開発サーバーを開き、操作し、結果をスクリーンショットで確認し、コード変更が正しい視覚的出力を生成したことを検証します。

実際のワークフローでは複数のインターフェースを使い分けます：

• CLI → スクリプト化された処理
• IDE → インタラクティブな機能開発
• Cloud → 監視が不要な並列タスク
• App → Goal 指向の長時間タスク

インターフェースを選ぶ主な基準は、エージェントの作業をどの程度細かく追跡したいかです。変更が行われるたびに監視したい場合は、CLI または IDE で作業を自分のマシン上で可視化します。長時間のセッションを委任して最後にレビューしたい場合は、Cloud が適切です。

思考モデル：オートコンプリートではなくエージェント

インターフェースが明確になったところで、次は作業単位の考え方を変える必要があります。

作業の単位はターンではなくタスクです。出力はチャットの応答ではなく PR です。

「X をする関数を書いて」ではなく、「機能 Y を実装して、これが制約です。完了したらテストを実行してください」と考えるようにしましょう。

すべての Codex タスクは同じ内部ループに従います。Codex はタスクとコンテキストを読み込み、内部計画を立て、ステップごとに実行し、自身の作業をチェックします。

Codex をコーディングアシスタントとして考えるのをやめましょう。朝に指示を出し、午後にレビューするジュニアエンジニアチームとして考えるのです。

実際の例として、WorkOS の開発者は今や朝のコーヒーを飲む前に 4～5 件の Codex タスクをキューに入れます。席に戻る頃には、2～3 件の完了した PR がレビュー待ちで、かつては 1 日の 30～40% を占めていたメンテナンス作業を処理しています。

2026 年 5 月時点の現在のモデル：

• GPT-5.5（デフォルト）— ほとんどのタスクを処理、レイテンシは以前と同じですが、同じ作業に必要なトークンが大幅に削減されています
• GPT-5.3-Codex — 長時間の自律実行、大規模なリファクタリング、並列クラウドファンアウト専用に設計、以前の Codex 専用モデルより 25% 高速
• GPT-5.5 Pro — 最高レベルの推論、Pro、Business、Enterprise プランのみ
• Codex Mini — ChatGPT Free で永続的に無料、学習に最適

Codex はデフォルトで GPT-5.5 のままにしておきましょう。Codex が長時間自律的に実行される大規模なエージェントタスクには GPT-5.3-Codex に切り替えます。

はじめに：最初の実際のセッション

動作する Codex セッションへの最短ルートは以下の 5 つのステップです。FizzBuzz チュートリアルは忘れてください。実際のコードベースから始めましょう。

ステップ 1：CLI をインストールします。

ステップ 2：実際のプロジェクトを開きます。

自分がよく知っている、リスクの低いリポジトリに移動してください。これが重要です。

Codex は、出力を認識して間違いを見つけられる場合にパフォーマンスが向上します。初めてのセッションで馴染みのないコードベースを扱うと、予測不能な結果になります。

プロンプトが表示されたら、ChatGPT アカウントでサインインします。ブラウザが自動的に開きます。「続行」をクリックしてターミナルに戻ります。

ステップ 3：何をするよりも先に /init を実行します。

この単一のコマンドは、ほとんどのチュートリアルで省略されています。Codex がディレクトリと Git 履歴をスキャンし、言語、フレームワーク、ビルドコマンド、テストコマンドを特定し、見つかった内容を反映した AGENTS.md ファイルを自動生成します。

生成されたファイルをレビューし、間違っている部分を修正し、コミットします。今後このプロジェクトで Codex を起動するたびに、自動的に読み込まれます。

ステップ 4：Codex にオリエンテーションタスクを与えます。

変更を依頼する前に、コードベースの説明を依頼してください。これにより、Codex がどのようなコンテキストを読み込んでいるか、あなたの自信が高まります：

出力を読みます。実際のコードベースを正確に説明しているなら、必要なコンテキストは揃っています。曖昧または間違っている場合は、AGENTS.md に詳細を追加する必要があります。

ステップ 5：1 つの小さな実際のタスクを与えます。具体的で範囲が明確なものを選びましょう。

これが正しい Codex プロンプトの形です：具体的なファイルのコンテキスト、期待される結果、制約、そして定義された検証ステップ。返ってきた差分をレビューします。これで Codex を正しく使えています。

ステップ 6：デスクトップアプリをインストールします。OpenAI のウェブサイトからダウンロードし、同じ ChatGPT アカウントでサインインします。

ステップ 7：IDE 拡張機能をインストールします。エディタの拡張機能パネルで「OpenAI Codex」を検索します。CLI の認証情報を自動的に読み取ります。

ステップ 8：GitHub を接続します。Codex アプリ内の設定に移動し、GitHub アカウントを接続します。クラウドタスクを使用する前に、少なくとも 1 つのリポジトリをリンクしてください。

各設定の場所：

• ~/.codex/config.toml : メイン設定：承認モード、サンドボックスモード、MCP サーバー、モデルのデフォルト
• ~/.codex/AGENTS.md : 個人用 AGENTS.md、すべてのプロジェクトに適用
• <project>/AGENTS.md : プロジェクトレベルの指示
• <project>/.agents/skills/ : プロジェクトレベルの Skill
• <project>/.codex/config.toml : プロジェクトスコープの設定（信頼できるプロジェクトのみ）

AGENTS.md：リポジトリで最も重要なファイル

動作するセッションができたので、次は今後のすべてのセッションが同じ品質で開始されるようにすることです。それが AGENTS.md の役割です。

1. AGENTS.md は、平凡な Codex 出力と一貫した高品質な出力を分ける唯一のファイルです。
2. これはリポジトリのルートにあるプレーンな Markdown ファイルです。プロジェクトで Codex セッションが開始されるたびに、エージェントが何かをする前に自動的に読み込みます。
3. これはオープンスタンダードです。Codex、Cursor、Gemini CLI、Windsurf、GitHub Copilot がすべて読み取ります。一度書けば、ツールチェーン内のすべてのエージェントが同じ情報源を参照します。

解決順序：Codex は ~/.codex/AGENTS.md（ホームレベル、全プロジェクト）と <project>/AGENTS.md（プロジェクトレベル）を読み取ります。AGENTS.override.md ファイルは各レベルで優先されます。合計サイズの上限は 32 KiB です。

記述する内容：

• スタック、フレームワーク、言語バージョン、パッケージマネージャー
• 正確なビルド、テスト、開発コマンド（コピー＆ペースト可能な形式、「通常のテストを実行」ではなく）
• ファイル構造の規則と命名ルール
• スタイルとパターンのルール
• 禁止領域：触れてはいけないもの
• リリース要件：CI、PR の規約、デプロイ方法

記述しない内容：

• シークレットや認証情報（ファイルはバージョン管理下にあるため）
• 曖昧なガイダンス（「きれいなコードを書く」はエージェントにとって無意味）
• README と重複するドキュメント

500 語以内に抑えましょう。膨張すると、有用なコンテキストがモデルのワーキングメモリから押し出されてしまいます。

動作するテンプレート：

• Codex が AGENTS.md を読み取っているか確認する：読み込まれている現在の指示を要約するようにプロンプトを送信
• 大規模なモノレポの場合、サブディレクトリ内に追加の AGENTS.md ファイルを配置します。
• packages/api/AGENTS.md にあるファイルは、そのパッケージ内のタスクに対してルートレベルのファイルよりも優先されます。
• codex trust . を実行して、プロジェクトレベルの .codex/config.toml を有効にします。これにより、悪意のあるクローンリポジトリがあなたの知らないうちに Codex を設定するのを防ぎます。

CLI の詳細

AGENTS.md を設定したら、次に習得すべきは CLI そのものです。ほとんどのユーザーは codex とだけ入力し、真に強力なコマンドを使いこなせていません。

実際の日常的な使用の 95% をカバーする 4 つのコマンドがあります。

codex は探索、反復、コードベースとの対話のためのインタラクティブモードを開きます。

codex exec "<task>" は Codex を非対話的に実行します。標準出力にストリームし、完了すると終了します。これはスクリプト化可能なあらゆるもののためのパワーツールです：

exec を git フック、CI パイプライン、cron ジョブに組み込みましょう。自動化の構成要素です。

codex resume --last は中断したところから正確に再開します。すべてのセッションは保存されています：

codex cloud は非同期クラウドタスクを管理します。Cloud セクションで詳しく説明します。

便利なフラグ：

• --json : 他のツールにパイプするための JSONL イベントストリーム
• --model <name> : GPT-5.5 または GPT-5.3-Codex を選択
• --reasoning <level> : low、medium、high
• --search : タスク中にウェブ検索を許可
• -C <dir> : 別の作業ディレクトリで実行
• --sandbox <mode> : このセッションのサンドボックスモードを上書き
• --approval <policy> : このセッションの承認ポリシーを上書き

サンドボックスと承認

CLI はパワーを与えます。サンドボックスは、Codex がそのパワーのうちどれだけを許可なく行使できるかを制御します。これを適切に設定することで、リスクを生み出さずにワークフローを高速に保てます。

サンドボックスは、Codex が何をできて何をできないかを制御する境界です。正しく設定することで驚きを防ぎます。

3 つのサンドボックスモード：

1. workspace-write（デフォルト） : ワークスペース内での読み書き、日常的なコマンド、許可がない限りネットワークアクセスなし。ほとんどの場合これを使います。
2. read-only : 読み取りのみ、書き込みなし、シェルなし。コードレビューや探索に使用。
3. danger-full-access : 制限なし。ほとんど使いません。テスト済みで検証済みの自動化にのみ使用。

2 つの承認ポリシー：

• untrusted — 信頼されていないコマンドの前に毎回確認。学習中や馴染みのないプロジェクトで使用。
• on-request（デフォルト） — ルーチンのサンドボックスコマンドは自動承認、サンドボックス境界を破るものの前に確認。

auto_review は、AGENTS.md に基づいて自動承認または拒否を行うレビュー担当サブエージェントです。

設定で approvals_reviewer = "auto_review" と有効にします。長時間の非同期タスクや Goal モードで、すべてのステップを監視したくない場合に適しています。

常に承認を求めてくるコマンドを追加します。破壊的なコマンドは決して追加しないでください。

Codex への効果的なプロンプト入力

サンドボックスを設定し、セッションを実行しています。次のレバーはプロンプトの質です。これは出力品質に他のどの変数よりも大きな影響を与えます。

Codex の出力品質に最も大きな影響を与えるのはプロンプトの構造です。曖昧なプロンプトは曖昧なコードを生みます。

フレームワーク：指示、提示、説明、想起。

• 方法ではなく、望む結果を指示する
• 入力例と期待される出力を提示する
• 使用する API、ライブラリ、パターンを説明する
• AGENTS.md の規約を想起させる

毎回すべてが必要なわけではありません。小さなバグ修正なら指示と想起だけで十分です。新しい機能なら通常 4 つすべてが必要です。

1. 単一変更ルール：Codex は 1 つのことでは劇的にパフォーマンスが向上しますが、5 つではそうでもありません。「認証バグを修正し、テストを追加し、ユーザーリポジトリをリファクタリングし、README を更新する」はコイン投げのようなものです。同じ作業を 4 つのプロンプトに分割すれば信頼性が高まります。
2. 非自明なものには最初に計画を強制する：「最初に計画を提示し、承認があるまでコードを書かないでください。」30 秒の計画レビューで、30 分の間違った実装のデバッグを回避できます。
3. 失敗時の動作を明示的に指定する。Codex は放っておくと、テストを通すためなら手段を選びません：

コンテキストを明示的に制限します。読む特定のファイルを指定します。「それ以外は読み取ったり修正したりしないでください。他の場所の情報が必要なら私に聞いてください。」

推論の努力レベル：

• Low : 些細な編集、フォーマット、単純なリファクタリング
• Medium（デフォルト） : ほとんどの機能開発とバグ修正
• High : アーキテクチャ決定、困難なデバッグ、大規模な複数ファイルのリファクタリング

Goal モード

単一タスクのプロンプトが自然に感じられるようになったら、次のレベルは Codex に複数日にわたる目的を与え、作業の順序付けを任せることです。

Goal モードは、タスクごとに指示するには大きすぎるが、単一の目的には一貫している作業に適しています。2026 年 5 月に安定しました。

実行中の Goal を管理するコマンド：

1. codex goal status : アクティブな Goal とその進捗を表示
2. codex goal logs <id> : Codex がこれまでに何をしたか確認
3. codex goal pause <id> : 実行を停止し、入力待ち
4. codex goal resume <id> : 中断したところから再開
5. codex goal cancel <id> : 停止して Goal を破棄

まずは範囲を限定した Goal から始めましょう。「最大 5 件の PR」のように、Codex が目的をどのように解釈するかを信頼できるようになるまで。暴走した Goal が自信満々で間違ったことをするのが最悪の結果です。

常に上限を設定：最大 PR 数、PR あたりの最大コード行数、PR 間の CI ゲート、明確な停止条件。AGENTS.md でカバーされていないアーキテクチャ上の決定があれば一時停止。破壊的な API 変更があれば一時停止。

Skill：再利用可能なワークフロー

Goal モードは大規模な取り組みを処理します。Skill は、すべてのプロジェクトで発生する繰り返しのマイクロワークフローを扱います。セッション間で同じ指示を繰り返していることに気づいたら、それが Skill を書く合図です。

Skill は、ディレクトリとしてパッケージ化された再利用可能なワークフローです。SKILL.md ファイル内の指示と、オプションのリソースやスクリプトで構成されます。

Codex は名前と説明で Skill を発見します。タスクが Skill をトリガーしたときにのみ、完全な指示が読み込まれます。50 個の Skill があっても、トリガーされるまではコンテキストコストはゼロです。

Skill の保存場所：

• 個人用 : $HOME/.agents/skills/ : プロジェクト横断的、リポジトリに関係なくあなたの仕事の仕方を反映
• チーム用 : .agents/skills/ リポジトリ内 : プロジェクト固有、バージョン管理、共同作業者と共有

SKILL.md の形式：

パワーユーザーが最初に書くべき 3 つの Skill：

1. open-pr は標準的な PR ワークフロー：ブランチを確認、プッシュ、構造化された本文で PR を作成、ラベルを適用、レビューを依頼。日常業務で最も使用される Skill。
2. new-feature は PRD と AGENTS.md を読み、既存のコンポーネントを再利用できるか特定し、計画を出力し、承認を待ち、実装し、テストし、open-pr Skill を介して PR を開きます。PRD に曖昧な点があれば、コード生成前に質問します。
3. investigate は診断のみで修正しない Skill。再現を確認し、関連するコードパスを読み、仮説を立て（「X は Y が原因で発生していると考えます」）、仮説と検証計画を Markdown で出力します。修正は実装しません。出力は理解であり、コードではありません。

investigate Skill が重要なのは、Codex は放置すると毎回根本原因分析をスキップしてしまうからです。直接修正に飛びつき、その修正はしばしば間違っています。investigate-first を強制することは、デバッグ出力の品質を最大限に向上させる単一の改善策です。

Skill が読み込まれていることを確認：利用可能な Skill を一覧表示

サブエージェントと並列処理

Skill は繰り返し可能なワークフローを処理します。サブエージェントは並列のワークフローを処理します。この区別は重要です。並列処理を間違えると、解決する問題よりも多くの問題を生み出すからです。

サブエージェントは、独立した分離されたエージェントインスタンスです。独自のコンテキストで実行され、サマリーを返し、コンテキストは破棄されます。これは、メインエージェントのコンテキストで実行される Skill とは異なります。

サブエージェントが適切な 3 つのパターン：

1. 探索 : サブエージェントを起動して 30 ファイルを読み込み、要約させる。読み込みはサブエージェントのコンテキストで行われ、あなたのコンテキストには影響しません。
2. 並列実装 : 5 つの独立した機能を 5 つの同時サブエージェントに任せ、それぞれが独自のコンテキストと計画を持ちます。
3. 検証 : 新たなレビュー担当サブエージェントは、コードを書いた直後であるというバイアスがありません。

カスタムサブエージェントは .codex/agents/<name>.md で定義します：

• サブエージェントのアドレス指定は 2026 年 3 月にリリースされました。実行中のサブエージェントに @<nickname> で話しかけられます。
• 複数のサブエージェントが並列実行されているときに、1 つだけを他のものに影響を与えずにリダイレクトしたい場合に便利です。
• ファンアウトパターン：独立したタスクで N 個のサブエージェントを並列に起動し、結果を統合します。
• 5 つのタスクが、最も遅いものの所要時間で完了します。経験則：タスクがメインコンテキストで 30 秒未満なら、そこで実行するだけです。

デスクトップアプリ：あらゆるもののための Codex

サブエージェントと Skill は CLI、IDE 拡張機能、デスクトップアプリのすべてで同等に動作します。しかし、デスクトップアプリには CLI に相当するものがない機能が存在します。

2026 年 4 月 16 日の「Codex for (almost) everything」アップデートにより、デスクトップアプリはコーディングツールから完全な開発者ワークステーションへと変貌しました。

Computer Use

Codex が Mac を操作します：クリック、タイピング、スクロール、アプリの起動、メニューの操作、そしてカーソルのフォーカスを奪わずにあなたの隣で動作します。

• キラー用途は動作検証です。ユニットテストは通っても UI が壊れていることはよくあります。
• Computer Use はそのギャップを埋め、Codex が開発サーバーを開き、関連するフローをクリックし、結果をスクリーンショットで確認できるようにします。
• 有効にするには、Codex 設定、Computer Use、インストールに進みます。macOS のプロンプトが表示されたら、画面収録とアクセシビリティの許可を付与します。任意のプロンプトから呼び出します：

ロック時の Computer Use を使用すると、画面がロックされた後も Codex がデスクトップアプリを操作し続けられます。設定の Computer Use で有効にします。就寝前にタスクを開始し、マシンをロックし、朝に結果を確認します。

Appshots

Command-Command を押すと、最前面の macOS ウィンドウが直接 Codex のスレッドに取り込まれます。

Codex はスクリーンショット、表示テキスト、アクセシビリティテキストをキャプチャします。多くの場合、画面外にスクロールされたコンテンツも含まれます。

• Appshots なし：エラーを確認、Codex に切り替え、質問を入力、スクリーンショットを撮り、ドラッグ＆ドロップ、さらにコンテキストを入力。30 秒の摩擦。
• Appshots あり：エラーを確認、Command-Command を押し、質問をする。5 秒。

過去 60 秒以内に Codex のスレッドとやり取りしていた場合、Appshot はその会話に追加されます。それ以外の場合は新しいスレッドが開きます。同一セッション内の複数の Appshot は 1 つのスレッドにまとめられます。画面収録とアクセシビリティの許可が必要です。

アプリ内ブラウザ

アプリ内ブラウザは、ページプレビューではなくネイティブのエージェントブラウザです。ローカル開発サーバーを開き、クリックし、フォームに入力し、DOM の状態を検査し、スクリーンショットを撮り、先ほど書いたパッチが視覚的なバグを修正したことを検証します。

1. その中でローカル開発サーバーを開き、レンダリングされた要素に自然言語で直接コメントを追加します。
2. 要素に「このボタンを 20 ピクセル高くして」と書くと、Codex がコードベースに変更を適用し、ページをリロードします。
3. アプリ内ブラウザは、ウィンドウ管理のオーバーヘッドなしに直接 DOM にアクセスでき、実際のブラウザからはサンドボックス化されています。

Memory

Memory により、Codex はセッション間でコンテキストを保持できます。

• 各セッションの終了後、Codex はやり取りを要約し、~/.codex/memories/ に書き込みます。
• 次のセッションでは、プロンプトを読み込む前にそれらのファイルを読み取ります。
• Codex はあなたの好みのコミットメッセージ形式、テストフレームワーク、アーキテクチャパターン、そして前回のミスを学習します。これらのコンテキストを繰り返し伝える必要はありません。
• 設定で有効にするか、config.toml に [features] セクションで memories = true を追加します。

90 以上のプラグインエコシステム

プラグインは、Skill、MCP、統合機能を厳選してバンドルしたものです。codex plugins install <name> でインストールします。

主要なプラグインカテゴリ：

• プロジェクト管理 : Linear、JIRA、GitHub
• CI/CD : CircleCI、Vercel、GitHub Actions
• データベース : Neon、Postgres、PlanetScale
• コード品質 : Sentry、CodeRabbit
• 生産性 : Notion、Remotion

毎日使用するツールのみインストールしてください。可能な限りプロジェクトごとにスコープを設定します。四半期ごとに監査します。すべてのプラグインは、使用するかどうかに関わらずコンテキストトークンを消費します。

Codex Cloud：非同期ワークの規模拡大

デスクトップアプリはローカルおよびインタラクティブな作業を支えます。Cloud は、単一のインタラクティブセッションには大きすぎる作業や、他のことに集中している間に複数のタスクを並行して実行したい場合に利用します。

Codex Cloud は、Codex を高速なコーディングアシスタントから、水平方向にスケールするジュニアエンジニアチームへと変える機能です。

タスクを送信すると、Codex はリポジトリが事前に読み込まれたサンドボックスを起動し、作業を行い、テストを実行し、PR を開きます。ローカルマシンに負荷はかかりません。

単一タスクの送信：

並列タスクのコアパターン：

20 分後、4 つの PR が開かれています。レビュー、トリアージ、マージ。

CSV ファンアウトを使用すると、タスクのファイルを送信でき、Codex が進行状況を追跡しながら並列クラウドエージェントとして展開します：

codex cloud でアクティブおよび完了したタスクを閲覧します。codex cloud apply <task-id> でマージ前にローカルに変更を取り込みます。

GitHub 統合

クラウドタスクは PR としてリポジトリに届きます。GitHub 統合により、それらの PR がどのようにレビューされ、Codex が既存の CI/CD パイプラインにどのように組み込まれるかが決まります。

Codex と GitHub は 3 つのレベルで統合されます：リポジトリ環境、プルリクエストレビュー、CI/CD のための codex-action。

リポジトリ環境が基盤です。Codex 設定で GitHub リポジトリをリンクすると、クラウドタスクはリポジトリをクローンし、サンドボックスコンテナ内でタスクを実行し、結果をブランチまたは PR としてプッシュします。AGENTS.md はすべてのクラウドタスクで自動的に読み取られます。

プルリクエストレビューは 2 つの方法で機能します：

• 任意の PR コメントで @codex review にメンションします。Codex は目の絵文字で受信を確認し、その後、AGENTS.md に照らして深刻な問題に焦点を当てた構造化レビューを投稿します。
• 自動レビューをオンにすると、Codex は手動トリガーなしで新しいすべての PR に投稿します。

Codex がレビューを投稿した後、PR コメントスレッド内で直接、指摘された問題を修正するよう依頼できます。同じブランチに修正をコミットし、PR を更新します。

codex-action は公式の GitHub Action で、プッシュ、スケジュール、イシュー作成、PR オープンなど任意のトリガーで CI/CD パイプライン内で Codex CLI を実行します。これは、人間が介在しない完全自動化パイプラインに Codex を統合する推奨方法です。

Automations：無人作業

GitHub 統合は、人間が PR を開いたときの処理を行います。Automations は、人間が関与する必要がないときの処理を担当します。

Automations は、専用のワークツリーで実行されるスケジュール済みの Codex タスクです。Automations パネルから設定します：名前、プロジェクト、プロンプト、スケジュール、実行環境。

スレッド再利用は 2026 年 4 月にリリースされました。Automations は実行間でスレッドを再利用でき、コンテキストを蓄積し、時間の経過とともに賢くなります。

すべてのプロジェクトが持つべき 3 つのスターター Automation：

1. 週次依存関係レビュー（月曜午前 6 時）：pnpm outdated と pnpm audit を実行。クリティカル、メジャー、マイナーの各レベルの調査結果を報告。安全なマイナーおよびパッチアップグレードは自動 PR。クリティカルおよびメジャーアップデートには触れない。それらは人間の判断が必要。
2. 日次 Sentry トリアージ（平日午前 8 時）：過去 24 時間のエラーをフィンガープリントでグループ化して取得。各グループで 3 回以上発生したものについて、ファイルと行を特定し、関連コードを読み、根本原因を特定。トリアージレポートを投稿。診断のみ、修正なし。
3. 週次古い PR クリーンアップ（金曜午後 5 時）：7 日以上経過したオープン PR を一覧表示。各 PR について、あなた待ちか、レビュー待ちか、古くなったかを判断し、リマインダコメントを投稿。何も閉じたりマージしたりしない。

出力が読まれなくなった Automation は削除しましょう。優れた Automation は、あなたが必ず実行するであろう定期的なタスクを節約し、1 つのスキャン可能な出力を生成し、無人で破壊的なアクションを行いません。

MCP 統合

Automations はリポジトリ内のものと連携します。MCP サーバーは Codex を拡張し、リポジトリ外のあらゆるものと連携できるようにします。

MCP（Model Context Protocol）はプラグインの背後にあるオープン仕様です。既存のプラグインがあればそれを使用します。内部ツールへのカスタム統合には生の MCP を使用します。

• STDIO : Codex がローカルプロセスを起動し、標準入出力で通信。個人利用の 95% をカバー。
• Streamable HTTP : Codex がネットワークエンドポイントに接続。ホスト型のチーム MCP に使用。

生の MCP サーバーの追加：

または ~/.codex/config.toml に直接：

ツールごとの承認設定

ツールごとに承認設定を構成できます。読み取り操作は自動承認し、書き込み操作は確認を求めるように設定可能です。各 MCP サーバーはツール定義を Codex のコンテキストに追加し、トークンを消費して注意力を分散させます。実際に使用するものだけを有効にしましょう。

Docker MCP Toolkit を使うと、Codex を 220 以上のプリビルドサーバーに接続できます。コマンドは次の一つだけです:

1docker mcp-client configure codex

モバイルアプリ

MCP サーバーは Codex が到達可能な範囲を拡張します。モバイルアプリは、あなたが Codex にアクセスできる場所を拡張します。

2026 年 5 月 14 日、Codex が iOS と Android の ChatGPT モバイルアプリに登場しました。

モバイル版の Codex は、リモートコントロールおよび監視用のインターフェースであり、コードエディタではありません。典型的なユースケースは、デスクを離れている間に、スマートフォンから長時間実行中のクラウドタスクや Goal モードの実行を確認することです。

スマートフォンから以下の操作が可能です:

• ラップトップ、Devbox、または接続されたリモート環境での実行状況をライブで確認
• スレッドを閲覧し、並列タスク間を移動
• ブランチにマージされる前の差分 (diff) を確認
• Codex がハードウェア上で実行しようとしているコマンドを承認または拒否
• より強力なモデルが必要な場合、タスク途中でモデルを切り替え
• 新しいプロンプトから、または GitHub イシューから直接、新しいタスクを開始
• Codex がオープンしたプルリクエストにコメント

セットアップするには、ChatGPT を 2026 年 5 月 13 日リリース以降にアップデートし、デスクトップと同じアカウントでサインインし、設定の Codex 配下の Environments で少なくとも 1 つのクラウド環境が設定されていることを確認してください。モバイルアプリは、既存のすべてのスレッドと接続済みホストを自動的に継承します。

これにより実現する実用的なループ: 家を出る前に Goal モードの実行を開始し、通勤中にその進捗を確認し、スマートフォンから保留中の決定を承認し、最初の 2 つの PR が既にオープンされた状態でオフィスに到着する。

Chrome 拡張機能

モバイルアプリはあなたのリーチを拡張します。Chrome 拡張機能は、あなたが既にログインしているあらゆるウェブサイトへの Codex のリーチを拡張します。

• これにより、認証が必要なサービスにアクセスできます: LinkedIn、Salesforce、Gmail、Workday、およびログインが必要な内部ツールなど。
• インストール方法: Codex デスクトップアプリ内の Plugins に移動し、Chrome プラグインを追加し、セットアップガイドに従ってください。
• 拡張機能はアクティブ時に「Connected」ステータスを表示します。任意の Codex スレッドから呼び出せます:

Codex は、サブエージェントを介して異なるスレッドで複数の Chrome タブを制御でき、各タブは分離されています。

ヘッドレスブラウザ自動化に対する大きな利点: Chrome 拡張機能はウェブ開発者ツールにアクセスできます。Codex は DOM を検査し、コンソールエラーを読み取り、ライブブラウザセッションでランタイムの問題を診断できます。macOS と Windows の両方で動作します。

Codex SDK

Chrome 拡張機能はブラウザ自動化を担当します。SDK はプログラムによる自動化を担当し、Codex をインフラストラクチャとして独自のアプリケーションやパイプラインに組み込みます。

Codex SDK は、開発者が自身のアプリケーションや CI パイプラインから Codex をプログラムで制御できるようにします。

JavaScript SDK のインストール:

1npm install codex-sdk

基本的な使用法:

1import { Codex } from 'codex-sdk';
2const codex = new Codex();
3const thread = await codex.createThread();
4await thread.run('Explain this codebase');

• 同じスレッドで再度 run() を呼び出して会話を続行します。codex.resumeThread(threadId) で保存したスレッドを復元します。
• Python SDK では from codex_app_server import Codex を使用します。開始時にモデル名を指定: thread = codex.thread_start(model="gpt-5.5")。
• SDK は現在実験的な段階で、ローカルの Codex CLI インストールが必要です。
• ローカルの app-server と JSON-RPC 経由で通信します。デスクトップアプリで操作するのと同じエージェントを制御します。

検証: Codex の出力を実際に信頼する方法

上記のすべてのインターフェースは出力を生成します。検証とは、その出力のうち実際に出荷できる量を決定するものです。

生成は解決済みです。検証がボトルネックです。

5 つの並列クラウド PR は、バグを出荷する 5 つの機会です。検証レイヤーがなければ、スループットは PR を読む速度によって制限されます。

核心的な問題は自己への追従 (sycophancy) です。コードを書いたモデルは、それが正しいと考えるバイアスを持っています。自身の作業をレビューするように依頼すると、ほとんどの場合、承認が返ってきます。

2 つの構造的な修正:

1. auto_review (Codex 内部) は、Codex に組み込まれたレビュアーサブエージェントです。新しいコンテキストで、以前の出力に固執せず、実際の問題を指摘する可能性がはるかに高いです。
2. クロスプロバイダー検証 (ゴールドスタンダード) は、Codex が書き、Claude Code がレビューすることを意味します。クロスプロバイダーは、特定のモデルファミリーに固有の盲点を捕捉します。これは、プロダクションコードのための最小限の検証習慣です。

Computer Use による動作検証は、「テストが通る」と「実際に機能する」の間のギャップを埋めます。Codex に開発サーバーを開かせ、関連するフローをクリックさせ、結果をスクリーンショットし、PRD と比較させます。

すべての PR における最小限の習慣: 自分で差分を開く前に、別のモデルで自動レビューを実行する。最初にレビューサマリーを読む。レビューがクリーンになった場合のみ差分を開く。その後は、正しさではなく、味付けのために読む。UI の変更については、スクリーンショットを見る。

レシピ: 実戦で試されたパターン

検証習慣が整ったところで、開発者が Codex で最も頻繁に実行するタスクのためのエンドツーエンドテンプレートを紹介します。

1. 機能を実装する: new-feature Skill を使用。PRD と AGENTS.md を読む。最初に計画を立て、承認を待つ。ハッピーパスと 1 つのエラーケースのテスト。不明な点があれば、コードを生成する前に質問する。
2. バグを修正する: 最初に investigate Skill を使用。診断のみ。再現手順、根本原因の仮説、検証計画を出力する。確認が取れるまで修正しない。
3. リファクタリング: grep で全ての箇所をリストアップ。移行計画を出力。承認を待つ。既存のテストは全て修正なしで合格すること。テストの更新が必要な場合、テストが間違っています。止めて報告。1 つの PR。
4. サードパーティ統合: /lib/integrations/[name].ts にラップ。env 変数を .env.example に追加。この PR では UI なし。外部サービスに対する手動テストのためにドラフトとしてオープン。
5. テストのバックフィル: ハッピーパス、エッジケース、エラーケースをカバーするテスト計画を出力。承認を待つ。全てのテストが既存のプロダクションコードに対して合格すること。プロダクションコードは修正しない。
6. 依存関係のアップグレード: バージョン間のリリースノートを読む。破壊的変更をリストアップ。承認を待つ。アップデートし、コード変更を適用。クリーンになるまでテストを実行。
7. Goal モードのイニシアチブ: 最大 PR 数、PR あたりの最大コード行数、PR 間の CI ゲート、明確な停止条件で制限。AGENTS.md にないアーキテクチャ上の決定で一時停止。破壊的な API 変更があれば一時停止。

よくある間違い

これらのパターンは一般的な成功例をカバーしています。以下のセクションでは、一般的な失敗例、つまり多くの悪い Codex 体験を説明する 10 の間違いをカバーします。

1. 曖昧なタスク: 具体的な成果物、ファイル、制約を指定する。具体的にできないなら、タスクは指示する準備ができていない。
2. AGENTS.md がない: 作成する。たとえ質が悪くても、ないよりはマシ。
3. 計画をスキップする: 些細でないことには「最初に計画を立てる」。
4. マルチタスクプロンプト: プロンプトは 1 つのタスクにつき 1 つ。並列作業にはサブエージェントまたはクラウドタスクを使用。
5. 危険なフルアクセスから始める: workspace-write と on-request が、テスト済みの自動化以外のすべてのデフォルトとして適切。
6. MCP とプラグインが多すぎる: リストをスリムに保つ。積極的に使用していないものは無効にする。
7. 自己レビュー: auto_review または完全に別のツールを使用する。コードを書いたモデルはそれに対してバイアスがある。
8. コンパイル成功を正しさとして信頼する: 動作検証を含める。UI の変更には Computer Use を使用。
9. 過剰な並列化: 独立した作業のみを並列化する。共有ファイルは直列化する必要がある。
10. 制限のない Goal: 最大 PR 数、最大コード行数、最大時間、明確な停止条件。Goal モードは、ジュニアエンジニアに与えるリード（制約）があるときに最も有用。

クイックリファレンスチートシート

CLI コマンド:

1codex        # 新しいスレッドを開始
2codex resume # 最後のスレッドを再開
3codex status # アクティブなスレッドを一覧表示
4codex config # 設定を開く
5codex skill  # 利用可能な Skill を管理

重要なファイルの場所:

• グローバル設定: ~/.codex/config.toml
• グローバル AGENTS.md: ~/.codex/AGENTS.md
• プロジェクト AGENTS.md: <repo-root>/AGENTS.md
• 上書きファイル: AGENTS.override.md
• メモリー: ~/.codex/memories/
• Skill (個人): $HOME/.agents/skills/
• Skill (チーム): リポジトリ内の .agents/skills/
• サブエージェント: .codex/agents/<name>.md

4 つの部分からなるプロンプト構造:

1. 指示 : 方法ではなく、成果を伝える
2. 提示 : 入力例と期待される出力例を示す
3. 説明 : 使用する API、ライブラリ、パターンを説明する
4. 注意喚起 : AGENTS.md の規約を思い出させる

結論

Claude を 12 ヶ月使用した後、転機となったのは特定の悪い日があったからではありません。レート制限、ワークフローの摩擦、そして常に邪魔をするデスクトップアプリアイの蓄積でした。

そのフラストレーションが、Codex への移行を後押ししました。

• 過去 90 日間、OpenAI エコシステムに深く関わってきたことで、一つ明確になったことがあります。Codex は、本格的な開発者ワークフローのための作業環境として、より完成度が高いと感じられます。
• エージェンティックモデルはより強力で、周辺のインターフェースはより広範で、AGENTS.md、Skill、Cloud、検証ループが整えば、システムを信頼しやすくなります。
• これは Claude Code に価値がないという意味ではありません。トレードオフが意味をなさなくなったということです。

Claude Code がまだあなたのワークフローに合っているなら、使い続けてください。しかし、レート制限、不安定なセッション、そしてあなたのプロセスと戦っているように感じるツールにうんざりしているなら、Codex は今や本格的な切り替えを正当化するのに十分なほど優れています。

この記事は、その切り替えを容易にするために書かれました。

楽しんでいただけたなら幸いです。さあ、構築を始めましょう ❤️

免責事項

この記事は、著者が自身のノート、調査、個人的な経験に基づいて執筆し、AI モデル (Sonnet 4.6) によって編集されました。

サムネイル画像は Pinterest から取得し、AI を使用して修正しました。