第 2 章：安装 CLI

推荐原生安装脚本，也支持 Homebrew、WinGet；安装后用 claude --version 与 claude doctor 验证。

install.sh Homebrew WinGet doctor

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

若在 PowerShell 里看到 The token '&&' is not a valid statement separator，说明你在 PowerShell 而非 CMD；若在 CMD 里看到 'irm' is not recognized，说明你在 CMD 而非 PowerShell。

PowerShell 提示符为 PS C:\，CMD 为 C:\（无 PS 前缀）。

原生 Windows 建议安装 Git for Windows，以便 Claude 使用 Bash 工具；未安装时 Claude 会使用 PowerShell 作为 Shell 工具。WSL 环境无需 Git for Windows。

2Homebrew 与 WinGet

Homebrew（macOS）

brew install --cask claude-code

Homebrew 提供两个 cask：claude-code（稳定通道，通常晚约一周）与 claude-code@latest（最新通道）。Homebrew 安装不会自动更新，需手动执行：

brew upgrade claude-code
# 或
brew upgrade claude-code@latest

WinGet（Windows）

winget install Anthropic.ClaudeCode

WinGet 安装同样不会自动更新，需定期执行：

winget upgrade Anthropic.ClaudeCode

Debian、Fedora、RHEL、Alpine 等也可通过 apt、dnf、apk 安装，详见官方 Advanced setup。

3npm 安装（不推荐）

仍可通过 npm 全局安装，但官方更推荐原生安装脚本。npm 方式需要 Node.js 22+，且可能遇到权限与 PATH 问题：

npm install -g @anthropic-ai/claude-code

切勿使用 sudo npm install -g，会导致权限与安全风险。升级请用 npm install -g @anthropic-ai/claude-code@latest，不要用 npm update -g。

4验证安装

安装完成后，确认 CLI 可用：

claude --version

成功时会输出版本号，例如：

2.1.211 (Claude Code)

若出现 command not found，请检查 PATH 是否包含 ~/.local/bin（见第 8 章 FAQ）。

运行诊断

claude doctor 在不启动会话的情况下检查安装与配置：

claude doctor

它会输出安装健康状态、settings 文件校验错误，以及可修复项的建议。会话内也可输入 /doctor 做自动化检查。

5系统要求

操作系统：macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+
硬件：4 GB+ 内存，x64 或 ARM64 处理器
网络：需要互联网连接
Shell：Bash、Zsh、PowerShell 或 CMD

安装失败（403、curl 语法错误等）请参阅第 8 章常见问题或官方 Troubleshooting。