按 2026 年的方式安装 Claude Code

先选一条安装路

2026 年官方文档推荐原生安装。macOS、Linux 和 WSL 共用一条 curl 到 bash 的脚本。Windows PowerShell 用官方 install.ps1 的 irm。本教程先走这条路。

Homebrew 有 cask claude-code。WinGet 有 Anthropic.ClaudeCode。你已经住在那个包管理器里就可以用。它们的自动更新往往和原生安装不一样。

全局 Node 包仍可能出现在进阶文档。这里不把它当首选。它最容易留下两份二进制和过期的大版本。

• 除非你已经统一用 brew 或 WinGet，否则走原生脚本。
• 一台机器一种方法。
• 桌面应用是另一扇门，不是第二条 CLI。

原生安装，然后换新终端

macOS、Linux 或 WSL 的公开命令是 curl -fsSL https://claude.ai/install.sh 再交给 bash。看清脚本 URL。不要换成随机 GitHub raw。

Windows PowerShell 的公开命令是 irm https://claude.ai/install.ps1 再交给 iex。若 irm 不存在，你多半在 CMD 而不是 PowerShell。

二进制常常落到 ~/.local/bin（Windows 则是用户目录下的 .local\bin）。安装器说成功但找不到 claude，先查 PATH。

关掉你用来安装的那个终端。新开一个，让 shell 重新加载 PATH。再进入项目运行 claude。

1. 抄当天官方的一行命令。
2. 除非页面要求，否则不要 sudo。
3. 换新终端。
4. cd 进项目再运行 claude。

Homebrew 和 WinGet

Homebrew：brew install --cask claude-code。若要最新通道，可能还有 latest cask。升级靠 brew upgrade，而不是默记一套自动更新。

WinGet：winget install Anthropic.ClaudeCode。升级用 winget upgrade。不要和残留的原生二进制混在 PATH 里却不检查 which。

部分 Linux 发行版还有 apt、dnf 或 apk 源。用它们就按发行版升级，不要按本教程记忆的某个参数。

• 只用一个包管理器。
• 写下升级命令。
• 装完后 which claude。

为什么不从 Node 全局包开始

进阶文档仍可能展示全局包。2026 年推荐原生安装。Node 全局包最容易带来权限问题和两个版本。

若已经有旧的全局包，等 doctor 指出 PATH 上哪一个在前，再删或忽略。不要 sudo 全局安装。

• 优先原生、brew 或 WinGet。
• 若全局包还在，先让 doctor 看。
• 永远不要 sudo 全局安装。

登录和密钥

第一次在项目里运行 claude，通常会打开浏览器。请用真正拥有 Code 权限的账号。

若已经设置 ANTHROPIC_API_KEY，客户端可能让你批准这把密钥，而不是走浏览器。密钥绝不进仓库。

套餐名称会变。登录成功但 Code 被拒，是账号门槛，不是二进制坏了。去看官方账号页，不要看推文。

• 在真实项目目录做浏览器登录。
• 密钥只放环境变量，永不提交。
• 账号拒绝不是 PATH 故障。

PATH 和 ~/.local/bin

原生安装常见把启动器放进 ~/.local/bin。有些 shell 从未加入该目录。症状是安装器很高兴，命令却找不到。

which claude 和 claude --version 必须指向你刚装的那份。对不上，就是有两份。

WSL 和 Windows 原生是两套家目录。不要在 PowerShell 改 PATH，却只在 WSL 里测试。

• 先换新终端。
• 安装器若提到 ~/.local/bin，就加进 PATH。
• 在你真正工作的那个 shell 里 which 一次。

拒绝终端时用桌面应用

独立桌面应用存在。登录后打开 Code 标签即可。这是正经入口，不是玩具。

若你同时保留 CLI，仍应知道 doctor 和 PATH。只想用桌面端的人，可以略过 CLI 校验，先待在应用里。

• 从官方桌面端链接下载。
• 不要再撒三条 CLI。
• 以后加终端时仍用同一份 CLAUDE.md。

安装阶段的错法

把来源不明的脚本管进 bash，只因为有人说它能装 Claude。

留着旧全局包和新原生安装，却向过期的那份报 bug。

• 不换新终端。
• 出于习惯 sudo。
• 桌面端和 CLI 都装，却怪错的那一个。

先校验，再做第一个任务

claude --version 应打出版本。claude doctor 打印安装健康和设置警告，但不会开始写代码。

doctor 在发脾气，就留在本章或去排错。不要在坏掉的 PATH 上写 CLAUDE.md。

1. 新终端。
2. claude --version。
3. claude doctor。
4. 在练习仓库里运行 claude。

做到这样就够了

你能启动一个客户端，并指着 doctor 的输出说话。

1. 一种安装方法。
2. 新终端能用。
3. version 和 doctor 都能跑。
4. 知道二进制在哪。
5. git 里没有密钥。

下一章：一个可回看的任务

下一章停在练习仓库，说出禁令，只要一小段 diff。

MCP 和技能继续等。doctor 失败就先跳排错。