在 CC Switch 中使用 BigModel.io

CC Switch 是一款桌面应用，用来在不同 API 服务商之间切换 Claude Code、Codex 等命令行工具。你可以在控制台点 导入到 CCS 按钮一键导入 BigModel.io Key，也可以手动添加服务商。一键导入需要 CC Switch v4.0.10 或更高版本。

#在控制台一键导入

1. 安装并打开 CC Switch。
2. 在 API Keys 找到对应 Key 的那一行，点击上传图标（导入到 CCS）。如果看不到这个按钮，说明本站关闭了该功能，请按下文手动配置。
3. 浏览器会询问是否打开 CC Switch。允许后，在 CC Switch 中确认导入。

只点一次。每点一次，CC Switch 中就会多一个服务商条目。

#按钮生成的内容

按钮会打开一个 ccswitch://v1/import 链接，参数如下：

服务商会创建到哪个应用，取决于分组平台：

导入到 Codex 后，除非你的分组确实提供 gpt-5.4，否则请把模型改成分组实际提供的模型。

GLM、DeepSeek 分组注意。 仅支持 Chat Completions 的分组（GLM 或 DeepSeek 平台）的 Key 会被导入为 Claude Code 服务商，但这些分组访问 /v1/messages 会返回 404，Claude Code 无法使用。Claude Code 请导入支持 Messages 的分组的 Key；仅 chat 的 Key 请改用 OpenCode、Cline 等 OpenAI 协议工具。

#余额显示

导入的服务商自带用量脚本。CC Switch 会用你的 Key 调用 https://bigmodel.io/v1/usage，以美元显示剩余额度：

• Key 设置了额度或消费窗口时，显示剩余额度；
• Key 属于套餐分组时，显示各项套餐限额中最小的剩余值；
• 其他情况显示账户余额。

Key 过期或额度用完时 /v1/usage 依然可用，余额显示也会继续更新。

#手动配置

#Claude Code

1. 在 CC Switch 侧边栏选择 Claude Code。
2. 点击 + Add Provider，选择 Custom。
3. 填入 API Key sk-... 和端点 https://bigmodel.io（不带 /v1）。
4. 设置模型，例如主模型 glm-5.3，快速 / haiku 模型 glm-5.3-flash。
5. 保存并切换到该服务商。

#Codex

1. 在侧边栏选择 Codex，点击 + Add Provider，选择 Custom。
2. 填入 API Key sk-... 和端点 https://bigmodel.io/v1。
3. 模型填分组在 /v1/responses 上提供的模型 ID。
4. 保存并切换。CC Switch 会在 ~/.codex/config.toml 中写入带 wire_api = "responses" 的 [model_providers.custom]。

#手动添加余额脚本

打开服务商的 Configure usage query（配置用量查询），启用后粘贴下面的脚本，点击 Test script：

({
  request: {
    url: "{{baseUrl}}/v1/usage",
    method: "GET",
    headers: { "Authorization": "Bearer {{apiKey}}" }
  },
  extractor: function(response) {
    const remaining = response?.remaining ?? response?.quota?.remaining ?? response?.balance;
    const unit = response?.unit ?? response?.quota?.unit ?? "USD";
    return {
      isValid: response?.is_active ?? response?.isValid ?? true,
      remaining,
      unit
    };
  }
})

如果测试显示请求发到了 /v1/v1/usage（端点以 /v1 结尾的 Codex 服务商），把 URL 改成 {{baseUrl}}/usage。

#验证配置

用同一个 Key 在终端查询余额：

curl https://bigmodel.io/v1/usage -H "Authorization: Bearer $BIGMODEL_API_KEY"

返回的 remaining 应与 CC Switch 显示一致。然后切换到该服务商，启动 claude 或 codex 发一个提示词，在用量页确认出现这条请求。

#常见问题排查

提示 "CC-Switch is not installed or the protocol handler is not registered"。 没有安装 CC Switch、版本低于 v4.0.10，或 ccswitch:// 链接被拦截。安装或升级后先打开一次，再点按钮；也可以复制 Key 手动配置。

点击后没有任何反应。 浏览器拦截了外部链接。允许其打开 CC Switch，或改为手动配置。

Claude Code 返回 404 not_found_error：... platform only supports /v1/chat/completions; /v1/messages is not available。 Key 来自 GLM 或 DeepSeek 分组，见上文注意事项。

Codex 返回 503 api_error：No available accounts: no available accounts supporting model: gpt-5.4。 导入时预设的模型不在你的分组中，在 Codex 服务商里修改模型。

所有请求都返回 404。 端点与应用不匹配：Claude Code 用 https://bigmodel.io，Codex 用 https://bigmodel.io/v1。

余额显示报错或为空。 在 Configure usage query 中运行 Test script，并查看 ~/.cc-switch/logs/cc-switch.log。401 INVALID_API_KEY 表示服务商里的 Key 填错或已删除。

出现两个一样的服务商。 导入链接被打开了两次，在 CC Switch 中删掉一个即可。

#相关文档

• Claude Code：Claude Code 的全部变量与注意事项。
• Codex CLI：Responses 接口要求。
• 用量 API：/v1/usage 返回字段。
• 按 Key 限额与预算：额度与消费窗口。