> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codexセッションキャプチャ

> チームのローカルOpenAI Codexセッションを通常のセッションとイベントとしてAgentEyeに取り込みます — Codexの実行方法を変更することなく。

エンジニアはすでに毎日OpenAI Codexを使用しています。Codexセッションキャプチャは、それらのコーディングセッションを通常のセッションとイベントとしてAgentEyeに取り込み、他のすべての観測対象と並べて検索・再生・評価できるようにします。[Python SDK](/ja/agenteye/python-sdk)を補完する機能です。SDKは自分で作成したエージェントを計装するのに対し、こちらはチームがすでに行っているCodexの作業を、実行方法を一切変えることなくキャプチャします。

小さなバックグラウンドコレクターが、Codexのローカルセッショントランスクリプトが書き込まれる際にそれを読み取り、AgentEyeに送信します。1台のマシンにつき1つのコレクターで、すべてのローカルCodexサーフェスを一括してキャプチャします — サーフェスごとのセットアップは不要です。

同じコレクターは他のエージェントもキャプチャします — [OpenClaw](/ja/agenteye/openclaw-capture)や[Hermes](/ja/agenteye/hermes-capture)も参照してください。使用しているものをそれぞれ有効化してください。1つのコレクターで複数を同時にキャプチャできます。

***

## キャプチャされる内容

**ローカル**で実行されるすべてのCodexサーフェスは同じオンディスクセッショントランスクリプトを生成し、コレクターがそれらをすべて取得します：

* Codex **CLI**および`codex exec`
* **VS Code / IDE拡張機能**
* **デスクトップアプリ**（ローカルでセッションを実行する場合）

各CodexセッションはAgentEyeの[セッション](/ja/agenteye/sessions)になります。ユーザーとアシスタントのメッセージ、推論、ツール呼び出し、ツール結果、トークン使用量が対応する[イベント](/ja/agenteye/event-stream)になります。各セッションの発生元サーフェス（CLI、IDE、またはデスクトップ）も記録されるため、区別することができます。

> **クラウドセッションはキャプチャされません。** デスクトップアプリはセッションをCodexクラウドで実行することが増えており、マシン上にはメタデータのみが保持されます — ローカルに読み取れるトランスクリプトが存在しません。ローカルで実行されたセッションのみがキャプチャされます。

***

## 有効化する方法

キャプチャは有効化するまでオフになっています。`events:add`権限を持つAPIキーでコレクターをインストールし（[APIキー](/ja/agenteye/api-keys)を参照）、Codexキャプチャを有効化します：

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/FailproofAI/agenteye-collector/main/install.sh \
  | sh -s -- --key <YOUR_API_KEY> --codex-enabled
```

これにより、コレクターがインストールされ、バックグラウンドサービスとして登録され、キャプチャが開始されます。実行中であることを確認します：

```bash theme={null}
agenteye-collector health
```

初回実行時に既存のCodexセッションが一度バックフィルされ、その後の新しいアクティビティは数秒以内にストリーミングされます。Codexのファイルは読み取られるのみで、変更・移動・削除されることはありません。また、再起動をまたいでも各セッションは正確に1回だけ送信されます。

***

## 表示される場所

キャプチャされたセッションは**Sessions**に表示され、そのイベントは**Events**ストリームに表示されます。他の観測対象エージェントと同様に扱われるため、[セッション再生](/ja/agenteye/sessions)、[検索](/ja/agenteye/queries)、[評価](/ja/agenteye/evaluations)、[アラート](/ja/agenteye/alerts)もすべて利用できます。Codexエージェントでフィルタリングすると、そのセッションだけを表示できます。

***

## プライバシー

Codexのトランスクリプトには、コマンド出力、ファイルの内容、Codexが読み書きしたすべての内容を含む完全なセッションデータが含まれており、シークレット情報が含まれる場合があります。キャプチャされたセッションはそのまま送信されるため、AgentEyeにそのコンテンツを集約することが適切なマシンおよびチームに限定してキャプチャを有効化してください。また、コレクターには`events:add`のみにスコープを絞ったキーを付与してください。データの隔離方法については[セキュリティ](/ja/agenteye/security)を参照してください。