Claude Code Manual

下载与安装

官方推荐使用原生安装器：一条命令装好，不依赖 Node.js，并且会在后台自动更新。

系统要求

• macOS 13 或更高版本；Windows 10（1809）或更高版本；Ubuntu 20.04+、Debian 10+ 等主流 Linux。
• 4 GB 以上内存，x64 或 ARM64 处理器。
• 能联网。

macOS、Linux、WSL

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

也可以用 Homebrew 安装。这种方式不会自动更新，需要定期运行 brew upgrade claude-code：

brew install --cask claude-code

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 安装（需要手动 winget upgrade 更新）：

winget install Anthropic.ClaudeCode

分清自己在哪个终端里：提示符以 PS C:\ 开头的是 PowerShell，没有 PS 的是 CMD。如果看到 The token '&&' is not a valid statement separator，说明你在 PowerShell 里运行了 CMD 的命令；看到 'irm' 不是内部或外部命令，说明你在 CMD 里运行了 PowerShell 的命令。

安装不需要管理员权限。

Git for Windows 是可选的。 装了它，Claude Code 会用 Git Bash 执行命令；没装，就用 PowerShell 执行命令。推荐安装，很多教程和脚本默认使用 Bash：

winget install --id Git.Git -e

WSL：在 WSL 里使用时，进入 WSL 后按上面 Linux 的方式安装，不需要 Git for Windows。Windows 原生和 WSL 是两个独立环境，在哪里运行 claude，就要在哪里安装和配置。

npm 安装

如果官方安装器下载失败，可以用 npm 安装（需要 Node.js 22 或更高版本）。国内可以加镜像参数：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

npm 包安装的是同一个原生程序。升级时运行 npm install -g @anthropic-ai/claude-code@latest，不要用 npm update -g。不要用 sudo npm install -g。

检查安装

重新打开终端，运行：

claude --version
claude doctor

claude --version 显示版本号说明安装成功；claude doctor 会检查安装方式、配置文件和依赖，有问题会给出提示。

如果提示找不到 claude 命令，先关掉终端重新打开；还不行，见排错与更新。

卸载

原生安装（macOS、Linux、WSL）：

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows 原生安装（PowerShell）：

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew、WinGet、npm 安装的，用对应的包管理器卸载。配置和会话记录在 ~/.claude 目录和 ~/.claude.json 文件里，确定不再需要时再删除。