主题
CC-Switch 一键接入(推荐)
CC-Switch 是一个桌面端 AI CLI 配置管理工具,可以在图形界面中统一管理 Claude Code、Codex 等客户端的供应商配置并一键切换,免去手动编辑配置文件的麻烦。
Chimney 的密钥管理页内置了 「导入到 CCS」 按钮,点击即可把密钥的完整配置(API 地址、密钥、默认模型)一键写入 CC-Switch,是最省事的接入方式。
第一步:安装 CC-Switch
text
打开 Release 页面,下载 .msi 安装包并安装:
https://github.com/farion1231/cc-switch/releases/latestbash
brew tap farion1231/ccswitch
brew install --cask cc-switchbash
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb安装后运行主程序。
📷 截图占位
ccs-01-main.png — CC-Switch 安装后的主界面
第二步:一键导入密钥
- 确保 CC-Switch 正在运行。
- 打开 密钥管理 页面,找到要使用的密钥(需已绑定分组)。
- 点击该密钥的 「导入到 CCS」 按钮。
- 浏览器会提示"是否打开 CC-Switch",确认后 CC-Switch 弹出导入确认窗口,点击确认即完成。
📷 截图占位
ccs-02-import-button.png — 密钥管理页中的「导入到 CCS」按钮 ccs-03-import-confirm.png — CC-Switch 弹出的导入确认窗口
第三步:启用供应商
在 CC-Switch 的供应商列表中找到刚导入的 Chimney,点击 启用。对应 CLI 的配置文件会自动写入,直接运行 claude / codex 即可使用。
📷 截图占位
ccs-04-enable.png — 在 CC-Switch 中启用导入的供应商
分组与客户端的对应关系
导入时 CC-Switch 会根据密钥分组的平台,自动写入对应客户端的配置:
| 密钥分组 | 导入到 |
|---|---|
| Claude | Claude Code |
| GPT Plus / GPT PRO | Codex |
| Grok号池 / Grok限时福利分组 | Claude Code(通过 Anthropic 协议调用 Grok) |
需要多个客户端时,为每个分组各建一个密钥,分别导入即可;在 CC-Switch 中可以一键切换当前使用的供应商。
手动添加(备选)
如果浏览器没有唤起 CC-Switch(如未安装协议关联),也可以在 CC-Switch 中手动添加供应商,各项参数见对应客户端的详细教程:
TIP
- 在密钥管理页切换了密钥的分组后,需要重新导入(或在 CC-Switch 中编辑对应供应商)。
- 重复点击导入会新增供应商而不是覆盖,可在 CC-Switch 中删除多余的。