Cách kiểm tra mức sử dụng token của Claude Code: 4 cách để xem các agent của bạn chi tiêu bao nhiê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 agent kéo 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 agent 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: /usage, /context và dòng trạng thái

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

/usage

Claude Code in ra mức sử dụng token của phiên hiện tại và, với gói Claude.ai, phần quota còn lại của bạn: giới hạn sử dụng trong 5 giờ và trong 7 ngày, cộng với phần cửa sổ ngữ cảnh bạn đang dùng. /cost và /stats vẫn hoạt động, chúng là bí danh của cùng một lệnh. Bạn có thể chạy lệnh này trong lúc Claude đang trả lời, các con số hiện ra mà không làm gián đoạn câu trả lời (trước phiên bản v2.1.234, lệnh này phải đợi lượt trả lời kết thúc).

Bạn muốn xem chi tiết cửa sổ ngữ cảnh thay vì một con số phần trăm duy nhất? Gõ /context: cửa sổ được vẽ thành một lưới màu, và những gì đang chiếm chỗ được đánh dấu, một công cụ có đầu ra quá nặng, một file bộ nhớ đã phình to, một phiên sắp đầy dung lượng.

Hai lệnh này có chung một điểm yếu: bạn phải gõ chúng, và chúng chỉ thấy phiên bạn đang ở. Không có gì cho bạn biết hôm qua bạn đã chi tiêu bao nhiêu hay một dự án khác tốn bao nhiêu. Nếu bạn muốn một con số luôn ở trên màn hình, hãy dùng dòng trạng thái. Hãy nhờ Claude Code viết nó cho bạn:

/statusline show model name and context percentage with a progress bar

Nó tạo một script trong ~/.claude/ và nối script đó vào phần cài đặt của bạn. Nếu bạn muốn tự viết, hãy thêm một mục statusLine vào ~/.claude/settings.json. Script nhận qua stdin một đối tượng JSON gồm context_window.used_percentage, cost.total_cost_usd và, với người đăng ký Pro và Max, rate_limits.five_hour.used_percentage. Một dòng là đủ:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Dòng trạng thái được làm mới sau mỗi phản hồi của API, nên con số phần trăm thay đổi trong lúc phiên chạy. Vẫn là một phiên cho mỗi terminal: để xem lịch sử, hay để theo dõi nhiều agent cùng lúc, hãy đọc tiếp.

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 /usage, í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 trả lời "ngay lúc này, agent nào đang tiêu token".

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 agent song song, bạn muốn xem mức sử dụng của từng agent, 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 từng agent, 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, hoặc muốn biết quota còn lại bao nhiêu? /usage, và dòng trạng thái nếu bạn muốn nó luôn hiển thị.
• 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 agent và muốn theo dõi mức sử dụng trực tiếp, theo từng agent và từng 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.