Claude Code 安装

本页目标

学完本页，你能选择正确的官方安装命令，检查 Claude Code 版本，并在练习项目中进入首次登录流程。

验证说明（2026-07-10） 安装命令与限制已逐字对照官方文档；本机仅运行 claude --version，得到 2.1.119。未执行安装、claude doctor、升级或账号登录，macOS、Linux、WSL 与原生 Windows 安装均未实机走完。

开始前

当前要求包括 macOS 13+、Windows 10 1809+ 或 Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+，以及 4 GB+ 内存、x64/ARM64 和网络。账号需为 Pro、Max、Team、Enterprise、Claude Console 或已配置的云提供商；Claude.ai Free 不包含 Claude Code。中国大陆未列入当前支持地区。

跟着做

1. 运行与你的终端对应的推荐命令。

macOS、Linux 或 WSL：

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

Windows PowerShell：

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

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2. 也可使用 Homebrew 或 WinGet：

brew install --cask claude-code

winget install Anthropic.ClaudeCode

3. 检查并启动：

claude --version
claude doctor
cd {项目路径}
claude

原生 Windows 可直接运行且 Git for Windows 为可选项，但没有 Claude Code 沙箱；WSL2 支持沙箱，WSL1 不支持。npm 仅作为备用，自 2.1.198 起要求 Node.js 22+，且不要配合 sudo 使用。

结果检查

claude --version 应显示版本，claude doctor 应完成环境检查。首次运行 claude 会打开浏览器登录；成功后，提示符上方应显示版本、模型和当前工作目录。

练习

本页小结

初学者应优先使用原生安装器，npm 不是当前默认路径。安装后先检查版本、环境和登录，再开始第一次只读任务。