/cost（コスト）

Claude Codeを本格的に使い始めて、毎月の請求が読めない／思ったより高くて怖い人向け

Claude Codeを毎日使い始めた頃に最初にぶつかるのが、「今日いくら使ったか分からない」「月末の請求が来てから青ざめる」という不安です。/cost はその不安に対する一次対処で、いま開いてるセッションでどれくらいトークンを食ったか、ドル換算でいくら相当か、作業時間はどれくらいかを1画面で見せてくれます。

正体を一言で言うと、/cost は /usage という本体コマンドの別名（エイリアス）です。叩くと /usage と同じ画面が開きます。

噛み砕くと

家計簿アプリの「今日のレシート集計ボタン」みたいなものです。1日の終わりにそれを押すと、今日のセッションだけを切り取った小さなレシートが出てくる。月末の本物の請求書とは別物で、あくまで「いまの会話で使ったぶんの自分用ざっくり見積もり」が見られます。

本物の請求書は別の場所（Claude Console）にあります。/cost が見せるのはその場で電卓を叩いた概算なので、ピッタリ一致はしません。月単位で何ドル使ったかを真剣に把握したい時は Console を見にいく、その日のセッションがどれくらい重かったかを軽くチェックしたい時は /cost、という棲み分けです。

大事な前提：何を見て、何を見ないコマンドか

このコマンドは「いま開いてるセッションだけ」を切り取って見せます。先週の合計でも今月の合計でもない。/clear でセッションをリセットすると、表示されるドル額もゼロからの計算に戻ります。

もう1つ大事なのは、ドル表示が「その場で電卓を叩いた概算」だという点です。公式docsはこれを「locally computed estimate from token counts」と書いていて、実際の請求とはズレることがあると明言しています。本物の請求書を見たい時は Claude Console（platform.claude.com/usage）を開きます。

「副業の料理ブログを半日いじる」を例に、実際の手順を見る

私が想定している場面はこうです。週末に副業で料理ブログを作っていて、午前中ずっとClaude Codeに記事構成を相談したり、レシピカードのHTMLを書かせたりしていた。気づいたら4時間経ってる。「これいくら使ったんだろう」と気になって /cost を叩く、という流れです。

ステップ1: ターミナルで Claude Code を開いている状態から始める

すでに半日くらい作業した後を想定します。レシピカードのHTMLを2本書かせて、写真の代替テキストを10個作らせて、SEO向けのh2案を相談した、くらいの中身です。

ステップ2: コマンドだけそのまま叩く

後ろに何も書き足しません。/cost だけ打ってEnterします。

> /cost

ステップ3: 出てきた画面を読む

こんな感じの4行が表示されます（公式docsの表示例そのまま）。

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

1行目がドル概算、2行目がClaudeに実際に問い合わせていた累積時間、3行目がセッションを開いてから経った実時間、4行目がコードに加えた行数です。ここで「あれ、$0.55って思ったより多いな」と気づくのが /cost の役割です。

ステップ4: ここで初心者がやりがちな勘違い

1行目の $0.55 を見て「今月の請求は0.55ドルか」と思ってしまうのが一番多い誤読です。違います。これは いま開いてるセッションだけ の概算で、月の合計でも今日の合計でもありません。/clear を叩いた瞬間にゼロに戻ります。

もう1つ、3行目の wall（実時間）が長いのを見て焦る人がいますが、ここは課金には関係しません。コーヒーを淹れに行ってる間も wall は伸びていきます。コストに効くのは2行目の API duration（実際にClaudeに問い合わせていた時間）の方です。

ステップ5: なぜ高かったかを推測する

$0.55 が高いか安いかは作業内容で変わりますが、半日いじって0.55なら正直安い部類です。私が想定する「高くて怖い」パターンはこちらで、たとえば途中で /model opus に切り替えたまま戻し忘れて、軽い相談までOpusで処理し続けてた、みたいな時です。同じ半日でも$1を超えることがあります。

ステップ6: 翌日の対策を立てる

$1超えに気づいた翌日は、私ならこう運用を変えます。軽い相談はSonnet固定、重い設計判断のときだけ /model opus、判断が終わったら即 /model sonnet に戻す、用事が変わったら /clear でセッションを切る。これだけで翌日は$0.3前後まで縮みました（あくまで個人運用の例）。

つまり /cost は何をしてくれるのか

• やってくれる: いま開いてるセッションのトークン消費・ドル概算・API/実時間・コード変更行数を1画面で見せる
• やってくれる: サブスクプラン契約中なら、ドル額だけでなく「今月のプラン使用量バー」と作業統計も同じ画面に出す
• やってくれない: 今日の合計・今週の合計・今月の合計の集計（あくまでセッション単位）
• やってくれない: 本物の請求金額の表示（それは Claude Console 側）
• 意味が薄い場面: Claude Code を Bedrock / Vertex / Foundry 経由で動かしている時。これらの経由ではClaude Codeはコストデータを送らないので、/cost を叩いてもクラウド側の本物の課金とは別の話になる

使いどころ3シナリオ

シナリオ1: 1日の終わりに「今日いくら使った」を確認するルーチン

これが一番多い使い方です。私の場合、副業の料理ブログ作業を1日やって最後に /cost を叩いて、$0.3〜$0.7 くらいに収まってるかチェックします。$1を超えてたら「今日はOpus使いすぎたな」「/clear 入れずに同じセッションで2件回したな」みたいに反省できる。月末請求を待つより、その場で気づける方が圧倒的に立て直しやすいです。

シナリオ2: 重い作業の直後にスポット確認

たとえば長文の記事を1本通して書かせた直後、複数のサブエージェントを並行で動かした直後、設計レビューをOpusに延々相談した直後。こういう「いま重かったな」の感覚があるタイミングで叩くと、感覚と数字が合うかチェックできます。「思ったより安かった」「思ったより高かった」の答え合わせが体に染み込むと、次回からの判断が速くなる。

シナリオ3: 新しい設定の前後で差分確認

MCPサーバーを追加した、スキルを新しく入れた、CLAUDE.mdに大きく書き足した、といった環境変更の直後は、同じような作業をしても消費が変わることがあります。変更前にいったん /cost を見て、変更後に同じ系統の作業をしてからまた /cost、という比較で差分を体感できます。「あのスキル入れてから明らかにトークン食ってるな」が分かれば、外す判断ができる。

初心者が踏みやすい落とし穴

• サブスク契約中のドル数字に一喜一憂しない。Pro/Max/Team/Enterpriseで契約してるなら、画面のドル額は「もしAPI課金だったらこのくらい」という参考値です。実際の支払いは月額固定。同じ画面に出てる「プラン使用量バー」の方を見るのが正解。
• wall duration の長さで焦らない。Claudeに席を外している時間も wall は伸びます。課金に効くのは API duration の方。私もよく勘違いして「6時間って何!?」と一瞬驚きますが、これは画面を開きっぱなしにしてた時間のこと。
• /cost と /context を混同しない。名前が似てますが別物です。/context はコンテキスト窓（Claudeが「いま覚えていられる量」）の使用率を可視化するコマンドで、お金の話はしません。コストを見たいなら /cost、Claudeの記憶量を見たいなら /context。
• 背景トークンの存在を忘れない。何も操作していないアイドル状態でも、過去会話の要約処理などが裏で少しだけ動きます。公式docsは「typically under $0.04 per session」と書いていて、セッションあたり数セント程度。/cost がゼロにならないのを見て「バグ?」と思わないでください。
• Bedrock/Vertex/Foundry経由なら別管理。これらクラウド経由でClaude Codeを動かしてる場合、Claude Codeはクラウド側にコストデータを送りません。/cost の数字とクラウド側の請求がそのままでは合わない。公式docsはサードパーティの LiteLLM を使う運用を例示しています。
• 本物の請求は Claude Console を見る。月単位で正確な金額を知りたい時は platform.claude.com/usage の方。/cost はあくまで「その場の概算」です。
• /cost なんとか のように後ろに足しても意味がない。このコマンドはコマンドだけそのまま叩く形で、後ろに何か書き足す使い方はありません。範囲指定や日付指定はできない仕様です。
• /stats も実は同じコマンド。/stats は /usage のエイリアスで、開いた瞬間に統計タブが選ばれている状態になるだけの違いです。三兄弟（/cost / /usage / /stats）が同じ画面を開く、と覚えておけばOK。

書き方

/cost

やってみるとこうなる

入力

/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

関連項目

• /usage（準備中）
• /stats（準備中）
• /context（準備中）
• /clear（クリア）
• /model（モデル）

公式ドキュメント

https://code.claude.com/docs/en/costs