Skip to main content
CC-Switch 是一个桌面应用，用来统一管理 Claude Code、Codex、Gemini 等 AI 编程工具的 Provider 配置。接入 XRouter 后，你可以在图形界面里切换 Provider，不需要反复手动编辑各个工具的配置文件。
XRouter 控制台提供 CC-Switch 导入入口，用于生成 ccswitch:// 导入链接。导入后如需检查或调整配置，请以 CC-Switch 主界面中的 Provider 表单为准。

​
前置条件

  • 本机已安装 CC-Switch。
  • 本机已安装要使用的 CLI 工具，例如 Claude Code 或 Codex CLI。
  • 已在 XRouter 控制台创建 API Key。
  • 已从控制台模型页复制目标模型 ID。

​
安装 CC-Switch

Terminal

​
从 XRouter 控制台导入

在 XRouter 控制台的 API Keys 页面，选择一把 Key 后打开 CC-Switch 导入弹窗。
待补图片：XRouter 控制台里的 Import to CC Switch 弹窗，展示 Claude、Codex、Gemini 选择和模型选择。截图必须使用假 Key。
导入弹窗会让你选择： 点击打开 CC-Switch 后，CC-Switch 会导入对应 Provider。
待补图片：CC-Switch 桌面端 Provider 已导入并启用的界面。截图中需要隐藏本机用户名和不相关 Provider。

​
手动添加 Provider

如果一键导入不可用，也可以在 CC-Switch 里手动添加。
Claude Code 使用服务根地址，不追加 /v1/messages。
不同工具的 endpoint 不同：Claude Code 使用服务根地址；Codex 使用 OpenAI 兼容地址并带 /v1。不要混用。

​
切换 Provider

1

选择工具分组

在 CC-Switch 顶部选择目标工具，例如 Claude、Codex 或 Gemini。
2

选中 XRouter Provider

在 Provider 列表中选择你导入或手动创建的 XRouter Provider。
3

启用配置

点击启用或切换按钮。看到成功提示后，新的 Provider 会写入对应工具配置。
4

重启目标工具

Claude Code 通常开启新会话即可；Codex CLI 建议重新打开终端后再启动。

​
常见问题

确认本机已安装 CC-Switch，并且系统已经注册 ccswitch:// 协议。如果浏览器拦截外部应用打开，请允许打开 CC-Switch。
重启目标 CLI。Claude Code 请开启新会话；Codex CLI 请关闭当前会话，并重新打开终端后启动。
确认 API Key 以 sk- 开头，复制时没有多余空格，并到 XRouter 控制台确认 Key 状态正常。
检查 TOML 是否合法，wire_api 是否为 responses，base_url 是否带 /v1。