CC Switch

CC Switch 是管理 AI 编程工具配置的桌面软件。你可以用它保存服务商地址、模型和密钥，需要时切换配置。它本身不提供模型，也不包含 Claude Code、Codex 等工具的付费服务。

这篇适合已经装好一个 AI 命令行工具，想减少手动修改配置文件的人。如果你还没有用过这些工具，先完成目标工具自己的安装与登录。 第一次只管理一个工具、一家服务商就够了。

本文主线使用原版 CC Switch。hkwuks 维护的增强版放在最后介绍，不是完成基础配置的前提。

准备好三个信息：你要管理的工具、实际使用的模型服务商、该服务商提供的登录方式或 API 密钥。

命令行工具常简称 CLI，就是在终端里通过命令运行的软件。各工具的安装要求不同，按它自己的官方说明安装；不要把 CC Switch 源码开发所需的 Node.js 版本当成所有 CLI 的统一要求。

1. 进入 原版 CC Switch Releases，选择适合自己系统的稳定版本。
2. Windows 可选择发布页提供的 .msi 安装包或便携版；macOS 按发布页选择 .dmg 等格式；Linux 按发行版和芯片架构选择对应安装包。
3. 完成安装后打开 CC Switch，找到你准备管理的应用入口。
4. 如果已有可用配置，先在设置的数据管理区域导出备份。备份可能包含密钥，应放在自己控制的安全位置，不要提交到公开仓库。

图：原版项目公开截图，仅演示应用与供应商的位置。图中的服务商和金额不构成推荐，也不代表你的账号额度。

先分清四个字段：供应商是提供模型服务的一方；API Key 是调用和计费凭证；模型 ID 是要调用的具体模型名称；端点或 Base URL 是请求发送的地址。这些信息应来自同一家服务商的官方文档。

1. 打开目标应用入口，例如 Claude Code。
2. 点击“添加供应商”或加号，优先选择你实际使用的服务商预设。
3. 核对预设中的地址和接口类型。预设存在不代表你已经拥有对应账号或权限。
4. 使用 API 服务时，将密钥填写在密钥栏，按服务商说明选择或填写模型。使用官方账号登录时，选择对应的官方登录预设，并按目标 CLI 的登录流程操作，不要把网页登录密码填成 API Key。
5. 给配置起一个能辨认的名字，例如“日常练习用”，然后保存。

图：原版项目的添加供应商界面。不同版本、不同应用的字段可能不同，以你所选应用和服务商的配置说明为准。

没有合适预设时再用自定义配置。先核对端点、接口格式、认证方式和模型 ID，不能只凭“兼容 AI”几个字判断能否接入。

保存配置只是第一步。接下来需要确认目标工具确实读取了新配置，并且能够完成请求。

1. 在 CC Switch 的对应应用页面找到刚才保存的配置，点击“启用”，确认它标为当前使用。
2. 结束目标 CLI 的旧会话，再重新打开。尤其是 Codex，切换后建议重启进程，避免继续读取旧配置。
3. 新建一个空的练习目录，在该目录打开终端并运行已经安装的 CLI。例如，用 Claude Code 时运行下面的命令；如果系统提示找不到命令，先回到 Claude Code 的官方安装流程。

claude

4. 完成目标 CLI 自己要求的登录或目录确认，再发送下面的短请求。API 调用可能产生费用。

这是一次连接测试。请只回复“连接测试收到”，不要读取或修改文件，不要运行命令。

5. 收到回答后，结合 CLI 的模型或连接状态、服务商后台调用记录，确认使用了预期的服务。AI 在回答里自报的模型名称不能作为切换成功的证据。

这次练习完成的标准： CC Switch 显示预期配置已启用，目标 CLI 重新启动后能完成请求，且没有认证、余额或模型不存在等错误。不要为了测试切换而在真实项目里要求它批量改文件。

需要换服务商时，添加另一份配置并启用，再按上一节重新验证。保留原来可用的配置，方便出错时切换回来。

恢复官方账号登录时，使用该应用对应的官方登录预设，重启 CLI，再按它自己的登录流程操作。不要简单地删除一个地址后就假定恢复成功。

批量导入、同步或恢复备份前，先导出当前配置。导入可能覆盖已有数据；不要在 CC Switch 写配置的同时用另一个工具编辑相同文件。

CC Switch 的密钥、配置备份和日志不要公开分享。接入第三方服务时，请求内容会交给所选服务商处理；在把代码或工作资料发过去前，应确认自己可以使用这个服务。

hkwuks 还维护了一个 CC Switch 增强版，原稿介绍了其中按请求模型名选择上游服务的聚合代理功能。这属于进阶配置，使用前需阅读该分支当前说明，确认端口、路由规则、密钥保存和费用归属。基础用户完成原版主线即可。

开启本地代理时，请求会先到电脑上的代理，再到所选上游服务。本地代理不是本地模型，也不会自动免除 API 费用；依赖代理转发时还需要保持代理运行。

本页根据 hkwuks 提交的《CC Switch 小白使用说明书》修订，保留安装、添加、启用、验证和排错流程。平台于 2026-09-08 对照原版项目说明复核。原稿与增强版介绍合计为一套 CC Switch 说明书贡献，不把尚未提交的 newAPI 说明计入。

• 社区提交登记与原稿附件
• 原版官方项目与使用说明
• 原版下载页
• Claude Code 官方安装说明

两张界面图来自原版项目公开资源，图中产品界面版权归相应权利人。