作者： Codex 能否使用 ChatGPT 订阅？登录与 API Key 说明
可以。Codex CLI 登录 ChatGPT Plus 或 Pro 等套餐即可使用，无需 API key。了解套餐覆盖范围，以及第三方桥接工具为何频繁失效。
是的，Codex 使用您的 ChatGPT 订阅
Codex 可以使用您的 ChatGPT 订阅，这是运行它的受支持方式。运行 codex login，完成浏览器中的步骤后，CLI 会使用您的 ChatGPT 套餐计费，而不是使用 API 密钥。截至 October 2026，包含 Codex 的套餐有 Free、Go、Plus、Pro、Business、Edu 和 Enterprise。OpenAI 在 Codex 应用于 February 2026 发布时，曾“限时”加入 Free 和 Go，并且目前仍列出这两个套餐：Free 适用于快速编码任务，Go 适用于轻量任务。因此，使用这两个套餐时，CLI 同样不需要 API 密钥。
npm install -g @openai/codex
codex login
codex login statuscodex login status 会报告 CLI 当前使用的账户，以及将使用的身份验证方式。在 macOS 上，您可以使用 brew install --cask codex 安装相同的二进制文件。如果状态输出显示的是 API 密钥，而您希望使用订阅，请运行 codex logout 并重新登录。
简而言之，对于 Codex，答案是肯定的。通常，问题是从另一个方向产生的：您安装了其他代理，它要求提供以 sk- 开头的密钥，而您想知道为什么已经付费的套餐还不够。这背后有明确的机制。在寻找变通方法之前，值得先了解这一点。
为什么编程代理会要求单独的 API key
ChatGPT 方案和 OpenAI API 是两种产品，使用两套计费系统。方案是消费者服务中的一个席位。API 是按用量计费的服务，在 platform.openai.com 下拥有独立余额。两者不共用余额，也不共用凭据。
codex login 保存的不是 API key，而是 OAuth（开放授权）令牌。该令牌写入 ~/.codex/auth.json，由 OpenAI 自己的客户端软件签发。第一方客户端可以接受它，包括 CLI 和 IDE 扩展。api.openai.com 不接受它作为 bearer key。因此，使用 OpenAI API 的第三方代理没有可代表您发送的凭据，这就是 Cline 和 aider 等工具要求 API key 的原因。公共 API 唯一接受的凭据就是它。
这种分离并非 OpenAI 特有。Claude Code 中订阅登录与 API key 的相同选择出于相同原因采用相同方式，而比较主要编程代理的计费方式在很大程度上取决于供应商是否提供自有 CLI。
ChatGPT 计划实际涵盖的内容
此图表背后的数据
[
{
"plan": "Free",
"usd_per_month": 0,
"codex_cli": "yes"
},
{
"plan": "Go",
"usd_per_month": 8,
"codex_cli": "yes"
},
{
"plan": "Plus",
"usd_per_month": 20,
"codex_cli": "yes"
},
{
"plan": "Pro",
"usd_per_month": 100,
"codex_cli": "yes"
},
{
"plan": "Business",
"usd_per_month": 25,
"codex_cli": "yes"
}
]这些是截至 2026 年 10 月公布的价格，适用于 5 个个人和小型团队计划。Business 的价格按月付费时按用户计算，按年付费时更低。Plus 每月收费 20 美元，Pro 起价为每月 100 美元；Pro 还提供限制更高的套餐。购买前请查看定价页面，因为这些数字会变动。
用量的计量方式取决于计划。Plus 和标准 Business 计划使用五小时窗口。Pro 目前没有五小时限制，但 OpenAI 表示可能还会叠加每周限制。在 Codex 会话中，/status 会显示每个窗口的剩余用量以及各窗口的重置时间。使用 Plus 或 Business 时，开始长时间重构前先运行它，因为五小时窗口结束后，工作会话也会提前结束。
有一个细节容易被忽略。本地 CLI 会话和云端 Codex 任务使用同一项计划额度，ChatGPT Work 也使用该额度。应用中的普通聊天不使用这项额度；OpenAI 会单独计量普通聊天。某天下午在终端中大量使用，会减少当天可用于云端任务和 Work 的额度，但不会消耗聊天额度。达到上限后，Plus 和 Pro 用户可以购买额外额度，而不必升级计划。
热门 ChatGPT 桥接工具实际做什么
桥接工具是一个小型本地服务器。它使用您的账户登录面向消费者的 Web 产品，然后在 localhost 上提供类似 /v1/chat/completions 的端点。您将代理指向该地址，代理会认为自己正在调用 API，而桥接工具在底层重放浏览器会话自身发出的请求。有些变体会跳过浏览器，直接调用内部端点；原理相同，但涉及的环节更少。
以这种方式自动化消费者 Web 会话违反 OpenAI 的使用条款，而且可能因此失去的是您自己的账户。本指南不介绍安装这些工具、处理会话凭据、提取 Cookie，或使其正常运行所涉及的任何其他步骤。
工程问题与条款问题相互独立，而且同样具有决定性。桥接工具模拟的接口属于内部接口。没有任何保证表明它会保持不变，实际上它也不会保持不变。某个字段可能被重命名，可能新增完整性检查，流式传输格式也可能发生变化；在维护者修复之前，所有基于该接口构建的桥接工具都会开始返回 401 或 403。这就是一篇发布仅 6 周的博客教程今天却无法使用的原因。一个可用桥接工具的生命周期按周计算，而且它可能在您正在处理任务时中断。您维护的是一个无人付费的集成，而对接目标没有任何理由保持不变。
路径 1：供应商提供的订阅登录方式
供应商提供自己的 CLI 时，这是成本最低且受支持的路径，因为您已经为此付费。对于 Codex，使用 codex login。有两种情况不能只运行基本命令。
在没有浏览器的服务器上，使用设备代码登录：
codex login --device-auth该命令会输出一段代码。您需要在笔记本电脑的浏览器中输入这段代码。另一种方法是通过 SSH 转发回调端口，然后在服务器上执行常规流程：
ssh -L 1455:localhost:1455 user@remote
codex login您也可以从已经登录的计算机复制 ~/.codex/auth.json。请像保护密码一样保护此文件，因为其中包含有效的访问令牌。将权限设为 600，所有者设为运行代理的用户，并且绝不要将其放在 git 仓库或同步文件夹中。
如果某台计算机持续使用错误的凭据，请在 ~/.codex/config.toml 中固定凭据：
forced_login_method = "chatgpt"将其设为 "api" 可启用相反的行为。在共享服务器上，固定凭据很有必要，因为 OPENAI_API_KEY 可能已为其他工具导出；这样，直接运行 codex 就不会在您打算使用订阅额度时，意外产生按量计费的 API 费用。
路线 2：设置严格消费上限的 API key
API key 提供了套餐不具备的两项能力：没有每周额度窗口，并且每个代理都能接受同一个凭据。它还按 token 计费，因此陷入重试循环的代理会以机器运行速度产生真实费用。将 key 粘贴到任何位置之前，先设置上限。
唯一无法争辩的上限，是预付余额且关闭自动充值。没有余额，就无法继续消费。充值 20 美元，关闭自动充值，最坏情况下的费用就是 20 美元。在此基础上，再设置平台的月度预算和消费提醒；但应将预算视为警报，而不是保证停止。通知阈值和硬性限制是两个独立功能，而且它们已经发生过多次变化。
余额用尽后，请求会失败，并返回 HTTP 429 和 insufficient_quota 错误。这正是预期行为。代理会停止并报告失败，而不是继续运行，直到月底你才发现费用。
为每台机器创建一个项目和一个 key。这样，平台用量记录会显示哪台机器产生了多少费用；撤销不再使用的笔记本电脑上的 key，也不会影响服务器。通过管道传入 key，让 Codex 登录，这样 key 不会成为命令参数或 shell 历史记录的一部分：
printenv OPENAI_API_KEY | codex login --with-api-key将导出操作写入只有你自己的用户可读取的文件。如果你在服务器上运行代理，在 VPS 上运行 OpenCode介绍了相同的 key 处理方式，适用于完全没有第一方登录功能的代理；根据自己的 token 用量计算月度账单则可以帮助你判断，按量计费对你而言是否真的比固定套餐更便宜。
路线 3：大部分任务使用本地模型，复杂任务使用托管模型
编码代理执行的许多任务都是机械性的：读取文件、重命名符号、编写一个与现有 3 个测试相似的测试，以及汇总差异。本地模型可以处理这些任务，且不会产生边际成本。需要判断的工作则交给托管模型。
Codex 直接支持这种配置。codex --oss 可将其指向本地的 OpenAI 兼容服务器，默认使用 Ollama：
ollama pull gpt-oss:20b
codex --oss -m gpt-oss:20b若要使配置永久生效，请在 ~/.codex/config.toml 中声明该提供商：
model = "gpt-oss:20b"
model_provider = "ollama"
[model_providers.ollama]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"是否适合采用这种方案，取决于两个限制条件。Ollama 的 Codex 页面要求上下文窗口至少为 64k tokens。由于代理会将整个文件粘贴到提示词中，上下文很快就会被填满。这意味着需要足够的内存。经过 4 bit 量化的 20b 模型，在计入上下文窗口之前就大约需要 16 GB RAM；而更大的 gpt-oss:120b 在普通 VPS 套餐上无法运行。为编码代理 VPS 估算 RAM 和 CPU 提供了实际所需的数值。
手动在本地模型和托管模型之间切换完全可行。网关的作用就是自动完成选择。自托管 LiteLLM 网关 为每个代理提供一个端点和一个查看支出的统一位置；将简单任务路由到本地模型，将复杂任务路由到托管模型 介绍了如何划分边界，同时避免降低代理的工作质量。
选择路线
如果您已经为 ChatGPT 付费，并且只在一台机器上工作，请使用 codex login，并监控 /status。这就是全部方案，不会产生额外费用。
如果您同时运行多个代理、执行无人值守任务，或使用不支持官方登录的工具，请购买 API key，预付少量余额，并关闭自动充值。按量计费开始让您感到负担后，再添加本地模型处理大部分工作。
各路径上故障的表现
订阅达到上限：Codex 拒绝请求，并告知窗口何时重置；/status 会显示已耗尽的窗口。系统没有故障。等待重置、购买额度，或将该会话迁移到本地模型。
API key 余额为空：返回 HTTP 429，并显示 insufficient_quota。为余额充值，或有意提高上限。如果不希望使用窗口在任务进行到一半时停止请求，API key 更适合，但前提是充值金额足以覆盖整个任务。
使用了错误的凭据：codex login status 会指出当前使用的身份验证方式。如果它报告 API key 余额为空，而 ChatGPT 的额度仍未使用，这就是全部问题所在。运行 codex logout，然后运行 codex login，最后固定 forced_login_method，避免设置再次漂移。
桥接层：本地代理返回 401 或 403，或者回复流在中途断开。上游接口已发生变化。你无法从本地修复此问题，这正是桥接层的作用。
FAQ
Codex 可以使用我的 ChatGPT Plus 订阅，而不是 API key 吗？
可以。运行 codex login，完成浏览器步骤后，Codex 会使用您的 ChatGPT 套餐计费。截至 2026 年 10 月，Free、Go、Plus、Pro、Business、Edu 和 Enterprise 套餐均包含 Codex，因此这些套餐在 CLI 中都不需要 API key。使用 codex login status 确认当前启用的凭据。
为什么我的其他编程代理仍然要求 OpenAI API key？
因为您的 ChatGPT 套餐不会签发公共 API 接受的凭据。codex login 会将 OAuth token 写入 ~/.codex/auth.json，供 OpenAI 自有客户端使用；api.openai.com 不会将该 token 作为 bearer key 接受。任何访问公共 API 的代理（例如 aider、Cline 或 OpenCode）都需要从 platform.openai.com 获取 API key，并使用该平台的余额。
通过 ChatGPT 网页会话转发编程代理是否违反规则？
是。自动化操作消费者网页会话违反 OpenAI 的使用条款，并可能导致您的账户被停用。这些桥接工具也经常失效，因为它们依赖会在没有通知的情况下发生变化的内部接口。因此，正常运行的配置通常很难维持超过几周。
Codex CLI 的使用量会占用 ChatGPT 应用的限额吗？
不会占用聊天限额。本地 CLI 会话、云端 Codex 任务和 ChatGPT Work 共用一个额度，但应用中的普通聊天单独计量。Plus 和标准 Business 套餐有五小时窗口；Pro 当前没有五小时限额，但也可能有每周限额。在 Codex 会话中运行 /status，即可查看每个窗口的剩余额度及重置时间。
如何防止 API key 产生高额账单？
预充值余额并关闭自动充值，因为没有余额就无法继续消费。将平台的月度预算和消费提醒作为第二层控制，并将预算视为提醒，而不是保证执行的截止限制。余额耗尽后，请求会返回 HTTP 429 和 insufficient_quota，代理会停止运行，而不会在不知情的情况下继续消费。