CC Switch 配置教程

CC Switch 是配置管理工具，也提供可选的本地路由与协议转换。安装 CC Switch 本身不会增加模型额度或改变 Noah 的分组权限。

本页按 4.0.x 界面说明，核对版本为 4.0.4（2026 年 10 月 8 日）。

1. 安装

从 官方 Releases 下载系统对应的包：

系统	常见安装包
Windows	MSI 安装包，或便携版 ZIP
macOS	对应芯片架构的 DMG
Linux	对应发行版包，或 AppImage

先安装需要使用的客户端：Codex 或 Claude Code。CC Switch 不代替客户端。

2. 理解模式

左侧栏选择应用，应用页面顶部可切换「直连 / 路由 / 聚合」。

模式	工作方式	本站教程用途
直连	写入客户端配置，客户端直接请求供应商	Codex → Noah Responses
路由	请求先经过 CC Switch 本机服务，可转换协议	Claude Code → Noah Responses
聚合	将多个供应商交给本地统一入口管理	初次接入无需配置

模式标签用于查看页面，实际模式切换需要执行「开始路由」「回到直连」等操作。要根据接口是否需要转换选择模式。

3. 为 Codex 添加 Noah

1. 在左侧栏选择 Codex，进入 直连。
2. 点击「添加供应商」→「自定义配置」。
3. 名称填写 Noah API，API Key 填写 Noah 令牌。
4. 请求地址填写 https://ai.11451418.xyz/v1。
5. 上游格式选择 Responses（原生）。
6. 默认模型设为 gpt-6.1-sol，在模型映射表添加对应模型。

模型映射表的最小一行：

菜单显示名	实际请求模型
gpt-6.1-sol	gpt-6.1-sol

上下文窗口和思考等级先不填未经确认的数值。CC Switch 会据此生成 Codex 的模型目录；新增模型或修改映射后需要重新启动 Codex，/model 菜单才会更新。

如果自定义页面显示配置编辑器，可将以下供应商配置合并到 config.toml 区域：

model = "gpt-6.1-sol"
model_provider = "noah"

[model_providers.noah]
name = "Noah API"
base_url = "https://ai.11451418.xyz/v1"
wire_api = "responses"

在 CC Switch 的 API Key / auth.json 编辑区域填写：

{
  "OPENAI_API_KEY": "YOUR_NOAH_API_KEY"
}

这里的「auth.json」是 CC Switch 保存的供应商数据字段。当前版本切到第三方供应商时，会把 Key 写入对应供应商的 experimental_bearer_token；它不是让你手动覆盖磁盘上的 ~/.codex/auth.json。

本页由 CC Switch 管理密钥，未使用手动教程中的 env_key 方式。不要把两套认证配置叠在一起。

4. 启用并验证 Codex

保存供应商，在直连模式启用 Noah。若先前已开启路由，执行 回到直连。

退出并重新启动 Codex，输入 /status 检查模型和供应商。发送简短问题后，查看 Noah 控制台请求日志。

Noah 的 Responses 模型可原生直连，不需要为了配置管理而开启协议转换。本机路由不开启时，请求由 Codex 直接发送到 Noah。

5. 为 Claude Code 配置 Noah

Claude Code 的原生协议是 Anthropic Messages，Noah 当前公开的是 OpenAI 接口，因此需要另建 Claude Code 供应商并开启路由转换。

关键字段：

项目	值
应用	Claude Code
地址	https://ai.11451418.xyz，不带 /v1
上游格式	OpenAI Responses API（需开启路由）
默认模型和三个档位映射	初次均设为 gpt-6.1-sol
使用模式	路由 → 开始路由 → 路由到此

按 Claude Code 完整教程 填写认证字段、模型映射并验证。不要直接复制 Codex 的带 /v1 地址，也不要只点击模式标签就以为路由已启动。

切换与配置冲突

CC Switch 切换供应商会更新客户端的实时配置。建议保留原供应商配置，确认 Noah 接入后再整理。

• Codex 切换后重新启动，模型目录在启动时加载。
• Claude 初次接管、切回直连或遇到旧会话仍使用旧地址时，新开会话验证。
• 如果终端里仍设置了其他供应商的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY，使用 CC Switch 的环境变量冲突检查功能，并在新终端核对 /status。
• Claude 用户设置中的 env、系统环境变量和项目设置都可能影响实际配置，以客户端显示的凭据来源和地址为准。
• 不要在 CC Switch 管理期间反复手改同一份供应商配置，后续切换可能覆盖手改内容。

路由模式下要保持本地服务运行。CC Switch 的请求统计和费用估算可用于排查，实际扣费以 Noah 控制台为准。

官方参考

• CC Switch 中文说明
• 添加供应商
• 切换供应商
• 环境变量冲突