Claude Code安装全攻略：Windows/Mac/Linux三平台图文教程

后台每天有人问 Claude Code 安装教程 的事。有人说 Mac 上装不了，有人说 Windows 报错，还有人 Linux 装完但跑不起来。

其实 Claude Code 安装教程 不复杂，但每个平台都有几个坑。今天把三个平台的完整安装步骤写清楚，附带常见报错处理。你照着做，10 分钟搞定。

先甩结论：安装前要准备什么

不管哪个平台，你需要先搞定两件事：

1. Node.js 18 以上版本。 Claude Code 是基于 Node.js 的 CLI 工具，没有 Node 跑不了。去 nodejs.org 下载对应平台的安装包。

2. Anthropic 账号。 注册 console.anthropic.com，拿到 API Key 或者订阅了 Pro/Max。没账号的话，装完了也用不了。

准备好这两样，下面的平台教程选一个跟着走。

Windows 安装步骤

Windows 装 Claude Code 安装教程 是被问最多的，因为坑最多。

第一步：装 Node.js

去 nodejs.org 下载 Windows 版 LTS 安装包（.msi）。双击安装，一路下一步就行。装完打开 PowerShell，输入：

node --version

显示 v18.xx.x 或更高就对了。如果提示「不是内部命令」，说明环境变量没配好。重启电脑通常能解决。

第二步：用 npm 全局安装 Claude Code

打开 PowerShell，运行：

npm install -g @anthropic-ai/claude-code

如果你在国内网络，这一步可能很慢或者报错。解决方案是先换源：

npm config set registry https://registry.npmmirror.com

换完再装。装完验证：

claude --version

第三步：配置 API Key

Claude Code 需要知道你的 API Key 才能调用。在 PowerShell 里设置环境变量：

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '你的key', 'User')

设完关掉 PowerShell，重新打开。输入 claude 启动，如果提示连接成功就 OK 了。

Windows 常见报错：

报错「command not found: claude」→ npm 全局路径没在 PATH 里。运行 npm config get prefix 拿到路径，把这个路径加到系统环境变量 PATH。

报错「EACCES permission denied」→ 权限问题。用管理员权限打开 PowerShell 再装。

报错「ENOTFOUND」→ 网络问题。确认你的代理能访问 Anthropic 的服务器。

Mac 安装步骤

Mac 相对顺利，但也有两个小坑。

第一步：装 Node.js

推荐用 Homebrew 装：

brew install node

或者去 nodejs.org 下载 Mac 版安装包。装完验证：

node --version

第二步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

Mac 上这步一般不会出错。装完验证 claude --version。

第三步：配置 API Key

Mac 配环境变量跟 Windows 不一样。打开终端，编辑你的 shell 配置文件：

如果你用 zsh（Mac 默认）：

echo 'export ANTHROPIC_API_KEY="你的key"' >> ~/.zshrcsource ~/.zshrc

如果你用 bash：

echo 'export ANTHROPIC_API_KEY="你的key"' >> ~/.bash_profilesource ~/.bash_profile

设完输入 claude 启动。

Mac 常见报错：

报错「zsh: command not found: claude」→ npm 全局路径不在 PATH 里。运行 npm config get prefix，把结果加到 ~/.zshrc 的 PATH 中。

报错「EACCES」→ 不要用 sudo 装。用以下命令修复 npm 权限：

mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrcsource ~/.zshrc

然后重新 npm install -g @anthropic-ai/claude-code。

Linux 安装步骤

Linux 是 Claude Code 安装教程 里最顺的，基本不会出问题。

第一步：装 Node.js

根据你的发行版选：

Ubuntu/Debian：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt install -y nodejs

CentOS/RHEL：

curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -sudo yum install -y nodejs

验证 node --version。

第二步：安装 Claude Code

npm install -g @anthropic-ai/claude-code

第三步：配置 API Key

echo 'export ANTHROPIC_API_KEY="你的key"' >> ~/.bashrcsource ~/.bashrc

输入 claude 启动。

Linux 上基本不会出问题。如果有，通常是网络层面的——服务器在墙外，需要配代理。

三个平台通用：装完后的第一步

不管你用的哪个平台，装完后建议先跑一个测试：

claude

然后在交互界面输入：

你好，请做个自我介绍

如果 Claude 正常回复，说明安装和配置都成功了。

接下来你可以初始化一个项目：

cd 你的项目目录claude

Claude Code 会自动读取当前目录的文件，开始帮你干活。

用订阅而不是 API Key

如果你买了 Pro 或 Max 订阅，不需要配 API Key。直接运行 claude，第一次会提示你登录。用浏览器打开授权链接，完成 OAuth 登录就行。

订阅方式的好处是不用管余额，坏处是用量有上限。Claude Code 安装教程 这一步两种方式都能用，看你自己选。

FAQ

Q1：能不能不装 Node.js？

不能。Claude Code 本质是 Node.js CLI 工具，没有 Node 跑不了。如果你实在不想装 Node，可以用 Anthropic 的 Web 版（claude.ai），但功能不一样。

Q2：装了之后怎么更新？

npm update -g @anthropic-ai/claude-code

建议每月更新一次，Anthropic 迭代很快，新功能不少。

Q3：多台电脑能装同一个账号吗？

能。API Key 和订阅都不限设备数。你在公司电脑和家里电脑都能装，用同一个账号。

Q4：装的时候报 SSL 证书错误怎么办？

通常是代理或防火墙的问题。如果你在用企业网络，问 IT 是否有中间人证书。个人网络的话，试试关掉代理再装。

总结：别被安装劝退

Claude Code 安装教程 的门槛其实很低，核心就三步：装 Node、装 Claude Code、配 Key。大部分报错都是网络和权限问题，不是软件本身的 bug。

如果你按照这篇装了还是有问题，把报错截图发我后台，我帮你看看。

想要我整理的安装检查清单和常见报错速查表？

公众号后台回复「安装」，我发你。不收费，交个朋友。

关于「Claude Code 企业服务」

这里只聊一件事：怎么把 Claude Code 真正用到企业里。

从订阅开通、Skill 蒸馏、API 对接到企业知识库搭建，我会把实操经验、避坑指南和模板资源直接写清楚。

不画大饼，不卖课，不收费。

觉得有用就点个关注，有问题直接留言，看到都会回。

交个朋友。