认证配置

5.1 谁可以用 Codex

Codex 需要 ChatGPT 付费订阅。根据编程指北与 FastGPTPlus 教程,Plus / Pro / Team / Business / Edu 付费会员都可以使用,免费账号不可用。

订阅价格参考:

• ChatGPT Plus:$20/月
• ChatGPT Pro:$200/月
• ChatGPT Team:按席位计费

Codex CLI 已包含在这些订阅中,无需单独支付 API 费用(除非你选择走 API Key 模式)。

5.2 codex login:浏览器一键登录

安装完成后,在终端运行:

codex

首次运行会自动弹出浏览器,用 ChatGPT 账号一键登录,登录成功后自动写回 ~/.codex/token,全程不需要复制粘贴任何 API Key。

也可以显式触发登录:

codex login

5.3 设备码模式(无 GUI 环境)

在服务器或无图形界面的环境中,浏览器无法自动打开。此时使用设备授权码模式:

codex auth --device-code

流程:

1. 终端显示一个 URL 和授权码
2. 手动复制 URL 到本地浏览器打开
3. 输入显示的授权码完成认证
4. 终端自动收到 token

5.4 API Key 方式

如果你不想用 ChatGPT 账户登录,或想用第三方 API 聚合平台,可以用 API Key 方式:

# 设置环境变量
export OPENAI_API_KEY="sk-..."

也可在 ~/.codex/config.toml 中配置自定义模型提供方与 base_url,接入第三方平台(见第 8 章高级配置)。

5.5 token 存储与自动续期

• 认证信息存储在 ~/.codex/ 目录下(包含加密的访问令牌)
• 首次认证后,token 会自动续期,通常不需要重新认证
• 配置文件路径:~/.codex/config.json 或 ~/.codex/token

5.6 国内账户升级方案

国内用户若还是 ChatGPT 免费用户,需要升级到 Plus 才能用 Codex。常见方式:

• 使用支持国内支付的虚拟卡服务(如 Depay、WildCard 等)在 OpenAI 官网升级
• 通过第三方平台购买成品 Plus 账号(风险自担,不建议用于生产)

⚠️ 本教程不推荐任何特定支付渠道,请自行评估风险。最稳妥的方式是直接在 chat.openai.com 官方升级。

5.7 多账户切换与登出

切换账户前先登出当前账户:

# 登出
codex logout

# 重新登录其他账户
codex login

5.8 认证故障排查

问题 1:浏览器无法打开

服务器环境用 5.3 节的设备码模式。

问题 2:连接超时

国内网络问题,配置代理:

export HTTPS_PROXY=http://127.0.0.1:7890
codex login

问题 3:登录成功但调用报错

检查 token 是否正确写入:

ls -la ~/.codex/

若 token 文件不存在或为空,重新执行 codex login。

资料来源

• 编程指北 csguide.cn——30 秒安装与浏览器一键登录流程
• FastGPTPlus《OpenAI Codex CLI 完整教程》认证配置章节
• CSDN《Codex CLI 教程》——codex auth --device-code 设备码模式