安装 Claude Code

三个平台，三条主流安装路径，一次讲清楚。

Claude Code 是一个跑在本地终端里的命令行工具，装完之后会在你系统的 PATH 里注册一个叫 claude 的可执行文件。所有系统上，安装的最终形态都是同一件事，只是拿到二进制的方式不一样。下面按平台分别讲。

三条路径怎么选

进入具体步骤前先看一眼决策表。多数人不用纠结，跟着推荐路径走就行。

• 只是想快速把工具装起来，跟教程走：选 Native 一键脚本。它跨平台一致，装完就能用，卸载也只是删几个文件。
• 已经在用 Homebrew 或者 Winget 管理其他开发工具：选对应的包管理器。好处是升级和其他工具统一走 brew upgrade 或 winget upgrade，一条命令搞定。
• 没有 sudo 权限的服务器、远程开发机：选 Native 脚本。它默认装到用户目录，不需要 root。

选好之后往下走对应的小节即可。

前置：Node.js 18 及以上

Claude Code 底层依赖 Node.js 运行时。哪怕你走 Native 一键脚本，也需要系统里存在 Node.js 18 或更新版本，否则安装脚本会中止。这是硬性依赖，绕不过去。检查方式很简单：

node --version

输出如果是 v18.x.x、v20.x.x 或更高，你就可以直接开始装 Claude Code。如果版本低于 18，或者提示 command not found，先按下面推荐方式装 Node。

• macOS，推荐 brew install node 或者用 nvm 管理多版本。
• Windows，推荐去 nodejs.org 下 LTS 版本的 msi 安装包，或者用 winget install OpenJS.NodeJS.LTS。
• Linux，推荐用 nvm，避免和系统包管理器打架。

注意

不要用系统自带的老版 Node，比如 Ubuntu 20.04 官方源里的 Node 10。版本太老会在安装或者启动阶段直接报错。

macOS 安装

macOS 上推荐两条路径，Native 一键脚本和 Homebrew。任选一条即可。

Native 一键脚本

打开终端，粘贴执行：

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

脚本会自动检测你的架构（Intel 或 Apple Silicon），下载对应的二进制，放到 ~/.local/bin/claude 或者 /usr/local/bin/claude，并把这个目录加进你的 shell 配置。装完新开一个终端窗口，敲 claude --version 应该能看到版本号。

Homebrew 安装

如果你已经在用 Homebrew 管理软件包，可以走 cask：

brew install --cask claude-code

后续升级同样通过 brew：

brew upgrade claude-code

Homebrew 路径的好处是版本管理和其他 brew 工具统一，缺点是首次装的时候需要下载完整包，速度取决于你的 Homebrew 镜像。

Windows 安装

Windows 上推荐 Winget，若拿不到管理员权限或者是精简版系统，退而走 PowerShell 一键脚本。

Winget 安装

以管理员身份打开 PowerShell 或 Windows Terminal：

winget install Anthropic.ClaudeCode

Winget 会把二进制装到 %LOCALAPPDATA%\Programs 下并自动登记 PATH。升级：

winget upgrade Anthropic.ClaudeCode

PowerShell 一键脚本

如果你更喜欢和 macOS 一样的一键体验，PowerShell 里执行：

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

irm 是 Invoke-RestMethod 的别名，iex 是 Invoke-Expression。整条命令的意思是把远程脚本抓下来直接执行。

CMD 一键脚本

如果你用的是老 CMD 而不是 PowerShell：

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

先下载脚本、执行、然后删掉临时文件。

提示

Windows 上建议用 Windows Terminal + PowerShell 7 的组合。老的 cmd.exe 显示 emoji、颜色、多字节字符都容易出问题，Claude Code 的对话界面会难看很多。

Linux 安装

Linux 上只有 Native 一键脚本这一条推荐路径：

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

脚本会把二进制放到 ~/.local/bin/claude，并把该目录加进你 shell 的 rc 文件。装完执行 source ~/.bashrc 或 source ~/.zshrc 让新的 PATH 生效，或者直接开一个新的终端窗口。

如果你是在服务器上无 sudo 权限安装，Native 脚本的用户目录模式正好合适，无需 root 权限。

验证安装

不管你走哪条路径，装完后都用同一个命令验证：

claude --version

正常输出形如：

claude 1.0.x (Claude Code)

看到版本号说明二进制和 PATH 都正确。如果提示 command not found，绝大多数情况是新装的 PATH 没生效，重开一个终端窗口就好。如果重开还是不行，翻到本章第四节的排错篇。

关于二进制位置

Native 脚本装在用户目录下的 ~/.local/bin 或者 ~/.claude/local，Homebrew 装在 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），Winget 装在 %LOCALAPPDATA%\Programs\Claude\Claude Code。想找具体位置直接 where claude（Windows）或者 which claude（Unix）。

升级与卸载

装好之后运行一段时间，Claude Code 会经常发新版本，修 bug、加功能都在里面。升级的方式和你当初的安装路径挂钩：

• Native 脚本装的，重新跑一遍安装命令即可，脚本会检测已装版本并做原地覆盖。
• Homebrew 装的，brew upgrade claude-code。
• Winget 装的，winget upgrade Anthropic.ClaudeCode。

想彻底卸载 Claude Code，除了删二进制之外还要清掉本地的配置和凭证目录。macOS 和 Linux 上是 ~/.claude，Windows 上是 %USERPROFILE%\.claude。这个目录里保存了你的登录凭证、会话历史、本地配置，正常升级不需要动它，只有真想彻底重置时才删。

下一步

装好之后先不要急着跑 claude，直接跑会弹登录界面。下一节我们把认证这一步讲清楚，然后再进真实项目。想搞清楚安装报错的话，直接翻到本章第四节，把常见坑挨个对号入座。