Skip to main content
您的工程师每天都在使用 OpenAI Codex。Codex 会话捕获功能将这些编码会话以普通会话和事件的形式引入 AgentEye，让您可以对其进行搜索、回放，并与其他所有观测数据放在一起进行评估。它与 Python SDK 相辅相成：SDK 用于对您自己编写的 Agent 进行埋点，而此功能则捕获团队日常使用 Codex 产生的会话数据——无需任何改动。 一个轻量级的后台采集器会在 Codex 本地会话记录写入时实时读取，并将其上报至 AgentEye。每台机器只需部署一个采集器，即可同时捕获所有本地 Codex 界面的数据，无需逐一配置。 同一采集器还支持其他 Agent 的捕获——详见 OpenClaw 和 Hermes。您可以按需启用，单个采集器能够同时捕获多个来源。

​
捕获内容

所有本地运行的 Codex 界面都会生成相同的磁盘会话记录，采集器会统一采集以下来源：
  • Codex CLI 及 codex exec
  • VS Code / IDE 扩展
  • 桌面应用（仅限本地执行的会话）
每个 Codex 会话都会成为 AgentEye 中的一个会话；其中的用户消息、助手消息、推理过程、工具调用、工具结果以及 Token 用量将转化为对应的事件。每个会话的来源界面（CLI、IDE 或桌面应用）均会被记录，便于您加以区分。
云端会话不在捕获范围内。 桌面应用越来越多地将会话运行在 Codex 云端，本地仅保留元数据，没有可供读取的本地记录。只有本地执行的会话才会被捕获。

​
启用捕获

捕获功能默认关闭，需手动启用。请使用具有 events:add 权限的 API 密钥（参见 API 密钥）安装采集器，并开启 Codex 捕获：
该命令将安装采集器、将其注册为后台服务并立即开始捕获。运行以下命令确认服务正常运行：
首次运行时，现有的 Codex 会话将被一次性回填，此后的新活动将在数秒内实时上报。采集器对 Codex 的本地文件仅执行读取操作，不会对其进行修改、移动或删除，且每个会话只会上报一次，重启后亦然。

​
数据展示

捕获的会话将出现在 Sessions 中，其事件将出现在 Events 流中，与您观测的其他 Agent 数据完全一致——因此会话回放、搜索、评估和告警均可正常使用。通过筛选 Codex Agent，可单独查看其数据。

​
隐私说明

Codex 会话记录包含完整的会话内容——包括命令输出、文件内容以及 Codex 读写的所有信息——可能涉及敏感数据。捕获的会话将原样上报，因此请仅在适合将相关内容集中存储至 AgentEye 的机器和团队中启用此功能，并为采集器配置仅限 events:add 权限的密钥。数据隔离机制详见安全说明。