Harness Atlas

COURSE 01 · Harness Engineering

Codex の内部アーキテクチャ

OpenAIのCodexを、Claude Codeと同じ軸で内部から見る。OSレベルのサンドボックスと承認ポリシー、AGENTS.mdとセッション、MCP、そしてOSS実装とApp Serverによる埋め込み性。公式ドキュメントとソースで確認した範囲を中立に整理する。

これは詳細編「各ハーネスの中身」のレッスンです。前のClaude Code の内部アーキテクチャと同じ軸で見るので、並べて比べられます。

このレッスンの見方

Codexは、OpenAIのコーディングエージェントです。Claude Codeと同じ5つの軸で、中で何が起きているかを見ます。ループと承認、コンテキストとセッション、ツールと拡張、実行環境とサンドボックス、そしてそのハーネス固有の構造。記述は調査時点(2026年11月)に公式ドキュメントとOSSのソースで確認した範囲です。

1. ループと承認ポリシー

Codexも中心はエージェントループです。個性は、推論のループと、実際にコマンドを動かす実行を、はっきり分けている点です。実行の手前には承認ポリシーが置かれます。

公式の設定では、approval_policy が「Codexがコマンド実行の前にどこで承認を求めるか」を決めます(調査時点の値は on-request・never、および細かく指定する形)。Claude Codeが拒否優先の権限判定を何層も重ねるのに対し、Codexは承認ポリシーと、次に見るOSレベルのサンドボックスの組み合わせで止めます。

推論ループ 考える 承認ポリシー 実行(OSサンドボックス) 各OSのネイティブ機構 read-only workspace full sandbox_mode(既定は workspace-write)
Codexは推論と実行を分け、承認ポリシーとOSレベルのサンドボックス(3モード)で実行の安全を保つ。

2. コンテキストとセッション

Codexは、AGENTS.md にプロジェクトの決まりごとを書きます。置き場所に応じて階層的に読まれ、上位と下位が重なります。読み込んだファイル、ツールの結果、会話の履歴とあわせて、モデルに渡すコンテキストが組み立てられます。長くなれば /compact で要約します。

セッションは、日付別のフォルダにrolloutのJSONLとして保存されます(~/.codex/sessions/...)。codex resume で以前のセッションを続けられ、forkもできます。ここは会話履歴の保存・Clear・Resumeの内部構造で詳しく見たとおりです。

3. ツールと拡張

Codexは、MCP(Model Context Protocol)で外部のツールやデータ源をつなぎます。設定では、サーバーごとに起動コマンド(stdio)や接続先URL(HTTP)を書き、公開するツールを enabled_tools・disabled_tools で絞れます。このほか、スキルや設定ファイル(config.toml)で挙動を調整できます。

4. 実行環境とサンドボックス

Codexは、コマンドの実行を各OSのネイティブな仕組みで囲います。sandbox_mode に3つの段階があります(公式の説明)。

モード できること
read-only ファイルの参照はできるが、編集やコマンド実行には承認が要る
workspace-write(既定) 参照と、ワークスペース内の編集・定型的なローカルコマンドまで
danger-full-access サンドボックスなし。ファイルとネットワークの境界を外す

ネットワークは既定で絞られ、ブロックされた通信は承認のきっかけになります。実行境界を設定で選べること、これがCodexの土台です。実行環境の一般論は実行環境とサンドボックスの基本で扱っています。

5. 固有の構造:OSS実装とApp Server

Codexの個性は、ここにあります。CodexはOSS(Apache-2.0、Rust)で、中身をソースで読めます。さらにApp Serverという仕組みを持ち、標準入出力の上でJSON-RPCをやり取りし、会話をThread・Turn・Itemという単位で扱います。これにより、ほかのツールがCodexを部品として埋め込めます。

Claude Codeがサブエージェントで「ひとつのハーネスの中の分業」を持つのに対し、Codexは「外のツールに埋め込まれる」方向に強みがあります。

まとめ:Codexの重心

Codexは、OSレベルのサンドボックスと承認ポリシーで実行の安全を土台に置き、OSS実装とApp Serverで埋め込みやすさを備えます。どれが優れているという話ではありません。Claude Codeが拡張の口とガードを厚く持つのに対し、Codexは実行境界と埋め込み性に重心がある、という違いです。

次に読む

同じ軸で、次はCursorの内部を見ます(順次公開)。概観の比較はハーネス比較、複数を束ねる話はMeta-Harnessコースにあります。

前のレッスンコースへ戻る次のレッスン