第0步：安装 Claude Code

欢迎来到你的Claude Code职场升级之旅！这一步我们会一起完成Claude Code的安装，让你准备好开始第一个项目。

💡 别担心

命令行（终端）只是一个工具，就像使用微信聊天一样简单。Claude Code会在这个窗口里和你对话，帮你完成所有工作。

安装前准备

1. 检查你的系统

首先确认你的电脑系统：

• Windows 10 或更高版本 ✅
• macOS 11 或更高版本 ✅

如何查看系统版本？

Windows：

1. 按 Win + R 键
2. 输入 winver 并回车
3. 会弹出一个窗口显示你的Windows版本

macOS：

1. 点击左上角苹果图标
2. 选择"关于本机"
3. 查看macOS版本号

2. 准备网络环境

国内用户注意

如果你在中国大陆，访问 Anthropic 服务需要科学上网。请确保：

• 代理软件已启动
• 代理模式设置为"系统代理"或"TUN模式"
• 可以正常访问 Google 和 Anthropic 官网

3. 关闭杀毒软件（Windows用户）

一些杀毒软件会误报并拦截 Claude Code 的安装，建议：

• Windows Defender：暂时关闭"实时保护"
• 第三方杀毒软件：暂时退出或添加白名单

安装完成后可以重新开启。

---

Windows 安装指南

步骤1：打开终端

有几种方式打开 Windows 终端：

::: tabs

方式1：使用PowerShell（推荐）

1. 按 Win + R 键
2. 输入 powershell 并回车
3. 会看到一个蓝色窗口，这就是终端

方式2：使用Windows Terminal

如果你安装了 Windows Terminal（新款）：

1. 按 Win + R 键
2. 输入 wt 并回车

方式3：使用命令提示符

1. 按 Win + R 键
2. 输入 cmd 并回车 :::

步骤2：安装 Claude Code

在打开的终端中，复制并粘贴以下命令，然后按回车：

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

如何粘贴到终端？

在 PowerShell 中：

• 鼠标右键点击窗口 = 粘贴
• 或直接使用 Ctrl + V

在 CMD 中：

• 鼠标右键点击窗口 = 粘贴

步骤3：等待安装完成

安装过程需要下载大约 200MB 的文件，根据网速不同，可能需要 1-5 分钟。

你会看到类似这样的输出：

added 1 package in 45s

如果看到错误信息，请查看后面的常见问题部分。

步骤4：验证安装

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

claude --version

如果安装成功，你会看到版本号输出，例如：

claude-code x.x.x

步骤5：启动 Claude Code

第一次启动时，Claude Code 会引导你完成认证：

claude

按照提示操作：

1. 会自动打开浏览器
2. 登录你的 Anthropic 账号（如果没有账号会提示注册）
3. 授权完成后回到终端

:::恭喜！🎉 你已经成功安装并启动了 Claude Code！:::

---

macOS 安装指南

步骤1：打开终端

1. 按 Command + 空格 打开 Spotlight 搜索
2. 输入"终端"或"Terminal"
3. 按回车打开终端

步骤2：安装 Homebrew（如果还没有）

在终端中输入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按回车后，根据提示完成安装。可能需要输入你的电脑密码。

为什么需要 Homebrew？

Homebrew 是 macOS 上最流行的包管理器，让我们可以方便地安装各种开发工具。

步骤3：安装 Claude Code

在终端中输入：

brew install anthropic-ai/claude-code/claude-code

等待安装完成（可能需要几分钟）

步骤4：验证安装

claude --version

应该看到版本号输出。

步骤5：启动 Claude Code

claude

按照浏览器提示完成认证即可。

---

常见错误

错误1：npm 不是内部或外部命令

原因：你的电脑没有安装 Node.js

解决方法：

1. 访问 https://nodejs.org/
2. 下载并安装 LTS 版本（长期支持版）
3. 安装完成后重新打开终端
4. 再次运行安装命令

错误2：权限错误 (EACCES)

原因：没有管理员权限

解决方法：

1. 以管理员身份运行 PowerShell
   • 按 Win 键，搜索"PowerShell"
   • 右键点击"Windows PowerShell"
   • 选择"以管理员身份运行"
2. 重新运行安装命令

错误3：网络超时或连接失败

原因：网络问题或代理配置问题

解决方法：

# 如果使用 npm，设置代理（替换成你的代理地址）
npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890

# 然后重新安装
npm install -g @anthropic-ai/claude-code

错误4：杀毒软件拦截

原因：杀毒软件误报

解决方法：

1. 暂时关闭杀毒软件
2. 重新安装 Claude Code
3. 安装完成后将 Claude Code 添加到杀毒软件白名单
4. 重新开启杀毒软件

错误5：认证失败

原因：网络问题或 Anthropic 服务不可用

解决方法：

1. 确认代理正在运行
2. 尝试访问 https://anthropic.com 确认可以访问
3. 清除浏览器缓存后重试
4. 如果使用企业网络，可能需要联系IT部门

---

下一步

安装完成后，你准备好开始第一个项目了！

▶️ 进入项目1：本地邮件正文生成器

---