Claude Desktop by CCS | UnifyLLM Docs

接入说明

本页说明如何通过 CC Switch 将 Claude Desktop 接入 UnifyLLM。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Claude Desktop，端点填写根地址，API 格式选择 Anthropic Messages 原生格式。每次切换后都要重启 Claude Desktop。

先安装 Claude Desktop

从 Claude 官方下载页安装 macOS 或 Windows 桌面应用，然后至少启动一次并完成初始化。CC Switch 文档明确说明，Claude Desktop 第三方 3P profile 目前只支持 macOS 和 Windows 写入，Linux 不支持该写入模式。

macOS：下载 DMG，拖入 Applications 后启动。
Windows：下载 Windows 安装程序，完成安装后从开始菜单启动。
Linux：不能使用 CC Switch 写入 Claude Desktop 3P profile；如需在 Linux 上使用，请改用 Claude Code 或其他支持 Linux 的 CLI 工具。

接入前准备

API Base URL：https://api.unifyllm.top
一个有效的 UnifyLLM API Key
一个当前可用的模型 ID，例如 claude-sonnet-4-6。模型、分组和价格可能变化，请以价格页及控制台模型列表为准。

在 CC Switch 中配置

1
安装并打开 CC Switch
打开供应商管理页面，在应用切换器中选择 Claude Desktop。
2
进入统一供应商
点击 +，在「统一供应商」中新增 UnifyLLM，不要放到应用专属供应商列表。
3
选择 NewAPI 预设
预设类型选择 NewAPI，供应商名称填写 UnifyLLM。
4
选择格式并填写端点
API 格式选择 Anthropic Messages（原生格式）；端点填写 https://api.unifyllm.top，再粘贴 API Key。不要把 Key 写入截图、代码仓库或公开日志。
5
添加并选择模型
添加模型 claude-sonnet-4-6 或从“获取模型”列表中选择准确的模型 ID；如果模型列表为空，先检查端点、Key 和 /v1 是否重复。
6
启用供应商
点击启用并按 Claude Desktop 的要求重启工具。在「统一供应商」中新增 UnifyLLM，预设类型选择 NewAPI，启用 Claude Desktop，端点填写根地址，API 格式选择 Anthropic Messages 原生格式。每次切换后都要重启 Claude Desktop。

手动配置参考

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

1{ "inferenceProvider": "gateway", "inferenceGatewayBaseUrl": "https://api.unifyllm.top", "inferenceGatewayAuthScheme": "bearer", "inferenceGatewayApiKey": "<YOUR_API_KEY>" }

测试与排查

启用供应商后完全退出并重新打开 Claude Desktop，再发送一条简短消息。如果为非 Claude 模型开启模型映射，必须保持 CC Switch 运行并开启 Claude Desktop 本地路由。

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

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

CC Switch 官方参考

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

安全提醒

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

安装并打开 CC Switch

进入统一供应商

选择 NewAPI 预设

选择格式并填写端点

添加并选择模型

启用供应商