Claude Codeの使用量、ちゃんと把握できていますか？
室谷今回はClaude Codeの使用量（usage）の話をしましょう。.AI（ドットエーアイ）コミュニティでも「気づいたら制限に当たっていた」「月末にコストがどのくらいかかったか把握できてない」という声が多くて・・・
テキトー教師講座でもここは毎回触れるポイントですね。Claude Codeを使い始めた直後は「なんか止まった」で終わっちゃう受講生さんが多い。
制限の仕組みを知っているかどうかで、日々の使い方がかなり変わってきます。
制限の仕組みを知っているかどうかで、日々の使い方がかなり変わってきます。
室谷そうなんですよね。ProとかMaxとかAPIとか、プランごとに使用量の管理方法が違うのが少しわかりにくいんですが、3つのパターンに分けて考えると楽です。
テキトー教師「プラン別の確認方法の違い」ってことですね。APIユーザー、Pro/Maxサブスクライバー、そして企業・チームユーザーの3つ。
ここを混同して「公式コンソールで見ようとしたけど出てこない」って受講生さんが出るんですよ（笑）
ここを混同して「公式コンソールで見ようとしたけど出てこない」って受講生さんが出るんですよ（笑）
室谷わかるw プロプランで使っている人がconsoleを見に行っても、コストの詳細は表示されないですもんね。
Claude Codeの使用量を確認する3つの方法
テキトー教師まず基本から整理しましょう。Claude Codeのusageを確認する方法は大きく3つあります。
室谷/costコマンド、/contextコマンド、そして外部ツール（ccusageやClaude-Code-Usage-Monitor）。この3つですね。テキトー教師注意点として、
サブスクライバーは代わりに
/costコマンドはAPIユーザー向けです。公式ドキュメントにも「Claude MaxやProサブスクライバーの場合、/costのデータは課金目的では関係ない」と明記されています。サブスクライバーは代わりに
/statsで使用パターンを確認する形になります。室谷ここ、ドキュメントを読まずに「/costを打ったら$0.55って出た。これが課金されるの？」って混乱している人が多いんですよね・・・。
APIユーザーはトークン消費分が課金されますが、サブスクライバーはあくまで参考値です。
APIユーザーはトークン消費分が課金されますが、サブスクライバーはあくまで参考値です。
テキトー教師/contextコマンドは全プランで使えるので汎用性が高いですね。現在のセッションのトークン使用量、残り使用可能量、カテゴリ別の内訳を確認できます。MCPのツール使用分まで細かく出るので、「どこでトークンを食っているか」の把握にも使えます。
室谷MYUUUでもエンジニアに「定期的に/contextで確認する癖をつけよう」と言っています。コンテキストウィンドウが埋まってくると精度が落ちるんですよね。
パフォーマンスが下がってきたなと感じたら、一度/clearしてリフレッシュする判断ができる。
パフォーマンスが下がってきたなと感じたら、一度/clearしてリフレッシュする判断ができる。
/cost と /context の使い分け
テキトー教師整理するとこうなります。
| コマンド | 対象 | 確認できる内容 |
|---|---|---|
/cost | APIユーザー | セッション合計コスト・API使用時間・コード変更行数 |
/context | 全プラン | 現在のトークン使用量・カテゴリ別内訳・MCPツール使用分 |
/stats | Pro/Maxサブスクライバー | 使用パターン |
室谷/costの出力はこんな感じです。``` Total cost: $0.55 Total duration (API): 6m 19.7s Total duration (wall): 6h 33m 10.2s Total code changes: 0 lines added, 0 lines removed ```
テキトー教師これを見てAPIユーザーは「今日のセッションはいくら使ったか」がわかる。でもProやMaxの人はこれを気にしなくていい。
そっちは月額定額ですから。
そっちは月額定額ですから。
室谷公式の数字だと、Claude Codeの平均コストはAPIユーザーで「1開発者あたり1日$6、90%のユーザーは1日$12以下」です。月換算で$100〜$200/開発者（Sonnet 4.6使用時）という数字が出ています。
テキトー教師「1日$6って高いじゃないか」と思う人もいるかもしれないですが・・・
室谷時給換算するとペイするんですよ。MYUUUのエンジニアだと、1日2〜3時間は削減できているので、エンジニアコストと比較すると全然合う。
「Claude Codeにかかるコストより、削減できる時間の方が大きい」というのは海外でもよく言われていますね。
「Claude Codeにかかるコストより、削減できる時間の方が大きい」というのは海外でもよく言われていますね。
サブスクライバーの使用量制限の仕組み
テキトー教師Pro/Maxプランを使っている人が一番気にするのが「使用量制限」ですよね。「気づいたら止まった」の正体です。
室谷ここはちょっと複雑で・・・。使用量はサーバー負荷によって変動します。
繁忙時間帯は少なくなることもある。だから「Pro = 常にこれだけ使える」という固定の数字はないんですよ。
繁忙時間帯は少なくなることもある。だから「Pro = 常にこれだけ使える」という固定の数字はないんですよ。
テキトー教師受講生さんによく聞かれるのは「セッションは何時間持つの？」という話ですね。セッションは最初のメッセージを送ってから5時間で1セッション。
これを超えると新しいセッションに移ります。
これを超えると新しいセッションに移ります。
室谷同じタスクを何時間も続けるより、タスクごとにセッションを切り替えた方が効率的です。コンテキストもリフレッシュされるので、精度が保ちやすい。
テキトー教師Proは中〜高負荷のコーディング向け、Max 5xはPro比5倍のトークン枠でOpusアクセス付き、Max 20xはほぼ自律的なマルチエージェント向けという位置づけです。
| プラン | 月額 | 対象ユーザー |
|---|---|---|
| Pro | $20 | 中〜高負荷のコーディング |
| Max 5x | $100 | ヘビーユーザー（Opusアクセス付き） |
| Max 20x | $200 | マルチエージェント・ほぼ全自動開発 |
室谷claude code usage limitsでよく出てくる「approaching usage limit」の通知、あれが出てきたらセッションをどう使うかを考えるサインです。weekly usage limitに引っかかった場合も同様で、次のリセットまで待つか、APIキーに切り替えるかの判断になります。
外部ツールでトークン使用量を可視化する
室谷ProやMaxユーザーはAnthropicコンソールでコスト詳細を見られないので、サードパーティツールを使う人が増えているんですよ。ここが面白い話で・・・。
テキトー教師ccusageとClaude Code Usage Monitor（claude-monitorパッケージ）ですね。どちらもClaude Codeが生成するローカルのJSONLファイルを読み込んで分析する仕組みです。
ccusage：履歴の使用量分析
室谷ccusageはCLIツールで、日付別・セッション別・プロジェクト別にトークン使用量を確認できます。インストールしなくてもnpxで直接使えるのが便利ですね。
```bash npx ccusage@latest report daily ```
テキトー教師「どのリポジトリでClaude Codeを一番使っているか」「特定期間の使用傾向」を見るのに向いています。受講生さんに「自分のClaude Code活用度を振り返りたい」と言われたらccusageを勧めています。
室谷Claude Code自体に「ccusageを使って、このプロジェクトの先月の使用量を調べて」と頼めば実行してくれるのも面白いですね。ツール自体をClaudeに使わせる。
Claude-Code-Usage-Monitor：リアルタイム監視
テキトー教師こちらはリアルタイムのトークン消費をグラフで可視化するツールです。GitHubのスター数が7,300を超えていて、かなり注目されています。
室谷インストール方法はuvかpipです。
```bash
uvで（推奨）
uv tool install claude-monitor claude-monitor
pipで
pip install claude-monitor cmonitor ```
テキトー教師Claude Codeを動かしながら別ウィンドウでcmonitorを立ち上げると、トークン消費の推移とコスト推計がリアルタイムで更新されます。「あとどれくらい使えるか」の予測も出るので、使用量制限に近づいているときに判断しやすい。
室谷APIユーザーにとっては「今日のコストがどこまで膨らんでいるか」の把握に使えます。ヘビーなタスクをやる前に確認する習慣が作れますね。
テキトー教師履歴を月単位で確認するときは：
```bash cmonitor --view monthly ```
室谷ccusageとClaude-Code-Usage-Monitorの使い分けとしては、「過去のトレンドを振り返る」のがccusage、「今まさに動かしながら消費量を見る」のがClaude-Code-Usage-Monitorです。
チームで使うときの使用量管理
テキトー教師個人じゃなくてチームで導入するときの話もしましょう。企業でAPI経由でClaude Codeを使う場合は、コンソールでワークスペースごとのコスト管理ができます。
室谷Anthropicコンソールで「Claude Code」というワークスペースが自動作成されます。ここからチーム全体の使用コストを確認したり、スペンドリミット（月間上限）を設定したりできます。
テキトー教師チーム規模に応じたTPM（Token Per Minute）の設定推奨値も公式ドキュメントに出ています。
| チーム規模 | 推奨TPM（1ユーザー） | 推奨RPM（1ユーザー） |
|---|---|---|
| 1〜5人 | 200k〜300k | 5〜7 |
| 5〜20人 | 100k〜150k | 2.5〜3.5 |
| 20〜50人 | 50k〜75k | 1.25〜1.75 |
| 50〜100人 | 25k〜35k | 0.62〜0.87 |
| 100〜500人 | 15k〜20k | 0.37〜0.47 |
| 500人以上 | 10k〜15k | 0.25〜0.35 |
室谷チームが大きくなるほど1人あたりのTPMが減るのは、「大きな組織ほど同時に使う人の割合が下がる」という前提からです。200人で1人あたり20k TPMを設定すると、合計400万TPMになる計算ですね。
テキトー教師全員が一斉に使うシーン、例えば大規模なハンズオン研修は例外で、高めのTPMを確保しておく必要があります。100人以上に同時にClaude Codeを触らせるときは事前に設定を確認しておいた方がいいですね。
室谷チームのusage analyticsはで確認できます。TeamプランとEnterpriseプランのみですが、承認したコード行数・サジェスト承認率・デイリーアクティブユーザー数・PRへの貢献量などが見えます。
GitHubとの連携を設定すれば、「Claude Codeが貢献したPR数」まで追跡できるので、ROI計測に使えるんですよね。
GitHubとの連携を設定すれば、「Claude Codeが貢献したPR数」まで追跡できるので、ROI計測に使えるんですよね。
トークン使用量を減らす実践的な方法
テキトー教師usage監視だけじゃなくて、「いかに効率よく使うか」も重要ですね。approaching usage limitを回避するためのコスト削減策もまとめましょう。
室谷公式ドキュメントでまとめられている方法が実践的で、MYUUUでも実際に導入しているものが多いです。
テキトー教師一番効果が大きいのはコンテキスト管理ですね。具体的には：
- タスクを切り替えたら
/clearでコンテキストをリセットする（前のタスクの情報がずっと残っているとトークンの無駄） /compactで会話履歴を圧縮する（/compact コードサンプルとAPIの使い方に集中してのように指示を追加できる）- CLAUDE.mdは200行以内に抑える（長いCLAUDE.mdはセッション開始ごとにコンテキストを消費する）
室谷モデルの選択もコスト管理の核心ですね。複雑なアーキテクチャ設計や多段階の推論が必要なタスクでなければ、Sonnetで十分です。
単純なサブエージェントのタスクにはHaikuを指定するのも有効です。
単純なサブエージェントのタスクにはHaikuを指定するのも有効です。
テキトー教師「拡張思考（extended thinking）」もデフォルトで有効になっていますが、思考トークンは出力トークンとして課金されます。複雑なタスクでは有効ですが、シンプルな作業では
/effortで下げたり、/configでオフにしたりする価値があります。室谷Claude Codeは内部で自動的にコンテキストを圧縮しようとするんですが、それでも手動で管理した方がコストは下がります。タスクの切れ目で意識的にリセットする習慣が大事です。
テキトー教師CLAUDE.mdを「ショート」に保つ話、受講生さんへの伝え方として「CLAUDE.mdに書く内容 × 会話のターン数 = 消費トークン」って言うとわかりやすいです。長いCLAUDE.mdほど、長い会話をするほどコストが増える。
室谷「CLAUDE.mdは毎ターンシステムプロンプトとして再注入される」という仕組みがわかると、内容を絞る動機がはっきりしますよね。プロンプトキャッシュで実際のコストは軽減されますが、コンテキスト圧迫は避けられない。
まとめ：Claude Code使用量管理の全体像
室谷改めて整理すると、使用量管理で最低限押さえるべきポイントは4つです。
テキトー教師まず「自分はAPIユーザーかサブスクライバーか」を把握すること。ここが違うと確認方法も変わります。
次に「/contextで現在のトークン消費を定期確認する」習慣をつけること。これは全プラン共通でできます。
次に「/contextで現在のトークン消費を定期確認する」習慣をつけること。これは全プラン共通でできます。
室谷3つ目が「履歴の振り返りにccusage、リアルタイム監視にClaude-Code-Usage-Monitor」という外部ツールの使い分け。4つ目が「コンテキスト管理でトークンを節約する」実践ですね。
テキトー教師チームで導入するなら、AnthropicコンソールでスペンドリミットとTPM設定を最初に決めておくことも重要です。「導入してみたらコストが想定外に膨らんだ」を防ぐための安全弁になります。
室谷「Claude Code usageの把握」で一番大事だと思うのは、「制限に当たってパニックにならない」ことですね。仕組みを理解していれば「5時間セッションが終わったから次のセッションに移る」「approaching limitが出たからコンテキストをクリアする」と冷静に対処できる。
テキトー教師.AIのコミュニティでも「Claude Codeが途中で止まった」という相談が来ると、だいたい使用量制限か、コンテキストが膨らんで精度が落ちているケースです。今回の内容を知っていれば、自分でトラブルシュートできます。
よくある質問
Q. Claude ProでもClaude Codeの使用量コストは確認できますか？
室谷Proプランの場合、Anthropicコンソールでのコスト詳細確認はできません。代わりに
/statsコマンドで使用パターンを確認するか、ccusageやClaude-Code-Usage-MonitorなどのサードパーティツールでローカルのJSONLデータを分析する方法があります。Q. 「approaching usage limit」が出たらどうすればいいですか？
テキトー教師いくつか選択肢があります。
/compactでコンテキストを圧縮する、/clearでコンテキストをリセットして新鮮な状態でタスクを続ける、あるいは5時間のセッション制限に近いなら次のセッションを待つ、という対処が有効です。Q. チームでAPIを使っている場合、コスト管理はどうするのがベストですか？
室谷AnthropicコンソールでスペンドリミットをTierごとに設定するのが基本です。また公式ドキュメントに記載されているTPM/RPMの推奨値を参考に、チームサイズに合ったレート制限を設定しておくと、予期せぬ高額請求を防げます。