claude-hud

用途：为 Claude Code 配置状态栏（statusline），实时显示上下文窗口用量与会话信息，帮助判断何时压缩上下文。配置写入 .claude/settings.json，例如： { "statusline": { "enabled": true, "template": "[CTX: {{context_window.used_percentage}}%] {{session.cost}}" } } 主要字段：CC 2.1.6 提供 context_window.used_percentage、context_window.remaining_percentage、session.cost、session.duration；CC 2.1.7 新增 turn.duration、context_window.effective、context_window.effective_percentage、mcp.deferred，可通过 showTurnDuration 开启回合时长显示。 阈值提示：按有效窗口（200K 上限扣除约 20% 系统开销后约 160K）计算，低于 60% 为绿色正常，60–80% 黄色建议分块，80–95% 橙色建议压缩或摘要，超过 95% 红色提示立即压缩。可用 elements.context_bar 配置进度条及 normal/warning/critical 阈值。 与 OrchestKit 集成：其 hook 可在上下文过高时提示使用 /ork:context-compression，并在超过 60% 时采用更积极的渐进加载策略。 限制与排障：需 Claude Code 版本不低于 2.1.6（VSCode 功能需 2.1.14）；状态栏不显示时检查版本、settings.json 语法并重启会话；百分比由系统提示、对话历史、已加载技能与上下文文件、待处理工具输出等计算，数值异常可检查大文件。VSCode 中可使用 /usage 查看计费周期用量，并通过 claudeCode.statusBar 设置状态栏。具体收费、价格与效果资料暂未提供。