Claude Code + CC-Switch

给中国大陆用户的一键可视化安装器。

不用先学命令行,不用反复处理镜像源。打开安装器,按步骤完成 Claude Code、CC-Switch 和国产模型配置。

Windows 安装包 macOS DMG 国内镜像源 国产模型配置
Claude Code 安装助手启动界面,显示开始安装按钮和当前 macOS arm64 系统信息
真实软件截图:启动后直接进入可视化安装流程。

为什么它更适合新手

把安装 Claude Code 时最容易出错的环节收进一个流程。

可视化安装

不要求用户先理解终端、npm 或 PATH。按窗口提示完成安装,适合不会命令行的新手用户。

多平台覆盖

README 已提供 Windows 安装包与 macOS DMG,同时保留脚本安装方式,给进阶用户继续使用。

国内网络友好

安装流程使用淘宝 NPM、清华镜像和 GitHub 代理镜像,降低网络环境带来的失败率。

软件截图

把原本分散在终端里的安装步骤,变成可确认的界面。

用户能看到当前系统环境、需要安装的组件,以及后续模型选择和完成后的启动指引。

环境检测界面,列出磁盘空间、Node.js、Git、Claude Code 和 CC-Switch 状态
环境检测

先确认缺什么。

Node.js、Git、Claude Code 和 CC-Switch 状态会集中展示,新手不用自己判断。

AI 模型选择界面,提供 DeepSeek、智谱 GLM-4 和通义千问选项
选择 AI 模型

安装后继续配置模型。

DeepSeek、智谱 GLM-4、通义千问等选项放在同一流程里,降低后续配置门槛。

安装完成界面,显示快速开始、图文教程、交流与支持,以及打开终端和打开 cc-switch 按钮
安装完成

告诉用户下一步做什么。

完成后给出打开终端、运行 claude 和启动 CC-Switch 的入口,避免装完后不知道怎么用。

Before

手动安装经常卡在环境和网络。

Node.js 版本不对、镜像源没切好,npm 安装 Claude Code 时失败。
Git Windows 下缺少 Git 环境导致部分步骤失败,新手很难处理。
模型 API 装好了 Claude Code,还要继续配置可用模型与 API Key。

After

安装器把步骤拆成可确认的任务。

  • macOS 直接使用官方安装包与 DMG,跳过 Homebrew,安装成功率提升至 100%。
  • Node.js 20 LTS 使用清华镜像,Claude Code 使用淘宝 NPM 镜像。
  • Windows 自动处理 Git 依赖,并提供双击运行的安装方式。
  • 安装 CC-Switch 后,可在桌面应用里切换 DeepSeek、智谱 GLM、通义千问等模型。

安装器会做什么

从系统依赖到模型配置,一次串起来。

目标不是重新发明 Claude Code,而是让中国大陆用户先顺利装上、能打开、能接入可用模型。

推荐

DeepSeek

国产顶级编程模型,README 中标注为推荐选择。

中文理解

智谱 GLM-4

清华系模型,适合需要中文理解能力的用户。

阿里生态

通义千问

通过 DashScope API Key 接入,生态完善。

Download

先下载对应系统的安装包。

根据你的电脑选择对应版本。Mac 用户如果不确定芯片,先在“关于本机”里查看是 Apple 芯片还是 Intel 芯片。

安全提示

README 说明:macOS 版本暂未签名,首次打开可能需要右键选择“打开”;Windows 首次运行可能出现 SmartScreen 提示。

macOS 用户安装提示

如果双击打开提示“已损坏,无法打开”,请在终端执行以下命令解锁:

sudo xattr -r -d com.apple.quarantine /Applications/Claude\ Code\ 安装助手.app

Contact

安装中遇到问题,可以关注公众号继续跟进。

我会把 GitHub 下载、国内镜像配置、macOS 打开权限和模型切换相关的更新说明,放在公众号里同步。

作者公众号二维码
微信扫码关注公众号

FAQ

安装前最该知道的几件事。

安装完成后输入 claude 找不到命令怎么办?

README 建议关闭当前终端,重新打开一个新终端窗口后再试。如果仍然不行,再检查全局安装是否成功。

提示 403 错误是什么意思?

通常是当前模型 API 配置有问题。可以打开 CC-Switch 检查 API Key,或切换到其他模型。

macOS 提示“已损坏,无法打开”怎么办?

这是 macOS 对未签名应用的隔离提示。确认安装包来源后,在终端执行下面命令解除隔离,再重新打开应用。

sudo xattr -r -d com.apple.quarantine /Applications/Claude\ Code\ 安装助手.app
完全不会命令行,可以用吗?

可以。这个项目同时提供可视化安装器和脚本安装。新手优先下载 Windows 安装包或 macOS DMG。

为什么还要安装 CC-Switch?

CC-Switch 用来管理和切换模型。安装完成后,可以用 DeepSeek、智谱 GLM、通义千问等模型驱动 Claude Code。

让 Claude Code 先跑起来。

不用先把每个环境问题都学会。下载安装器,按步骤完成依赖、镜像和模型配置。

选择安装包