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のみにスコープを絞ったキーを付与してください。データの隔離方法についてはセキュリティを参照してください。