如何安装 Claude Code：macOS、Windows、Linux 完整准备清单

安装前先确认环境

Claude Code 本身不难装，真正容易出问题的是安装前的环境没有准备好。开始之前，先确认这几件事：

• 你的系统是 macOS、Linux、Windows，或者 Windows 上的 WSL。
• 终端工具可以正常使用：macOS 用 Terminal，Windows 可用 PowerShell、CMD、Git Bash 或 WSL。
• Claude 账号可以正常登录，所在地区和订阅状态支持你使用相关功能。
• 如果你打算用 npm 安装，先确认 Node.js 版本不低于 18。
• 网络连接稳定，不要一边安装一边频繁切换网络环境。

如果你只是第一次安装，我建议优先用官方当前推荐的安装方式。不要从旧教程里随手复制一段命令就跑，因为 Claude Code 的安装方式和桌面 App 支持情况都可能随版本更新变化。

macOS / Linux / WSL 安装

macOS、Linux 和 WSL 通常可以使用同一类安装方式。打开终端后运行：

curl -fsSL https://claude.ai/install.sh | bash

安装完成后，关闭当前终端窗口，再重新打开一个新的终端。这样可以避免 PATH 还没有刷新，导致系统找不到 claude 命令。

Windows 安装

Windows 有三种常见选择：PowerShell、WinGet、WSL。做 Web 开发、Python、Node 项目时，如果你已经习惯 Linux 工具链，WSL 2 通常更顺手；如果只是想在 Windows 原生环境里使用，可以先试 PowerShell 或 WinGet。

PowerShell

irm https://claude.ai/install.ps1 | iex

WinGet

winget install Anthropic.ClaudeCode

WSL

如果你在 Windows 里使用 WSL，可以进入对应的 Linux 发行版，然后执行和 Linux 一样的安装命令：

curl -fsSL https://claude.ai/install.sh | bash

验证安装是否完成

不要只看到安装命令跑完就认为已经装好了。建议至少做两步验证。

第一步，确认 Claude Code 命令是否可用：

claude --version

如果能正常返回版本号，说明系统已经能找到 claude 命令。第二步，检查本机环境是否还有明显问题：

claude doctor

claude doctor 的价值在于，它会帮你检查认证、环境变量、终端环境等常见问题。遇到报错时，先按它给出的提示处理，比反复卸载重装更有效。

最后再运行一次：

claude

如果能进入交互界面，才算完成了最基本的安装和登录验证。

桌面 App

如果你更习惯图形界面，可以到 Claude 官网下载桌面 App。Claude 的桌面 App 已经支持 Claude Code，但具体可用功能取决于系统平台和订阅计划。我的建议是：桌面 App 可以装，但不要把它和命令行安装混在一起判断。命令行能不能用，还是以 claude --version、claude doctor 和 claude 这三步为准。

账号和环境稳定性

安装只是第一步。长期使用 Claude Code，更重要的是保持账号信息、登录设备、网络环境和付款方式稳定。可以继续看：如何降低 Claude Code 账号异常风险？

参考资料

• Anthropic: Set up Claude Code
• Claude Code advanced setup
• Claude download