# 在 CC Switch 中使用 BigModel.io

> 在控制台一键把 BigModel.io Key 导入 CC Switch，或为 Claude Code、Codex 手动添加服务商，并通过 /v1/usage 显示美元余额。

网页版: https://bigmodel.io/zh-cn/docs/cc-switch · 更新于 2026-10-18

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

| | CC Switch 中的 Claude Code | CC Switch 中的 Codex |
|---|---|---|
| 端点（endpoint） | `https://bigmodel.io`（不带 `/v1`） | `https://bigmodel.io/v1` |
| API Key | 你的 BigModel.io Key（`sk-...`） | 你的 BigModel.io Key（`sk-...`） |
| 模型 | [模型目录](https://bigmodel.io/zh-cn/models)中的模型 ID | 分组在 `/v1/responses` 上提供的模型 ID |
| 分组必须支持 | `/v1/messages` | `/v1/responses` |

## 在控制台一键导入

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

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

### 按钮生成的内容

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

| 参数 | 值 |
|---|---|
| `resource` | `provider` |
| `app` | 由 Key 所在分组的平台决定，见下表 |
| `name` | `BigModel.io` |
| `homepage`、`endpoint` | `https://bigmodel.io` |
| `apiKey` | 该行 Key 的完整内容 |
| `model` | `gpt-5.4`，仅当 `app` 为 `codex` 时携带 |
| `usageEnabled`、`usageScript`、`usageAutoInterval` | `true`、一段调用 `/v1/usage` 的脚本、`30` |

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

| 分组平台 | CC Switch 应用 |
|---|---|
| OpenAI | Codex（预设模型 `gpt-5.4`） |
| Gemini | Gemini CLI |
| Anthropic、GLM、DeepSeek 等其他平台 | Claude Code |

导入到 **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](https://bigmodel.io/zh-cn/docs/opencode)、[Cline](https://bigmodel.io/zh-cn/docs/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**：

```js
({
  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 在终端查询余额：

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

返回的 `remaining` 应与 CC Switch 显示一致。然后切换到该服务商，启动 `claude` 或 `codex` 发一个提示词，在[用量](https://bigmodel.io/usage)页确认出现这条请求。

## 常见问题排查

**提示 "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](https://bigmodel.io/zh-cn/docs/claude-code)：Claude Code 的全部变量与注意事项。
- [Codex CLI](https://bigmodel.io/zh-cn/docs/codex-cli)：Responses 接口要求。
- [用量 API](https://bigmodel.io/zh-cn/docs/api-usage)：`/v1/usage` 返回字段。
- [按 Key 限额与预算](https://bigmodel.io/zh-cn/docs/key-limits)：额度与消费窗口。