第 4 期：配置与预设

本期核心：HUD 的灵活性在于可深度定制。三种预设覆盖 90% 的使用场景。

---

4.1 交互式配置

/claude-hud:configure

引导流程：

1. 选预设（Full / Essential / Minimal）
2. 选择语言（English / 中文）
3. 开关个别元素
4. 预览效果
5. 保存

---

4.2 三种预设

预设	内容
Full	全部开启 — 工具、Agent、Todo、Git、用量、时长
Essential	活动行 + Git 状态，信息精简
Minimal	仅模型名 + 上下文条

---

4.3 手动配置

编辑 ~/.claude/plugins/claude-hud/config.json：

{
  "language": "zh",
  "lineLayout": "expanded",
  "pathLevels": 2,
  "elementOrder": ["project", "tools", "context", "usage", "environment", "agents", "todos"],
  "gitStatus": {
    "enabled": true,
    "showDirty": true,
    "showAheadBehind": true,
    "showFileStats": true
  },
  "display": {
    "showTools": true,
    "showAgents": true,
    "showTodos": true,
    "showDuration": true,
    "showSpeed": true
  },
  "colors": {
    "context": "cyan",
    "usage": "cyan",
    "warning": "yellow",
    "critical": "red"
  }
}

---

4.4 核心配置项

配置项	类型	默认	说明
lineLayout	expanded / compact	expanded	多行或单行
pathLevels	1-3	1	目录显示层级
language	en / zh	en	标签语言
elementOrder	string[]	见文档	行排列顺序，省略即隐藏

---

4.5 setup vs configure — 两个命令的区别

	/claude-hud:setup	/claude-hud:configure
用途	一次性安装注册	日常功能定制
做什么	检测平台 → 找插件路径 → 生成 statusline 命令 → 写入 settings.json	修改 config.json
修改的文件	~/.claude/settings.json（全局设置）	~/.claude/plugins/claude-hud/config.json（插件配置）
何时运行	首次安装后运行一次	想改 HUD 显示内容时随时运行
需要重启	是	否（配置即时生效）
交互方式	自动检测，无交互	交互式引导

典型流程：

首次安装：
  /plugin install claude-hud    ← 安装插件文件
  /claude-hud:setup             ← 注册 statusline（写 settings.json）
  重启 Claude Code              ← 使 statusline 生效
  /claude-hud:configure         ← 定制 HUD 显示内容（可选）

日常使用：
  /claude-hud:configure         ← 随时调整 HUD 显示（即时生效）

---

下期预告：第 5 期深入上下文窗口——理解 200K tokens 里到底装了什么，以及什么操作会让它暴涨。