Claude HUD 完整配置指南手把手配好你的个性化状态栏【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hudClaude HUD 是一款 Claude Code 插件把会话的实时状态——上下文用量、正在使用的工具、子代理进度、待办完成度——固定显示在输入框下方状态栏即终端输入框下面始终可见的那一行。如果你每天用 Claude Code又总担心上下文还剩多少它现在到底在改哪个文件这个插件就是为你准备的。读完本文你能从零把它装好、跑通配置向导并把显示元素和顺序调成自己的习惯——让屏幕底部的一小块区域替你盯住整个会话在发生什么。 为什么值得花十分钟配置它一眼看到上下文剩余量快满时提前压缩实时看到 Claude 在读改哪些文件子代理进度不用切窗口去问待办完成度直接显示不再追问进度 核心元素速览始终可见模型名— 当前用的模型如[Opus 4.5]上下文条— 可视化上下文占用颜色随占用从绿变黄再变红可选开启默认隐藏在配置向导里打开项目路径— 当前工作目录可设 1~3 级目录深度Git 状态— 分支名、脏标记*、领先/落后远程的提交数工具活动— Claude 正在使用的读取、编辑、搜索工具代理状态— 哪些子代理在跑、各自在做什么任务待办进度— 任务完成数如(2/5)用量限制— 订阅配额的消耗比例与重置倒计时后六项只在已开启 有活动时才出现所以默认两行很干净开多了也不会吵。 三种预设先选一个再微调预设包含内容适合场景Full全部开启工具、代理、待办、Git、用量、时长复杂项目、需要全面监控Essential活动行 Git 状态信息最少日常专注编码Minimal只有模型名 上下文条简单任务、小屏幕建议先选 Full 再逐项关掉向导允许选完预设后单独开关每个元素选错了随时可改。布局也有三种expanded扩展把元素分成语义行、compact紧凑全部挤在一行、compact 分隔符一行显示但在活动前加分隔线。扩展布局是推荐项信息分层更清楚。️ 五步配好你的 HUD1. 添加市场并安装插件在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud也可以在终端用claude plugin marketplace add加claude plugin install完成同样两步。Linux 上若安装报 EXDEV 错误先升级 Claude Code 再装。2. 重载插件并运行 setup/reload-plugins /claude-hud:setupsetup 会把 HUD 写进 Claude Code 的 statusline 配置。完成后随便发一条消息输入框下方出现两行模型 项目 Git下面是上下文条和用量即算成功。Windows 若提示找不到 JavaScript 运行时先安装 Node.js LTS 再重跑 setup。3. 选布局和预设运行/claude-hud:configure进入向导。先选布局推荐扩展再选预设Full / Essential / Minimal最后选标签语言英文 / 简体中文 / 繁體中文。向导保存前会给预览确认效果再落盘。4. 逐项开关元素向导引导你走两轮从预设已开启的项目里关掉不需要的再从关闭项里打开想要的工具、代理、待办、用量、时长、配置计数等。Git 详细程度也可在此选仅分支、加脏标记、加领先/落后数、或加文件变更统计。5. 保存后在配置文件里精调向导覆盖不了的高级项可以手动编辑~/.claude/plugins/claude-hud/config.json之后再跑向导也会保留这些手动设置。一份最典型的精调配置{ lineLayout: expanded, pathLevels: 2, elementOrder: [tools, project, context, usage, agents, todos], display: { showTools: true, showAgents: true, showTodos: true } }elementOrder里越靠前越先显示写进数组的项才会出现漏写即隐藏pathLevels控制项目路径显示几级目录颜色改colors即可。 即拿即用的场景配方前端同学的监控位showTools、showTodos、showDuration全开elementOrder把tools放第一位效果Claude 每次读写文件都第一时间进眼重构跑到哪一步心里有数。跑长任务的人showUsage、showTokenBreakdown、showSpeed开启上下文显示格式设为both百分比 具体 token 数lineLayout选compact省垂直空间效果一行里同时看到配额消耗、剩余上下文和输出速度长任务不用频繁回查。多人协作 / 多会话并行showSessionName、showAgents、showTodos开启效果多个会话并排时一眼分辨每个会话在跑什么任务、进行到哪一步。 常见问题速查配置改了不生效多半是 JSON 语法错误无效配置会静默回退默认值。检查语法或直接删掉配置文件重跑/claude-hud:configure重新生成。装完看不到 HUD状态栏只在下次交互后渲染。随便发一条消息即可仍不出现就重启 Claude Code并确认环境里没设CLAUDE_HUD_DISABLE。工具/代理/待办行一直不出现它们默认隐藏且只在有活动时显示。在向导里打开对应开关后下次 Claude 动手时就能看到。没有用量条该项只对 Pro/Max/Team 订阅账号可用API Key 用户没有配额数据属正常现象。想临时关掉 HUD用CLAUDE_HUD_DISABLE1 claude启动会话即可不用动任何配置。默认预设已经够日常用了。建议先按 Full 跑一周再根据实际使用感受逐项开关、把elementOrder调成顺手顺序你的第一版刚刚好布局会比想象中来得更快。【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Claude HUD 完整配置指南：手把手配好你的个性化状态栏
Claude HUD 完整配置指南手把手配好你的个性化状态栏【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hudClaude HUD 是一款 Claude Code 插件把会话的实时状态——上下文用量、正在使用的工具、子代理进度、待办完成度——固定显示在输入框下方状态栏即终端输入框下面始终可见的那一行。如果你每天用 Claude Code又总担心上下文还剩多少它现在到底在改哪个文件这个插件就是为你准备的。读完本文你能从零把它装好、跑通配置向导并把显示元素和顺序调成自己的习惯——让屏幕底部的一小块区域替你盯住整个会话在发生什么。 为什么值得花十分钟配置它一眼看到上下文剩余量快满时提前压缩实时看到 Claude 在读改哪些文件子代理进度不用切窗口去问待办完成度直接显示不再追问进度 核心元素速览始终可见模型名— 当前用的模型如[Opus 4.5]上下文条— 可视化上下文占用颜色随占用从绿变黄再变红可选开启默认隐藏在配置向导里打开项目路径— 当前工作目录可设 1~3 级目录深度Git 状态— 分支名、脏标记*、领先/落后远程的提交数工具活动— Claude 正在使用的读取、编辑、搜索工具代理状态— 哪些子代理在跑、各自在做什么任务待办进度— 任务完成数如(2/5)用量限制— 订阅配额的消耗比例与重置倒计时后六项只在已开启 有活动时才出现所以默认两行很干净开多了也不会吵。 三种预设先选一个再微调预设包含内容适合场景Full全部开启工具、代理、待办、Git、用量、时长复杂项目、需要全面监控Essential活动行 Git 状态信息最少日常专注编码Minimal只有模型名 上下文条简单任务、小屏幕建议先选 Full 再逐项关掉向导允许选完预设后单独开关每个元素选错了随时可改。布局也有三种expanded扩展把元素分成语义行、compact紧凑全部挤在一行、compact 分隔符一行显示但在活动前加分隔线。扩展布局是推荐项信息分层更清楚。️ 五步配好你的 HUD1. 添加市场并安装插件在 Claude Code 会话里依次执行/plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud也可以在终端用claude plugin marketplace add加claude plugin install完成同样两步。Linux 上若安装报 EXDEV 错误先升级 Claude Code 再装。2. 重载插件并运行 setup/reload-plugins /claude-hud:setupsetup 会把 HUD 写进 Claude Code 的 statusline 配置。完成后随便发一条消息输入框下方出现两行模型 项目 Git下面是上下文条和用量即算成功。Windows 若提示找不到 JavaScript 运行时先安装 Node.js LTS 再重跑 setup。3. 选布局和预设运行/claude-hud:configure进入向导。先选布局推荐扩展再选预设Full / Essential / Minimal最后选标签语言英文 / 简体中文 / 繁體中文。向导保存前会给预览确认效果再落盘。4. 逐项开关元素向导引导你走两轮从预设已开启的项目里关掉不需要的再从关闭项里打开想要的工具、代理、待办、用量、时长、配置计数等。Git 详细程度也可在此选仅分支、加脏标记、加领先/落后数、或加文件变更统计。5. 保存后在配置文件里精调向导覆盖不了的高级项可以手动编辑~/.claude/plugins/claude-hud/config.json之后再跑向导也会保留这些手动设置。一份最典型的精调配置{ lineLayout: expanded, pathLevels: 2, elementOrder: [tools, project, context, usage, agents, todos], display: { showTools: true, showAgents: true, showTodos: true } }elementOrder里越靠前越先显示写进数组的项才会出现漏写即隐藏pathLevels控制项目路径显示几级目录颜色改colors即可。 即拿即用的场景配方前端同学的监控位showTools、showTodos、showDuration全开elementOrder把tools放第一位效果Claude 每次读写文件都第一时间进眼重构跑到哪一步心里有数。跑长任务的人showUsage、showTokenBreakdown、showSpeed开启上下文显示格式设为both百分比 具体 token 数lineLayout选compact省垂直空间效果一行里同时看到配额消耗、剩余上下文和输出速度长任务不用频繁回查。多人协作 / 多会话并行showSessionName、showAgents、showTodos开启效果多个会话并排时一眼分辨每个会话在跑什么任务、进行到哪一步。 常见问题速查配置改了不生效多半是 JSON 语法错误无效配置会静默回退默认值。检查语法或直接删掉配置文件重跑/claude-hud:configure重新生成。装完看不到 HUD状态栏只在下次交互后渲染。随便发一条消息即可仍不出现就重启 Claude Code并确认环境里没设CLAUDE_HUD_DISABLE。工具/代理/待办行一直不出现它们默认隐藏且只在有活动时显示。在向导里打开对应开关后下次 Claude 动手时就能看到。没有用量条该项只对 Pro/Max/Team 订阅账号可用API Key 用户没有配额数据属正常现象。想临时关掉 HUD用CLAUDE_HUD_DISABLE1 claude启动会话即可不用动任何配置。默认预设已经够日常用了。建议先按 Full 跑一周再根据实际使用感受逐项开关、把elementOrder调成顺手顺序你的第一版刚刚好布局会比想象中来得更快。【免费下载链接】claude-hudA Claude Code plugin that shows whats happening - context usage, active tools, running agents, and todo progress项目地址: https://gitcode.com/GitHub_Trending/cl/claude-hud创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
