解锁Codex应用服务器：如何构建统一的代理框架

摘要

OpenAI构建了Codex应用服务器作为统一的JSON-RPC API，将不同客户端（Web、CLI、IDE扩展、macOS应用）连接到同一个Codex代理框架。该协议支持双向通信、线程管理、工具执行审批和流式事件传输，为合作伙伴提供了稳定可扩展的集成方案。

内容框架与概述

文章首先回顾了应用服务器的起源：最初为解决CLI与VS Code扩展之间代码复用问题而创建，后逐步演化为标准化协议。随着JetBrains、Xcode等合作伙伴提出集成需求，团队设计出支持双向JSON-RPC的App Server架构。文章随后深入剖析了内部组件——stdio读取器、消息处理器、线程管理器和核心线程的协作方式，并详细解释了三大核心原语：Item（原子输入输出单元）、Turn（代理工作单元）和Thread（持久会话容器）。最后通过初始化握手、线程轮次、工具审批等场景展示了客户端与服务器的完整消息流转过程。

核心概念及解读

Codex Harness：驱动所有Codex产品的底层代理循环和逻辑，包含核心代理循环、线程生命周期管理和工具执行扩展机制。

App Server：运行在长进程中的JSON-RPC协议层，负责在客户端与Codex核心线程之间进行消息转换和事件转发。

三大核心原语：Item（原子输入输出）、Turn（工作单元）、Thread（持久会话容器），共同构成了协议层的对话抽象。

双向JSON-RPC协议：支持客户端请求和服务器通知两种模式，服务器可主动发起审批请求以实现人机协作交互。

原文信息

此摘要卡片由 AI 自动生成