SuperAPI AI 工具集

clade-reliability-patterns

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:为 Claude 集成提供生产级容错方案,降低 API 限流、过载或故障对业务的影响。

主要能力:

  1. SDK 内置重试:自动重试 429(限流)与 529(过载),可配置 maxRetries(默认 2)与 timeout。
  2. 模型降级链:按 FALLBACK_CHAIN 顺序尝试,如 claude-sonnet-4-20250514 失败后转 claude-haiku-4-5-20251001;仅对 5xx 服务端错误继续尝试,4xx 客户端错误直接抛出。
  3. 熔断器:ClaudeCircuitBreaker 在连续失败达阈值(5 次)后打开电路,60 秒内拒绝请求,避免持续冲击故障 API,成功后重置计数。
  4. 优雅降级:捕获异常后返回缓存或静态提示文本,而非直接失败。
  5. 超时处理:客户端级默认超时(如 30 秒),可按请求覆盖(如复杂提示 120 秒)。

使用方式:先完成 clade-install-auth 前置配置,再按需将各模式代码复制并适配到代码库,逐项测试验证。

适用场景:需要高可用性的生产 Claude 集成。

限制:需理解重试与熔断等容错概念;具体错误排查可参考 clade-common-errors,内容安全可参考 clade-policy-guardrails。