这份 Claude Code 安装配置指南,带一个开发者从什么都没装,走到一个能用、且稳定的首次会话。多数安装教程停在安装命令那一步,留你对着一个能登录、却在第一条真实请求上卡住的命令行发呆。本文覆盖完整路径:系统要求、两种受支持的安装方式、首次登录验证,以及大多数教程忽略的网络一步——确认你到 API 的连接足够稳,让你的第一次 agent 运行真的能跑完。照着这份 Claude Code 安装配置指南按顺序走,就能避开常见的第一天挫败。
面向的读者,是想在 macOS、Linux 或 Windows 上做一次干净、可复现安装的开发者,也不想在刚开始几分钟后就去 debug 一个卡住的会话。下面的顺序,就是我在一台全新机器上会照着跑的顺序。
这份指南适合谁
第一种是全新用户:你有一个符合条件的账户、从没跑过命令行,只想要一条最短又可靠的路通向能用的会话。第二种是要统一安装的团队——需要让同一份安装在每位工程师的笔记本上行为一致,包括那些网络更慢或更远、第一次请求最容易挂住的同事。两者要的是同一件事:一个能装好的安装,和一次不超时的首跑。
还有一点值得先说清楚:安装顺利和首跑顺利,其实是两件事。前者只取决于本地环境和命令是否正确,后者还取决于你和 API 之间那段网络是否稳。很多人把"装好了却跑不动"当成安装失败,于是反复卸载重装,可一段慢链路重装一万次也修不好。先把这两件事分开看,后面排查会清晰很多,也省下大量白费的重装时间。
一步步安装 Claude Code
先核对系统要求
在动手之前,先确认环境。Claude Code 跑在 macOS、Linux 和 Windows 上,npm 包要求 Node.js 18 或更新——Node.js 22 LTS 是干净、经过充分测试的选择。你还需要一个符合条件的账户,命令行工具不在免费网页套餐里。跑 node --version 验证运行时。把这一步提前做对,能挡掉最常见的安装失败——它们几乎都是版本不匹配,而不是什么稀奇问题。
在 npm 和原生安装之间选一个
有两条受支持的路。原生安装器不需要任何依赖、在后台自更新,对单台工作机来说最省事。npm 这条路——npm install -g @anthropic-ai/claude-code——仍然完全受支持,在你本来就管着 Node 工具链时很方便。无论走哪条,有一条规则要记住:别在 npm 命令前面加 sudo。如果碰到权限错误,用 Node 版本管理器去修,而不是以 root 身份安装——以 root 装全局包,是人们弄坏安装最常见的一种方式。
首次运行时登录并验证
用 claude 启动命令行,完成它提示的登录流程。然后端到端地证明安装没问题:跑 claude --version 确认二进制,在会话里跑 /doctor 在配置问题咬人之前先抓出来。发一条最琐碎的提示——"列出这里的文件"——看它返回。如果这次往返干净地走完,你的 Claude Code 安装配置就是稳的。如果它能登录、第一条真实请求却挂住,说明安装没问题,下一节就是给你的。
把第一次连接弄稳
这一步是普通的 Claude Code 安装配置指南会漏掉的。命令行可能装得、登录得都很完美,只要到 API 的路径又慢又丢包,它照样像坏了——因为第一次 agent 运行本身就涉及很多次往返,一个卡住的跳点就会让它看着像冻住。用一次到 API 主机的 ping 看基准;如果你离服务器很远、看到很高的延迟,就把流量走一条优化路径。NasaCode 提供的正是为此调优的开发者低延迟节点,让一次全新安装无论你在服务器隔壁还是隔着一个大陆,都表现得一样。
安装方式对比
| 方式 | 依赖 | 更新 | 适合 | 备注 |
|---|---|---|---|---|
| 原生安装器 | 无 | 后台自动 | 单台工作机,起步最快 | 推荐默认 |
| npm 全局 | Node.js 18+ | 手动重装 latest | 已有 Node 工具链 | 切勿用 sudo |
| 版本管理器安装 | nvm 等 | 手动,隔离 | 多个 Node 版本 | 修权限错误最干净 |
| 安装 + NasaCode 路由 | 以上任一 | 同上 | 远距离或不稳网络 | 让首跑不卡住 |
常见问题
用 Claude Code 一定要付费账户吗?
是的。Claude Code 需要一个符合条件的付费套餐或控制台访问,不包含在免费网页层里。装之前先确认账户,免得卡在登录那一步走进死胡同。
npm 安装报权限错误怎么办?
你八成是用了提升权限、或者装到了系统自带的 Node 上。用版本管理器重装,让全局包落在你的用户空间里,错误就消失了。
命令行装好了,第一条命令却挂住,怎么办?
安装没问题,连接有问题。测一下到 API 主机的延迟。如果很高,你的路径就是瓶颈,一条优化路径能让第一次 agent 运行跑完。
新手该选哪种安装方式?
先用原生安装器,摩擦最小。只有在有明确理由时——比如要管理好几个 Node 版本——再转到 npm 或版本管理器这条路。
一次干净的 Claude Code 安装配置是四步,不是一步:核对要求、按适合你机器的方式安装、用一条琐碎提示登录并验证、在真正依赖它之前把到 API 的路径弄稳。跳过最后一步,一个完美的安装也可能在你第一个真实任务上像坏了。
在安装 Claude Code 的同时下载 NasaCode 客户端,给你的第一次会话——以及之后每一次——它需要的那条稳定低延迟连接。