Claude Code トークン節約 — 月 ¥3,000 超えで先回りした設定 6 つの記録

結論から：Claude Code を個人開発で使い始めて API 費用が気になってきたなら、この設定 6 つを先に入れてほしい。CLAUDE.md の最小化・/clear 習慣・サブエージェントによるコンテキスト分離 — この 3 つだけで消費量は大きく変わります。「そろそろ月 ¥3,000 を超えそうだ」と感じた段階で先回りした実装の記録です。

設定なしで Claude Code をエージェントモードで使い続けると、API 費用は静かに積み上がります。Anthropic 公式単価（Sonnet 4：入力 $3/MTok・出力 $15/MTok）ベースで試算すると、1 日 10 セッション動かした場合の月額は $60〜$150（¥9,000〜¥22,500 相当）になりえます。「そんなに使わない」と思っていても、エージェントモードは想像より多くのトークンを消費します。

本記事では今すぐ入れられる 6 つの設定 を順に解説します（応用 3 つは末尾に補足）。先回りで入れた場合の費用感の変化を Anthropic 公式単価ベースで試算すると次のとおりです。

	設定なし（目安）	6 つ設定後（目安）
月 API 換算	$60〜$150	$15〜$40
月費用（¥150/$ 換算）	¥9,000〜¥22,500	¥2,250〜¥6,000

※ Anthropic 公式単価 + 1 日 10 セッション想定の試算。実際の消費量は用途・モデルにより異なります。

結論：トークン節約は「9つの工夫の積み重ね」で実現する

結論を先に書きます。Pro プランの範囲内に Claude Code 運用を収める鍵は、次の 9 つの工夫の組み合わせです。

Max プラン定額 で従量課金から脱出
CLAUDE.md を最小化 して毎回のオーバーヘッドを削減
Skills でプロンプトを再利用 してコピペの繰り返しをやめる
サブエージェントでコンテキスト分離
MCP で外部情報を必要時だけ取得
長いログは tail で切る
/clear をこまめに使う
画像・PDF は事前にテキスト化
不要な再生成を避けるための Hooks

順に解説します。

工夫1：Max プラン定額に切り替える

最重要かつ最大の節約効果はこれです。

API 従量課金は Sonnet 4 で入力 $3/MTok、出力 $15/MTok。並列エージェントを多めに走らせると月 $200 = Max 20x 相当を簡単に超え得ます。Max プラン（月 $100 / $200）なら定額で予算が読みやすくなります。

判断基準：API 換算で月 $50 を超える消費が続くなら Max への移行検討タイミング。さらに $200 を超えるなら Max 20x が安くなる計算です（公式単価ベース）。

工夫2：CLAUDE.md を最小化する

CLAUDE.md は 毎セッションで読み込まれる ため、ここに書いた文字数 × セッション数だけトークンを消費します。

例えば 5,000 字の CLAUDE.md があり、1 日 10 セッション動かすと、それだけで CLAUDE.md ぶんだけで毎月 100 万トークン超を消費する計算になります（5,000 字 × 10 × 30 日 ≒ 150 万）。

節約のコツ：

必須ルールだけ書く
プロジェクト固有の詳細は docs/ 配下に分けて、必要時だけ参照させる
一般的な技術知識は書かない（Claude は知っている）
削れるものは削る、迷ったら削る

工夫3：Skills でプロンプトを再利用

「コミット前にこの順でチェックして」「マイグレーションを作る前にこれを確認して」のような 繰り返しプロンプト を Skill 化します（Ep.01参照）。

これで毎回コピペしていたプロンプトのトークン消費がゼロになります。Skills は呼び出されたときだけロードされるので、CLAUDE.md と違って「常時オーバーヘッド」になりません。

工夫4：サブエージェントでコンテキスト分離

Ep.03 で扱ったサブエージェントは、トークン節約観点でも重要です。

例えば「競合 SaaS 5本のドキュメントを読んで比較する」作業をメインの Claude にやらせると、5サイトのコンテンツ（数万トークン）がメインのコンテキストに残り続けます。researcher サブエージェントに委譲すれば、メインに返るのはサマリー数百トークンだけ。コンテキスト効率が10〜50倍 になります。

工夫5：MCP で外部情報を必要時だけ取得

「DB の現在の状態を毎回 CLAUDE.md に書く」みたいな運用は最悪です。情報が古くなる上に毎回トークンを消費します。

代わりに自作 MCP（Ep.02参照）で get_db_schema のようなツールを実装し、Claude が必要なときだけ呼び出すようにします。取得時にしかトークンを使わない ので圧倒的に効率的です。

工夫6：長いログは tail で切る

npm test の出力を全部 Claude に渡すと、数千トークンを一瞬で消費します。

# 悪い例
claude "$(npm test)"

# 良い例
claude "$(npm test 2>&1 | tail -30)"

エラーの本質は最後の数十行に集約されていることがほとんどです。tail で切るだけでトークン消費を90%削減できます。

工夫7：/clear をこまめに使う

長い会話を続けると、過去の文脈がすべて毎回再送信されます。区切りの良いタイミングで /clear を叩いて履歴をリセットしてください。

特に 「別のタスクに移るとき」 は必ずクリア。これだけで1セッションあたり数万トークンの節約になります。

工夫8：画像・PDF は事前にテキスト化

Claude に画像を直接渡すと、内部で大量のトークンを消費します（画像1枚で数千トークン相当）。

PDFや画像は、事前に OCR またはテキスト抽出ツールで .txt 化しておき、テキストとして渡すのが圧倒的に節約効率が良いです。

工夫9：不要な再生成を避けるための Hooks

Claude は時々「念のため再実装する」という挙動を取ります。これを Hooks で制御します。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "test -f \"$CLAUDE_FILE_PATH\" && echo 'File exists, considering reuse' || true"
          }
        ]
      }
    ]
  }
}

このような Hook で「既存ファイルがある場合は警告」を出すことで、無駄な再生成を抑制できます。

Anthropic は Max プランを公式に「需要の高いプロジェクト向けの拡張アクセス」として位置付けており、月額 $200/月（年契約割引あり）で Claude Code が含まれます。公式の「Manage costs effectively」ドキュメントによれば、Max プランは API 従量課金と比較して高負荷ユーザーに対して大幅にコスト効率が良い設計で、Claude Code を本格運用するヘビーユーザーは Max プランへの移行が推奨されています。コスト管理のベストプラクティスとして、Anthropic は CLAUDE.md の最小化、サブエージェントによるコンテキスト分離、/clear での履歴リセット、画像/PDFの事前テキスト化などをガイドしています。

出典: Max plan | Claude by Anthropic / Manage costs effectively - Claude Code Docs / Plans & Pricing

落とし穴：節約しすぎると逆効果

トークン節約を追求しすぎると、逆に開発効率が落ちることがあります。

落とし穴1：CLAUDE.md を削りすぎてプロジェクト理解が不足する

毎回「プロジェクト構成を確認して」から始めると、結局トークンを消費します。節約するべきは「不要な情報」だけ、必要な情報は残します。

落とし穴2：/clear しすぎて会話の流れが切れる

連続した作業の途中で /clear すると、Claude が先ほどまでの文脈を完全に失います。論理的な区切りでだけ /clear する習慣を。

落とし穴3：サブエージェントを乱用してオーバーヘッドが増える

サブエージェント起動には固定オーバーヘッドがあります。10秒で終わる作業を委譲しても割に合いません。5分以上かかる作業だけ 委譲するのが目安です。

で、どう稼ぐ？ — トークン節約は「副業時間の確保」と等価

トークン代を月¥7万節約することは、単なるコスト削減ではありません。個人開発に投資できる時間と金額が増えること を意味します。

1. 節約分を新規 SaaS の検証コストに回せる

月¥7万の節約 = 新しい SaaS を1本立ち上げる原資。Ep.06 の7日パイプラインを月1本回せる計算になります。

2. Maxプラン定額化でストレスフリーに開発できる

「今月いくら使ったかな」と気にしながら開発するのは精神的に消耗します。定額化すれば「使い切る」発想に変わり、実験回数が増え、結果的に当たりを引きやすくなります。

3. クライアント案件でコスト見積もりが正確になる

受託案件で「Claude のトークン代が読めない」というリスクが消えます。月¥3万固定で見積もれるので、提案時の安心材料になります。

まとめ

Pro プランの範囲内で並列エージェントを回す運用は、9 つの工夫の積み重ねで実現できます。重要ポイントは次のとおり。

最大の節約は Max プラン定額化（消費量がそこまで来たら）。API 換算で月 $50 超なら Max 5x、$200 超なら Max 20x が安い計算
CLAUDE.md を最小化 して毎セッションのオーバーヘッドを削減
サブエージェント・MCP・Skills の3点セット で「必要なときだけトークンを使う」設計に
節約しすぎると逆効果。バランスを見ながら導入する

次のエピソードでは、Claude Code を使った GitHub Issue → PR の自動化フローを解説します。Ep.08 もまた無料記事です。

Claude Code を本格活用するなら Max プラン（月$100〜、定額でトークン使い放題）が必須です。このシリーズの全実装例は Max プランで動作確認済みです。

Claude Maxプランを確認する