首页 / 第2部分：安装与配置 / 第2章：安装与配置

2.1 安装教程

Anthropic 官方现在推荐用原生安装器（Native Install）安装 Claude Code，一行命令搞定，不再需要先装 Node.js / npm，并且会在后台自动更新。

下面分别给出 Windows、macOS、Linux 的安装步骤，以及登录与首次启动方式。

2.1.1 Windows 安装步骤

Windows 上有三种安装方式，任选其一即可。

前置：（推荐）安装 Git for Windows

Claude Code 在 Windows 上需要 Bash 才能运行其 Bash 工具，官方推荐先装 Git for Windows（自带 Git Bash）。如果不装，Claude Code 会回退使用 PowerShell。

访问 https://git-scm.com/downloads/win，下载 64-bit 安装程序，双击运行，保持默认选项一路下一步即可。

方式一：原生安装器（官方推荐，自动更新）

打开 PowerShell（按 Win 键，输入 PowerShell 回车），运行：

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

如果你用的是 CMD（命令提示符），改用：

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

怎么区分 PowerShell 和 CMD？看提示符：PS C:\> 是 PowerShell，C:\> 是 CMD。

方式二：WinGet 包管理器（国内网络）

如果你更习惯用 Windows 包管理器，按顺序执行以下两条命令：

1. 使用 winget 安装 Git：

winget install Git.Git

2. 使用 winget 安装 Claude Code：

winget install Anthropic.ClaudeCode

注意：WinGet 安装的版本不会自动更新，需要手动跑 winget upgrade Anthropic.ClaudeCode。

方式三：npm 全局安装

这种方式需要按顺序完成三个子步骤：

步骤 1：安装 Node.js

访问 https://nodejs.org/，下载 LTS 版本的 Windows Installer（.msi），双击运行，一路「Next」使用默认配置（默认会自动加入 PATH）。装完重新打开 PowerShell，运行：

node --version
npm --version

步骤 2：安装 Git for Windows

Claude Code 运行时需要 Bash 才能执行其 Bash 工具。访问 https://git-scm.com/downloads/win，下载 64-bit 安装程序，双击运行，保持默认选项一路下一步。

（如果你已经按本节最前面的「前置」步骤装过 Git for Windows，跳过即可。）

步骤 3：用 npm 全局安装 Claude Code

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

升级用 npm update -g @anthropic-ai/claude-code。

验证安装

关闭并重新打开终端，然后运行：

claude --version

能正常输出版本号即安装成功。

2.1.2 macOS（苹果）安装步骤

macOS 上有三种安装方式，任选其一即可。

前置：打开终端

使用 Command + 空格 打开 Spotlight，输入 Terminal 或「终端」并回车。

方式一：原生安装器（官方推荐，自动更新）

一行 curl 命令搞定，无需先装 Node.js / Homebrew，会自动在后台保持更新：

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

方式二：Homebrew

如果尚未安装 Homebrew，先运行以下命令安装，安装完成后按照提示配置环境变量：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装好 Homebrew 后，运行：

brew install --cask claude-code

注意：Homebrew 安装的版本不会自动更新，需要手动跑 brew upgrade claude-code。如果想跟最新版本，可以装 claude-code@latest。

方式三：npm 全局安装

需要先装 Node.js（用 brew install node，或从 nodejs.org 下载 LTS 版本安装），然后运行：

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

升级用 npm update -g @anthropic-ai/claude-code。

验证安装

关闭并重新打开终端，然后运行：

claude --version

能正常输出版本号即安装成功。

2.1.3 Linux 安装步骤

Linux（包括 WSL）有三种安装方式，任选其一即可。

前置：确保已安装 curl

# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y curl

# Fedora / RHEL / CentOS
sudo dnf install -y curl   # CentOS/RHEL 也可用 sudo yum install -y curl

# Alpine
sudo apk add curl

方式一：原生安装器（官方推荐，自动更新）

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

原生安装器会自动检测发行版并保持后台更新，不需要 sudo。

方式二：系统包管理器（apt / dnf / apk）

官方也提供 apt、dnf、apk 仓库，适合 Debian、Fedora、RHEL、Alpine 等发行版，详见 官方 Linux 包管理器安装文档。

方式三：npm 全局安装

需要先装 Node.js（推荐通过 NodeSource 官方源安装）：

# Ubuntu / Debian（安装 Node.js 20.x LTS）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora / RHEL / CentOS
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo -E bash -
sudo dnf install -y nodejs

装好 Node.js 后，全局安装 Claude Code：

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

升级用 sudo npm update -g @anthropic-ai/claude-code。

验证安装

关闭并重新打开终端，然后运行：

claude --version

能正常输出版本号即安装成功。

2.1.4 启动并登录

三个系统装完 Claude Code 后，启动方式完全一样：

cd your-project    # 进入你的项目目录
claude              # 启动 Claude Code

首次运行时，Claude Code 会自动打开浏览器引导你登录 Anthropic 账户（需要 Claude 订阅或 Anthropic Console 账户）。登录完成后即可开始使用。

2.1.5 常见问题

2.1.5.1 claude: command not found

  • 关闭并重新打开终端 / PowerShell（让 PATH 生效）
  • 检查安装日志是否有报错
  • 更多排查：官方安装故障排查

2.1.5.2 Windows PowerShell 报 'irm' is not recognized

说明你当前在 CMD 而不是 PowerShell。改用 CMD 的安装命令：

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

2.1.5.3 Windows PowerShell 报 The token '&&' is not a valid statement separator

说明你在 PowerShell 而不是 CMD 里跑了 CMD 命令。改用 PowerShell 的命令：

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

2.1.5.4 公司 / 学校网络需要 HTTP 代理

# macOS / Linux：临时给 curl 设置代理
export https_proxy=http://proxy.example.com:8080
export http_proxy=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell：临时设置代理
$env:HTTPS_PROXY = "http://proxy.example.com:8080"
$env:HTTP_PROXY  = "http://proxy.example.com:8080"
irm https://claude.ai/install.ps1 | iex