Claude Code 安装教程：Mac/Win/Linux 全流程
Claude Code 安装看官方一句 curl 命令容易踩坑，本文按 Mac、Windows、Linux 三个平台拆细，含 Node 版本、PATH 不识别、企业代理、TLS 证书等常见错的解决办法
30 秒先看：Claude Code 安装到底要做几件事
Claude Code 安装本身就 3 件事：装运行环境（Node 18+）、跑一行命令把 CLI 拉下来、再 claude login 登一下账号。 顺利的话整个过程 5 分钟。
但 Anthropic 官方那篇 troubleshoot 文章之所以存在，是因为这三件事里每一件都可能在不同平台卡住——Mac 的 Gatekeeper、Windows 的 PowerShell 执行策略、Linux 的 PATH 写入、公司电脑的 Cloudflare 代理、用 nvm 装的 Node 又跟 root 权限打架。
这篇会按 Mac、Windows、Linux 三个平台分别走一遍，最后单独整一节讲所有「装不上」的常见错误怎么定位。装之前先想清楚一件事：如果你完全不知道 Claude Code 是什么、能干嘛、跟 Cursor 有啥区别，先看 Claude Code 是什么 再回来。
装之前先确认 4 件事
跳过这步直接装很容易翻车，先花 1 分钟确认下面 4 项：
1. 账号：你能登录 Claude 吗
Claude Code 跑起来要登录 Anthropic 账号。如果你还没有，先去 claude.ai 注册一个——国内注册要走海外手机号 + 海外信用卡。注册流程跟 Claude 网页版完全一样，详细看 Claude 注册教程。
如果你打算用 API key 而不是订阅，准备好一个 sk-ant-... 开头的 key。
2. Node.js 版本：必须 18 或更高
打开终端跑一句：
node -v如果输出 v18.x.x、v20.x.x、v22.x.x 就 OK。如果输出 v16.x.x 或者更低，或者直接说 command not found，先去装 Node 18+。
推荐用 nvm（Node 版本管理器）装，省得以后跟系统 Node 打架：
# Mac / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --ltsWindows 用户用 nvm-windows 或者直接去 nodejs.org 下安装包。
3. 终端：你打算在哪个终端里跑
| 平台 | 推荐终端 |
|---|---|
| Mac | iTerm2、Ghostty、自带 Terminal |
| Windows | Windows Terminal + PowerShell 7、WSL2 里的 bash |
| Linux | 任何 bash / zsh / fish 都行 |
Claude Code 是命令行工具，对终端没特殊要求，但建议用支持 24-bit 颜色和 Unicode 的现代终端，体验好太多。
4. 网络：能不能稳定连 anthropic.com
Claude Code 跑的时候要频繁请求 api.anthropic.com。国内直连这域名不稳定，需要稳定的代理。如果你公司或学校有出网代理，准备好 http://proxy:port 这种地址，后面装的时候会用到。
Mac 安装：3 种方式任选
方式 1：官方原生安装脚本（最推荐）
打开 Terminal，跑这一行：
curl -fsSL https://claude.ai/install.sh | bash这个脚本会下载预编译的二进制，自动放到 ~/.claude/bin/ 并加进 PATH。装完看到 Installation complete 就成功。
方式 2：Homebrew
如果你电脑上有 Homebrew（大部分 Mac 开发者都装了），一句话搞定：
brew install --cask claude-codeHomebrew 装的版本会自动跟着 brew upgrade 更新，省心。
方式 3：npm
如果你只想用熟悉的 npm 装：
npm install -g @anthropic-ai/claude-code注意：不要加 sudo。一旦你 sudo npm install -g，全局包会被装到 root 权限的目录，之后 Claude Code 想读写 ~/.claude/ 目录会权限错。
如果你的 npm 全局目录默认就要 sudo，先重定向：
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc然后再不带 sudo 跑 install。
验证安装
任何一种方式装完，关掉当前终端窗口，重新开一个，跑：
claude --version看到版本号就 OK。
Windows 安装：PowerShell 优先，WSL2 兜底
方式 1：PowerShell（最简单）
以管理员身份打开 PowerShell，跑：
irm https://claude.ai/install.ps1 | iexirm 是 Invoke-RestMethod，iex 是 Invoke-Expression——意思是把脚本下载下来直接执行。
如果报错 the execution of scripts is disabled on this system，先放开执行策略：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned然后再跑安装命令。
方式 2：WSL2（开发者推荐）
如果你已经在用 WSL2 + Ubuntu，强烈建议在 WSL 里装。Linux 环境下 Claude Code 跟一切 unix 工具（grep、git、make、docker）配合最丝滑：
# 在 WSL 的 Ubuntu 里
curl -fsSL https://claude.ai/install.sh | bash方式 3：npm
npm install -g @anthropic-ai/claude-code验证
新开一个 PowerShell 或 WSL 窗口：
claude --versionLinux 安装：脚本就够，特殊发行版自己改 PATH
主流发行版（Ubuntu、Debian、Fedora、Arch、CentOS）都用同一句：
curl -fsSL https://claude.ai/install.sh | bash脚本会判断你的 shell（bash / zsh / fish），把 ~/.claude/bin 加进对应的 rc 文件。装完 source ~/.bashrc（或 ~/.zshrc）激活，或者直接开新窗口。
如果你用的是 nix、alpine 这种小众发行版，脚本可能识别不出 shell，自己手动加：
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc装完第一件事：登录
不管你哪种方式装的，装完都要登录。在终端跑：
claude第一次启动会弹一句让你跑 /login。按它说的输入 /login，浏览器自动打开 Anthropic 登录页，登完授权回来，CLI 自动拿到 token。
不能开浏览器怎么办（SSH 远程服务器）
远程服务器没图形界面，浏览器开不起来。/login 会切到手动流程：终端打印一段 URL，你复制到本地浏览器打开、登录、把回调里的授权码粘回终端就行。
用 API key 而不是订阅
如果你想绕过订阅，直接拿 API key 付费用：
# Mac / Linux 加进 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_API_KEY=sk-ant-...
# Windows PowerShell
$env:ANTHROPIC_API_KEY = "sk-ant-..."设完重启终端，直接 claude 就跳过登录流程。
走云厂商：AWS Bedrock / GCP Vertex
公司有 AWS / GCP 账号、用云厂商的 Claude 服务：
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
# 然后配好 AWS 凭证，aws configure 走一遍
# GCP Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
# 配好 gcloud 凭证5 个最常见的安装错误怎么修
错误 1：装完 claude: command not found
最常见的错。原因：PATH 没生效。
解决：
# 看看 ~/.claude/bin 在不在
ls ~/.claude/bin/claude
# 在但找不到，手动 source
source ~/.zshrc # 或 ~/.bashrc
# 还不行，新开终端窗口（关掉当前窗口重开）Windows 用户：装完必须新开一个 PowerShell 窗口，旧窗口的环境变量不会刷新。
错误 2：Node version too old
报错说 Node 不够新。
解决：
# 看当前版本
node -v
# 用 nvm 升到 LTS
nvm install --lts
nvm use --lts
# 检查 Claude Code 现在用的 Node
which node如果 which node 显示的是 /usr/local/bin/node 而不是 nvm 路径，说明系统 Node 还在抢路径，把 nvm 的 PATH 放到 ~/.zshrc 最前面。
错误 3：npm 装报 EACCES 权限错
解决：不要用 sudo。按上面 Mac 那段把 npm 全局目录改到 ~/.npm-global，重新装。
错误 4：公司电脑装不上（代理 / TLS）
公司网络有出网代理，或者用了企业 CA 证书：
# 设代理
export HTTPS_PROXY=http://proxy.company.com:8080
export HTTP_PROXY=http://proxy.company.com:8080
# 自定义 CA 证书（解决企业网拦截 TLS 的问题）
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem加到 ~/.zshrc 里持久化，重启终端再装。
错误 5：WSL2 里 claude 找不到 node
WSL2 里如果同时存在 Windows 的 node 和 Linux 的 node，PATH 优先级可能乱。在 ~/.bashrc 最前面加：
export PATH="/usr/local/bin:/usr/bin:$PATH"让 Linux 的 node 优先于 Windows 那个被映射进来的 node。
万能诊断：claude doctor
实在搞不清楚装哪步出问题，跑：
claude doctor它会自动检查 Node 版本、PATH、网络连通性、登录状态、配置文件路径，输出一份诊断报告。报 issue 给 Anthropic 时把这个报告贴上。
装完干嘛：第一个 5 分钟实战
进到任意一个你想让 Claude Code 帮忙的项目目录：
cd ~/projects/你的项目
claude进去后会进入交互式界面。直接用中文说话，先试这个 prompt：
你好。这是这个项目的第一次 Claude Code 会话。
请帮我做下面 3 件事：
- 看一眼当前目录的结构（前两层就行），告诉我这是个什么项目
- 找有没有 README.md 或者 package.json / pyproject.toml，简单总结项目用什么技术栈
- 跑一下项目的测试或者 build 命令（如果你能找到），告诉我现在状态是不是正常
做完这 3 件事就停，等我下一步指令。
跑通这个就说明 Claude Code 装好了、能正常工作。下一步看 Claude Code 怎么用？官方上手 7 步走 把核心工作流走一遍。
装完别忘了写 CLAUDE.md
装好 Claude Code 后，强烈建议在你第一个项目根目录跑 /init 命令——它会自动帮你生成一份 CLAUDE.md，作为这个项目的「持久记忆」，以后每次启动都会读。
详细写法看 CLAUDE.md 怎么写。
下一步
- 上手 7 步走 → Claude Code 怎么用
- 写持久记忆 → CLAUDE.md 怎么写
- 命令速查 → Claude Code 命令速查表
- 进阶玩法 → Claude Code 进阶 10 技巧
- 想看其他 AI 编程工具 → AI 写代码完全指南
- 国产替代 → Kimi Code 是什么 / Kimi Code CLI 怎么用
常见问题
Q：Claude Code 安装包多大？需要联网装吗？ A：原生安装脚本拉的二进制大约 80-120 MB（不同平台略有差别）。装的过程必须联网，装完日常使用也要联网——它每次执行都要请求 Anthropic API。
Q：能不能离线装？
A：不能。即使你想办法把安装包搬到离线机器，运行时还是要访问 api.anthropic.com，没网络它做不了任何事。
Q：能不能装多个版本并存？
A：默认不行。Claude Code 跟着账号订阅走最新版，频繁更新。如果你需要锁版本，用 npm 装并指定版本：npm install -g @anthropic-ai/claude-code@版本号（比如 @1.2.3）。
Q：装完每次跑 claude 要重新登录吗？
A：不用。登录状态存在 ~/.claude/credentials.json，长期有效。除非你主动 /logout 或者 token 过期才会让你重登。
Q：跟 Claude Desktop 是一个东西吗？ A：不是。Claude Desktop 是 Mac/Windows 的图形客户端（聊天为主），Claude Code 是命令行编程工具。两个产品互不影响，装一个不影响另一个。