我第一次装 Claude Code 用的 npm，权限问题折腾了半小时。后来发现官方脚本一行命令就完事了，白踩的坑。

这篇文章讲怎么在 Mac 上把 Claude Code 装好、跑起来。三种方式我都走过一遍，直接告诉你哪个最省心。

Claude Code 到底是什么

先说清楚它不是什么——不是聊天机器人。

Claude Code 是一个跑在终端里的 AI 编程助手，能直接进到你的项目目录里干活。看代码、改文件、重构、调试，这些都能做。你可以把它理解成一个住在终端里的 Agent，你给它任务，它在你的项目里执行。

它不绑定 Claude 官方模型，后面可以通过其他方式接国产模型，这个下篇再讲。现在先解决第一步：装上它。

开始之前

这篇教程面向 Mac 用户。你需要打开 Mac 自带的「终端」或者 iTerm：

Command + 空格
搜索：终端
回车打开

然后先检查一下你电脑有没有 Node.js 和 npm：

node -v
v24.5.0
npm -v
11.5.1

能看到版本号就行。Claude Code 要求 Node.js 18 以上。

如果显示 command not found 或者版本太低，也别急，后面的官方安装脚本一般会自动处理依赖。

方式一：官方脚本安装（推荐）

这是我试过最省心的方式，一行命令：

curl -fsSL https://claude.ai/install.sh | bash

能正常访问 Claude 官网的话直接用这个，不用自己处理依赖。

安装完成后检查版本：

claude --version
2.1.120 (Claude Code)

能看到版本号就说明装好了。

方式二：Homebrew 安装

电脑上已经装了 Homebrew 的话，也可以用这个方式：

brew install --cask claude-code@latest

跟装其他 Mac 软件一样。

安装成功结果：

安装完成后，同样检查版本：

claude --version
2.1.120 (Claude Code)

需要注意的是 Homebrew 装的不会自动更新，后面要手动升级：

brew upgrade claude-code@latest

卸载方式：

brew uninstall --cask claude-code
brew cleanup claude-code # 清理缓存
brew unlink claude-code 2>/dev/null # 删除可能残留的符号链接

方式三：npm 安装（不推荐新手用）

以前很多教程推荐这种方式：

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

我第一次就是用这个装的，踩了一堆权限坑，改了 npm 全局路径才搞定。新手建议直接跳过，用前两种方式省心很多。

装好之后怎么启动

随便找一个目录，输入：

claude

能进到 Claude Code 的交互界面就说明装好了。

第一次进入会让你选主题样式、登录方式和账号配置。主题随便选，后面用 /theme 随时改。

登录方式怎么选

首次启动后会看到几种登录方式：

Claude 订阅账号（Pro / Max / Team）——体验最完整，但国内用户可能会遇到地区和风控问题。

Anthropic Console API——有 API Key 的话按量计费，用多少算多少。

第三方平台（Amazon Bedrock、Google Vertex AI 等）——偏企业和开发者，普通用户可以先不管。

国内用户可能碰到的问题

装好之后跑 claude，如果看到：

Claude Code might not be available in your country.

这不是装坏了，是网络或账号认证的问题。工具装好了，但官方服务连不上。

解决方向有两个：一是确保网络环境能访问 Claude 官网；二是后面通过其他模型方案接入，比如用 CC Switch 配合 GLM、MiniMax 这些国产模型，不用 Claude 官方账号也能跑起来。这个我下篇会详细讲。

常见问题

必须会编程才能用吗？ 不必须。但你得会打开终端、复制命令、按步骤操作。

装好了就能直接用？ 不一定。安装成功只代表工具本身装好了，能不能顺利用还取决于账号、网络、模型配置和 API 可用性。

Mac 没有 Homebrew？ 先用官方脚本装。后面打算长期折腾 AI 工具的话，建议装一个 Homebrew，省得每次手动处理依赖。

为什么不推荐一上来用 npm？ 新手很容易碰到权限问题、Node 版本问题、npm 全局路径问题、装完命令不可用这些坑。官方脚本和 Homebrew 稳得多。

总结

三种安装方式，优先级：

1. 能访问 Claude 官网 → 用官方脚本

2. 有 Homebrew → 用 brew

3. 都不行 → 再考虑 npm

装完跑 claude --version，能看到版本号就成功了。然后输入 claude 启动，先把它跑起来再说。

下一篇讲不用 Claude 官方账号，怎么用 CC Switch 接国产模型把 Claude Code 真正跑起来。对国内用户来说那步才是关键。

我是赛博李同学大厂写代码的，觉得有用的话，点个赞 + 转发给需要的TA，感谢支持！，我们下期再见！