Claude Code 安装教程：Mac、Windows、Linux 的安装、验证、更新和卸载

这篇教程解决一个问题：把 Claude Code 装到自己的电脑上，确认它能用，并完成第一次对话。 全程大约十分钟，命令都来自官方文档。

如果你完全不想碰终端，官方还有桌面应用，可以不用命令行使用 Claude Code；这篇只讲终端里的安装。

开始之前

系统要求

项目	要求
macOS	13.0 或更高
Windows	Windows 10 1809 或更高，或 Windows Server 2019 或更高
Linux	Ubuntu 20.04 及以上、Debian 10 及以上、Alpine Linux 3.19 及以上
硬件	4 GB 以上内存，x64 或 ARM64 处理器
终端	Bash、Zsh、PowerShell 或 CMD
网络	需要联网
地区	需要在 Anthropic 支持的国家和地区内

账号

Claude Code 需要下面任意一种账号，免费版的 claude.ai 不能用 Claude Code：

Claude 的 Pro、Max、Team 或 Enterprise 订阅（官方推荐）；
Claude Console 账号（按量付费的 API，预先充值）；
通过 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 这些云服务商接入。

1安装

官方推荐用原生安装方式，好处是装完会在后台自动更新。打开终端，按你的系统运行对应的命令。

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

几点说明：

安装过程中没有进度显示，等它自己结束就行。
Windows 上怎么分辨自己在哪个终端：提示符是 PS C:\ 开头的是 PowerShell，只有 C:\ 没有 PS 的是 CMD。两条命令不能混用。
Windows 上不需要用管理员身份运行。

其他安装方式

方式	命令	会自动更新吗
Homebrew（macOS）	`brew install --cask claude-code`	默认不会
WinGet（Windows）	`winget install Anthropic.ClaudeCode`	默认不会
npm	`npm install -g @anthropic-ai/claude-code`	见下面的说明
apt、dnf、apk（Linux）	见官方文档的 Linux 包管理器一节	不会，跟随系统升级

Homebrew 有两个包：claude-code 跟的是稳定版，通常比最新版晚一周左右，并且会跳过有严重问题的版本；claude-code@latest 跟的是最新版。
npm 方式需要 Node.js 22 或更高版本。不要用 sudo npm install -g，官方明确说这会带来权限问题和安全风险。
npm 装的和原生安装是同一个程序，运行时并不依赖你的 Node.js。

Windows 上选原生还是 WSL

选项	需要什么	沙箱	适合
原生 Windows	不需要额外的东西；Git for Windows 可选	不支持	Windows 上的项目和工具
WSL 2	已启用 WSL 2	支持	用 Linux 工具链，或需要沙箱里执行命令
WSL 1	已启用 WSL 1	不支持	用不了 WSL 2 时

原生 Windows 上建议装 Git for Windows：装了之后 Claude Code 用 Git Bash 执行命令；没装的话改用 PowerShell。
用 WSL 的话，要在 WSL 的终端里运行上面那条 Linux 的安装命令，之后也在 WSL 里启动 claude，不是在 PowerShell 或 CMD 里。

2验证

安装结束后，新开一个终端窗口，运行：

claude --version

正常的话会打印版本号，后面跟着 (Claude Code)，例如 2.1.211 (Claude Code)。

想做更详细的检查，运行：

claude doctor

它不会启动会话，只打印安装和设置的诊断信息：安装是否正常、是用哪种方式装的、自动更新的状态、设置文件有没有错误，以及发现问题时的修复建议。

3第一次启动和登录

进入你要处理的项目目录，启动 Claude Code：

cd /path/to/your/project
claude

第一次使用会提示登录。订阅账号和 Console 账号都是按提示在浏览器里完成登录。登录一次之后凭据会保存下来，以后不用再登录。

如果你设置了环境变量 ANTHROPIC_API_KEY，Claude Code 会问你要不要用这个 key；你同意之后就跳过登录。
用 Console 账号第一次登录时，Console 里会自动建一个名叫“Claude Code”的工作区，方便集中看花费。
以后想换账号或重新登录，在会话里输入 /login。

启动后会看到输入框，上方显示版本、当前模型和工作目录。

4第一次对话

先问一个不改动任何文件的问题：

what does this project do?

Claude Code 会按需要自己去读项目文件，不用你手动提供。然后试一个小改动：

add a hello world function to the main file

它会找到合适的文件并把改动给你看。如果它在动手前询问，选 Yes 批准。

哪些操作可以不问你就执行，由会话的权限模式决定；随时可以按 Shift+Tab 切换。

最常用的命令

在哪里用	命令	作用
终端	`claude`	启动交互模式
终端	`claude "任务"`	启动并带上第一句话
终端	`claude -p "问题"`	问一次就退出
终端	`claude -c`	继续当前目录下最近的一次对话
终端	`claude -r`	选一个以前的对话恢复
会话里	`/help`	查看可用的命令
会话里	`/clear`	清空对话记录
会话里	`/exit`，或按两次 Ctrl+D	退出

更新

原生安装：启动时和运行期间会定期检查更新，在后台下载安装，下次启动时生效。想立刻更新就运行 claude update。
Homebrew：brew upgrade claude-code（装的是最新版那个包就用 brew upgrade claude-code@latest）。
WinGet：winget upgrade Anthropic.ClaudeCode。
npm：npm install -g @anthropic-ai/claude-code@latest。官方提醒不要用 npm update -g，它可能不会升到最新版。

用 Homebrew 或 WinGet 装的人要特别留意：它们默认不自动更新，而新模型有时需要更新的 Claude Code 版本才能用。想让 Claude Code 替你执行升级命令，可以把环境变量 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设为 1。

想用更稳的版本

原生安装默认跟最新版。想改成稳定版（通常晚一周左右，跳过有严重问题的版本），在会话里用 /config 找到 Auto-update channel，或者在 settings.json 里写：

{
  "autoUpdatesChannel": "stable"
}

官方也提醒了代价：刚发布的新模型可能需要比稳定版更新的 Claude Code，这时要切回最新版才能用。

卸载

原生安装（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`（或 `claude-code@latest`）
WinGet	`winget uninstall Anthropic.ClaudeCode`
npm	`npm uninstall -g @anthropic-ai/claude-code`

上面这些只删除程序本身。你的设置、允许的工具、MCP 服务器配置和会话历史保存在 ~/.claude 目录和 ~/.claude.json 文件里。删掉它们会丢失全部设置和历史，确定不要了再删。VS Code 扩展、JetBrains 插件和桌面应用也会往 ~/.claude 里写东西，它们还装着的话，这个目录会被重新建出来。

卸载之后 claude 还能运行，多半是电脑上还有另一份安装，或者旧安装方式留下的别名。

常见报错

现象	意思	怎么办
提示找不到 `claude`，或不是可识别的命令	安装目录还没有加进 PATH	先新开一个终端窗口再试；还不行就按官方排错页的“Fix your PATH”处理
`The token '&&' is not a valid statement separator`	你在 PowerShell 里运行了 CMD 的命令	换成 PowerShell 那一条
`'irm' is not recognized as an internal or external command`	你在 CMD 里运行了 PowerShell 的命令	换成 CMD 那一条
`syntax error near unexpected token '<'`，或者 `403`	安装脚本没有正常下载下来	官方排错页按报错给出了对应的处理办法和其他安装方式
Alpine 上安装命令报 `not found`	系统里没有 `bash` 和 `curl`	先运行 `apk add bash curl libgcc libstdc++ ripgrep`，再在 `settings.json` 的 `env` 里把 `USE_BUILTIN_RIPGREP` 设为 `"0"`
npm 安装时出现 `EBADENGINE` 警告	Node.js 版本低于 22	只是警告，安装会完成，`claude` 也能运行

官方的安装和登录排错页：https://code.claude.com/docs/en/troubleshoot-install

在国内使用

官方的要求有两条和国内用户直接相关：需要联网访问 Anthropic 的服务，并且所在地区要在 Anthropic 支持的国家和地区名单内。安装命令本身也要从 claude.ai 下载脚本。

很多国内用户通过中转站来使用 Claude Code。中转站是什么、有哪些风险，见本站的指南：中转站是什么。

下一步

装好之后，建议先在一个自己熟悉的小项目里用几天，再去看 effort 和模型怎么选、skills 和 hooks 怎么用。这个系列的后续文章会逐一讲到。