一个编码智能体可以说它完成了任务。但这并不能告诉你最后一次测试是否通过。

打开网易新闻 查看精彩图片

日志能显示某条 shell 命令跑过,却无法单独证明结果正确。终端安静下来时,你面对的可能是权限提示、一个长时间运行的工具,或者一个早已结束回合的会话。

这是三个不同的问题,我们却一直试图用一个滚动终端同时回答它们。

Thoughtworks 的 2026 年 11 月技术雷达把大规模执行框架工程列为主题之一。r/ClaudeCode 上的一场讨论提出了一个相关问题:Claude Code 已经存在,为什么还要构建 AI 执行框架?

答案要从拆开三样常被塞进同一个标签的东西开始。

模型、执行框架、记录仪,各司其职

模型产出回复、提出动作。编码执行框架把这些提议放进工作环境:提供上下文、暴露工具、管理回合、执行权限、处理结果。Claude Code 和 Codex CLI 在这里已经做了大量工作。

记录仪观察的是既有执行框架产生的事件。它记录执行框架报告的内容,让这些活动在事后或进行中可被检视。它不需要替换执行框架,也不决定智能体被允许做什么。

这个区分很重要。权限引擎需要的是权威,记录仪需要的是证据。仅仅因为一块仪表盘在观察事件就赋予它权威,等于给工具执行开了第二个可以改变结果的地方。

后端工程里有先例:追踪和日志帮你排查一个请求,但追踪不是 HTTP 响应,追踪查看器也不该悄悄改变授权决策。智能体工具值得同样的区分。

一个事件能证明什么

假设智能体被要求修一个失败的 API 测试。你查看运行记录,找到一个测试命令、一次文件编辑,以及一条声称 bug 已修复的最终消息。

你可以对这段序列做出若干判断,但它们的证据强度并不相同。陷阱在于把活动、进展和正确性当成可以互换的东西——它们不是。

要确立正确性,你仍然需要变更后的文件、相关测试、对行为的审查,有时还需要人对需求的判断。记录仪告诉你该往哪里看,但它替你做不了这个决定。

两个编码命令行工具,两种证据来源

当你试图观察不止一个编码工具时,事情变得有意思。

Claude Code 通过钩子暴露事件。观察者可以收到会话开始、工具使用、子智能体、回合结束等受支持事件的通知。设计良好的观察钩子可以转发事件后退出,不向 Claude Code 回传任何指令。

Codex CLI 把 rollout 记录存在磁盘上。外部工具可以跟随这些文件重建会话活动。但发生过什么的记录,不等于实时的权限状态信号。特别是,Codex 的审批请求无法通过这里使用的 rollout 数据被记录仪获取。

接口不同,单一仪表盘就不该对两者宣称同样的置信度。数据流可以这样描述,而不必假装两家提供方暴露了相同的 API:

  • Claude Code — 事件钩子 → 本地事件处理 → 时间线/关系图
  • Codex CLI — rollout 文件 → 本地事件处理 → 时间线/关系图

这只是架构草图,不是协议规范。观察者仍须处理缺失事件、延迟写入、重启和不完整的会话结束。比如,一个缺少结束事件的 Codex rollout,并不能证明它的进程还在运行。

有用的可视化界面也可能在这里变成误导。一个绿点、一个计时器、一条连接两个智能体的线,看起来都很确定——除非软件能解释它是如何获得这个状态的。

证据模型应当保留不确定性

如果要为记录仪定义一份小的事件契约,我会保留每条观察的来源,而不是把所有来源压缩成一个通用的 running: true 标志:

  • source:claude-hook 或 codex-rollout
  • sessionId:会话标识
  • observedAt:观察时间
  • eventType:事件类型
  • status:observed(已观察)或 inferred(已推断)

observed 表示来源报告了该事件;inferred 表示观察者从不完整的证据推导出某个状态,比如文件里缺少结尾。两者都不等于已验证正确。记录仪的职责,是把这些区分一路保留到界面上。

为什么把 ccdeck 建在执行框架之外

我开发了 ccdeck,一个免费、开源的本地仪表盘,面向 Claude Code 和 Codex CLI。它在画布上展示会话和受支持的子智能体,让你检视捕获的工具活动,并标出正在等待人回应的 Claude Code 会话。

它的两条捕获路径刻意分开:单向的 Claude Code 钩子把事件转发给本地服务器,文件监视器则读取 Codex rollout。得到的记录可以放在一起看,尽管底层信号并不等价。

有一个设计选择比关系图更重要:观察钩子不能操纵智能体。ccdeck 的 Claude Code 转发器只投递事件、成功退出,不向标准输出写入任何决策。仓库里有一个测试,用来防止这一行为在无人察觉的情况下改变。

这是一个很窄的声明。该钩子不能批准、拒绝、推迟或改写工具调用。这也不意味着 ccdeck 完全只读:安装会向 Claude Code 设置添加一条钩子条目,可选功能可能改变本地设置或账户状态。

它也不是编排器。它不分配编码任务,不把会话变成受管工作流。我仍然在终端里启动 Claude Code 或 Codex,仍然在工作发生的地方审查输出。

本地记录仪也有隐私边界

“本地运行”是有用信息,但不是完整的隐私政策。

ccdeck 把提示词、工具调用细节等会话内容留在本机,不把这些内容放进使用报告。但使用报告默认开启,包含系统元数据、IP 地址和一个稳定的哈希设备指纹。在 deck 启动前设置环境变量 AGENTS_DECK_NO_REPORTS=1 可以关闭这些报告。

产品还默认开启局域网发现,Browser Watch 功能也默认开启,会检查 Chromium 历史记录中的某些浏览导航模式。这些都是真实的访问面,即便会话内容留在本地。评估用于敏感工作的会话记录仪时,安装前应查看其权限、默认网络行为、数据保留和解装流程。

记录仪可以有用,但不必隐形。诚实的目标是让它的访问权限变得明确。

下次运行时试试这个区分

如果你已经在用 Claude Code 或 Codex CLI,可以检视一个会话,问三个问题:哪些事实被捕获了?哪些状态是推断的?哪些结论仍需要检查代码?

需要 Node.js 18 或更高版本,启动仪表盘:

npx ccdeck

然后照常启动 claude 或 codex 会话。本地仪表盘通常打开在 http://127.0.0.1:4317;端口被占用时,使用启动命令打印的地址。桌面版安装器和一行命令在 ccdeck.dev 上。基于 Node 的 deck 可以用 npx ccdeck --stop 停止。

我建议测试一个具体命题,而不是仪表盘好不好看:它的事件历史能否帮你更快找到证据,同时不假装为智能体的答案背书?对任何智能体可观测性工具来说,这都是一个有用的门槛,包括我自己的。

Claude Code 已经有执行框架了。我不需要另一个运行时来使用它。我需要知道运行时观察到了什么、没能观察到什么,以及我自己的审查究竟从哪里开始。