Chuyển đến nội dung

ccusage / ccusage

ccusage

Xem bạn đã tiêu bao nhiêu token và tiền khi dùng Claude Code, Codex và các công cụ AI lập trình khác

ccusage là công cụ dòng lệnh đọc dữ liệu sử dụng đã lưu sẵn trên máy của các trợ lý AI lập trình (Claude Code, Codex, OpenCode, Cline, Gemini CLI và nhiều công cụ khác) rồi lập báo cáo theo ngày, tuần, tháng hoặc từng phiên. Bạn biết rõ mình đã dùng bao nhiêu token (mẩu chữ AI đọc và viết) và chi phí ước tính.

  • 19.448 sao
  • 929 fork
  • Rust
  • Cập nhật hôm nay
  • Giấy phép riêng, xem trên GitHub
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI)
Chạy trên
Node.js, Windows, macOS, Linux
Chi phí
Miễn phí hoàn toàn

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)

  1. 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.

    Terminal
    npx ccusage@latest
  2. Nế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

  1. 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.

    Terminal
    bunx ccusage
  2. Nếu dùng pnpm, chạy bằng lệnh dưới.

    Terminal
    pnpm dlx ccusage

Dùng thử lần đầu

  1. 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.

    Terminal
    npx ccusage@latest
  2. Xem theo tháng để có bức tranh tổng thể.

    Terminal
    npx ccusage@latest monthly
  3. Xem theo từng phiên làm việc để tìm ra phiên tốn nhiều nhất.

    Terminal
    npx ccusage@latest session
  4. Nếu chỉ dùng Claude Code, xem riêng phần của nó.

    Terminal
    npx ccusage@latest claude daily
  5. Xem các khoảng 5 giờ tính hạn mức của Claude Code.

    Terminal
    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.

Terminal
git clone https://github.com/ccusage/ccusage.git

Repo tương tự nên xem

AI hỗ trợ lập trình156K

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

VừaWindowsmacOSLinux
AI hỗ trợ lập trình135K

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

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình71,7K

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

VừaWindowsmacOSLinuxNode.js

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình318K

Superpowers

obra / superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

VừaWindowsmacOSLinux
AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình227K

OpenCode

anomalyco / opencode

Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo