CCSwitch 接入优芯中转站

CCSwitch 的核心作用是管理 Claude / Claude Code 相关配置，并在不同服务商之间切换。接入优芯时，把优芯当作一个 Anthropic / Claude 兼容中转站 配置即可。

前置条件

开始前先准备：

1. 已登录优芯用户平台。
2. 已在 API Hub 创建 API Key。
3. API Key 所在分组支持 Claude / Anthropic 兼容入口。
4. 钱包余额或订阅额度可用。

推荐配置

在 CCSwitch 中新增一个自定义服务商或自定义 Claude 服务，填入：

配置项	填写内容
名称	优芯中转站
API 类型	Anthropic / Claude / Claude Compatible
Base URL	https://api.yucpu.com
Messages URL	https://api.yucpu.com/v1/messages
API Key	你在 API Hub 创建的 Key
Header	Authorization: Bearer sk-your-api-key

如果 CCSwitch 只提供一个 Base URL 输入框，通常填：

https://api.yucpu.com

如果 CCSwitch 要求填写完整接口地址，填：

https://api.yucpu.com/v1/messages

Header 怎么填

优先使用 Bearer 认证：

Authorization: Bearer sk-your-api-key

如果 CCSwitch 的界面只提供 API Key 输入框，没有 Header 编辑区域，直接填入：

sk-your-api-key

如果它要求使用 Anthropic 风格的 Header，也可以填：

x-api-key: sk-your-api-key

模型怎么选

模型名称以 API Hub 的 渠道状态 页面为准。常见 Claude 兼容模型会类似：

claude-sonnet-4-5
claude-opus-4-5

如果 CCSwitch 有默认模型配置，建议先选择 Sonnet 系列模型作为默认值。确认能正常调用后，再按需求切换到其他模型。

验证是否接通

配置完成后，在 CCSwitch 中发起一次简单请求。如果请求成功，API Hub 的 用量明细 会出现一条记录。

也可以用 curl 直接验证同一个 Key：

curl https://api.yucpu.com/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 128,
    "messages": [
      { "role": "user", "content": "回复 pong" }
    ]
  }'

常见配置错误

把文档域名填成接口地址

错误：

https://docs.yucpu.com

正确：

https://api.yucpu.com

Base URL 多写了路径

如果 CCSwitch 会自动拼接 /v1/messages，Base URL 应该只填：

https://api.yucpu.com

如果你填成：

https://api.yucpu.com/v1/messages

客户端可能会请求到：

https://api.yucpu.com/v1/messages/v1/messages

这会导致 404 或接口不匹配。

API Key 没带 Bearer

如果界面要求填写完整 Header，需要写：

Authorization: Bearer sk-your-api-key

不要只写：

Authorization: sk-your-api-key

没有用量记录

如果 CCSwitch 显示失败，API Hub 里没有任何用量记录，说明请求大概率没有到达优芯。优先检查 Base URL、网络代理、请求路径和 Header。

如果 API Hub 有失败记录，再根据记录中的模型、端点和错误信息排查。