Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi plugin chỉ chạy trên máy, không gọi mạng, không đọc mật khẩu hay token; khi đọc mã ở commit này mình không thấy lệnh fetch hay http nào. | README, Security |
|---|---|---|
| Ưu | Số context lấy thẳng từ dữ liệu Claude Code gửi cho thanh trạng thái, không đếm chữ để đoán. Một bài hướng dẫn độc lập ghi tác giả bài dùng hằng ngày và coi đây là thay đổi lớn nhất trong cách họ làm việc. | heyuan110 blog |
| Nhược | Dùng API key, Bedrock hay Vertex thì thanh giới hạn dùng không hiện, vì Claude Code chỉ gửi số này cho người đăng nhập gói trả phí. | README, Usage Limits |
| Nhược | Trên Windows từng có lỗi thanh trạng thái hiện JSON thô thay cho thanh đẹp (issue #129), và README vẫn ghi phải cài Node.js trước khi setup. | Issue #129 |
| Nhược | Plugin đọc khối tài khoản trong ~/.claude.json. Nếu bạn bật display.showAuthUser (mặc định tắt), phần trước dấu @ của email hiện trên thanh trạng thái và lọt vào ảnh chụp màn hình. | src/auth.ts |
| Chưa rõ | Launcher do setup cài luôn chạy bản claude-hud mới nhất đang có trên máy, và plugin marketplace lấy bản mới nhất của repo. README không có cách ghim vào bản 0.13.1. | commands/setup.md |
Khi nên dùng
- Bạn dùng Claude Code bằng gói Pro hoặc Max và muốn luôn thấy context còn bao nhiêu và giới hạn 5 giờ đã dùng tới đâu.
Khi không nên dùng
- Bạn dùng agent khác ngoài Claude Code (plugin chỉ chạy trên Claude Code), hoặc chỉ cần tổng token theo ngày: ccusage làm việc đó.
Cách cài
Claude Code
/plugin marketplace add jarrodwatts/claude-hud → /plugin install claude-hud → /reload-plugins → /claude-hud:setupNó chạm vào những gì
- File đọc và ghi
- Đọc dữ liệu Claude Code gửi qua stdin, file transcript của phiên, khối oauthAccount trong ~/.claude.json (loại gói và phần trước @ của email, chỉ hiện khi bật display.showAuth và display.showAuthUser, mặc định tắt) và thông tin git hoặc jj của thư mục hiện tại. /claude-hud:setup ghi statusLine vào ~/.claude/settings.json (sao lưu trước) và chép launcher statusline.mjs vào ~/.claude/plugins/claude-hud; plugin ghi config, sổ chi phí theo ngày và tốc độ output ở cùng thư mục đó.
- Gọi mạng
- Không thấy lệnh gọi mạng nào trong src ở commit đã đọc. Từ bản 0.0.12 plugin bỏ việc hỏi API usage bằng OAuth và chỉ dùng số rate_limits Claude Code gửi qua stdin.
- Script lúc cài
- Không có postinstall. Mã chạy là dist/ đã build sẵn trong repo (JavaScript không nén).
- Tiến trình
- Mỗi lần thanh trạng thái vẽ lại, plugin chạy git (hoặc jj). Tùy chọn --extra-cmd chạy một lệnh shell bất kỳ, chỉ khi bạn đặt CLAUDE_HUD_ALLOW_EXTRA_CMD=1.
Đọc từ: auth.ts#L68-L105, git-runner.ts#L36, setup.md, statusline.mjs, README.md#security, CHANGELOG.md
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin
