この記事の目次
「残りトークン」とは何の残りを指しているのか
「残りトークン」という検索語は、利用上限に対する残り消費量と、今の会話にあとどれだけ内容を入れられるかという残り容量という、仕組みも確認場所も異なる2つを指して使われています。
Claude Codeを使っていて「残りトークン」が気になる場面は、大きく2種類あります。1つは、契約しているプラン（サブスクリプションまたはAPI）に対して、あとどれくらい使えるかという利用上限側の残量です。もう1つは、今進めている会話や作業がどれだけ長く続けられるか、というコンテキストウィンドウ（AIが一度に読み込んで処理できる情報量の上限）側の残量です。表記ゆれで「生成AIのトークン」や「生成aiのトークン」と検索して来る人も多いのですが、Claude Codeにおいてはこの2つを区別しないまま対処法を探すと、的外れな行動につながります。
本記事では主に前者、つまり利用上限側の残量の読み方と行動判断を扱います。トークンやコンテキストウィンドウの用語自体をもう少し丁寧に押さえたい場合はトークンとコンテキストウィンドウの基礎を、コンテキストウィンドウ側の自動圧縮の仕組みを詳しく知りたい場合はコンテキストウィンドウの残量管理を参照してください。
残りトークンはどこで確認できるのか
Claude Codeでの残量確認は、ターミナルで/usageコマンドを実行するか、常時表示されるステータスラインを見るかの2通りが基本です。
/usageを実行すると、現在の利用状況が画面に表示されます。ここには利用上限に対する割合と、次にリセットされるまでの目安が示されます。毎回コマンドを打つのが手間な場合は、ステータスラインに残量を常時表示する設定にしておくと、作業を止めずに確認できます。
一つ注意したいのは、サブスクリプション契約とAPI利用とでは、見るべき画面や表示のされ方が異なる点です。この違いを踏まえた具体的な確認手順は、サブスクとAPIでの利用状況確認方法で画面ごとに整理しているので、そちらを参照してください。CLI操作全体の型を先に押さえておきたい場合はClaude CodeのCLI操作ガイドも参考になります。
表示されている数値やバーは、どう読めばいいのか
表示される％やバーは、5時間ごとの短期枠と週次の長期枠という2層構造のどちらに対する残量なのかを見分けて読む必要があります。
Claude Codeの利用上限は、短い周期でリセットされる枠と、週単位でリセットされる枠の二重構造になっています。画面に「あと〇%」と出ていても、それが5時間枠の残りなのか週次枠の残りなのかによって、取るべき行動はまったく変わります。短期枠の残りが少ないだけなら、数時間待てば回復しますが、週次枠の残りが少ない場合は、その週のうちに使える量そのものが限られているという意味になります。
また、残量が少なくなると警告表示が出ることがありますが、これはあくまで利用上限に近づいているサインです。前のセクションで触れたコンテキストウィンドウ側の残量とは別物なので、警告が出たからといってコンテキストウィンドウを圧縮しても意味がありません。この2つを混同しないことが、次の行動判断を誤らないための前提になります。
セッション単位の制限とAPI側のレート制限（一定時間あたりのリクエスト数に対する制限）は仕組みが異なるため、混同しやすい場合はセッション制限とレート制限の違いやレート制限の種類と対処法で切り分けておくと理解しやすくなります。
残りが少ないとき、何を基準に行動を変えればいいのか
残りが少ないときの判断は、モデルを軽くする、消費そのものを減らす、作業のタイミングをずらすという3つの軸で考えると整理しやすくなります。
どの軸を優先すべきかは、前のセクションで確認した「短期枠の残りか週次枠の残りか」によって変わります。短期枠が少ないだけなら待つという選択肢が現実的ですが、週次枠が少ない場合は、モデルを切り替えるか消費を減らすかの工夫が必要になります。個人利用でも法人契約でのチーム利用でも、この判断の考え方自体は変わりません。
| 判断軸 | 見分け方 | 具体的な行動の例 |
|---|---|---|
| モデルを軽くする | 作業内容に対して性能が過剰なモデルを使っていないか | 単純な作業ではOpusからSonnetやHaikuへ切り替える |
| 消費そのものを減らす | 不要なコンテキストを毎回持ち込んでいないか、同じ説明を繰り返させていないか | 指示を簡潔にする、無関係なファイルを読み込ませない |
| 作業のタイミングをずらす | 短期枠のリセットまで待てる作業かどうか | 急ぎでなければ数時間後に再開する |
モデルの使い分けをもう少し具体的に判断したい場合はOpus・Sonnet・Haikuの使い分け、消費を減らす工夫を掘り下げたい場合はトークン消費を減らす使い方、無駄なやり取り自体を減らす指示の組み立て方はプロンプト設計のガイドにまとめています。
「/usageが反応しない」「表示が古い」ときの最小限の切り分け
/usageが動かない、または数字が更新されないように見える場合は、まずコマンド自体の認識とバージョンを疑うのが最初の一歩です。
本節で扱うのは、残量表示そのものに直接関わる2つの症状に限定します。1つは、コマンドが認識されない場合で、多くはバージョンが古いか入力方法を誤っています。もう1つは、表示されている数値が明らかに古く、実際の利用状況と合っていないように見える場合です。こちらもバージョンの更新で解消することがあります。バージョンの確認手順はアップデート方法のガイドにまとめてあります。
一方で、ログインできない、認証方式で迷っているといった問題は、この記事の対象外です。その場合はログインできないときの切り分けを確認してください。また、利用上限に達した際に表示される具体的なエラーメッセージの意味については、エラーの原因別切り分けガイドで扱っているので、そちらに委ねます。
まとめ
「残りトークン」という言葉は利用上限の残量とコンテキストウィンドウの残量という別物を指しうること、表示される数値やバーは短期枠と週次枠のどちらに対するものかを見分けて読む必要があること、そして残量に応じてモデルを軽くする・消費を減らす・作業のタイミングをずらすという3つの軸で行動を決められることを見てきました。
残量を正しく読めるようになると、次に気になってくるのは「そもそも消費を抑える使い方」や「Claude Codeを場当たりではなく型として運用すること」だと思います。そうした部分を実際に手を動かしながら学べる場として、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」(https://lab.no-wave.jp/) があります。自分の手でClaude Codeを使いこなせるようになるための学びの場なので、興味があれば覗いてみてください。