# ADR-0003 Codex 通过 app-server 接入

- 状态：Accepted · 日期：2026-10-22

## 决策
使用 `codex app-server`（JSON-RPC over stdio），不使用 Codex TS SDK 或 `codex exec --json`。

## 理由
- 只有 app-server 支持服务端向客户端发起审批请求，满足交互审批需求
- 事件粒度最细（item + delta），支持 thread 恢复、turn 中断、账户状态查询
- 与官方 VS Code 插件使用同一协议，长期维护有保障

## 代价
- 协议仍标注 experimental：锁定 CLI 版本，用 `codex app-server generate-ts` 生成类型并纳入版本控制
- 需要自己实现 JSON-RPC 客户端和进程管理（每份凭证一个常驻进程）