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

Anthropic 当前推荐原生安装器。该安装器安装到用户目录，不需要管理员权限，并在受支持的平台后台更新。已统一软件管理的环境可使用 Homebrew、WinGet 或 Linux 包管理器；升级由所选包管理器负责。

安装命令必须与当前 shell 匹配：macOS、Linux 和 WSL 使用 Bash，Windows PowerShell 使用 irm。Bash 与 PowerShell 命令不可互换。

安装命令成功退出并不代表 PATH、配置解析和更新通道已正常工作。重新加载当前终端的 shell 配置后，运行版本检查和只读诊断。

claude doctor 检查安装状态、设置文件解析和更新状态。应先根据诊断输出定位 PATH 或配置问题，再执行重装。

Claude Code 将启动目录作为工作范围。在项目目录中运行 claude，首次启动完成认证后，执行一次只读请求以验证项目访问权限。

不要从包含无关仓库的父目录启动。较小的工作范围可以限制文件探索，并明确权限边界。

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

原生 Windows 未安装 Git for Windows 时使用 PowerShell；安装后可使用 Git Bash。CLI 与项目文件应位于同一文件系统，避免路径和性能问题。

原生安装默认后台更新。需要发布稳定性时选择 stable 通道；需要较早使用新行为时选择 latest。Homebrew 和 WinGet 安装由各自的包管理器升级。

文档和自动化中不得使用未经验证的新参数。升级后运行 claude --version、claude doctor，并验证所需项目工作流。

命令找不到时，检查 PATH 和 shell 实际解析的可执行文件。HTTP 403、HTML 被作为脚本执行和 TLS 错误均属于下载链路问题。反复切换 npm、Homebrew、WinGet 与原生安装器可能留下多个同名二进制文件。

记录当前安装渠道，并仅通过该渠道修复。先验证安装，再排查认证或项目配置，使下载和网络故障与账号、模型故障保持区分。