AI 编程工具的第一道门槛往往在安装：Claude Code 的安装命令敲下去，有人直接看到 command not found: claude，有人卡在 Node 版本上，还有人装完才发现机器上同时存在两份 claude，跑的哪个版本全看 PATH 排序。安装这一步看着简单，坑集中在三件事上：装哪条路、版本够不够、来源是否唯一。这篇给出 npm 与原生安装器两条安装路、装完的验证动作、Node 18+ 这道坎、双版本冲突的排查方法，以及 claude update 这条万能招。
两条安装路：npm 与原生安装器
主流走法有两条。第一条是 npm 全局安装：机器上先有 Node 环境，然后 npm install -g @anthropic-ai/claude-code 一条命令装好，Windows、macOS、Linux 通用，适合本来就在做 Node 开发的人。第二条是原生安装器：官方提供的安装脚本，把 claude 装到用户目录下的 ~/.local/bin，不依赖系统里已有的 Node，适合不想动 Node 环境、或者权限受限装不了全局包的机器。两条路装的是同一个工具，选一条顺手的走到底，别中途换道——换道正是双版本冲突的主要来源。装好之后第一次怎么跑起来，见首次上手一篇的六步链路。
| 安装路 | 前置条件 | 装到哪 | 适合谁 |
|---|---|---|---|
| npm 全局安装 | 机器上先有 Node 18+ | 全局包目录，一条 npm install -g 装好 | 本来就在做 Node 开发的人 |
| 原生安装器 | 不依赖系统里已有的 Node | 用户目录下的 ~/.local/bin | 不想动 Node 环境、权限受限装不了全局包的机器 |
| 两条都走过 | 机器上两份 claude 并存 | PATH 里排前面的那份生效 | 冲突之源，确认后卸载其一 |
装完先验一遍
安装是否成功，claude --version 一验便知：能吐出版本号，说明装上了、PATH 也通；提示 command not found: claude，多半是新开的终端还没刷新 PATH，或者可执行文件所在目录没进 PATH。验证这步别省：后面排查任何问题时，第一步都是确认当前版本，很多「莫名怪问题」其实是版本对不上；去社区求助时带上版本号，别人才能对上号。命令不存在的逐项排查，见command not found 专项一篇。
Node 18+ 这道坎
走 npm 路线的，Node 版本是硬门槛：Claude Code 要求 Node 18 及以上，版本太旧轻则装不上，重则装上了运行时行为异常。排查顺序固定：先 node -v 看当前版本，不够就升级；用 nvm 之类的版本管理器最稳，切换自如，不干扰系统里其他依赖 Node 的项目。走原生安装器的可以直接跳过这道坎——它自带运行环境，这正是两条路线的核心差别之一。版本处理完，重跑 claude --version 确认一遍再往下走。
一台机器两份 claude
「明明升级了，行为还是旧的」这类怪事，根源常常是多来源：npm 装过一份，原生安装器又装了一份，PATH 里谁排前面就用到谁——你以为在用新版，实际跑的是旧版，或者反过来。排查用 which claude 看路径（Windows 下用 where），输出指向哪条安装来源一目了然；确认冲突后卸载其一，只保留一条来源，以后升级也只动这一条。拿不准机器现状时，跑 claude doctor：它是官方自带的自检命令，会报告安装方式与版本状态，双版本冲突在 doctor 的报告里藏不住。doctor 与另外两个排查命令的完整用法，见claude doctor 专项一篇。
claude update：万能的一招
很多「莫名怪问题」的官方答案是升级：旧版本带着已修复的缺陷，新版一行命令修完。claude update 检查并更新到当前版本，升级后把出问题的场景再复现一次，多数安装期与运行期的边角毛病就此消失。排查的通用顺序因此可以固定下来：先 claude doctor 看自检报告，再 claude update 升到新版，两项做完问题仍在，才进入按报错逐项排查的深水区——先自检再重装，顺序别反，重装是最后的动作而不是第一反应。升级与回滚的取舍，Codex 那边有一篇同主题拆解（见版本升级与回滚），思路通用；Codex 的安装路与 Claude Code 高度同构，两边的坑也相似，Codex 安装一篇可对照参考。装机前想拿一份对着走的清单，可以让豆包按你的操作系统与包管理器情况生成安装检查单；卡在报错上，把 claude --version 与 claude doctor 的输出一起丢给 DeepSeek 分析；分不清两条安装路该走哪条，让 Kimi 对照你的使用场景给个建议。
Claude Code 安装速查
- 两条路：npm 全局安装与原生安装器（~/.local/bin），选一条走到底
- 装完 claude --version 验证，命令不存在先新开终端刷新 PATH
- npm 路线要求 Node 18+，用 nvm 管版本最稳；原生安装器自带环境
- which claude 定位来源，双版本卸载其一，claude doctor 出自检报告
- 排查顺序：先 doctor 自检，再 claude update 升级，最后才考虑重装
关于 Claude Code 安装的三问三答
- npm 和原生安装器选哪个？：机器上本来就有 Node 且日常维护，走 npm 顺手；不想碰 Node、权限受限或只求能用，走原生安装器。核心是选定一条用到底，混用是冲突之源。
- 装完提示 command not found: claude 怎么办？：先新开一个终端窗口让 PATH 刷新，多数情况就此解决；仍不行的，确认可执行文件所在目录已进 PATH，逐项排查见 command not found 专项一篇。
- 升级会丢配置吗？：不会。配置与项目记忆存放在用户目录的配置文件里，与程序本体分离，claude update 只更新程序本身，升级后配置原样保留。
