多代理可观测性方案：Claude Code与Codex的统一监控平台

multi-agents-claude-codex项目提供了一个本地部署的实时可观测性仪表板，统一追踪Claude Code和OpenAI Codex的代理事件，帮助开发者监控多代理工作流的完整生命周期。

当AI代理工作从单一会话扩展到多代理协作时，可观测性成为关键挑战。开发者需要回答的问题变得复杂：

• 哪个代理正在执行什么任务？
• 工具调用的输入输出是什么？
• 会话之间的调用关系如何？
• 模型选择和性能表现如何？
• 失败发生在哪个环节？

传统的日志记录方式难以应对这种复杂性。代理事件分散在不同进程的输出中，缺乏统一的时间线和关联分析。当出现问题时，开发者往往需要在多个终端窗口和日志文件之间来回切换，效率低下且容易遗漏关键信息。

multi-agents-claude-codex项目构建了一个本地运行的可观测性平台，通过Hook机制捕获Claude Code和Codex的运行时事件，提供统一的监控、分析和审计能力。

该项目的核心创新在于同时支持两个主流AI编程代理——Anthropic的Claude Code和OpenAI的Codex，并通过标准化的数据模型实现跨平台的事件关联分析。

项目通过两种机制捕获代理事件：

Claude Code Hooks：利用Claude Code的settings.json配置，在关键生命周期点（SessionStart、UserPromptSubmit、PreToolUse、PostToolUse等）触发Python脚本，将事件数据发送到本地服务器。

Codex Hooks：通过.codex/hooks.json配置，同样捕获Codex会话的事件。特别值得注意的是，项目设计让Codex保持OAuth凭证的所有权，Hook脚本仅接收事件JSON，不接触敏感认证信息。

不同代理平台的事件格式各异。项目通过normalize.ts模块将Claude Code和Codex的原始负载转换为统一的标准化事件模型，同时保留原始数据用于深度分析。

标准化事件包含以下关键字段：

• 运行时标识（claude-code / codex）
• 事件类别（session、turn、tool、agent等）
• 状态信息（started、completed、failed、blocked）
• 模型名称和工具信息
• 持续时间、工作目录、会话关联

事件数据存储在本地SQLite数据库中，同时通过WebSocket实时推送到前端仪表板。这种设计既保证了数据的持久化，又支持实时监控场景。

基于Vue 3构建的Web界面提供：

• 时间线视图：按时间顺序展示所有代理事件
• 过滤器：按源应用、会话、事件类型、模型、工具筛选
• 聊天转录：查看完整的对话历史
• 图表分析：统计视图展示代理活动模式

这是项目最显著的特点。开发者可以在同一个仪表板中同时观察Claude Code和Codex的活动，比较两者的行为模式，甚至分析跨平台的协作场景。

标准化事件模型让这种统一成为可能。无论底层代理如何不同，上层分析工具都使用一致的接口。