接入指南
CC Switch
一个桌面应用,集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的服务商配置:可视化增删、一键切换,省去手改各家配置文件。
- 01
安装
到 CC Switch 的官方 GitHub(farion1231/cc-switch)Releases 按系统下载安装。它完全免费开源——近期出现假冒的收费网站,认准官方仓库,别在任何要求付费或登录的「CC Switch」站点填信息。
- 02
新增 XylemNode 服务商
点右上角 + 打开新增面板。XylemNode 是可跨工具复用的 OpenAI 兼容服务,推荐用「通用服务商 / Universal Provider」:填好下面三项,再勾选要同步的工具(Claude Code / Codex / Gemini)。接口地址填到域名即可,CC Switch 会按各工具自动补 /v1 等路径。
- 名称
XylemNode- 接口地址
https://api.xylemnode.com- API Key
sk-你的密钥
- 03
拉取并选择模型
地址和密钥填好后,点模型框旁的「拉取模型 / Fetch Models」,它会用你的密钥调 /v1/models 自动拉列表,选中要用的模型(如 gpt-5.6-sol);拉不到就手动填模型名。
- 04
保存并启用
通用服务商可点「保存并同步」一次性写入所有勾选的工具;随后在服务商卡片上点「启用」切到 XylemNode。之后用系统托盘就能在各工具间快速切换。
两点说明
① 接口地址填到域名即可,CC Switch 默认按各工具自动补 /v1、/chat/completions 等路径;若某工具路径不标准,在高级选项里开「完整 URL 模式」手填完整地址。 ② 也可以不用通用服务商,而是切到具体工具(如 Codex)单独新增;预设里没有 XylemNode 时,选「自定义 / OpenAI Compatible」即可。
常见问题
CC Switch 里切了服务商,工具还在用旧的?
官方手册给了两个方向。其一是工具没重新读配置:Claude Code 要关掉再重开终端、或重启 IDE,Codex 同样要重开终端,而 Gemini 从托盘切换是即时生效、不用重启。其二是环境变量在跟你抢——环境变量的优先级高于配置文件,所以你以前手工设过的 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、OPENAI_API_KEY 会盖掉 CC Switch 写进配置文件的值,请求就发去了旧地址。CC Switch 自己会检测这种冲突并在界面顶部弹黄色横幅,展开后可勾选删除,删除前会自动备份到 ~/.cc-switch/env-backups/;也可以自己去系统环境变量或 shell 配置文件里清掉。照本页 Codex、Gemini CLI 两节用环境变量配过 XylemNode 的,装上 CC Switch 后基本都会撞上这一条。