9-2 Claude Code トークン節約術｜コストを半額にする

このレッスンで身につくこと

前のレッスン 9-1 で「トークンとは何か」「入力と出力の単価差」を押さえました。ここから先は、同じ成果物を半分のコストで仕上げる ための具体的な手筋を一気に増やします。

所要時間 — 約 60 分（手元で /cost を叩きながら読むのを推奨） 難易度 — ★★☆☆☆（前のレッスン 9-1 の内容を前提にします）

最適化の効果は実例で見る — Before / After

抽象的な話を始める前に、最適化を入れる前と後でどれくらい違うかを見ておきます。同じユーザーが、同じ機能を実装する というシナリオです。

「ちょっと工夫した」だけで、1 桁 コストが変わるのが Claude Code のコスト構造です。原因はシンプルで、トークンは指数的に積み上がる 性質があるからです。会話が長くなるほど、毎回の往復で過去全部が再送信されるため、同じことを繰り返すたびに料金が増えていきます。

==/compact== コマンド — 会話履歴を要約してトークン削減

Claude Code は会話のたびに 今までの全文脈 をモデルに送り直します。これが コストが線形ではなく二次関数的に増える 主因です。

/compact コマンドは、会話履歴をその場で 要約圧縮 して、新しいスタート地点を作る機能です。

> /compact
# Context compressed: 62,400 → 8,200 tokens
# (要約は内部に保持、これまでの意思決定や暗黙ルールは引き継がれる)

いつ実行するか — 3 つのサイン

1. 画面下のコンテキスト残量バー が 40% を切ったとき
2. 話題が明確に切り替わった とき（例: バグ修正 → UI 改善に移行）
3. 同じファイルを 3 回以上読み直してる ことに気づいたとき（過去の Read 結果がもう古い）

/compact の前後で起こること

/compact を実行すると、内部的にはこんな処理が走ります。

1. 直近の会話履歴（数万トークン）を Claude 自身に渡す
2. 「重要な決定・現在の状態・残タスク」を抽出した要約を生成
3. 古い履歴を破棄し、要約 + 最新の数往復だけを新しい文脈にする
4. 以降の指示は、この圧縮後の状態からスタート

要約自体に小さなコストはかかります（だいたい $0.01〜0.03）。ただし、その後の数往復で 30,000 トークン削減 × 5 ターン なら、回収どころか何倍にもなります。

==/clear== の使い分け — 思い切ってリセット

/compact が「要約して引き継ぐ」のに対して、/clear は 全部リセットして真っさらにする コマンドです。

> /clear
# Conversation cleared. Starting fresh.

/clear を選ぶ場面

• 別の機能の作業に切り替える とき（バグ修正 → 別アプリの開発）
• 試行錯誤の山が積み重なって、もう経緯が邪魔 なとき
• 前の話の影響で Claude が変な思い込みをしている とき
• デモ・スクショ用に綺麗な状態を作りたい とき

==/compact は「過去を覚えていてほしいけど短くしたい」、/clear== は「過去はもう要らない、忘れて」というニュアンスの違いです。

/compact vs /clear 早見表

プロンプトキャッシュを意図的に効かせる

Anthropic API には プロンプトキャッシュ という仕組みがあり、繰り返し送るプロンプトの先頭部分 は最大 90% 割引で再利用できます。Claude Code はこれを自動で使ってくれますが、書き方次第で効きが変わります。

キャッシュが効く 3 つの条件

1. プロンプトの先頭から、変わらない部分が連続している こと
2. 同じ会話の中で短時間に 再送信されること（数分以内が目安）
3. キャッシュ可能な最小長 を超えていること（モデルによるが数千トークン）

つまり CLAUDE.md と Read で読んだファイル は、放っておいてもキャッシュが効きやすい部分です。逆に プロンプトの真ん中で頻繁に内容が変わる と、それ以降のキャッシュが全部破棄されます。

キャッシュを壊しやすい NG パターン

大きすぎる文脈を避ける — CLAUDE.md の肥大化に注意

CLAUDE.md は便利だからといって、何でも書き足していくと コストの逆効果 になります。毎回の会話で全文が送信される ので、肥大化した CLAUDE.md は 永続的な税金 として効いてきます。

CLAUDE.md の理想サイズ

1 ファイル 600 行を超えたら、分割を検討 してください。具体的には、後の章で出てくる ==@import や サブドキュメント参照== の仕組みを使って、必要なときだけ読み込ませる形にします。

肥大化を防ぐ 3 つのルール

1. 「毎回必要な情報」だけ を CLAUDE.md に書く
2. 「たまに必要な情報」 は別ファイルに分け、必要時に @docs/database-conventions.md のように参照
3. 「もう古い情報」 は積極的に削る（過去の決定の残骸が一番危険）

モデル選択の使い分け — Haiku で済むタスクには Haiku

Claude には大きく 3 つのモデル があります。料金差は 15 倍 あります。

デフォルトの Sonnet で 90% のタスクが片付きます。残り 10% を Opus、もしくは Haiku に振り分けることで、コストを大きく下げられます。

タスク別の推奨モデル

# モデル切り替え
> /model claude-haiku-4-5
# 軽いタスクを高速・低コストで

> /model claude-sonnet-4-6
# 通常モードに戻す

> /model claude-opus-4-7
# 難しい局面だけ

出力フォーマット指定で無駄を削る

ここからは 出力トークン を削るテクニックです。前述したとおり、出力は入力の 5 倍の単価 なので、ここを削るのが最もリターンが大きいです。

「短く返して」を入れるだけで 50% 削減

> このコードの問題点を教えて。
→ 説明だけで 1,500 トークン

> このコードの問題点を 3 行以内で教えて。
→ 200 トークン以下

出力フォーマット指定の型

どれくらいの密度で どんな形で 返してほしいかを最初に伝えるだけで、出力が劇的に縮みます。

コードだけ欲しいときの定型

> 以下を Python で書いて。説明は不要、コードブロックだけ返して。
> 仕様: ……

この 1 行が入っているだけで、平均 1,000 トークン以上の節約 になります。

一度に詰め込まない — タスク分割でリトライコスト削減

大きな依頼を一発で投げる と、Claude は途中で迷子になり、リトライが増えます。リトライこそが最大のコスト源です。

悪い投げ方の例

> 新規プロジェクト作って、認証つけて、DB繋いで、管理画面と
> ユーザーページとAPI と E2E テストとデプロイ設定までやって。

これを 1 発で頼むと、Claude は どこから手をつけるか の判断にトークンを使い、途中で前提が崩れて やり直し になります。1 セッションで $5 飛ぶこともあります。

良い投げ方の例

> まず認証だけ実装して。Better Auth で email/password、最小構成。
（ここまで OK ならコミット）

> 次に DB スキーマ。users / sessions テーブルを Drizzle で。

> その次に管理画面の雛形。/admin に / page と /users page だけ。

1 ステップずつコミットして進める と、失敗しても巻き戻しが 1 ステップ分 で済みます。==/compact== のタイミングも自然に取りやすくなります。

==/cost== ベースの可視化習慣

コスト最適化の本丸は、測ることを習慣にする ことです。測らない最適化は、ほぼ全部気のせいです。

/cost の読み方

> /cost

Session usage:
  Input tokens:           42,180 ($0.13)
  Cache read tokens:     128,400 ($0.04)
  Cache create tokens:    18,200 ($0.07)
  Output tokens:           7,940 ($0.12)
  Total: $0.36

注目すべきは ==Cache read tokens と Output tokens の比率== です。

コストレビューを「日次」にする

==1 日の終わりに 1 分だけ /cost を見る== 習慣を作ってください。

# 1 日の最後にやる儀式
> /cost                    # 最終確認
> （メモアプリに金額をメモ）

これだけで、月末の請求書ショック が起こらなくなります。1 週間も続ければ、自分の作業 1 件あたりの平均コストが体感で分かるようになります。

プロンプトテンプレート — 「短く返して」「箇条書きで」

毎回手で書くのは面倒なので、自分用の定型句 を持っておくと一気に楽になります。CLAUDE.md の一節に書いておけば、Claude が常に意識してくれます。

個人用 CLAUDE.md スニペット例

## 応答スタイル

- 説明は最小限。コードだけ欲しいときは「コードだけ」と指定する
- 質問は 3 案までに絞る。それ以上の選択肢は提示しない
- 修正前後の差分は、==変更箇所だけ== を提示する
- 失敗報告は 1 行で。原因 + 対処 + 影響範囲 のみ
- 提案前に動かしてしまって OK のものは、勝手に動かしてから報告する

この 5 行が CLAUDE.md にあるだけ で、Claude の応答密度が高くなり、出力トークンが目に見えて減ります。

場面別の定型プロンプト

# レビュー依頼
> 以下のコードを 5 行以内でレビュー。
> 重大度高い指摘だけ、それ以下は無視で。

# バグ報告から原因特定
> 以下のエラーの原因候補を 3 つだけ。
> 解決策はまだ提示しないで。

# リファクタ
> 以下のファイルを、ロジック変えずに読みやすく。
> 差分だけ返す。説明は 1 行で。

失敗パターン

最後に、初心者〜中級者が陥りがちな失敗パターンを 5 つ並べておきます。自分のセッションを振り返って、このパターンに該当していないか をチェックしてみてください。

Pattern 1 — 冗長プロンプト

> あの、すいません、もしよかったらでいいんですけど、
> このコードがちょっと動かなくて、なんでかなあと思ってて、
> もし時間あったら見てもらえると嬉しいなと……

丁寧さは無料ではありません。入力トークンとして毎回送信されます。短くても失礼にはなりません（相手は AI です）。

Pattern 2 — 巨大ファイル全文を貼る

> 以下のコードを直して。
（5000 行のファイルを全文貼り付け）

Claude は ファイルパスを言うだけで Read してくれます。貼り付ける必要はありません。貼り付け キャッシュが効かない ので、毎回フルコストです。

Pattern 3 — 試行錯誤の山積み

「あ、違う」「やっぱりこうして」「やっぱり戻して」を 10 回繰り返したセッションは、過去ログ全部が毎回送信 されます。==/compact または /clear== でリセットすべきタイミングです。

Pattern 4 — Opus 常用

「念のため Opus にしておこう」が 月額の最大の敵 です。Sonnet で十分なタスクに Opus を使い続けると、5 倍払い続けます。「=Sonnet で 2 回失敗してから Opus=」のルールを死守してください。

Pattern 5 — /cost を一度も見ない

測らないものは改善しません。1 日 1 回でいいので /cost を眺めましょう。眺めるだけで自然に最適化が走り出します。

Pattern 6 — エラー全文ペースト

スタックトレース 3,000 行をそのまま貼り付ける人がいますが、Claude にとって必要なのは最初の数行と末尾だけ です。

# 悪い例
> エラーが出た
（3000 行のスタックトレースを貼る）

# 良い例
> 以下のエラーが出た。原因候補を 3 つだけ。
（エラーメッセージ本体 + 関連する関数名だけ）

エラー本体だけなら 50 トークン です。スタックトレース全部だと 15,000 トークン です。300 倍違います。

Pattern 7 — 似た指示を別セッションで繰り返す

毎日「README.md を見て今日の進捗を要約して」とやっている人は、同じ前提を毎日キャッシュ作成しています。これは Claude Code のスラッシュコマンド化 や プロジェクトコマンド で 1 行化できます。

# .claude/commands/progress.md に保存
README.md を読んで今日の進捗を 5 行で要約して。

# 使うときは
> /progress

同じプロンプトをスラッシュコマンド にすると、毎回のタイピング時間も、思考のコンテキストスイッチも消えます。

プロンプトキャッシュ をもう一歩深く

もう少しだけ踏み込んだ話題を 1 つ。

プロンプトキャッシュは、Anthropic API のヘッダ anthropic-beta: prompt-caching-2024-07-31 を内部的に使っています。Claude Code はこれを システム部分・CLAUDE.md・最初の Read 結果 に自動で適用します。

つまり、CLAUDE.md を編集した直後の最初のメッセージ は、キャッシュ作成コストとして少し高めになります。が、その後の 5〜10 ターンで回収できる構造になっています。

キャッシュ寿命の数字感

プロンプトキャッシュは 約 5 分間 有効です。これは Anthropic の公式仕様で、5 分以内に同じ先頭プロンプトが再送信されれば、入力単価が約 10% に なります。Sonnet の入力 $3/1M で考えると、$0.30/1M まで下がる計算です。

入力 100,000 トークンを 1 セッションで 10 回送る場合:
- キャッシュなし: 100k × 10 × $3/1M = $3.00
- キャッシュあり: 初回 $0.30 + 9 回 × $0.03 = $0.57
→ ==約 80% 削減==

これだけ差が出るので、キャッシュを意識した書き方 が長期的なコストに与える影響は無視できません。

キャッシュ判定の早見表

ツール権限の絞り込みでもコストが下がる

意外と知られていませんが、Claude が使えるツールの種類 もトークン消費に影響します。Claude は毎ターン、「自分が使えるツールの一覧」をシステムプロンプトの一部として認識しています。MCP サーバを大量に有効にする と、ここのトークン数が肥大します。

MCP サーバの最適化

# 使っていない MCP サーバを無効化
> /mcp
# → 一覧から不要なものを削る

# プロジェクト単位で必要な MCP だけ
# .mcp.json に書く（グローバル設定より優先）

使っていない MCP は無効化 するだけで、毎ターン数千トークン節約できます。

並列処理を意識した依頼方法

Claude Code は 複数のツール呼び出しを並列実行 できます。これを意識した依頼の仕方で、試行錯誤の往復回数 を減らせます。

並列を活かす書き方

# 悪い例（逐次的）
> このファイルを読んで
（読んだ結果を見て）
> このファイルも読んで
（読んだ結果を見て）
> このファイルも

# 良い例（並列ヒント込み）
> 以下 3 ファイルを並行で読んで、共通する設定を要約して。
> - src/config.ts
> - src/env.ts
> - .env.example

1 ターンで複数の Read が走る形にすると、Claude 側で並列実行され、往復のオーバーヘッド が消えます。1 ターン分の入力トークンも 1 回分で済みます。

やってみよう — 1 セッション最適化チャレンジ

最後にハンズオン課題です。今日中に 1 回だけ試してください。

多くの人は、この 1 回の実験で コストが 40〜60% 落ちる のを実感します。実感した経験は記憶に残るので、以後は自然と最適化された使い方に寄ります。

まとめ

このレッスンで押さえてほしい 7 つです。

1. コストは 単価ではなくループ回数で決まる。1 発で終わらせる工夫が最大の節約
2. ==/compact は「要約して引き継ぐ」、/clear== は「忘れてやり直す」。場面で使い分け
3. プロンプトキャッシュは プロンプト先頭の安定性 で決まる。CLAUDE.md は頻繁にいじらない
4. CLAUDE.md は 600 行を超えたら分割。常識を分厚くしすぎない
5. モデル選択は 「Sonnet で 2 回失敗したら Opus」 ルールが実用的
6. 出力指定（「短く」「箇条書き」「説明不要」）は 出力トークン半減 の即効薬
7. ==/cost を 1 日 1 回== 眺める。測らないものは改善しない

<Checklist items={["/cost を最低 1 日 1 回見ている","/compact と /clear を場面で使い分けている","CLAUDE.md が 600 行を超えていない","Sonnet をデフォルトにしている","出力フォーマットを指定する習慣がある","ファイル全文の貼り付けをやめた","プロンプトテンプレートを 3 つ以上持っている"]} />

<Quiz question="Claude Code の /compact と /clear の違いとして最も正しいのはどれ？" options={["/compact は要約して文脈を保ち、/clear は全部リセットする","/compact は無料、/clear は有料","両方とも同じで、どちらを使っても結果は変わらない"]} answer={0} />

<Quiz question="出力トークンを削るのが効果的な理由として正しいのは？" options={["出力は入力の 5 倍の単価なので、削減効果が大きい","出力は無料なので削れば削るほど得","出力トークンはコストに影響しない"]} answer={0} />

次のレッスン 9-3: 月額予算 では、利用パターン別の月額目安と、API 従量制 / Max プランの切り替え判断基準を整理します。