开发环境快速上手

这一页不是主线的硬前置，而是一份推荐的开课准备清单。

你会先把课程实验需要的开发环境配好，再决定要不要安装 Claude Code 这类 AI 编程助手。课程会穿插演示这类工具怎么帮你提效，但主线能力本身不依赖某一个具体工具。

这个模块讲什么

课次	主题	核心内容
01	环境准备	Node.js、包管理器、API Key、课程实验依赖
02	推荐工具	Claude Code 的安装、认证与基本使用
03	项目上下文	CLAUDE.md、README、代码规范怎么喂给工具
04	协作工作流	如何描述任务、如何审查结果、如何继续追问

学完你能做什么

• 配好课程实验所需的基础开发环境
• 知道 Claude Code 在这套课里是辅助工具，不是主线本体
• 如果你决定使用 Claude Code，能在项目目录里把它跑起来
• 配置 CLAUDE.md，让工具理解项目背景和偏好
• 建立「描述 → 生成 → 审查 → 迭代」的基本工作节奏

Claude Code 要不要先装

不一定。

如果你平时就会在本地写代码、改文件、跑命令，Claude Code 很值得早点装上，后面做项目会顺很多。

如果你现在更想先理解 Agent、RAG、评估这些主线内容，也可以先不装。课程主线不会因为少一个工具就学不下去。

如果你打算用 Claude Code

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

需要 Node.js 18+。安装后进入你的项目目录，运行：

claude

第一次运行会引导你完成认证（API Key 或 Claude Pro/Max 订阅）。

模型访问方式怎么选

这套课默认会用 Anthropic 风格的接口和 Claude Code 演示，因为 Agent 的消息结构、工具调用和多轮循环在这条线上更直观。

但你不一定非得用 Anthropic 官方服务。实际可分成三类：

方案	怎么理解	这套课怎么支持
Anthropic API	官方 Claude 接口	作为默认示例
兼容 Anthropic API 的国产模型服务	接口形状接近 Anthropic，通常主要是换 base URL、API Key、模型名	大多数主线示例可以直接迁移
兼容 OpenAI 的 API	接口风格是 OpenAI 那一套 chat/completions 或 responses	关键课次会补一套 OpenAI 兼容写法

如果你用的是兼容 Anthropic API 的国产模型，主线里的很多实验通常不用重写思路，重点只是把接入层替换掉。

如果你更想用 OpenAI 或兼容 OpenAI 的服务，这门课也会在涉及模型接入的关键示例里给出对应写法，避免你只看懂一套接口风格。

不会写代码也能用吗？

可以。Claude Code 会写代码，也会解释它写了什么。你的工作是：

1. 描述你想要什么：用自然语言说清楚目标
2. 看懂结果对不对：不需要懂每一行代码，但要知道功能有没有实现
3. 给出反馈：哪里不对、哪里还需要调整

判断力比代码能力更重要。这门课会帮你建立这种判断力。

前置要求

• 一台电脑（Mac / Windows / Linux 均可）
• 至少准备一种可用的模型访问方式：Anthropic API、兼容 Anthropic API 的国产模型服务，或兼容 OpenAI 的 API
• 有一件你想做的事（不需要提前想好技术方案）