Claude Code 入门指南②：3分钟安装完成，这些坑千万别踩

? 2026-04-15 | 数字彩云 · Claude Code 修炼手册 · 第2篇（共7篇）

前言

上一期（准备篇）我们聊了 Claude Code 是什么、需要哪些前置准备。今天这篇，直接上手安装！

3种安装方式，总有一种适合你。 安装过程本身很简单，但有几个坑我帮你提前踩平，看完保证顺顺利利装好。

一、方式一：npm 全局安装（⭐ 推荐）

这是官方最推荐的安装方式，适合绝大多数用户。

前提条件

• Node.js v18 或更高版本
• npm（随 Node.js 一起安装）

安装命令

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

安装完成后，终端输入以下命令验证：

claude --version

如果输出版本号（如 0.x.x），说明安装成功 ✅

? 提示：国内用户如果 npm 安装慢，可以用淘宝镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

二、方式二：Homebrew 安装（macOS / Linux 用户）

如果你用 macOS 或 Linux，并且已经装了 Homebrew，用这个最方便：

brew install claude-code

验证安装：

claude --version

⚠️ 注意：Windows 用户请跳过此方式。Homebrew 在 Windows 上需要 WSL2 环境。

三、方式三：npx 免安装直接用

不想全局安装？每次临时用也行：

npx @anthropic-ai/claude-code

这种方式每次运行都会临时下载，速度稍慢。适合尝鲜体验，不建议长期使用。

四、配置 API Key

安装完成后，首次运行 Claude Code 时会提示你输入 API Key。

方法一：设置环境变量（推荐）

# macOS / Linux
export ANTHROPIC_API_KEY="sk-ant-xxxxx..."

# Windows PowerShell
$env:ANTHROPIC_API_KEY="sk-ant-xxxxx..."

# Windows CMD
set ANTHROPIC_API_KEY=sk-ant-xxxxx...

? 永久生效：把上面的命令加到你的 Shell 配置文件（~/.bashrc / ~/.zshrc / $HOMEDocumentsPowerShellMicrosoft.PowerShell_profile.ps1）里，重启终端后自动生效。

方法二：首次运行时输入

直接运行 claude 命令，终端会提示你粘贴 API Key：

Welcome to Claude Code!
Enter your Anthropic API Key: sk-ant-xxxxx...

五、验证安装成功

配置好 API Key 后，运行：

claude

看到以下界面，说明一切正常：

╔══════════════════════════════════════════════════╗
║          Claude Code v0.x.x                      ║
║     Type 'exit' to quit at any time             ║
╚══════════════════════════════════════════════════╝

You:

试着输入一句话，比如：

帮我写一个 Hello World 的 Python 脚本

Claude 会帮你生成代码，并写入文件。?

六、常见报错 & 解决方案

报错一：command not found: claude

原因：npm 全局安装路径没加到 PATH 里。

解决：

# 查看 npm 全局路径
npm config get prefix

# 确认 node_modules/.bin 在 PATH 中
echo $PATH

Windows 用户：打开「系统属性 → 环境变量」，确保 C:Users你的用户名AppDataRoaming pm 在 PATH 里。

报错二：ANTHROPIC_API_KEY is not set

原因：API Key 没配置或环境变量没生效。

解决：

# 检查环境变量是否设置
echo $ANTHROPIC_API_KEY   # macOS/Linux
echo %ANTHROPIC_API_KEY%   # Windows

# 如果为空，重新设置
export ANTHROPIC_API_KEY="sk-ant-xxxxx"  # macOS/Linux
$env:ANTHROPIC_API_KEY="sk-ant-xxxxx"   # PowerShell

报错三：npm 安装时报 EACCES 权限错误（macOS/Linux）

原因：没有全局写权限。

解决：

# 方案一：修复 npm 权限
sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules

# 方案二：使用 npx 代替（最省事）
npx @anthropic-ai/claude-code

报错四：Windows 用户提示 claude.ps1 无法运行

原因：PowerShell 执行策略限制。

解决（以管理员身份运行 PowerShell）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

七、三种安装方式对比

八、接下来看什么？

安装成功后，下一篇（使用篇）我们一起来看：

• Claude Code 的基本交互流程
• 常用命令一览表
• 提升效率的5个技巧

安装遇到问题？评论区留言，下一篇我帮你解答！

? 往期回顾：

• 第1篇（准备篇）：Claude Code 入门指南①：这些准备做对了，后面的路就顺了

? 下期预告：

• 第3篇（使用篇）：Claude Code 入门指南③：核心操作详解，看完就会用