> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teio.me/llms.txt
> Use this file to discover all available pages before exploring further.
# CC Switch
> CC Switch 是一个桌面应用，帮你统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 AI 编程工具的 API 配置。通过可视化界面一键切换供应商，不需要手动改配置文件。
>
> 一个很有特色的功能就是可以将模型转成另一个模型供Agent调用；例如可以将Deepseek转成Opus供Claude Code调用；
## 前置条件
开始之前，确保你已经完成以下两步：
* 已 [创建 API 密钥](/create-token)
* 已安装至少一个支持的 AI 编程工具（如 Claude Code、OpenCode 等）
## 安装 CC Switch
通过 Homebrew 安装（推荐）：
```bash theme={null}
brew install --cask cc-switch
```
或者手动下载安装包：
前往 [CC Switch Releases](https://github.com/farion1231/cc-switch/releases) 页面，下载最新的 `.dmg` 文件，双击打开后将应用拖入 Applications 文件夹即可。
如果下载速度较慢，可以使用 [7ED 静态加速](https://www.7ed.net/) 加速下载，具体使用方式请访问该页面查看。
前往 [CC Switch Releases](https://github.com/farion1231/cc-switch/releases) 页面，下载最新的 `.msi` 安装包，双击按提示完成安装。
如果下载速度较慢，可以使用 [7ED 静态加速](https://www.7ed.net/) 加速下载，具体使用方式请访问该页面查看。
## 启动
安装完成后打开 CC Switch，你会看到一个图形界面，所有配置都在这里完成，不需要手动编辑任何配置文件。
如果你之前手动配置过 `ANTHROPIC_API_KEY` 等环境变量，CC Switch 启动时会检测到这些变量并提示冲突。建议在系统环境变量或 shell 配置文件（如 `~/.zshrc`）中注释或删除这些旧配置，以 CC Switch 的配置为准，避免互相干扰。
CC Switch 会自动识别你已安装的 AI 编程工具，并按照每个工具要求的格式写入配置。你不需要了解各工具的配置文件在哪、格式是什么，CC Switch 都帮你处理好了。
## 添加 Teio 供应商
CC Switch 支持为每个工具单独配置供应商，也可以设置一个"统一供应商"让所有工具共用同一套配置。你可以选择在 Teio 站点一键跳转自动导入，也可以在 CC Switch 中手动填写。
推荐使用这种方式，全程不用手动复制 Key 和请求地址，几步就能完成配置。
**第一步：从密钥页发起跳转**
打开 Teio 站点的**密钥**页面，找到要导入的密钥，点击密钥右侧的下拉按钮，选择 **"CC Switch"**。
**第二步：填写供应商名称并选择模型**
CC Switch 启动后会自动打开导入面板，密钥的 API Key、请求地址、分组等信息已自动填好。你只需要补充供应商名称，并选择要使用的模型即可。
浏览器首次会弹出"是否允许打开 CC Switch"的提示，勾选"始终允许"即可避免以后重复确认。如果点击没有任何反应，请确认 CC Switch 已安装并至少启动过一次，让系统完成 URL Scheme 注册。
**第三步：确认导入**
核对信息无误后，点击"导入配置"完成添加。
导入成功后，新供应商会出现在对应工具的列表中，切换启用后即可在 AI 编程工具里开始使用。
在 CC Switch 中手动添加供应商，各工具的填写信息略有差异，按下面对应的标签页操作即可。
不同工具的配置字段名称可能略有差异，但填写逻辑完全一样：选预设、填标识、填名称、选择API格式、填 Key、填地址，保存即可。
选中 **Claude Code**，点击右上角的 **"+"** 按钮添加新供应商，按以下信息填写：
预设供应商：`自定义配置`
供应商名称：`Teio`
API Key：`你在 Teio 创建的 Claude 分组密钥`
请求地址：`https://teio.me`
填写完成后点击添加，CC Switch 会自动将配置写入 Claude Code 的配置文件。
选中 **Codex**，点击右上角的 **"+"** 按钮添加新供应商，按以下信息填写：
预设供应商：`自定义配置`
供应商名称：`Teio`
API Key：`你在 Teio 创建的 OpenAI 分组密钥`
请求地址：`https://teio.me/v1`
注意。必须要这里要有模型才能调用，否则会出现调用不了模型
填写完成后添加保存即可。
选中 **OpenCode**，点击右上角的 **"+"** 按钮添加新供应商，按以下信息填写：
预设供应商：`自定义配置`
供应商标识： `teio`
供应商名称：`Teio`
接口格式： `OpenAI Compatible`
API Key：`你在 Teio 创建的 OpenAI 分组密钥`
请求地址：`https://teio.me/v1`
获取模型列表 -> 添加模型 -> 选择模型 -> 设置模型名称
填写完成后点击保存即可。
选中 **OpenClaw**，点击右上角的 **"+"** 按钮添加新供应商，按以下信息填写：
预设供应商：`自定义配置`
供应商标识： `teio`
供应商名称：`Teio`
接口格式： `Anthropic Messages`
API Key：`你在 Teio 创建的 Claude 分组密钥`
请求地址：`https://teio.me`
获取模型列表 -> 添加模型 -> 选择模型 -> 设置模型名称
填写完成后点击保存即可。
选中 **Hermes**，点击右上角的 **"+"** 按钮添加新供应商，按以下信息填写：
预设供应商：`自定义配置`
供应商标识： `teio`
供应商名称：`Teio`
接口格式： `OpenAI Compatible`
API Key：`你在 Teio 创建的 OpenAI 分组密钥`
请求地址：`https://teio.me/v1`
获取模型列表 -> 添加模型 -> 选择模型 -> 设置模型名称
填写完成后点击保存即可。
## 常见问题
先确认以下几点：
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 编程工具，再试一次。
遇到其他问题？请参考 [常见问题](/faq)。