如何檢查Claude Code令牌使用情況：4種檢視您的代理支出的方式

如果您每天執行Claude Code超過幾分鐘，令牌就是您的真實貨幣。它們決定了您何時達到速率限制，您訂閱的消耗速度，以及長時間執行的代理是否值得。問題在於Claude Code並不會直接告訴您這個數字。您需要自己去檢視。

以下是檢查Claude Code令牌使用情況的四種方法，從最快的內建命令到即時顯示每個代理的使用情況的計量器。選擇適合您需要深入瞭解的方式。

1. 最快的方法：/usage、/context和狀態列

在任何Claude Code會話中，輸入：

/usage

Claude Code會列印當前會話的令牌使用量，如果您使用的是Claude.ai套餐，還會顯示配額剩餘多少：5小時和7天的使用限制，以及上下文視窗已用了多少。/cost和/stats仍然可用，它們是同一命令的別名。您可以在Claude回答時執行它，數字會直接顯示出來，不會打斷回答（在v2.1.234之前，該命令會等到本輪結束）。

想看上下文視窗的詳情，而不只是一個百分比？輸入/context：它會把視窗畫成一個彩色網格，並標出是什麼在佔用它，比如輸出很重的工具、膨脹的記憶檔案、接近容量上限的會話。

這兩個命令有一個共同的問題：您必須手動輸入，而且它們只能看到您所在的會話。它們不會告訴您昨天花了多少錢，也不會告訴您另一個專案的成本。如果您想要一個一直留在螢幕上的數字，請使用狀態列。讓Claude Code替您編寫：

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

它會在~/.claude/中生成一個腳本，並接入您的設定。如果您更願意自己寫，請在~/.claude/settings.json中新增一個statusLine條目。腳本透過stdin接收一個JSON物件，其中包含context_window.used_percentage、cost.total_cost_usd，以及面向Pro和Max訂閱者的rate_limits.five_hour.used_percentage。一行就夠了：

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

狀態列會在每次API響應後重新整理，因此百分比會隨著會話執行而變化。它仍然是每個終端一個會話：如果需要歷史資料，或者要同時檢視多個代理，請繼續閱讀。

2. 閱讀源資料：會話記錄

Claude Code將每個會話寫入磁碟，作為JSONL記錄。在macOS和Linux上，您可以在這裡找到它們：

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

每一行是一條訊息，助手訊息攜帶一個usage物件，包含確切的計數：input_tokens、output_tokens和快取欄位（cache_creation_input_tokens、cache_read_input_tokens）。快取讀取是有趣的部分：它們比新輸入便宜得多，因此具有高快取命中率的會話成本遠低於原始令牌計數所暗示的。

這是事實真相。包括下面的兩個工具在內的所有其他工具都讀取這些相同的檔案。如果您想編寫自己的報告，使用jq處理JSONL將能滿足您的需求。

3. 專用CLI：ccusage

如果您不想編寫自己的解析器，社群工具ccusage會讀取這些記錄，並將它們彙總為每日、每月和每個會話的總計：

npx ccusage@latest

這是一個不錯的折中選擇：比/usage有更多歷史記錄，但比手動編寫jq工作量小。不過，它仍然在終端中執行，因此它可以回答「我花了多少錢」，但不能回答「哪個代理現在在花錢」。

4. 即時計量器：AgentsRoom中的每會話使用情況

上述三種方法都有一個盲點：它們都是事後分析且單流的。當您同時執行多個代理時，您希望即時檢視每個代理的使用情況，而無需在每個終端中輸入命令。

這就是AgentsRoom中的Claude Code令牌使用計量器的作用。它讀取相同的JSONL記錄，按會話顯示，並提供：

• 每個代理的輸入、輸出和快取令牌，隨著會話的進行而更新
• 快取命中率，以便您可以看到何時重用上下文而不是重新傳送
• 在會話接近速率限制之前發出警告

由於它按會話歸屬使用情況，因此即使您並排執行多個Claude Code帳戶，它也能保持準確：每個帳戶保持自己的總計，這使得按客戶重新計費變得簡單。

您應該使用哪一個

• 只需要這個會話的數字，或者配額還剩多少？/usage，如果想一直看到它，再加上狀態列。
• 想要編寫自定義報告？直接讀取JSONL記錄。
• 想要在終端中檢視每日和每月總計？ccusage。
• 執行多個代理並希望即時檢視每個代理和每個帳戶的使用情況？使用AgentsRoom中的計量器。

檢查使用情況是第一步。如果這些數字讓您感到不安，下一步就是降低它們的成本：請參見如何降低Claude Code令牌成本，瞭解實際重要的槓桿，從快取重用開始。