本页面通过国内镜像源完成所有安装，全程国内 CDN 直连，无需访问海外网站。安装分两部分：先装 Claude Code 命令行工具，再用 CC Switch 配置国内模型提供商。
一键安装（推荐）
下载脚本，双击运行，全程自动。脚本会装：Node.js + npm 国内镜像 + Claude Code + Git，预计 5-15 分钟。
下载后解压，双击 install.command。终端会自动打开，按提示输入 Mac 登录密码（输入时屏幕不会显示字符，这是正常现象）。
首次双击可能弹出「Terminal 想要打开一个从互联网下载的文件」对话框，点「打开」即可。
或在终端粘贴这一行：
curl -fsSL https://cccourse.yunbozs.com.cn/downloads/installers/install.command | bash脚本失败时会在桌面留一个 claude-code-install-<时间戳>.log 日志文件，屏幕同时显示红色错误码（EXX_YY 格式）。两者结合可以快速定位失败原因，对应的修复建议会随错误码一并打印。
完成一键安装后，跳过下一节直接看「接入国内模型」。Linux 用户或想自己控制每一步的高级用户先看下面的「手动安装」。
手动安装
一键安装目前仅覆盖 macOS 和 Windows。使用 Linux 系统、已有 Node.js 18+ 环境、或想自己控制每一步的高级用户走这条路径。
完成手动安装后，继续下面的「接入国内模型」。
接入国内模型
Claude Code 装好了，但默认连接 Anthropic 官方 API 在国内不稳定。下面用 CC Switch（一个开源 GUI 工具）把它切换到国内模型提供商。
安装 CC Switch
CC Switch（37,500+ Stars）是一个开源桌面应用，帮你把 Claude Code 接入国内模型提供商。安装后打开就能用。
打开 Gitee 镜像 Releases，找到最新版本，下载 CC-Switch-vX.X.X-macOS.dmg（国内 CDN 直连，几秒下完）。
双击 .dmg 文件，把 CC Switch 拖进「应用程序」文件夹。
首次打开如果提示「无法验证开发者」：先关闭提示 → 打开「系统设置」→「隐私与安全性」→ 找到 CC Switch 的相关提示 → 点「仍要打开」。
已熟悉 Homebrew？ 也可以用：
brew tap farion1231/ccswitch
brew install --cask cc-switch安装完成后打开 CC Switch，先放着，下一步去拿 API Key。
选择模型提供商
Claude Code 通过 API 调用模型。国内有三家主要提供商，注册任意一家，获取 API Key 即可使用。
| Kimi (月之暗面) | GLM (智谱) | MiniMax (海螺) | DeepSeek (深度求索) | |
|---|---|---|---|---|
| 最强模型 | kimi-k2.5 (262K context) | GLM-5 (200K context) | M2.7 (205K context) | deepseek-v4-pro (1M context) |
| 免费模型 | 无（新用户注册送 $5 券） | GLM-4.7-Flash / GLM-4.5-Flash | 无（注册送额度） | 无 |
| 最低门槛 | 按量付费 | Coding Plan 约 ¥70/月起 | Coding Plan ¥29/月起 | 按量付费 |
| 付费模式 | 按量付费 | 套餐制 (Coding Plan) | 套餐制 (Coding Plan) | 按量付费 |
价格随时可能调整，注册前去官方定价页确认：
- Kimi：platform.moonshot.ai
- GLM：bigmodel.cn
- MiniMax：platform.minimax.io
- DeepSeek：platform.deepseek.com
火山引擎（字节跳动）也支持 Claude Code 接入，详情见其官网。
四家都提供 Anthropic 兼容接口，可以直接配合 Claude Code 使用。如果不确定选哪家：GLM 和 MiniMax 的 Coding Plan 套餐上手最简单（固定月费）；Kimi 和 DeepSeek 按量付费，适合用量不固定的情况，DeepSeek 也是这几家里上下文窗口最大的（1M tokens）。
配置连接
拿到 API Key 后，把 CC Switch 和提供商连起来。
- 打开 CC Switch
- 在提供商列表中选择你注册的那一家
- 把 API Key 粘贴进去
- 点击保存
CC Switch 会自动写入配置，不需要手动编辑任何文件。
配置完成。下一步验证安装是否成功。