Claude Code 装不上？先读这篇，3 分钟解决

上周我同事来找我，脸色很难看。

他买了 Claude Code 订阅，折腾了两个小时，装不上。最后问我一个让我愣住的问题：

“npm 到底是什么？”

他不是菜鸟。互联网公司 3 年，用 Python，跑 AI 工具，但他从来没搞清楚过 npm 是啥。

这让我想到一件事：AI 现在越来越强，但它的门槛从来没有消失，只是换了个位置。

npm 是什么？

npm 是 JavaScript 的“软件安装器”。

你可以理解成程序员世界里的 App Store——里面放着几百万个软件包，你用一行命令就能装好。

现在你想用的很多 AI 工具，都得走 npm 这条路：

Claude Code（@anthropic-ai/claude-code）

Vercel（AI 应用部署平台）

OpenClaw（AI 助理）

各种 MCP server（连接 Claude 与本地工具的桥梁）

哪怕你不写一行 JavaScript，你也绕不开 npm。这是 2025 年的情况。

先装 Node.js，npm 就自动来了

npm 跟着 Node.js 打包发布，装了 Node.js，npm 就有了。

最简单的方式：去 nodejs.org 下载 LTS（长期支持）版本，一路下一步。

装完验证：

node -v
npm -v

两行都有版本号，说明装好了。这步完成，你已经比卡在入门的人快了一半。

你只需要记住这三个命令

安装工具

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

看装了什么

npm list -g

卸载工具

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

-g 表示“全局安装”，装完在任何地方都能用。装 AI 命令行工具基本都要加这个。

99% 的失败都是这两个问题

问题一：权限报错

报错长这样：

Error: EACCES: permission denied

解法：命令前面加 sudo，输入你的电脑密码：

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

macOS 用户必看。

问题二：网络超时

npm 默认的源在国外，国内访问会超时甚至卡死。

一行命令换国内镜像（淘宝源）

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

换完再装，速度直接飞起。

我那个同事，权限加网络双重问题，两步解决，加起来不到 1 分钟。

装好之后，你能做什么？

这才是重头戏。

Claude Code 装上后，进入你的项目文件夹，输入 claude，它就能读懂你整个代码库，自己写代码、改 Bug、跑测试。

我让它帮我改一个 API 报错，说了一句：「这个接口超时了，帮我加上重试逻辑。」

它没有只加一个简单的 retry。它看了整个文件，发现这个接口调了 3 个下游服务，分别设了不同的超时，顺手把错误日志格式统一了，然后告诉我：「有个边界情况是重试成功但数据不一致，我在这里加了幂等校验，你看看合不合适。」

我一个字都没提幂等。它自己想到的。

那一刻我意识到：这不是代码补全工具，是真的在帮你干活的同事。

手把手：装 Claude Code 全流程

第一步：确认 npm 在不在

npm -v

第二步：换国内镜像（避免超时）

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

第三步：安装（权限报错就加 sudo）

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

第四步：验证是否装上

claude -v

四步。装上了就可以直接开始用。

顺便：npx 是什么？

你可能看到过：

npx create-next-app my-project

npx 和 npm install 的区别是：install 把东西装到本地，npx 是临时跑一次，用完不留。

创建项目的脚手架工具通常用 npx，因为你只用一次，不需要常驻。

最后说一句

npm 就这些，没什么神秘的。

AI 工具装失败，大概率不是你电脑的问题，也不是工具坏了。先换镜像，再加 sudo，两步解决 99% 的报错。

原文发布于 X：https://x.com/vincemask/status/2039677661682044933

Claude Code 装不上？先读这篇，3 分钟解决｜npm 小白教程