# 案例 0：工作区安装与进入

## 这个案例解决什么问题

让你在自己的电脑上进入 Claude Code + VOC 技能包工作区，并能正常运行第一轮演示样例。

## 你需要准备什么

- VS Code
- Claude Code
- Node.js LTS
- 稳定网络
- 一个课程工作区文件夹

## 操作步骤

> 截图保存到 `docs/5.30/task/case-guides/screenshots/case-00-workspace-setup/`

### 第 1 步：用 VS Code 打开课程工作区

打开 VS Code，选择课程工作区文件夹，确认左侧文件树能看到当前项目文件。

![待补充截图](screenshots/case-00-workspace-setup/01-open-workspace.png)
![alt text](image.png)
![alt text](image-1.png)
![alt text](image-2.png)

截图说明：

### 第 2 步：打开终端并检查 Node/npx

在 VS Code 中打开终端，运行下面命令，确认 Node/npx 可用。

```powershell
node --version
npx --version
where node
where npx
```

![待补充截图](screenshots/case-00-workspace-setup/02-check-node-npx.png)
![alt text](image-3.png)
![alt text](image-4.png)

截图说明：如果 `node --version` 没有检测到版本，需要先去 Node.js 官网下载安装 LTS 版本，官网地址：https://nodejs.org/

### 第 3 步：运行 workspace smoke

在终端运行下面命令，等待命令执行完成。

```powershell
npx --yes @gangvy/claude-code-voc-intelligence@latest workspace --smoke
```

![待补充截图](screenshots/case-00-workspace-setup/03-run-workspace-smoke.png)
![alt text](image-5.png)

截图说明：如图就是技能包下载成功

### 第 4 步：确认工作区文件已生成

检查工作区里是否生成 `.mcp.json` 和 `.claude/skills/`。

![待补充截图](screenshots/case-00-workspace-setup/04-generated-files.png)
![alt text](image-6.png)

截图说明：

### 第 5 步：在 Claude Code 中跑通 sample

重启 Claude Code 后，输入下面示例 prompt，确认能输出趋势情报或 VOC 分析结果。

```text
请用 sample 模式，围绕茶饮新客转化做一轮小红书/抖音 VOC 趋势观察。
先输出第一轮初步判断、证据样本、用户顾虑和下一步验证问题。
```

![待补充截图](screenshots/case-00-workspace-setup/05-sample-output.png)
![alt text](image-7.png)
![alt text](image-8.png)
截图说明：

## 常见错误

| 问题 | 处理 |
| --- | --- |
| `npx` 无法识别 | 安装 Node.js LTS，重启 VS Code |
| 命令写成 `px` | 改成 `npx` |
| 安装太慢 | 使用课程提供的已安装工作区压缩包 |

## 完成标准

- `workspace --smoke` 成功。
- Claude Code 能识别 VOC 技能。
- sample 模式能输出一份趋势情报。