乐于分享
好东西不私藏

2026.04.28 – AI开发工具日报|cc-switch小白上手指南

2026.04.28 – AI开发工具日报|cc-switch小白上手指南

TUTORIAL · 2026.04.28

Claude Code + cc-switch

10分钟接上国产模型 · 小白也能看懂

先搞清楚为什么

Claude Code 很强,但国内用有「三座大山」

Claude Code 是目前最强的 AI 编程助手之一,能帮你写代码、改 Bug、做重构。但国内开发者用起来有三个头疼的问题:

第一:网络访问不稳定,终端动不动就卡住;
第二:官方 API 每百万 Token 输出要 $15,用多了钱包受不了;
第三:没有特殊网络根本装不上。

cc-switch 就是来解决这三件事的——它是一个本地代理工具,把 Claude Code 发出的请求转换成国产模型能懂的格式,让你在国内网络下流畅使用,还能省不少钱。

第一步 · 安装 Git

Claude Code 依赖 Git,先把它装上

Claude Code 的底层依赖 Git,没有它装不上。按Win键+X,选择「Windows PowerShell(管理员)」,弹出黑色窗口后输入:

winget install Git.Git

等待出现「已成功安装」后,输入下面的命令验证是否成功:

git --version

看到类似「git version 2.42.0」的字样,说明安装成功了。

✅ Git 是所有操作的基础,这步必须成功。

第二步 · 安装 Claude Code

用 winget 直接装,不需要特殊网络

在同一个 PowerShell 窗口里,输入:

winget install Anthropic.ClaudeCode

等待安装完成。完成后关闭 PowerShell,重新打开一个新的 PowerShell 窗口(这步很重要),输入:

claude --version

看到版本号就说明装好了。如果提示「claude 不是可识别的命令」,重启电脑后再试。

✅ winget 是 Windows 自带的软件管家,不需要科学上网。

第三步 · 安装 cc-switch

下载并安装 cc-switch,给 Claude Code 换个脑子

在浏览器打开这个地址:

github.com/farion123/cc-switch/releases

找到「Assets」下面的安装包下载,双击运行,一路点「Next」安装完成。如果 GitHub 打不开,在公众号后台回复「cc-switch」获取备用下载链接。

装好后,从开始菜单找到 CC Switch,点击打开它。

🔧 cc-switch 是图形界面,不需要记命令。

第四步 · 获取 API Key

API Key = 调用国产模型的「通行证」,免费注册就能拿

以 DeepSeek 为例,打开官网:

platform.deepseek.com

注册账号 → 登录 → 进入「API Keys」页面 → 点击「创建 API Key」→ 复制生成的 Key(一串字母数字混合字符串)。

除了 DeepSeek,以下平台也支持:
Kimi(platform.moonshot.cn,新用户送15元)
硅基流动(cloud.siliconflow.cn,实名送16元)
通义千问(百炼平台)
智谱 GLM(open.bigmodel.cn)

💡 新用户一般都有免费额度,足够先用起来。

第五步 · 在 cc-switch 里配置

图形界面操作,三分钟搞定

打开 CC Switch 应用后,按以下步骤操作:

1. 点击右上角的「+」按钮

2. 选择你的模型供应商(如 DeepSeek / Kimi / 硅基流动)

3. 粘贴 API Key,填入模型名称:
DeepSeek:`deepseek-chat` 或 `deepseek-coder`
Kimi:`Pro/moonshotai/Kimi-K2.5`
通义千问:`qwen-turbo` 或 `qwen-coder-plus`

4. 点击「添加」

5. 返回主界面,点击刚才添加的配置,让它显示为「启用」状态

✅ 配置完不用重启,cc-switch 会自动接管。

第六步 · 启动 Claude Code

重要:不要在「我的电脑」里直接启动

随便找一个文件夹(比如桌面新建一个「项目」文件夹),打开 PowerShell,进入这个文件夹,然后输入:

claude

看到小螃蟹图标就说明启动成功了!接下来你就可以像平常一样跟 Claude Code 对话,但它背后调用的已经是国产模型了。

⚠️ 在根目录(如 C 盘)启动会让 Claude 看到你整个电脑的文件,速度会变慢。

常见问题

三个最常踩的坑,一次说清楚

报错 400 或 401:API Key 填错了,或者 cc-switch 里的模型名称不对。去开放平台确认一下 API Key 和模型名称是否匹配。

Claude Code 说「不是可识别的命令」:关闭 PowerShell,重新打开一个新的再试。或者重启电脑。

计费太快:cc-switch 里配置 `retry_limit: 3`,避免网络抖动导致无限重试。另外 DeepSeek-V4-Flash 版本比 Pro 版便宜很多,简单的代码任务用 Flash 版就够了。

全程约10分钟,不需要任何编程基础。

作者:AI资讯主理人