夜雨聆风关注▲奇奇▲ 分享更多ai干货，期待和你一起活出超高能人生
这是一篇写给完全不懂编程的小白的 Claude Code 安装教程，仅限mac系统！（windows安装见这篇：文科生20分钟安装好了Claude Code
因为我本人确实是一个纯文科生，零代码基础，之前也没有敲过代码的经验。
最开始我也看不懂什么是终端，为什么那个黑黑的命令行输入东西就能出来结果，所以我很理解普通人的感受。
后来尝试着自己输入代码、自己安装，我就觉得很神奇。即便你完全不懂代码，也是可以安装 Claude Code 的，因为我就是这样过来的。
一、安装前先说明：我们要安装哪些东西？
在 Mac 上安装 Claude Code，不能只装 Claude Code 本身。
按照这个教程，我们需要依次安装：
Homebrew
Git
Node.js
npm
Claude Code
你可以这样理解：
Homebrew：Mac 上的软件安装工具
Git：很多开发工具需要用到的基础环境
Node.js：运行 Claude Code 需要的环境之一
npm：Node.js 自带的软件安装工具
Claude Code：最终要安装的 AI 编程助手
这几个东西不用一次性理解，先照着步骤安装成功就可以。
二、安装 Homebrew 和 Git
为什么要先安装 Homebrew 和 Git？
Mac 上很多开发软件都可以通过 Homebrew 来安装。 而且按照这个教程，安装 Homebrew 的过程中，Git 通常也会一起安装好。
所以我们第一步先安装 Homebrew。
打开 Mac 终端
方法一：通过启动台打开
点击 Mac 底部 Dock 栏里的 启动台
找到 其他
点击 终端
方法二：通过 Spotlight 搜索打开
按下键盘：Command + 空格
在搜索框里输入：终端
英文系统可以输入：Terminal
点击打开终端，打开后，你会看到一个可以输入文字命令的窗口。这个窗口就是我们接下来安装软件的地方。
复制 Homebrew 安装命令
复制下面这整行命令：
/bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)"
注意：
一定要整行复制，不要漏掉前面，也不要漏掉后面的括号和引号。
粘贴到终端并回车
在终端里粘贴刚才复制的命令。
然后终端会开始执行安装。
如果出现 Password 怎么办？
安装过程中，终端可能会出现：
Password:
这个意思是：
请输入你的 Mac 电脑登录密码。
也就是你平时开机、解锁电脑时输入的那个密码。
这里有一个小白特别容易误会的地方：
在终端里输入密码时，屏幕上不会显示任何东西。
不会显示数字，不会显示星号，也不会显示小圆点。
你只需要正常输入密码，然后按回车就可以。
如果输错了，就重新输入。
安装过程中如果让你选择下载源
安装 Homebrew 的过程中，可能会让你选择下载源。
截图里出现了类似选项：
1、通过清华大学下载 brew2、通过 Gitee 下载 brew3、我已经安装 brew，跳过克隆4、不克隆 brew，只把仓库地址设置成 Gitee5、不克隆 brew，只把仓库地址设置成清华大学
这里按照截图教程：
第一次选择：1。然后按回车。
也就是选择：通过清华大学下载 brew
如图：
如果再次让你输入密码
后面可能又会出现：
Password:
这时候继续输入你的 Mac 电脑登录密码。
还是那句话：
密码输入时不会显示，直接输入完按回车即可。
如果出现 Y / N 选择
安装过程中，如果终端问你是否继续，可能会出现类似：Y/N
或者：是否继续？
这时候输入：Y
然后按回车。
如图：
配置国内镜像源
Homebrew 安装完成后，教程里还会让你选择之后 brew install 时访问哪个国内镜像源。
截图里出现了类似选项：
1、中科大国内源2、清华大学国内源3、上海交通大学国内源4、腾讯国内源5、阿里巴巴国内源（推荐）
按照截图教程，这一步选择：2
然后按回车。
也就是选择：清华大学国内源
如图：
10.按照终端提示执行 source 命令
安装完成后，终端可能会提示你执行一行命令，类似：
source /Users/你的用户名/.zprofile
注意：
每个人电脑上的用户名不一样，所以这行命令不能完全照抄别人的截图。
你要复制你自己终端里显示的那一行。
比如截图里可能是：source /Users/happypeet/.zprofile
你的电脑可能是：source /Users/suda/.zprofile
或者：source /Users/你的英文用户名/.zprofile
你要以自己终端显示的为准。
复制终端提示里的那一行，粘贴到终端，按回车。
这一步的作用是：
让刚刚安装好的 Homebrew 配置立即生效。
验证 Homebrew 是否安装成功
在终端输入：
brew -vgit --version
然后按回车。只要能显示版本号，就可以继续下一步。
成功安装如图：
三、安装 Node.js 和 npm
Claude Code 是通过 npm 安装的，所以我们需要先安装 Node.js。
npm 一般会随着 Node.js 一起安装。
你可以这样理解：
Node.js 是环境，npm 是安装工具。
我们后面要用 npm 来安装 Claude Code。
复制 Node.js 安装命令
复制下面这整行命令：
/bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)"
注意：
一定要完整复制，不要漏掉引号、括号和最后的 install.sh。
粘贴到终端并回车
打开终端，粘贴命令按回车。
这一步会通过脚本安装 nvm，并进一步安装 Node.js。
这里的小白解释是：
nvm：用来管理 Node.js 版本的工具
Node.js：Claude Code 需要的运行环境
npm：用来安装 Claude Code 的工具
按照终端提示继续操作
安装过程中，如果终端让你输入数字、确认选项，按照它的提示来。
如果出现类似：Y/N
一般输入：Y。然后按回车。
如果出现：Password:
就输入你的 Mac 登录密码，然后按回车。
还是要提醒：终端输入密码时不会显示，正常输入即可。
验证 Node.js 是否安装成功
安装完成后，在终端里输入：
node -v
然后按回车。
如果看到类似：v20.x.x
或者：v22.x.x
或者：v24.x.x
就说明 Node.js 安装成功。
版本号不需要和教程截图一模一样。
只要能显示版本号，就可以。
验证 npm 是否安装成功
继续输入：
npm -v
然后按回车。
如果看到类似：10.x.x
或者：11.x.x
就说明 npm 安装成功。
只要 node -v 和 npm -v 都能显示版本号，说明 Node.js 环境已经配置好了。
四、安装 VS Code
如果你的用户后面要用 Claude Code 写项目，我建议这里也把 VS Code 安装上。
VS Code 是用来看文件、改文件、写代码的工具。
打开 VS Code 下载地址
打开浏览器，进入：https://code.visualstudio.com/download
选择 Mac 版本下载
进入页面后，找到 Mac 版本。
点击 Mac 图标或 Mac 下载按钮。
下载完成后，你会得到一个 VS Code 安装文件。
安装 VS Code
一般步骤是：
打开下载好的文件
把 Visual Studio Code 拖到 应用程序 文件夹
打开“应用程序”
找到 Visual Studio Code
双击打开
五、安装 Claude Code
前面的 Homebrew、Git、Node.js、npm 都装好以后，就可以安装 Claude Code 了。
复制 Claude Code 安装命令
复制下面这行命令：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
这行命令的意思是：使用 npm 安装 Claude Code，并且使用国内 npm 镜像源加速下载。
粘贴到终端并回车
把命令粘贴到终端按回车。
等待安装完成
安装过程中，终端可能会显示很多英文。
只要没有红色报错，就可以继续等。
如果安装成功，你可能会看到类似：changed packages
或者：added packages
或者回到可以继续输入命令的状态。
这通常就说明安装结束了。
验证 Claude Code 是否安装成功
在终端输入：
claude --version
然后按回车。
如果你看到版本号，比如：1.x.x
或者：2.x.x
就说明 Claude Code 安装成功。
版本号不需要和别人一样。
只要能显示版本号，就可以。
安装成功如图：
六、买模型
前面安装好后，还得有 AI 模型才能干活。虽然智谱 AI 挺好，但它现在需要抢名额，新手很难抢到。建议直接用 MiniMax，稳定且方便。
去哪买： 浏览器打开 platform.minimaxi.com（这是 MiniMax 的开放平台）。
怎么买：
注册登录后，找到订阅套餐。
点击 “购买”，选择mini max 2.7。建议买基础的“29 元/月”套餐。这些钱足够你高强度折腾很久了。
怎么拿钥匙（API Key）：
在网页左侧菜单找 “账户管理” -> “接口密钥”。
点击 “创建新的 API Key”，起个名字。
重点： 创建后会跳出一串很长的字符，立刻点击“复制”并找个地方存好。它是你的私人密码，关掉网页后可能就看不到了。
七、下载并配置 CC-Switch（连接器）
现在你有软件（VS Code）和燃料（API Key）了，得用这个工具把它们连起来。
去哪下载： 浏览器打开 github.com/farion1231/cc-switch/releases
点哪个： 找最上面那个 “Latest” 版本，下载那个 .dmg结尾的文件。
怎么操作：
安装并打开 CC-Switch。
点击软件界面右上角的图标（设置按钮），把这些按钮都打开。
把你刚才在 MiniMax 复制的那串 API Key 粘贴进去。
保存并关掉，它就帮你把后台配置全部接通了。
八、在 VS Code 里正式开工
最后，我们要在编辑器里把 Claude Code 的图标叫出来。
打开 VS Code 软件。
点击左边侧边栏的 “四个小方块” 图标（这就是插件市场）。
在搜索框输入 “Claude Code”，点那个蓝色的 “Install” 进行安装。
大功告成： 安装完后，看 VS Code 窗口的右上角区域。
只要在那看到了一个“烟花形状”的小图标，就表示你安装成功了！
vs code 中文界面设置
很多人会苦恼于 VS Code 的页面都是英文，看不懂。很简单，点击左下角四个方格的这个图标，然后在搜索框搜索 Chinese，安装这个插件，然后重启一下，你的 vscode 就会变成中文的界面。
九、小白常见问题
输入密码时为什么没有反应？
这是正常的。
终端为了保护密码安全，输入密码时不会显示任何内容。
你只需要正常输入密码，然后按回车。
密码是哪个密码？
是你的 Mac 电脑登录密码。
也就是你平时开机、解锁电脑时输入的密码。
不是 Apple ID 密码。不是 Claude 密码。不是邮箱密码。
看到很多英文是不是出错了？
不一定。
安装开发工具时，终端本来就会显示很多英文。
只要没有明显的红色报错，通常不用管。
如果你不确定，可以让用户截图给 AI 看。
你可以在教程里写：
如果你看不懂终端输出，不要自己乱改命令，直接截图发给 AI，让 AI 判断是否正常。
版本号和教程不一样怎么办？
没关系。
比如你输入：node -v
别人显示：v24.14.1
你显示：v22.10.0
这都正常。
只要能显示版本号，就说明安装成功。
brew -v 没反应怎么办？
先关闭终端，重新打开，再输入：
brew -v
如果还是不行，看看安装结束时终端有没有提示你执行类似：
source /Users/你的用户名/.zprofile
你需要复制你自己终端里的那一行执行。
node -v 或 npm -v 显示 command not found 怎么办？
先关闭终端，重新打开。
然后再试：
node -vnpm -v
如果还是不行，说明 Node.js 环境可能没有配置成功，需要重新执行 Node.js 安装命令：
/bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)"
claude –version 显示 command not found 怎么办？
说明 Claude Code 没有安装成功，或者终端还没有识别到它。
先尝试：
关闭终端
重新打开终端
输入：
claude --version
如果还是不行，重新执行安装命令：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
npm install 的时候报错怎么办？
先看是不是网络问题。
可以重新执行：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
如果还是报错，截图给 AI 看，不要自己乱改。
-全文完-
很多人装好 Claude Code 之后，真正卡住的不是安装，而是不知道下一步该做什么。
我整理了一份《AI 入门资料包》，帮零基础小白快速理清：AI 工具有哪些、怎么选、怎么安装、装好之后怎么开始用。
关于本人：
其他安装教程：
