博客

EN

打造满血版 AI 编程环境：CC Switch 安装与 TeamoRouter 配置教程

CC Switch 一站式管理 Claude Code、Codex、Gemini CLI 等 Agent 配置，支持 API 路由热切换。本文手把手教你安装 CC Switch，并接入原生适配 Agent 场景的 LLM 统一网关 TeamoRouter，规避缓存失效导致的账单暴涨。

· cc-switch · claude-code · api-gateway

CC Switch（ccswitch.io）是一款专为重度 AI 编程用户打造的开源桌面端统管工具。它可以跨平台一站式管理 Claude Code、Codex、Gemini CLI、OpenClaw 等主流 Agent 产品的配置，支持 API 路由热切换、自动容灾及多应用 Session 共享。

然而，在 Agent 时代，API 渠道的质量直接决定了你的账单厚度和代码成功率。市面上许多主打「1 折」的普通中转站，往往因为底层采用账号池轮转机制，导致提示词缓存（Prompt Caching）几乎失效。由于 Agent 每一轮对话都会重发长串上下文，没有缓存的 API 会让你的 Token 消耗量暴涨 10 倍，最终实际账单比官方原价还贵。

为了真正发挥 CC Switch 的威力，我们需要接入原生适配 Agent 场景的 LLM 统一网关 —— TeamoRouter。

为什么 Agent 必须搭配 TeamoRouter？

在开始配置之前，了解基础设施的差异能帮你规避巨大的隐性成本：

  • 真正的极致性价比（缓存命中率 >99%）： TeamoRouter 依托高优渠道和底层优化，在压测中能实现极高的缓存命中率（命中缓存读取价格仅为全价的 10%）。结合平台低至 1-2 折的实时浮动费率，能让每一个 Token 都花在刀刃上。
  • 100% 兼容 Agent 协议： 完美打平 Claude Code、Codex 的全部高级特性（如 Tool Calling 和各类 Beta 特性）。少一个细节，Agent 的某个能力就会静默失灵。
  • 企业级高并发与高可用（SLA 99.6%）： 提供高达 5000 QPM、千万级 TPM 并发量，首字延迟（TTFT）接近直采级别。当你去睡觉，让 Agent 独自重构代码一整晚时，你需要的是一条绝对稳定、不降智的「大动脉」。

CC Switch 安装与配置指南

1. 获取 TeamoRouter API 凭证：为 Agent 获取稳定的动力源

  1. 访问 TeamoRouter 官网（https://teamorouter.com）。
  2. 注册并登录控制台面板。
  3. 在管理后台生成你的专属 API Key，并记录下官方的 Base URL。
  4. 企业版福利（可选）： 如果你是企业用户，可在后台申请开通企业版套餐，享受额外 95 折、多级权限与预算管理，并支持公对公转账与增值税专票。

2. 下载并安装 CC Switch：支持主流桌面操作系统

前往 CC Switch 官网（ccswitch.io）或其 GitHub Releases 页面获取最新版本。

  • Windows 用户： 下载 .msi 或 .exe 安装包，双击运行并按照向导完成安装。
  • macOS 用户： 推荐使用 Homebrew 进行一键安装与更新：
brew tap farion1231/ccswitch
brew install --cask cc-switch
  • Linux 用户： 官方提供 .deb、.rpm 或 AppImage 格式，Arch Linux 用户也可通过 paru -S cc-switch-bin 进行安装。

3. 在 CC Switch 中添加 TeamoRouter：将其设为全局供应商

  1. 启动 CC Switch 桌面应用。
  2. 在左侧导航栏点击 Provider Management（供应商管理）。
  3. 点击 Add Provider（添加供应商），选择自定义 OpenAI 兼容格式或 Anthropic 格式。
  4. 填入你在第一步中获取的参数：
    • Name： 建议命名为 TeamoRouter
    • Base URL： 填入 TeamoRouter 提供的网关地址。
    • API Key： 填入你的专属密钥。
  5. 点击保存。CC Switch 内置的 Provider 健康检查会自动验证该节点是否通畅。

4. 将请求路由切换至 TeamoRouter：应用配置并开始 Vibe Coding

  1. 在 CC Switch 顶部导航栏，选择你正在使用的 Agent 工具（例如：Claude Code、Codex 或 OpenCode）。
  2. 在该工具的具体配置页面中，通过可视化下拉菜单，将默认 Provider 切换为你刚刚添加的 TeamoRouter。
  3. 生效机制： 对于 Claude Code，CC Switch 支持热切换，立即生效；对于其他多数 CLI 工具，请在终端中重启该工具以加载新的环境变量和配置。

如果你想跳过桌面端、直接在命令行里把 Claude Code 接到 TeamoRouter，可参考 Claude Code 接入教程；想了解中转站与直连网关的差别，可看 Claude Code 中转站推荐与避坑指南。

常见问题（FAQ）

我已经有一个便宜的中转站了，换成 TeamoRouter 真的有区别吗？

区别巨大。普通中转站最大的陷阱是标价便宜，但没有缓存。Agent 工作流极度依赖长上下文的循环提交，失去官方级别的 Prompt Caching 支持，会导致你的 Token 消耗量暴增十几倍。TeamoRouter 通过自建品控体系，屏蔽了灰产供应商，保障超高缓存命中率，帮你实现真正的「低成本闭环」。

TeamoRouter 适合团队和企业使用吗？

非常适合。TeamoRouter 专为追求效率的企业和专业人士打造。内置了免费的可视化企业管理后台，可以配置部门与人员的权限，进行精细化的预算控制和数据审计。此外，企业用户在高峰期享有更高的路由优先级，确保业务不中断。

配置好之后，我可以在多台设备上同步 CC Switch 吗？

可以。CC Switch 支持将所有供应商配置、MCP 服务器设置和应用偏好打包导出备份。你只需在一台电脑上配置好 TeamoRouter 及其依赖，导出配置文件并在新电脑上导入即可。

打造满血版 AI 编程环境：CC Switch 安装与 TeamoRouter 配置教程 · TeamoRouter