Skip to main content
CC Switch 是一个桌面应用，帮你统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的 API 配置。通过可视化界面一键切换供应商，不需要手动改配置文件。 一个很有特色的功能就是可以将模型转成另一个模型供Agent调用；例如可以将Deepseek转成Opus供Claude Code调用；

​
前置条件

开始之前，确保你已经完成以下两步：
  • 已 创建 API 密钥
  • 已安装至少一个支持的 AI 编程工具（如 Claude Code、OpenCode 等）

​
安装 CC Switch

通过 Homebrew 安装（推荐）：
brew install --cask cc-switch
或者手动下载安装包：前往 CC Switch Releases 页面，下载最新的 .dmg 文件，双击打开后将应用拖入 Applications 文件夹即可。
如果下载速度较慢，可以使用 7ED 静态加速 加速下载，具体使用方式请访问该页面查看。

​
启动

安装完成后打开 CC Switch，你会看到一个图形界面，所有配置都在这里完成，不需要手动编辑任何配置文件。
如果你之前手动配置过 ANTHROPIC_API_KEY 等环境变量，CC Switch 启动时会检测到这些变量并提示冲突。建议在系统环境变量或 shell 配置文件（如 ~/.zshrc）中注释或删除这些旧配置，以 CC Switch 的配置为准，避免互相干扰。
Macshot Clipboard B2645F5C 8CE2 4672 8868 BAE38E22C781
CC Switch 会自动识别你已安装的 AI 编程工具，并按照每个工具要求的格式写入配置。你不需要了解各工具的配置文件在哪、格式是什么，CC Switch 都帮你处理好了。

​
添加 Teio 供应商

CC Switch 支持为每个工具单独配置供应商，也可以设置一个”统一供应商”让所有工具共用同一套配置。你可以选择在 Teio 站点一键跳转自动导入，也可以在 CC Switch 中手动填写。
推荐使用这种方式，全程不用手动复制 Key 和请求地址，几步就能完成配置。第一步：从密钥页发起跳转打开 Teio 站点的密钥页面，找到要导入的密钥，点击密钥右侧的下拉按钮，选择 “CC Switch”。
Macshot Clipboard 38A2C7F3 23E3 4F0E A2FC 85D6102DDEFB
第二步：填写供应商名称并选择模型CC Switch 启动后会自动打开导入面板，密钥的 API Key、请求地址、分组等信息已自动填好。你只需要补充供应商名称，并选择要使用的模型即可。
Macshot Clipboard A88835C9 30A7 4575 ACCC 9D60EF3C91F8
浏览器首次会弹出”是否允许打开 CC Switch”的提示，勾选”始终允许”即可避免以后重复确认。如果点击没有任何反应，请确认 CC Switch 已安装并至少启动过一次，让系统完成 URL Scheme 注册。
第三步：确认导入核对信息无误后，点击”导入配置”完成添加。
Macshot Clipboard 1B215ABD 7860 4DC9 A356 1AE0F8E5AEF9
导入成功后，新供应商会出现在对应工具的列表中，切换启用后即可在 AI 编程工具里开始使用。
Macshot Clipboard 30112173 EC19 47C8 8149 75D2189AFB72

​
常见问题

先确认以下几点：
  1. 供应商添加后，是否已在工具列表中启用该供应商（切换到对应供应商）
  2. API Key 是否填写正确，注意不要有多余的空格
  3. 请求地址是否填写正确，Claude Code 填 https://teio.me，其他 OpenAI 兼容工具填 https://teio.me/v1
  4. 密钥是否选对了分组，Claude Code 用 Claude 分组密钥，Codex / OpenCode / Hermes 用 OpenAI 分组密钥
如果你之前在 ~/.zshrc、~/.bashrc 或系统环境变量中设置过 ANTHROPIC_API_KEY 等变量，CC Switch 的配置会被覆盖。建议注释或删除这些旧变量，重启终端后再试。
部分工具需要重启才能读取新配置。保存后关闭并重新打开对应的 AI 编程工具，再试一次。
遇到其他问题？请参考 常见问题。