Claude Codeを本格的に導入すると、そのあまりの便利さに「これ、今月いくら請求が来るんだろう……」と不安になる瞬間がありますよね。AIエージェントは自律的に思考し、複数のファイルを読み書きするため、チャット型のClaudeよりもトークン消費が激しくなりがちです。まずは、ターミナル上で今すぐ実行できる基本的な確認コマンドから見ていきましょう。これらをマスターするだけで、見えないコストへの恐怖心はかなり和らぐはずですよ。
Claude Codeでトークン使用量を確認する基本手順
usageコマンドで現在の消費統計を見る
セッション中に最も頻繁に使うことになるのが/usageコマンドです。これをターミナルに入力するだけで、現在のセッション（Claude Codeを立ち上げてから現在まで）において、どれくらいのAPIトークンを消費したのかが詳細なリスト形式で表示されます。表示項目は非常に多岐にわたり、単なる「トークン数」だけでなく、以下のような内訳を確認できるのがClaude Codeの面白いところですね。
- Input Tokens: あなたが送った指示や、読み込まれたコードの総量。
- Output Tokens: Claudeが生成した回答や、書き換えたコードの量。
- Cache Writes: 新しくキャッシュとして保存されたデータ量。
- Cache Reads: 保存済みのキャッシュから再利用され、料金が格安（約1/10）になった量。
【注意点】
表示される金額（ドル）は、Anthropic APIの標準的な価格設定に基づき、ローカル環境で計算された「推定値」です。実際の請求額は端数処理やAPIプランの違いにより、表示されている数値と数セント〜数ドルのズレが生じる可能性がある点は頭の片隅に置いておきましょう。とはいえ、目安としては十分すぎる精度を持っています。
特に「Cache Reads」の項目に注目してください。ここが大きければ大きいほど、あなたは効率的にClaudeを使いこなせている証拠です。逆にここがゼロに近い場合は、毎回すべての情報をフルプライスで読み込ませていることになるので、運用の見直しが必要かもしれません。こまめに/usageを叩いて、自分の「お財布事情」をリアルタイムで把握する癖をつけましょう。
statsコマンドで過去7日間の履歴を追跡
「今この瞬間」のコストだけでなく、もう少し長いスパンでの利用傾向を知りたいときは/statsが非常に強力な味方になります。このコマンドは、現在のセッションを越えて、過去7日間や全期間（Cumulative）での累計統計をダッシュボードのように表示してくれます。これにより、自分の「使いすぎ傾向」を客観的なデータとして分析することが可能になります。
例えば、「月曜日はリファクタリングをしたからトークン消費が激しかったな」「水曜日はバグ修正だけだったから意外と安く済んでいる」といった具合に、プロジェクトの進捗とコストの相関関係を可視化できるのがメリットです。主なチェックポイントは以下の通りです。
| 確認できる項目 | 分析のヒント |
|---|---|
| Total Tokens Used | プロジェクト全体の「重さ」を把握する指標になります。 |
| Activity History | どの時間帯に集中してトークンを使っているかが見えます。 |
| Average Cost per Task | 1つの機能を実装するのにかかる「平均単価」が見えてきます。 |
特にチーム開発や受託案件でClaude Codeを使っている場合、「この機能追加にはこれくらいのコストがかかる」という予測を立てるための貴重な資料になります。週末に一度/statsを眺めて、次週の予算配分や作業の進め方を調整するルーティンを作ると、驚くほどスマートに開発を回せるようになりますよ。
costコマンドで累積された概算コストを把握
「結局のところ、今このプロジェクトを始めてから合計で何ドル使ったの？」という、最も切実で直球な疑問に応えてくれるのが/costコマンドです。/usageが「現在の会話の流れ」にフォーカスしているのに対し、/costはより「累計金額」に特化した情報を提示してくれます。API利用ユーザーにとって、何よりも安心材料（あるいは引き締め材料）になるコマンドと言えるでしょう。
このコマンドの素晴らしい点は、非常にシンプルであることです。複雑な内訳に惑わされることなく、パッと実行してパッと金額を確認できます。忙しい開発の合間に「ちょっと使いすぎたかな？」と不安になった時、数秒で現実を確認できるスピード感は、心理的なハードルを下げてくれます。もし予想以上の金額が表示されたら、それは一度作業を止めて、後述する「節約術」を実践すべきサインかもしれません。
また、Claude Codeの設定で予算制限（Budget limit）をかけている場合、その上限に対して今どの位置にいるのかも併せて把握できます。「あと5ドルで今月の制限に達する」といった危機感を具体的に持てるため、無計画な全自動リファクタリングなどで一気に予算を溶かすリスクを回避できます。自分の財布を守るための「防衛ライン」として、このコマンドを使い倒しましょう。
status lineのカスタマイズと設定方法
「いちいちコマンドを打つのすら面倒だし、忘れてしまう」という方にぜひ試してほしいのが、ターミナル下部に常駐するステータスライン（Status Line）のカスタマイズです。実はClaude Codeのデフォルト設定では隠れている情報も、設定ファイルを一行いじるだけで常に画面上に表示させることができるんです。これにより、一文字打つごとに現在のコンテキスト消費量を「チラ見」しながら作業できるようになります。
設定方法は簡単で、~/.claude/settings.jsonを開き、表示項目（Display Items）を編集するだけです。おすすめの表示設定は以下の通りです。
| 表示項目 | 表示例 | 内容 |
|---|---|---|
| コンテキスト使用量 | 12.5k / 200k (6%) | 現在のトークン数と上限に対する占有率 |
| Session Cost | $1.45 | 今のセッションで発生した概算コスト |
| Cache Status | Hit: 85% | キャッシュがどれだけ効いているかの指標 |
このように可視化しておけば、「あ、今一気にコンテキストが膨らんだな」と直感的に気づけます。特筆すべきは「コンテキスト占有率」です。Claude 3.5 Sonnetなどは非常に大きなコンテキストウィンドウを持っていますが、パンパンに詰め込むとレスポンスが遅くなり、かつ1往復あたりの単価が跳ね上がります。常に20%〜30%程度に収まっているかを確認しながら作業するのが、プロの「Claude Code使い」への第一歩と言えるでしょう。
contextコマンドで内訳の割合をチェックする
トークン消費が激しい原因を突き止めたいときに役立つのが、/contextコマンドです。これは現在のコンテキストウィンドウの中に「何が、どれくらいの割合で詰め込まれているのか」を解剖して見せてくれるツールです。Claudeは回答を生成する際、直近の会話履歴だけでなく、プロジェクトのディレクトリ構造、現在開いているファイルの内容、さらには連携しているツール（MCPサーバー）の定義まで、あらゆる情報を「背景知識」として読み込みます。
このコマンドを実行すると、以下のような内訳が円グラフやリスト形式でイメージできるデータとして出力されます。
- Project Structure: ファイルツリー情報。巨大なプロジェクトだとここだけで数千トークン食うことも。
- Opened Files: Claudeが現在「読んでいる」ファイル。不要なファイルが含まれていないかチェック。
- Tool Definitions: MCPサーバーなどが提供する機能の定義。
- Conversation History: 過去のやり取りの履歴。
例えば、「特定の大きな画像データ（のテキスト表現）やバイナリファイルが誤って読み込まれ、コンテキストの8割を占領していた」なんてミスも、このコマンドで見つかります。どのファイルが「犯人」なのかを特定できれば、後述する.claudeignoreで除外するといった対策が打てますよね。単に「高いな」と嘆くのではなく、内訳を科学的に分析することで、スマートなコスト管理が可能になります。
doctorコマンドによる異常な消費の診断
「自分では節約しているつもりなのに、なぜかトークンの減りが異常に早い……」そんなときは、Claude Codeのシステム診断機能/doctorを活用しましょう。これはまさにエンジニアのための「健康診断」のようなコマンドで、環境設定やプロジェクトの構造にコスト増大の原因が潜んでいないかを自動でスキャンしてくれます。
具体的に/doctorが警告してくれるのは、以下のようなケースです。
- 巨大すぎるCLAUDE.md: プロジェクトのルールを記したこのファイルが肥大化しすぎると、毎回の通信で大量のトークンを消費します。
- 重たいMCPサーバー: 常にバックグラウンドで大量のデータをやり取りしている外部ツールがあれば、それを特定します。
- 循環参照や無限ループの懸念: ツールが意図せず同じファイルを読み込み続けていないかなどをチェックします。
「原因不明のコスト高」は、ツール自体のバグというよりは、設定ミスや意図しないファイルの読み込みが原因であることがほとんどです。/doctorはそうした「人間の死角」を鋭く指摘してくれるので、定期的に実行して環境をクリーンに保つことをおすすめします。特に新しいライブラリを導入した直後や、プロジェクトのディレクトリ構成を大きく変えた後などは、一度診断を走らせておくと安心ですね。
Claude Codeのトークン使用量を確認し節約するコツ
確認方法がわかったところで、次は「どうやって節約するか」という超・実践的なテクニックを紹介します。Claude Codeは非常に賢いですが、何も考えずに使っていると「ブルドーザーで庭の草むしりをする」ような、過剰なパワー（とコスト）を使ってしまうことがあります。AIエージェント特有の消費構造を理解して、最小限のコストで最大限のアウトプットを引き出す運用ルールを構築しましょう。
キャッシュ読み取り率を高める運用ルール
Claude Codeを使いこなす上で、最もインパクトが大きい節約術がプロンプトキャッシュ（Prompt Caching）の最大活用です。これは、Anthropicが提供している「一度送った情報をサーバー側で一定期間保存し、次回の指示で使い回す」という画期的な仕組みです。特筆すべきは、キャッシュされた情報を再利用する際の料金（Cache Read）が、新規で読み込む場合の約10%という破格の安さであることです。
キャッシュヒット率（どれだけ使い回せたか）を90%以上に保つことができれば、理論上のコストを劇的に抑えることが可能です。ただし、これには明確なルールがあります。それは「前方一致」の法則です。プロンプトの冒頭からある程度の長さが完全に一致していないと、キャッシュは効きません。そのため、以下のような運用ルールを意識しましょう。
- 頻繁に変える指示はプロンプトの後半に置く: プロジェクト全体のルールや基本構造など「変わらない情報」を先に読み込ませるようにします。
- CLAUDE.mdを固定する: コロコロとルールを変えず、安定した状態を保つことでキャッシュの維持時間を延ばせます。
なお、Anthropicの公式ドキュメント（出典：Anthropic『Prompt Caching』）によると、キャッシュは通常5分間保持されます。つまり、集中して一気に作業を進める「スプリント開発」スタイルの方が、間隔を空けて作業するよりも圧倒的に安く済むのです。節約のためには、作業時間をまとめて確保することも一つの戦略と言えますね。
clearコマンドで不要な会話履歴をリセット
Claude Codeとの会話が長くなってくると、過去のバグ修正の経緯や、今はもう終わったタスクの議論がコンテキストに溜まっていきます。これらはすべて「入力トークン」として毎回の送信時に課金対象となります。新しいタスク（例えば「認証機能の実装が終わったので、次はUIのデザイン修正に入る」など）に移るタイミングでは、迷わず/clearを打ちましょう。
/clearを実行すると、それまでの会話履歴がリセットされ、コンテキストが初期化されます。これにより、次に指示を出す際の入力トークン数を大幅に減らすことができます。これは単なるコスト削減だけでなく、Claudeの思考をクリアにするメリットもあります。古い情報が残っていると、Claudeが「さっき言っていたあの仕様はどうなったんだっけ？」と混乱し、現在のタスクに悪影響を及ぼすことがあるからです。
「歴史を消すのは不安……」と思うかもしれませんが、大切な設計指針やルールはCLAUDE.mdに書いておけば、/clearをしても引き継がれます。「動的な会話はこまめに消し、重要なルールは静的なファイルに残す」という切り分けが、スマートなClaude Code運用の基本です。
claudeignoreで読み込みファイルを制限
プロジェクトの中には、Claudeに絶対に読ませる必要がないファイルが大量に存在します。例えば、node_modulesの中身、.gitディレクトリ、巨大な画像ファイル、ビルド成果物のログなどです。これらをClaudeがスキャンしに行くだけで、無駄なAPIコールとトークン消費が発生してしまいます。これを防ぐのが.claudeignoreファイルです。
使い方は.gitignoreと全く同じです。プロジェクトのルートディレクトリにファイルを配置し、除外したいパスを記述します。おすすめの記述例を以下にまとめました。
# 依存ライブラリ
node_modules/
vendor/
# ビルド成果物
dist/
build/
*.log
# バイナリデータ・メディア
*.png
*.jpg
*.mp4
*.pdf
# 秘匿情報（念のため）
.env
*.pem
これらを明示的に除外することで、Claude Codeが「プロジェクト全体を把握して」と言われたときに読み込むデータ量を物理的に制限できます。特に、大規模なモノレポ（Monorepo）構成で開発している場合、この設定一つで月間のコストが数割変わることも珍しくありません。「Claudeに見せる必要がないものは徹底的に隠す」のが、無駄遣いを防ぐ鉄則です。
プロンプトキャッシュを有効活用する設計
前述の「キャッシュ」を最大限に活かすためには、プロジェクト設計そのものを工夫する必要があります。その中心となるのが、すべてのセッションで必ず読み込まれるCLAUDE.md（またはシステムプロンプト的なファイル）の管理です。ここにはコーディング規約やプロジェクトの概要を書きますが、情報を詰め込みすぎるのは逆効果です。
ベストプラクティスとしては、CLAUDE.mdを500行（約5KB）程度以内に抑えることが推奨されています。すべてのAPI仕様や全テーブル定義を書き込むのではなく、以下のような「段階的開示（Progressive Disclosure）」の考え方を取り入れましょう。
- CLAUDE.mdには「地図」だけを書く: 「APIの定義はdocs/api.mdにあるよ」「DB設計はdocs/db.mdを見てね」というポインタだけを記述します。
- 必要なときにだけ読み込ませる: 「今からDB周りをいじるから、docs/db.mdを読んで作業して」と指示を出します。
このように、「常にメモリに乗せておく情報」と「必要なときだけロードする情報」を分けることで、ベースとなる毎回の消費トークン（固定費）を最小化し、変動費である会話トークンを効率的にコントロールできます。まさに「必要な情報を必要な分だけ」というジャストインタイムの考え方ですね。
効率的なClaude Codeのトークン使用量確認法
標準コマンドでも十分な管理が可能ですが、より直感的に、あるいは視覚的に消費状況を把握したい方には、コミュニティで開発されている外部ツールの併用もおすすめです。例えば、GitHubなどで公開されているオープンソースのツールには、Claude Codeのログファイルを解析してグラフ化してくれるものや、ターミナルの端っこで常に「現在のバーンレート（消費速度）」を表示してくれるものがあります。
一例として、ccusageのようなツール（npmなどで配布されている場合があります）を使えば、以下のような高度な分析が可能になります。
- Live Monitoring:
npx ccusage@latest --liveのように実行し、リアルタイムで1分あたりの消費金額を表示。 - Project Ranking: どのプロジェクトファイルが最も「コストを食っているか」のランキング表示。
- Budget Alert: 設定した予算に近づいたときにデスクトップ通知を送る。
こうしたツールを導入することで、「気づいたら数万円使っていた」という最悪の事態を防ぐことができます。もちろん、公式の/usageコマンドをスクリプトで定期的に取得し、自分専用のダッシュボードを作るのも面白いでしょう。Claude Codeはあくまで「APIを通じたツール」なので、そのログをどう料理するかはユーザー次第です。自分にとって最もストレスのない監視環境を構築しましょう。
まとめとClaude Codeのトークン使用量確認
Claude Codeは、間違いなくエンジニアの生産性を数倍に引き上げてくれる革命的なツールです。しかし、その強力なパワーの裏側には、常に「トークン消費」という現実的なコストがつきまといます。今回紹介した/usage、/stats、/contextといったコマンドを使いこなし、現在の状況を「見える化」することが、まずは何よりの対策になります。
【本日の振り返り】
1. /usageと/statsで、現在と過去の利用状況を把握する。
2. ステータスラインをカスタムして、リアルタイムの消費量を可視化する。
3. /clearと.claudeignoreで、無駄なコンテキストを削ぎ落とす。
4. プロンプトキャッシュを意識した設計で、単価を1/10に抑える。
「今、どれだけ使っているか」を常に意識するだけで、無駄な支出は驚くほど減らせるはずです。AIを使いこなすということは、AIに丸投げすることではなく、AIという強力なエンジンの「燃費」を管理しながら、目的地まで最短距離で走らせることでもあります。まずは自分のステータスラインを一行書き換えるところから始めて、お財布にも優しい快適なClaude Codeライフを送ってくださいね。もし途中でわからなくなったら、またこの記事を読み返しに来てください！
