TeamoRouter接入 CC Switch

CC Switch 是一款开源的桌面应用,把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七个 AI 工具的供应商配置统一管在一个面板里。

一、安装 CC Switch

请安装 v3.16.5 及以上版本。

macOS 用户(推荐)通过 Homebrew 安装:

plaintext
brew install --cask cc-switch

或访问 CC Switch Releases 下载对应平台安装包:

  • macOS:.dmg / .zip
  • Windows:.msi 安装版 / Portable .zip 绿色版
  • Linux:.deb / .rpm / .AppImage

首次打开如被 macOS Gatekeeper 拦截,到「系统设置 → 隐私与安全性」点 「仍要打开」。

二、接入 Claude Code 命令行

从零安装 Claude Code:参考TeamoRouter 接入 Claude Code命令行

如果你已经装了 CC Switch 和 Claude Code,按以下步骤把 TeamoRouter 添加为 Claude Code 的供应商:

添加 TeamoRouter 供应商

  1. 打开 CC Switch,主界面顶部切到 Claude Code。

CC Switch Claude Code 标签

  1. 点击右上角 「橙色加号」 按钮,弹出 「添加新供应商」 对话框。
  2. 在 「预设供应商中」 找到 「TeamoRouter」(或直接搜索“TeamoRouter”)。

选择 TeamoRouter 预设供应商

  1. 填入你的API Key:

填写 TeamoRouter API Key

  1. 点击底部 「添加」 保存。

启用 TeamoRouter 供应商

回到主界面 Claude Code tab,在 TeamoRouter 供应商卡片上点 「启用」,并打开Claude Code,即可使用。

启用 TeamoRouter

三、接入 Claude Desktop

安装 Claude Desktop:访问 Claude Desktop 官网 下载对应平台版本:

  • macOS:下载 .dmg 双击安装;或 brew install --cask claude
  • Windows:下载 .exe 安装程序运行

如果你已经装了 CC Switch 和 Claude Desktop,按以下步骤把 TeamoRouter 添加为 Claude Desktop 的供应商:

添加 TeamoRouter 供应商

  1. 打开 CC Switch,主界面顶部切到 Claude Desktop tab。
  2. 点击右上角 「橙色加号」按钮,弹出 「添加新供应商」 对话框。
  3. 在 「预设供应商中」 找到 「TeamoRouter」(或直接搜索“TeamoRouter”)。

Claude Desktop 选择 TeamoRouter 供应商

  1. 填写API Key:

Claude Desktop 填写 API Key

  1. 点击右下角 「+ 添加」 保存。

启用 TeamoRouter 供应商

回到主界面 Claude Desktop tab,在 TeamoRouter 供应商卡片上点 「启用」。切换成功后会弹出提示:

切换成功,重启 Claude Desktop 后生效

Claude Desktop 启用 TeamoRouter

按提示完整重启 Claude Desktop 应用,即可使用。

四、接入 Codex

安装 Codex:参考接入 Codex

如果你已经装了 CC Switch 和 Codex,按以下步骤把 TeamoRouter 添加为 Codex 的供应商:

添加 TeamoRouter 供应商

  1. 打开 CC Switch,主界面顶部切到 Codex tab。
  2. 点击右上角 「添加供应商」,弹出 「添加新供应商」 对话框。
  3. 在 「预设供应商中」 找到 「TeamoRouter」(或直接搜索“TeamoRouter”)。

Codex 选择 TeamoRouter 供应商

  1. 填入基础字段:「API Key」——粘贴你在 TeamoRouter Dashboard 创建的 key
  2. 点击底部 「+ 添加」 保存。

启用 TeamoRouter 供应商

回到主界面 Codex tab,在 TeamoRouter 供应商卡片上点 「启用」。Codex 不支持热切换——重启你正在运行的 codex 终端进程才生效。

五、接入 Gemini CLI

暂不支持Gemini CLI的接入,全力开发中……

六、接入 OpenCode

参考TeamoRouter接入 OpenCode。暂时不支持通过CC Switch接入OpenCode。

七、接入 OpenClaw

参考TeamoRouter接入 OpenClaw

八、接入 Hermes Agent

安装 Hermes Agent:

如果你已经装了 CC Switch 和 Hermes Agent,按以下步骤把 TeamoRouter 添加为 Hermes 的供应商:

添加 TeamoRouter 供应商

  1. 打开 CC Switch,主界面顶部切到 Hermes tab。

  2. 点击右上角 「添加供应商」,弹出 「添加新供应商」 对话框。

  3. 填入字段:

    1. 「供应商标识」:teamorouter(只能小写字母/数字/连字符,会作为 config.yaml 中的供应商 key)
    2. 「供应商名称」:TeamoRouter
    3. 「官网链接」(可选):https://teamorouter.cn
    4. 「API 模式」:保持默认 OpenAI Chat Completions
    5. 「API 端点」:https://api.teamorouter.cn/v1
    6. 「API Key」:粘贴你在 TeamoRouter 控制台 创建的 key
  4. 「模型列表」:点 「获取模型列表」 自动拉取 TeamoRouter 可用模型,或点 「+ 添加模型」 手动填。每个模型至少填 「模型 ID」 + 「显示名称」(显示名称不能留空)。第一个模型会写入顶层 model.default,建议把 claude-opus-4-7 放第一位。

  5. 点击底部 「+ 添加」 保存。

启用 TeamoRouter 供应商

回到主界面 Hermes tab,在 TeamoRouter 供应商卡片上点 「启用」。CC-Switch 会把配置写入 Hermes 配置文件(默认 ~/.hermes/config.yaml,可在 CC Switch ⚙ 设置「Hermes 配置目录」覆盖)。完整退出并重启 hermes 进程 才生效。

在 Hermes 里切换到 TeamoRouter

回到终端执行:

plaintext
hermes setup

进入 「Select provider」 wizard,顶部提示 ↑↓ navigate ENTER/SPACE select ESC cancel,按以下操作:

  1. 用 ↑↓ 方向键翻到列表最底部(自定义 provider 会追加在内置列表后面),找到这一行:
plaintext
teamorouter (api.teamorouter.cn/v1) — 模型名
  1. 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样:
plaintext
→ (●) teamorouter (api.teamorouter.cn/v1) — 模型名   ← currently active

之后直接执行 hermes 进会话,即可使用。

准备好了?三步即可开始登录控制台 · 购买额度 · 创建 API Key
微信扫码加入交流群
遇到问题?微信扫码加入交流群
TeamoRouter接入 CC Switch · 帮助文档