TeamoRouter接入 CC-Switch

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

一、安装 CC Switch：

macOS 用户（推荐）通过 Homebrew 安装：

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：参考 接入 Claude Code 如果你已经装了 CC Switch 和 Claude Code，按以下步骤把 TeamoRouter 添加为 Claude Code 的供应商：

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

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

1. 点击右上角 「添加供应商」 按钮，弹出 「添加新供应商」 对话框。
2. 在 「选择配置类型」 选 「自定义」（提示「手动配置供应商，需要填写完整的配置信息」）。
3. 填入基础字段：

• 「供应商名称」：TeamoRouter
• 「官网地址」（可选）：https://teamorouter.com
• 「API Key」：粘贴你在 TeamoRouter 控制台 创建的 key
• 「请求地址」：https://api.teamorouter.com

1. 展开 「高级选项」（默认是折叠的）：

• 「API 格式」： Anthropic Messages (原生)
• 「认证字段」：保持默认 ANTHROPIC_AUTH_TOKEN（默认），无需改动。
• 「模型映射」：点击获取模型列表，即可获取 TeamoRouter 可用的所有模型，按需添加。
• 需要使用 1M 长上下文的模型勾选对应行的 「1M」 标志（界面文案「声明支持 1M」）。

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

在 Claude Code tab 启用 TeamoRouter

回到主界面 Claude Code tab，在 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
• 「API Key」：粘贴你在 TeamoRouter 控制台 创建的 key
• 「请求地址」填 https://api.teamorouter.com

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

启用 TeamoRouter 供应商

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

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

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

四、接入 Codex

安装 Codex：参考 接入 Codex 如果你已经装了 CC Switch 和 Codex，按以下步骤把 TeamoRouter 添加为 Codex 的供应商：

在 CC Switch 里添加供应商

1. 打开 CC Switch，主界面顶部切到 Codex tab。
2. 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
3. 填入基础字段：

1. 「供应商名称」：TeamoRouter
2. 「官网链接」（可选）：https://teamorouter.com
3. 「API Key」：粘贴你在 TeamoRouter Dashboard 创建的 key
4. 「API 请求地址」：https://api.teamorouter.com/v1
5. 「模型名称」：保持默认 gpt-5.4，或通过获取模型列表来使用 TeamoRouter 上其它模型。
6. 「API 格式」：保持默认 OpenAI Responses API (原生)。
7. 点击底部 「+ 添加」 保存。

启用 TeamoRouter 供应商

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

五、接入 Gemini CLI

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

六、接入 OpenCode

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

七、接入 OpenClaw

参考 接入 OpenClaw。

八、接入Hermes Agent

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

在 CC Switch 里添加供应商

1. 打开 CC Switch，主界面顶部切到 Hermes tab。
2. 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
3. 填入字段：
4. 「供应商标识」：teamorouter（只能小写字母/数字/连字符，会作为 config.yaml 中的供应商 key）
5. 「供应商名称」：TeamoRouter
6. 「官网链接」（可选）：https://teamorouter.com
7. 「API 模式」：保持默认 OpenAI Chat Completions。
8. 「API 端点」：https://api.teamorouter.com/v1
9. 「API Key」：粘贴你在 TeamoRouter 控制台 创建的 key
10. 「模型列表」：点 「获取模型列表」 自动拉取 TeamoRouter 可用模型，或点 「+ 添加模型」 手动填。每个模型至少填 「模型 ID」 + 「显示名称」（显示名称不能留空）。第一个模型会写入顶层 model.default，建议把 claude-opus-4-7 放第一位。
11. 点击底部 「+ 添加」 保存。

启用 TeamoRouter 供应商

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

在 Hermes 里切换到 TeamoRouter

回到终端执行：

hermes setup

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

1. 用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：

teamorouter (api.teamorouter.com/v1) — 模型名

1. 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样：

→ (●) teamorouter (api.teamorouter.com/v1) — 模型名   ← currently active

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