CC-Switch 接入 XRouter

CC-Switch 是一个桌面应用，用来统一管理 Claude Code、Codex 等 AI 编程工具的 Provider 配置。接入 XRouter 后，你可以在图形界面里添加供应商，并在不同 Provider 之间切换，不需要手动编辑各个工具的配置文件。

本页按 CC-Switch 的图形界面配置流程编写。XRouter 控制台里的一键导入入口只用于辅助填充；如果需要检查或调整配置，请以 CC-Switch 主界面中的 Provider 表单为准。

准备工作

在开始之前，请确认：

本机已安装要使用的 CLI 工具，例如 Claude Code 或 Codex CLI。
已在 XRouter 控制台创建 API Key，格式通常为 sk-...。
你知道要使用的模型名。模型名以 XRouter 控制台模型页为准。

第一步：安装 CC-Switch

macOS
Windows
Linux

推荐通过 Homebrew 安装：

Terminal

brew tap farion1231/ccswitch
brew install --cask cc-switch

也可以从 CC-Switch 的 GitHub Releases 下载 .dmg 安装包。

从 CC-Switch 的 GitHub Releases 下载 .msi 安装包或便携版 .zip，安装后启动应用。

从 CC-Switch 的 GitHub Releases 下载适合发行版的安装包：

Debian / Ubuntu：.deb
Fedora / RHEL：.rpm
通用格式：.AppImage
Arch Linux：paru -S cc-switch-bin

首次打开 CC-Switch 时，它会检测本机已安装的 CLI 工具，并可导入已有配置作为默认 Provider。

第二步：添加 XRouter Provider

CC-Switch 主界面顶部可以切换不同工具分组。请选择你要配置的工具，然后按对应表单填写 XRouter 信息。

Claude Code
Codex

切换到 Claude Code 分组

在 CC Switch 主界面顶部选择 Claude Code。

打开添加 Provider 面板

点击主界面右上角的 + 按钮，进入添加 Provider 表单。

填写 Provider 信息

按下面字段填写：

字段	填写内容	说明
Name	`XRouter`	Provider 显示名称，可自定义
Endpoint URL	`https://api.xrouter.dev`	Claude Code 使用 Anthropic Messages 入口，不带 `/v1`
API Key	`sk-your-api-key`	XRouter API Key
API Format	`Anthropic Messages`	保持 Anthropic 原生格式
Model	`claude-sonnet-4-5-20250929`	示例模型，请以控制台可用模型为准

保存配置

点击 Add 保存。保存后，XRouter 会出现在 Claude Code Provider 列表中。

切换到 Codex 分组

在 CC Switch 主界面顶部选择 Codex。

打开添加 Provider 面板

点击主界面右上角的 + 按钮，进入添加 Provider 表单。

填写 auth.json 配置块

在 auth.json 配置块中填入 XRouter API Key：

auth.json

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

填写 config.toml 配置块

在 config.toml 配置块中新增 XRouter 供应商：

config.toml

model = "gpt-5.3-codex"
model_provider = "xrouter"

[model_providers.xrouter]
name = "XRouter"
base_url = "https://api.xrouter.dev/v1"
wire_api = "responses"
requires_openai_auth = true

保存配置

为 Provider 命名为 XRouter，点击 Add 保存。CC-Switch 会校验 JSON 与 TOML 格式。

不同工具使用的 endpoint 不同：Claude Code 使用 https://api.xrouter.dev；Codex 使用 OpenAI 兼容地址 https://api.xrouter.dev/v1。不要混用。

第三步：切换 Provider

添加完成后，可以在 CC-Switch 中随时切换到 XRouter。

在主界面切换

选择工具分组

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

选中 XRouter Provider

在 Provider 列表中选择 XRouter。

启用配置

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

通过系统托盘切换

CC-Switch 会常驻系统托盘。你也可以点击托盘图标，在菜单中直接选择 XRouter Provider。

Claude Code 通常新会话即可应用新配置；Codex 切换后建议重启终端或重新启动 Codex CLI。

常见问题

切换 Provider 后没有生效

Claude Code 请开启新会话或重启 Claude Code。Codex 请关闭当前 Codex 会话，并重新打开终端后启动。

提示 API Key 无效

确认 API Key 以 sk- 开头，且复制时没有多余空格。再到 XRouter 控制台确认密钥状态、额度和可用分组。

添加 Codex Provider 时提示格式错误

检查 auth.json 是否是合法 JSON，config.toml 是否是合法 TOML。不要使用中文引号；wire_api 应设置为 responses。

CC-Switch 会修改哪些文件

CC-Switch 会写入对应工具的本地配置。Claude Code 通常写入 ~/.claude/settings.json；Codex 会写入 ~/.codex/config.toml 和 ~/.codex/auth.json。切换前会自动备份。

​准备工作

​第一步：安装 CC-Switch

​第二步：添加 XRouter Provider

​第三步：切换 Provider

​在主界面切换

​通过系统托盘切换

​常见问题

准备工作

第一步：安装 CC-Switch

第二步：添加 XRouter Provider

第三步：切换 Provider

在主界面切换

通过系统托盘切换

常见问题