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 的供应商:

在 CC Switch 里添加 Claude Code 命令行自定义供应商

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

CC Switch Claude Code 标签

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

选择 TeamoRouter 预设供应商

  1. 填入你的API Key:

填写 TeamoRouter API Key

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

在 Claude Code tab 启用 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 的供应商:

在 CC Switch 里添加供应商

  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 的供应商:

在 CC Switch 里添加供应商

  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 的供应商:

在 CC Switch 里添加供应商

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

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

  3. 填入字段:

    1. 「供应商标识」:teamorouter(只能小写字母/数字/连字符,会作为 config.yaml 中的供应商 key)
    2. 「供应商名称」:TeamoRouter
    3. 「官网链接」(可选):https://teamorouter.com
    4. 「API 模式」:保持默认 OpenAI Chat Completions
    5. 「API 端点」:https://api.teamorouter.com/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.com/v1) — 模型名
  1. 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样:
plaintext
→ (●) teamorouter (api.teamorouter.com/v1) — 模型名   ← currently active

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

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