用途：这是一份针对 Anthropic API 集成常见错误的审查辅助资料，用于代码审查、开发者上手培训，以及排查细微的集成问题。使用时应以实际安装的 SDK/API 版本为准，并在做出兼容性结论前对照 Anthropic 当前官方文档确认行为变化。
主要能力：列出十类常见陷阱，包括错误的导入或类名（如误用 AnthropicClient，Python 应 import anthropic 后 client = anthropic.Anthropic()，TypeScript 应使用默认导出 import Anthropic from '@anthropic-ai/sdk'）；忘记必填的 max_tokens；把 system 提示放进 messages 数组而非使用 system 参数；错误访问响应（应使用 response.content[0].text，并处理多个内容块）；忽略 stop_reason（max_tokens、tool_use、end_turn）；未正确使用 tool_use_id（必须与响应中的 block.id 完全一致）；硬编码模型别名而非固定带日期版本；重复实现 SDK 已内置的自动重试（可用 max_retries 配置）；max_tokens 设置过大增加延迟；以及未跟踪 usage 成本。
使用方式：先确认 SDK/运行时版本、固定模型 ID、请求路径、工具定义、数据分级与集成负责人；在沙箱工作区用合成提示、最小权限凭据和脱敏策略进行审查与复现，不要把生产内容或密钥粘贴到诊断中。逐项检查导入、请求构造、响应解析、模型版本固定、重试行为和 token 上限，并用合成夹具覆盖畸形请求、截断输出、工具调用、429/5xx、超时和重复重试等场景。
适用场景与限制：适合集成评审、故障排查和团队规范制定。资料未提供具体收费、价格或平台支持信息；实际行为以所用 SDK 版本和官方文档为准。