Claude Code 安装分两步：安装 CLI 本体，然后登录认证。macOS 用 Homebrew 一行命令搞定；Windows 先装 Node.js 再 npm 安装；Linux 推荐用 fnm 安装 Node.js 后再装。认证支持 Claude.ai 订阅账号和 Anthropic API Key 两种方式。

Claude Code 安装指南：macOS、Windows、Linux 全平台

系统要求

• Node.js：v18 或更高（macOS 通过 Homebrew 安装时自动满足）
• 网络：需要能访问 Anthropic 服务
• 认证：Claude Pro/Max 订阅，或 Anthropic API Key

---

macOS 安装

# 1. 如果没有 Homebrew，先安装它
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. 安装 Claude Code
brew install --cask claude-code

# 3. 验证安装
claude --version

如果已有 Homebrew，只需第 2 步。

---

Windows 安装

1. 安装 Node.js

• 访问 nodejs.org
• 点击 "Download Node.js (LTS)" 下载 .msi 安装包
• 运行安装包，点击 Next 按默认选项安装

2. 验证 Node.js

打开 PowerShell 或 Windows Terminal（重新开一个新窗口）：

node --version   # 应显示 v18.x 或更高
npm --version

3. 安装 Claude Code

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

如果出现权限错误，以管理员身份运行终端（右键 → 以管理员身份运行），再重试。

4. 验证安装

claude --version

---

Linux 安装

推荐方式：fnm（Node.js 官方推荐）

fnm（Fast Node Manager）是 Node.js 官网"推荐（官方）"分类下的版本管理器，安装后不需要 sudo 执行全局包安装。

1. 安装 fnm

访问 nodejs.org/en/download，将 Package Manager 选择为 fnm，页面会生成对应命令，通常如下：

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 重载 shell 配置
source ~/.bashrc   # zsh 用户改为 source ~/.zshrc

# 安装 Node.js LTS
fnm install --lts

2. 安装 Claude Code

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

3. 验证

node --version   # v18 或更高
claude --version

---

备用方式：发行版包管理器

适合不需要版本管理、只需快速安装的场景。安装后需确认版本 ≥ v18。

Ubuntu / Debian：

sudo apt update
sudo apt install -y nodejs npm

# 确认版本
node --version   # 必须 >= v18

Fedora：

sudo dnf install -y nodejs npm

Arch Linux：

sudo pacman -S nodejs npm

安装 Claude Code：

# 如果有权限报错，先修复 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 再安装
npm install -g @anthropic-ai/claude-code

---

WSL（Windows Subsystem for Linux）

WSL 内跟 Linux 安装方式完全相同，在 WSL 终端中按 Linux 步骤操作即可。

---

登录认证

所有平台安装完后，在终端运行 claude，首次启动会进入认证流程。

方式 1：Claude.ai 订阅账号（Pro/Max）

1. 选择 Claude.ai account
2. 浏览器自动打开 → 登录并授权
3. 返回终端，登录完成

适合个人使用 Claude Pro 或 Max 订阅的用户。

方式 2a：API Key（团队邀请）

团队管理员通过 Anthropic 控制台邀请你：

1. 收到邀请邮件 → 接受邀请，创建 Anthropic 账号
2. 在终端运行 claude
3. 选择 Anthropic API Key
4. Key 在控制台自动生成，无需手动操作
5. Claude Code 立即可用

方式 2b：API Key（手动输入）

如果你已有 API Key（别人分享的，或自己在 console.anthropic.com 创建的）：

1. 在终端运行 claude
2. 选择 Anthropic API Key
3. 粘贴你的 Key（格式：sk-ant-...）
4. Key 永久保存，下次不再询问

---

验证安装完整性

node --version    # v18.x 或更高
claude --version  # 显示已安装的 Claude Code 版本号

两个命令都有输出即安装成功，运行 claude 即可开始使用。

---

常见问题

Q: macOS 上 brew install 报错说找不到 cask？
A: 先运行 brew update 更新 Homebrew 索引，再重试安装命令。

Q: Windows 上 claude 命令找不到，但 npm 安装没有报错？
A: npm 全局 bin 目录可能不在 PATH 中。运行 npm config get prefix，将输出路径下的 bin 子目录加入系统 PATH 环境变量，然后重开终端。

Q: Linux 用系统包管理器装的 Node.js 版本太低（低于 v18）怎么办？
A: 改用 fnm 安装。它会把 Node.js 装在用户目录下，不影响系统 Node.js，不需要 sudo，可以按需切换版本。

Q: 用 API Key 登录后，Key 存在哪里？
A: Key 存储在本地配置文件中（通常在 ~/.claude/ 目录下）。不会上传到任何远端服务器，只在你本机使用。

Q: 订阅账号和 API Key 有什么区别？
A: 订阅账号（Pro/Max）通过 OAuth 登录，使用你订阅内的额度；API Key 按 token 用量计费，适合团队共享或批量自动化场景。两者功能相同，区别在于计费方式。