Model Server 使用指南

外观

Codex 配置 ​

Codex 同时提供桌面版和 CLI。第一次使用推荐桌面版；一键配置对两种方式都有效，不需要自己创建 config.toml 或 auth.json。

先选择你使用的 Codex

两种方式使用同一个配置目录，下面的一键配置都适用。

1安装 Codex 桌面版

打开桌面版安装说明

已经安装可以直接进入下一步。一键配置同时适用于 Codex 桌面版和 CLI。

2创建 API 密钥

打开 API 密钥页面，创建或找到准备使用的密钥。

打开 API 密钥页面

3下载并运行一键配置

找到密钥后，点击右侧的 使用密钥。

选择“Codex CLI”和当前操作系统，然后点击 下载一键配置脚本。 Codex 桌面版和 CLI 共用同一个配置目录。

在下载目录打开终端，然后运行：

sh codex-setup.sh
看图操作

Codex 配置流程图

按照真实控制台截图找到“使用密钥”，选择 Codex CLI 后下载一键配置；也可以复制配置文件内容手动设置，最后重新打开 Codex 验证。

界面可能随版本变化
  1. 第 1 步

    在令牌管理页点击“使用密钥”

    1. 1

      点击目标密钥这一行右侧的“使用密钥”。

    打开令牌管理页，在准备配置给 Codex 的密钥这一行点击“使用密钥”。密钥本身不会在这张截图中显示。

    自行采集Model Server 控制台当前界面（自行截图）
  2. 第 2 步

    选择 Codex CLI 并完成配置

    1. 1

      选择 Codex CLI；生成的配置同时可供 Codex CLI 和桌面版读取。

    2. 2

      选择自己的操作系统；截图中选中的是 macOS / Linux。

    3. 3

      推荐点击“下载一键配置脚本”。

    4. 4

      下载后运行这里显示的终端命令；可点击右侧“复制”。

    5. 5

      脚本不可用时，复制 config.toml 内容写入对应文件。

    6. 6

      再复制 auth.json 内容写入对应文件；不要分享含真实密钥的文件。

    先选择 Codex CLI 和自己的操作系统。推荐点击“下载一键配置脚本”，下载后运行图中给出的终端命令；只有脚本不可用时，才分别复制 config.toml 和 auth.json 手动配置。截图以 macOS / Linux 为例，API Key 已经遮盖；实际地址、模型和密钥必须以当前页面复制内容为准。

    自行采集Model Server 控制台当前界面（macOS / Linux 自行截图）
  3. 第 3 步

    重新打开 Codex 并确认模型

    1. 1

      确认这里显示的是配置中的模型。

    2. 2

      在输入区提交一个只读取当前目录的简单任务。

    重新启动后，先确认顶部显示的是预期模型，再输入一个简单任务进行验证。

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

4重启并验证

完全退出 Codex 桌面版，重新打开并新建一个任务。只关闭窗口可能不会重新加载配置。

新建任务后输入：说明当前目录包含哪些文件

能够正常返回内容，就表示配置成功。

一键配置文件包含你的 API 密钥。配置完成后请妥善保管或删除下载文件。

一键配置不可用时，查看手动配置

将示例中的 sk-your-api-key 替换为自己的 API Key。

~/.codex/config.toml

model_provider = "custom"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.custom]
name = "API 服务"
base_url = ""
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

如何确认配置成功 ​

桌面版重新打开后，新建一个任务并发送一句简单请求，例如“说明当前目录包含哪些文件”。CLI 用户运行 codex 后发送同样的请求。能够正常返回内容即表示接入成功。

如果 Codex 仍然要求登录，请先完全退出 Codex Desktop 或 CLI，再重新打开并新建任务。仍未解决时，检查 ~/.codex 或 %USERPROFILE%\.codex 中是否已经生成配置文件。

更新配置 ​

更换 API Key、API 地址或模型后，重新下载并运行一键配置即可。建议不要同时保留多套指向不同服务商的同名配置。

常见问题 ​

  • 401：API Key 不正确、已删除或复制不完整。
  • 403：当前 Key 没有对应分组或模型权限。
  • 429：余额、并发数或速率限制不足。
  • 一直连接：检查网络、代理以及 API 地址是否可以访问。

更多处理方法见常见问题。