Claude Code Manual

下载与安装

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

系统要求

  • macOS 13 或更高版本;Windows 10(1809)或更高版本(或 Windows Server 2019+);Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+ 等主流 Linux。
  • 4 GB 以上内存,x64 或 ARM64 处理器。
  • 能联网。

macOS、Linux、WSL

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

也可以用 Homebrew 安装。这种方式不会自动更新,需要定期升级。Homebrew 提供两个 cask:claude-code 跟随稳定版(通常比最新版晚约一周,会跳过有严重问题的版本),claude-code@latest 在新版本发布后立即更新:

brew install --cask claude-code
brew upgrade claude-code

Debian、Ubuntu、Fedora、RHEL、Alpine 也可以用官方签名的 apt、dnf、apk 软件源安装,步骤见官方文档 Advanced setup 的“Install with Linux package managers”。这些方式同样不会通过 Claude Code 自动更新。

Alpine 等 musl 系统的安装器依赖 bash 和 curl,系统默认没有时先运行 apk add bash curl。

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。如果 npm --version 显示的是 12 开头的版本,请按官方 Troubleshoot installation 里的 “Fix an npm 12 install” 处理。

选择更新渠道

原生安装默认跟随 latest,新版本一发布就更新。想要更稳一点,可以改用 stable(通常比最新版晚约一周,跳过有严重问题的版本):在会话里运行 /config,修改 Auto-update channel;或者在 ~/.claude/settings.json 里写:

{
  "autoUpdatesChannel": "stable"
}

安装时也可以直接指定渠道或版本号,例如 curl -fsSL https://claude.ai/install.sh | bash -s stable。注意:新发布的模型有时需要比 stable 更新的版本,遇到“不支持这个模型”时见排错与更新。

检查安装

重新打开终端,运行:

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 用 brew uninstall --cask claude-code(装的是最新版 cask 则为 claude-code@latest),WinGet 用 winget uninstall Anthropic.ClaudeCode,npm 用 npm uninstall -g @anthropic-ai/claude-code;apt、dnf、apk 安装的用对应的包管理器卸载,并按官方文档删除软件源配置。配置和会话记录在 ~/.claude 目录和 ~/.claude.json 文件里,确定不再需要时再删除。