A Step-by-Step Guide to Using CC Switch: Manage All AI Programming Tool Providers and Configurations in 10 Minutes手把手教你用 CC Switch:10 分钟管好所有 AI 编程工具的供应商与配置
In the previous article, we introduced the CC Switch desktop manager, which has received 156,000 stars. This article will guide you from downloading and installing the software to completing your first provider switch, and then to managing the MCP server and Skills in a unified manner. We will use the official portable version that was released today throughout the process. We will use Windows as an example, but the process is the same for macOS/Linux.
上一篇我们介绍了 15.6 万星的 CC Switch 桌面管理器,这篇带你从下载安装到完成第一次供应商切换,再把 MCP 服务器和 Skills 也统一管起来。全程用今天入库的官方便携版,Windows 为例,macOS/Linux 流程相同。

Step 1: Download and Launch第 1 步:下载并启动
Click the button above to download CC-Switch-v4.0.36-Windows-Portable.zip (19.58MB), and extract it to any directory (it is recommended to place it in a fixed location, such as C:\tools\cc-switch). Double-click to run CC Switch.exe inside. No installation is required, and no entries are written to the registry.
When launched for the first time, it will automatically scan the AI programming CLIs installed on the local machine: Claude Code, Codex, Gemini CLI, etc. As long as they have been installed, they will be visible in the list on the left. For tools that are not detected, you can manually specify the configuration path.
macOS and Linux users should visit the official Releases page to download the corresponding installation package (dmg / AppImage / deb). The interface and operation are exactly the same.
点上方按钮下载 CC-Switch-v4.0.36-Windows-Portable.zip(19.58MB),解压到任意目录(建议放个固定位置,比如 C:\tools\cc-switch),双击运行里面的 CC Switch.exe,无需安装、不写注册表。
首次启动它会自动扫描本机已安装的 AI 编程 CLI:Claude Code、Codex、Gemini CLI 等只要装过就能在左侧列表看到。没检测到的工具可以手动指定配置路径。
macOS 与 Linux 用户请到官方 Releases 页下载对应安装包(dmg / AppImage / deb),界面和操作完全一致。

Step 2: Add your first third-party supplier第 2 步:添加你的第一个第三方供应商
Click "Add Supplier", select the target tool (e.g., Claude Code), and fill in three items: Name (create your own, e.g., "Intermediary A"), Base URL (the interface address provided by the supplier), and API Key. After saving, the supplier card appears in the list.
If you want to add more, just repeat the process – official APIs, various Chinese direct connections, and self-built gateways can all coexist. Each card represents one channel, and they do not interfere with each other.
The switch has not been made yet, and your Claude Code is still using the original configuration. The switching action of CC Switch is "write": the configuration of the selected provider is written to the configuration file read by Claude Code.
点击「添加供应商」,选目标工具(以 Claude Code 为例),填三样:名称(自己起,比如「中转商A」)、Base URL(供应商给的接口地址)、API Key。保存后供应商卡片出现在列表里。
想加多个就重复添加——官方 API、各家中国直连中转、自建网关都可以并存,一张卡片一个渠道,互不干扰。
此时还没切换,你的 Claude Code 仍在用原配置。CC Switch 的切换动作是「写入」:把选中供应商的配置写到 Claude Code 读取的配置文件里。

Step 3: Switch and verify with one click第 3 步:一键切换并验证
Click the "Switch" button on the target card in Claude Code's list of providers: CC Switch first automatically backs up the current configuration, then writes the new configuration. The whole process takes just one second.
Enable terminal verification: Run a Claude conversation once. If it responds normally, it means the switch was successful. If you want to confirm that the new channel is being used, you can ask the model to report its API endpoint or check the request log in the intermediary's backend.
Switched to the wrong one or want to go back to the official version? Select the original configuration in the history and restore it with one click – the automatic backup before switching is for this step. Repeat the same steps for other tools such as Codex and Gemini CLI.
在 Claude Code 的供应商列表里点目标卡片上的「切换」按钮:CC Switch 先自动备份当前配置,再写入新配置,全程一秒完成。
打开终端验证:随便跑一次 claude 对话,能正常响应说明切换成功;如果想确认走的是新渠道,可以让模型自报 API 端点或在中转商后台看请求记录。
切错了或想回官方?在历史里选原配置一键还原——切换前的自动备份就是为这一步准备的。Codex、Gemini CLI 等其他工具重复同样操作即可。

Step 4: Also manage MCPs, Skills, and Prompts第 4 步:把 MCP、Skills、Prompts 也管起来
Go to the "MCP Management" page: All MCP servers for all CLIs are listed together. Starting and stopping, changing parameters, and switching commands are all done here, so there's no need to go through each mcp.json file. After making changes, remember to have the corresponding CLI reload the configuration.
The "Skills Management" page shows the skill packages installed for each tool: view versions, edit descriptions, and delete unused ones. Together with the skills-manager-tool and planning-with-files-skill we previously added to the library, the skill system is clear at a glance.
The "Prompt Management" page centrally stores your system prompts and commonly used command templates. Write one and use it everywhere, so you don't have to save a copy for each tool and have them conflict with each other. At this point, the entire infrastructure of your AI programming workbench is consolidated within CC Switch.
进入「MCP 管理」页:所有 CLI 的 MCP 服务器集中列出,启停、改参数、换命令都在这里完成,不用再去翻各家的 mcp.json。改完记得让对应 CLI 重载配置。
「Skills 管理」页能看到每个工具已装的技能包:查看版本、编辑说明、删除不用的,配合我们之前入库的 skills-manager-tool 与 planning-with-files-skill,技能体系一目了然。
「Prompts 管理」页统一保存你的系统提示词与常用指令模板,写一份到处用,省得每个工具各存一份还互相打架。到这里,你的 AI 编程工作台基建就全部收口在 CC Switch 里了。

Problem Encountered遇到问题
After switching, the CLI reports an error and cannot connect: Check whether there is an extra /v1 or a missing path at the end of the Base URL. Most transit provider documentation lists the full address. Key is not working: Confirm that the provider's backend quota has not been exhausted and that the Key has been copied in full. If you want to start over completely: Use the restore function to roll back to any previous configuration. The API key only exists on this device. Please do not save it on a shared computer. The Windows portable version that accompanies this article can be found via the download button above.
切换后 CLI 报错连不上:核对 Base URL 末尾是否多了 /v1 或少了路径,多数中转商文档里写的是完整地址;Key 不生效:确认供应商后台额度未用尽且 Key 复制完整;想彻底重来:用还原功能回滚到任意一份历史配置。API Key 只存在本机,公用电脑请勿保存。本文配套 Windows 便携版见上方下载按钮。
⬇ Download · 点击下载:CC Switch v4.0.36 Windows 便携版(本教程配套)
官方 Release · 免安装解压即用 · 教程全程使用本包
阅读与点赞数据保存在你的浏览器本地,欢迎留下你的想法。
今日正能量学一点,用一点;今天种下的种子,会长成明天的能力。去免费下载专区 →广告
评论 文明发言,让讨论更有价值