Codex 客户端从装好到跑通：第三方 API 接入与配置避坑指南

前阵子上手 Codex 客户端时，注意到不少同学卡在同一个地方------软件装好了，却不知道怎么把第三方 API 配进去、调用 GPT-5.5 模型。

其实流程很短：装好客户端、拿到 API Key、再改两个配置文件，三步就能跑通。

下面把每个环节都展开讲清楚，新手照着做也能一次配好。

一、下载安装 Codex 客户端

先到官网下载最新版本的安装包：

选择与自己系统对应的版本，正常安装即可。

装完记得先打开一次 Codex，让程序把配置目录初始化出来。

二、申请 API Key

接下来要拿到一个可用于调用 GPT-5.5 的 API Key。

打开注册页，完成注册并登录：

登录之后进入密钥管理页：

这里就是 API 密钥的管理界面。

新建 Key

点击页面右上角的 创建API密钥 按钮：

表单里的两项可以这样填：

配置项	内容
名称	随便填写
分组	defalut

不同分组的倍率有差别，按平台当前显示和自己的预算挑一个就行。

填完点 保存 保存：

创建成功后，点 Key 右侧的 复制 把它复制出来：

这个 Key 后面要写进配置文件，先妥善保存。

三、定位配置目录

Windows

用 Win + R 唤出运行窗口：

输入 %userprofile%\.codex 后回车，就能直接打开配置目录。

macOS

在终端里执行 ~/.codex 即可跳转过去。

也可以在访达里前往 /Users/用户名/.codex 这个路径。

四、修改 auth.json

在配置目录里找到 auth.json 文件，它负责存放 Codex 的认证信息。

这里有个容易踩的坑：文件里有且只能有这一个字段，格式也必须一字不差，否则调用时会报 Failed to refresh token: 403 Forbidden 这样的错误。

标准写法如下：

json 复制代码

{
  "OPENAI_API_KEY": "替换成你自己的APIKey"
}

实际填好之后大概长这样：

json 复制代码

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
}

一个典型的错误写法

像下面这样就是错的：

json 复制代码

{
  "OPENAI_API_KEY": "sk-xxx",
  "MODEL": "gpt-5.5"
}

多塞进去的字段会让认证直接失败。

五、修改 config.toml

接着打开 config.toml 文件，把内容替换成：

toml 复制代码

model_provider = "mycodex"
personality = "pragmatic"
model = "gpt-5.5"
model_reasoning_effort = "medium"
preferred_auth_method = "apikey"

[model_providers.mycodex]
name = "mycodex"
base_url = "https://api.aisz.mom/v1"
wire_api = "responses"

六、各参数含义

model_provider

用来指定模型服务商是谁：

toml 复制代码

model_provider = "mycodex"

它的取值必须和后面配置块的名称对得上：

toml 复制代码

[model_providers.mycodex]

model

当前要用的模型：

toml 复制代码

model = "gpt-5.5"

平台以后上线了别的模型，改这一行就能切换。

model_reasoning_effort

推理力度档位：

toml 复制代码

model_reasoning_effort = "medium"

可选值有 low、high、medium 三档，日常用 medium 一档，速度和效果比较均衡。

preferred_auth_method

认证方式的设定：

toml 复制代码

preferred_auth_method = "apikey"

apikey 表示走 API Key 鉴权。

base_url

请求要打到哪个地址：

toml 复制代码

base_url = "https://api.aisz.mom/v1"

之后所有的调用请求都会发往这里。

wire_api

接口采用什么协议：

toml 复制代码

wire_api = "responses"

Codex 官方建议使用 Responses API。

七、完整配置示例

auth.json

json 复制代码

{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxx"
}

config.toml

toml 复制代码

model_provider = "mycodex"
personality = "pragmatic"
model = "gpt-5.5"
model_reasoning_effort = "medium"
preferred_auth_method = "apikey"

[model_providers.mycodex]
name = "mycodex"
base_url = "https://api.aisz.mom/v1"
wire_api = "responses"

八、重启 Codex

配置都写完之后，按顺序做四件事：

保存 auth.json
保存 config.toml
退出 Codex
重新打开 Codex

如果一切正常，此时就已经能和 GPT-5.5 正常对话了。

九、常见问题排查

提示 API Key 无效

先核对 auth.json 里的内容：

json 复制代码

{
  "OPENAI_API_KEY": "你的Key"
}

重点检查有没有这些问题：

多出来的字段
多余的逗号
引号用错

提示连接失败

检查 base_url 是否填写正确：

toml 复制代码

base_url = "https://api.aisz.mom/v1"

修改后不生效

把 Codex 完全退出，再重新启动一次------部分版本不会实时热加载配置。

写在最后

整个配置过程归纳起来就三步：

步骤	操作
第一步	装好 Codex 客户端
第二步	申请 API Key
第三步	改 auth.json 和 config.toml

最容易翻车的两处：auth.json 的格式写错，以及 config.toml 里服务商配置块的名称对不上。

配置无误后，Codex 客户端就能通过第三方 OpenAI 兼容接口用上 GPT-5.5，写代码、答疑、辅助项目开发都可以派上用场。