Codex API Key 怎么配置?ChatGPT 登录、OpenAI Key 与第三方 Provider(2026 年 10 月 · Codex 0.165 实测)

Codex API Key 怎么配置?按 Codex CLI 0.165.0 实测:三种认证路线怎么选,第三方 Provider 在全局 config.toml 里用 experimental_bearer_token 写 Key,15.6 秒跑通改文件小任务;附 401、换 Key 仍报错、配置不生效(优先级)的排查。

5 分钟阅读
Codex API Key 怎么配置?ChatGPT 登录、OpenAI Key 与第三方 Provider(2026 年 10 月 · Codex 0.165 实测)
2026-10-29 更新:全文按 Codex CLI 0.165.0 重写。第三方 Provider 的 Key 改为直接写进全局 ~/.codex/config.toml 的 experimental_bearer_token,不再依赖环境变量;新增三条路线对比表、实测记录和配置优先级排查。

先说结论:Codex API Key 怎么配置,取决于你走哪条路线。用 ChatGPT 订阅就 codex login 浏览器登录;用 OpenAI 官方 Key 就 codex login --with-api-key;用第三方服务(比如 AICodeWith)就在全局 ~/.codex/config.toml 里写 model_provider 和 [model_providers.xxx],Key 放进 experimental_bearer_token。三条路线的 Key 不能混用。

我们在一台干净的 Linux 机器上,用独立的 CODEX_HOME 装了 Codex CLI 0.165.0,按第三种写法配好本站 Key:让 Codex 给 app.py 的函数加一行 docstring,从启动到改完用时 15.6 秒,diff 只动了一行。下面把每一步和踩到的报错都列出来。

速查:三条路线怎么选

路线怎么配置Key 从哪来适合谁
ChatGPT 登录codex login,浏览器完成登录;无浏览器用 codex login --device-auth不用 Key,用 ChatGPT 账号有 ChatGPT 订阅、要用 Codex cloud 的人
OpenAI Platform Keycodex login --with-api-key,Key 从标准输入传入OpenAI Platform 后台已有 OpenAI API 账户、按 API 用量走账的人
第三方 Provider全局 ~/.codex/config.toml 写 model_provider + [model_providers.xxx]服务商后台(如 AICodeWith「密钥管理」)想用服务商提供的接入地址和模型的人

据 OpenAI 官方认证文档:CLI、IDE 扩展和桌面端都支持 ChatGPT 登录和 API Key 登录;Codex cloud 只能用 ChatGPT 登录;用 API Key 登录时按 OpenAI Platform 账户的标准 API 计费走,不用 ChatGPT 套餐里的额度,一些依赖 ChatGPT 工作区或云端的功能会受限。

创建 API Key →

路线一:ChatGPT 登录

bash
codex login
codex login status

codex login 会打开浏览器,登录后凭证回传给 Codex。在远程服务器或没有浏览器的环境里,用 codex login --device-auth,在另一台设备的浏览器里输入一次性代码。据官方文档,登录信息缓存在 ~/.codex/auth.json 或系统凭证库里,CLI 和 IDE 扩展共用一份,在其中一个里退出,另一个也要重新登录。

路线二:OpenAI Platform Key

在 OpenAI Platform 后台创建 Key,再从标准输入传给 Codex,Key 不会出现在命令本身里:

bash
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status

Windows PowerShell:

powershell
$env:OPENAI_API_KEY | codex login --with-api-key

要换回 ChatGPT 登录,先 codex logout 再 codex login。

路线三:第三方 Provider(以 AICodeWith 为例)

第 1 步:创建 Key

  1. 注册并登录 AICodeWith
  2. 左侧导航点「密钥管理」,右上方点「创建密钥」,起一个好认的名字
  3. 生成后马上复制保存,窗口关掉就看不到完整 Key 了

创建 API Key →

第 2 步:写全局 config.toml

打开 ~/.codex/config.toml(Windows 是 C:\Users\你的用户名\.codex\config.toml,没有就新建),写入:

toml
model_provider = "aicodewith"
model = "gpt-6.1-sol"
model_reasoning_effort = "low"

[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "sk-你的Key"

几个要点:

  • model_provider 的值必须和表名 [model_providers.aicodewith] 里的 aicodewith 一致。
  • Key 直接写在 experimental_bearer_token,所有项目通用,不用每次开终端再设环境变量。
  • base_url 和 model 以服务商的接入说明为准;本站的完整接入步骤见 Codex 接入 AICodeWith 教程,每个字段的含义见 Codex config.toml 配置指南。
  • 这个文件里是明文 Key:不要提交到 Git,不要截图或贴到群里。

第 3 步:跑一个最小任务确认

进到一个 Git 项目里,用非交互模式跑一个小任务:

bash
codex exec -s workspace-write "给 app.py 的 greet 加一个 docstring,只改这一处"

我们实测(Codex CLI 0.165.0,gpt-6.1-sol,推理强度 low)的真实输出开头是这样的:

text
OpenAI Codex v0.165.0
--------
workdir: /tmp/cx22/proj
model: gpt-6.1-sol
provider: aicodewith
approval: never
sandbox: workspace-write [workdir, /tmp, $TMPDIR]
reasoning effort: low

Codex 先用 rg 找到 greet,然后打补丁,最后回复「已为 app.py 的 greet 添加 docstring,仅修改这一处。」git diff 只有一行:

text
 def greet(name):
+    """Return a greeting for the given name."""
     return "hi " + name

整个过程用时 15.6 秒。看到 provider: aicodewith 就说明配置生效了;在交互界面里输入 /status,看 Model provider 这一行也一样。

用 experimental_bearer_token 时,codex login status 会显示 Not logged in。我们实测就是这样,但上面的任务照常跑通。判断能不能用,以 provider 那一行和任务能否正常完成为准,不看 login status。

常见报错与排查

401 Unauthorized:Key 不对

我们故意把 experimental_bearer_token 换成一个错误的 Key,Codex 先重连 5 次,7.5 秒后退出,最后一行是:

text
ERROR: unexpected status 401 Unauthorized: {"error":"请在请求中提供有效的 API Key。"}, url: https://api.aicodewith.ai/chatgpt/v1/responses

按这个顺序查:

  1. 看 url。是服务商的地址,说明配置生效了,问题在 Key 本身:检查有没有复制全、前后有没有空格或引号、Key 是否已在后台删除。
  2. url 是 api.openai.com,说明 Codex 根本没用你的 Provider。我们把 model_provider 去掉再跑,日志就变成 provider: openai 并对 wss://api.openai.com/v1/responses 报 401。这时回去检查 model_provider 那一行和表名。

更多 401 场景见 Codex 401 Unauthorized 怎么解决。

换了 Key 还是报错

  • 改错了文件。Provider 和 Key 只能写在用户级 ~/.codex/config.toml(或 --profile 指定的 profile 文件)。据 官方高级配置文档,项目里的 .codex/config.toml 会忽略 model_provider、model_providers 等字段。我们在项目配置里写 model_provider = "openai",实测运行时仍是 provider: aicodewith。
  • 改了环境变量,没改配置。这套写法不读 OPENAI_API_KEY。我们把 OPENAI_API_KEY 设成一个假值再跑,任务照常完成,说明 Codex 用的是 experimental_bearer_token。换 Key 就改 config.toml 里那一行。
  • 用了别的 CODEX_HOME。设置了 CODEX_HOME 环境变量时,Codex 读的是那个目录下的 config.toml,不是 ~/.codex。
  • 改完没重开。改完配置,退出 Codex 再重新启动后再试。
  • 其实是 429。Key 没问题但被限流或额度不够,报的是 429,见 Codex 429 Too Many Requests。

配置不生效:先看优先级

据 官方配置文档,Codex 按下面顺序取值,上面的覆盖下面的:

  1. 命令行参数和 -c / --config
  2. 项目里的 .codex/config.toml(只在受信任的项目里生效,离当前目录近的优先)
  3. --profile 指定的 profile 文件 ~/.codex/<名字>.config.toml
  4. 用户级 ~/.codex/config.toml
  5. 系统配置和内置默认值

我们逐条试过:

做法实测结果
codex exec -c model='"gpt-6.1-nope"'日志显示 model: gpt-6.1-nope,0.5 秒返回「模型不存在」,命令行覆盖了全局配置
项目 .codex/config.toml 写 model = "gpt-6.1-nope2"同样被采用并报模型不存在,项目配置能改 model
项目 .codex/config.toml 写 model_provider = "openai"被忽略,仍是 provider: aicodewith,13.3 秒正常回复
全局配置里同一个表写了两遍Codex 直接退出:Error loading config.toml ... duplicate key

所以「配置不生效」先查三处:命令行有没有带 -m 或 -c,项目里有没有 .codex/config.toml 改了 model,全局配置里有没有重复的表或键(复制粘贴两遍很常见)。环境变量相关的坑见 Codex 环境变量怎么配。

想同时保留 ChatGPT 登录和第三方 Key

把 Provider 那几行挪到一个单独的 profile 文件里,比如 ~/.codex/aicodewith.config.toml,全局 config.toml 里不写 model_provider。需要时:

bash
codex --profile aicodewith
codex exec --profile aicodewith "只回复 OK 两个字母"

实测带 --profile aicodewith 时日志显示 provider: aicodewith,8.2 秒回复 OK;不带时回到默认的 provider: openai。多项目、多 Key 的写法见 Codex 多项目配置。

常见问题

codex login status 显示 Not logged in,是没配好吗?

不一定。用第三方 Provider 的 experimental_bearer_token 时,它就是这样显示。以运行日志里的 provider 那一行和任务能否完成为准。

还要设置 OPENAI_API_KEY 吗?

走第三方 Provider 不用。OPENAI_API_KEY 只在路线二(codex login --with-api-key)里用来把 Key 传给 Codex。

Key 能写在项目的 .codex/config.toml 里吗?

不能。项目配置会忽略 Provider 相关字段,Key 和 Provider 写在用户级 ~/.codex/config.toml 或 profile 文件里。

第三方 Key 能用来登录 ChatGPT 或 OpenAI Platform 吗?

不能。第三方 Key 只能配在对应服务商的 Provider 里;OpenAI 的 Key 和 ChatGPT 账号也不能拿去给第三方服务用。

还没装 Codex 怎么办?

先看 Codex 安装教程,装好后再按本文配置 Key。配好之后怎么用,见 Codex 怎么用。

创建 API Key →

相关资料

相关文章

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是什么、怎么用?Vercel + shadcn 给 Agent 的行为库,在 Claude Code / Codex / Cursor 里安装与实测(0.1.0-beta.1)

UI SDK 是 Vercel 在 2026 年 11 月 12 日发布的、给 Agent 用的行为(behaviors)库,版本 0.1.0-beta.1。行为写在与框架无关的 @ui-sdk/core 里,再由 React、Vue、Svelte、Solid 和 Web Components 适配器渲染。本文按官方文档整理它是什么、怎么安装、怎么给 Claude Code / Codex / Cursor 装 skill,并记录我们在测试机上的真实命令、耗时和输出。

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是什么、怎么装?让 Claude Code / Codex 在本地测 AWS 应用(1.0.322 实测)

AWS Emulator 是 AWS 官方 2026 年 11 月 12 日(北京时间)正式发布的本地 AWS 模拟器,没有额外服务费、源码开放,不需要 AWS 账号,覆盖 200 多个服务。本文在 Debian 13 上实测 1.0.322:安装命令、AWS CLI 指向本地 endpoint 建 S3 桶和 DynamoDB 表、常见报错,以及让 Claude Code、Codex、Cursor 对着模拟器写代码跑测试的接法。

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是什么、怎么装?接入 Claude Code 和 Codex、配置第三方 API Key 与常见报错(0.1.9 实测)

T3 Code 是 pingdotgg 开源的编码 Agent 控制台,本身不带模型,调用你机器上已装好的 Claude Code、Codex、Cursor 等 CLI。本文在 Linux 上实测 T3 Code 0.1.9:讲清安装命令,Claude Code 和 Codex 先各自接上 AICodeWith API Key、再由 T3 Code 调用的配置方法,用 t3 thread 命令行跑通两端的过程,以及我们实际遇到的报错和解法。