第 18 期：Q&A — HUD 排错、Memory 与高级话题

本期场景：进阶用户在深度使用后遇到的 6 个高级问题。

---

Q15：HUD token 明细为什么不显示？

按诊断顺序排查：

1. contextCriticalThreshold 太高 — 默认 85%，context 不到 85% 时不显示。降到 30：{ "contextCriticalThreshold": 30 }
2. current_usage 数据缺失 — 非原生 Claude 模型可能不提供此字段
3. 多行截断 — expanded 布局行太多，session tokens 行被截断。关掉不重要的元素
4. showTokenBreakdown 被关 — 确认不是 false

详见第 12 期完整诊断流程。

---

Q16：非原生 Claude 模型 HUD 功能有什么不同？

功能	原生 Claude	ZAI 等兼容平台
上下文百分比	正常	正常
Token 明细	正常	⚠️ 可能缺失
用量限制	正常	❌ 不显示
费用估算	实际费用	⚠️ 可能为 $0

HUD 有 context-cache 兜底：即使 stdin 偶尔缺数据，从上次完整快照恢复。

---

Q17：expanded 布局后面几行消失怎么办？

Claude Code statusLine 多行显示有已知限制（GitHub #37522）。

解决方案：

1. 关闭不重要的元素（推荐）：

   { "display": {
       "showSessionName": false,
       "showClaudeCodeVersion": false,
       "showMemoryUsage": false,
       "showOutputStyle": false
   }}
   

2. 加宽终端窗口
3. 切 compact 布局：{ "lineLayout": "compact" }

---

Q18：Memory 会占上下文吗？

会。Memory 文件在 SessionStart 时注入 system prompt，成为固定部分。

固定部分 = System Prompt (~3K) + CLAUDE.md (~4K) + Memory (~0.5-3K) + Hooks (~1.5K)

但因为有 Prompt Cache，固定部分只收一次费用。Memory 占空间，但不重复收费。

---

Q19：Session History 文件能删吗？

能删，但不推荐。删了之后：

• HUD 无法读取此 Session 的工具/agent/todo 数据
• claude-mem 无法从此 Session 提取 observations
• 对话历史永久丢失

如果想清理磁盘，删最旧的 Session：

ls -lt ~/.claude/projects/-Users-eric-work-teachagent/*.jsonl | tail -10

---

Q20：/compact 和 /clear 对 Memory 有影响吗？

没有。Memory 文件存储在 memory/ 目录，独立于 Session。

• /compact — 只压缩 Session 内的对话历史，不碰 Memory
• /clear — 清空 Session 对话历史，不碰 Memory
• Memory 只在你手动编辑或 Claude 主动写入时变化

新 Session 启动时，Memory 通过 SessionStart hook 自动加载，不受前一个 Session 影响。

---

教程完结：恭喜你完成了 Claude HUD 的 18 章完整教程！从安装到精通，你已经掌握了上下文管理、Token 优化、缓存策略的全部核心知识。

项目地址：jarrodwatts/claude-hud