Claude Code 一键安装：macOS、Linux、Windows

在 PowerShell 运行 irm https://claude.ai/install.ps1 | iex，在 CMD 运行 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd，不需要以管理员身份运行；也可以用 winget install Anthropic.ClaudeCode。官方支持 Windows 10 1809+ 或 Windows Server 2019+。Git for Windows 是可选的：装了它 Claude Code 用 Git Bash，没装就用 PowerShell 作为 shell 工具。想在 WSL 里用，就在 WSL 终端里运行 Linux 安装命令，并在那里启动 claude。要接 QCode，可直接在 PowerShell 运行 irm https://qcode.cc/install/claude-code.ps1 | iex。

多半是安装目录还不在 PATH 里，先新开一个终端窗口再试：官方说明，执行安装的那个终端会保留旧的 PATH。官方安装器把 claude 放在 macOS / Linux 的 ~/.local/bin/claude、Windows 的 %USERPROFILE%\.local\bin\claude.exe；Zsh 用户可运行 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc，Linux 上的 Bash 把同一行写进 ~/.bashrc。用 QCode 脚本在 Windows 上装完找不到命令，QCode 文档给的办法同样是重开一个 PowerShell 窗口。

这是命令和终端对不上。官方写明：看到 'irm' is not recognized 说明你在 CMD 里，要换 CMD 的安装命令或打开 PowerShell；看到 The token '&&' is not a valid statement separator 说明你在 PowerShell 里用了 CMD 的命令。在 PowerShell 里运行 curl -fsSL ... | bash 会报找不到 fsSL 参数，因为 PowerShell 的 curl 是 Invoke-WebRequest 的别名。QCode 脚本在 CMD 里可运行 powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex"。

这是执行策略挡住了 npm 生成的 .ps1 启动脚本。官方给了三个办法：运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 后重试；改用 npm.cmd 与 claude.cmd；或者不用 npm，改用 PowerShell 安装器，它装的是二进制而不是 .ps1 脚本。QCode 一键脚本会为本次运行自动放宽执行策略，不改动你的用户级与机器级设置；想让以后新开的 PowerShell 也不被拦，QCode 文档给的命令是 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

不要。官方明确写明不要用 sudo npm install -g，这会带来权限问题与安全风险；之前用 npm 装、遇到 npm 专属的权限错误的，官方建议改用官方安装器 curl -fsSL https://claude.ai/install.sh | bash。QCode 一键脚本同样不需要 sudo：用 sudo 运行会把配置写进 root 的家目录，你自己的终端读不到，去掉 sudo 重跑即可。

看状态码。QCode 文档写明：401 是密钥无效或过期，到控制台核对 cr_ 前缀是否完整复制后重跑；404 是接入地址错误，Claude Code 的 ANTHROPIC_BASE_URL 应为 https://api.qcode.cc/api 这种形式，末尾不带斜杠；网络超时就用 --domain 参数换一个接入域重跑。看到「配置已写入，但验证未通过」时配置文件已经写好，修好原因后重跑即可。重跑总是安全的：托管块原地更新，配置文件先备份再覆盖。