Skip to main content
エンジニアたちはすでに毎日 OpenAI Codex を使っています。Codex セッションキャプチャは、それらのコーディングセッションを通常のセッションおよびイベントとして AgentEye に取り込むことで、他の観測対象と並べて検索・再生・評価できるようにします。これは Python SDK を補完する機能です。SDK は自分で書いたエージェントを計装するのに対し、こちらはチームがすでに行っている Codex の作業をキャプチャします — 使い方を変える必要は一切ありません。 小さなバックグラウンドコレクターが Codex のローカルセッショントランスクリプトを書き込みと同時に読み取り、AgentEye に送信します。1 台のマシンに 1 つのコレクターを置くだけで、すべてのローカル Codex サーフェスを一括でキャプチャできます — サーフェスごとのセットアップは不要です。 同じコレクターで他のエージェントもキャプチャできます — OpenClaw や Hermes をご覧ください。使用しているものをそれぞれ有効にしてください。1 つのコレクターで複数を同時にキャプチャできます。

​
キャプチャされる内容

ローカルで動作するすべての Codex サーフェスは同じオンディスクのセッショントランスクリプトを生成し、コレクターはそれらをすべて取得します。
  • Codex CLI および codex exec
  • VS Code / IDE 拡張機能
  • セッションをローカルで実行している場合のデスクトップアプリ
各 Codex セッションは AgentEye のセッションになり、ユーザーとアシスタントのメッセージ、推論、ツール呼び出し、ツールの結果、トークン使用量が対応するイベントになります。各セッションの発生元（CLI、IDE、またはデスクトップ）も記録されるため、区別することができます。
クラウドセッションはキャプチャされません。 デスクトップアプリはセッションをますます Codex クラウドで実行するようになっており、マシン上にはメタデータのみが保存されます — ローカルに読み取るトランスクリプトは存在しません。ローカルで実行されたセッションのみがキャプチャされます。

​
有効にする方法

キャプチャは有効にするまでオフになっています。events:add 権限を持つ API キー（API キーを参照）でコレクターをインストールし、Codex キャプチャを有効にします。
これにより、コレクターのインストール、バックグラウンドサービスとしての登録、およびキャプチャの開始が行われます。動作を確認するには次のコマンドを実行してください。
初回実行時に既存の Codex セッションが一括でバックフィルされ、その後の新しいアクティビティは数秒以内にストリーミングされます。Codex 自身のファイルは読み取り専用です — 変更・移動・削除は一切されません。また、再起動をまたいでも各セッションは正確に 1 回だけ送信されます。

​
表示される場所

キャプチャされたセッションは Sessions に表示され、そのイベントは他の観測対象エージェントと同様に Events ストリームに表示されます — そのため、セッションリプレイ、検索、評価、アラートもすべて利用できます。Codex エージェントでフィルタリングすると、それだけを表示できます。

​
プライバシー

Codex トランスクリプトにはセッション全体が含まれます — コマンド出力、ファイルの内容、Codex が読み書きしたものすべてを含み、シークレットが含まれることもあります。キャプチャされたセッションはそのまま送信されるため、AgentEye にその内容を集約することが適切なマシンおよびチームに限ってキャプチャを有効にしてください。また、コレクターには events:add のみにスコープされたキーを使用してください。データがどのように隔離されて保管されるかについては、セキュリティをご覧ください。