CC-Switch 一键配置教程（新手推荐）

新手推荐首选！

CC-Switch 是专为零基础用户设计的一键配置工具——无需手动改配置文件，图形化界面操作，十几秒完成渠道切换。

配置步骤

1. 下载并安装 CC-Switch

• Windows：前往 CC-Switch GitHub Releases 下载 .msi 安装包
• macOS（Homebrew）：

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

• Linux：Releases 页面下载 .deb 包安装

下载后在本地完成安装。

2. 打开软件，选择要配置的 CLI

启动 CC-Switch，在主界面选择你要配置的工具（如 Claude Code、Codex 等），然后点击「添加供应商」进行配置。

3. 填写供应商信息

• 供应商名称：填写 NextHub
• 请求地址：Claude Code 填 https://api.nexthub.cc；Codex 填 https://api.nexthub.cc/v1
• API 格式：根据你选择的 CLI 类型进行配置
• API Key：填写你在控制台生成的密钥

请求地址要不要带 /v1？

Claude Code 走 Anthropic 协议，会自动在地址后拼接 /v1/messages，填裸域即可；Codex 走 OpenAI Responses 协议（/v1/responses），请求地址需要带 /v1。

填写完成后，点击右下角「添加」按钮保存配置。

4. 确认渠道已生效

回到主界面，查看当前使用的渠道，确保已切换到你刚配置的 NextHub 渠道。

5. 跳过 Claude Code 初次安装确认（可选）

在主界面点击「设置」按钮，进入通用设置页面，找到「跳过 Claude Code 初次安装确认」，确保这项是打开的。

6. 终端运行验证

打开终端，运行 claude 或 codex 进行简单对话，查看配置是否正常。能收到回复就说明配置成功了 🎉

claude

也能配置 Claude Desktop

CC-Switch 自带 Claude Desktop 面板，支持一键导入 Claude Code 里已有的供应商，切换后记得彻底重启 Claude Desktop。详细步骤见 Claude Desktop 配置教程。

CC-Switch 功能亮点

一键切换 API 配置、可视化配置管理、MCP 服务器管理、系统托盘快捷操作、本地代理支持热切换、全自动渠道故障转移。