Claude API 最佳实践 — 安全 / 性能 / 成本优化
生产环境使用 Claude API 的 7 大最佳实践：Key 安全、Prompt Caching、模型选择、错误处理、流式、限额监控。
1. API Key 安全
- 使用环境变量（
ANTHROPIC_API_KEY） - 每个项目 / IDE 独立 Key，便于隔离与轮换
- 启用 IP 白名单 (CIDR) 限制调用源
- 设置每 Key 每日 / 每月用量上限
- 永远不在浏览器 / 移动端硬编码
如果 Key 不慎提交到 Git，立即在后台撤销并重新生成。Git 历史无法删除。
2. 模型选择策略
- Haiku 4.5 — 分类、提取、简单对话
- Sonnet 4.6 — 日常 AI 编程、RAG、客服（90% 场景默认）
- Opus 4.7 — 复杂代码、架构设计、长文档分析
3. Prompt Caching
对超过 1024 Token 的系统提示启用 cache_control，缓存读取仅按输入价格的 10% 计费。RAG 场景可省 60–80% 成本。
4. 错误处理与重试
实现指数退避（1s → 2s → 4s → 8s），最多 5 次重试。HTTP 429 解析 retry-after 头；HTTP 5xx 重试；HTTP 4xx（除 429）不重试。
5. 流式输出
聊天 / 代码生成场景务必启用 stream: true，首 Token 延迟可降至 200–500ms。
6. 控制 max_tokens
限制输出长度可显著降低成本（输出比输入贵 5 倍）。短回答场景设 256，长回答 1024–2048，超长报告 4096+。
7. 监控与告警
定期查看用户后台用量趋势。配置预算告警（余额 < 10% 时邮件通知）。生产环境记录 request_id 便于排查。