【第7回】Claude Code トークン節約運用 — Pro プランの範囲で並列エージェントを回す 9 つの工夫

「Claude Code は便利だけど、トークン代がいくらかかるか怖い」——多くの個人開発者が抱える悩みです。

筆者は masatoman.net + 周辺自動化を Claude Code Pro（$20/月）の範囲内で回す方針で運用しています。並列エージェントを多めに走らせるとあっという間に上限に近づくので、トークン節約は固定費を読みやすくするための重要な工夫です。

この記事では、Pro プランの範囲内で並列エージェントを動かし続けるための 9 つの工夫を、実装手順と判断軸つきで整理します。1 つでも導入すれば、Max への移行を遅らせる or 移行後のコストを抑えられるはずです。

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

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

1. Max プラン定額 で従量課金から脱出
2. CLAUDE.md を最小化 して毎回のオーバーヘッドを削減
3. Skills でプロンプトを再利用 してコピペの繰り返しをやめる
4. サブエージェントでコンテキスト分離
5. MCP で外部情報を必要時だけ取得
6. 長いログは tail で切る
7. /clear をこまめに使う
8. 画像・PDF は事前にテキスト化
9. 不要な再生成を避けるための 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 で「既存ファイルがある場合は警告」を出すことで、無駄な再生成を抑制できます。

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

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

落とし穴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 プランで動作確認済みです。