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つの口から行い、重い作業はサブエージェントに切り出して並行・隔離で進められます。安全面は、拒否を先に評価するルール、自動モードの機械学習による判定、ライフサイクルの要所に差し込むフックの割り込み、そして複数の権限モードで固めます。
ひとことで言えば、手元で拡張し、ガードを重ねられるハーネスです。自分の作法や統制を細かく載せたいときに向きます。
どう読むか
どちらが上、という話ではありません。同じ「コードを書く」仕事でも、
- 自分のアプリやCIに埋め込むことを軸にするなら、Codexの分離された作りとApp Serverが効きます。
- 手元で拡張しガードを重ねることを軸にするなら、Claude Codeの4つの拡張とガードの層が効きます。
用途(埋め込むのか、手元で拡張するのか、チームで統制するのか)で選ぶのが素直です。
メタハーネスへの橋
ここで、本コースの先につながる論点が見えます。作りの違う2つのハーネスを、同じ操作・同じポリシー・ひとつのセッションで扱いたくなったら、その上に立つ層が要ります。それがメタハーネスです。この先、Claude Code・Codex・Cursor・Devin を1つずつ内部から深掘りします。4つを束ねて同じ操作で扱う考え方は、ハーネス比較とMeta-Harnessコースで扱います。
さらに読む(一次情報)
- Claude Code 公式ドキュメント(Anthropic)
- Codex as a platform: build on the open agent harness(OpenAI)
いずれも仕様は変わります。細部は判断の前に公式の最新を確認してください(本記事は調査時点の公開情報にもとづきます)。