这篇解决什么问题
Claude Code 是 Anthropic 官方推出的终端 AI 编程工具：npm 包名 @anthropic-ai/claude-code，装完在任意项目目录敲 claude 就能进入交互式会话。它直接跑在你的终端里，能读代码、改文件、执行命令、写 git 提交，也支持 claude -p "指令" 这种非交互模式接进脚本和 CI。
很多”装好了但不能用”的反馈，问题其实出在验证环节被跳过。所以这篇除了 Windows 和 macOS 两条安装路线，还把验证做成了固定步骤：装完立刻确认三件事——命令存在、自检通过、会话能跑通。
读完你能拿到三样东西：
- 一个全局可用的
claude命令； - 一个已完成登录、能对话改代码的工作会话；
- 一份出问题时的自查清单（常见坑一节，四个高频坑按命中率排序）。
环境与版本
先对齐环境，缺什么补什么：
| 项目 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10/11、macOS 常见版本 | Windows 原生支持 PowerShell / CMD / Git Bash，也可走 WSL |
| Node.js | 18 及以上（官方硬性要求） | 建议 LTS；版本过低启动会直接报错 |
| npm | 随 Node.js 一起装好 | 主安装路线依赖它 |
| 账号 | Claude 订阅（Pro/Max）或 Anthropic Console 的 API Key | 二选一，计费方式不同【待补：订阅与 API 当前价格】 |
| 硬件 | 内存 8 GB 起步 | 工具本身开销很小，瓶颈通常是项目规模 |
Node.js 选版本的依据——LTS 节奏表：
| 版本 | 发布时间 | 维护状态 |
|---|---|---|
| Node.js 18.0 | 2022 年 4 月 | 已于 2025 年 4 月结束维护，别再新装 |
| Node.js 20.0 | 2023 年 4 月 | 已于 2026 年 4 月结束维护 |
| Node.js 22.0 | 2024 年 4 月 | LTS 主力，无特殊理由选它 |
| Node.js 24.0 | 2025 年发布 | 新 LTS【待补：当前官方推荐 LTS 的具体小版本号】 |
验证 Node 是否就绪：
node -v
npm -v两条命令都打印出版本号即可。没装的，Windows/macOS 都可以去 nodejs.org 下 LTS 安装包；国内下载慢就换 npmmirror 的镜像目录：https://npmmirror.com/mirrors/node/，安装方式完全一样。
分步骤安装
第 1 步：npm 全局安装（主路线）
npm install -g @anthropic-ai/claude-code- Windows：PowerShell 或 CMD 都行；npm 全局目录默认在用户目录下，不需要管理员权限。
- macOS：同一条命令。如果 npm 全局目录落在
/usr/local这类需要 root 的位置，别用sudo硬装，处理方式见常见坑第 1 条。 - 网络慢：先把 registry 切到国内镜像再装：
npm config set registry https://registry.npmmirror.com装完不需要重启终端。【待补：实测安装耗时与下载体积】
第 2 步：备选路线——官方安装脚本（不走 npm）
机器上不方便装 Node 的，可以用官方安装脚本，它下载独立可执行文件并自动配好 PATH：
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex【待补：脚本实际安装目录与输出内容】
两条路线选一条即可，混装容易出现版本互相覆盖。npm 版后续用 npm update -g @anthropic-ai/claude-code 升级；脚本版有自己的更新机制。已经用 npm 装过又想换脚本版的，先 npm uninstall -g @anthropic-ai/claude-code 卸干净。
第 3 步：验证安装
claude --version
claude doctorclaude --version 打印版本号【待补：实际输出，含当前最新版本号】。claude doctor 是官方自检命令，会检查 Node 版本、安装完整度和网络连通性【待补：doctor 输出内容或截图】。自检全绿再往下走，不绿就按提示修，带着病跑后面全是玄学问题。
第 4 步：登录并跑通第一条指令
cd 你的项目目录
claude首次启动会引导认证：订阅用户走浏览器 OAuth 授权【待补：OAuth 授权页实际流程描述或截图】；API 用户在提示时粘贴 Key（Anthropic Console 创建，以 sk-ant- 开头）。登录成功进入 REPL，先给它一个最小任务：
> 用一句话说明这个项目是做什么的它能正确回答并引用项目里的文件，说明网络、认证、模型调用整条链路都通了。想试非交互模式：
claude -p "列出当前目录结构并解释项目类型"常见坑
坑 1：macOS 提示 EACCES 权限错误
npm 全局目录落在需要 root 的位置。正确做法不是 sudo npm install -g（会把目录权限越搞越乱），而是装 nvm 管理 Node，或把 npm 全局前缀改到用户目录。装了 nvm 之后全局包跟 Node 版本走，换版本要重装，这是它唯一的代价。
坑 2：Windows 提示 claude 不是内部或外部命令
命令装上了但当前终端找不到，按顺序查两个原因：一是装完没重开终端，PATH 没刷新；二是 npm 全局目录不在 PATH 里，用 npm config get prefix 查实际目录，把它加进 PATH 再重开终端。
坑 3：Node 版本低于 18
claude 启动直接报 Node 版本不满足。别硬扛，升 LTS。企业内网常有旧 Node，用 nvm-windows（Windows）或 nvm（macOS）做多版本并存，切版本不影响其他项目。
坑 4：公司网络或代理环境下连不上
Claude Code 遵循标准代理环境变量，有代理就先设好再启动：
export HTTPS_PROXY=http://127.0.0.1:7890 # 端口换成你自己的Windows PowerShell 写法是 $env:HTTPS_PROXY = "http://127.0.0.1:端口"。设完重开 claude 再试；如果公司是透明代理不认环境变量，让 IT 确认放行 Anthropic 的 API 域名。
最终效果
全部做完后应该是这个状态：claude --version 有版本号输出；claude doctor 自检通过；项目目录里能正常对话，让它改一个文件、跑一次测试都能落地。到这里安装与验证就闭环了。
【待补：安装成功界面截图】
想让它全程说中文，看中文配置那篇；想接 DeepSeek 模型省成本，看接入那篇。