Harness Atlas

COURSE 01 · Harness Engineering

Claude CodeとCodexのハーネスを比較する

同じコーディングエージェントでも、ハーネスの作りは違う。Claude CodeとCodexを並べ、共通の土台と設計の重心の違いを中立に読み解く。各ハーネスの中身へ入る導入。

これは詳細編「各ハーネスの中身」の導入です。まず身近な2つ(Claude CodeとCodex)を並べて感触をつかんでから、各ハーネスを1つずつ内部から深掘りします。

同じ仕事、違う作り

Claude Code(Anthropic)とCodex(OpenAI)は、どちらもターミナルで動くコーディングエージェントです。やることは近いのに、ハーネスとしての作りには個性があります。ここでは、どちらが優れているかではなく、設計の重心がどこにあるかを並べて見ます。自分の用途に合うほうを選ぶための地図だと思ってください。

共通の土台

まず、2つが共有している部分を押さえます。入口で見たハーネスの基本が、どちらにもそろっています。

  • エージェントループ:モデルが次の一手を決め、ツールを実行し、結果を戻して繰り返す。
  • プロジェクト指示のファイル:リポジトリに置いたMarkdownで、守ってほしい前提や作法を伝える。
  • ツールとサンドボックス:ファイル操作やコマンドを、隔離された環境で実行する。
  • 承認(approval/permission):危ない操作の前に確認を挟む。
  • MCPとマルチターンのセッション:外部ツールの接続と、会話をまたいだ作業の継続。

入口で見た言葉でいえば、指示ファイルは行動を導く「ガイド」、サンドボックスと承認は行動を止める「ガード」に当たります。土台は同じです。

Codexの重心:埋め込めるハーネス

Codexは、ハーネスそのものをオープンソースのリファレンス実装として公開しています(Apache-2.0、Rustで書き直し)。プロジェクト指示は AGENTS.md に書き、リポジトリの階層をたどって読み込みます。

設計の特徴は、推論のループと、ツールの実行を分けていることです。さらに「App Server」というstdio上のJSON-RPCの仕組みで、Codexのコアをどんなクライアントにも載せられるようにしています。やり取りの単位は Item(入出力)・Turn(1回分の仕事)・Thread(会話のまとまり)です。アプリ側が画面・文脈・MCP・承認を持ち、App Server側がループとサンドボックス実行を持つ、という分担です。

ひとことで言えば、覗けて、埋め込めるハーネスです。自分のアプリやCIにCodexのコアを組み込みたいときに向きます。

Claude Codeの重心:拡張とガードを重ねるハーネス

Claude Codeは、プロジェクト指示を CLAUDE.md に書きます(モデルにはユーザーの文脈として渡るので、従うかどうかは確率的です)。

設計の特徴は、拡張の口とガードの層が厚いことです。拡張は MCP・プラグイン・スキル・フックの4つの口から行い、重い作業はサブエージェントに切り出して並行・隔離で進められます。安全面は、拒否を先に評価するルール、自動モードの機械学習による判定、ライフサイクルの要所に差し込むフックの割り込み、そして複数の権限モードで固めます。

ひとことで言えば、手元で拡張し、ガードを重ねられるハーネスです。自分の作法や統制を細かく載せたいときに向きます。

Codex の重心 埋め込める(App Server・ 推論と実行の分離) Claude Code の重心 拡張とガード(4つの口・ 権限モード) 共通の土台 エージェントループ・指示ファイル・ツール/サンドボックス・承認・MCP
土台は共通。その上で、Codexは「埋め込める」こと、Claude Codeは「拡張とガード」に重心がある。

どう読むか

どちらが上、という話ではありません。同じ「コードを書く」仕事でも、

  • 自分のアプリやCIに埋め込むことを軸にするなら、Codexの分離された作りとApp Serverが効きます。
  • 手元で拡張しガードを重ねることを軸にするなら、Claude Codeの4つの拡張とガードの層が効きます。

用途(埋め込むのか、手元で拡張するのか、チームで統制するのか)で選ぶのが素直です。

メタハーネスへの橋

ここで、本コースの先につながる論点が見えます。作りの違う2つのハーネスを、同じ操作・同じポリシー・ひとつのセッションで扱いたくなったら、その上に立つ層が要ります。それがメタハーネスです。この先、Claude Code・Codex・Cursor・Devin を1つずつ内部から深掘りします。4つを束ねて同じ操作で扱う考え方は、ハーネス比較とMeta-Harnessコースで扱います。

さらに読む(一次情報)

いずれも仕様は変わります。細部は判断の前に公式の最新を確認してください(本記事は調査時点の公開情報にもとづきます)。

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