Claude Code 安装教程：Windows、WSL 2 与 macOS

在 Windows 上，先决定以后从哪个环境运行 Claude Code

摘要： 本文介绍 Claude Code 在 Windows 原生、WSL 2 与 macOS 三种环境下的安装方式：Windows 可选择 PowerShell 官方脚本或 WinGet，WSL 2 需先准备环境再在 WSL 终端安装，macOS 可选官方安装脚本或 Homebrew。安装完成后应重开对应终端，并运行 claude --version 核对版本号，确认安装成功。

：直接在 Windows PowerShell 中使用，选原生安装，可以用官方 PowerShell 脚本或 WinGet；准备在 WSL 2 中使用，就进入 WSL 终端安装。macOS 则可以选择官方安装脚本或 Homebrew。同一环境下的安装方式是备选，选一种执行，不需要全部安装一遍。

Windows 原生：选择 PowerShell 脚本或 WinGet

Windows 原生安装没有强制依赖，Git for Windows 是可选项。装了它，Claude Code 会通过 Git Bash 使用 Bash 工具；没装则改用 PowerShell 工具。

PowerShell 官方安装脚本

在 Windows PowerShell 中执行下面的命令，运行 Claude Code 官方安装脚本：

powershell 复制代码

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

WinGet 安装方式

如果选择 WinGet，也在 Windows PowerShell 中执行，安装目标是 Claude Code：

powershell 复制代码

winget install Anthropic.ClaudeCode

WSL 2：先准备环境，再在 WSL 终端安装

Windows PowerShell 与 WSL 2 是两个运行环境。安装在哪个环境，就需要在哪个环境运行；安装在 WSL 2 中的 Claude Code 不能从 Windows PowerShell 启动。

尚未安装 WSL 2 时

以管理员身份打开 Windows PowerShell，执行：

powershell 复制代码

wsl --install

按系统提示完成 WSL 2 安装并重启电脑，然后打开 WSL 发行版的终端，继续下面的安装。这里的 PowerShell 用于安装 WSL；接下来的 Claude Code 安装命令要在 WSL 终端执行。已经装好 WSL 2 的读者直接进入该终端，不需要重复这一前置步骤。

在 WSL 2 终端安装 Claude Code

WSL 2 环境不需要 Git for Windows。下面这组命令使用 apt 准备安装环境：先更新软件包索引，再安装 Git 和 curl，最后运行 Claude Code 安装脚本。命令按此顺序在 WSL 2 发行版终端执行：

bash 复制代码

sudo apt update
sudo apt install -y git curl
curl -fsSL https://claude.ai/install.sh | bash

macOS：选择官方安装脚本或 Homebrew

两种方式任选其一，都在 macOS 终端执行。

官方安装脚本

下面的命令运行 Claude Code 官方安装脚本：

bash 复制代码

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

Homebrew 安装方式

选择 Homebrew 时，执行以下命令安装 Claude Code：

bash 复制代码

brew install --cask claude-code

安装后：重开对应终端，核对版本号

安装命令执行结束后，还需要确认新终端能找到 Claude Code。关闭并重新打开安装对应环境的终端：Windows 原生安装回到 Windows PowerShell，WSL 2 安装回到 WSL 终端，macOS 安装回到 macOS 终端。

下面这条版本检查命令适用于上述三个环境，在重新打开的终端中执行：

text 复制代码

claude --version

终端输出 Claude Code 版本号，才算完成安装验证；实际数值以本机输出为准，不要求某个固定版本号。

如果没有输出版本号，先确认旧终端已经关闭、新终端已经打开，并且当前环境与安装环境一致。这些条件都满足后仍然报错，继续按下方官方安装文档中的安装排错入口查阅，不要用另一个环境的版本输出代替当前环境的检查。

官方资料

Claude Code 官方安装文档提供安装渠道说明和安装遇错时的排查入口。本文安装渠道与命令的参考日期为 2026-08-29。

参考文档

需要重新安装或切换使用环境时，可在 Muze Wiki：Claude Code 安装教程中按环境切换安装命令。