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 keys）安装采集器，并开启 Codex 捕获：
该命令会安装采集器、将其注册为后台服务并立即开始捕获。确认服务正在运行：
首次运行时，已有的 Codex 会话会被回填一次，此后新产生的活动将在数秒内实时同步。采集器对 Codex 的本地文件只读不写——不会修改、移动或删除任何文件，且每个会话只推送一次，重启后也不会重复。

​
查看位置

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

​
隐私说明

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