安装配置

Claude Code 的安装过程非常简单，只需一条命令即可完成。无论您使用的是 macOS、Linux（包括 WSL）还是 Windows 系统，都可以通过运行对应的安装脚本快速开始。例如，在 macOS 或 Linux 终端中执行 curl -fsSL https://claude.ai/install.sh | bash 即可完成原生安装，该方式还支持自动更新。本教程将详细指导您完成 Claude Code 安装的每一步，包括系统要求检查、不同平台的安装命令、安装后的验证方法，以及针对 Windows WSL 和 Alpine Linux 的特殊配置，确保您能顺利安装并立即开始使用 Claude Code。

系统要求

项目	要求
操作系统	macOS 13.0+、Windows 10 1809+ 或 Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+
硬件	4 GB 以上 RAM；x64 或 ARM64 处理器
网络	需要互联网连接
Shell	Bash、Zsh、PowerShell 或 CMD。Windows 原生安装需要 Git for Windows；WSL 不需要
地区	Anthropic 支持的国家

安装方法

原生安装（推荐）

macOS / Linux / WSL：

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

Windows PowerShell：

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

Windows CMD：

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

原生安装会在后台自动更新，始终保持最新版本。

Homebrew（macOS）

brew install --cask claude-code

Homebrew 提供两个 cask：claude-code 跟随稳定发布频道（通常滞后约一周，跳过有严重回退的版本）；claude-code@latest 跟随最新频道，新版发布后立即更新。Homebrew 安装需要手动更新（brew upgrade claude-code），不会自动更新。

WinGet（Windows）

winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新，需定期运行 winget upgrade Anthropic.ClaudeCode。

---

验证安装

# 检查版本
claude --version

# 全面诊断（检查配置、MCP、插件等）
claude doctor

---

Windows 特殊配置

Windows 上可以原生运行或在 WSL 中运行 Claude Code，根据项目位置和所需功能选择：

选项	需要	沙箱	适合场景
原生 Windows	Git for Windows	不支持	Windows 原生项目和工具
WSL 2	启用 WSL 2	支持	Linux 工具链或需要沙箱隔离
WSL 1	启用 WSL 1	不支持	WSL 2 不可用时的备选

原生 Windows（使用 Git Bash）

安装 Git for Windows，安装时选择"Add to PATH"，无需以管理员权限运行安装命令。

安装完成后可从 PowerShell、CMD 或 Git Bash 启动 claude。Claude Code 内部使用 Git Bash 执行命令，无论从哪里启动。如果 Claude Code 找不到 Git Bash，在 settings.json 中指定路径：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Claude Code 还支持在 Windows 上以预览模式原生运行 PowerShell，详见工具参考的 PowerShell 工具说明。

WSL 配置

打开 WSL 发行版终端，在 WSL 内运行 Linux 安装命令。从 WSL 终端启动 claude，不要从 PowerShell 或 CMD 启动。

---

Alpine Linux 配置

Alpine 和其他基于 musl/uClibc 的发行版需要额外安装依赖：

apk add libgcc libstdc++ ripgrep

然后在 settings.json 中设置：

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

---

更新管理

自动更新

原生安装会在启动时和运行过程中自动检查更新，后台下载后在下次启动时生效。

配置更新频道

频道	说明
latest（默认）	新功能发布后立即获取
stable	约延迟一周，跳过有重大回退的版本

在 /config 中切换，或修改 settings.json：

{
  "autoUpdatesChannel": "stable"
}

禁用自动更新

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

手动更新

claude update

安装指定版本

# macOS/Linux/WSL - 安装 stable 频道
curl -fsSL https://claude.ai/install.sh | bash -s stable

# 安装特定版本号
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Windows PowerShell - 安装 stable
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

---

账户认证

Claude Code 需要以下账户类型之一：

• Claude Pro / Max / Teams / Enterprise（推荐，按订阅计费）
• Claude Console（API 用量计费）
• Amazon Bedrock、Google Vertex AI、Microsoft Foundry（企业云服务商）

免费版 Claude.ai 不包含 Claude Code 访问权限。

安装后运行 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

WinGet

winget uninstall Anthropic.ClaudeCode

清除配置文件

⚠️ 此操作会删除所有设置、会话历史和 MCP 服务器配置。

macOS/Linux/WSL：

# 删除用户设置和状态
rm -rf ~/.claude
rm ~/.claude.json

# 删除项目设置（在项目目录中运行）
rm -rf .claude
rm -f .mcp.json

Windows PowerShell：

# 删除用户设置
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# 删除项目设置（在项目目录中运行）
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force

---

相关资源

• 快速开始：安装后的第一步
• 故障排查：安装问题解决方案
• 设置：配置文件和选项说明

常见问题

Q: Claude Code 怎么安装？

根据您的操作系统选择对应命令：macOS/Linux/WSL 使用 curl -fsSL https://claude.ai/install.sh | bash；Windows PowerShell 使用 irm https://claude.ai/install.ps1 | iex。这是最推荐的原生安装方式。

Q: Claude Code 安装后就能使用吗？

安装后运行 claude 命令即可启动。首次使用需要完成账户认证（OAuth 登录），支持 Claude Pro/Max/Teams 或 Claude Console 等账户，免费版 Claude.ai 账户无法使用。

Q: Claude Code 安装后怎么用？

安装后，首先在终端输入 claude 命令并按提示登录。之后，您可以使用 claude --version 检查版本，或用 claude doctor 进行诊断。具体使用请参考《快速开始》文档。

Q: Windows 系统安装 Claude Code 有什么要求？

需要 Windows 10 1809 或更高版本。推荐使用 PowerShell 执行安装命令，或者安装 Git for Windows 后使用 Git Bash。文中也提供了详细的 WSL 配置指南。

Q: 如何更新或卸载 Claude Code？

原生安装会自动更新。您也可以手动运行 claude update。卸载方法因安装方式而异：原生安装直接删除相关文件；Homebrew 使用 brew uninstall；WinGet 使用 winget uninstall。