跳转到主要内容

Claude Code 用量查看与 Token 审计:5 小时和每周额度、缓存与 MCP

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

LaoZhang AI Team发布于更新于 25 分钟阅读
文章目录
Claude Code Token 审计看板,分为上下文、缓存、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 > UsageAPI 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:

bash
#!/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 秒重跑一次,倒计时才会走动:

json
{
  "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 是否值得。

用量掉得快:先在现场建一张审计台账

审计台账:把 Claude Code 的各个计量入口对应到证据强度和计费归属

保留出问题的会话,不用导出整段聊天,只记能比较的字段:

  • 时间与时区,用来对齐 Console 或云账单;
  • claude --version、模型和 effort;
  • /status 里的账号与登录方式、工作目录、session ID;
  • /context 的总占比和最大的几类;
  • /usage Session 区块里每个模型的 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 说明。

审计时分两层:

  1. 用 /mcp 和 /context 看哪些 server 真正启用、占了多少上下文。
  2. 看工具调用返回了多少内容。定义很小的工具也可能带回整张表、整段日志或大量搜索结果,并一直留在会话历史里。/usage 用量拆分里某个 MCP server 的占比,只统计用到了它的工具结果的那些请求;v2.1.222 之前的版本会把调用过它之后的所有请求都算到它头上,占比偏高。

单次 MCP 输出超过 10,000 token 时 Claude Code 会警告,默认上限是 25,000 token。用 MAX_MCP_OUTPUT_TOKENS 把上限调大,只会让更多内容进入上下文,不会更省。优先用筛选、分页、摘要或文件路径。需要系统清理时,看 Claude Code MCP 上下文爆掉:为什么服务器太多会吃窗口,怎么筛选和压缩。

用一个干净会话做对照,判断是否值得上报

Claude Code 高消耗会话与干净对照会话的用量比较

选一个小而能完成、又能代表原任务的动作。不要换模型或换路线,否则对照就失效了。

  1. 保持版本、项目、登录方式、模型和 effort 相同。
  2. 新开会话,只保留任务真正需要的 MCP。
  3. 开始前记下 /usage 和 /context。
  4. 完成一个边界清楚的动作。
  5. 再记一次同样的字段,比较上下文增长、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 小时窗口几个小时后就回来,每周额度用光要等到固定的重置日。排活时两条线一起看。

  1. 开工前看两个百分比。 在 /usage 或状态栏看 5 小时和 7 天各用了多少、各自何时重置。5 小时额度决定这几个小时能不能做完,每周额度决定接下来几天还剩多少。
  2. 算出每天能花多少每周额度。 本周剩余百分比除以距每周重置的天数。比如 7 天额度已用 64%,还有 3 天重置:(100 − 64) ÷ 3 = 12,每天大约 12 个百分点。
  3. 量一次自己的换算比。 在一个典型工作时段的开始和结束各记一次两个百分比。假设 5 小时额度从 0 用到 80%,每周额度涨了 8 个点,那么用满一个 5 小时窗口大约要花 8 ÷ 80 × 100 = 10 个点的每周额度。按上一步每天 12 个点算,一天只够一个多满窗口。这个比值随模型、effort 和任务类型变化,换了工作方式要重新量。
  4. 大并发放在每周额度宽裕的时候。 工作流并发、多个子代理和 agent team 会在一个窗口里吃掉大块每周额度。临近周重置、每周额度又紧张时,拆成几批跨窗口跑,或先用 Sonnet 和较低 effort 做前期探索。
  5. 想清楚要不要让它在你离开时续跑。 自动续跑会在重置后无人值守地花掉下一个窗口。每周额度紧张时,下班前在 /config 关掉它,或在 /rate-limit-options 里选不自动继续。
  6. 休息前先收尾。 订阅的缓存有效期 1 小时,休息更久回来,第一条消息要重新处理全部上下文。Pro 和 Max 在长时间休息后恢复大会话时,Claude Code 会提出从摘要继续;选择从摘要继续,后面的请求就不用带完整历史。
  7. 事先定好超额怎么办。 当天必须交付的工作,提前开好用量积分并设每月上限,比撞线时临时决定更稳;使用积分期间缓存有效期只有 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日。

  1. 1.命令列表code.claude.com/docs/en/commands
  2. 2.成本说明code.claude.com/docs/en/costs
  3. 3.状态栏文档code.claude.com/docs/en/statusline
  4. 4.Claude Consoleplatform.claude.com/usage
更多 Claude Code