用途:该技能面向使用 Anthropic API 的开发者,帮助定位并修复调用中常见的错误。每个错误都包含 type 字段与 HTTP 状态码,可据此判断根因并采取对应措施。
主要能力:
- authentication_error(401):API 密钥缺失、格式错误或被撤销。可用 echo $ANTHROPIC_API_KEY | head -c 10 检查密钥是否以 sk-ant- 开头,并用 curl 直接测试。
- rate_limit_error(429):超出每分钟请求数(RPM)或每分钟令牌数(TPM)。SDK 内置带退避的重试,可通过 maxRetries 调整;也可读取 retry-after 头手动重试。资料列出 2025 年各层级限额,如 Tier 1 免费为 50 RPM、40,000 输入 TPM、8,000 输出 TPM。
- overloaded_error(529):服务端临时容量不足,并非速率限制。SDK 会自动重试 529,可提高 maxRetries,关键路径可回退到其他模型。
- invalid_request_error(400):消息角色未交替、max_tokens 缺失或超限、图片过大或格式错误、模型 ID 无效等。可在发送前校验消息角色交替且首条为 user。
- not_found_error(404):模型 ID 无效或当前套餐不可用,需使用准确模型 ID。
- 上下文超长:提示词超过模型上限,可用 countTokens 统计输入令牌,必要时截断历史消息。
使用方式:安装 Anthropic SDK(@claude-ai/sdk 或 anthropic)并配置 API 凭据,结合应用日志或控制台输出排查。快速诊断可用 curl 查询 status.anthropic.com 状态,或直接调用 /v1/messages 验证密钥。
适用场景:调试 Anthropic API 集成、处理限流与重试、校验请求参数、排查模型与上下文问题。
限制:资料未提供该技能自身的安装命令、收费方式或平台支持信息;速率限制层级数据标注为 2025 年,可能变化;当前用量与限额无 API 可查,需在 console.anthropic.com/settings/limits 查看。