文档说明

1. 适用人群：AI产品开发、数据分析平台搭建，无专业编程/产品经理基础的学员

1. 学习目标：掌握Claude Code的安装与配置、多智能体（subagent）搭建逻辑，能通过Claude Code全流程生成数据分析复盘报告平台的PRD（产品需求文档）+高保真原型图，理解数据分析平台的核心开发逻辑

1. 前置说明：所有步骤均为一步一操作，标注了实操中的坑点和易错点，学员按步骤执行即可；涉及的工具/平台优先使用Kimi（性价比高、适配国内环境），也可替换为Deepseek、豆包、Gemini等大模型。

1. 核心术语解释

• PRD：产品需求文档，包含产品定位、用户分析、功能清单、数据流、原型图等核心内容，是产品开发的核心依据

• Agent/智能体：具备特定功能的AI模块，可独立完成某一类任务

• Subagent/子智能体：由主智能体调度的子模块，每个子智能体负责单一细分任务（如需求分析、原型设计），多个子智能体协作完成复杂项目

• TOKEN：大模型的计费/使用单位，生成/读取文字会消耗TOKEN，不同模型TOKEN收费标准不同

• API Key：调用大模型接口的密钥，需在对应大模型平台申请，是配置Claude Code的核心信息

• 流式输出：AI分步骤、分板块输出内容，而非一次性生成，是数据分析平台的核心体验之一

一、前置环境准备：安装Node.js

Claude Code的运行依赖Node.js环境，必须先安装，未安装会导致后续Claude Code安装失败。

1.1 下载安装（Windows/Mac通用）

1. 打开Node.js官方下载地址（https://nodejs.org/），下载LTS版本（长期支持版，稳定性高）；

1. 双击安装包，全程点击下一步，无需修改默认配置（不要自定义安装路径，避免路径错误）；

1. 安装完成后，关闭所有已打开的终端/命令提示符/Powershell（环境变量需重启终端生效）。

1.2 验证安装是否成功

1. 打开终端（Mac）/Powershell（Windows，建议右键以管理员身份打开）；

1. 分别输入以下两个指令，回车执行，若能显示版本号则安装成功，无显示则重新安装：

• 检查node版本：node -v

• 检查npm版本：npm -v

坑点：若提示“不是内部或外部命令”，说明安装时未勾选“添加到环境变量”，需重新安装并勾选该选项。

二、Claude Code安装与基础配置

2.1 Claude Code安装（Windows/Mac分指令，切勿混输）

安装前确认已完成Node.js安装并验证成功，终端处于任意路径均可安装，步骤如下：

1. 打开终端（Mac）/Powershell（Windows）；

1. 复制对应系统的指令，回车执行，等待安装完成（镜像已配置，无需科学上网，安装速度约1-2分钟）：

• Mac系统：npm install -g @anthropic-ai/claude

• Windows系统：npm install -g @anthropic-ai/claude --registry=https://registry.npmmirror.com/

1. 安装完成后，终端无红色报错即成功（出现黄色警告可忽略，不影响使用）。

2.2 API Key与大模型配置

Claude Code需配置大模型的API Key才能使用，优先推荐Kimi（有会员按coding plan配置，无会员按API配置），也可替换为Deepseek、豆包等，步骤如下：

2.2.1 获取API Key

1. 打开Kimi官网（https://kimi.moonshot.cn/），登录账号；

1. 进入个人中心-API密钥，创建并复制API Key（复制后妥善保存，不要泄露，泄露后可立即作废）；

其他模型：Deepseek/Gemini/豆包均在各自官网的“开发者平台/API中心”申请API Key，流程一致。

2.2.2 临时配置（简单，重启终端失效，适合新手测试）

临时配置无需修改系统文件，直接在终端输入指令即可，Windows/Mac指令格式不同，切勿混输：

1. 终端中输入对应指令，将<你的API Key>替换为实际复制的API Key，回车执行：

• Mac系统：export ANTHROPIC_API_KEY=<你的API Key>

• Windows系统：$env:ANTHROPIC_API_KEY="<你的API Key>"

1. 配置大模型地址和模型版本，继续输入以下指令（Kimi专用，回车执行）：

• Mac系统：export ANTHROPIC_BASE_URL=https://api.moonshot.cn/v1

• Windows系统：$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/v1"

• 通用模型版本配置：export ANTHROPIC_MODEL="moonshot-v1-8k"（Kimi 8k版本，免费/低额TOKEN即可使用）

坑点：指令中的符号（引号/等号）不要漏输，Windows指令需加双引号，Mac无需。

2.2.3 永久配置（避免重复输入，推荐熟练后配置）

临时配置重启终端后会失效，永久配置需将指令写入系统环境变量，新手可先跳过，用临时配置完成实操后再配置：

1. Mac系统：终端输入echo 'export ANTHROPIC_API_KEY=<你的API Key>' >> ~/.zshrc && echo 'export ANTHROPIC_BASE_URL=https://api.moonshot.cn/v1' >> ~/.zshrc，回车执行，然后输入source ~/.zshrc使配置生效；

1. Windows系统：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在「用户变量」中新建2个变量，分别为ANTHROPIC_API_KEY（值为你的API Key）、ANTHROPIC_BASE_URL（值为https://api.moonshot.cn/v1），点击确定保存。

2.3 验证Claude Code配置是否成功

1. 终端中输入指令code，回车执行，进入Claude Code交互界面（显示版本号+模型信息即成功）；

1. 在Claude Code界面中输入/status，回车执行，查看配置信息：

• 确认base URL为https://api.moonshot.cn/v1；

• 确认model为配置的模型版本；

• 无红色报错即配置成功，按ESC退出状态查看。

坑点：若提示“API Key无效”，检查是否复制错误/API Key已过期，重新申请并配置即可。

2.4 大模型使用成本建议

1. Kimi会员：推荐购买coding plan（按次数计费，生成大量文字/文档性价比高），避免按TOKEN计费（生成PRD等长文档会消耗大量TOKEN，成本高）；

1. 无会员/API使用：至少充值50元以上，避免TOKEN不足导致任务中断；模型优先选择8k/16k版本，不要用Turbo版本（收费高，适合小任务）；

1. 其他模型：Deepseek/Gemini/豆包均有免费额度/低价会员，按各自平台说明选择，配置时仅需替换API Key和base URL即可。

三、Claude Code多智能体（subagent）搭建

本次实操的核心是主agent调度4个子agent完成数据分析平台PRD生成，子agent分别负责：需求分析、功能设计、原型设计、PRD汇总。搭建前先理解核心逻辑：subagent本质是自定义提示词，每个子agent由提示词约束功能，主agent负责任务调度和上下文传递，避免单一agent上下文占满导致任务失败。

3.1 核心文件夹结构创建

Claude Code的所有配置均基于项目文件夹，需按固定结构创建，步骤不可逆，零基础严格按要求命名（文件夹/文件名称大小写、标点不可改），创建完成后的文件夹结构如下：

Plain Text [你的项目文件夹，如living]  # 自定义名称，英文 ├── Claude.md               # 主agent调度提示词，固定名称，后缀md └── .claudecode             # 隐藏文件夹，固定名称，前缀带点     └── agents              # 子agent文件夹，固定名称         ├── requirements.md # 需求分析子agent，固定后缀md         ├── functional.md   # 功能设计子agent，固定后缀md         ├── prototype.md    # 原型设计子agent，固定后缀md         └── prd.md          # PRD汇总子agent，固定后缀md

3.1.1 步骤1：创建项目文件夹

1. 终端中输入指令mkdir living（创建名为living的项目文件夹，英文名称），回车执行；

1. 输入指令cd living，回车执行，进入项目文件夹（后续所有操作均在该文件夹内执行）。

3.1.2 步骤2：创建隐藏文件夹.claudecode与agents子文件夹

1. 终端中输入指令mkdir .claudecode，回车执行（前缀带点为隐藏文件夹，Mac需开启“显示隐藏文件”，Windows需在文件夹选项中勾选“显示隐藏文件”）；

1. 输入指令cd .claudecode，回车执行，进入隐藏文件夹；

1. 输入指令mkdir agents，回车执行，创建子agent文件夹；

1. 输入指令cd ..，回车执行，返回项目根文件夹（living）。

3.1.3 步骤3：创建主提示词文件[Claude.md](Claude.md)

1. 项目根文件夹（living）中，新建文本文档，重命名为Claude.md（后缀改为md，若看不到后缀，先在电脑中开启“显示文件扩展名”）；

1. 打开Claude.md，复制主agent调度提示词（核心内容为：定义主agent为“调度者”，职责是接收需求、分解任务、调度4个子agent、审核结果、最终交付，提示词可直接使用直播中提供的模板，无需修改）；

1. 保存文件，关闭编辑器。

3.1.4 步骤4：创建4个子agent提示词文件

1. 进入.claudecode/agents文件夹，新建4个文本文档，分别重命名为：requirements.md、functional.md、prototype.md、prd.md（后缀均为md，名称不可改）；

1. 分别打开4个文件，复制对应子agent的提示词模板（直播中提供，核心内容为：定义每个子agent的功能、交付物、工作流程，零基础无需修改模板，直接复制即可）；

1. 每个子agent的提示词包含3部分核心配置，可按需微调：

• name：子agent名称，如“需求分析智能体”；

• description：子agent功能描述，让主agent判断何时调用；

• model/color：可选配置，model为子agent使用的模型（不配置则用默认模型），color为子agent工作时的显示颜色（方便区分，如蓝色=需求分析、绿色=功能设计）；

1. 保存所有文件，关闭编辑器。

3.2 重启Claude Code加载subagent

1. 若已进入Claude Code界面，输入指令/exit，回车执行，退出界面；

1. 终端中确保处于项目根文件夹（living），输入指令code --dangerously-skip-permission-checks，回车执行：

• 该指令为免授权模式，避免Claude Code执行任务时频繁询问“是否允许创建文件夹/文件”，适合新手实操；

• 进入界面后，输入指令/agents，回车执行，显示4个子agent名称即搭建成功，按ESC退出即可。

坑点：若/agents无显示，检查文件夹/文件名称是否正确，是否在项目根文件夹执行code指令。

四、实战：全流程生成数据分析平台PRD

4.1 输入产品开发需求

在Claude Code交互界面中，直接输入数据分析复盘报告平台的开发需求，零基础直接复制以下需求（直播实操需求，确保任务能正常执行），回车发送：

开发一款数据复盘报告网页应用，用户上传Excel表格和分析需求，应用调用大模型自主规划分析流程，一步步调用Python工具撰写代码、运行代码分析数据，最终生成一份满足用户需求的可视化分析报告，帮我设计这款产品的产品定位，生成完整的PRD文档和高保真原型图。

4.2 调用subagent执行任务

1. 需求发送后，Claude Code的主agent会自动分解任务，依次调用4个子agent；

1. 子agent工作时会显示不同颜色（搭建时配置的），可直观看到任务进度；

1. 全程无需手动干预，AI会自动完成：需求分析→功能设计→原型设计→PRD汇总，生成的所有文档会自动保存到**项目根文件夹（living）**中。

4.3 各子agent工作成果解读

每个子agent完成任务后，会在项目文件夹中生成对应文档，零基础重点关注以下核心内容，无需逐字阅读，后续基于AI生成的框架优化即可：

1. 需求分析agent（[requirements.md](requirements.md)）：生成产品定位、市场现状、竞品分析、用户画像（核心用户：运营专员、销售经理、数据分析新手）、用户痛点/需求；

• 坑点：AI无搜索能力，会编造市场数据/竞品信息，需手动替换为真实数据；

1. 功能设计agent（[functional.md](functional.md)）：生成功能清单、信息架构、核心数据流、用户旅程（重点看数据流图/时序图，是数据分析平台的核心，确保AI理解“上传Excel→AI写代码→分析→生成报告”的循环逻辑）；

1. 原型设计agent（[prototype.md](prototype.md)）：生成高保真原型图（可交互/不可交互），包含核心界面：Excel上传页、分析需求输入页、AI分析进度页、分析报告展示页，原型图可直接截图用于PRD；

1. PRD汇总agent（[prd.md](prd.md)）：合并所有子agent的成果，生成完整的PRD文档，包含所有产品开发所需信息，后续仅需基于该文档手动修正AI编造的内容、补充细节即可。

4.4 AI生成内容的优化技巧

1. 修正编造内容：删除AI编造的市场数据/竞品信息，替换为真实的行业数据/竞品分析（如豆包、镝数聚等数据分析平台的功能）；

1. 简化功能清单：AI会生成冗余功能，零基础开发时优先保留核心功能：Excel上传、需求输入、AI代码生成、分析报告输出，删除复杂的权限管理、云端存储等功能；

1. 优化数据流：确保AI生成的数据流符合逻辑：用户上传Excel→系统解析数据→AI接收分析需求→AI写Python代码→运行代码分析→流式输出分析结果→生成可视化报告，若逻辑错误，手动修改数据流图并重新输入需求让AI优化。

四、数据分析平台核心功能理解（DEMO实操）

直播中演示的数据分析平台核心功能是复现豆包的数据分析功能，零基础无需开发完整产品，先理解核心逻辑，后续课程会讲解具体开发步骤，核心功能如下：

4.1 核心功能1：Excel文件上传与解析

1. 用户上传Excel表格，系统自动解析表格中的数据（列名、数据类型、数据量）；

1. 解析失败时，AI自动提示用户修正表格（如格式错误、空值过多）。

4.2 核心功能2：AI自动写代码+分析数据

1. 用户输入分析需求（如“从地理位置角度分析用户消费报告”）；

1. AI（如Kimi）自主规划分析流程，一步一步撰写Python代码；

1. 代码运行报错时，AI自我修复，重新撰写代码并运行，直至分析成功；

1. 直播中使用Kimi实现该功能，也可替换为豆包、Deepseek等支持代码生成的大模型。

4.3 核心功能3：流式输出+多板块呈现

1. 流式输出：AI分步骤输出分析结果，而非一次性生成（如先输出数据预处理结果，再输出探索性分析结果）；

1. 多板块呈现：将不同类型的分析结果展示在不同板块（如数据概览、可视化图表、分析结论），提升用户体验。

4.4 核心功能4：可视化分析报告生成

分析完成后，系统自动生成可视化报告，包含：数据概览、图表（柱状图/折线图/地图）、分析结论、建议，报告支持下载/分享。

五、常见问题与排坑指南

零基础实操中最易遇到以下问题，按对应方法解决即可，无需纠结技术原理：

5.1 安装类问题

1. Node.js/Claude Code安装报错：关闭所有杀毒软件/防火墙，重新安装，全程默认配置；

1. 终端提示“不是内部或外部命令”：未配置环境变量，重新安装并勾选“添加到环境变量”，或手动配置环境变量；

1. 隐藏文件夹.claudecode看不到：Mac按Command+Shift+.显示隐藏文件，Windows在文件夹选项中勾选“显示隐藏的文件、文件夹和驱动器”。

5.2 配置类问题

1. API Key无效：检查是否复制错误/过期，重新申请并配置；

1. /status查看配置信息错误：重新执行临时配置指令，确保指令无符号错误，Windows加双引号，Mac不加；

1. Claude Code无法进入：终端中输入npm uninstall -g @anthropic-ai/claude卸载，重新安装即可。

5.3 任务执行类问题

1. subagent调用不了：检查文件夹/文件名称是否正确，是否在项目根文件夹执行code指令，退出Claude Code（/exit）重新进入；

1. AI生成任务中断：TOKEN不足/网络波动，充值TOKEN/切换网络，重新输入需求执行任务；

1. AI生成代码报错无法修复：简化分析需求，避免复杂的分析逻辑（如多维度分析、大数据量分析），先从简单的单维度分析开始。

5.4 其他问题

1. 无文档权限：在课程群中点击小程序，重新进入课程即可获取文档权限；

1. 原型图/PRD生成乱码：在Claude Code中输入需求时，明确要求“生成中文文档，无乱码，格式清晰”，AI会自动优化；

1. 文件夹结构错误：删除项目文件夹，重新按步骤创建，零基础不要自定义文件夹/文件名称。

六、后续学习安排

1. 本课程完成Claude Code安装配置+subagent搭建+PRD生成，核心是理解多智能体协作逻辑；

1. 下一节课将讲解数据分析平台的实际开发步骤，基于AI生成的PRD，使用前端/后端技术开发完整的DEMO；

1. 实操中有问题可通过腾讯会议答疑，或在课程群中交流，群内会提供提示词模板、文件夹结构模板等资料。

附：资料获取

1. Claude Code安装/配置指令、主agent/子agent提示词模板、数据分析平台需求模板，均在课程群中发布