Codex 国内怎么用?要什么套餐、CLI 怎么装、怎么接 API(2026)
Codex 用哪个套餐、在哪能用:按 OpenAI 官方定价页逐档讲 Free / Go / Plus / Pro / Business,API key 登录按 API 价计费、少了哪些功能;Codex CLI 的安装命令、登录方式和 config.toml 的位置;官方路线的地区名单与付款;以及 cocodot 的 OpenAI 兼容端点提供的是 Chat Completions,Codex 要经 CC Switch 本地路由才能接上。
1. Codex 是什么:一个智能体、几个入口、两种登录
Codex 是 OpenAI 的编程智能体,能读你的代码库、改文件、跑命令。按官方文档,它有好几个入口:ChatGPT 桌面 App(macOS、Windows、Linux 都有,在 ChatGPT 下拉菜单里选 Codex)、网页、终端里的 Codex CLI、编辑器里的 IDE 扩展,以及 iOS;Codex cloud 则是在云端环境里跑任务,网页、手机和桌面 App 上都能发起和继续。官方定价页开头还写明 ChatGPT Work(「ChatGPT 工作」)和 Codex 共用用量:同一份订阅额度,两边一起消耗。怎么付钱由登录方式决定,能用哪些入口和功能还要再看套餐。官方认证页写明,使用 OpenAI 模型时,个人登录 Codex 有两种方式:用 ChatGPT 账号登录,走订阅;用 API key 登录,按用量计费。桌面 App、CLI 和 IDE 扩展两种都支持,Codex cloud 只能用 ChatGPT 登录。登录方式还决定了适用哪套数据政策:ChatGPT 登录跟着 ChatGPT 工作区的权限和保留设置走,API key 跟着你 API 组织的保留和数据共享设置走。所以「Codex 国内怎么用」要先拆成两个问题:你打算用订阅额度,还是按 token 付 API 费;你手上的账号和卡,能不能走通对应的那一条。下面第 2、3 节分别讲两种登录,第 4、5 节是安装和配置,第 6 节讲官方路线的地区和付款,第 7、8 节讲为什么 cocodot 的 API 不能直接填进 Codex、要怎么接。
2. Codex 要什么套餐:Free、Go、Plus、Pro、Business 逐档看
以下按 learn.chatgpt.com/docs/pricing 在 2026-11-03 的写法,价格和额度会调整,以官方页当前值为准。Free($0)和 Go($8 / 月)列的是同一句:在桌面 App 里以标准速度用 GPT-6 Luna,视逐步开放情况;这两档没有列 CLI、IDE 扩展和网页,Free 也不能生成图片。Plus($20 / 月)是个人套餐里在网页、CLI、IDE 扩展和 iOS 上用 Codex 的起点,包含自动代码审查、Slack 集成这类云端功能,模型列了 GPT-6.1 Sol 和 GPT-6 Luna。Pro 从 $100 / 月起,有 $100、$200、$500 三档,包含 Plus 的全部,三档里 Ultrafast 模式只在 $500 档。Business 按年付、2 人起是每人每月 $20,按月付是每人每月 $25,另有 Enterprise 和 Edu 需要联系销售。额度怎么看:官方只给 Plus 和标准 Business 的估算区间,单位是「每 5 小时的本地消息数」,例如 GPT-6.1 Sol 约 15–160 条、GPT-6 Luna 约 350–3,000 条,并写明这是估算、不是固定上限,云端任务可能比本地消息更耗额度,另外还可能有每周限额;Pro 目前没有 5 小时限额。撞到上限时,Plus 和 Pro 可以加购 ChatGPT credits 继续用,不必升级套餐;所有用户也可以改用 API key 跑额外的本地对话,按 API 标准价计费。官方给的省额度办法包括:提示写准、只给相关文件、精简 AGENTS.md、不用的 MCP 服务器先关掉。还有一处容易踩:官方写明 GPT-5.5 从 2026 年 10 月 14 日(美国太平洋时间中午)起退出用 ChatGPT 登录的 Codex,API key 登录的会话不受影响;旧配置里还写着 gpt-5.5 的,用 ChatGPT 登录时要换成官方 Models 页当前列出的型号。按这个顺序选:只想在桌面 App 里试试,先用 Free(视开放情况);要在终端或编辑器里干活,个人套餐的起点是 Plus;Plus 经常不够,先在用量面板看清用到哪,再在「加购 credits」和「升 Pro」之间算账,ChatGPT Pro 的订阅与付款见 /hub/chatgpt-pro。
3. 用 API key 登录 Codex:按 API 价计费,少了哪些功能
不订阅也能用 Codex:用 OpenAI Platform 的 API key 登录。官方认证页写明,API key 的用量通过你的 OpenAI Platform 账户、按 API 标准价计费,不再用 ChatGPT 套餐内额度。定价页把这条路单独列成一档:能在 CLI、SDK 和 IDE 扩展里用 Codex;没有云端功能(云端代码审查、Slack 集成等);可用模型跟着你这把 key 能调的 API 模型走。功能对照表里,API key 一栏的 Codex cloud 和网页版 ChatGPT Work 标为不可用,CLI、IDE 扩展、桌面 App 的本地对话和 codex exec 脚本标为可用。桌面 App 里在未登录界面选「Sign in another way」填 key,IDE 扩展里选「Use API Key」,CLI 的写法见下一节。按 developers.openai.com/api/docs/pricing(2026-11-03 查阅,以官方为准),每百万 token 的标准价:gpt-6.1-sol 在短上下文(输入 ≤272K)时输入 $2、缓存输入 $0.10、输出 $10,输入超过 272K 按更高的长上下文价;gpt-6-luna 短上下文输入 $0.10、缓存输入 $0.01、输出 $0.50;定价页 Codex 分类下的 gpt-5.3-codex 输入 $1.75、缓存输入 $0.175、输出 $14。Codex 定价页特别提醒,API 的 token 价和订阅用量是两回事,别拿 API 价去估算订阅里能跑多少任务。什么时候考虑 API key:CI/CD 这类脚本化流程(官方文档建议这类流程用 API key 登录)、用量低到不值得订阅、或者只想在 CLI 里按量付费。官方同时提醒,不要在不受信任或公开的环境里暴露 Codex 的执行。OpenAI API 的充值与付款排查见 /hub/openai-api。
4. 安装 Codex CLI 与登录:命令和自查
官方 Codex CLI 页的地址是 developers.openai.com/codex/cli,现在会跳转到 learn.chatgpt.com/docs/codex/cli。官方 CLI 页列了四种安装方式,任选其一:macOS / Linux 用官方独立安装脚本;Windows 在新开的 PowerShell 窗口里跑官方安装脚本;也可以用 npm 或 Homebrew 装。独立安装脚本和 npm 的更新命令与安装命令相同,Homebrew 更新用 upgrade。装好后在项目目录里运行 codex,第一次会让你选「Sign in with ChatGPT」或其它可用的登录方式。用 API key 登录,官方给的写法是通过标准输入把环境变量里的 key 交给 codex login --with-api-key。在远程服务器、没有浏览器的环境里用 ChatGPT 登录,官方推荐设备码登录 codex login --device-auth(标为 beta),个人账号要先在 ChatGPT 的安全设置里开启设备码登录,再打开链接、输入一次性代码。自查:codex login status 显示当前用的是哪种登录;在 CLI 会话里输入 /status 能看剩余额度;订阅用量面板在 chatgpt.com/codex/settings/usage。登录信息缓存在本机:明文文件 ~/.codex/auth.json,或者系统的凭据库;CLI 和 IDE 扩展共用这份缓存,任意一边退出登录,两边下次启动都要重新登录。用文件存储时,官方写明要像对待密码一样对待 ~/.codex/auth.json:它含有访问令牌,不要提交进仓库、贴进工单或发到聊天里。官方还建议在每个任务前后各打一个 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 / Homebrew 安装
npm install -g @openai/codex
brew install --cask codex # Homebrew 更新:brew upgrade --cask codex
# 在项目目录里启动,首次运行选择登录方式
codex
# 用 API key 登录(先把 key 放进环境变量 OPENAI_API_KEY;printenv 是 macOS / Linux 的写法)
printenv OPENAI_API_KEY | codex login --with-api-key
# 没有浏览器的环境用 ChatGPT 登录:设备码(beta)
codex login --device-auth
# 查看当前登录方式 / 退出登录
codex login status
codex logout5. 配置文件在哪:config.toml 的层级和会被忽略的键
按官方 Config basics 页,Codex 的个人配置在 ~/.codex/config.toml,项目里可以再放 .codex/config.toml 做覆盖;只有你把项目标为受信任时,Codex 才加载项目里的 .codex/ 配置。CLI 和 IDE 扩展共用同一套配置层,IDE 扩展里点右上角齿轮,选 Codex Settings → Open config.toml 就能打开。生效顺序从高到低:命令行参数和 --config 覆盖 → 项目里的 .codex/config.toml(离当前目录最近的优先)→ 用 --profile 选的 profile 文件 → ~/.codex/config.toml → 登录工作区下发的云端默认配置 → 系统配置(Unix 上是 /etc/codex/config.toml)→ 内置默认值。~/.codex 这个目录可以用环境变量 CODEX_HOME 改,设了的话目录必须事先存在。要特别注意的一条:官方 Advanced config 页写明,项目级 .codex/config.toml 里的 openai_base_url、model_provider、model_providers、profile 等键会被忽略,并在启动时打印警告;官方让你把供应商这类键写在用户级的 ~/.codex/config.toml。所以「我在项目里改了供应商却没生效」,先看启动时有没有这条警告。常改的几项:model(默认模型)、approval_policy(什么时候停下来征求你同意)、sandbox_mode(执行命令时的文件和网络权限)、model_reasoning_effort(推理强度)。改完重启 Codex 会话再测,一次只改一项,才分得清是哪一项起了作用。
# ~/.codex/config.toml(用户级;项目级 .codex/config.toml 里写 provider 类的键会被忽略)
model = "gpt-6.1-sol" # 默认模型(官方路线的示例值);接 cocodot 时按 /ccswitch 的 Codex 配置清单填
approval_policy = "on-request" # 需要时停下来征求同意
sandbox_mode = "workspace-write" # 允许写当前工作区
model_reasoning_effort = "medium" # 推理强度6. 官方路线的地区与付款:先查名单,再小额验证
走官方路线(ChatGPT 订阅或 OpenAI API key)之前,先自己核对 OpenAI 的支持国家和地区名单:developers.openai.com/api/docs/supported-countries。这一页开头写明,在名单以外的国家和地区访问或提供访问,可能导致账号被封禁或暂停;2026-11-03 查阅时,名单里没有中国大陆。名单会变,以官方页当前内容为准;账号所在地是否符合规定,注册和付费之前先看清楚。付款要先分清是哪一条账单:ChatGPT 订阅(Plus、Pro 等)是 ChatGPT 的订阅账单;API key 的用量按官方认证页的说法,记在你的 OpenAI Platform 账户上、按 API 标准价计费。能用哪些付款方式、在哪里绑卡,以 OpenAI 官方帮助页和付款页的当前说明为准。有用户用 cocodot 的美国卡段虚拟卡订阅 ChatGPT、给 OpenAI API 充值付成功过,但这不代表每一档、每一笔都验证过;第一次先付一个月或充一笔小额,确认扣款和开通都正常,再考虑长期用。付款被拒时,请向发卡行和商户确认拒绝原因;银行 App 里没有记录,不能证明请求在哪一方被拦;同一张卡在别处被拒,也不能单独确定原因。账单地址:这张卡没有绑定个人地址,cocodot 不提供也不分配任何地址。付款页的账单地址请填你本人真实使用的地址,各项填完整,同一个商户一直用同一个;不要用网上找来的、他人的或编造的地址,能否订阅以各服务商对国家和地区的规定为准。卡费:开卡 $9.9(一次性);充值 3%;活跃月费 $1;消费不另收消费手续费，但单笔低于 $20 收 $0.60 结算费;发卡方对某笔收费时(外币交易手续费、3DS 验证费、授权费等)另收相应费用，金额以账单为准。订阅付款的细节见 /hub/chatgpt-plus,API 充值见 /hub/openai-api,开卡见 /card。
7. 为什么不能把 base_url 直接改成 cocodot:Responses 和 Chat Completions
给 Codex 换接口地址,官方文档里有两种写法,都在 config.toml 里改 —— Advanced config 页写明,只想把内置 OpenAI 供应商指向别的地址时设 openai_base_url;需要自定义供应商时,在 [model_providers.<id>] 里写 base_url、env_key 等,再把 model_provider 指过去。关键在协议:官方配置参考页对 model_providers.<id>.wire_api 的说明是,它只支持 responses 这一个值,不写时默认也是它。也就是说,接自定义供应商时,Codex 发出去的是 OpenAI Responses 协议的请求,对端得提供 Responses 接口。如果你手上的配置写着 wire_api = "chat",按当前的官方配置参考页,它已经不是受支持的值。cocodot 的 OpenAI 兼容端点(https://cocodot.co/api/ai/v1)目前提供的是 Chat Completions,没有 /v1/responses。所以把 openai_base_url 或自定义供应商的 base_url 直接改成 cocodot 的地址,Codex 发出的 Responses 请求在 cocodot 这边没有对应的接口;接 cocodot 时别走这条路。能接上的办法是在本机加一层协议转换:开启 CC Switch 的 Codex 路由后,由本机把 Codex 发出的请求转成 Chat Completions 再发给 cocodot,这正是 /ccswitch 那套配置。换任何服务商之前都可以这样自查:① 看这家服务商自己的文档,确认它有没有提供 Responses 接口;② 没有的话,Codex 需要本地协议转换才能用;③ 改过 config.toml 却没生效,看启动时的警告,项目级文件里的供应商类键会被忽略。
8. 用 CC Switch 把 Codex 接到 cocodot:步骤、型号与计费
CC Switch 管理本机 AI 编程工具与 Provider(供应商)配置;它本身不提供模型、Key 和余额,这些由 cocodot 提供,两者是独立产品。按 /ccswitch 的步骤:① 在 cocodot API 后台创建 Key,并复制 Codex 配置清单;② 在 CC Switch 里按清单添加 Codex 供应商,Base URL 填 https://cocodot.co/api/ai/v1(带 /v1);③ 上游格式选 Chat Completions;④ 打开 Routing 总开关和 Codex 路由,再重启 Codex 会话。真实 Key 只在你设备上的 CC Switch 里粘贴,不要放进 Deep Link 或任何 URL:URL 可能进入浏览器历史、日志、剪贴板历史和分析系统。同一个 CC Switch 里还可以给 Claude Code 配 cocodot,那边走 Anthropic 兼容端点 https://cocodot.co/api/ai(不带 /v1),不需要路由,见 /hub/claude-code-china-direct。能用哪些型号:这条路只能用 cocodot 在售的型号,GPT 线有 GPT-5.6 Sol(mog-8-s)、GPT-5.6 Terra(mog-8-t)、GPT-5.6 Luna(mog-8-l)、GPT-5.5(mog-6)、GPT-5.4(mog-3)、GPT-5.3-codex(mog-5),没有 GPT-6 系列(Astra / Sol / 6.1 Sol / Luna),要用 GPT-6.1 Sol 请走第 2、3 节的官方路线。Codex 里填哪个模型名,按后台的 Codex 配置清单;当前在售列表可以用公开接口 https://cocodot.co/api/ai/v1/models 查,不用 key。开通与计费:新用户调用 API 须先完成实名认证;充值方式为支付宝 / 微信支付(人民币)、USDT / USDC;注册赠送的免费体验额度只能调部分低价型号;费用按 token 实际用量从余额扣,Claude / GPT / Gemini 各线挂牌价不超官网，逐型号以价格页实时标价为准。先跑一条测试请求,确认通了再用于大任务。连不上时按顺序查:Base URL 有没有带 /v1、上游格式是不是 Chat Completions、两个路由开关是否都开了、Key 有没有多余空格、余额够不够;一次只改一项,改完重启会话再测。CC Switch 的更多排查见 /hub/cc-switch-claude-code-codex-provider-guide,Key 的保管见 /hub/ai-api-key-security-guide。
Codex 各种用法对比(2026-11-03 按 learn.chatgpt.com/docs/pricing 与 cocodot.co/ccswitch 核对;价格和额度以官方页面当前值为准)
| 用法 | 官方写的可用范围 | 怎么计费 | 要注意的 |
|---|---|---|---|
| ChatGPT Free($0 / 月) | 桌面 App 里以标准速度用 GPT-6 Luna,视逐步开放 | 订阅内用量 | 这一档没有列 CLI、IDE 扩展和网页;不能生成图片 |
| ChatGPT Go($8 / 月) | 与 Free 同一句:桌面 App 里的 GPT-6 Luna,视逐步开放 | 订阅内用量 | 官方定位是轻量编程任务 |
| ChatGPT Plus($20 / 月) | 网页、CLI、IDE 扩展、iOS;自动代码审查、Slack 等云端集成;GPT-6.1 Sol、GPT-6 Luna | 订阅内用量,撞到上限可加购 ChatGPT credits | 5 小时用量只给估算区间,另外可能有每周限额 |
| ChatGPT Pro($100 / $200 / $500 三档) | Plus 的全部;三档里 Ultrafast 模式只在 $500 档 | 订阅内用量,可加购 credits | 官方写 Pro 目前没有 5 小时限额;当前限额和重置时间看用量面板 |
| ChatGPT Business(按年 $20 / 人 / 月,2 人起;按月 $25) | 桌面和移动端的 ChatGPT 与 Codex、更大的云端虚拟机、SAML SSO 与 MFA | 按席位,可加购 credits | 团队工作区;Enterprise / Edu 需联系销售 |
| API key 登录 | CLI、SDK、IDE 扩展、桌面 App 的本地对话;可用模型跟着你的 key 走 | OpenAI Platform 账单,按 API 标准价 | 没有 Codex cloud、云端代码审查、Slack 集成 |
| Codex + CC Switch + cocodot | 按 /ccswitch 配好的 Codex | 从 cocodot 余额扣,单价以 cocodot 价格页为准 | 必须开本地路由;只有 cocodot 在售型号,没有 GPT-6 系列 |