Cách kiểm tra mức sử dụng token của Claude Code: 4 cách để xem các đại lý của bạn chi tiêu

Nếu bạn chạy Claude Code hơn vài phút mỗi ngày, token là loại tiền tệ thực sự của bạn. Chúng quyết định khi nào bạn chạm vào giới hạn tốc độ, bạn tiêu tốn nhanh như thế nào qua một gói đăng ký, và liệu một phiên chạy đại lý dài có xứng đáng hay không. Vấn đề là Claude Code không thông báo cho bạn số lượng đó. Bạn phải tự đi tìm.

Dưới đây là bốn cách để kiểm tra mức sử dụng token Claude Code, từ lệnh tích hợp nhanh nhất đến một đồng hồ trực tiếp hiển thị mọi đại lý theo thời gian thực. Chọn cách phù hợp với mức độ bạn cần đi sâu.

1. Cách nhanh nhất: lệnh /cost

Trong bất kỳ phiên Claude Code nào, gõ:

/cost

Claude Code in ra tổng chi phí và số lượng token cho phiên hiện tại, cộng với thời gian nó đã chạy. Đây là câu trả lời nhanh nhất cho "phiên này đã chi tiêu bao nhiêu cho đến nay", và nó không cần cài đặt gì cả.

Điểm cần lưu ý: /cost chỉ áp dụng cho phiên bạn đang ở. Nó không cho bạn biết bạn đã chi tiêu bao nhiêu hôm qua, một dự án khác tốn bao nhiêu, hoặc một đại lý cụ thể so với đại lý khác như thế nào. Đối với một kiểm tra nhanh đơn lẻ, nó hoàn hảo. Đối với bất kỳ điều gì lịch sử, hãy tiếp tục đọc.

2. Đọc nguồn: biên bản phiên

Claude Code ghi lại mọi phiên vào đĩa dưới dạng biên bản JSONL. Trên macOS và Linux, bạn sẽ tìm thấy chúng ở đây:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Mỗi dòng là một tin nhắn, và các tin nhắn của trợ lý mang theo một đối tượng usage với các số lượng chính xác: input_tokens, output_tokens, và các trường cache (cache_creation_input_tokens, cache_read_input_tokens). Đọc cache là phần thú vị: chúng rẻ hơn nhiều so với đầu vào mới, vì vậy một phiên có tỷ lệ trúng cache cao tốn ít hơn nhiều so với số lượng token thô gợi ý.

Đây là sự thật cơ bản. Mọi công cụ khác, bao gồm hai công cụ bên dưới, đều đọc những tệp này. Nếu bạn muốn lập trình báo cáo của riêng mình, jq trên JSONL sẽ giúp bạn đến đó.

3. Một CLI chuyên dụng: ccusage

Nếu bạn không muốn viết trình phân tích của riêng mình, công cụ cộng đồng ccusage đọc các biên bản đó và tổng hợp chúng thành tổng số hàng ngày, hàng tháng và theo phiên:

npx ccusage@latest

Đây là một lựa chọn tốt: nhiều lịch sử hơn /cost, ít công việc hơn so với việc tự tay viết jq. Tuy nhiên, nó vẫn ở trong terminal, vì vậy nó trả lời "tôi đã chi tiêu gì" nhưng không phải "đại lý nào, ngay bây giờ, đang chi tiêu".

4. Một đồng hồ trực tiếp: mức sử dụng theo phiên trong AgentsRoom

Ba phương pháp trên đều có một điểm mù: chúng là sau sự kiện và một dòng đơn. Ngay khi bạn chạy nhiều đại lý song song, bạn muốn xem mức sử dụng theo đại lý, trực tiếp, mà không cần gõ lệnh trong mỗi terminal.

Đó là những gì đồng hồ mức sử dụng token Claude Code trong AgentsRoom làm. Nó đọc các biên bản JSONL giống nhau, theo phiên, và hiển thị:

• token đầu vào, đầu ra và cache theo đại lý, cập nhật khi phiên chạy
• tỷ lệ trúng cache, để bạn có thể thấy khi nào ngữ cảnh đang được tái sử dụng thay vì gửi lại
• một cảnh báo trước khi một phiên trôi về phía giới hạn tốc độ

Bởi vì nó phân bổ mức sử dụng theo phiên, nó vẫn chính xác ngay cả khi bạn chạy nhiều tài khoản Claude Code cạnh nhau: mỗi tài khoản giữ tổng số của riêng mình, điều này làm cho việc lập hóa đơn lại theo từng khách hàng trở nên đơn giản.

Bạn nên sử dụng cái nào

• Chỉ cần số liệu của phiên này? /cost.
• Muốn lập trình một báo cáo tùy chỉnh? Đọc các biên bản JSONL trực tiếp.
• Muốn tổng số hàng ngày và hàng tháng trong terminal? ccusage.
• Chạy nhiều đại lý và muốn theo dõi mức sử dụng trực tiếp, theo đại lý và theo tài khoản? Sử dụng đồng hồ trong AgentsRoom.

Kiểm tra mức sử dụng là bước đầu tiên. Nếu các con số làm bạn khó chịu, bước tiếp theo là giảm chúng: xem cách giảm chi phí token Claude Code để biết các yếu tố thực sự quan trọng, bắt đầu với việc tái sử dụng cache.