Mac 无翻墙装 Claude CLI：全程国内镜像

作者"搞钱研究院"刚买了电脑装 Claude Code，踩了一些坑后总结：现在能搜到的教程要么要设置代理、要么很慢。这篇教程的方案核心是——全部使用国内镜像源（中科大、清华、阿里），解决海外工具下载慢、安装失败、连接超时问题。

• 适用设备：全部 Mac 设备（Intel 芯片 + Apple Silicon M 系列）
• 网络要求：纯国内网络、无需翻墙、不开任何代理
• 操作难度：零基础无脑照抄，命令直接复制粘贴执行

合规说明：以下内容整理自原作者的个人经验分享，仅作信息学习参考。命令请逐条理解后再执行；CC-Switch 需填入你自己的 API 密钥，密钥来源请走正规渠道。

以下来自 @gaoqian2580。Homebrew 是 Mac 必备的包管理器。

1.1 执行安装命令（打开 Mac 终端，整行复制粘贴回车）：

复制/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

1.2 安装交互操作（关键步骤）：

1. 选择下载源：输入 1（中科大） 或 2（清华大学），回车（二选一，国内极速下载）
2. 权限验证：提示输入密码时，输入电脑开机密码（输入过程无任何显示，属于正常现象），输完回车
3. 等待安装：全程自动执行，出现安装完成提示即可

1.3 环境生效：安装完成后，关闭当前终端，重新打开一个新终端，确保环境变量生效。

以下来自 @gaoqian2580。新终端内粘贴以下命令，安装国内适配版 Node.js（内置 npm）：

复制brew install node

依次输入以下两条命令，输出版本号即为安装成功：

复制node -v
npm -v

以下来自 @gaoqian2580。

切换 npm 为国内镜像源（必做，防止下载失败）——切换为阿里旗下 npmmirror 镜像：

复制npm config set registry https://registry.npmmirror.com

安装 Claude Code（CLI 命令行工具）：

复制npm install -g @anthropic-ai/claude-code

安装完成后输入以下命令检测，输出版本号即代表安装完成：

复制claude --version

以下来自 @gaoqian2580。CC-Switch 是开源免费的 AI 编程 CLI 管理工具，轻量无冗余，专门适配 Mac：可统一管理 Claude Code 等 AI 命令行工具，支持 API 密钥本地存储、服务商一键切换、自动故障转移；纯本地运行、无云端上传，作者称之为"国内网络使用 Claude CLI 的必备工具"。

安全下载渠道（优先推荐直连安装包）：

• 官方网站：https://www.ccswitch.io/zh/
• GitHub 发布页：https://github.com/farion1231/cc-switch/releases
• Mac 最新稳定版直连下载：CC-Switch-v3.14.1-macOS.dmg（作者实测版本）

Mac 详细安装步骤：

1. 下载完成后双击 .dmg 安装包
2. 将左侧 CC-Switch 图标拖拽至右侧「应用程序」文件夹
3. 打开启动台启动 CC-Switch，弹出「无法验证开发者」提示（Mac 安全机制，正常现象）
4. 打开「系统设置 → 隐私与安全性」，下滑至底部点击「仍要打开」，输入电脑开机密码
5. 验证完成后即可正常启动

Claude CLI 基础配置（极简入门）：

1. 打开 CC-Switch，本地路由默认端口 127.0.0.1:15721，无需手动修改
2. 添加 Claude 服务商，填入可用 API 密钥
3. 开启代理接管，终端无需额外配置，直接输入 claude 命令即可使用
4. 软件内置用量统计、密钥管理、模型自动检测，全程可视化操作

以下来自 @gaoqian2580。

常用基础命令：

复制brew -v                                  # 查看 Homebrew 版本
brew update                              # 更新 Homebrew
claude --version                         # 查看 Claude 版本
claude                                   # 启动 Claude 命令行
npm config set registry https://registry.npmmirror.com   # 重置 npm 国内源

常见报错解决方案：

• 密码输入无显示：Mac 终端通用机制，正常输入密码回车即可
• Homebrew 下载卡顿：优先选清华/中科大源，关闭电脑所有代理工具
• npm 安装报错：重新执行镜像切换命令，清除缓存 npm cache clean -f
• CC-Switch 无法打开：隐私与安全性内放行软件，重启电脑重试