# Claude Code 完整安装流程说明 · v1.0

> 这是所有 AI 能力的"引擎"。装好它，再装技能包，即可开工。全程约 10 分钟。

---

## 一、环境要求

| 项目 | 说明 |
|---|---|
| 操作系统 | Windows 10+ / macOS 10.15+ / Linux（Ubuntu 20.04+、Debian 10+）/ WSL |
| Node.js | **18 或更高**（仅「npm 安装方式」需要；原生安装器自带运行时，无需 Node） |
| Git | 推荐安装（版本管理、很多工作流会用到） |
| 账号 | 一个 **Claude 账号**（Pro/Max 订阅）**或** 一个 **Anthropic API Key** |
| 网络 | 需能正常连通 `claude.ai`（国内访问请确保网络畅通） |

---

## 二、第 1 步：安装 Claude Code

任选一种方式。**官方原生安装器最简单**：自带运行时、自动更新、无需 Node。

### 方式 A · 原生安装器（推荐）

**Windows（PowerShell）**
```powershell
irm https://claude.ai/install.ps1 | iex
```

**macOS / Linux / WSL（终端）**
```bash
curl -fsSL https://claude.ai/install.sh | bash
```

### 方式 B · npm（需先安装 Node.js 18+）
```bash
npm install -g @anthropic-ai/claude-code
```

> 验证是否装好：
> ```bash
> claude --version
> ```

---

## 三、第 2 步：进入项目并启动

打开终端，进到你的工作文件夹，输入 `claude` 启动：

```bash
cd 你的项目文件夹
claude
```

启动后即进入对话界面，可以直接说人话给它派活。

---

## 四、第 3 步：登录授权 + 验证

首次运行会提示登录，二选一：

- **Claude 订阅账号**：用 claude.ai 的 Pro/Max 账号登录（按提示在浏览器完成授权）。
- **Anthropic API Key**：在 <https://console.anthropic.com> 创建 Key，按提示填入。

常用命令：

```bash
/login          # 在对话里切换登录方式（订阅 / API Key）
claude doctor   # 体检：检查安装与环境是否正常
claude update   # 更新到最新版本（原生安装器通常会自动更新）
```

---

## 五、第 4 步：安装技能包（Skills）

装好 Claude Code 后，把「大学生通用 Skill 包」装上，能力立刻翻倍：

1. 解压 `大学生通用Skill包_v1.0.0.zip`。
2. 双击里面的 **`一键安装.bat`**，脚本会把全部技能复制到 `%USERPROFILE%\.claude\skills\`。
3. 重启 Claude Code 即可生效 —— 之后只要"说人话"就能触发对应技能。

> 想加新能力？把别人发你的 skill 文件夹丢进 `.claude\skills\` 就行 —— 像给 Agent 招新员工。

---

## 六、常见问题（FAQ）

**Q：必须装 Node.js 吗？**
A：用「原生安装器」不需要；只有走 npm 方式才需要 Node 18+。

**Q：`claude` 命令找不到 / 不生效？**
A：关掉终端重开一次（让 PATH 生效）；或运行 `claude doctor` 查看诊断；npm 方式确认全局 bin 在 PATH 里。

**Q：没有订阅可以用吗？**
A：可以用 Anthropic API Key（按用量计费）；或开通 Claude Pro/Max 订阅。

**Q：国内网络连不上？**
A：确保网络能访问 `claude.ai` 与 `console.anthropic.com`。

---

*配套《大学生 AI 能力使用手册》· Powered by Claude · 2026*