Home >博客

Codex桌面客户端如何使用第三方中转站

如果你想让 Codex 桌面客户端走BigModel这类第三方中转站，而不是默认线路，可以按这篇教程来配置。下面的内容已经按你自己的 BigModel 接法整理好了，适合直接发布。

一、先准备好 BigModel 的 API Key

先登录 BigModel 控制台，创建你自己的 API Key。后面 Codex 发请求时，会直接使用这个 Key 进行鉴权。

官网：https://api.bigmodel.org/

拿到 Key 之后先保存好，下一步配置 Codex 时会直接用到。

二、先关闭 Codex 桌面客户端

在修改配置之前，建议先把 Codex 桌面客户端完全退出。

原因很简单：如果当前程序还在运行，它可能还在读取旧配置。你虽然已经改了文件，但实际请求不一定马上走新线路。

三、进入 ~/.codex 目录

打开终端，执行下面命令：

cd ~/.codex

如果这个目录不存在，就先创建：

mkdir -p ~/.codex

cd ~/.codex

四、创建或编辑 config.toml

Codex 最关键的本地配置文件，一般就是：

~/.codex/config.toml

如果你还没有这个文件，可以先创建：

touch ~/.codex/config.toml

五、把配置改成 BigModel

打开 ~/.codex/config.toml，填入下面这份配置：

model_provider = "Bigmodel"

model = "gpt-5.4"

model_reasoning_effort = "high"

approval_policy = "never"

[model_providers.Bigmodel]

name = "Bigmodel"

base_url = "https://api.bigmodel.org/v1"

wire_api = "responses"

supports_websockets = false

experimental_bearer_token = "你的 BigModel API Key"

requires_openai_auth = true

六、这些配置项分别是什么意思？

model_provider = "Bigmodel"

表示 Codex 默认使用你定义的这个模型提供方，也就是 BigModel。

model = "gpt-5.4"

这是默认模型名。这里不要随便写，必须填 BigModel 当前真实支持、并且你这条线路可调用的模型 ID。

base_url = "https://api.bigmodel.org/v1"

这一项表示 Codex 请求最终发往哪里。对于 BigModel 这种 OpenAI 兼容中转站，通常就写它的网关地址，并带上 /v1。

wire_api = "responses"

表示 Codex 与上游使用的是 responses 这套接口协议。也就是说，中转站需要能正确承接这类请求。

experimental_bearer_token = "你的 BigModel API Key"

这里填的就是你在 BigModel 后台创建的 API Key。Codex 会把它作为 Bearer Token 带到请求头里。

supports_websockets = false

表示当前这套接法不依赖 WebSocket 能力，走普通请求链路即可。

requires_openai_auth = true

表示按 OpenAI 风格的 Bearer Token 认证方式处理请求。BigModel 这种兼容型中转站，通常就保留这个配置。

七、保存后重启 Codex

配置写好并保存后，重新打开 Codex 桌面客户端。

一般来说，新开的会话就会按你刚才的 BigModel 配置去发请求。

八、怎么判断是否已经配置成功？

方法 1：看 Codex 是否能正常使用

如果 Codex 可以正常发消息、正常返回结果，说明基础调用链路已经打通。

方法 2：看 BigModel 后台的使用日志

九、常见问题

1）Codex 打开后还是不能用

• 检查 ~/.codex/config.toml 路径是否正确

• 检查 Codex 是否已经完全重启

• 检查 API Key 是否填写正确

2）接口通了，但模型报错

这种情况通常不是配置文件格式问题，而是你填的模型名在 BigModel 当前线路中并不可用。建议以 BigModel 当前实际支持的模型 ID 为准。

3）写了 Key 还是 401

• 检查 Key 是否复制错误

• 检查 Key 是否已经失效

• 检查账户是否还有余额

• 检查当前 BigModel 通道是否可用

4）为什么这里不用 env_key？

因为你现在这套 BigModel 接法，实际用的是直接写：

experimental_bearer_token = "你的 BigModel API Key"

所以这里不是沿用别的教程里的 env_key 写法，而是按你自己的当前接法来写。

十、一句话总结

如果你想让 Codex 使用 BigModel，本质上就是在 ~/.codex/config.toml 里定义一个新的模型提供方，然后把请求地址和 Bearer Token 指向 BigModel。

配好 model_provider、model、base_url、wire_api 和 experimental_bearer_token，重启 Codex 后就可以使用。

参考链接

BigModel 官网：https://api.bigmodel.org/

BigModel API 文档：https://apiai.apifox.cn/

Information

Hits29
Published date2026/05/23

Codex桌面客户端如何使用第三方中转站

Table of Contents

Information

More Posts

推荐一个AI生图的网站-Imagens.app

BigModel API 中转站怎么用？新手 10 分钟上手教程

Cookie Preferences