CC-Switch 配置管理

CC-Switch 是本机配置管理工具。本页介绍 Claude Code CLI 与 Codex CLI 的 RouteFast 配置；桌面应用与扩展的设置入口可能不同。

1. 安装与备份

从 farion1231/cc-switch 官方仓库 的 Releases 下载适合系统的安装包。不要从名称相似的镜像站下载，也无需按不明教程关闭系统安全校验。

先按本站 Claude Code 或 Codex CLI 教程安装对应客户端。CC-Switch 不会替你验证 RouteFast 余额、分组或全部模型能力。

添加配置之前，在 CC-Switch 中备份已有设置，并另外保存客户端现有配置。Claude Code 涉及 ~/.claude/settings.json；Codex 涉及 ~/.codex/config.toml 与可能含登录凭证的 auth.json。Windows 对应当前用户目录，设置了自定义配置目录时以实际路径为准。所有备份应当按凭证保护。

2. 分别添加两个配置

在对应应用页点击添加供应商，选择 Custom / 自定义配置。建议分别命名 RouteFast Claude 和 RouteFast GPT，不要用共享一把 Key 的通用供应商模板把两个分组混在一起。

项目	Claude Code CLI	Codex CLI
RouteFast Key 分组	Anthropic-Claude	OpenAI-ChatGPT
请求地址 / Base URL	https://api.routefast.ai	https://api.routefast.ai/v1
原生接口格式	Anthropic Messages	OpenAI Responses
示例模型 ID	claude-sonnet-5	gpt-5.6-terra
本地协议转换	本页不启用	本页不启用

这里的原生接口指 RouteFast 对客户端提供的协议，不代表绕过 RouteFast 直接调用官方服务。

使用原生接口，无需本地协议转换

RouteFast 提供 /v1/messages 和 /v1/responses 入口。按本页配置即可直连，无需额外开启 CC-Switch 的本地协议转换。

Claude Code：Messages 配置

在 Claude Code CLI 的自定义配置中，使用 RouteFast 的 Claude 分组密钥。若界面有认证字段选项，选择 ANTHROPIC_AUTH_TOKEN。可参考下面的 JSON 合并 env，不要同时保留不再使用的旧 ANTHROPIC_API_KEY：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.routefast.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-routefast-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

将占位符替换为真实密钥后，只保存在自己的配置中，不要分享含 Key 的截图或导入链接。模型需在该 Key 的列表中；不要把 Key 前面手动加上 Bearer。

Codex CLI：Responses 配置

在 Codex 的自定义供应商里填写 GPT 分组 Key、带 /v1 的地址和模型。若版本提供格式选项，选择原生 Responses，不选择需要本地路由的 Chat Completions。

CC-Switch 的官方添加指南使用 auth.json 管理 API Key，并在 config.toml 指向自定义 provider。这与本站手动教程的 env_key 注入是两种不同的凭证管理方式：选择其中一种，不要在同一个 provider 中混用。

采用 CC-Switch 管理凭证的方式时，检查其配置编辑器中的 API Key 对应 RouteFast GPT Key，生成的 TOML 核心字段应类似：

model_provider = "routefast"
model = "gpt-5.6-terra"

[model_providers.routefast]
name = "RouteFast.AI"
base_url = "https://api.routefast.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

此处 requires_openai_auth = true 是使用 Codex 的认证机制读取已配置 API Key，不是要求购买 ChatGPT 订阅。官方说明该开关开启时会忽略 env_key。不要把上一页环境变量模式的 env_key 再追加进来。Codex 官方认证说明

如果你已通过系统钥匙串、受管配置或自定义 CODEX_HOME 管理凭证，CC-Switch 写入的文件不一定是当前读取来源；先确认配置目录和 credential store，或继续使用 Codex 手动环境变量方式。不要通过删除已有登录文件来反复试错。

保持 provider ID 与 [model_providers.<ID>] 一致，顶层字段放在第一个 TOML 表之前。其他设置见 Codex 配置参考。

3. 启用并验证实际连接

1. 保存后，在对应供应商卡片点击 启用 / Enable；只保存不代表已选中。
2. 退出并重新启动对应 CLI，确保其读取新配置。不要在长任务执行途中切换。
3. Claude Code 内执行 /status，核对实际 Base URL、凭证来源和模型；Codex 内执行 /status，核对 provider 和模型。
4. 发送“只回复 OK，不调用工具”，确认完整回答，然后到 使用记录 核对时间、Key 和模型。这一步会产生实际用量。

CC-Switch 显示“已启用”、模型拉取成功或客户端显示价格，都不等于完整模型调用已成功。仅文本成功也不代表工具和长任务全部可用。

常见问题

现象	检查方法
保存后仍连旧平台	确认点击启用、读取的是同一个用户配置目录，并检查启动参数和环境变量残留
地址变成 127.0.0.1	检查是否仍处于原先的本地代理接管模式；本页直连 RouteFast 的步骤不依赖该模式
一退出 CC-Switch 就无法调用	检查是否依赖本地代理进程，而不是把 RouteFast 地址直接写入客户端
401 / 403	按响应检查凭证、分组、IP、有效期或余额，不能一律归因于余额不足
404 或模型不存在	核对 Responses / Messages 格式、重复 /v1、精确模型 ID 和 Key 分组
切换后费用不一致	本地统计不等于 sub2api 实付账单，按 计费与用量 核对

更多信息见 统一排障。排障时只提供脱敏配置和服务端响应请求 ID，不上传完整 CC-Switch 数据库。

恢复原配置

先停止正在运行的任务，在 CC-Switch 中启用原来的供应商，再重启 CLI 并用 /status 检查。若要恢复备份，先对照期间的其他修改，避免覆盖新增加的设置。删除 RouteFast 卡片、卸载 CC-Switch 或关闭窗口，都不能代替对实际配置的检查。

官方文档

• CC-Switch 添加供应商
• CC-Switch 切换供应商