Claude Code 用量查看与 Token 审计:5 小时和每周额度、缓存与 MCP
Claude Code 剩余额度用 /usage 查看,/status 只看账号和计费路线。用量同时计入 5 小时和每周额度;掉得快时先按上下文、缓存和 MCP 归因,再排活。
文章目录

查 Claude Code 还剩多少额度,在会话里运行 /usage。Pro、Max、Team 和 Enterprise 套餐会在同一屏看到 5 小时会话额度和每周额度的用量条与重置时间,以及最近的用量花在了哪些技能、子代理、插件和 MCP server 上。/cost 和 /stats 现在都是 /usage 的别名。/status 显示的是版本、模型、账号和连通性,用来确认当前走的是订阅还是 API key,不是看剩余额度的地方。
用量条掉得比预期快时,先别急着升级套餐或认定是 bug。同一个终端里可能同时出现套餐用量条、本机按标价算的会话估算、Console 账单和云厂商账单,它们回答的问题不同。先把数字归到对的地方,再判断是上下文变重、缓存反复重建、MCP 返回太多,还是子代理和并发在消耗,最后按 5 小时和每周两条额度安排重活。
下面的命令和字段以 Claude Code 官方的命令列表、成本说明、状态栏文档和 Claude 帮助中心为依据,截至 2026 年 10 月 5 日。不少功能有最低版本要求,先用 claude --version 看自己装的是哪一版。
Claude Code 用量去哪看:每个入口只回答一个问题
| 你想知道 | 去哪看 | 它回答不了 |
|---|---|---|
| 5 小时额度和本周额度还剩多少、何时重置 | /usage 的套餐用量条;网页或桌面端的 Settings > Usage | API key 或其他账号的消耗 |
| 最近的套餐用量花在哪 | /usage 的用量拆分,按 d 或 w 切换最近 24 小时和 7 天 | 其他设备和 claude.ai 网页上的用量 |
| 当前会话用了多少 token | /usage 顶部的 Session 区块 | 订阅用户的实际扣费 |
| 实际账单 | API key:Claude Console 的 Usage 页;Bedrock、Google Cloud、Foundry:各自的云账单 | 订阅套餐还剩多少 |
| 用量积分本月花了多少 | /usage 里的用量积分行,开启后才显示 | 套餐内额度 |
| 当前走哪个账号、哪条计费路线 | /status | 剩余额度 |
| 上下文被什么占满 | /context | 这些 token 由谁付费 |
几处容易看错的地方:
- Session 区块里的美元数字是 Claude Code 在本机按标价算出的估算。Pro 和 Max 的用量包含在订阅里,官方成本文档写明这个数字与订阅用户的计费无关;它适合比较两个会话谁更重,不能证明发生了额外扣费。API 用户的权威账单在 Claude Console。从 v2.1.211 起,
/clear开新会话后这些合计从零算起。 - 用量拆分是根据这台电脑上的会话历史近似算出来的,另一台电脑或网页上的消耗不在里面。占近期用量 10% 以上的行为会被单独标出,比如长上下文、缓存未命中;v2.1.242 起还会列出最耗用量的
/loop和定时任务。 - 查询额度的请求失败时,多半是查询接口被限流,
/usage会显示 60 分钟内最后一次拿到的用量条并注明是多久前的数据,按r重试。 - Claude 帮助中心介绍 Pro/Max 使用 Claude Code 的文章里仍写着用
/status监控剩余额度;按 Claude Code 当前的命令文档,/status只显示版本、模型、账号和连通性,额度要看/usage。
/status 显示的账号如果不是你以为的那个,先停下来查路线。环境里设置了 ANTHROPIC_API_KEY 时,Claude Code 会用这把 key 而不是订阅,产生的是按 API 计费的费用;API key 路线没有硬性上限,用多少扣多少。完整的分流方法见 Claude Code API Key 和订阅计费怎么选:先看 /status。
在状态栏实时显示 5 小时和每周额度百分比
不想反复敲 /usage,可以让状态栏常驻显示两条额度。Claude Code 传给状态栏脚本的 JSON 里有 rate_limits.five_hour 和 rate_limits.seven_day 两个窗口,各带 used_percentage(0 到 100)和 resets_at(Unix 时间戳,单位秒)。这些字段只提供给 claude.ai 的 Pro 和 Max 订阅,并且要等会话里第一次 API 响应之后才出现;任一窗口都可能缺失,脚本必须能处理空值。
最省事的做法是运行 /statusline,用自然语言说想显示什么,比如“显示 5 小时和 7 天额度百分比”,Claude Code 会生成脚本并改好设置。想自己写,可以把下面的脚本存为 ~/.claude/statusline.sh,再执行 chmod +x ~/.claude/statusline.sh:
#!/bin/bash
input=$(cat)
# 没有额度字段时,// empty 返回空字符串
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
RESET=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty | floor')
OUT=""
[ -n "$FIVE_H" ] && OUT="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$RESET" ] && OUT="$OUT (resets in $(( (RESET - $(date +%s)) / 60 ))m)"
[ -n "$WEEK" ] && OUT="${OUT:+$OUT }7d: $(printf '%.0f' "$WEEK")%"
echo "${OUT:-no plan data yet}"然后在 ~/.claude/settings.json 里加上状态栏配置。refreshInterval 让脚本每 60 秒重跑一次,倒计时才会走动:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"refreshInterval": 60
}
}这段脚本用模拟的 JSON 输入在 macOS 自带的 bash 和 jq 1.7.1 下跑过:有数据时输出 5h: 23% (resets in 102m) 7d: 41%,还没有额度字段时输出 no plan data yet。需要先装好 jq。
桌面端不用配置:在 Code 标签页点模型选择器旁边的用量环,能看到当前会话的上下文占用和本期套餐用量,后者在所有 Claude Code 入口之间共享。额度快用完时,Claude Code 也会主动提醒,例如 You've used 85% of your session limit · resets 3:45pm。
5 小时会话额度和每周额度:同一次使用两边同时扣
Pro 和 Max 有两条额度。会话额度(session limit)每五小时重置;每周额度(weekly limit)跨所有模型计算,在分配给你账号的固定时间每周重置,这个时间不随你何时开始使用、何时订阅而变,下一次重置时间在 Settings > Usage 里能看到。Team 和 Enterprise 成员的席位额度同样按滚动的五小时窗口和每周窗口重置,大小取决于席位类型。
影响你怎么排计划的几条事实:
- 两条线同时扣。 每次使用都同时计入会话额度和每周额度。Claude Code 的错误文档专门提醒:一次大规模并发的工作流,可能在 5 小时窗口重置之前就用光本周额度。
- 所有入口共用。 claude.ai 网页、Claude Code、Claude Desktop,以及 VS Code、JetBrains 等 IDE 里的 Claude Code,都计入同一份额度。白天在网页上处理长文档,晚上 Claude Code 能用的就少了。
- 没有公布的小时数或条数。 能用多少取决于对话长度和复杂度、用到的功能、模型和 effort。官方只给相对倍数:Max 5x 和 Max 20x 的单个会话额度分别是 Pro 的 5 倍和 20 倍。官方还保留用其他方式限制用量的权利,例如每周或每月上限、针对模型与功能的限制。
- Opus 和 Sonnet 可能另有单独限额。 提示
You've hit your Opus limit或You've hit your Sonnet limit时,只有这个系列被限,用/model换到另一个系列就能继续。会话额度和每周额度跨模型共享,换模型救不回来。
5 小时窗口从哪一刻开始计时,官方文档没有写明。排计划时不要按“从第一条消息算起”推算,以 /usage 或状态栏显示的重置时间为准。
撞到额度之后:自动续跑、用量积分和限额重置怎么选
额度用完时,终端里会出现带重置时间的提示:
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am接下来有几条路,各自的代价不同:
| 选项 | 怎么做 | 要注意的 |
|---|---|---|
| 等重置后自动续跑 | v2.1.234 起,用订阅登录的交互式会话默认开启;保持会话打开,重置后 Claude Code 接着做被打断的任务 | 不会重发你的上一条消息;你不在时会花掉下一个窗口的额度;遇到权限确认仍会停下 |
| 换模型系列 | 只对 Opus 或 Sonnet 单独限额有效,用 /model 换到另一个系列 | 每个模型有自己的缓存,下一次请求要重新读完整个对话 |
| 用量积分(usage credits) | /usage-credits 打开 Settings > Usage 开启,可设每月花费上限 | 按 API 标准价另外计费;使用积分期间提示缓存有效期从 1 小时降到 5 分钟 |
| 限额重置(limit reset) | 有资格时,在网页或桌面端的 Settings > Usage 点 Reset for free | 终端和 IDE 里的 Claude Code 没有这个按钮;按所给的重置类型,把 5 小时额度或每周额度立即恢复满额,用后不能撤销 |
| 升级套餐 | Pro 升 Max 5x,Max 5x 升 Max 20x | 经常撞线才值得 |
自动续跑可以在 /config 里关掉 Continue automatically at usage limit,或在用户设置里写 "autoContinueAtUsageLimit": false。/rate-limit-options 会列出等待后续跑、添加用量积分和升级几项。每周额度常常要几天后才重置,重置时间超过 24 小时的,Claude Code 不会自己开始等待。桌面端的会话额度卡片另有一个 Auto-continue when limits reset 勾选框,和终端里的设置互不影响,要分别关闭。
相邻的问题各有专门的页面:终端里出现 Rate limit reached 原话、需要马上恢复工作,看 Claude Code Rate Limit Reached 怎么办:认出限额类型,原会话续跑;用量积分会花多少钱,看 Claude 额外使用费用:用量积分、Max 和 Claude Code 账单怎么判断;赠金、用量积分和限额重置先用哪个,看 Claude 云端会话赠金、用量积分和限额重置:区别与使用顺序;要不要升级,看 Claude Pro vs Max 怎么选(2026):价格、Claude Code 限制与 Max 是否值得。
用量掉得快:先在现场建一张审计台账

保留出问题的会话,不用导出整段聊天,只记能比较的字段:
- 时间与时区,用来对齐 Console 或云账单;
claude --version、模型和 effort;/status里的账号与登录方式、工作目录、session ID;/context的总占比和最大的几类;/usageSession 区块里每个模型的 input、output、cache read、cache write;/usage用量拆分里技能、子代理、插件和单个 MCP server 的占比,Loops 行,以及被标出的行为;- 准确的限额提示、
429、529或上下文警告原文; - 最近是否切过模型、改过 effort、连接过 MCP、执行过
/compact、升级过版本或恢复过旧会话。
需要交给支持时,不要放 API key、私人对话、客户代码或完整文件内容。
上下文变重,还是缓存反复重建
两者不是一回事。Claude Code 每次请求都会带上完整对话,每用一次工具还会再发一个携带工具结果的请求。缓存正常时,这段历史按缓存读取的价格重读,但仍然计入用量:一个开了一整天的会话里问一句话,算的是整段对话的量。
先看 /context。启动时就可能载入了 CLAUDE.md、memory、MCP 工具名和 skill 描述,随后文件读取、工具返回和对话继续累积。最大的几项如果来自已经做完的旧任务,最有效的动作是开一个范围明确的新会话,而不是继续压缩同一条历史。
再看缓存。v2.1.251 起,/usage 的 Session 区块多了一行 Prompt cache (main),列出多少比例的输入来自缓存、几次未命中、几次预期内的重建(压缩或清理旧工具结果造成的),以及缓存现在是热还是冷、有效期多长;v2.1.260 起还会写出上一次未命中的可能原因。这一行只统计主对话,不含子代理。
判断时用这几条:
- 缓存有效期在订阅上是 1 小时,使用用量积分期间降到 5 分钟,API key 和云厂商默认 5 分钟。离开超过有效期,回来的第一条消息会重新处理全部上下文。
- 切换模型或 effort、改变加载的工具、执行
/compact、升级版本或换路线之后,出现一次重建是正常的。值得调查的是:路线、模型、工具都没变、间隔也很短,相似请求却连续出现高 cache write、低 cache read。 - 会话空闲时额度仍在掉,看有没有定时任务按间隔触发、其他会话发来的消息、目标(goal)的空闲检查,这些都会带着完整上下文发请求。后台的会话摘要等功能也会消耗少量 token,官方给的量级是每个会话通常不到 $0.04。
/compact本身要读一遍它要总结的对话,压缩一个很大的上下文就是一次大请求;只想重新开始时,/clear不花额度。
缓存失效的具体原因和代价见 Claude Code 缓存未命中 token 成本:一次对话为什么突然变贵。
MCP 用量要分开查工具定义和返回数据
不要用“装了几个 MCP”直接估成本。MCP 工具定义默认延迟加载:在 Claude 真正用到某个工具之前,进入上下文的只有工具名和 server 说明。
审计时分两层:
- 用
/mcp和/context看哪些 server 真正启用、占了多少上下文。 - 看工具调用返回了多少内容。定义很小的工具也可能带回整张表、整段日志或大量搜索结果,并一直留在会话历史里。
/usage用量拆分里某个 MCP server 的占比,只统计用到了它的工具结果的那些请求;v2.1.222 之前的版本会把调用过它之后的所有请求都算到它头上,占比偏高。
单次 MCP 输出超过 10,000 token 时 Claude Code 会警告,默认上限是 25,000 token。用 MAX_MCP_OUTPUT_TOKENS 把上限调大,只会让更多内容进入上下文,不会更省。优先用筛选、分页、摘要或文件路径。需要系统清理时,看 Claude Code MCP 上下文爆掉:为什么服务器太多会吃窗口,怎么筛选和压缩。
用一个干净会话做对照,判断是否值得上报

选一个小而能完成、又能代表原任务的动作。不要换模型或换路线,否则对照就失效了。
- 保持版本、项目、登录方式、模型和 effort 相同。
- 新开会话,只保留任务真正需要的 MCP。
- 开始前记下
/usage和/context。 - 完成一个边界清楚的动作。
- 再记一次同样的字段,比较上下文增长、cache read 与 cache write、output、MCP 占比和套餐用量条的变化。
干净会话明显更轻,问题多半在旧会话本身:历史累积、过大的工具结果、混进来的无关任务或多个代理的上下文,按下一节的表处理。
干净会话仍然复现异常,就别再重复烧额度了,把台账整理成可核对的材料:同一版本、路线、模型、effort 和小任务,新会话,MCP 不变,带时间戳和 token 分类,复现一次即可。订阅用户在 claude.ai 左下角点自己的头像缩写,选 Get help;API 账单问题在 platform.claude.com 走同样的入口。
按证据选降耗动作,而不是照着清单全做一遍
| 台账里看到的 | 第一动作 | 先别做 |
|---|---|---|
| 无关任务堆在同一个会话,上下文持续增长 | 换任务时 /clear;想以后回来,先 /rename,之后用 /resume | 直接升级套餐 |
| 同一任务做到一半,对话已经很长 | 带重点的 /compact,例如 /compact 保留失败的测试和改过的文件;也可在 CLAUDE.md 里写压缩说明 | 每轮都压缩 |
/context 里启动内容就很大 | 把特定流程的说明从 CLAUDE.md 挪进 skills,CLAUDE.md 控制在 200 行左右 | 删掉所有项目说明 |
| 缓存未命中被标出,或 cache write 连续偏高 | 固定模型、effort、工具和路线;长时间离开前先收尾或 /clear | 每轮都压缩 |
| 某个 MCP server 占比突出 | 缩小查询和返回;有 gh、aws、gcloud 这类 CLI 就让 Claude 直接用;在 /mcp 里停用当前用不到的 server | 调大输出上限 |
| output 占大头 | 日常任务用 /effort 调低,思考 token 按输出计;Opus 5.5、Sonnet 5.5 和 Fable 系列不能关思考,只能调 effort | 归咎于缓存 |
| 日常编码默认跑 Opus | 大多数编码用 Sonnet;/model opusplan 让 Opus 做规划、Sonnet 执行;简单的子代理配置 model: haiku | 所有任务一律用最强模型 |
粘贴大段日志,或用 @ 引用整个文件 | 改为写出文件路径让 Claude 按需读;日志只留相关的二三十行;用 hook 先把测试输出过滤到只剩失败项 | 把整个日志贴进对话 |
| 子代理、工作流或 agent team 占比高 | 子代理换小模型;agent team 保持小规模、做完就关,队友在 plan mode 下运行时大约消耗普通会话 7 倍的 token | 以为子代理的请求不算额度 |
| Loops 行靠前,或空闲时额度仍在掉 | 降低 /loop 和定时任务的频率,停掉不需要的 | 一直开着会话等它 |
| 需求含糊,Claude 大范围扫描或做错方向返工 | 写具体需求;复杂任务先进 plan mode;方向不对立刻按 Esc 或 /rewind | 让它做完再整体重来 |
错误是 529 | 看服务状态并有限重试,详见 Claude Code 报 529 过载怎么办:换模型还是等待 | 当作个人额度耗尽 |
API 或云厂商返回 429 | 按重试时间和限额处理,详见 Claude Rate Exceeded 错误:先确认限制归属再重试 | 当作 Pro/Max 套餐用完 |
| 干净对照仍然异常 | 带台账联系支持 | 买更多额度掩盖问题 |
一次审计不需要建立完美的 token 模型。每个大的变化能归到上下文携带、缓存写入或读取、MCP 定义或返回、模型输出、子代理和并发、定时任务、订阅窗口或计费路线之一,就足够决定下一步。
按 5 小时和每周额度安排一天、一周的重活
真正卡住人的常常是每周额度:5 小时窗口几个小时后就回来,每周额度用光要等到固定的重置日。排活时两条线一起看。
- 开工前看两个百分比。 在
/usage或状态栏看 5 小时和 7 天各用了多少、各自何时重置。5 小时额度决定这几个小时能不能做完,每周额度决定接下来几天还剩多少。 - 算出每天能花多少每周额度。 本周剩余百分比除以距每周重置的天数。比如 7 天额度已用 64%,还有 3 天重置:(100 − 64) ÷ 3 = 12,每天大约 12 个百分点。
- 量一次自己的换算比。 在一个典型工作时段的开始和结束各记一次两个百分比。假设 5 小时额度从 0 用到 80%,每周额度涨了 8 个点,那么用满一个 5 小时窗口大约要花 8 ÷ 80 × 100 = 10 个点的每周额度。按上一步每天 12 个点算,一天只够一个多满窗口。这个比值随模型、effort 和任务类型变化,换了工作方式要重新量。
- 大并发放在每周额度宽裕的时候。 工作流并发、多个子代理和 agent team 会在一个窗口里吃掉大块每周额度。临近周重置、每周额度又紧张时,拆成几批跨窗口跑,或先用 Sonnet 和较低 effort 做前期探索。
- 想清楚要不要让它在你离开时续跑。 自动续跑会在重置后无人值守地花掉下一个窗口。每周额度紧张时,下班前在
/config关掉它,或在/rate-limit-options里选不自动继续。 - 休息前先收尾。 订阅的缓存有效期 1 小时,休息更久回来,第一条消息要重新处理全部上下文。Pro 和 Max 在长时间休息后恢复大会话时,Claude Code 会提出从摘要继续;选择从摘要继续,后面的请求就不用带完整历史。
- 事先定好超额怎么办。 当天必须交付的工作,提前开好用量积分并设每月上限,比撞线时临时决定更稳;使用积分期间缓存有效期只有 5 分钟,尽量连续工作。手里有限额重置时,它恢复哪条额度由提供的类型决定,留到真正卡住的时候再用。
如果按这个节奏仍然几乎每周都提前用完每周额度,问题就不在用法,而在套餐大小了。Pro、Max、Team 和 API 的价格对比见 Claude Code 价格 2026:Pro、Max、Team、API 和额外用量怎么选。
Claude Code 用量查看的常见问题
Claude Code 查看用量的命令是哪个?
/usage。它同时显示当前会话的 token 与本机估算、套餐的 5 小时和每周用量条、活动统计以及用量拆分。/cost 和 /stats 是它的别名,/stats 直接打开 Stats 标签。/status 只显示版本、模型、账号和连通性。
Claude Code Pro 的用量是多少?
官方不公布小时数或消息条数。Pro 的会话额度每五小时重置,另有每周额度;Max 5x 和 Max 20x 的单个会话额度分别是 Pro 的 5 倍和 20 倍。实际能用多少取决于上下文长度、模型、effort 和功能,以 /usage 显示的百分比为准。免费版和 Pro 的差别见 Claude 免费版和 Pro 用量差多少?官方不再给倍数,按任务中断判断。
Claude Code 和 Claude 网页版的额度是分开算的吗?
不分开。claude.ai 网页、Claude Code、Claude Desktop 和 IDE 插件计入同一份 5 小时额度和每周额度。只有用 API key 或云厂商账号登录时,Claude Code 才按 token 单独计费,和订阅额度无关。
参考来源4
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月5日。
参考来源4
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月5日。





