用途:针对 Anthropic Claude API 的各类报错,按 HTTP 状态码定位错误类型并给出修复方向,适合遇到 API 错误、请求失败或排查故障时参考。
主要能力:覆盖 400 invalid_request_error(如角色必须交替、max_tokens 必填且不小于 1、模型 ID 写错、内容为空、tool_use_id 不匹配)、401 authentication_error、403 permission_error、404 not_found_error、429 rate_limit_error、529 overloaded_error、500 api_error;并说明 API 以 JSON 形式返回 {"type": "error", "error": {"type": "...", "message": "..."}}。
使用方式:用 curl 直接测试最小请求验证密钥与端点,例如: curl -s https://api.anthropic.com/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-sonnet-4-20250514","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'。 可检查状态:curl -s https://status.anthropic.com/api/v2/status.json;密钥格式检查:echo $ANTHROPIC_API_KEY | grep -qE '^sk-ant-api03-'。SDK 侧按异常类型分别处理,如 anthropic.AuthenticationError、RateLimitError、BadRequestError、APIStatusError、APIConnectionError。429 时关注 retry-after 与 anthropic-ratelimit-* 等头信息。
适用场景:调试请求构造问题、区分认证或权限问题、判断是否该重试及重试上限、验证修复后回归。
限制与安全要求:400/401/403/404 不应盲目重试;429、500、529 仅在设定上限的指数退避下重试,并遵守 retry-after。网络超时视为不确定,仅对幂等操作重试并限制次数。诊断时使用沙箱项目与合成提示(如 health-check-001),只记录状态码、错误类型、请求 ID、重试元数据与时序,须脱敏授权头、消息内容、工具输入及可能含敏感数据的响应体;不要把密钥粘贴到命令、工单或回执中。若认证或权限问题在沙箱检查后仍存在,应停止并通过受控密钥与工作区流程轮换或重新授权。输出为诊断回执,包含 correlation_id、状态/错误类型、端点类别、模型标识、请求 ID、重试决策、金丝雀结果、回滚结果与清理状态。
未提供信息:具体定价、配额数值、支持平台与版本兼容范围暂未提供。