Integrations

Codex by CCS

通过 CC Switch 将 Codex 接入 UnifyLLM。

接入说明

本页说明如何通过 CC Switch 将 Codex 接入 UnifyLLM。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Codex，端点填写带 /v1 的地址，API 格式选择 Responses 原生格式。

先安装 Codex：桌面版或 CLI

你可以使用 Codex 桌面版，也可以使用 Codex CLI。桌面版请从 OpenAI Codex 官方页面进入下载或产品入口；CLI 则在终端中安装，二者都需要先完成官方登录。

  1. 1

    macOS / Linux：安装 CLI

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

  2. 2

    Windows：安装 CLI

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

  3. 3

    启动并登录

    进入项目目录运行 codex，首次启动选择 Sign in with ChatGPT 或当前版本提供的其他登录方式。

  4. 4

    确认命令可用

    执行 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 Base URL：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（原生格式）；端点填写 https://api.unifyllm.top/v1，再粘贴 API Key。不要把 Key 写入截图、代码仓库或公开日志。

  5. 5

    添加并选择模型

    添加模型 gpt-5.6-sol 或从“获取模型”列表中选择准确的模型 ID；如果模型列表为空，先检查端点、Key 和 /v1 是否重复。

  6. 6

    启用供应商

    点击启用并按 Codex 的要求重启工具。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Codex，端点填写带 /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，发送一个简短的编程请求；再到控制台用量日志确认模型、Token 用量和扣费。

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

  • 先使用一个短请求测试，不要一开始就运行大批量任务。
  • 确认模型 ID 与价格页/控制台完全一致，尤其注意分组前缀。
  • 到控制台用量日志查看请求是否到达、实际模型、Token 用量和错误信息。
  • 如果工具自动追加 /v1，而你又手动填写了 /v1，请删除重复部分。

CC Switch 官方参考

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

安全提醒

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