用途:为 Claude 集成提供生产级容错方案,降低 API 限流、过载或故障对业务的影响。
主要能力:
- SDK 内置重试:自动重试 429(限流)与 529(过载),可配置 maxRetries(默认 2)与 timeout。
- 模型降级链:按 FALLBACK_CHAIN 顺序尝试,如 claude-sonnet-4-20250514 失败后转 claude-haiku-4-5-20251001;仅对 5xx 服务端错误继续尝试,4xx 客户端错误直接抛出。
- 熔断器:ClaudeCircuitBreaker 在连续失败达阈值(5 次)后打开电路,60 秒内拒绝请求,避免持续冲击故障 API,成功后重置计数。
- 优雅降级:捕获异常后返回缓存或静态提示文本,而非直接失败。
- 超时处理:客户端级默认超时(如 30 秒),可按请求覆盖(如复杂提示 120 秒)。
使用方式:先完成 clade-install-auth 前置配置,再按需将各模式代码复制并适配到代码库,逐项测试验证。
适用场景:需要高可用性的生产 Claude 集成。
限制:需理解重试与熔断等容错概念;具体错误排查可参考 clade-common-errors,内容安全可参考 clade-policy-guardrails。