DocsClient setup手动配置 Codex

手动配置 Codex

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

手动配置 Codex

本页通过 Codex 的 config.toml 配置文件将其永久接入 SoleAPI。开始前，请先在控制台创建一个 API Key。

本教程同时适用于 Codex CLI 与 ChatGPT。原 Codex 桌面应用现已合并到 ChatGPT，桌面端请在 ChatGPT 中使用 Codex。

老手看这里

编辑 ~/.codex/config.toml，自行替换 API Key 和模型：

toml
model_provider = "soleapi"
# 模型列表(可选)
# model_catalog_json = "列表文件"

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

新手步骤级教程

  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 是否仍然有效。