Claude Code Skillsのコンテキストコストを削減する方法

Claude Code Skillsのうち、実際の作業に役立っていないのにコンテキストを消費するものを、いまでは特定できます。しかも、Claude Codeの本番ワークフローに必要な指示を捨てずに、その負担だけを取り除けます。新しい /skill-doctor レポートによって、勘に頼っていたスキル整理を、計測できて元にも戻せる運用習慣へ変えられます。

結論から言えば、/skill-doctor を実行し、未使用の各スキルを「失った場合の影響」で分類して、最も破壊性の低い表示設定を適用し、新しいセッションで検証します。最初からフォルダーを削除してはいけません。一週間使われなかったスキルでも、デプロイやインシデント対応の安全を支える存在かもしれないからです。

2026年9月4日にリリースされたClaude Code 2.1.261では、読み込まれたスキルのうち使われていないものと、それぞれが消費するコンテキストを確認できる /skill-doctor が追加されました。これは重要な変更です。各スキルは名前と、通常は説明文も毎ターン提示されるため、Claude が完全な指示を一度も呼び出さなくても、コンテキストを使い続けるからです。

Claude Code Skillsのコンテキストコストとは

スキルのコンテキストコストには二種類あります。ここを混同すると、整理の判断を誤ります。

一つ目は一覧表示コストです。入力を始める前から、Claudeには利用可能なスキルの名前と説明が提示され、依頼に合うスキルを選べるようになっています。Anthropicはこの一覧を、デフォルトでモデルのコンテキストウィンドウの1%までに制限しています。また、各スキルの description と when_to_use を合わせたテキストは、デフォルトで最大1,536文字です。

二つ目は呼び出しコストです。SKILL.md の本文全体が読み込まれるのは、ユーザーまたはClaudeがそのスキルを呼び出したときだけです。ただし、一度読み込まれると、その後のターンでも会話内に残ります。コンパクション後、Claude Codeは呼び出し済みスキルごとに最大5,000トークン、全スキル合計で最大25,000トークンを再付加できます。

一覧を店先のショーウィンドウ、スキル本文を注文後にカウンターへ運ばれる在庫だと考えると分かりやすいでしょう。看板はすべて通りのスペースを使います。在庫はさらに大きな場所を取りますが、誰かが求めたときにだけ出てきます。

この違いによって、取るべき対策も変わります。説明が長い未使用スキルは、一覧表示のたびにコストを生みます。頻繁に呼び出される巨大なスキル本文は、セッション全体に残るコストを生みます。/skill-doctor が特に得意なのは前者の発見であり、後者には優れたスキル設計が必要です。

導入数ではなく、ターンごとに効くコスト

使われていないスキルは、導入時に一度だけ発生する費用ではありません。会話が進むたびに、その一覧テキストが再び提示されます。実務では、次の式を目安にできます。

一日に回避できるコンテキスト = 一ターンあたりの未使用一覧トークン数 × 一日のClaudeターン数

たとえば、レポートで未使用の一覧コンテキストが2,000トークン見つかり、一日の作業で40回のモデルターンが発生するなら、その日に提示される入力は80,000トークンです。これは説明用の例であり、ベンチマークではありません。プロンプトキャッシュによって繰り返し部分の課金単価が下がることはありますが、コンテキスト自体が消えるわけではありません。

APIやクラウドプロバイダー経由で利用している場合、余分なトークンは請求額に影響します。サブスクリプション利用者の場合はプランの利用枠を消費し、コンパクションまでに作業へ使える余地を減らします。Anthropicによると、企業でのClaude Code導入コストは、アクティブな開発者あたり一日平均約$13、月額$150〜$250です。スキルの無駄は支出の一部にすぎませんが、いまでは名前単位で切り分けられる数少ない要素の一つになりました。

圧迫されるのはモデル利用料だけではありません。開発者の処理能力にも響きます。一覧が過密になると、Claude Codeは利用頻度の低いスキルから説明を落としてスペースを確保することがあります。コンテキストは節約できますが、そのスキルをClaudeが自動選択しにくくなるという代償があります。

削る・再実行する・戻す：安全な七つのステップ

最も安全な進め方は、次の七段階です。

1. 最新のターミナルセッションから始める

Claude Codeを2.1.261以降へ更新し、claude --version でインストール済みバージョンを確認します。Anthropicのリファレンスでは /skill-doctor の要件は2.1.252以降とされていますが、このコマンドが変更履歴で発表されたのは2.1.261です。

セッションを実行しているマシンのターミナルで /skill-doctor を実行します。対話セッションでは、レポートは /plugin マネージャーのStatsタブに開きます。-p を使う非対話モードならテキストとして出力されるため、ローカル監査用に保存できます。Remote Controlではレポートを取得できません。

2. 変更前の基準値を記録する

何かを変更する前に、スキル一覧の総コスト、未使用項目のうち負担が大きいもの、変更予定のスキルまたはプラグインという三点を保存します。さらに /context を実行して、予算適用後のSkills行を確認し、/doctor で一覧の最大要因を特定します。

モデル、キャッシュの挙動、契約単価が分からないまま、トークン数をそのまま金額へ換算してはいけません。安定した単位としてトークンを使い、費用は別に計算します。

3. 候補を「失敗時の損失」で分ける

各候補を次の三グループに分類します。

ここでは、レポートだけでなく人の判断が必要です。「一度も呼び出されていない」が示すのは頻度であって、価値ではありません。消火器は使われていなくても、備えておく意味があります。

4. 最も破壊性の低い設定を使う

ローカル、個人、プロジェクト、同期済みの各スキルでは、/skills メニューから、元へ戻せる skillOverrides の変更を .claude/settings.local.json に書き込めます。

• Claudeにスキルの存在だけを知らせ、一覧に詳しい説明を載せる必要がない場合は name-only を使います。
• user-invocable-only は、/skill-name を残しつつ、自動選択をさせたくない場合に使います。
• ユーザーにもClaudeにも見せる必要がない場合に限り off を使います。
• 元の動作へ戻すには on を使います。

自分で管理するスキルなら、disable-model-invocation: true が、ユーザーだけが呼び出せるポリシーを作成者側で持たせる方法です。Claudeの一覧から説明を外しながら、直接呼び出す手段は残せます。

プラグインのスキルは扱いが異なり、skillOverrides は適用されません。アンインストールせずに無効化するには /plugin disable plugin-name@marketplace-name、元に戻すには /plugin enable plugin-name@marketplace-name を使います。プラグインはエージェント、フック、MCPサーバー、言語ツールも提供している可能性があるため、無効化する前に構成要素を確認してください。

5. 能力を落とさずに本文を小さくする

有用なスキルの本文が大きい場合は、SKILL.md を案内図として簡潔に保ち、詳しい例、APIリファレンス、エッジケースを補助ファイルへ移します。Anthropicは SKILL.md を500行未満に収めることを推奨しています。補助ファイルはClaudeが必要としたときだけ読み込まれ、ヘルパースクリプトはソースをプロンプトへ載せずに実行できます。

仕事の目的、トリガー、譲れないルール、補助ファイルへの案内は冒頭近くに置きます。コンパクション後に再付加される各スキルの先頭5,000トークンだけが保持される場合にも、重要な部分を守れます。

6. 新しいセッションで検証する

スキルを変更しても、現在の会話にすでに読み込まれた指示は消えません。新しいセッションを開始し、そのスキルが発動すべきプロンプトをいくつか試して、スキルを隠した状態で同じプロンプトを実行した結果と比較します。まずタスクの成否を測り、その次にトークンを見ます。

Anthropicが新しいセッション同士の比較を推奨するのは、作成時の情報や以前のスキルコンテキストが残っていると、そのスキルが本当に生む効果を見誤るためです。プラグイン変更に /reload-plugins が必要な場合は、次のリクエストでトークンコストが発生し、プラグインが遅延読み込みでないMCPツールを公開していれば、プロンプトキャッシュの再構築も起こり得ます。

7. 問題があれば戻し、監査を再実行する

品質が下がったら、一段階だけ元へ戻します。off から user-invocable-only へ、ユーザー限定から name-only へ、または無効化したプラグインを有効へ戻します。品質を保てたなら、軽量化した状態を維持し、実際の仕事を十分に行った後で /skill-doctor をもう一度実行します。

最後の再確認は欠かせません。目標はスキル一覧を限界まで小さくすることではなく、繰り返し発生する仕事を正しく振り分けられる範囲で、最も低コストな一覧を作ることです。

Claude Codeのコンテキスト削減で効果が大きい人

次のユースケースは、期待できる経済効果が大きい順に並べています。

1. 共通のClaude Code環境を管理するプラットフォームチーム

数十人の開発者を抱えるプラットフォーム責任者なら、試験グループにローカルの /skill-doctor レポートを書き出してもらい、どの環境にも存在するのに一度も発動しないスキルを特定できます。そのうえで、任意のワークフローをユーザー限定またはプロジェクト限定に移します。効果は開発者の全ターンに積み上がり、復元用ファイルがあるので実験も元へ戻せます。企業管理のスキルはレポート対象外のため、これはポリシー全体の監査ではなく、各ローカル環境を抽出した調査になります。

2. プラグインを多用する開発チーム

一度の移行作業のために導入したプラグインが、その後何か月もスキル、エージェント、フック、MCPツールを有効にしたまま残ることがあります。/skill-doctor は最近使われていないプラグインを明らかにし、プラグインマネージャーならアンインストールせずに無効化できます。未使用プラグインがコンテキストを持つ複数の構成要素を追加している場合、効果はスキル説明の削減だけにとどまりません。ただし影響範囲も同じく広く、無効化によってスキル以外の有用な機能まで消える可能性があります。

3. 顧客ごとに技術スタックが変わるコンサルタント

コンサルタントは、現在の顧客には一種類しか関係しないのに、フロントエンド、データ、eコマース、インフラのスキルをすべてグローバルで抱えがちです。ローカル設定に名前付きプロファイルを用意し、必要なグループだけを公開しつつ、まれに使う安全関連のワークフローはユーザー限定で残せます。毎週ツールキットを組み直さずに、案件ごとにすっきりしたコンテキストから始められます。

4. 大規模モノレポの保守担当者

Claude Codeは、より深いディレクトリを読み進めるとネストされたスキルを検出し、それらはセッションの残りの時間も利用可能なままになります。モノレポの保守担当者は、複数パッケージにまたがる作業後に監査し、パッケージ固有の指示を適切なネスト先へ移し、ルート階層の説明を短くできます。これにより振り分けが改善し、バックエンド作業に大量のフロントエンド用ワークフロー説明が付いてくる状態を避けられます。

5. 低頻度で重要度の高いコマンドを持つチーム

デプロイ、ロールバック、データ移行、インシデント対応のスキルは、何週間も発動しないことがあります。レポートで未使用と表示されたからといって、削除すべきではありません。手動限定にすれば、Claudeが毎回見る一覧から説明を外しつつ、正確な /skill-name という緊急時の呼び出し手段を残せます。通常セッションのコンテキストを減らしながら、非常時に手順書を作り直す必要もありません。

6. 参照情報の多いスキルを作る人

スキル作成者は、レポートで高コストなスキルを見つけ、長い例や仕様を補助ファイルへ分割できます。メインファイルは簡潔な判断マップになります。必要な分岐に到達したときだけ詳細が読み込まれるため、コンテキストコストの発生を遅らせられます。

7. サブスクリプション上限を意識する個人開発者

ProやMaxでは利用料がサブスクリプションに含まれるため、個人開発者には直接的な支出削減が見えないかもしれません。得られるのは、同じ利用枠で進められる仕事の増加と、コンパクションまでの余裕です。/skill-doctor と無駄のないClaude Code環境を組み合わせ、無関係な作業へ切り替えるときはセッションをクリアします。

Claude Code Skillsを生かした三つのプロダクト案

新しい検索語の見た目以上に、市場は広がっています。DataForSEOによると、米国で claude code skills は月間12,100回検索され、CPCは$8.26です。スキルのコンテキスト削減に絞った検索フレーズには候補が返らなかったため、これは成熟した独立カテゴリではなく、すでに確立したスキル市場に生まれた新鮮な機会だと考えられます。

1. Skill Budget Guard：最有力案

リポジトリ内のスキル、表示設定、書き出した /skill-doctor レポートを読み取り、プルリクエストごとのコンテキスト増減を示す、ローカル優先のCLIとCIチェックを作ります。一人の開発者による整理を、チームで繰り返せる予算管理へ変えられるため、プラットフォームチームが対価を払うプロダクトになります。

需要の根拠は非常に明確です。claude code skills の月間検索数は12,100、CPCは$8.26で、Anthropicが示す企業向けClaude Codeの平均コストは開発者あたり月額$150〜$250です。販売可能な最小構成には、ローカルパーサー、リポジトリに保存する予算ファイル、GitHub Action、「ユーザー限定へ移す」「参照情報を分割する」といった元に戻せる提案が必要です。

率直な弱点は、プラットフォーム側の機能拡張リスクです。Anthropicは /skill-doctor を拡張できますし、Analytics APIは対象組織へすでに無料提供されています。防御力を持つのは、ポリシーの履歴、リポジトリ横断の比較、コンテキスト削減後もタスク成功率が落ちなかったことの証明です。

2. Project Skill Profile Switcher

frontend、data、incident、release といった名前付きプロファイルを用意し、skillOverrides とプラグインの有効・無効設定をまとめて適用した後、一つのコマンドで以前の状態へ戻せるようにします。買い手はコンサルタントとモノレポ運用チームです。

DataForSEOによると、best claude code skills は月間590回検索され、商用意図があり、CPCは$11.91です。MVPには、マニフェスト、差分プレビュー、ローカル設定への安全な書き込み、プラグイン操作、復元用チェックポイントが必要です。弱点は参入障壁の低さです。Claude Code自体のメニューに基礎機能がすでにあり、プラグインの再読み込みで一ターン分のキャッシュコストが加わる場合もあります。

3. Skill Outcome Lab

スキルを有効にした新規セッションと、無効にした新規セッションへ、同じ現実的なプロンプトを送り、成功率、所要時間、トークン使用量を比較するテストランナーを作ります。スキル作成者や社内イネーブルメントチームは、指示が消費コンテキストに見合うと証明するために費用を払います。

DataForSEOによると、claude code skills best practices は月間110回検索され、商用意図があり、ページ上部入札額は$4.14〜$6.01です。実用的なMVPには、プロンプトのフィクスチャ、期待出力のチェック、新規セッションの分離、簡潔な前後比較レポートが必要です。

決定的な弱点もあります。Anthropic公式のskill-creatorプラグインは、スキルありとなしの実行をすでにベンチマークできます。したがって、これは独立した事業ではなく、Skill Budget Guard内の一機能にすべきです。

チームでプロダクトやエージェントをまたいでスキルを配布する場合は、Notion SkillsとClaude Skills APIの比較を読むと、判断に必要なガバナンス面も補えます。

/skill-doctor だけでは解決できないこと

/skill-doctor はスキル一覧の無駄を見つけるプロファイラーであり、Claude Code全体のコスト最適化ツールではありません。

• 組み込みスキルや企業管理のスキルは監査しません。
• 現在の会話にすでに読み込まれたスキル本文は削除しません。
• CLAUDE.md、過去の会話履歴、モデル選択、思考トークン、冗長なツール出力、MCPのオーバーヘッドは測定しません。
• Remote Control経由では利用状況レポートを返せません。
• 低頻度のスキルが高額な失敗を防いだかどうかは判断できません。
• キャッシュされたコンテキストを無料にはしません。キャッシュ料金とコンテキスト占有量は別の問題です。

最初から skillListingBudgetFraction を下げてはいけません。一覧が予算を超えると、Claude Codeは名前を残したまま、利用頻度の低いスキルから説明を削除します。一覧テキストは減りますが、必要なスキルが発動しにくくなる恐れがあります。価値の低い項目を意図的に削除するか隠してください。

もう一つの誤りは、プラグインを見つけ次第アンインストールすることです。まず無効化して検証し、ほかの構成要素も不要だと分かってからアンインストールします。

月曜日にまず行うこと

実際のリポジトリを一つ選び、Claude Codeを頻繁に使う開発者を一人決めます。/skill-doctor を実行して、未使用項目のうち負担が大きい上位五つを記録し、そのうち二つだけを変更します。低頻度のワークフローを一つユーザー限定にし、本当に不要なプラグインを一つ無効化してください。新しいセッションを始め、通常のタスクを三つ繰り返し、結果が変わったものは元へ戻します。これなら、エージェントの能力をひそかに落とすだけの整然とした設定ではなく、根拠のあるコンテキスト節約ポリシーを金曜日までに作れます。

Claude Codeのコンテキスト使用量を減らすには？

/skill-doctor で未使用スキルの一覧コストを見つけ、/context で全体の内訳を確認します。不要なスキルは隠し、低頻度のワークフローはユーザー限定にし、長い参照情報は補助ファイルへ移し、無関係なタスクの切り替え時には /clear を使います。

Claude Codeのコストを最小化するには？

まず繰り返し載るコンテキストを減らし、その後でモデル選択、長時間のセッション、思考設定、冗長なツール出力、未使用のMCPサーバーを見直します。/skill-doctor が扱うのは、その費用のうちスキルに関する部分だけです。

Claude Code Skillsは無料ですか？

Anthropicのスキル文書には、ローカルの SKILL.md に対する個別料金は記載されていません。ただし、名前と説明は毎ターンのコンテキストを消費する可能性があり、本文全体は呼び出し後にコンテキストを使います。API利用者はトークン使用量に応じて支払い、サブスクリプション利用者はプランに含まれる利用枠を消費します。

Claude Codeのコンテキストをコンパクトにするには？

長いタスクの継続性を保ちたいときは /compact、無関係な作業へ切り替えるときは /clear を使います。呼び出し済みのスキル本文はコンパクション後に再付加されることがあり、上限はスキルごとに5,000トークン、合計25,000トークンです。

Claude Codeでコンテキストをクリアすべきですか？

はい。無関係なタスクへ移るときはクリアすべきです。スキル整理の検証でも新しいセッションが重要です。古い会話に読み込み済みのスキル本文が残っていると、無効化した効果が見えなくなるためです。

エンジニアリングチーム向けに、計測可能なスキルガバナンスの仕組みを導入したい場合は、AI本番システムをご覧ください。