本页使用
/v1/models 返回的完整 供应商/模型 ID,例如 aliyun/kimi-k3。实际可选模型以 CC Switch 的“获取模型列表”和 HiLinkup 控制台为准。配置前准备
你需要准备:- 已安装并能打开 CC Switch
- HiLinkup API Key。
- HiLinkup 请求地址:
https://api.hilinkup.com/v1 - 至少一个支持 Claude Messages 兼容调用的模型。
- macOS / Linux
- Windows PowerShell
添加 HiLinkup 供应商

1
打开供应商管理
打开 CC Switch,在顶部应用切换器中选择 Claude Code。官方文档说明,应用切换器可在 Claude、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw、Hermes 等应用之间切换。
2
点击添加
点击右上角的
+,进入“添加新供应商”页面。3
选择添加方式
选择“应用专属供应商”。如果你的 CC Switch 版本支持“统一供应商”,也可以用统一供应商复用到多个应用;本页按 Claude Code 专属供应商说明。
4
填写基础信息
按下面填写:
5
确认认证字段
认证环境变量保持默认
ANTHROPIC_AUTH_TOKEN。CC Switch 会把你填写的 API Key 写入对应配置。6
保存供应商
点击“添加”或“保存”。回到供应商列表后,确认 HiLinkup 已出现在列表中。

请求地址填写兼容 Claude API 的服务端地址,不要以斜杠结尾。推荐使用
https://api.hilinkup.com/v1。获取模型列表并映射角色
添加供应商后,进入 HiLinkup 的“编辑供应商”页面。
1
获取模型列表
点击“获取模型列表”。CC Switch 官方文档说明,该功能会使用配置的 API Key 调用 OpenAI 兼容的
/v1/models 端点,并按类别显示模型下拉菜单。2
映射 Sonnet
在
Sonnet 行选择 /v1/models 返回的完整 ID,例如 aliyun/kimi-k3。3
映射 Opus
在
Opus 行选择你已验证支持 Claude Messages 和目标能力的完整模型 ID。首次配置也可以先使用 aliyun/kimi-k3。4
映射 Fable 和 Haiku
给
Fable、Haiku 选择接口实际返回且已验证可用的完整模型 ID。首次配置可先统一使用 aliyun/kimi-k3,连接成功后再分别调整。5
设置默认兜底模型
在“默认兜底模型”中选择一个稳定模型。未明确落到 Sonnet、Opus、Fable、Haiku 的请求会使用该模型。
6
保存配置
点击“保存”,再回到 CC Switch 供应商列表。
推荐映射示例
切换到 HiLinkup
1
回到供应商列表
在 CC Switch 首页找到
HiLinkup 供应商。2
切换默认供应商
选中 HiLinkup。确认列表中的当前供应商显示为
HiLinkup,请求地址显示为 https://api.hilinkup.com/v1。3
确认生效
CC Switch 官方文档说明,Claude Code 支持热重载,切换供应商后通常即时生效。如果你发现请求仍走旧供应商,再关闭并重新打开 Claude Code。
4
发送测试请求
在 Claude Code 中输入:
验证顺序
按下面顺序测试,不要一开始就跑复杂 Agent 任务:- 普通文本问答。
- 读取当前目录结构。
- 读取一个非敏感文件。
- 在临时目录或临时分支里执行一次小改动。
- 再测试长上下文、工具调用和多文件修改。
常见问题
获取模型列表失败
获取模型列表失败
检查 API Key 是否来自 HiLinkup,
请求地址 是否为 https://api.hilinkup.com/v1。如果浏览器或系统代理拦截请求,也可能导致列表为空。模型列表有模型,但 Claude Code 请求失败
模型列表有模型,但 Claude Code 请求失败
/v1/models 返回模型可用,不代表该模型一定支持 Claude Messages 兼容调用。请换成明确支持 Claude Code/Claude Messages 的模型,或先用 Claude Messages 的 cURL 示例验证。切换后仍然走旧供应商
切换后仍然走旧供应商
Claude Code 通常会热重载配置。若切换后仍然走旧供应商,先确认 HiLinkup 已被设为当前供应商;仍不生效时,再关闭并重新打开 Claude Code。
请求地址是否需要包含 /v1
请求地址是否需要包含 /v1
在 CC Switch 的供应商请求地址中推荐填写
https://api.hilinkup.com/v1。如果当前 CC Switch 版本明确提示“不要带 /v1”,填写 https://api.hilinkup.com;API 请求不要使用官网域名。模型映射怎么选
模型映射怎么选
先使用稳定模型:Sonnet 和默认兜底模型填同一个模型;Opus 填高能力模型;Fable、Haiku 填更快或成本更低的模型。上线后根据延迟、成本和成功率调整。