Codex Harness全面开源

Posted on Views:

OpenAI 于 2026-08-19 宣布将驱动 Codex App / CLI / IDE 扩展运行的底层执行框架（Agent harness）完整开源（Apache-2.0，仓库 github.com/openai/codex），核心是把”自家商业产品的 Agent 运行时”对外完全开放。最新稳定版 v0.149.0（2026-08-20），截至发文仓库约 10.7 万 Star。

1.Harness 是什么

  • 底层执行框架，统一管理对话状态、工具调用、沙箱执行、流式输出、人工审批，是 Codex App / CLI / VS Code 插件共用的同一套基础设施。
  • 设计哲学与 DeepSeek Harness 呼应：Everything through the harness——模型被封装后，以可控、可审批、可持久化的方式对外提供能力。
  • 技术栈：Rust 核心（codex-rs）+ TypeScript SDK，定位生产环境嵌入。

2.为什么值得关注

此前只开源 CLI 前端，底层 Rust 核心和 app-server 未开放。本次关键变化是 app-server 协议 + SDK 集成接口完整开放，开发者可：

    1. 把 Codex Agent 嵌入自己的产品（不只调 CLI）
    1. 替换底层模型（OpenAI / DeepSeek / 任意 OpenAI 兼容端点）
    1. 在 CI/CD 中无人工干预运行 Agent

核心论据：ARC-AGI-3 上，仅通过 harness 策略优化（retained reasoning + context compaction），GPT-5.6 得分从 13.3% → 38.3%，输出 token 减少 6 倍——同一模型、不同 harness，效果差 3 倍。

3.三层集成接口（核心）

层级 形态 适用场景
codex exec 非交互 CLI 调用，后台起 exec-server，完即退出 CI 脚本、一次性任务、批量
Codex SDK（TS） 程序化编排，支持 thread start/fork/resume、stream 事件、推理强度（low/max/ultra） 多轮 Agent 产品
Codex app-server JSON-RPC 2.0 进程间通信层，传输含 stdio / unix socket / WebSocket（实验性） 产品级持久会话 + 流式 + 审批

app-server三大原语：

Thread（完整会话）→ Turn（单轮交互）→ Item（原子事件：消息/推理/Shell/文件编辑/工具结果）。

4.v0.149.0 主要更新

  • codex agents 仪表盘：交互式 Agent 生命周期管理（启动/停止/重命名）
  • **codex queue**：向运行中会话追加消息，无需等当前 Turn 完成
  • TUI 内新增 /cd、/pwd、/cwd 切目录
  • SDK 支持 reasoningEffort: max/ultra
  • codex doctor 增强（诊断端点/网络/桌面状态）
  • Bug 修复：队列唤醒空闲会话、resume/fork 正确还原权限 Profile、Sub-agent 重复活动、WebRTC 断线自动重连

5.自定义模型接入

model-provider 支持任意 OpenAI 兼容端点，改 base_url + API Key 即可（文中以七牛云统一接口举例）。配置文件 ~/.codex/config.toml。

6.FAQ 要点

  • 与 DeepSeek Harness 非同一套（独立开发、理念相近），Codex 可作为子代理嵌套进 DeepSeek Harness。
  • codex-rs 是 Rust 重写核心，TS/Node 仅作上层接口；并发响应远超 Node 时代。
  • app-server 的 WebSocket 仍 experimental，生产建议 stdio / unix socket。
  • CI 免弹窗：exec 用 --approval-policy auto（或 suggest）。
  • Codex for OSS：面向开源维护者提供 API credits，入口 chatgpt.com/community/codex-for-oss。

未开源：IDE Extension 内部实现、Codex Cloud 托管服务本身。