Claude Code 安装教程：macOS、Linux、Windows 与 WSL

Anthropic 当前推荐原生安装器。它会把 Claude Code 安装到用户目录，不要求以管理员身份运行，并在支持的平台上负责后台更新。Homebrew、WinGet 和 Linux 包管理器适合已有统一软件管理流程的团队，但通常需要自行升级。

先确认终端类型再执行命令：macOS、Linux 与 WSL 使用 Bash 命令；Windows PowerShell 使用 irm。PowerShell 和 CMD 的语法不同，不要混用安装命令。

安装命令结束不代表 PATH、设置文件和更新通道都正常。先让当前终端重新加载 shell 配置，再分别运行版本检查和只读诊断。

claude doctor 会检查安装健康、设置文件解析和更新状态。它比反复重装更适合定位 PATH 或配置错误。

Claude Code 以启动目录作为当前工作范围。进入真实项目目录后运行 claude，首次使用会进入认证流程；认证完成后再发送一个只读问题确认它能读取项目。

不要在包含大量无关仓库的父目录启动。工作范围越清楚，文件探索越集中，后续权限判断也越容易。

Claude Code 可以原生运行在 Windows，也可以运行在 WSL。原生 Windows 适合 Windows 工具链；WSL 2 更适合 Linux 工具链，并支持 Claude Code 的 Bash 沙箱。

原生 Windows 未安装 Git for Windows 时，Claude Code 使用 PowerShell 工具；安装后可使用 Git Bash。项目文件在哪里，通常就在哪里安装和启动 CLI，避免跨文件系统带来的路径与性能问题。

原生安装默认在后台更新。团队若更看重稳定性，可在设置中选择 stable 通道；希望立即获得新功能则使用 latest。Homebrew 与 WinGet 安装默认由各自包管理器升级。

在教程或自动化脚本中不要依赖未经检查的新参数。升级后先运行 claude --version 和 claude doctor，再验证常用工作流。

命令不存在时先检查 PATH 和实际命中的可执行文件；403、HTML 被当作脚本或 TLS 错误则属于下载链路问题。连续切换 npm、Homebrew、WinGet 和原生安装器，容易留下多个同名二进制。

记录当前安装方式后只沿一个渠道修复。安装完成后再进入认证与项目配置，不要把网络下载问题误判为账号或模型问题。