Codex CLI
OpenAI 的终端编程 Agent
Codex CLI 是 OpenAI 用 Rust 写的开源终端编程 Agent：截至 2026-10-20，官方文档给出 macOS / Linux 官方安装脚本、Windows install.ps1、npm 与 Homebrew 等装法，官方推荐 gpt-6.1-sol，gpt-5.6-sol 等现行型号仍可用（2026-10-20 模型文档核），本地执行并支持 MCP。
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
更新于 2026-10-30
什么是 Codex CLI
Codex CLI 是 OpenAI 开源的终端编程 agent，装在你自己的电脑上，读代码、改文件、执行命令。它用 Rust 编写，官方文档给出独立安装脚本、npm 与 Homebrew 等装法，登录后就在项目目录里工作（官方仓库核于 2026-10-20）。
会话里靠斜杠命令控制：/model 选模型与推理档，/permissions 定它能做什么，/init 为项目生成 AGENTS.md，/review 复查改动（命令名取自官方 CLI 文档 2026-10-20 存档快照）。
到 2026 年它已经不只是终端工具：官方仓库同时给出 IDE 插件、桌面 app 与云端 Codex 的入口，整个仓库按 Apache-2.0 许可开源（核于 2026-10-20）。
先核对时效
本页的型号名、安装方式与功能清单核于 2026-10-20，依据是官方仓库与 CLI 文档的存档快照。官方仓库与文档更新很快，动手前请回官方页再看一眼。
安装指南
步骤 1：安装
官方文档给的装法：macOS / Linux 跑独立安装脚本，Windows 在新开的 PowerShell 窗口里跑独立安装脚本，也可以用 npm 或 Homebrew；npm 上的 @openai/codex 目前是 0.163.0（2026-10-15 发布）。
npm install -g @openai/codex
步骤 2：认证
登录方式：在终端跑 codex login，按提示用 ChatGPT 账户完成浏览器登录；也可以用 API Key 登录，codex login status 可查看当前认证方式。
export OPENAI_API_KEY=sk-...
步骤 3：启动
在项目目录里运行 codex，然后用一句话描述任务；脚本与流水线里用 codex exec 跑非交互命令。
codex "explain this project"
步骤 4：选择模型
会话里用 /model 选模型与推理档，启动时加 --model 或 -m 指定型号（如 gpt-6.1-sol、gpt-6-sol）；官方文档的默认模型示例是 gpt-6.1-sol，写在 ~/.codex/config.toml 的 model 项。
核心功能
会话与图片
能重开本仓库最近的会话，也能跨本地会话找回旧工作；提问时可直接贴截图或架构图。
MCP 工具接入
可添加本地或远程 MCP 服务器，先查看当前会话能用哪些工具，再让 Codex 调用。
实时网页检索
任务牵涉最新发布、文档或外部行为时可切到实时检索，检索过程会留在会话记录里。
项目约定文件
用 /init 在项目里生成 AGENTS.md，把构建命令与代码规范写进去，后续会话都会带上。
沙箱与审批
可设定何时允许直接改文件或跑命令，也能先查看当前沙箱与可写目录再决定放行。
非交互运行
非交互命令可放进可重复的工作流，适合接在脚本或流水线里做固定动作。
Codex CLI 对比 Claude Code
两个终端编程 agent 的差别逐行对照（核于 2026-10-20）。
| 对比维度 | Codex CLI | Claude Code |
|---|---|---|
| 架构 | Rust 编写，本地运行 | 终端、IDE、桌面、浏览器 |
| 模型 | 模型与推理档由 /model 选 | 别名或完整模型名 |
| 上下文 | 随所选模型与推理档变化 | 可扩展上下文，自动压缩 |
| 价格 | 可含在 ChatGPT 计划内 | 需订阅或按 token 计费 |
| 执行方式 | 本地终端加沙箱审批 | 读码、改文件、跑命令 |
| Agent 能力 | 可委派给专职代理 | 子代理与代理团队 |
| 语音模式 | 语音未核到 | CLI 内置 /voice 听写 |
| 开源情况 | 开源，Apache-2.0 | 按 Anthropic 服务条款授权 |
Codex CLI 是开源与本地执行，Claude Code 是多端客户端与并行 agent，真正的差别在协作方式。
通过 QCode.cc 使用 AI 编程工具
在售的 gpt-5.6-sol 与 claude-opus-5 共用一把 key。
两个型号取自 2026-10-20 核对过的模型页清单。
在售型号共用一把 key
在售（released）型号共用一把 key，换型号只改配置里的名字；预告与传闻型号需另行核对。
换型号改的是配置不是代码
在同一账户里从 gpt-5.6-sol 换到 claude-opus-5，参数以模型页当日显示为准。
按 token 计价，单价看当日定价页
计费方式与单价以站内定价页当日口径为准。
型号清单统一
在售型号都列在同一张模型页，gpt-5.6-sol、claude-opus-5 也在其中，下单前先在那页确认它还在。
使用建议
先只读跑通一轮，再放开改文件；构建命令与规约写进 AGENTS.md；收尾用 /review 看改动再提交。
适合做什么
存量仓库改造
批量重命名、依赖升级、补测试这类活，先让它读结构、给计划，再分步落地；每一步都能审批。
流水线里的固定动作
非交互模式适合接在脚本与流水线里：生成变更摘要、跑例行检查、按同样的步骤复现。
查外部行为
问题牵涉最新版本号或第三方接口时，切到实时检索比让它凭旧记忆作答更可靠。
Codex 生态扩展
从 CLI 到桌面 app，再到并入 ChatGPT 桌面 app，Codex 在 2026 年持续扩展。
Codex Desktop App
Codex 桌面 app 于 2026-02-02 推出 macOS 版、2026-03-04 推出 Windows 版，在一个界面里跨项目并行运行 agent 线程并审查结果。
- macOS + Windows 双平台
- 并行管理多个 Agent 实例
- 可视化任务队列与执行状态
并入 ChatGPT 桌面 app
2026 年 7 月 9 日起，Codex 成为 macOS 与 Windows 上 ChatGPT 桌面 app 的一部分，原 Codex app 用户更新后保留项目、设置与工作流。
- Chat、Work 与 Codex 在同一个 app
- 可把 Codex 设为默认视图
- macOS 上可保留 Codex 图标
最新模型线
GPT-6.1 Sol
OpenAI 官方推荐用于复杂编码与 agentic 工作，称性能接近 Astra、成本更低；GPT-5.3-Codex-Spark 已于 2026-09-14 下线（截至 2026-10-20）
GPT-6 Sol
OpenAI 官方指定用 gpt-6-sol 取代已于 2026-08-31 从用 ChatGPT 登录的 Codex 退出的 gpt-5.4（截至 2026-10-20）
GPT-5.5
OpenAI 官方给出的 GPT-5.5 退出 ChatGPT、ChatGPT Work 与 Codex（所有计划）的日期是 2026-10-14；截至 2026-10-20 已生效，OpenAI API 与用 API Key 认证的 Codex 会话不受影响。
Codex CLI 实操补充：安装、登录、接入 QCode 与报错排查
四种安装方式（截至 2026-10-20 的官方文档）
截至 2026-10-20，OpenAI 官方 Codex CLI 文档列出四种安装方式：macOS 与 Linux 用独立安装脚本，Windows 在新开的 PowerShell 窗口里运行独立安装脚本，另外也可以用 npm 或 Homebrew。升级时重新运行同一条安装命令即可，Homebrew 用 brew upgrade --cask codex。
装好后进入项目目录运行 codex，首次启动时选择 Sign in with ChatGPT 或其他登录方式，然后用一句话描述任务即可开始。官方建议在任务前后各建一个 Git 检查点，方便回退改动。
- macOS / Linux：curl -fsSL https://chatgpt.com/codex/install.sh | sh
- Windows（PowerShell）：powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
- npm：npm install -g @openai/codex
- Homebrew：brew install --cask codex
- WSL：官方文档写明 WSL1 只支持到 Codex 0.114，从 0.115 起 Linux 沙箱改用 bubblewrap，需要改用 WSL2。
两种登录方式与官方限额
官方认证文档写明，Codex CLI 支持两种登录：用 ChatGPT 账号登录走订阅额度，用 API Key 登录按用量计费。API Key 可以通过管道传给 codex login --with-api-key，codex login status 可查看当前认证方式；登录信息缓存在 ~/.codex/auth.json 或系统凭据库里，CLI 与 IDE 插件共用同一份登录缓存。
用 ChatGPT 账号登录时受套餐限额约束：OpenAI 价格页（截至 2026-10-20）写明 Plus 与标准 Business 套餐按每 5 小时的本地消息数估算用量，Pro 套餐目前没有 5 小时限制，另外可能还有每周限额；会话中输入 /status 可以看到剩余额度。用 OpenAI 的 API Key 登录时，Codex 按 OpenAI 官方价（标准 API 价格）结算，不占用 ChatGPT 套餐额度。
用 QCode 的 API Key 接入 Codex CLI
QCode 文档的 Codex 教程走 OpenAI Responses 协议：在用户级配置文件 ~/.codex/config.toml 里新增一个自定义 model provider（名字可自定），把 model_provider 指向它，再按下面几项填写。注册 QCode 后，在控制台创建以 cr_ 开头的 API Key 即可开始。
这条接入只服务 GPT 型号：QCode 文档的接入速览写明，Codex 使用的 Responses 端点不服务 Claude 与国产模型。要用 claude-sonnet-5-5、claude-opus-5-5 等 Claude 模型，请用同一把 Key 配置 Claude Code。按 token 计费，各模型单价见 /models。
- base_url 填 https://api.qcode.cc/openai（QCode 文档写明必须是这个地址）；亚洲备用接入点为 https://asia.qcode.cc/openai。
- wire_api 填 responses，requires_openai_auth 设为 true；OpenAI 官方文档写明当前版本的 Codex 不支持 wire_api = chat，也不支持只有 Chat Completions 的端点。
- 二选一：用环境变量就去掉 requires_openai_auth，写 env_key = "QCODE_API_KEY"（名字可自定）并 export 这个变量；用文件就保留 requires_openai_auth = true，把 Key 写进 ~/.codex/auth.json（文件权限建议 600）。文档写明 requires_openai_auth = true 时 Codex 会忽略 env_key。
- model 填 QCode 文档列出的 GPT 型号，例如 gpt-6-sol、gpt-6.1-sol、gpt-6-astra、gpt-5.6-terra 或 gpt-5.6-sol；model_reasoning_effort 可选 low、medium、high。
- 不想手动改文件，可以用 QCode 文档提供的一键配置脚本：curl -fsSL https://qcode.cc/install/codex.sh | bash（Windows 为 irm https://qcode.cc/install/codex.ps1 | iex），它会安装 CLI、写入 ~/.codex 配置并做连通验证。
常见报错与排查
排查前先运行 codex doctor：官方文档说明它会生成本地诊断报告，检查安装、配置、认证、运行时、Git、终端等状态。会话里用 /status 确认当前模型、审批策略与剩余上下文，用 /debug-config 查看各配置层的生效情况。
- 401 或提示 API Key 无效：确认 Key 以 cr_ 开头、没有多余空格或换行；用环境变量时，变量名必须与 config.toml 里的 env_key 完全一致；再到 QCode 控制台确认 Key 状态。
- 连接超时或网络错误：确认 base_url 是 https://api.qcode.cc/openai，用 curl -I https://api.qcode.cc 测试连通，主地址不通时试 https://asia.qcode.cc/openai。
- 配置改了不生效：OpenAI 官方文档写明，项目目录里的 .codex/config.toml 会忽略 model_provider、model_providers 等键，provider 必须写在用户级 ~/.codex/config.toml。
- profile 报错：官方文档写明从 Codex 0.134.0 起，--profile 不再读取 config.toml 里的 [profiles.名称] 表，顶层的 profile 选择器也已不再支持，要改成独立文件 ~/.codex/名称.config.toml。
- 提示模型不可用：官方文档写明 GPT-5.3-Codex-Spark 已于 2026-09-14 下线，gpt-5.4 于 2026-08-31 退出用 ChatGPT 登录的 Codex；GPT-5.5 的退役见上方型号卡，脚本与配置里的旧型号需要替换。
- npm 全局安装报 EACCES：QCode 文档建议把 npm 全局目录改到用户目录，也可以改用上面的官方独立安装脚本。
Codex CLI 补充问答
Codex CLI 怎么安装？
截至 2026-10-20，官方文档给出四种方式：macOS / Linux 运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh；Windows 在 PowerShell 中运行官方 install.ps1 安装脚本；也可以用 npm install -g @openai/codex 或 brew install --cask codex。装好后在项目目录运行 codex 并登录即可。
Codex CLI 能让多个 agent 协作吗？
能。官方 CLI 文档写明 subagents 可以把聚焦的工作交给专门的 agent，再把结果带回主终端会话；官方 config.toml 的 [features] 表里有 multi_agent 开关，默认 true、成熟度一栏写着 Stable，用来启用 subagent 协作工具。另外，Windows 用户请注意：官方提供 Windows 独立安装脚本，需在新开的 PowerShell 窗口里运行；也可以在 WSL2 中使用。官方文档写明从 Codex 0.115 起 Linux 沙箱改用 bubblewrap，WSL1 不再支持。
Codex CLI 能用 Claude 模型吗？
通过 QCode 接入时不能。Codex 使用 OpenAI Responses 协议，QCode 文档写明这条端点只服务 GPT 型号；Claude 模型请用 Claude Code，同一把 QCode API Key 即可。
Codex 的 5 小时限额是怎么回事？
这是用 ChatGPT 账号登录时的套餐限额。OpenAI 价格页（截至 2026-10-20）写明 Plus 与标准 Business 按每 5 小时的本地消息数估算，Pro 套餐目前没有 5 小时限制，另外可能有每周限额，会话里用 /status 查看剩余额度。用 API Key 登录则按 OpenAI 官方价（标准 API 价格）结算，不占用 ChatGPT 套餐额度；通过 QCode 的 Key 接入时按 token 计费，各模型单价见 /models。
怎么在 Codex CLI 里切换到 gpt-6.1-sol？
有三种方式：会话里输入 /model 选择模型与推理档；启动时加参数，例如 codex -m gpt-6.1-sol；或在 ~/.codex/config.toml 里写 model = "gpt-6.1-sol" 作为默认值。通过 QCode 接入时，能用的 GPT 型号以 QCode 文档与 /models 为准。
不同项目想用不同的模型和推理强度，怎么配置？
用 profile。OpenAI 官方文档写明 codex --profile 名称 会在 ~/.codex/config.toml 之上叠加 ~/.codex/名称.config.toml；QCode 文档的示例把 provider 写在主配置里，再分别建 work.config.toml 与 personal.config.toml 设置不同的 model 与 model_reasoning_effort，启动时用 codex --profile work 切换。
在国内怎么付款开通 QCode？
注册后先充值、再选套餐，然后在控制台创建 API Key。人民币可用支付宝或微信支付，美元可用 Visa / Mastercard 信用卡、Apple Pay、Google Pay，也支持加密货币（多币种多网络），无需境外信用卡，全程自助。按 token 计费，各模型单价见 /models。
2026 Q1-Q2 重要更新
OpenAI 官方 Codex 更新日志记载：2026-02-05 发布 GPT-5.3-Codex，官方称它是当时面向复杂、真实软件工程的最强 agentic 编码模型，Codex 用户使用时速度快 25%，并能在执行中实时响应 steering；2026-02-12 又发布了研究预览版 GPT-5.3-Codex-Spark。此后，GPT-5.3-Codex 自 2026-05-26 起不再是用 ChatGPT 登录的 Codex 里可选的型号（API Key 工作流不受影响），GPT-5.3-Codex-Spark 已于 2026-09-14 下线。中国用户用 QCode 的一把 API Key 接入 Codex 与 gpt-6.1-sol 等 GPT 型号，按 token 计费，各模型单价见 /models（截至 2026-10-13；OpenAI 官方文档写明，GPT-5.5 退出 ChatGPT、ChatGPT Work 与 Codex 的日期是 2026-10-14，OpenAI API 不受影响）。
查看 GPT-5.3-Codex 完全指南