文档客户端配置Codex

Codex

不使用 CC Switch，通过 Codex 配置文件将其永久接入 SoleAPI。

Codex

本页通过 Codex 的 config.toml 配置文件将其永久接入 SoleAPI，在此之前您可选择通过更便捷的CC-Switch接入。开始前，请先在控制台创建一个 API Key。

安装 Codex

安装命令行版本（CLI）

这里仅展示通过Node.js附带的npm来安装codex-cli：

  1. 确保您的Node.js版本 >= v22，可通过命令行执行 node -v 查看
bash
node -v

展示本地node.js版本

如果您的版本低于 v22 或没有Node.js，可从官网下载页面获取：https://nodejs.org/zh-cn/download。

展示下载页面

  1. 通过npm安装@openai/codex
bash
npm install -g @openai/codex

安装Windows图形化桌面版本（ChatGPT）

Codex 现在被合并到 ChatGPT 应用程序中，通过应用主界面左上角进行切换，如图：

  • 方式一：通过[Microsoft Store](https://apps.microsoft.com/detail/9PLM9XGG6VKS?hl=neutral&gl=CN&ocid=pdpshare)安装

  • 方式二：通过官网下载页面获取安装程序

配置接入 SoleAPI

  1. 打开 Codex 配置目录
  • Windows: C:\Users\你的用户名\.codex
  • MacOS: /Users/你的用户名/.codex
  • Linux: /home/你的用户名/.codex

Windows 可通过 Win + R 打开「运行」窗口，输入 explorer %userprofile%\.codex 即可打开资源管理器并跳转至对应目录。

Linux / MacOS 终端用户可使用 cd ~/.codex 命令进入目录。

  1. 确认配置文件存在

我们需要的配置文件名为 config.toml。如果文件不存在，请手动创建；如果文件已存在，可以先复制一份备份。

  1. 修改配置文件

将以下内容合并到 config.toml，并将 sk-sole-你的Key 替换为你自己的 API Key，将model写成你要用的模型名称：

toml
model_provider = "soleapi"
model = "gpt-5.6-sol"

[model_providers.soleapi]
name = "SoleAPI"
base_url = "https://soleapi.com/v1"
experimental_bearer_token = "sk-sole-你的Key"
wire_api = "responses"

base_url 必须使用 https://soleapi.com/v1，末尾不要再加 /。

如果 config.toml 中已经有其他配置，请保留原有字段，仅合并或修改 model_provider、model 和 [model_providers.soleapi] 部分。
再次提醒：修改配置文件前建议先备份！

  1. 生效验证

保存文件后，完全退出并重新启动 Codex。发送一条消息，能正常收到回复即表示配置成功。

ChatGPT 应用程序默认关掉窗口后是最小化到系统托盘，注意在右键系统托盘图标选择「退出」后再重新启动应用程序，才能生效。

常见问题

  • 请求返回 404：确认 base_url 使用的是 https://soleapi.com/v1。
  • 请求路径出现双斜杠：删除 base_url 末尾的 /。
  • 返回 401：检查 experimental_bearer_token 是否完整，以及 API Key 是否仍然有效。