Integrations

Codex by CCS

通过 CC Switch 将 Codex 接入 UnifyLLM。

接入说明

本页说明如何通过 CC Switch 将 Codex 接入 UnifyLLM。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Codex，API 地址填写 https://api.unifyllm.top。然后回到 Codex 设置，点击「编辑供应商」，CC Switch 会自动将 API 请求地址显示为带 /v1 后缀的 https://api.unifyllm.top/v1，API 格式选择 Responses 原生格式。

先安装 Codex：桌面版或 CLI

你可以使用 Codex 桌面版（目前已合并进 ChatGPT 桌面版），也可以使用 Codex CLI。桌面版可从 OpenAI Codex 官方页面下载或进入产品入口，也可以从微软应用商店获取；CLI 则在终端中安装。推荐顺序是：先安装并登录 ChatGPT 桌面版，再通过 CC Switch 配置 Codex；配置生效后启动 Codex 即可直接使用，通常无需再次登录。

  1. 1

    macOS / Linux：安装 CLI

    在 Terminal、iTerm2 或其他 bash/zsh 终端执行官方独立安装命令。

  2. 2

    Windows：安装 CLI

    在 PowerShell 或 Windows Terminal 中执行 PowerShell 安装命令；不要把 PowerShell 语法直接粘贴到 Git Bash。

  3. 3

    先安装并登录 ChatGPT

    如果使用桌面版，先安装 ChatGPT 桌面应用并完成登录；桌面版已包含 Codex。

  4. 4

    通过 CC Switch 配置 Codex

    打开 CC Switch，在「统一供应商」中添加并启用 UnifyLLM，完成 Codex 配置后再启动 Codex。

  5. 5

    启动并验证

    进入项目目录运行 codex，或直接打开 ChatGPT 桌面版中的 Codex。配置已生效时即可直接发送请求，无需再次执行 Codex 登录。

  6. 6

    确认命令可用

    执行 codex --version；如果提示找不到命令，重启终端并检查 npm 或独立安装器写入的 PATH。

bash
1# macOS / Linux2curl -fsSL https://chatgpt.com/codex/install.sh | sh3 4# Windows PowerShell5powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"6 7# cross-platform npm fallback8npm install -g @openai/codex9 10# start in a project11codex

接入前准备

  • 统一供应商 API 地址：https://api.unifyllm.top（Codex 设置中的 API 请求地址会由 CC Switch 自动显示为 https://api.unifyllm.top/v1）
  • 一个有效的 UnifyLLM API Key
  • 一个当前可用的模型 ID，例如 gpt-5.6-sol。模型、分组和价格可能变化，请以价格页及控制台模型列表为准。

在 CC Switch 中配置

  1. 1

    安装并打开 CC Switch

    打开供应商管理页面，在应用切换器中选择 Codex。

  2. 2

    进入统一供应商

    点击 +，在「统一供应商」中新增 UnifyLLM，不要放到应用专属供应商列表。

  3. 3

    选择 NewAPI 预设

    预设类型选择 NewAPI，供应商名称填写 UnifyLLM。

  4. 4

    选择格式并填写端点

    API 格式选择 Responses（原生格式）；在「统一供应商」的 API 地址填写 https://api.unifyllm.top，再粘贴 API Key。保存后回到 Codex 设置，点击「编辑供应商」，确认 API 请求地址已自动显示为 https://api.unifyllm.top/v1；不要手动把 /v1 重复填入统一供应商地址。

  5. 5

    添加并选择模型

    添加模型 gpt-5.6-sol 或从“获取模型”列表中选择准确的模型 ID；如果模型列表为空，先检查地址、Key，以及 Codex 设置中的 /v1 是否已自动补全。

  6. 6

    启用供应商

    点击启用并按 Codex 的要求重启工具。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Codex，API 地址填写 https://api.unifyllm.top。然后回到 Codex 设置，点击「编辑供应商」，CC Switch 会自动将 API 请求地址显示为带 /v1 后缀的 https://api.unifyllm.top/v1，API 格式选择 Responses 原生格式。

手动配置参考

如果你没有使用 CC Switch，下面是对应工具常见配置格式的参考。不同版本的配置字段可能变化，优先以工具本身文档为准。

toml
1model = "gpt-5.6-sol"2model_provider = "unifyllm"3 4[model_providers.unifyllm]5name = "UnifyLLM"6base_url = "https://api.unifyllm.top/v1"7env_key = "UNIFYLLM_API_KEY"8wire_api = "responses"

测试与排查

保存供应商后启动 Codex，发送一个简短的编程请求。完成 ChatGPT 安装登录和 CC Switch 配置后，通常无需再次登录 Codex；再到控制台用量日志确认模型、Token 用量和扣费。

接口参考：Chat Completions、Responses、Messages 和 Generate Content。

  • 先使用一个短请求测试，不要一开始就运行大批量任务。
  • 确认模型 ID 与价格页/控制台完全一致，尤其注意分组前缀。
  • 到控制台用量日志查看请求是否到达、实际模型、Token 用量和错误信息。
  • 确认 Codex 设置中的 API 请求地址已自动显示 https://api.unifyllm.top/v1；如果没有，请重新点击「编辑供应商」检查应用和预设选择。不要在统一供应商地址中重复添加 /v1。

CC Switch 官方参考

本文参考 CC Switch 官方的软件介绍、添加供应商和编辑供应商。CC Switch 更新后，字段名称和配置路径可能变化，请以其最新版文档和应用界面为准。

安全提醒

API Key 等同于账户调用凭据。请使用专用 Key，限制暴露范围，发现泄露后立即在控制台禁用并重新创建。不要把 Key 放入前端代码、公开仓库、截图或第三方同步服务。