Claude Code 结构化用量限额行(Structured Usage Rate-Limit Rows):limits[] 字段的服务器权威语义与客户端渲染契约

发布时间:2026/10/7 15:06:52
Claude Code 结构化用量限额行(Structured Usage Rate-Limit Rows):limits[] 字段的服务器权威语义与客户端渲染契约 文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载Claude Code 的系统提示词仓库claude-code-system-prompts中的>{extra_usage: {is_enabled: true, monthly_limit: 50000, used_credits: 27140, utilization: 54, currency: USD}, limits: [{kind: spend, group: monthly, percent: 54, resets_at: 2026-10-01T00:00:00.000Z, severity: normal, is_active: true}]}其中limits数组的每一行包含kind配额类型如spend、group周期分组如monthly、percent0–100 的整百分比超限可超过 100、resets_atISO 8601 UTC 重置时刻、severity严重级别以及is_active标记该行所属的金额。该文档同时说明无配额的账号返回{limits: []}。二、核心契约meters 的权威在服务器客户端只负责原样渲染本字段最关键的一句话是which meters apply, their scope, labels, severity and order are the servers——哪些 meter 生效、它们的作用域、标签、严重级别以及排列顺序全部由服务器决定。由此推出两条直接约束客户端必须逐字渲染render verbatim客户端不得按自己的规则对行重排、改名或改变严重级别语义limits[]呈现的就是服务器的判定。新增 meter 不需要客户端发版服务器可以随时加入新的 meter 行新的kind/group/severity组合旧版客户端依然能正确展示因为渲染逻辑不依赖对某个具体 meter 的硬编码认知。这与网关协议中Dont reject what you dont recognizedata-claude-code-gateway-protocol.md的向后兼容原则一脉相承。这种服务器权威 客户端透明的设计把配额语义的演进成本全部收敛到服务端客户端 UI 只需是一个忠实的中转层。三、null与[]两种无数据的精确语义该字段用三种状态区分没有用量行的不同成因这也是最容易误用的部分[]空数组服务器已支持usage 端点且明确报告了没有 meter——例如账号本身没有任何配额约束网关对无配额用户返回{limits: []}见上文网关协议示例。null响应体完全没有 rows服务器先于该能力存在a server that predates them即旧版服务端根本不在响应体中携带 rows 字段。此时是能力缺失而非没有限额。nullfetch 失败时usage 请求正在进行或失败期间该字段同样为null。第三点在语义上很微妙需要与快照严格区分该字段只反映服务器当前的回复the rows here are only ever the servers current reply。它绝不包含以下两种数据CLI 根据 rate-limit 响应头自行构建、用于自身屏幕的那一行客户端对更早一次回复的本地快照。换句话说这是一个活值字段fetch 失败时它归null而不是退回上一次成功的结果。UI 需要据此处理数据尚未就绪/拉取失败状态而不是展示过期数据。四、两条数据通道的分工结构化 rows 与响应头要理解该字段为什么严格排除CLI 从响应头构建的行需要对照仓库中速率限制头相关文档。Claude Code 实际存在两条并行的用量数据来源通道一usage 端点的结构化limits[]本文主题——面向账号/网关级配额的完整描述含金额extra_usage、周期、重置时间、严重级别等结构化字段供/usage面板与状态行展示。通道二anthropic-ratelimit-unified-*响应头——每次POST /v1/messages响应携带的实时限额状态。data-claude-code-gateway-protocol.md 列出了这些头的完整语义响应头含义anthropic-ratelimit-unified-statusallowed越过阈值后为allowed_warninganthropic-ratelimit-unified-representative-claimoverage或5h/7d滚动窗口客户端做时间运算勿当日历预算anthropic-ratelimit-unified-overage-utilization已用额度占比两位小数允许请求期间保持在 1 以下anthropic-ratelimit-unified-overage-surpassed-threshold越过 75% 时为0.75、95% 时为0.95用于触发客户端提示anthropic-ratelimit-unified-reset/-overage-reset配额重置时刻Unix 秒data-rate-limit-unified-windows.md 进一步说明5 小时、7 天与含超额的每周per-model bucket窗口均从这些头读取utilization与顶层字段同尺度通常 0–1超出 1 表示合法超出上限如低优先级任务越过 5 小时限额且窗口在每次观测时都记录事件在百分比或重置时间变化时即触发而不只发生在状态迁移时。同时>赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude Code 订阅限流统一窗口Unified Rate-Limit Windows数据结构解析Claude Code 订阅限流统一窗口Unified Rate Limit Windows数据结构解析 本文基于 Claude Code 系统提示词仓库中文档提示工程人工智能电子课本下载工具教程3步把智慧教育平台课本PDF存到本地电子课本下载工具教程3步把智慧教育平台课本PDF存到本地 下周要给孩子打印语文课本打开国家中小学智慧教育平台却只能在线翻、不能存开源工具 tchMater网页爬虫教育Authelia 服务端端点限流Server Endpoint Rate Limits配置指南Authelia 服务端端点限流Server Endpoint Rate Limits配置指南 Authelia 内置 Web 服务器默认对若干安全敏感端点后端认证鉴权单点登录身份认证应用安全创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考