2026.04.28 – AI开发工具日报|cc-switch小白上手指南
Claude Code + cc-switch
10分钟接上国产模型 · 小白也能看懂
Claude Code 很强,但国内用有「三座大山」
Claude Code 是目前最强的 AI 编程助手之一,能帮你写代码、改 Bug、做重构。但国内开发者用起来有三个头疼的问题:
第一:网络访问不稳定,终端动不动就卡住;
第二:官方 API 每百万 Token 输出要 $15,用多了钱包受不了;
第三:没有特殊网络根本装不上。
cc-switch 就是来解决这三件事的——它是一个本地代理工具,把 Claude Code 发出的请求转换成国产模型能懂的格式,让你在国内网络下流畅使用,还能省不少钱。
Claude Code 依赖 Git,先把它装上
Claude Code 的底层依赖 Git,没有它装不上。按Win键+X,选择「Windows PowerShell(管理员)」,弹出黑色窗口后输入:
winget install Git.Git
等待出现「已成功安装」后,输入下面的命令验证是否成功:
git --version
看到类似「git version 2.42.0」的字样,说明安装成功了。
✅ Git 是所有操作的基础,这步必须成功。
用 winget 直接装,不需要特殊网络
在同一个 PowerShell 窗口里,输入:
winget install Anthropic.ClaudeCode
等待安装完成。完成后关闭 PowerShell,重新打开一个新的 PowerShell 窗口(这步很重要),输入:
claude --version
看到版本号就说明装好了。如果提示「claude 不是可识别的命令」,重启电脑后再试。
✅ winget 是 Windows 自带的软件管家,不需要科学上网。
下载并安装 cc-switch,给 Claude Code 换个脑子
在浏览器打开这个地址:
github.com/farion123/cc-switch/releases
找到「Assets」下面的安装包下载,双击运行,一路点「Next」安装完成。如果 GitHub 打不开,在公众号后台回复「cc-switch」获取备用下载链接。
装好后,从开始菜单找到 CC Switch,点击打开它。
🔧 cc-switch 是图形界面,不需要记命令。
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 应用后,按以下步骤操作:
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 会自动接管。
重要:不要在「我的电脑」里直接启动
随便找一个文件夹(比如桌面新建一个「项目」文件夹),打开 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资讯主理人
夜雨聆风