08. 附录
附录A：常用命令速查表
Claude Code 命令速查
| 命令 | 功能 |
|---|---|
claude | 启动交互式会话 |
claude --model <model> | 使用指定模型启动 |
claude -p "prompt" | 单次执行模式 |
/help | 显示帮助 |
/model | 查看/切换模型 |
/compact | 压缩上下文 |
/clear | 清空对话 |
/memory | 管理记忆 |
/cost | 查看费用 |
/review | 代码审查 |
/init | 初始化CLAUDE.md |
Ctrl+C | 中断操作 |
Esc | 取消生成 |
Git 命令速查
| 命令 | 功能 |
|---|---|
git init | 初始化仓库 |
git status | 查看状态 |
git add . | 暂存所有修改 |
git commit -m "msg" | 提交 |
git push | 推送到远程 |
git pull | 拉取远程更新 |
git checkout . | 撤销所有未提交的修改 |
git log --oneline | 查看提交历史 |
git diff | 查看修改内容 |
npm 命令速查
| 命令 | 功能 |
|---|---|
npm init -y | 初始化项目 |
npm install <包名> | 安装依赖 |
npm install -g <包名> | 全局安装 |
npm run dev | 启动开发服务器 |
npm run build | 构建项目 |
npm test | 运行测试 |
终端基础命令速查
| 命令 | 功能 | Windows 替代 |
|---|---|---|
pwd | 查看当前目录 | pwd (PowerShell) |
ls | 列出文件 | dir |
cd <路径> | 切换目录 | 同左 |
mkdir <名称> | 创建目录 | 同左 |
clear | 清屏 | cls |
附录B：Prompt 模板库
项目初始化模板
我要创建一个 [项目类型] 项目。
项目名称：[名称]
简述：[一句话描述]
技术栈：[前端框架] + [后端框架] + [数据库]
核心功能（MVP）：
1. [功能1]
2. [功能2]
3. [功能3]
请先创建项目结构和基础配置文件，暂不实现具体功能。功能实现模板
请在 [指定目录/文件] 中实现 [功能名称]。
具体需求：
1. [需求点1]
2. [需求点2]
3. [需求点3]
技术约束：
- 参考 [已有文件/模块] 的风格
- 使用 [指定技术/库]
- 返回格式遵循 [项目约定的格式]
请先说明实现计划，确认后再开始编码。Bug 修复模板
发现一个Bug，需要修复：
现象：[实际看到的行为]
期望：[应该是什么行为]
复现步骤：
1. [步骤1]
2. [步骤2]
错误信息：
[粘贴完整的错误堆栈]
我已经尝试过：[你尝试的解决方案]
请定位问题原因并修复。代码审查模板
请对 [文件路径或范围] 进行代码审查。
审查重点：
1. 安全性（输入验证、XSS防护、SQL注入）
2. 错误处理（异常是否被正确捕获和处理）
3. 性能（是否有明显的性能问题）
4. 代码质量（可读性、命名规范、重复代码）
请按严重程度分级：Critical / Warning / Info
并给出具体的修复建议。架构设计模板
我需要设计一个 [系统/功能] 的架构。
业务需求：[描述]
性能要求：[QPS/响应时间/并发用户数]
技术约束：[必须使用的技术/限制条件]
请给出：
1. 系统架构图（文字描述即可）
2. 技术选型建议及理由
3. 数据模型设计
4. API 接口设计
5. 潜在的技术风险和应对方案附录C：常见问题排查指南（FAQ 汇总）
| 类别 | 问题 | 解决方案 |
|---|---|---|
| 安装 | npm install -g 报权限错误 | macOS: 前加 sudo；Windows: 管理员运行 |
| 安装 | 下载超时 | 设置npm镜像: npm config set registry https://registry.npmmirror.com |
| 安装 | claude: command not found | 检查npm全局路径是否在PATH中: npm config get prefix |
| 连接 | Invalid API Key (401) | 检查Key是否完整复制，环境变量是否正确设置 |
| 连接 | 网络超时 | 国内用户使用中转服务或国产模型 |
| 连接 | Rate limit exceeded | 等待1分钟后重试，或升级API套餐 |
| 使用 | AI修改了不该改的文件 | Prompt中明确指定文件范围，或用 git checkout . 回退 |
| 使用 | AI陷入修复循环 | git checkout . 回退 + /clear 清空对话 + 重新描述需求 |
| 使用 | 对话太长AI遗忘 | 使用 /compact 压缩上下文 |
| 使用 | AI推荐不存在的npm包 | 先到 npmjs.com 搜索确认包是否存在 |
| 费用 | 不确定花了多少钱 | 使用 /cost 查看当前会话费用 |
| 费用 | 想控制费用 | 简单任务用 Haiku/DeepSeek；设置月度预算 |
| 项目 | 数据库报错 | 运行 npx prisma db push 同步数据库 |
| 项目 | 端口被占用 | 杀掉占用端口的进程，或在命令中指定其他端口 |
| 部署 | Vercel构建失败 | 检查构建日志中的错误信息，通常是依赖问题 |
附录E：术语表
| 英文术语 | 中文释义 | 简要说明 |
|---|---|---|
| AI-Assisted Programming | AI辅助编程 | 使用AI工具帮助编写代码 |
| Agent | 智能体 | 能自主执行任务的AI系统 |
| Agentic Engineering | 智能体工程化 | 系统化的AI驱动开发方法论 |
| API | 应用程序接口 | 程序之间通信的规则 |
| API Key | API密钥 | 访问AI服务的身份凭证 |
| CLI | 命令行界面 | 通过文字命令操作电脑 |
| Context Window | 上下文窗口 | AI一次能处理的最大内容量 |
| CRUD | 增删改查 | Create/Read/Update/Delete |
| Hallucination | 幻觉 | AI编造不存在的信息 |
| IDE | 集成开发环境 | 编写代码的专业软件 |
| LLM | 大语言模型 | 如Claude、GPT等AI模型 |
| MCP | 模型上下文协议 | AI工具的扩展能力标准 |
| MVP | 最小可行产品 | 只包含核心功能的第一个版本 |
| ORM | 对象关系映射 | 用代码操作数据库的工具（如Prisma） |
| PRD | 产品需求文档 | 描述产品"做什么"的文档 |
| Prompt | 提示词 | 给AI的指令/问题 |
| RAG | 检索增强生成 | 结合搜索和AI生成的技术 |
| SDD | 规范驱动开发 | 先写规范再让AI执行的方法 |
| Skill | 技能 | 封装的可复用AI指令集 |
| SPEC | 技术规范 | 描述产品"怎么做"的文档 |
| Token | 令牌 | AI处理文本的基本单位 |
| Vibe Coding | 氛围编程 | 凭感觉和意图驱动的AI编程方式 |
结语
请记住五个核心原则：
- 动手大于阅读 —— 学到的知识必须通过实践才能变成技能
- 项目驱动学习 —— 带着目标去学，效率最高
- 拥抱错误 —— AI会犯错，你也会，但每次错误都是学习
- 持续迭代 —— 先做出来，再做好，没有一步到位的完美
- 记录与分享 —— 把经验写下来，分享出去，帮助他人也巩固自己
AI编程领域发展极快，保持学习的节奏，关注新工具和新技术。
祝你在AI编程的世界里，创造出令自己骄傲的作品！
本教程中的价格、版本信息已在 2026-05-18 做过一次核对，请以各服务商官网最新信息为准。