Trải nghiệm khi dùng ccusage
Bạn mở Terminal (cửa sổ gõ lệnh) và chạy một lệnh duy nhất, không cần cài đặt phức tạp. Công cụ tự tìm dữ liệu mà các trợ lý AI lập trình đã lưu trên máy bạn, rồi in ra một bảng gọn gàng: mỗi dòng là một ngày, kèm lượng token và số tiền quy đổi.
Muốn nhìn kỹ hơn, bạn đổi sang báo cáo theo tuần, theo tháng hoặc theo từng phiên làm việc để thấy dự án nào ngốn nhiều nhất. Nếu chỉ dùng một công cụ, bạn gõ tên công cụ đó trước, ví dụ chỉ xem phần của Claude Code.
Vì chỉ đọc dữ liệu có sẵn trên máy, bạn không phải nhập khoá API hay gửi gì lên mạng. Nó giúp những người dùng gói trả theo lượt hoặc có hạn mức theo giờ nắm được mình đang dùng bao nhiêu.
Tính năng nổi bật
Báo cáo theo ngày, tuần, tháng, phiên
Chọn đúng mốc thời gian để thấy xu hướng chi tiêu và biết phiên làm việc nào tốn nhiều nhất.
Hỗ trợ nhiều công cụ AI lập trình
Đọc được dữ liệu của Claude Code, Codex, OpenCode, Cline, Gemini CLI, GitHub Copilot CLI và nhiều công cụ khác trong danh sách của README.
Báo cáo gộp hoặc tách riêng
Xem tất cả công cụ trong một bảng chung, hoặc chỉ riêng từng công cụ bằng lệnh có tên công cụ.
Cửa sổ 5 giờ của Claude Code
Lệnh blocks hiển thị theo các khoảng 5 giờ tính hạn mức của Claude Code, tiện cho người dùng gói có giới hạn.
Thanh trạng thái cho Claude Code
Có lệnh statusline (bản beta) để gắn thông tin sử dụng vào thanh trạng thái của Claude Code qua hook.
Tận dụng ccusage vào việc gì?
Lập trình viên tự do, người dùng Claude Code
Kiểm tra hoá đơn AI cuối tháng
Xem tổng token và chi phí ước tính theo tháng để quyết định có nên đổi gói hay đổi cách dùng.
Lập trình viên
Tìm phiên làm việc ngốn token nhất
Xem báo cáo theo phiên để nhận ra những cuộc trò chuyện dài tốn kém và rút kinh nghiệm cách nhờ AI hiệu quả hơn.
Người dùng nhiều công cụ cùng lúc
So sánh các công cụ AI đang dùng
Gộp dữ liệu của Claude Code, Codex, Cline... vào một báo cáo để biết công cụ nào bạn thực sự dùng nhiều.
Trưởng nhóm kỹ thuật
Theo dõi chi tiêu của nhóm nhỏ
Mỗi thành viên chạy lệnh trên máy của mình và chia sẻ kết quả, để nhóm có số liệu thật khi bàn ngân sách công cụ AI.
Cần chuẩn bị gì?
- Máy có Node.js (để chạy npx) hoặc một trình chạy tương đương như Bun, pnpm; README còn nhắc cả Nix.
- Đã từng dùng ít nhất một công cụ AI lập trình được hỗ trợ trên máy, vì ccusage đọc dữ liệu mà các công cụ đó đã lưu.
- Có Internet ở lần chạy đầu để tải gói về.
Hướng dẫn cài đặt chi tiết
Cài trên npx (Node.js)
Không cần cài đặt riêng. Mở Terminal (PowerShell trên Windows) và chạy lệnh dưới, nó tự tải bản mới nhất rồi hiện báo cáo.
npx ccusage@latestNếu máy chưa có Node.js, hãy cài từ trang chính thức nodejs.org trước, rồi mở lại Terminal.
Cài trên Bun / pnpm
Nếu bạn đã dùng Bun, chạy bằng bunx; Bun lưu bộ nhớ đệm nên các lần sau khởi động nhanh hơn.
bunx ccusageNếu dùng pnpm, chạy bằng lệnh dưới.
pnpm dlx ccusage
Dùng thử lần đầu
Chạy báo cáo mặc định để xem mức dùng theo từng ngày của tất cả công cụ được tìm thấy.
npx ccusage@latestXem theo tháng để có bức tranh tổng thể.
npx ccusage@latest monthlyXem theo từng phiên làm việc để tìm ra phiên tốn nhiều nhất.
npx ccusage@latest sessionNếu chỉ dùng Claude Code, xem riêng phần của nó.
npx ccusage@latest claude dailyXem các khoảng 5 giờ tính hạn mức của Claude Code.
npx ccusage@latest blocks
Mẹo dùng hay
- Thêm tên công cụ (claude, codex, opencode, cline...) rồi daily hoặc monthly để chỉ xem một nguồn.
- Nếu dùng nhiều lần mỗi ngày, cài Bun và chạy bằng bunx sẽ nhanh hơn vì có bộ nhớ đệm.
- Đọc tài liệu đầy đủ trên trang ccusage.com để biết các tuỳ chọn khác.
Lưu ý và hạn chế
- Chi phí hiển thị là con số ước tính quy đổi từ lượng token; nếu bạn dùng gói thuê bao cố định thì đó không phải số tiền thực tế bạn bị tính.
- Công cụ chỉ thấy dữ liệu có trên chính máy bạn đang chạy; việc dùng ở máy khác hoặc trên web sẽ không có trong báo cáo.
- Danh sách công cụ được hỗ trợ và định dạng dữ liệu thay đổi theo thời gian, nên với công cụ AI quá mới có thể chưa đọc được.
Câu hỏi thường gặp
ccusage có miễn phí và có cần khoá API không?
Miễn phí và không cần khoá API, vì nó chỉ đọc dữ liệu sử dụng đã lưu sẵn trên máy bạn.
Dữ liệu của tôi có bị gửi đi đâu không?
Theo mô tả của README, công cụ phân tích dữ liệu cục bộ trên máy. Lần chạy đầu cần Internet chỉ để tải gói về.
Có dùng được nếu tôi chỉ dùng Claude Code không?
Có. Lệnh mặc định sẽ tự tìm dữ liệu Claude Code, và bạn cũng có thể gõ riêng phần Claude để chỉ xem nguồn đó.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/ccusage/ccusage.gitRepo tương tự nên xem
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
Codex CLI
openai / codex
Trợ lý AI viết code của OpenAI chạy nhẹ trong Terminal, đăng nhập bằng tài khoản ChatGPT hoặc khoá API
Cline
cline / cline
Trợ lý AI viết code mã nguồn mở trong VS Code, JetBrains, Terminal và app desktop, dùng được nhiều mô hình