Claude Codeの出力が重くなる原因は、モデルの能力不足ではありません。コンテキストに背負わせる情報が多すぎることです。そこで効くのが、バックエンドの知識や操作手順を本体から切り離し、必要なときだけ呼び出す設計です。

この記事では、InsForge SkillsとCLIを使ってClaude Codeのコンテキストを軽くする考え方を整理します。

  • 何を本体に残し、何を外に逃がすか
  • なぜトークン削減とエラー減少が同時に起きるのか
  • SkillsとCLIをどう役割分担させるか
  • 導入時に詰まりやすい点

https://x.com/_avichawla/status/2046685172666712571

先に結論

Claude Codeを速く、安く、安定して使いたいなら、プロンプトを削るより先に知識の置き場所を変えるべきです。InsForgeのようなバックエンド基盤をSkillsとCLIで分離すると、モデルは「全部を覚える役」から「必要な操作だけ実行する役」に変わります。結果として、毎回の会話に大量の説明を貼り直す必要がなくなります。

今回のネタでも、Claude Codeのトークン使用量を3分の1に落とし、エラーをゼロにしたという報告がありました。数字だけを見ると派手ですが、やっていることは単純です。バックエンドの文脈を会話に埋め込まず、外部の手順と道具に寄せています。

何がボトルネックか

Claude Codeのようなエージェント型ツールは、会話のたびに前提を積み上げがちです。APIキー、認証、DB操作、ストレージ、関数の呼び出し方まで毎回説明すると、トークンはすぐ膨らみます。しかも説明が長いほど、手順の一部が抜けたり、順番を間違えたりします。

問題は「賢さ」ではなく「保持の仕方」です。モデルに長文を読ませ続けると、推論に使える余白が減ります。反対に、定型の操作をCLIに寄せれば、モデルは判断だけに集中できます。

InsForgeが効く理由

InsForgeは、AI-assisted development向けのバックエンド基盤です。公式ドキュメントでは、PostgreSQL、認証、S3互換ストレージ、Edge Functions、AI統合をまとめて提供し、AIエージェントが扱いやすい形で見せると説明されています。

この構造が重要です。バックエンドの操作を「人間が読む説明書」ではなく「機械が扱う手順」に変えるからです。Claude Codeにとっては、毎回DB設計を長々と説明されるより、必要なコマンドと役割だけが渡される方がずっと扱いやすいです。

CLIは実行係、Skillsは判断の補助と考えると整理しやすいです。CLIは状態確認、作成、リンク、デプロイなどの実操作を担います。Skillsは、そのCLIをいつどう使うかを短く教える役に徹します。結果として、モデルが抱える文脈は小さく保てます。

トークンが減る仕組み

トークン削減の本質は、情報の再利用です。毎回同じ説明を会話に書くと、そのたびに課金対象が増えます。Skills化しておけば、手順は別ファイルに退避できます。Claude Codeは必要なときだけその知識を読み込みます。

このとき重要なのは、Skillsに入れる内容を「長い説明」ではなく「短い意思決定ルール」にすることです。

  • この作業はCLIでやる
  • この状態なら whoami を先に確認する
  • project未接続なら current を見る
  • 認証が切れていれば login に進む

こうしたルールだけでも、会話の往復はかなり減ります。モデルは手順を再発明しなくてよくなり、失敗したときのやり直しも短くなります。

エラーが減る理由

エラーがゼロに近づくのは、モデルが賢くなったからではありません。失敗しやすい判断を人間が先に固定しているからです。

たとえば、バックエンド操作でよくある事故は次の3つです。

  • 認証済みかどうかを確認せずに進む
  • どのプロジェクトに紐づいているかを見ない
  • 既存環境と新規作成を取り違える

CLIベースの設計にしておけば、最初に状態確認を挟めます。ここで失敗を止めれば、後続の操作が壊れません。AIに自由に推測させるより、決め打ちのガードを置く方が実務では強いです。

どう導入するか

導入の順番はシンプルです。最初から全部をSkills化しないことが大事です。

  1. まず、毎回説明している定型作業を洗い出します。
  2. 次に、その作業をCLIの1コマンド単位に分けます。
  3. 最後に、判断だけをSkillsに残します。

この流れなら、Claude Codeの会話は短く保てます。操作の詳細はCLIに、判断の入口はSkillsに、という分担ができます。

InsForgeのような基盤は、この分担と相性がいいです。バックエンドを一つの文脈として持たせるのではなく、認証、DB、ストレージ、関数を個別に扱えるからです。

向いている場面

このやり方が特に効くのは、同じ種類の変更を何度も回すチームです。たとえば、開発環境の初期化、DBの確認、関数のデプロイ、ストレージの点検のような作業です。

逆に、毎回まったく違う手順が必要な仕事では、Skills化の効果は小さくなります。定型化できる部分が多いほど、分離設計の価値は上がります。

まとめ

Claude Codeを軽くしたいなら、プロンプトを磨く前に文脈の置き場を変えるべきです。InsForge SkillsとCLIの組み合わせは、そのための実践的な型です。モデルに全部を覚えさせず、実行はCLIに、判断はSkillsに寄せる。この分離だけで、トークン、速度、安定性は同時に改善します。