Model Server 使用指南

外观

CC Switch 配置 Model Server 供应商 ​

CC Switch 是跨平台图形化供应商管理工具。本页只说明如何在 CC Switch 的 Codex 面板中添加名为 Model Server 的第三方供应商。它会替你维护 Codex 的 ~/.codex/config.toml 和认证配置，适合不熟悉终端配置文件、或需要在多个供应商之间切换的用户。

这里的 Model Server 是供应商显示名，实际请求使用本页动态显示的 API 地址、API Key 和模型；整个流程只配置 Codex，不涉及其他客户端。

接入协议Codex / OpenAI Responses
打开安装说明

配置步骤

  1. 1

    安装 CC Switch，并先单独启动一次 Codex CLI 或 Codex Desktop，让软件识别 ~/.codex 配置目录。

  2. 2

    打开 CC Switch，点击顶部带 OpenAI 标志的 Codex 图标，再点击窗口右上角的橙色加号。

  3. 3

    供应商名称填写 Model Server；按照下方字段填写 API Key、API 请求地址和默认模型，保持“完整 URL”关闭，然后点击“保存”。

  4. 4

    回到 Codex 供应商列表，找到 Model Server 并点击右侧“启用”，完全退出后重新启动 Codex。

复制配置

CC Switch → Codex → Model Server 供应商

供应商名称: Model Server
API Key: sk-your-api-key
API 请求地址: 
完整 URL: 关闭
默认模型: gpt-5.6-sol

启用后应写入的 Codex 配置（核对用）

model_provider = "custom"
model = "gpt-5.6-sol"

[model_providers.custom]
name = "Model Server"
base_url = ""
wire_api = "responses"
requires_openai_auth = true

这段用于核对 CC Switch 生成的 ~/.codex/config.toml；真实 API Key 通常由 CC Switch 保存到 ~/.codex/auth.json，请勿分享含密钥的文件。

看图操作

CC Switch 配置流程图

按照 3 张当前中文版真实界面截图，在 CC Switch 的 Codex 页面添加 Model Server 供应商：点击加号、填写并保存，最后回到列表启用。

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

    选择 Codex 并点击右上角加号

    1. 1

      先点击顶部的 Codex 图标；选中后图标后方会显示深色背景。

    2. 2

      点击窗口右上角的橙色加号，添加 Codex 供应商。

    打开 CC Switch 后，先点击顶部带 OpenAI 标志的 Codex 图标，再点击窗口右上角的橙色加号，进入添加供应商页面。

    自行采集CC Switch 当前稳定版
  2. 第 2 步

    填写 Model Server 供应商并保存

    1. 1

      供应商名称填写 Model Server；备注和官网链接可以留空。

    2. 2

      API Key 粘贴自己在本站后台创建的完整密钥。

    3. 3

      API 请求地址填写页面复制区中的 /v1 地址，并保持“完整 URL”关闭。

    4. 4

      默认模型填写页面复制区显示的 Codex 模型名称。

    5. 5

      检查以上内容无误后，点击右下角“保存”。

    供应商名称填写 Model Server；API Key 粘贴自己的完整密钥；API 请求地址和默认模型使用页面复制区给出的值。保持“完整 URL”关闭，确认后点击右下角“保存”。截图中的密钥已经隐藏。

    自行采集CC Switch 当前稳定版
  3. 第 3 步

    在供应商列表启用 Model Server

    1. 1

      点击 Model Server 卡片右侧的蓝色“启用”按钮。

    保存后会返回 Codex 供应商列表。找到刚添加的 Model Server 卡片，点击右侧蓝色“启用”；启用后完全退出并重新启动 Codex。

    自行采集CC Switch 当前稳定版

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

验证配置

CC Switch 中 Model Server 显示为当前使用后，重新启动 Codex，在 Codex 中发送“只读取并说明当前目录有哪些文件”；能够正常回复且没有认证错误即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

安装要求 ​

  • Windows 10 或更高版本。
  • macOS 12 或更高版本。
  • Linux 可使用官方 .deb、AppImage 或 AUR 包。
  • Codex CLI 或 Codex Desktop 需要先安装并至少启动一次，让 CC Switch 能够找到 Codex 配置目录。

只从 CC Switch 官方仓库发布页下载安装包。macOS 也可以运行 brew install --cask cc-switch。

如何恢复原配置 ​

启用供应商前，建议在 CC Switch 的设置或备份功能中保存当前配置。如果切换后需要恢复，可在供应商列表重新启用原供应商；不要同时手工修改 config.toml 和让 CC Switch 写入同一个配置。

常见错误 ​

  • 看不到 Codex：升级 CC Switch 到当前版本，并在应用可见性设置中启用 Codex；同时确认 Codex 已启动过一次。
  • 配置写到了别的客户端：添加前没有先选择 Codex；删除错误条目后在 Codex 面板重新创建。
  • 401：重新编辑 Model Server 供应商并粘贴完整 API Key；如果启用了保留官方登录，请确认 auth.json 与当前供应商状态一致。
  • 地址错误：Base URL 填写本页的 /v1 地址，不要填写完整 /v1/responses。
  • 切换后没有变化：完全退出 Codex，再重新启动，让它重新读取 config.toml。

更多功能和版本说明见 CC Switch 官方仓库；通用错误处理见常见问题。