NateCueccusage & codeburn: Theo dõi lịch sử và chi phí dùng Claude Code
Dùng Claude Code mỗi ngày nhưng không biết mình đang tiêu bao nhiêu token? Không rõ hôm nay làm được những session nào, hay model nào đang “ngốn” nhiều nhất? ccusage và codeburn là hai tool nhỏ giải quyết đúng cái đau đó - chạy local, không cần API key, setup trong vài phút.
Khi mới bắt đầu dùng Claude Code, ít ai để ý đến chuyện theo dõi usage. Nhưng sau vài tuần làm việc thực sự - debug dài hơi, viết code với context lớn, chạy nhiều agent song song - bạn sẽ nhận ra: hiểu rõ mình đang dùng AI như thế nào là bước đầu tiên để dùng nó tốt hơn.
Cả hai tool đều đọc thẳng từ file log local mà Claude Code tự ghi trong quá trình chạy, lưu tại ~/.claude/projects/. Không gửi data đi đâu, không cần kết nối thêm bất kỳ dịch vụ nào.
Tại sao cần theo dõi usage Claude Code?
Claude Code với subscription Max hoặc Pro không charge theo từng token - nhưng có giới hạn theo billing window 5 tiếng. Nếu bạn hit limit vào đúng lúc đang làm dở một task quan trọng, trải nghiệm khá tệ.
Theo dõi usage giúp bạn:
- Biết mình còn “room” không - trước khi bắt đầu một task nặng, kiểm tra block 5 tiếng hiện tại còn bao nhiêu
- Nhận ra pattern tốn kém - session nào, task nào, hay model nào đang tiêu token nhiều nhất
- Tối ưu workflow - nếu biết 80% cost đến từ một loại task cụ thể, bạn có thể điều chỉnh cách làm việc
- Tính chi phí thực tế - đặc biệt quan trọng nếu bạn dùng gói pay-as-you-go hoặc đang cân nhắc nâng cấp plan
ccusage - CLI đơn giản, dữ liệu rõ ràng
GitHub: ryoppippi/ccusage
ccusage là CLI tool được build bởi ryoppippi - cộng đồng mã nguồn mở. Điểm hay nhất: không cần cài đặt, chạy thẳng với npx.
Chạy ngay, không cần cài
npx ccusage@latestLuôn dùng @latest để đảm bảo có version mới nhất với pricing data được cập nhật theo LiteLLM.
Các lệnh chính
| Lệnh | Mô tả |
|---|---|
npx ccusage@latest | Báo cáo theo ngày (mặc định) |
npx ccusage@latest daily | Token và chi phí từng ngày |
npx ccusage@latest monthly | Tổng hợp theo tháng |
npx ccusage@latest session | Chi tiết theo từng conversation session |
npx ccusage@latest blocks | Phân tích theo billing window 5 tiếng |
Lệnh blocks đặc biệt hữu ích - nó ánh xạ chính xác theo cách Claude Code tính usage, cho bạn thấy đang tiêu bao nhiêu trong từng window 5 tiếng.
Lọc và tùy chỉnh
# Xem usage từ ngày cụ thể
npx ccusage@latest daily --since 2026-04-01
# Xem trong khoảng thời gian
npx ccusage@latest daily --since 2026-04-01 --until 2026-04-15
# Breakdown theo từng model
npx ccusage@latest daily --breakdown
# Xuất ra JSON để xử lý thêm
npx ccusage@latest monthly --json
# Lọc theo project cụ thể
npx ccusage@latest daily --project ten-project
# Chạy offline (dùng pricing cache, không cần internet)
npx ccusage@latest --offlineĐọc output như thế nào
Khi chạy npx ccusage@latest daily, bạn thấy bảng với các cột:
- Date: Ngày
- Input tokens: Token bạn gửi vào (prompt + context)
- Output tokens: Token Claude trả về
- Cache read / Cache write: Token được cache - đây là phần “tiết kiệm được”
- Cost ($): Chi phí quy đổi theo giá LiteLLM
Mẹo nhỏ: Cột Cache read lớn là dấu hiệu tốt - nghĩa là bạn đang tận dụng được prompt caching, giảm đáng kể chi phí thực tế.
Tích hợp MCP (nâng cao)
ccusage có MCP server built-in, cho phép bạn hỏi Claude về usage của chính mình ngay trong conversation:
npx ccusage@latest mcpSau đó cấu hình trong Claude Code để dùng như một tool. Kiểu “Claude ơi, tuần này mình dùng bao nhiêu?” - và Claude sẽ trả lời bằng dữ liệu thực từ log của bạn.
codeburn - Dashboard TUI trực quan hơn
GitHub: AgentSeal/codeburn
Nếu ccusage là bảng số liệu thì codeburn là dashboard có giao diện - chạy ngay trong terminal với charts, panels, và keyboard navigation.
Cài đặt
npm install -g codeburnYêu cầu Node.js 20+. Cài một lần, dùng mãi.
Chạy
codeburnMở terminal, gõ lệnh, dashboard tự render. Không config gì thêm.
Những gì codeburn hiển thị
Gradient charts theo thời gian Biểu đồ token/cost theo ngày, tuần - dễ hình dung trend hơn rất nhiều so với nhìn số thuần.
Task classification (13 loại) codeburn tự phân loại task dựa trên pattern tool usage và keyword trong message của bạn - không gọi LLM, hoàn toàn deterministic. Bạn biết được mình dùng Claude Code nhiều nhất để làm gì: code generation, debugging, editing, testing, documentation, v.v.
Đây là insight khá thú vị. Nhiều người tưởng mình dùng AI để code, nhưng nhìn vào dashboard mới biết 60% thời gian thực ra là đang debug và explain code cho AI hiểu.
One-shot success rate Tỉ lệ Claude làm đúng ngay lần đầu so với số lần phải edit/retry. Nhìn vào metric này để biết task nào AI “nails it” và task nào cần cải thiện cách viết prompt hoặc cung cấp context tốt hơn.
Multi-provider support Hỗ trợ cả Claude Code lẫn Codex (OpenAI) nếu bạn dùng song song.
macOS Menu Bar (bonus)
codeburn đi kèm SwiftBar plugin - hiển thị cost hôm nay ngay trên menu bar macOS với icon ngọn lửa 🔥. Cài SwiftBar xong, copy plugin vào là dùng được. Nhìn lên góc trên màn hình là thấy ngay hôm nay tiêu bao nhiêu.
So sánh nhanh: Dùng cái nào?
| Tiêu chí | ccusage | codeburn |
|---|---|---|
| Giao diện | Terminal text table | TUI dashboard có chart |
| Cài đặt | Không cần (npx) | Install global |
| Lọc dữ liệu | Nhiều filter linh hoạt | Keyboard navigation |
| Export JSON | Có (--json) | Không có sẵn |
| Task classification | Không | Có (13 loại) |
| Menu bar macOS | Không | Có (SwiftBar) |
| MCP integration | Có | Không |
| Node.js yêu cầu | Bất kỳ | 20+ |
Gợi ý thực tế: Dùng cả hai. ccusage để tra nhanh số liệu cụ thể (“tuần này mình tiêu bao nhiêu?”, “block 5 tiếng này còn room không?”). codeburn để xem tổng quan visual và phân tích pattern làm việc theo tuần.
Workflow thực tế gợi ý
Buổi sáng trước khi làm:
npx ccusage@latest blocksKiểm tra block 5 tiếng hiện tại - còn bao nhiêu room để lên kế hoạch cho buổi sáng.
Cuối tuần review:
npx ccusage@latest monthly --breakdownXem tổng chi phí tháng, phân tích theo model xem mình đang dùng claude-opus hay sonnet nhiều hơn.
Khi muốn phân tích sâu:
codeburnMở dashboard, xem task classification, nhận ra workflow nào đang “đốt” token nhiều nhất và điều chỉnh cho tháng tới.
Câu hỏi thường gặp (FAQ)
Hai tool này có an toàn không? Dữ liệu có bị gửi đi đâu không?
Cả hai đều đọc thẳng từ file JSONL local tại ~/.claude/projects/ trên máy của bạn. Không có API call ra ngoài, không cần đăng nhập, không gửi dữ liệu đến bất kỳ server nào. Hoàn toàn local-first và open-source - bạn có thể đọc source code để xác minh.
Claude Code lưu log ở đâu? Có thể xem thẳng không?
Claude Code tự ghi log vào ~/.claude/projects/ - mỗi conversation session là một file .jsonl. Bạn có thể mở thẳng bằng text editor để xem raw data, nhưng format khá phức tạp. ccusage và codeburn parse và tổng hợp những file này thành dạng dễ đọc.
Tôi dùng Claude Code với subscription Pro/Max, có cần quan tâm đến cost không?
Với subscription, bạn không bị charge theo token - nhưng vẫn nên theo dõi usage để hiểu billing window 5 tiếng hoạt động như thế nào. Nếu hit limit vào đúng lúc đang làm dở task quan trọng, bạn phải đợi. Dùng lệnh blocks để kiểm tra trước khi bắt đầu task nặng.
ccusage báo lỗi "no data found" - tại sao?
Claude Code cần đã được dùng ít nhất một lần để tạo file log. Nếu bạn vừa cài Claude Code và chưa chạy session nào, sẽ không có dữ liệu. Thử chạy lại sau khi đã có ít nhất một conversation session.
Tổng kết
ccusage và codeburn là hai tool nhỏ nhưng thực sự có ích cho ai dùng Claude Code thường xuyên. Cả hai đều open-source, local-first, và setup trong vài phút.
- Dùng ccusage khi cần số liệu nhanh, lọc theo ngày/tháng/project, hoặc muốn tích hợp MCP
- Dùng codeburn khi muốn cái nhìn visual tổng thể và phân tích pattern làm việc
Biết mình đang dùng AI như thế nào là bước đầu tiên để dùng nó tốt hơn. Không cần xem mỗi ngày - nhưng review định kỳ mỗi tuần sẽ giúp bạn nhận ra những điểm có thể tối ưu và làm việc hiệu quả hơn với Claude Code.