限制与错误
容量上限与错误处理。
按以下边界规划库与 Secret。
| 限制 | 上限 |
|---|---|
| 每库有效 Secret 数 | 50 |
| Secret 值大小 | 16384 bytes (16 KiB) |
| 每个 Secret 的允许域名数 | 16 |
| 单次导入行数 | 50 |
| 授权创建 / OAuth 校验（每账户每分钟，各自计数） | 30 / 30 |
| 库名称长度 | 255 |
| metadata 键值对数 | 16 |
| metadata 键 / 值长度 | 64 / 512 |
| 列表每页条数 | 50 (最大 200) |
同名 Secret 已存在返回 409 SECRET_CONFLICT；往已归档的库写入返回 409 VAULT_INVALID_STATE；超过有效 Secret 上限返回 400 VAULT_LIMIT_EXCEEDED；值超过 16 KiB 返回 413 SECRET_TOO_LARGE。一键授权创建与 OAuth 校验各按账户独立计数，每个固定一分钟窗口各最多 30 次；超出返回 429 RATE_LIMITED，等待下一窗口重试。授权链接过期返回 410 AUTHORIZATION_EXPIRED，需要重新发起授权。
通过 Claude 托管智能体的凭据库接口访问时，每库最多 20 个有效凭据，错误使用该接口自己的错误格式。