Claude CodeのAPI利用料が跳ね上がる現象が報告されている。コストの正体はAIの賢さではなく、セッションの肥大化にある。
実験データでは、同じ作業でもセッションを分けるだけでコストに31倍の開きが生じる。APIコストを抑えつつ開発を回すための、セッション管理とサブエージェント活用術をまとめる。
SNS運用を自動化しませんか?
ThreadPostなら、投稿作成・画像生成・スケジュール管理までAIがサポート。
開発コストを食いつぶす「セッション肥大化」の正体
Claude Codeの課金対象となる入力トークンのうち、98%以上が「プロンプトキャッシュの読み込み」であるケースが確認されている。キャッシュ単価は低いが、膨大なコンテキストをリクエストのたびに読み直すことでコストが積み重なる。
Claude Codeのコストは「コンテキスト長 × リクエスト数」で決まる。ツールを呼び出すたびにシステムプロンプトや過去のやり取り、読み込んだファイル群がAPIに送り直される。リクエストを重ねるごとにコンテキストは肥大化し、後半のリクエストほど割高になる。
1つのセッションを13日間使い続けた結果、5,065回のリクエストが発生した。適切なタイミングでセッションをリセットした場合と比較すると、同じ作業内容でもコストに31倍の開きが生じる。
しんたろー:
31倍という数字は衝撃だ。僕もThreadPostの開発で「さっきの続きで」とセッションを使い回していたが、これがコストの無駄遣いだった。読み込みコストを放置していたのは甘かった。
ツール呼び出しの84%以上が、1メッセージにつき1件のみという単発のリクエストである。依存関係のないファイル操作や検索を並列で実行せず、細かくリクエストを分けることで、コンテキストの再読み込み回数が増加している。
なぜ僕らは「AIのAPI料金」で沼にハマるのか
コストの約98%を占めるのはキャッシュ読み込みだ。コンテキストが一定量ずつ増え続けるセッションでは、全体の入力量はリクエスト数の2乗に比例する。セッションの後半では、同じツール呼び出しに30倍以上のコストがかかるケースがある。
しんたろー:
13日間もセッションを放置していた。「さっきの続きで」という言葉が、最も高価な贅沢品だったとログを見て気づいた。
タスクが完了したら即座に `/clear` を実行する。これを `CLAUDE.md` にルールとして記載する。巨大なファイルをメインスレッドで開くと、そのサイズ分が以降の全リクエストに乗り続ける。150KBのファイルを読み込むだけで、数千リクエスト後には数十ドルの差が生まれる。
調査やファイル探索はサブエージェントに任せ、メインスレッドには結論と最小限の差分だけを戻す。`CLAUDE.md` に「常時有効な指示」として、巨大ファイルの探索はサブエージェント経由で行うよう明記する。
ここまで読んだあなたに
今なら無料で全機能をお試しいただけます。設定後はAIが投稿案を毎日生成。確認して選ぶだけ。
実務に直結する「AI開発パイプライン」の再定義
開発のルーティンに以下の3つのアクションを組み込む。
第一に、タスク単位でのセッション・リセットを徹底する。新しい機能の実装や調査が完了したら `/clear` を叩く。続きが必要なら、数行のメモと変更対象のファイルパスだけを引き継ぐ。
第二に、サブエージェントの強制活用だ。巨大な仕様書や依存関係の多いコードベースの調査は、調査専用のサブエージェントを定義して行う。メインのコンテキストを汚さない設計を維持する。
第三に、「3行テンプレート」による依頼の標準化だ。プロンプトの冒頭に「範囲・触らない・完了条件」を明記する。「終わったら変えたファイルの一覧を出して止まる」という一文で、無駄なリクエストを遮断する。
しんたろー:
`/clear` を打つたびに最初から説明し直す手間を感じる。しかし、ログでコストの推移を見るとその感情は消える。開発者としての直感より、jsonlのログの数字を信じるのが節約の近道だ。
チーム開発では、モデルの手前にプロキシを置き、利用者ごとの利用実績を記録する構成を検討する。AIの使いすぎを止める手段を持たないまま組織で導入するのは、蛇口を全開にしたまま水道代を気にしている状態に近い。
よくある質問
Claude Codeのコストを抑えるために、まず何をすべきですか?
セッションの寿命を短くすることです。タスクが完了するたびに `/clear` コマンドを実行し、肥大化したコンテキストをリセットしてください。また、巨大なファイルや調査作業は `code-explorer` のようなサブエージェントに切り出すことで、メインのコンテキスト汚染を防ぎ、再読み込みコストを削減できます。
AIに作業を依頼する際、コストと精度のバランスはどう取ればいいですか?
「範囲・触らない・完了条件」の3行テンプレートを依頼の冒頭に貼ってください。不要なファイルの変更を防ぎ、無駄なリクエストを抑制できます。依存関係のないツール呼び出しは1つのメッセージにまとめることで、リクエスト回数自体を減らす工夫も有効です。
チーム開発でAIエージェントを導入する際の注意点は?
「誰がどれだけ使ったか」の可視化が不可欠です。モデルの手前にプロキシを配置し、利用者ごとのレート制限や利用実績を記録する構成を検討してください。まずは開発チーム内でコスト意識を共有し、運用ルールを定めることから始めてください。
まとめ
AIエージェントのコストはAPI単価ではなく運用設計で決まる。13日間同じセッションを回し続けるのか、タスクごとに `/clear` でリセットするのか。この習慣の差が、数倍から数十倍のコスト変動を生む。
コンテキストを汚さないサブエージェントの活用や、3行テンプレートによる依頼の最適化など、AIを制御可能なツールとして扱うエンジニアリングが求められる。ログを分析し、コストを支配する運用ルールを自分の開発環境に組み込む。

この記事が参考になったら、ThreadPostを試してみませんか?
投稿作成・画像生成・スケジュール管理まで、AIがサポートします。
ThreadPostをもっと知る