这一章来聊聊怎么把 Claude Code 安装到你的电脑上。别担心，整个过程就跟装一个普通软件差不多，跟着一步步来就行。

---

1.1 装之前先检查一下你的电脑

在安装 Claude Code 之前，你的电脑上需要先有两个小帮手。就像你装游戏之前得先有运行环境一样。

整个安装流程长这样：

需要准备什么？

小帮手	干什么用的	怎么看有没有装好
Node.js	Claude Code 运行需要它	打开终端输入 node -v
npm	跟 Node.js 一起来的，负责装软件	终端输入 npm -v
Git	管理文件版本（强烈建议装上）	终端输入 git --version

什么是"终端"？

就是电脑上那个可以打字的黑窗口：

• Mac 电脑：打开"启动台"，搜索"终端"（Terminal）就行
• Windows 电脑：打开"开始菜单"，搜索"PowerShell"或"命令提示符"
• Linux 电脑：你应该已经知道怎么打开了

1.1.1 先把 Node.js 装上

版本提醒

Claude Code 需要 Node.js 18 或更新的版本，太旧的可不行。

用 Mac 的朋友（推荐用 Homebrew 装）：

# 如果还没装 Homebrew，先装它（就当是 Mac 的一个"应用商店"）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 然后用它装 Node.js，就像装 App 一样简单
brew install node

用 Windows 的朋友：

1. 去 Node.js 官网 下载安装包
2. 选那个写着 LTS（长期支持）的版本，更稳定
3. 双击安装包，一路点"下一步"就行了

用 Linux 的朋友（Ubuntu/Debian）：

# 添加 Node.js 的下载源，让系统知道去哪找
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 正式安装 Node.js
sudo apt-get install -y nodejs

装完了验证一下：

# 看看 Node.js 装好没，显示版本号就说明OK
node -v
# 显示 v18.x.x 或更高的数字就对了

# npm 是跟着 Node.js 一起来的，顺便检查一下
npm -v
# 显示 9.x.x 或更高的数字就对了

1.1.2 再把 Git 装上

Mac：

# 用 Homebrew 装 Git，跟装 Node.js 一样的套路
brew install git

Windows：

去 Git for Windows 下载安装就行。

Linux：

# 一行命令装好 Git
sudo apt-get install git

验证一下：

# 确认 Git 能用了
git --version
# 显示 git version 2.x.x 就行了

---

1.2 正式安装 Claude Code

方法一：一条命令搞定（最推荐）

这是最省事的方式，在终端里输入这一行就行：

# 这一步是全局安装 Claude Code，装完之后哪里都能用
npm install -g @anthropic-ai/claude-code

遇到问题？

• Mac 或 Linux 朋友如果提示权限不够，前面加个 sudo：sudo npm install -g @anthropic-ai/claude-code
• 安装过程大概需要 1-2 分钟，取决于你的网速，耐心等一下就好

装完了验证一下：

# 确认 Claude Code 装好了没
claude --version
# 能看到版本号就说明装好了

方法二：不安装也能用

如果你不想全局安装，也可以直接运行：

# 不想全局装？用 npx 临时跑也行，就是每次都要输一长串
npx @anthropic-ai/claude-code

小建议

如果你刚接触这些，还是建议用方法一全局安装，以后用起来更方便，不用每次都输入一长串命令。

---

1.3 准备好你的 Claude 账号

Claude Code 需要你有一个 Claude 账号才能使用，就像用微信得先注册微信号一样。

1.3.1 注册一个 Claude 账号

1. 打开 claude.ai
2. 点"Sign Up"注册
3. 用邮箱或者 Google 账号注册都行

关于费用

• 免费的 Claude 账号就可以使用 Claude Code
• 付费的 Claude Pro 账号能用得更多更快
• 建议先用免费账号体验一下，觉得确实有用再考虑升级

1.3.2 用 API Key 的方式（可选）

还有一种方式是用 API Key 来登录。如果你有 Anthropic 的 API Key，可以这样操作：

1. 打开 console.anthropic.com
2. 登录后找到 API Keys 页面
3. 点"Create Key"创建一个新的密钥
4. 把密钥复制保存好（注意：这个密钥只显示一次，一定要存好）

然后把密钥设置到电脑里：

# Mac/Linux（添加到 ~/.bashrc 或 ~/.zshrc）
# 这里填你刚才复制的那个 API 密钥，别照抄示例哦
export ANTHROPIC_API_KEY="你的API密钥"

# Windows PowerShell
# Windows 用户用这个命令设置
$env:ANTHROPIC_API_KEY="你的API密钥"

安全提醒

• 这个 API Key 就像是你家的钥匙，千万不能告诉别人
• 不要把它发到网上、群里或者分享给任何人
• 万一不小心泄露了，赶紧去控制台把它删掉，重新创建一个

---

1.4 第一次打开 Claude Code

启动它

在终端里输入：

# 启动 Claude Code，就是输入这一个词就行
claude

第一次打开的时候，它会引导你登录，你会看到类似这样的画面：

╭─────────────────────────────────────╮
│  Welcome to Claude Code!            │
│                                     │
│  Let's get you set up.              │
│                                     │
│  Choose a sign-in method:           │
│  1. Sign in with Claude account     │
│  2. Sign in with API key            │
╰─────────────────────────────────────╯

选第 1 个（用 Claude 账号登录），它会自动打开浏览器让你登录。登录完回到终端，就可以开始用了。

怎么退出

用完了想退出，有几种方式：

• 输入 /exit 或 /quit
• 按 Ctrl + C 两次
• 按 Ctrl + D

---

1.5 给编辑器装个插件（可选但推荐）

虽然 Claude Code 在任何终端里都能用，但如果你平时用编辑器写东西的话，配合插件体验会更好。

VS Code（推荐）

1. 先下载安装 VS Code（免费的，很好用）
2. 装上 Claude Code 的插件：
   • 打开 VS Code
   • 按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展面板
   • 搜索"Claude Code"然后点安装

小建议

VS Code 是免费的，全世界用的人特别多。如果你还没有顺手的编辑器，试试这个准没错。

JetBrains 系列（WebStorm、IntelliJ IDEA 等）

在编辑器的 Plugins 设置里搜索"Claude Code"，装上就行。

换个好用的终端（可选）

如果你经常要用终端，可以考虑换个更顺手的终端工具：

• Mac：推荐 iTerm2 或 Warp
• Windows：推荐 Windows Terminal
• 通用：Hyper

---

1.6 最后检查一遍

运行下面几条命令，确认所有东西都装好了：

# 检查 Node.js 有没有装好
node -v

# 检查 npm 跟没跟着来
npm -v

# 检查 Git 能不能用
git --version

# 最后确认 Claude Code 也装好了
claude --version

如果每条命令都能正常显示版本号，那就说明全部准备就绪了！

搞定啦！

所有东西都装好了，下一章就来试试跟 Claude Code 说第一句话吧！

---

1.7 遇到问题怎么办

Q1: npm install 报错说"permission denied"

Mac/Linux 朋友：加个 sudo 试试：

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

或者换个安装路径（更推荐长期这样用）：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
# 然后把 ~/.npm-global/bin 添加到 PATH

Q2: Node.js 版本太旧了

如果你之前装过旧版本的 Node.js，需要先升级：

# Mac（用 Homebrew）
brew upgrade node

# 或者用 nvm（一个 Node 版本管理工具）
nvm install --lts
nvm use --lts

Q3: Claude Code 打开后登不上

• 先检查一下网络连接
• 如果是在公司网络里，可能需要配置一下代理
• 或者试试用 API Key 的方式登录

Q4: Windows 上运行报错了

• 确认装了最新的 Node.js LTS 版本
• 试试用 PowerShell 而不是 CMD
• 如果还是不行，试试用 Windows Subsystem for Linux (WSL)

Q5: 装完了但输入 claude 说找不到命令

这说明安装路径没有被电脑识别到。

# 先看看 npm 把东西装到哪里了
npm config get prefix

# 然后把这个路径/bin 添加到电脑的 PATH 环境变量里

---

小结

要点	一句话总结
Node.js 是前提	Claude Code 运行需要 Node.js 18+，提前装好它
Git 强烈建议装	虽然不是必须的，但装了之后体验更好
一条命令安装	npm install -g @anthropic-ai/claude-code 搞定一切
两种登录方式	Claude 账号登录（推荐）或 API Key 登录
API Key 要保密	就像家门钥匙，泄露了赶紧删掉重新创建
编辑器插件可选	VS Code 装个插件体验更丝滑

---

下一章来聊聊怎么跟 Claude Code 说第一句话吧！点这里去看第2章