安装和更新 Claude Code
Claude Code 官方安装方式、系统要求、验证命令和更新策略。
Claude Code 官方当前推荐优先使用 native installer。macOS、Linux、WSL、Windows 都有对应安装方式；Homebrew 和 WinGet 也可用，但它们不会自动更新。
系统要求
官方 setup 文档列出的基础要求：
- 操作系统：macOS 13.0+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+。
- 硬件：4 GB 以上内存，x64 或 ARM64 处理器。
- 网络：需要可访问互联网。
- Shell：Bash、Zsh、PowerShell 或 CMD。
- 地区：需要位于 Anthropic 支持的国家或地区。
- 搜索依赖：
ripgrep通常随 Claude Code 提供；如果搜索失败，再按官方排障补装或切换配置。
Windows 原生环境推荐安装 Git for Windows，这样 Claude Code 可以使用 Bash 工具；如果没有 Git Bash，会回退到 PowerShell。WSL 环境不需要 Git for Windows。
推荐安装命令
macOS、Linux、WSL：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell：
irm https://claude.ai/install.ps1 | iexWindows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew：
brew install --cask claude-codeWinGet：
winget install Anthropic.ClaudeCode如果你在 Windows 里看到 && 不是有效分隔符，大概率是在 PowerShell 里执行了 CMD 命令；如果 irm 不存在，大概率是在 CMD 里执行了 PowerShell 命令。
Windows 选择
官方把 Windows 分成三种使用方式：
- Native Windows：适合 Windows 原生项目和工具；推荐安装 Git for Windows；不支持 sandboxing。
- WSL 2：适合 Linux 工具链和需要 sandboxed command execution 的场景。
- WSL 1：在不能使用 WSL 2 时可用；不支持 sandboxing。
如果项目本身在 WSL 文件系统里，就在 WSL 终端里安装和运行 claude。不要从 PowerShell 装完后跨环境操作 WSL 项目。
验证安装
安装完成后先确认版本：
claude --version再跑更完整的环境检查：
claude doctor如果出现 command not found，优先检查 PATH；如果登录失败，再看认证页和官方 troubleshoot-install。
更新策略
Native install 会在后台自动更新。更新通常在启动时或运行中检查，下载后在下一次启动生效。
Homebrew、WinGet、apt、dnf、apk 这类包管理器安装方式不会自动更新，需要手动执行升级：
brew upgrade claude-codewinget upgrade Anthropic.ClaudeCodeHomebrew 当前有两个 cask：
claude-code：稳定通道，通常比最新发布晚约一周，并跳过有重大回归的版本。claude-code@latest：最新通道，新版本发布后尽快获得。
Native install 可以在 /config 里切换 auto-update channel，也可以在 settings.json 里设置：
{
"autoUpdatesChannel": "stable"
}