Claude HUD 在 Windows 下不显示的修复记录

Claude HUD 在 Windows 下不显示的修复记录

问题描述

在 Windows 系统上,Claude Code 的 claude-hud 插件状态栏始终不显示,即使插件已安装、配置文件存在,重启后也无效。

Claude HUD 显示效果:

环境信息

  • 系统:Windows 11 Pro
  • Shell:Git Bash (bash)
  • Bun:1.3.9(路径:C:\Users\admin\.bun\bin\bun)
  • claude-hud 版本:0.0.11

排查过程

1. 确认 bun 可用

bash 复制代码
which bun
# /c/Users/admin/.bun/bin/bun  ✓

/c/Users/admin/.bun/bin/bun --version
# 1.3.9  ✓

2. 确认插件目录存在

bash 复制代码
ls ~/.claude/plugins/cache/claude-hud/claude-hud/
# 0.0.11  ✓

3. 确认 bun 可以运行 HUD 脚本

bash 复制代码
plugin_dir=~/.claude/plugins/cache/claude-hud/claude-hud/0.0.11/
/c/Users/admin/.bun/bin/bun --env-file /dev/null "${plugin_dir}src/index.ts"
# [claude-hud] Initializing...  ✓

脚本本身可以正常运行,说明问题不在 bun 或插件本身。

4. 定位真正的根因:shell 命令语法错误

settings.json 中的 statusLine.command 值经过 JSON 解码后,awk 部分的引号处理存在问题:

原始 JSON 中的命令(片段):

复制代码
awk -F/ \\'{ print $(NF-1) "\\t" $(0) }\\'

JSON 解码后实际得到:

bash 复制代码
awk -F/ \'{ print $(NF-1) "\t" $(0) }\'

问题所在:

外层命令是 bash -c '...'(使用单引号包裹),而 bash 的单引号字符串内不支持任何转义,\' 并不会被解释为字面量单引号,而是直接终止当前单引号字符串,导致整个命令语法错误,bash 直接报错退出,HUD 进程无法启动。

验证复现:

bash 复制代码
# 模拟解码后的命令 ------ 会报语法错误
bash -c 'plugin_dir=$(... | awk -F/ \'{ print $(NF-1) "\t" $(0) }\' | ...)'
# bash: syntax error near unexpected token ')'

修复方案

用 sort -V(GNU 版本排序)替换原来的 awk 版本排序逻辑,完全避免单引号嵌套问题:

修复前(settings.json):

json 复制代码
"command": "bash -c 'plugin_dir=$(ls -d \"${CLAUDE_CONFIG_DIR:-$HOME/.claude}\"/plugins/cache/claude-hud/claude-hud/*/ 2>/dev/null | awk -F/ \\'{ print $(NF-1) \"\\t\" $(0) }\\' | sort -t. -k1,1n -k2,2n -k3,3n -k4,4n | tail -1 | cut -f2-); exec \"/c/Users/admin/.bun/bin/bun\" --env-file /dev/null \"${plugin_dir}src/index.ts\"'"

修复后(settings.json):

json 复制代码
"command": "bash -c 'plugin_dir=$(ls -1d \"${CLAUDE_CONFIG_DIR:-$HOME/.claude}/plugins/cache/claude-hud/claude-hud\"/*/ 2>/dev/null | sort -V | tail -1); exec \"/c/Users/admin/.bun/bin/bun\" --env-file /dev/null \"${plugin_dir}src/index.ts\"'"

sort -V 是 GNU coreutils 提供的版本号排序,Git for Windows 自带,行为与原 awk 版本排序等效。

修改的文件

  • ~/.claude/settings.json --- statusLine.command 字段

结论

根因是 claude-hud 安装脚本生成的 bash -c '...' 命令中,awk 的单引号在 JSON 编码时处理有误(用 \\' 表示),解码后变成 \' 放入 bash 单引号字符串中,导致语法错误,HUD 进程无法启动。与 Windows 系统本身无关,属于 shell 字符串转义 bug。

相关推荐
Maynor9968 小时前
Trymodel 使用介绍:一个平台同时用 Claude、GPT、Gemini 和 Grok
人工智能·gpt·ai·程序员·教程·claude·语音
观察员11 小时前
告别频繁锁屏:5行 PowerShell 脚本实现 Windows 自动防休眠
windows·命令行
Funlang11 小时前
在 Windows 95 上写前端
前端·javascript·windows
ZzT17 小时前
约 90% 代码由 Claude 写和审,Claude Code 团队如何做验证
ai编程·claude
一切皆有可能!!17 小时前
【SoduWork测评】本机跑源码,找到并修了7个Bug
windows·开源·bug·ai编程·soduwork
xx z17 小时前
打开游戏提示 d3dx9_43.dll 缺失怎么办(DirectX 修复步骤)
windows·游戏·工具·软件
如夏倾城19 小时前
五大远程桌面协议:RDP、SSH、VNC/RFB、Citrix ICA/HDX 与 VMware Blast Extreme
运维·windows·网络协议·安全·自动化·ssh·远程工作
一缕82年的清风20 小时前
谷歌甩出 Gemini 4 Neon:Agent 编程榜登顶第一、缓存仅 $0.15,把刚发的 GPT-6.2 架在火上烤!
gpt·claude·gemini
Vex2une2 天前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程
黎羽_2 天前
Claude 免费号 7 天养号毕业全记录:54 轮对话、IP 预检与月度维护
claude·免费账号·muse·ai 养号