Claude 编程辅助指南

Claude 在代码生成、审查与调试上表现稳定，结合 Projects/Artifacts/API 工具调用可以大幅提效。

#快速心智

• 选模型：通用用 Claude 4.5 Sonnet；高并发/低成本用 4.5 Haiku。
• 结构化请求：明确语言/框架/约束（依赖、风格、测试要求）。
• 长上下文：把需求、文件结构、关键代码片段一起提供；超长场景用 Projects 上传文件。

#常用 Prompt 模板

#代码生成

用 TypeScript 写一个函数，输入订单数组 [{id, amount, status}]，
返回 { total, pending, completed }。要求：
- 纯函数，不修改入参
- 对非法输入抛出错误
- 添加单元测试（vitest）

#代码审查

你是资深后端工程师，请审查下面的 NestJS 控制器：
- 标记潜在 Bug 与安全问题（SQL/注入/越权）
- 列出性能风险（N+1、缓存缺失）
- 给出修复建议和示例代码

#调试/解释

下面的日志显示请求 500，帮我排查：
- 环境：Node.js 20，PostgreSQL 14
- 错误栈：[粘贴]
- 相关代码：[粘贴]
请给可能原因、验证步骤、修复代码。

#配合工具与平台

• Artifacts：生成可预览的组件/HTML/图表，适合前端 UI 迭代。Artifacts 使用 →
• Projects：上传代码/文档，持久上下文做重构与审查。Projects 使用 →
• Claude API Tool Use：函数调用、JSON 输出、流式响应，适合自动化与 CI 代码建议。API 工具调用 →

#最佳实践

• 先小后大：先让 Claude 生成接口/类型/测试，再整合。
• 明确边界：列出输入校验、性能目标、兼容性要求。
• 多轮迭代：逐步补充日志/错误/测试结果，避免一次扔长指令。
• 保护敏感信息：不要贴密钥；脱敏数据后再提供上下文。

#常见坑

• 输出偏格式：要求 JSON/函数签名时，写明“只输出 code block / schema”。
• 忘记上下文：跨多轮对话时，复述关键需求或引用上一段代码。
• 工具调用循环：API 调用时限制最大调用轮次，并提供兜底响应。

#下一步

• Prompt 技巧 - 提升提问质量
• Claude API 总览 - 开发者集成与 SDK
• Prompt Caching / Batch - 成本与吞吐优化