Biến màn hình LCD 38 đô thành HUD theo dõi Claude Code trực tiếp

Một nhà phát triển vừa công bố dự án mã nguồn mở claude-trofeo-hud, cho phép biến màn hình LCD giá rẻ Thermalright Trofeo Vision 6.86" (1280×480, USB-C, chỉ ~38 USD) thành bảng điều khiển (HUD) hiển thị trực tiếp mức sử dụng Claude trên macOS. Dự án lấy cảm hứng từ bài đăng trên Reddit r/ClaudeAI về "màn hình để bàn Claude LCD giá 38 đô".

HUD hiển thị những gì?

• Mức sử dụng phiên Pro/Max: thanh tiến trình và bộ đếm ngược thời gian reset, lấy dữ liệu trực tiếp từ endpoint usage của Anthropic.
• Token hôm nay và chi phí API ước tính (qua ccusage).
• Phiên hoạt động trực tiếp: dự án, model, tốc độ tiêu thụ token (burn rate).
• Đồng hồ và biểu đồ sparkline token theo giờ.

Toàn bộ dữ liệu được đọc từ logs cục bộ và OAuth token trong Keychain của macOS — hoàn toàn chỉ đọc (read-only), không có gì rời khỏi máy ngoài yêu cầu truy vấn usage gửi đến api.anthropic.com.

Cách hoạt động kỹ thuật

Điểm thú vị nhất: màn hình này không phải là màn hình thông thường — nó là thiết bị USB HID (VID:PID 0416:5302) nhận khung JPEG qua một giao thức đã được reverse-engineer. Dự án tận dụng các class device từ thermalright-trcc-linux với HidApiTransport (IOHIDManager) để vượt qua hạn chế của macOS đối với libusb trên thiết bị HID.

Firmware của màn hình tự tắt khi không có dữ liệu, nên HUD phát luồng liên tục ở 2 khung hình/giây mặc định.

Giao diện HUD hiển thị trên màn hình LCD

Cài đặt và sử dụng

Yêu cầu: macOS, Python 3.12+, uv, Node (cho npx ccusage), và Claude Code đã đăng nhập.

# Cài đặt dependencies
brew install hidapi
uv sync

# Xem trước giao diện giả lập
uv run python -m claude_trofeo_hud preview

# Chạy HUD trực tiếp trên màn hình LCD
uv run python -m claude_trofeo_hud run

# Tự động chạy khi đăng nhập qua launchd
uv run python -m claude_trofeo_hud install-agent

Lần chạy đầu tiên, macOS sẽ yêu cầu quyền truy cập Keychain cho "Claude Code-credentials" — chọn Always Allow để daemon hoạt động nền. Cấu hình nằm trong config.toml (fps, chất lượng JPEG, chế độ giảm sáng/ban đêm), logs lưu tại ~/Library/Logs/claude-trofeo-hud/.

Xử lý sự cố thường gặp

• "Access denied": có tiến trình khác đang mở thiết bị qua libusb — hãy chắc chắn dùng CLI của dự án, không phải trcc trực tiếp.
• Màn hình trống/boot logo: không có khung hình nào đến — kiểm tra log hud.log, rút/cắm lại USB sẽ tự động xử lý.
• Chi phí/token trống: chạy npx ccusage trong terminal trước; sau khi nâng cấp Node cần chạy lại install-agent.
• Dữ liệu giới hạn cũ: Keychain chưa được cấp quyền hoặc bạn đã đăng xuất Claude Code.

Ý nghĩa với cộng đồng Việt Nam

Dự án này mở ra hướng DIY thú vị cho lập trình viên Việt: chỉ với ~1 triệu đồng cho màn hình LCD để bàn, bạn có thể xây dựng bảng điều khiển theo dõi chi phí AI trực quan ngay trên bàn làm việc — một cách tuyệt vời để kiểm soát ngân sách khi dùng Claude Pro/Max hàng ngày. Nguồn mở hoàn toàn, code rõ ràng, là tài liệu tham khảo tốt cho ai muốn học về USB HID và reverse-engineering giao thức.