Codex CLI
OpenAI 官方终端 AI 编程 Agent，GPT-6 Astra 默认驱动，支持 ACP
Claude Code 的 OpenAI 版镜像。Plus / Pro 已含、Windows 原生沙箱、Rust 速度快，喜欢 GPT 派的人首选；Claude Sonnet 4.5 在长任务上仍略胜，喜欢 Claude 的留 Claude Code。
TL;DR
一句话： Codex CLI 是 OpenAI 官方做的终端 Coding Agent，对标 Claude Code。Rust 实现 + Windows 原生沙箱 + 子代理 + MCP + Hooks，ChatGPT Plus/Pro/Team/Edu 已含使用额度。
2026-07 最新：稳定版 0.144.1（7-09）接入 GPT-5.6 家族（Sol/Terra/Luna）；新增 ACP 支持，可在 Devin Desktop / Zed 等 ACP 客户端里作为 Agent provider 运行；此前已作为公测 Agent provider 进入 JetBrains（经 GitHub Copilot，7-07）。
2026-09 更新：GPT-6 Astra 成为 Codex CLI 默认模型（v0.153.4，9-3 起），并在 /plugins 中按 OpenAI Curated / Workspace / Shared-with-me 分组、支持按线程追踪 rollout token 预算；详见 GPT-6 Astra 发布 与 AI 编程周报 2026-09-12。
2026-09 更新（v0.154.0，9-12 前后）：破坏性变更——codex mcp-server 入口已被移除，脚本 / 服务定义 / 编辑器集成里还在调它的必须先替换再升级；新增实验性 worktree 隔离（--worktree / /worktree，可为新建或分叉会话创建隔离 checkout 并浏览恢复）、任务进行中内联回答问题、Windows 共享后台 Codex server（含 daemon 生命周期命令与托管更新）；GPT-6 Astra 进入模型选择器并上架 Amazon Bedrock 目录。信任模型同时收紧：启动阶段在建立信任前不再执行工作区控制的 helper，macOS 沙箱阻断终端输入注入；Python SDK 新增 max / ultra 两档 reasoning effort，并注意 HookMetadata 已把 handler 包进 .root（hook.command → hook.root.command）。详见 AI 编程周报 2026-09-13。
2026-09 更新（桌面端接本地权重，09-09 ~ 09-10）：Codex 桌面端打通 Ollama 本地权重，可以跑完全离线的 open-weights 编码循环——代码与提示词不出本机，推理也发生在本地。这是「只认 OpenAI 一家模型」这个长期限制首次被打破，对有数据不出域要求的团队是结构性变化。注意：该能力目前限于桌面端，CLI 仍是 OpenAI 原生路径；待核实：官方未提供完整的支持模型清单与性能对照，实际效果请以本地硬件与模型尺寸为准。详见 AI 编程周报 2026-09-18。
形态和 Claude Code 几乎一样，差异主要在模型选择。喜欢 GPT 的人选它，喜欢 Claude 的留 Claude Code。
它到底是个什么
GitHub: openai/codex，Apache-2.0 开源，Rust 写的二进制，428+ 贡献者。在终端里跑一个能读 / 改 / 执行代码的 Agent，类似 Claude Code 但绑定 OpenAI 模型。
2026 的三个主线：
- 速度 & 实时：gpt-5.3-codex-spark 推理速度 1000+ token/s；WebSocket 远程控制延迟优化。
- Agent 自主性：Subagents GA、Smart Approvals、PostToolUse hooks、worktree 自动化。
- 企业就绪：自定义 CA 证书、userpromptsubmit hooks、托管配置、插件策略强制。
最有用的 4 个能力：
- 沙箱执行：默认在受限沙箱跑命令（macOS Sandbox / Linux Landlock / Windows AppContainer），不会污染主机。
- MCP 工具调用：连 GitHub / 数据库 / Slack / 自建 server，支持并行 tool call。
- Subagents：把大任务拆给多个并行 sub-agent，token 用得多但效率高。
- Image inputs：终端里
codex -i screenshot.png "解释这个错误"直接读图。
价格
| 档位 | 价格 | 说明 |
|---|---|---|
| ChatGPT Plus | $20/月 | 含 Codex CLI 用量（2026-03 起 mini 模型额度 +4×） |
| ChatGPT Pro | $200/月 | 更高额度 + 优先处理 + Spark 研究预览 |
| Business / Edu / Team | $25-30/用户/月起 | 企业管理 + SSO + Codex 含在内 |
| 纯 API | 按 token | gpt-5.5 ≈ $1.25 / $10 per 1M token |
已经付 ChatGPT Plus 的人，等于白嫖一个 Codex CLI 用量，几乎不必另开 API 账号。
真实任务实测（基于官方文档归纳）
来源说明：以下基于 Codex CLI 官方 features 文档与公开评测整合。
任务 1：在 50k 行 Rust 项目里加新 feature
codex -m gpt-5-codex
> 在 src/auth 模块下加 OAuth2 callback handler，参考已有的 token refresh 实现
Agent 会 plan → 读相关文件 → 跑 cargo check → 跑测试 → 提 diff。子代理可以同时跑 lint 和 test 两条线。
任务 2：CI 失败自动 debug
codex --features enable post_tool_use_hook
# 然后跑 cargo test，CI 失败时 Hook 自动触发 Agent 分析失败 + 写 fix
任务 3：跨仓库脚手架生成
codex -m gpt-5-codex
> 用 mono-repo 模式建 3 个 package：core / cli / web，统一走 pnpm workspace
子代理并行起 3 个目录的初始化，单次任务跑完 ~3 分钟，token 用约 80k。
上手 5 分钟
# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Windows（原生 PowerShell）
# 见官方 Windows setup guide，或用 npm i -g @openai/codex
codex # 启动 TUI
codex -m gpt-5-codex . # 在当前目录起 Agent
codex --remote wss://... # 远程模式（SSH / 容器）
codex features list # 看可用 feature flag
codex features enable unified_exec
配置文件：$CODEX_HOME/config.toml（默认 ~/.codex/config.toml）。
同类对比
| 维度 | Codex CLI | Claude Code | Aider | Cline |
|---|---|---|---|---|
| 形态 | 终端 TUI | 终端 TUI | 终端 REPL | VS Code 插件 |
| 默认模型 | gpt-5-codex | Claude Sonnet/Opus | BYOK 任意 | BYOK 任意 |
| 含在订阅 | ChatGPT Plus/Pro | Claude.ai $20/月 | 仅 API） | 仅 API） |
| 沙箱 | macOS Sandbox / Landlock / AppContainer | 类似 | 无 | VS Code 环境 |
| MCP | 部分 | |||
| Subagents | GA | Task tool | ||
| 开源 | Apache-2.0 | 闭源 | Apache-2.0 | Apache-2.0 |
| 原生 Windows | 部分 |
一句话区分：Codex CLI = OpenAI 官方版的 Claude Code；Claude Code = Anthropic 官方版的 Codex；Aider = 任意 OpenAI 兼容 API 都能跑；Cline = VS Code 里的 GUI 终端 Agent。
避坑清单
- 国内访问别频繁切 IP，OpenAI 风控严，账号被封基本无法找回。
- 沙箱默认会限制网络，跑
npm install等需要联网的命令前先看 approval 弹窗。 - Subagents 吃 token 多，预算敏感时关闭
[agents]配置或换 mini 模型。 - WebSocket 远程模式只接受 wss:// 或 localhost ws://，远程公网必须 TLS。
- gpt-5-codex 比 gpt-5.5 便宜但能力对齐，2026-03 之后默认推荐用 codex 系列而非 5.5。
- 不要用过期的
--approval-mode旧参数，新版用codex features子命令管理。
适合 / 不适合
终端 / TMUX / Vim 重度用户；已订阅 ChatGPT Plus / Pro 的人；Windows 原生开发者；headless / SSH / 容器场景。
GUI 党；纯内网开发；偏好 Claude 长上下文风格的人。
相关阅读
- 选型对比：Codex CLI vs Claude Code 怎么选
- 同分类：AI CLI 全分类
- 替代品：Claude Code · Aider · Cline
Long-tail quick picks
长尾检索速查：下面三项对应「Codex CLI 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。
Open-source alternatives
Free tier
- 是否有免费档：否
- 价格概要：ChatGPT Plus/Pro/Business/Edu/Enterprise 包含 / 或按 OpenAI API 计费
- 无免费档，预算敏感可转 Trae（国内版免费）或 GitHub Copilot（$10/月）。
China availability
相关替代品：
来源
- 官方文档：https://developers.openai.com/codex/cli
- Features 页：https://developers.openai.com/codex/cli/features
- GitHub：https://github.com/openai/codex
- 2026 更新综述：https://codex.danielvaughan.com/2026/03/27/codex-cli-in-2026-whats-new
本卡片由 AI 之家 编辑部根据以上公开资料整理，非厂商付费内容；定价与功能以官网为准，欢迎在 反馈邮箱 反馈更新。
| 计划 | 价格 | 限制 | 国内支付 | 备注 |
|---|---|---|---|---|
| ChatGPT Plus | $20/月 | 含 Codex CLI 使用额度，默认 gpt-5-codex-mini（2026-03 起额度 +4×） | 支付宝 | 个人入门 |
| ChatGPT Pro | $200/月 | 更高额度 + 优先处理 + GPT-5.3-Codex-Spark 研究预览 | 支付宝 | Agent 重度用户 |
| Business / Edu / Team | $25-30/用户/月起 | 团队管理 + SSO + Codex 含在内 | — | 团队档 |
| 纯 API 调用 | 按 token | gpt-5.5 ≈ $1.25/$10 per 1M tokens（input/output） | — | BYOK 自由模式 |
- · 终端 / TMUX / Vim 重度用户
- · 已经订阅 ChatGPT Plus / Pro 的人（白嫖 Codex 用量）
- · Windows 原生开发者（Codex CLI 有 PowerShell 沙箱，不必走 WSL）
- · 需要远程 SSH / 容器中跑 Agent 的人（headless 友好）
- · 重度 GUI 党（终端排斥者请用 Cursor）
- · 国内纯内网（OpenAI API 需稳定代理）
- · 需要 Claude 上下文风格的人
不适合纯内网开发和非 GPT 模型用户——OpenAI 账号与网络门槛绕不开，模型也被锁死
- 必须用 OpenAI 账号登录，国内得全程挂代理，且频繁切 IP 会触发风控，账号被封基本无法找回
- 默认沙箱会限制网络，跑 npm install 之类要联网的命令会被拦在 approval 弹窗上，新手常以为是命令写错
- Subagents 并行拆分任务会把 token 消耗成倍放大，Plus 档额度在重度使用下几天就见底
- CLI 侧只认 OpenAI 一家模型，想接 Claude、DeepSeek 都得换工具（2026-09 起**桌面端**已可接 Ollama 本地权重，但 CLI 仍未开放）
Codex CLI 和 Claude Code 有什么区别？
形态几乎一致：都是终端 Agent + 沙箱执行 + MCP + 子代理。差异主要在模型——Codex CLI 走 OpenAI 的 gpt-5-codex 系列，Claude Code 走 Anthropic Sonnet/Opus。OpenAI 在原生 Windows 沙箱（不需要 WSL）和 Rust 实现速度上略胜，Claude 在长任务上下文连续性上略胜。
在 Windows 上怎么用？
原生 PowerShell 沙箱模式（推荐），也支持 WSL2。安装命令：curl -fsSL https://chatgpt.com/codex/install.sh | sh（macOS/Linux），Windows 直接通过 npm 或 PowerShell installer。
国内能用吗？
需要 OpenAI 账号 + 稳定代理。Plus / Pro 订阅可走支付宝。直接 `codex` 即可启动。
Codex CLI 支持本地模型吗？
原生只走 OpenAI API。如果要本地模型，建议用 Aider（OpenAI 兼容 endpoint，可指向 Ollama / vLLM）。
Subagents / Hooks / MCP 是什么？
Subagents：把大任务拆给多个并行子代理；Hooks（PostToolUse / userpromptsubmit）：在工具调用前后插入企业策略；MCP：连外部工具（GitHub / 数据库 / Slack）。Codex 2026 把这三块都做到了 GA。
可接入 / 兼容以下大模型 API（在设置中配置 key 即可切换底座）：
Aider 深度评测：把 AI 编程当 git 工作流的极客派最爱
Aider 深度评测：git-native 心智的真实代价、Architect 双模型经济学、与 Claude Code 的决策边界、何时不该选 Aider。AI 之家 编辑部基于官方文档与社区公开反馈整合，非厂商付费内容。
Claude Code 深度评测：终端 AI Coding Agent 标杆
Anthropic 官方 CLI Agent 一个月真实使用报告：长任务能力、CLAUDE.md 配置、权限模型、成本控制、与 Cursor / Codex / Aider 的实操对比与选型建议。
Codex CLI 深度评测：OpenAI 的终端 AI Agent 好用吗
Codex CLI 真实评测：OpenAI 官方开源（Apache-2.0）的终端 Coding Agent，Rust 实现、原生 Windows 沙箱、Subagents + MCP + Hooks 三件套齐活。本文写它真正解决的问题、gpt-5-codex 的代码生成质量、与 Claude Code 的实操差距、ChatGPT 订阅打包的价格经济学，以及 5 类不推荐场景。AI 之家 编辑部基于官方文档与公开评测整理。
Cursor 深度评测：AI IDE 当前天花板，但代价不便宜
Cursor 深度评测：Composer / Tab / @-symbol 三件套实战表现、2025-06 token 计费改革后的账单模型、与 Claude Code 的决策边界、国内使用避坑。AI 之家 编辑部基于官方文档与社区公开反馈整合，非厂商付费内容。
同任务替代方案
相关横评
Codex CLI vs Crush：OpenAI 官方 vs 多模型 TUI（2026 实测选型）
Codex CLI vs Crush 2026 选型对比：OpenAI 官方终端 Coding Agent（GPT-5.6 + Windows 原生沙箱 + Apache-2.0）vs Charmbracelet 开源 TUI Agent（多模型 mid-session 切换 + LSP + FSL-1.1-MIT）。从模型、平台、生态、价格、国内可用性帮你选对终端 AI 编程工具。
2026-09-23
Codex CLI vs Gemini CLI：两家大厂终端 Agent 怎么选？（2026 选型）
OpenAI Codex CLI 与 Google Gemini CLI 的正面比较：一句话结论 + 决策树 + 价格 + 国内可用性。已有 ChatGPT 账号选 Codex，想零成本起步选 Gemini CLI。
2026-09-23
Claude Code vs Codex CLI：终端 AI Agent 双雄对比
Claude Code vs Codex CLI 2026 选型对比：Anthropic 与 OpenAI 两大官方终端 Agent 的模型、长任务、MCP 生态、Windows 支持、订阅打包价格和国内可用性全方位对比，帮你判断该用哪个终端 AI Agent，以及能不能两个一起用。
2026-07-04