跳到主内容
AIHO 2026 全新改版上线
TOOL · CODING #04/05AI CLI
Codex CLI

Codex CLI

OpenAI 官方终端 Coding Agent,GPT-5.5 / gpt-5-codex 驱动

cliagentterminalopenaigpt-5subagentsmcpopensourcerust
访问官网
能力
5
易用
4
性价比
4
中文
3
稳定
4
编辑结论 综合4.0/ 5

Claude Code 的 OpenAI 版镜像。Plus / Pro 已含、Windows 原生沙箱、Rust 速度快,喜欢 GPT 派的人首选;Claude Sonnet 4.5 在长任务上仍略胜,喜欢 Claude 的留 Claude Code。

01 / 04深度解读

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/codexApache-2.0 开源,Rust 写的二进制,428+ 贡献者。在终端里跑一个能读 / 改 / 执行代码的 Agent,类似 Claude Code 但绑定 OpenAI 模型。

2026 的三个主线:

  1. 速度 & 实时:gpt-5.3-codex-spark 推理速度 1000+ token/s;WebSocket 远程控制延迟优化。
  2. Agent 自主性:Subagents GA、Smart Approvals、PostToolUse hooks、worktree 自动化。
  3. 企业就绪:自定义 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按 tokengpt-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 CLIClaude CodeAiderCline
形态终端 TUI终端 TUI终端 REPLVS Code 插件
默认模型gpt-5-codexClaude Sonnet/OpusBYOK 任意BYOK 任意
含在订阅ChatGPT Plus/ProClaude.ai $20/月❌(仅 API)❌(仅 API)
沙箱macOS Sandbox / Landlock / AppContainer类似VS Code 环境
MCP部分
Subagents✅ GA✅ Task tool
开源Apache-2.0闭源Apache-2.0Apache-2.0
原生 Windows部分

一句话区分:Codex CLI = OpenAI 官方版的 Claude Code;Claude Code = Anthropic 官方版的 Codex;Aider = 任意 OpenAI 兼容 API 都能跑;Cline = VS Code 里的 GUI 终端 Agent。

避坑清单

  1. 国内访问别频繁切 IP,OpenAI 风控严,账号被封基本无法找回。
  2. 沙箱默认会限制网络,跑 npm install 等需要联网的命令前先看 approval 弹窗。
  3. Subagents 吃 token 多,预算敏感时关闭 [agents] 配置或换 mini 模型。
  4. WebSocket 远程模式只接受 wss:// 或 localhost ws://,远程公网必须 TLS。
  5. gpt-5-codex 比 gpt-5.5 便宜但能力对齐,2026-03 之后默认推荐用 codex 系列而非 5.5。
  6. 不要用过期的 --approval-mode 旧参数,新版用 codex features 子命令管理。

适合 / 不适合

✅ 终端 / TMUX / Vim 重度用户;已订阅 ChatGPT Plus / Pro 的人;Windows 原生开发者;headless / SSH / 容器场景。
❌ GUI 党;纯内网开发;偏好 Claude 长上下文风格的人。

相关阅读

来源

本卡片由 AIHO 编辑部根据以上公开资料整理,非厂商付费内容;定价与功能以官网为准,欢迎在 /submit 反馈更新。

02 / 04价格速查
计划价格限制国内支付备注
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 调用按 tokengpt-5.5 ≈ $1.25/$10 per 1M tokens(input/output)BYOK 自由模式
03 / 04适合 / 不适合
✅ 适合谁
  • · 终端 / TMUX / Vim 重度用户
  • · 已经订阅 ChatGPT Plus / Pro 的人(白嫖 Codex 用量)
  • · Windows 原生开发者(Codex CLI 有 PowerShell 沙箱,不必走 WSL)
  • · 需要远程 SSH / 容器中跑 Agent 的人(headless 友好)
⚠️ 不适合谁
  • · 重度 GUI 党(终端排斥者请用 Cursor)
  • · 国内纯内网(OpenAI API 需稳定代理)
  • · 需要 Claude 上下文风格的人
04 / 04 常见问题
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。