Claudetop: Giám sát chi phí Claude Code thời gian thực, tạm biệt hóa đơn bất ngờ

Vấn đề nan giải: Chi phí "vô hình" của Claude Code

Nếu bạn đang sử dụng Claude Code và thường xuyên giật mình khi xem hóa đơn cuối tháng, bạn không hề đơn độc. Một trong những thách thức lớn nhất khi làm việc với các mô hình AI mạnh mẽ là sự thiếu minh bạch về chi phí trong thời gian thực. Bạn có thể kết thúc một phiên làm việc kéo dài 30 phút và sau đó phát hiện ra một khoản phí 65 USD mà không rõ nguyên nhân, không biết phiên nào đã gây ra chi phí đột biến, hay mô hình nào đã hoạt động kém hiệu quả.

Chính từ trải nghiệm cá nhân, khi ước tính chi phí chỉ là 10 USD nhưng hóa đơn thực tế lên tới 65 USD, nhà phát triển Lioran đã tạo ra claudetop. Nguyên nhân của sự chênh lệch này là do cơ chế nén (compaction) đã che giấu tới 80% lượng token sử dụng. Chi phí là thật, nhưng sự minh bạch thì không.

Claudetop: Lời giải cho bài toán chi phí

claudetop là một công cụ dòng lệnh, được ví như "htop cho Claude Code", giúp bạn thấy chính xác từng token và từng đồng đô la của mình đang được chi tiêu ở đâu – ngay tại thời điểm nó diễn ra.

Chỉ với một dòng trạng thái đơn giản, bạn sẽ có cái nhìn toàn cảnh:

14:32 my-project/src/app Opus 20m 0s +256/-43 #auth-refactor
152.3K in / 45.2K out ████░░░░░░ 38% $3.47 $5.10/hr ~$174/mo
cache: 66% efficiency: $0.012/line opus:~$3.20 sonnet:~$0.88 haiku:~$0.23
in:80% out:20% (fresh:15% cwrite:7% cread:76%)
$5 MARK | main* | ♫ Artist - Song | PROJ-123 | CI ✓

Các tính năng chính

Với mỗi phản hồi từ AI, claudetop cung cấp cho bạn thông tin chi tiết:

• Thông tin dự án: Bạn đang ở dự án nào và sâu đến đâu.
• Mô hình đang chạy: Tên mô hình, thời gian hoạt động.
• Chi phí tức thời: Chi phí hiện tại, chi phí mỗi giờ, và dự báo chi phí hàng tháng.
• Hiệu quả Cache: Bộ nhớ đệm của bạn hoạt động hiệu quả ra sao (bạn có đang lãng phí token không?).
• So sánh chi phí: Chi phí sẽ là bao nhiêu nếu chuyển sang một mô hình khác (Opus, Sonnet, hoặc Haiku) với cơ chế định giá nhận biết cache (cache-aware pricing).
• Cảnh báo thông minh: Thông báo ngay khi có điều gì đó bất thường cần bạn chú ý.

Cài đặt và sử dụng

Để cài đặt, bạn chỉ cần chạy các lệnh sau trong terminal:

claude plugin marketplace add liorwn/claudetop
claude plugin install claudetop@liorwn/claudetop

Sau đó, chạy script cài đặt để cấu hình dòng trạng thái và cập nhật giá hàng ngày:

cd ~/.claude/plugins/cache/liorwn/claudetop/*/
./install.sh

Hoặc bạn có thể cài đặt trực tiếp:

curl -fsSL https://raw.githubusercontent.com/liorwn/claudetop/main/install.sh | bash

Cuối cùng, khởi động lại Claude Code để áp dụng thay đổi.

Thống kê và quản lý chi tiêu

claudetop tự động ghi lại nhật ký mỗi phiên làm việc, cho phép bạn xem lại chi phí đã tiêu:

claudetop-stats # Tóm tắt hôm nay
claudetop-stats week # Tuần này
claudetop-stats month # Tháng này
claudetop-stats all # Toàn bộ thời gian
claudetop-stats tag auth # Lọc theo thẻ (tag)

Bạn cũng có thể theo dõi chi phí cho từng tính năng, lỗi, hoặc dự án bằng cách sử dụng biến môi trường:

export CLAUDETOP_TAG=auth-refactor
# ... làm việc với tính năng xác thực ...
claudetop-stats tag auth-refactor
# Total cost: $12.40 across 3 sessions

Tùy biến linh hoạt

• Đặt ngân sách hàng ngày: export CLAUDETOP_DAILY_BUDGET=50 Công cụ sẽ hiển thị ngân sách còn lại và cảnh báo khi bạn vượt mức.

• Thay đổi giao diện: export CLAUDETOP_THEME=full (Mặc định) export CLAUDETOP_THEME=minimal (2 dòng) export CLAUDETOP_THEME=compact (1 dòng)

• Mở rộng với Plugin: Bạn có thể thêm bất kỳ script thực thi nào vào thư mục ~/.claude/claudetop.d/ để nó trở thành một phần của dòng trạng thái. Một số plugin ví dụ có sẵn bao gồm hiển thị nhánh git, trạng thái CI/CD, bài hát đang phát trên Spotify, và nhiều hơn nữa.

Luôn cập nhật giá mới nhất

Bảng giá của các mô hình được cập nhật tự động hàng ngày từ kho mã nguồn của dự án. Khi Anthropic thay đổi giá, claudetop sẽ tự động áp dụng mức giá mới vào sáng hôm sau, đảm bảo các tính toán của bạn luôn chính xác.

Yêu cầu hệ thống

• Claude Code phiên bản có hỗ trợ dòng trạng thái.
• jq: brew install jq hoặc apt install jq
• bc: Thường được cài đặt sẵn trên macOS và hầu hết các bản phân phối Linux.

Với claudetop, các nhà phát triển giờ đây đã có một công cụ mạnh mẽ để kiểm soát chi phí AI, tối ưu hóa việc sử dụng tài nguyên và tránh những bất ngờ không đáng có trên hóa đơn hàng tháng.