本页面通过国内镜像源完成所有安装,全程国内 CDN 直连,无需访问海外网站。安装分两部分:先装 Claude Code 命令行工具,再用 CC Switch 配置国内模型提供商。
安装 Node.js
Claude Code 基于 Node.js 运行。Node.js 是 JavaScript 运行环境,由 OpenJS 基金会维护,全球数百万开发者日常使用。需要 18 或更高版本。
打开 Node.js 中文网下载页,点击「macOS Installer」(下载 .pkg 文件,约 80 MB,国内 CDN 直连)。
下载完成后双击 .pkg 文件,按提示一路点「继续」、「同意」、「安装」,输入电脑密码,等待安装完成。这一个安装包同时支持 Apple Silicon 和 Intel 芯片。
按 ⌘ + 空格 打开聚焦搜索,输入「终端」,回车打开。粘贴这条命令配置 npm 镜像:
npm config set registry https://registry.npmmirror.com安装 Claude Code
上一步已配置好镜像源,直接安装:
sudo npm install -g @anthropic-ai/claude-code输入电脑密码时屏幕上不会显示字符,这是正常现象,输完按回车即可。
Windows 用户:去掉前面的 sudo,直接 npm install -g @anthropic-ai/claude-code(Windows 的全局 npm 目录在用户文件夹下,不需要管理员权限)。
macOS 用 Homebrew 安装的 Node.js:也不需要 sudo(brew 已配置好用户目录权限)。
安装完成后先不要启动,等下一步配置好国内模型再用。
安装 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 会自动写入配置,不需要手动编辑任何文件。
配置完成。下一步验证安装是否成功。