Ưu, nhược và chỗ chưa rõ
| Ưu | Mã chỉ gọi mạng để tải bảng giá model; log dùng token của bạn được đọc và cộng trên máy. | pricing.rs |
|---|---|---|
| Ưu | README ghi một lệnh đọc được 18 nguồn, từ Claude Code, Codex đến Gemini CLI, và gộp chúng vào một bảng theo ngày, tuần, tháng hoặc phiên. | README, Supported Sources |
| Ưu | Shipyard dùng ccusage để xem token chia theo từng repo, phần mà lệnh /usage của Claude Code không có vì /usage chỉ hiện phiên hiện tại. | Shipyard blog |
| Nhược | Issue #483: chế độ live blocks ước lượng giới hạn của gói từ các block 5 giờ trước đó, nên báo còn dư trong khi Claude Code đã chặn. Maintainer thừa nhận cách này không chạy tốt và đóng issue. | Issue #483 |
| Nhược | Issue #459: ở bản 15.9.1, gắn ccusage statusline vào Claude Code làm sinh tiến trình liên tục, CPU lên gần 100%. Bản 15.9.8 đã thêm giới hạn để sửa. | Issue #459 |
| Chưa rõ | Số đô là ước tính theo bảng giá API công khai. Một người dùng gói Max 100 đô trên Hacker News kể ccusage báo 600 đến 800 đô mỗi tháng, tức là con số đó là giá nếu trả theo API; số tiền thật bạn trả là phí gói. | Hacker News, bình luận |
| Chưa rõ | Gói npm chạy binary Rust dựng sẵn từ CI. Mình đọc mã Rust trong repo nhưng không so binary trên npm với mã đó. | apps/ccusage/package.json |
Khi nên dùng
- Bạn muốn biết mỗi ngày, mỗi repo đã dùng bao nhiêu token với Claude Code hay Codex, và giá API tương đương là bao nhiêu.
Khi không nên dùng
- Bạn cần biết chính xác còn bao nhiêu trước khi gói bị chặn: dùng lệnh /usage của Claude Code, vì live blocks của ccusage đã bị bỏ do đoán sai.
Cách cài
Claude Code
npx [email protected] claude dailyCodex
npx [email protected] codex dailyNó chạm vào những gì
- File đọc và ghi
- Đọc file JSONL của Claude Code trong ~/.claude/projects (hoặc thư mục trong CLAUDE_CONFIG_DIR) và thư mục dữ liệu của các agent khác. Chỉ ghi cache bảng giá vào ~/.cache/ccusage/http-cache.
- Gọi mạng
- Chỉ có lệnh GET tải bảng giá model từ raw.githubusercontent.com (LiteLLM) và models.dev. Cờ --offline dùng bảng giá đã cache. Mình không thấy đoạn mã nào gửi dữ liệu dùng của bạn đi.
- Script lúc cài
- Không có postinstall. Gói npm kéo một binary Rust dựng sẵn theo hệ điều hành qua optionalDependencies, rồi src/cli.js chạy binary đó.
- Tiến trình
- Chạy một lần rồi thoát. Lệnh statusline chạy mỗi lần Claude Code vẽ lại thanh trạng thái nếu bạn gắn nó vào.
Đọc từ: pricing.rs#L95-L97, http.rs#L42-L57, paths.rs#L26, package.json, cli.js
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
