Claude Usage Barometer
Một thước đo gọn gàng kiểu pin trên thanh menu cho mức sử dụng Claude của bạn. Theo dõi hai cửa sổ 5-hour và 7-day vơi dần theo thời gian thực — ngay trên thanh menu macOS.
Giới hạn Claude của bạn, luôn trong tầm mắt
Claude Usage Barometer là một plugin miễn phí, mã nguồn mở cho SwiftBar (hoặc xbar) nằm ngay trên thanh menu macOS. Nó hiển thị hai thanh kiểu pin — một cho cửa sổ trượt 5-hour của Claude và một cho cửa sổ 7-day — để bạn thấy chính xác còn lại bao nhiêu hạn mức chỉ trong một cái liếc mắt. Công cụ thuần Bash, không cần bước biên dịch, đọc token Claude Code của bạn cục bộ từ macOS Keychain và không bao giờ gửi dữ liệu của bạn đi đâu cả.
Giới hạn sử dụng vô hình cho đến khi bạn chạm phải
Claude áp dụng các cửa sổ sử dụng trượt, nhưng không có gì trên màn hình cho bạn biết mình đang gần ngưỡng đến đâu — cho tới khi công việc dừng lại giữa chừng.
Không có chỉ báo gốc
Không có thước đo tích hợp sẵn cho cửa sổ 5-hour và 7-day, nên giới hạn có thể ập đến mà không hề báo trước, ngay giữa một phiên làm việc.
Chi phí chuyển ngữ cảnh
Kiểm tra mức sử dụng nghĩa là phải rời khỏi công việc và lục lọi qua một bảng điều khiển — phiền toái mà bạn phải trả giá mỗi lần tự hỏi còn lại bao nhiêu.
Gián đoạn bất ngờ
Chạm giới hạn một cách bất ngờ làm đứt mạch và đình trệ bất cứ thứ gì bạn đang triển khai. Một thước đo liếc-là-thấy giúp loại bỏ bất ngờ đó.
Một viên pin cho hạn mức Claude của bạn
Hai thanh trên thanh menu, một menu xổ chi tiết, và màu sắc kể trọn câu chuyện mà không cần một cú nhấp nào.
Phần được lấp đầy cho biết còn lại bao nhiêu, phần trống cho biết đã dùng bao nhiêu. Mỗi thanh vơi dần khi bạn tiêu thụ hạn mức 5-hour và 7-day.
Xanh lá khi dùng đến 69%, hổ phách từ 70%, đỏ từ 90% — thanh trên thanh menu bám theo cửa sổ nào đang căng hơn.
Nhấp vào để xem phần trăm còn lại của từng cửa sổ và bộ đếm ngược chính xác đến lúc đặt lại, cùng thời điểm cập nhật gần nhất.
Nó đọc token OAuth của Claude Code từ Keychain trên chiếc Mac này. Không tài khoản, không máy chủ, không có gì rời khỏi máy của bạn.
Thước đo nhỏ, chi tiết tinh tế
Mọi thứ bạn cần ở một công cụ trên thanh menu, và không thừa một thứ gì.
Thước đo 5-hour & 7-day
Cả hai cửa sổ trượt chỉ trong một cái liếc, kèm phần trăm còn lại và bộ đếm ngược đặt lại trong menu xổ.
Trạng thái mã màu
Xanh lá chuyển sang hổ phách rồi sang đỏ khi bạn tiến gần giới hạn, để trạng thái hiển nhiên mà không cần mở bất cứ thứ gì.
Thân thiện với giới hạn tốc độ
Lưu lại lần đọc tốt gần nhất và điều tiết các lệnh gọi API cách nhau ít nhất 3 minutes, vượt qua các lỗi 429 thoáng qua một cách êm ái.
Biết khi có bản cập nhật
Kiểm tra GitHub mỗi ngày một lần và hiển thị liên kết "có bản cập nhật" trong menu xổ khi một phiên bản mới được phát hành.
Tần suất làm mới tùy chỉnh
Chọn khoảng làm mới 1, 3 hoặc 5 phút từ menu xổ để cân bằng giữa độ mới và số lệnh gọi API.
Không biên dịch, thuần Bash
Dễ đọc, dễ kiểm định và dễ tinh chỉnh. Riêng tư từ trong thiết kế và phát hành theo giấy phép MIT.
Một dòng lệnh trong Terminal
Trình cài đặt thêm jq và SwiftBar qua Homebrew, đặt plugin vào và khởi chạy nó. Ở lần chạy đầu, hãy chọn "Always Allow" cho lời nhắc Keychain.
curl -fsSL https://raw.githubusercontent.com/taka-avantgarde/claude-usage-barometer/main/install.sh | bashYêu cầu macOS 12+, Homebrew và Claude Code đã đăng nhập trên chiếc Mac này.
Câu hỏi thường gặp
Claude Usage Barometer có miễn phí không?
Có. Đây là mã nguồn mở theo giấy phép MIT và miễn phí sử dụng. Nó chỉ cần phiên Claude Code bạn đã có sẵn trên Mac.
Tôi cần gì để chạy nó?
macOS 12 trở lên, SwiftBar (hoặc xbar), jq và curl, cùng Claude Code đã đăng nhập trên cùng một chiếc Mac. Trình cài đặt một dòng sẽ thiết lập jq và SwiftBar giúp bạn.
Token Claude của tôi có an toàn không?
Có. Plugin đọc token OAuth của Claude Code một cách cục bộ từ macOS Keychain và chỉ dùng nó để truy xuất chính mức sử dụng của bạn. Nó thuần Bash, không gửi gì cho bên thứ ba và không có telemetry.
Các màu sắc có ý nghĩa gì?
Thanh có màu xanh lá khi dùng dưới 70%, hổ phách từ 70% đến 89%, và đỏ từ 90% đến 100%. Màu trên thanh menu bám theo cửa sổ nào trong hai cửa sổ đang gần giới hạn của nó hơn.
Nó có hỗ trợ cả xbar lẫn SwiftBar không?
Có. Nó chạy như một plugin SwiftBar hoặc xbar. SwiftBar được khuyến nghị và là thứ mà trình cài đặt một dòng thiết lập.
Đưa giới hạn Claude của bạn lên thanh menu
Cài đặt chỉ với một dòng lệnh, rồi không bao giờ bị giới hạn sử dụng làm bất ngờ nữa. Miễn phí và mã nguồn mở.