
Codex CLI
OpenAI 官方终端 Coding Agent,GPT-5.5 / gpt-5-codex 驱动
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,2026 默认模型 gpt-5-codex / gpt-5-codex-mini,ChatGPT Plus/Pro/Team/Edu 已含使用额度。
形态和 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 长上下文风格的人。
相关阅读
- 配套 playbook:Codex CLI vs Claude Code 怎么选
- 同分类:AI CLI 全分类
- 替代品:Claude Code · Aider · Cline
来源
- 官方文档: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
本卡片由 AIHO 编辑部根据以上公开资料整理,非厂商付费内容;定价与功能以官网为准,欢迎在 /submit 反馈更新。
| 计划 | 价格 | 限制 | 国内支付 | 备注 |
|---|---|---|---|---|
| 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 上下文风格的人
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。