第 7 期：用量限制（Usage Limits）

本期核心：理解你的订阅配额还剩多少，避免关键时刻被限流。

---

7.1 谁有用量限制

订阅类型	有限制	说明
Claude Pro	是	5 小时滚动窗口 + 7 天窗口
Claude Max	是	更高限额
Claude Team	是	团队共享
API 用户	否	按实际 Token 付费

---

7.2 HUD 中的用量显示

Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)

信息	含义
25%	5 小时窗口已用 25%
1h 30m	已消耗 1.5 小时
5h	窗口总长 5 小时

7 天用量超过阈值时额外显示：

Usage ██░░░░░░░░ 25% (1h 30m / 5h) | ██████████ 85% (2d / 7d)

---

7.3 用量条颜色

颜色	含义
🔵 蓝色	正常
🟣 紫色	接近阈值
🔴 红色	达到限制

---

7.4 用量不显示的排查

• 确认是 Pro/Max/Team 订阅（非 API key）
• display.showUsage 不为 false
• API 用户无限额显示（按 Token 付费）
• Bedrock/Vertex 用户用量在云平台管理
• 自定义 ANTHROPIC_BASE_URL 会跳过用量显示

---

7.5 配置用量显示

{
  "display": {
    "showUsage": true,
    "usageBarEnabled": true,
    "usageCompact": false,
    "sevenDayThreshold": 80,
    "timeFormat": "relative",
    "showResetLabel": true
  }
}

配置	说明
usageCompact	简短文本格式，如 5h: 25% (1h 30m)
timeFormat	relative（倒计时）/ absolute（具体时间）/ both
sevenDayThreshold	7 天用量显示阈值（0 = 始终显示）

---

下期预告：第 8 期讲解 Git 状态显示与工具/Agent/Todo 活动行的配置与含义。