← Agents

Codex CLI

OpenAI

编程终端本地 partial lifecycle: active 核验 2026-09-29

OpenAI 官方的终端编码 agent，Rust 实现，架构上强调 app server 与线程续接。

适合与不适合

在终端做工程任务，需要接入 CI 或自建客户端的场景。已有仓库的续接与恢复是它的架构重点。

不适合需要沙箱与权限机制完全明确可控的场景—— 本次采集环境无法访问官方文档站，这几项标为未知，采购前需自行核对。

固定坐标系

8 个维度，与同赛道其他对象逐项可比。

模型与开放条件: OpenAI 自家模型。官方描述为「Lightweight coding agent that runs in your terminal」。 本次未核验统一默认模型与具体模型映射，README 未列出，记为未知。
运行位置: 本地 Rust 实现的终端进程（releases 标签为 rust-v*）。生命周期绑定终端会话，退出即结束。
本地文件: 在用户工作目录内操作。README 提供 npm 与 Homebrew 两种安装方式。 具体的沙箱默认档位与目录边界本次未核验，记为未知。
关机后的任务: 不支持终端形态的长后台任务。 是否存在云端任务入口本次未核验，记为未知。
工具与扩展: 面向工程任务的工具集（读写文件、执行命令等）。 官方文档站 developers.openai.com 在本次采集环境对 curl 返回 403，具体工具清单与 MCP 接入方式本次未核验，记为未知。
上下文与记忆: app server 架构是本工具的关键设计—— 官方文档提及自定义客户端通过 app server 接入，线程可启动、续接与恢复。 具体上下文窗口与压缩策略本次未核验。
权限与限制: 沙箱与审批边界跟随运行环境。 API key 计费与订阅不是同一额度（此点已在定价说明中确认）。 审批与沙箱模式已于 2026-10-01 核验完成（此前记为未核验）：来自 @openai/codex-sdk 源码 sdk/typescript/src/threadOptions.ts 的类型定义 —— ApprovalMode = "never" | "on-request" | "on-failure" | "untrusted"（四档）、 SandboxMode = "read-only" | "workspace-write" | "danger-full-access"（三档），网络由 networkAccessEnabled / webSearchMode（disabled/cached/live）单独控制。证据在 SDK 侧而非 CLI 文档侧 —— docs/sandbox.md 正文只有外链，所以当初核验不到。 ⚠ 三档沙箱的跨平台实现差异仍未核验（尤其 Windows）。详见 Codex SDK 档案。
适合什么任务: 在终端里做工程任务，需要接入 CI 或自建客户端的场景。 非交互模式有官方文档支持（docs/exec.md标题即 Non-interactive mode，正文为外链），这使它是本站 CLI 站里除 Gemini CLI 外唯一有非交互证据的对象。已有仓库的续接与恢复是其架构重点。

头号误解

把 API 额度当成订阅额度的一部分，两者独立计费
以为 CLI 本身就是全部，实际还有 app server 供自建客户端接入
以为文档站能直接 curl 抓取，可能被 CDN 拦截

价格

月度入口	随 ChatGPT 套餐（Free 有限 / Plus $20 扩量 / Pro $100 起最大任务量）
月度数值	$20
年付	官方定价页只列月付；年付价未列出，记为未知
额度说明	README 确认「Using Codex with your ChatGPT plan」—— 授权随 ChatGPT 订阅。 2026-10-01 按 OpenAI 官方定价页逐档核实（美元口径）： Free $0（Codex access limited）、 Go $8、Plus $20（Expanded Codex usage）、 Pro 起 $100（Maximum Codex tasks，另标5x 或 20x 更多用量）。 Business / Enterprise 另计。关键结论：Codex 额度是随套餐分档的，不是「买了就有」—— 免费层只有有限额度，Plus 是「扩量」，Pro 才是「最大任务量」。 API 计费与订阅授权不是同一额度（原 pitfall 仍成立）： API 走独立的按量计费，不消耗订阅内的 Codex 额度。

不同币种不做折算。优惠、地区、税费与登录后报价可能变化，购买前请到官方页面确认。

未知项清单

统一默认模型与模型映射
沙箱默认档位与目录边界
完整工具清单与 MCP 接入方式
上下文窗口与压缩策略
审批模式的具体形态
是否提供云端任务入口

证据来源

判断可回到以下一手源复核。本站核验日 2026-09-29，内容更新日 2026-09-29。

类型	名称	链接
repo	OpenAI · Codex CLI 仓库	https://github.com/openai/codex
changelog	OpenAI · Codex CLI Releases（rust-v0.158.0 @ 2026-09-28）	https://github.com/openai/codex/releases
changelog	OpenAI · Codex CLI Commits	https://github.com/openai/codex/commits/main
docs	OpenAI · Codex 文档	https://developers.openai.com/codex/cli

实测记录

本站尚未完成实测。测试协议见 tasks/_protocol.md。