弥勒鹿先别急着复制安装命令。我知道你现在很兴奋，想赶紧把 Claude Code 跑起来，但绝大多数人第一次装完、兴冲冲敲下 claude，看到的不是对话界面，而是一整屏红色报错，然后开始怀疑人生：“是不是我电脑有问题？”“是不是要开什么特殊网络？”“是不是这个工具根本不支持 Windows？”
都不是。通常只有一个原因：你跳过了安装之后最不起眼、但价值最高的那一步——环境自检。这一步耗时大约 2 分钟，却决定了后面 28 分钟是丝滑复现还是反复踩坑。这篇东西就是写给零基础用户的，全程跟着操作，不求你懂什么底层原理，只求 30 分钟内让 Claude Code 在你自己的电脑上真正能跑起来，并且把那些 90% 的人会遇到但没人提前讲的坑，一次填平。
1. 装 Claude Code 之前，先搞清楚你要装的到底是个什么
1.1 它不是网页版，也不是 App，而是一个“住在终端里的程序员”
Claude Code 本质上是一个命令行工具（CLI），它运行在你的终端窗口里，不做图形界面，不弹漂亮窗口，而是通过文字跟你对话。你告诉它“帮我看下这个项目里哪里导致内存泄漏”，它会自己读代码、定位问题、给出修改建议，甚至直接帮你改。
把它理解成一个“住在终端里的程序员”就好——你在浏览器里用 Claude 聊天，是一问一答的顾问模式；而在 Claude Code 里工作，它直接接触到你的项目文件、代码目录和 Git 状态，像同事一样上手干活。
这也就解释了为什么很多教程强调“要在一个项目文件夹里启动它”。它需要上下文，不只是一个聊天框。
1.2 零基础用户的 30 分钟路线图
既然是零基础，我先把完整的行动链路给你列出来，每一段分别干什么心里有数：
- 装 Node.js（Claude Code 的运行底座）
- 做环境自检（这是大多数人跳过的步骤，后面详说）
- 执行一条全局安装命令
- 验证安装是否成功
- 配置密钥或登录授权
- 在 VS Code 里跑通一次真实对话
前两步是铺垫，真正的安装命令只有一条，剩下的时间主要花在“让电脑认识这条命令”和“让这个工具连上模型”上。
为什么强调零基础用户必须在终端里操作？因为 CLI 工具不像普通软件有安装包，点两下就完事。它需要系统里预先存在几个基础组件，而且这些组件的配置状态直接决定你后面的成败。很多老手觉得这些是常识，顺手就过了，反而把新手卡死在起跑线。
1.3 你的系统可能需要的额外认知（Windows 用户重点看）
如果你用的是 macOS 或 Linux，环境相对清爽；如果是 Windows，大概率会碰上 PowerShell 脚本策略、系统编码格式、终端重启这些破事。
提前打个预防针：下面出现任何看似多余的“重启终端窗口”“执行策略修改”，都不是浪费时间，而是在给后面排除隐患。我在文章后面会用一整章讲那些必然翻车的报错，你现在花两分钟处理，比到时候研究两小时划算得多。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 被 90% 的人跳过的那 2 分钟：装完 Node.js 先做三项自检
2.1 自检一：Node.js 装完不等于“能用”，先验证这个命令
Claude Code 官方推荐通过 npm 安装，npm 是 Node.js 自带的包管理器。所以第一步永远是装 Node.js，这没有争议。
但争议点在这里：很多人在安装 Node.js 时一路点“Next”，装完直接打开浏览器、下载 VS Code、开始复制安装 Claude Code 的命令，完全没有确认 Node.js 是否真的进入了系统的可执行路径。
结果就是终端里敲 npm install -g @anthropic-ai/claude-code，系统回你一句：
无法将“npm”识别为 cmdlet、函数、脚本文件或可运行程序的名称。
这句话的原意是：系统在所有能找程序的地方都翻了，没找到叫 npm 的程序。但你明明刚装过 Node.js，为什么找不到？
最常见的两种原因：安装过程没有把 Node.js 写入环境变量，或者安装完成后你没有重开终端窗口。
第二种情况极其常见。Windows 下安装 Node.js 时确实会写环境变量，但已经打开的终端窗口不会自动刷新环境变量。你在安装 Node.js 之前就开着的那个 PowerShell 窗口，里面保存的还是旧的环境变量快照。安装完 Node.js 后如果不关掉重开，系统就不知道 npm 已经存在了。
所以自检第一项就是：重开一个全新的终端窗口，然后执行：
bash复制node -v
npm -v
看到类似 v20.11.0 和 10.2.4 的输出，才算通过。如果 `node -