Claude Code の使用量(残り)を確認する方法:/usage、ステータスライン、claude.ai
/usage、5 時間と週ごとの制限を表示するステータスライン、または claude.ai の Settings > Usage で Claude Code の使用量を確認する方法と、それぞれの数字の意味。
- CLI
- 0.2.17
- プレビュー ref
- a2c45c8
要点
Claude Code の中で /usage を実行します。Pro、Max、Team、Enterprise のプランなら、5 時間のセッション制限と週ごとの制限のバーがリセット時刻つきで表示され、何に使ったかの内訳も出ます。API 課金なら、セッションのトークン数と推定コストが表示されます。
同じプランの制限は、他に 2 か所でも確認できます。
- claude.ai → Settings → Usage。チャットの使用量も含みます。
- カスタムステータスライン。すべてのセッションの下部に
5h: 42% 7d: 18%のように表示できます。
課題
Claude Code は、作業中にデフォルトで残りの割り当てを表示しません。最初の兆候は 85% の警告か、制限のメッセージそのものであることが多く、その時点で長いタスクは半分ほど進んでいます。
似たような数字もいくつかあります。ドル建てのセッションコスト、スピナーの横のトークン数、5 時間枠に対する割合、週に対する割合。それぞれ測っているものが違い、サブスクリプションで意味があるのはその一部だけです。
方法 1:/usage で Claude Code の使用量を確認する
/usage表示内容はサインイン方法によって変わります。Anthropic の コストのページ より:
サブスクリプション(Pro、Max、Team、Enterprise)の場合:
- セッション枠と週の枠の プラン使用量バー と、それぞれのリセット時刻。
- スキル、サブエージェント、プラグイン、個々の MCP サーバーに割り当てた 最近の使用量の内訳(割合)。
- 最近の使用量の 10% 以上を占めるものについての 推奨事項(1 行に 1 件)。
25% Trim ~/code/api/CLAUDE.md · 49k tokens per requestのような行は、その行が使用量のどれだけに関係するかを示すもので、変更でどれだけ節約できるかではありません。 - 最近実行された中で重い
/loopや予約タスクを示す ループ。 - 使用量クレジットが有効なら 使用量クレジットの行。
d または w を押すと、内訳を直近 24 時間と直近 7 日間で切り替えられます。内訳はこのマシンのセッション履歴から計算されるので、他のコンピューターや claude.ai での使用量は含まれません。プランのバーは Anthropic から取得するので、すべてを含みます。
フッターに f to fix 2 of 3 のようなヒントが表示されたら、f を押すと Claude Code が対応できる推奨事項を実行します。Claude Code v2.1.305 以降が必要です。
API 課金の場合:
Session のブロックに、合計コスト、API 時間と実時間、コードの変更、モデルごとのトークン数が表示されます。ドルの数字は Claude Code が定価でローカルに計算したものです。実際の請求は Claude Console の Usage ページで確認してください。これらの合計は、/clear で新しいセッションを始めるとリセットされます。
/usage がレート制限と表示するとき
rate limited until 3:14am のようなメッセージは、その時刻まで Claude Code がプランの制限を再取得できないという意味です。使用量の制限ではありません。取得に失敗すると、/usage はこのマシンで過去 1 時間以内に読み込んだ最後のバーを Showing last-known usage という注記つきで表示します。表示された時刻を過ぎたら r を押して最新のデータを取得します。
方法 2:ステータスラインに Claude Code の制限を表示する
常に見える数字がほしいなら、カスタムステータスライン に rate_limits のフィールドを追加します。Claude Code はスクリプトに JSON を stdin で渡します。Pro と Max の加入者には、最初の API レスポンスのあとに次が含まれます。
rate_limits.five_hour.used_percentageとrate_limits.five_hour.resets_atrate_limits.seven_day.used_percentageとrate_limits.seven_day.resets_at
used_percentage は 0 から 100 です。resets_at は Unix エポック秒です。
Anthropic の例をもとにした最小限のスクリプト:
#!/bin/bash
input=$(cat)
MODEL=$(echo "$input" | jq -r '.model.display_name')
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"
echo "[$MODEL] $LIMITS"~/.claude/statusline.sh として保存し、chmod +x で実行可能にして、~/.claude/settings.json の statusLine でこれを指定します:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}jq の呼び出しにある // empty は、API 課金のときや最初のレスポンスの前など、フィールドがないときにスクリプトが何も出力しないようにするためのものです。
方法 3:claude.ai で使用量を確認する
claude.ai で Settings → Usage を開きます。チャットを含むアカウント全体の、現在のセッションと週ごとの制限が表示されます。スマホから確認したいときや、チャットのセッションでどれだけ使ったか見たいときに便利です。
方法 4:Console で API の支出を確認する
従量課金なら、Claude Console の Usage ページが正式な記録です。Console アカウントで初めて Claude Code を認証すると「Claude Code」というワークスペースが作成され、その支出は他の API の利用と分けて管理されます。
数字の意味
| 数字 | 場所 | 測っているもの |
|---|---|---|
| セッションのバー | /usage、ステータスライン、claude.ai | 5 時間枠のうち使った割合 |
| 週のバー | /usage、ステータスライン、claude.ai | 週ごとの制限のうち使った割合 |
Total cost | /usage の Session ブロック | このセッションの、定価での API の推定コスト |
| スピナーの横のトークン数 | ターンの実行中 | 現在のターンが生成した出力 |
| 内訳の割合 | /usage の内訳 | このマシンでの最近の使用量に占める割合 |
スピナーの数字(たとえば (10m 27s · ↓ 5.5k tokens))は出力だけを数えます。プロンプトや会話の履歴では増えないので、そのターンが枠をどれだけ使ったかはほとんどわかりません。
複数のエージェントやコンピューターの使用量を確認する
/usage が対象にするのは、1 台のマシンから見たひとつの Claude アカウントです。Codex や Gemini も使っている場合や、Claude のアカウントが複数ある場合は、それぞれ確認する場所が違います。
各アカウントの残りをスマホからまとめて見たいなら、Happier は Claude Code、Codex などのエージェントを、スマホ、デスクトップ、Web からクロスデバイスで実行・オーケストレーションできるオープンソースのアプリです。
メーターの仕組み:
- メーターがあるのは 3 つのサービスです: Claude のサブスクリプション、Codex のサブスクリプション(
openai-codex)、Gemini。API キーのサービスや、Happier で動かす他のエージェントにはクォータメーターはありません。 - ゲージは残りを示します。
30% left · resets in 2h 10mは、その枠の 30% がまだ使えるという意味です。 - 古いデータには表示がつきます。 各アカウントには最終更新時刻が表示され、古いデータは stale と示され、クォータを今すぐ更新(Refresh quota now)があります。
- メーターは接続したアカウントと一緒にあります。 設定(Settings)→ 接続済みサービス(Connected services)にあり、セッション内ではアカウントの横に表示されます。
接続済みサービスと 連携サービスのクォータ(Connected services quotas)は、Happier 0.2.17 ではどちらも実験的な機能で、デフォルトではオフです。設定(Settings)→ 機能(Features)で両方を有効にしてください。セットアップは スマホから Happier を使う方法 にあります。Happier は GitHub にあり、こちらからダウンロード でき、Discord もあります。
トラブルシューティング
Pro プランなのに /usage にドルのコストが表示される
その Session ブロックは API ユーザー向けです。Anthropic の注記によると、セッションコストの数字は Pro と Max の請求には関係ありません。プランのバーを期待していたのにコストしか表示されないなら、ANTHROPIC_API_KEY が設定されていないか確認してください。設定されていれば、Claude Code はプランではなくキーに課金しています。
ステータスラインに制限が何も表示されない
rate_limits オブジェクトは、claude.ai の Pro と Max の加入者にだけ、最初の API レスポンスのあとに表示されます。メッセージを送ってから、もう一度確認してください。
内訳が claude.ai と一致しない
内訳はこのマシンのセッション履歴を使います。プランのバーと claude.ai には、すべてのデバイスとチャットが含まれます。
よくある質問
Claude Code の使用量があとどれだけ残っているか確認するには?
/usage を実行して、セッションと週のバーを見ます。使った割合とリセット時刻が表示されます。
/status で使用量は表示されますか?
Anthropic のヘルプ記事では、残りの割り当ての確認に /status が挙げられています。現在のバージョンでは、ドキュメントでプランのバーと内訳を表示するコマンドとして説明されているのは /usage です。
プロジェクトごとの Claude Code の使用量を見られますか?
直接は見られません。内訳は、スキル、サブエージェント、プラグイン、MCP サーバーに使用量を割り当てます。チームでユーザーごとの数字を見るには、Anthropic は分析機能と OpenTelemetry のエクスポートを案内しています。
長いセッションで使用量が多くなるのはなぜですか?
Claude Code はリクエストのたびに会話全体を送ります。一日がかりのセッションの終盤では、1 行の質問でも履歴の分を消費します。関係のないタスクの間に /clear を実行すれば、履歴を短く保てます。