跳转到主要内容
🎉 限时免费 — MiniMax: MiniMax M3 Free 现在体验 🔥

CC Switch

CC Switch 是桌面端配置管理工具，可以统一管理 Claude Code、Codex、Gemini、OpenCode、OpenClaw 等工具的 Provider。下面以 Claude Code 为例，将 ModelGo 添加到 CC Switch 并启用。

接入前准备

  • 已安装 CC Switch，并能正常打开。
  • 已安装 Claude Code，并至少启动过一次。
  • 已在 ModelGo 控制台创建或复制 API Key。
  • 已在模型广场确认当前 API Key 可调用的逻辑模型名。

1. 打开 Claude Code 配置

打开 CC Switch，在顶部选择 Claude，点击右侧的 + 新增配置。

CC Switch 主界面
在 CC Switch 中添加 Claude 配置

2. 添加 ModelGo Provider

在配置编辑器中粘贴下面的 JSON。将 你的模型名 替换为模型广场中的逻辑模型名，将 sk-你的token 替换为 ModelGo API Key：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的token",
    "ANTHROPIC_BASE_URL": "https://api.modelgo.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "API_TIMEOUT_MS": 600000,
    "ANTHROPIC_MODEL": "你的模型名",
    "ANTHROPIC_SMALL_FAST_MODEL": "你的模型名"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
在 CC Switch 中编辑 ModelGo 配置

如果你的 CC Switch 版本支持环境变量占位符，可以将 Token 改为 {env:MODELGO_API_KEY}，并在启动 Claude Code 的终端中设置：

bash
export MODELGO_API_KEY="sk-你的token"

Windows PowerShell：

powershell
$env:MODELGO_API_KEY = "sk-你的token"

配置项说明：

配置项ModelGo 填写内容
ANTHROPIC_AUTH_TOKENModelGo 控制台创建的 API Key
ANTHROPIC_BASE_URLhttps://api.modelgo.com
ANTHROPIC_MODEL模型广场中的逻辑模型名
ANTHROPIC_SMALL_FAST_MODEL同一个可调用的逻辑模型名

3. 保存并启用

填写 Provider 名称 ModelGo 后点击 Add 或 Save。回到 Claude 配置列表，选中 ModelGo 配置并启用。

在 CC Switch 中添加 ModelGo Provider
在 CC Switch 中启用 ModelGo 配置

启动 Claude Code：

bash
claude

输入一条简单任务，例如“用三句话介绍这个项目”。能够正常返回结果，即表示接入成功。

4. 验证配置

如果需要单独验证 API Key 和模型，可执行：

bash
curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

返回结果中的 id 即可作为 ANTHROPIC_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL 的逻辑模型名。

常见问题

返回 401 或认证失败

确认 Token 是有效的 ModelGo API Key，且当前 CC Switch 配置没有残留的旧 Token。复制 Token 时不要带空格或换行。

返回 404 或找不到接口

确认 ANTHROPIC_BASE_URL 为 https://api.modelgo.com，不要填写 https://api.modelgo.com/v1/messages 或完整请求路径。

模型不可用

确认模型名与模型广场中的逻辑模型名完全一致，并检查该模型是否已对当前 API Key 开通。

修改后 Claude Code 仍使用旧配置

在 CC Switch 中确认 ModelGo 配置已启用，然后完全退出并重新打开终端，再运行 claude。

相关文档