小伙伴们大家好我是小溪见字如面。最近在使用Claude Code CLI时因为无法实时查看上下文窗口信息导致经常上下文频繁压缩打断开发进度体感非常不好在逛Github时找到一个不错的项目这里记录一下配置使用方式。当前使用版本2.1.156 (Claude Code)优势原生Token数据精度无感嵌入实时动态追踪灵活的配置方式限制仅限于在Cluade Code中使用高频刷新可能带来轻微开销Linux和Windows平台有一定限制简介Claude HUD 是一个专为 Claude Code 命令行工具设计的状态栏插件。它利用Claude Code的 statusline 在终端输入框下方实时展示会话状态能够直观呈现上下文健康度、订阅限额使用率、当前活跃工具、后台运行的 Agent 以及待办任务进度无需额外窗口或复杂配置即可大幅提升命令行开发时的交互体验与透明度。Github地址https://github.com/jarrodwatts/claude-hud安装Claude HUD是Claude Code的一个插件需要添加插件市场进行安装。添加插件市场启动Claude Code CLI在交互式命令行中输入如下命令添加插件市场/plugin marketplaceaddjarrodwatts/claude-hud安装插件插件市场添加成功后输入下面命令安装插件/plugininstallclaude-hudClaude Code CLI会进行插件安装界面选择安装位置回车安装完成后在交互式命令中输入 /plugins 切换到【Installed】查看看到【claude-hub】插件即为安装成功插件安装完后执行下面命令重新加载插件/reload-plugins配置statusline注意初始化过程需要模型配合Claude HUB插件安装完成后在交互式命令中输入下面命令进行初始化/claude-hud:setup初始化完成后可以看到如下效果工作原理Claude HUD使用Claude Code原生的statusline API——无需独立窗口不需要 tmux在任何终端都能工作。Claude Code → stdinJSON→ claude-hud → stdout → 在终端中显示 ↘ transcriptJSONL工具、Agent、待办核心特性来自Claude Code的原生Token数据非估算适配Claude Code报告的上下文窗口大小包括最新的1M上下文会话解析转录文件以获取工具/Agent 活动约每 300ms 更新一次功能及配置Claude HUD提供了多种状态显示效果大致如下第 1 行模型 项目名 git 状态第 2 行上下文使用率条 使用配额条可选行工具活动、代理状态、todos 等首次安装默认展示2行可选行是不展示的不过官方也提供了可选行的配置目前可以通过 引导式 和 手动 2种方式进行配置引导式配置在Claude Code CLI中输入以下命令唤起引导式配置根据可视化交换进行配置/claude-hud:configure第一步配置布局Claude HUD提供了3种布局方式展开模式(推荐)按语义分行展示身份、项目、环境、用途紧凑单行模式所有内容合并为单行带分隔符紧凑模式单行展示行为标识前添加分隔符为了展示最全的效果这里我选择【展开模式】回车后进入【预设选择】配置展示内容Claude HUD提供了3种预设选择完整Full全部启用——工具、Agent、待办、Git、使用率、时长核心Essential活动行 Git 状态减少信息冗余极简Minimal仅核心——只有模型名称和上下文进度条这里我选择【Full】回车后进入【语言选择】这里我选择【简体中文】回车后进入【关闭功能】可以选择要关闭展示的状态提交后最后进行自定义行的配置这里我选择【3】输入自定义内容预览配置无误后选择【保存设置】配置保存后Claude Code CLI输入框底部会出现前面配置内容的状态展示效果如下保存命令会创建插件配置 ~/.claude/plugins/claude-hud/config.json完成内容如下{lineLayout:expanded,showSeparators:false,language:zh-Hans,display:{showModel:true,showContextBar:true,showTools:true,showSkills:true,showMcp:true,showAgents:true,showTodos:true,showProject:true,showAddedDirs:true,showConfigCounts:true,showTokenBreakdown:true,showSpeed:true,showCost:true,showRoutedCost:true,showUsage:true,showResetLabel:true,showDuration:true,showSessionName:true,showSessionTokens:true,showEffortLevel:true,showOutputStyle:true,showMemoryUsage:true,showPromptCache:true,showClaudeCodeVersion:true,showCompactions:true,showAdvisor:true,customLine:hello world},gitStatus:{enabled:true,showDirty:true,showAheadBehind:false,showFileStats:false}}手动配置手动配置Claude HUD就是直接编辑~/.claude/plugins/claude-hud/config.jsonClaude HUD提供了如下配置languageHUD标签语言默认en可选值en | zh | zh-Hans | zh-Hant | zh-TW。设为zh/zh-Hans启用简体中文设为zh-Hant/zh-TW启用繁体中文lineLayout行布局默认expanded可选值expanded多行展开、compact单行紧凑、compact-separated带分隔符紧凑单行pathLevels项目路径显示的目录层级数默认1取值范围1-3maxWidth备用回退宽度默认null类型数字|null仅终端宽度检测完全失效时生效forceMaxWidth是否强制使用maxWidth默认false类型布尔值配置maxWidth后该参数开启则忽略终端检测到的更小宽度强制使用设定宽度elementOrder展开模式下各元素展示顺序默认[“project”,“context”,“usage”,“promptCache”,“memory”,“environment”,“tools”,“agents”,“todos”,“sessionTime”]类型字符串数组列表中省略的内容将在展开布局隐藏旧配置会保留自定义顺序直至更新display.mergeGroups展开模式下可合并同行的相邻元素分组默认[[“context”,“usage”]]类型二维字符串数组设为空数组[]即可关闭行合并功能gitStatus.enabled是否在HUD展示Git分支信息默认true类型布尔值gitStatus.showDirty是否显示*标记代表未提交变更默认true类型布尔值gitStatus.showAheadBehind是否展示提交超前/落后远程计数默认false类型布尔值gitStatus.pushWarningThreshold未推送提交数警告阈值默认0类型数字达到阈值后超前计数使用警告色0代表关闭警告gitStatus.pushCriticalThreshold未推送提交数严重警告阈值默认0类型数字达到阈值后超前计数使用危险色0代表关闭严重提醒gitStatus.showFileStats是否展示文件变更统计默认false类型布尔值gitStatus.branchOverflow超长分支名处理方式默认truncate可选值truncate截断、wrap换行truncate为直接截断文字wrap会将Git模块单独换行展示display.showModel是否展示模型名称默认true类型布尔值示例展示[Opus]display.modelSource模型名称数据来源默认stdin可选值stdin | auto | transcriptstdin默认逻辑auto仅代理路由返回非Claude模型时切换transcript始终读取API返回模型。自动清理终端转义字符文字最大截断80字符display.showAddedDirs是否展示/add-dir添加的额外工作目录默认true类型布尔值两种布局最多展示5个目录超出显示N more目录名基础部分截断24字符并添加省略号…display.addedDirsLayout额外目录展示样式默认inline可选值inline | lineinline和项目名称同行前缀目录名line单独一行展示Added dirs: name1,name2无前缀、逗号分隔display.showContextBar是否展示可视化上下文进度条 ████░░░░░░默认true类型布尔值display.contextValue上下文用量展示格式默认percent可选值percent | tokens | remaining | bothpercent百分比tokens总Token数remaining剩余占比both百分比Token总数同时展示display.showConfigCounts是否统计并展示CLAUDE.md、规则、MCP服务、钩子脚本数量默认false类型布尔值display.showCost是否显示会话消耗费用默认false类型布尔值优先读取Claude Code原生cost.total_cost_usd无数据时本地估算display.showRoutedCost是否展示第三方路由服务商Bedrock/Vertex费用默认false类型布尔值必须同时开启showCost才生效原生费用有效标注CostToken估算标注Est.display.showOutputStyle是否展示当前Claude Code输出样式默认false类型布尔值展示格式style: 样式名display.showDuration是否展示会话总时长默认false类型布尔值示例⏱️ 5mdisplay.showSpeed是否展示输出Token速率默认false类型布尔值示例out: 42.1 tok/sdisplay.showUsage是否展示Claude订阅额度使用限制默认true类型布尔值仅订阅用户可用display.usageValue订阅额度展示格式默认percent可选值percent | remainingpercent已使用占比remaining剩余占比display.usageBarEnabled是否使用可视化进度条展示额度默认true类型布尔值关闭后仅纯文本展示display.usageCompact是否启用精简额度文本默认false类型布尔值示例5h: 25% (1h 30m)优先级高于进度条开关display.showResetLabel额度倒计时前是否显示resets in前缀默认true类型布尔值display.timeFormat额度重置时间展示方式默认relative可选值relative | absolute | both | elapsed | elapsedAndAbsoluterelative仅倒计时absolute墙钟重置时刻both两者同时elapsed窗口已过百分比elapsedAndAbsolute已过比例墙钟时间display.sevenDayThreshold7天使用率提醒阈值默认80取值范围0-100使用率≥阈值时展示0代表永久展示display.externalUsagePath本地使用率快照文件路径默认空字符串类型字符串仅标准输入缺少rate_limits数据时读取该文件display.externalUsageWritePath快照写入绝对JSON路径默认空字符串类型字符串父目录必须提前存在标准输入存在rate_limits时自动写入快照供本地工具读取相对路径、非JSON文件、不存在父目录会直接忽略display.externalUsageFreshnessMs外部快照文件有效时长默认300000毫秒类型数字文件超过该时长会判定失效不再读取display.showTokenBreakdown高上下文85%及以上时是否展示Token详细数据默认true类型布尔值display.showTools是否展示工具运行状态行默认false类型布尔值display.toolNameMaxLength工具名称最大展示字符长度默认0类型数字0代表完整名称MCP名称截断仅保留末尾段display.toolsMaxVisible单行最多展示已完成工具数量默认4类型数字0代表无数量限制display.showAgents是否展示代理Agent活动行默认false类型布尔值display.showTodos是否展示待办事项进度行默认false类型布尔值display.showSessionName是否展示会话标识slug或/rename自定义标题默认false类型布尔值display.showAdvisor是否在行内展示/advisor配置的顾问模型默认false类型布尔值示例Advisor: Opus 4.7自动过滤控制字符、ANSI转义最大截断64字符display.advisorOverride手动自定义顾问展示文字默认空字符串类型字符串非空时优先覆盖自动读取的模型名称同样过滤特殊字符并截断display.showSessionStartDate是否展示会话创建时间戳默认false类型布尔值display.showLastResponseAt是否展示上一次助手响应距今时长默认false类型布尔值display.showCompactions是否展示会话上下文压缩次数默认false类型布尔值手动执行/compact或自动压缩都会计数示例压缩次数: 2无压缩时不渲染该行display.showClaudeCodeVersion是否展示本地Claude Code版本号默认false类型布尔值示例CC v2.1.81display.showMemoryUsage展开布局下是否展示近似系统内存占用默认false类型布尔值display.showPromptCache是否展示提示缓存倒计时默认false类型布尔值读取最后一次助手响应数据计算缓存有效期display.promptCacheTtlSeconds提示缓存存活时长秒默认300类型数字Pro版本默认300Max版本可调整至3600display.customLine自定义行内容colors.context上下文进度条与百分比文字基础色默认green类型颜色值colors.usage额度进度条、低于警告阈值百分比文字颜色默认brightBlue类型颜色值colors.warning上下文超限、额度警告文本颜色默认yellow类型颜色值colors.usageWarning额度接近阈值时进度条与文字警告色默认brightMagenta类型颜色值colors.critical额度触顶、严重超限状态文字颜色默认red类型颜色值colors.model模型标签徽章颜色默认cyan类型颜色值colors.project项目路径文字颜色默认yellow类型颜色值colors.gitGit外围括号文本颜色git:( )默认magenta类型颜色值colors.gitBranchGit分支名、分支状态文字颜色默认cyan类型颜色值colors.label次要标签、元数据文字颜色Context、Usage、计数等默认dim类型颜色值colors.custom自定义单行模块文字颜色默认208类型颜色值colors.barFilled进度条填充字符默认█类型字符串colors.barEmpty进度条空白字符默认░类型字符串下面是我精简后的配置{lineLayout:expanded,showSeparators:false,language:zh-Hans,display:{showModel:true,showContextBar:true,showSkills:true,showMcp:true,showAgents:true,showTodos:true,showProject:true,showAddedDirs:true,showConfigCounts:true,showTokenBreakdown:true,showSpeed:true,showCost:true,showRoutedCost:true,showUsage:true,showResetLabel:true,showDuration:true,showSessionName:true,showSessionTokens:true,showEffortLevel:true,showOutputStyle:true,showCompactions:true,showAdvisor:true},gitStatus:{enabled:true,showDirty:true,showAheadBehind:false,showFileStats:false}}配置效果如下友情提示见原文Claude HUD一款好用的Claude Code状态栏插件