用途：这是一份面向 Anthropic Messages API 开发者的避坑清单，用于审查和修正代码中的常见错误。
主要能力：列出十个常见问题及修复方式——忘记必填的 max_tokens（会返回 400）；把 system 提示写进 messages 数组（应使用顶层 system 参数）；消息未严格 user/assistant 交替；未检查 stop_reason 是否为 max_tokens 导致截断；每次请求新建 Anthropic 客户端；未处理 529 过载错误；硬编码模型 ID；忽视输出 token 成本；面向用户的界面未使用流式输出；不必要地发送 PII。
使用方式：先逐条对照代码模式，将示例改写适配到自己的用例，逐项修改并单独测试，最后运行测试套件验证。文档给出 BAD/GOOD 代码对比与速查表，并建议模型 ID 用环境变量，如 const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-20250514';。
适用场景：审计现有 Claude 集成、排查 API 报错、优化延迟与成本、准备生产上线。
限制：需熟悉 Anthropic Messages API 并有可审查的代码库；具体价格、模型版本与 SDK 重试细节以官方文档为准，资料未提供完整错误码对照，仅指向 clade-common-errors。