💼 Context Budget
Claude Codeが利用する文脈情報(
📺 まず動画で見る(YouTube)
▶ 【自動化】AIガチ勢の最新活用術6選がこれ1本で丸分かり!【ClaudeCode・AIエージェント・AI経営・Skills・MCP】 ↗
※ jpskill.com 編集部が参考用に選んだ動画です。動画の内容と Skill の挙動は厳密には一致しないことがあります。
📜 元の英語説明(参考)
审核Claude Code上下文窗口在代理、技能、MCP服务器和规则中的消耗情况。识别膨胀、冗余组件,并提供优先的令牌节省建议。
🇯🇵 日本人クリエイター向け解説
Claude Codeが利用する文脈情報(
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o context-budget.zip https://jpskill.com/download/694.zip && unzip -o context-budget.zip && rm context-budget.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/694.zip -OutFile "$d\context-budget.zip"; Expand-Archive "$d\context-budget.zip" -DestinationPath $d -Force; ri "$d\context-budget.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
context-budget.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
context-budgetフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
💬 こう話しかけるだけ — サンプルプロンプト
- › Context Budget で、私のビジネスを分析して改善案を3つ提案して
- › Context Budget を使って、来週の会議用の資料を作って
- › Context Budget で、現状の課題を整理してアクションプランに落として
これをClaude Code に貼るだけで、このSkillが自動発動します。
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
コンテキスト予算
Claude Code セッションで読み込まれている各コンポーネントのトークンコストを分析し、コンテキストスペースを回収するための実用的な最適化提案を提供します。
使用時機
- セッションのパフォーマンスが遅い、または出力品質が低下していると感じる場合
- 最近、多くのスキル、エージェント、または MCP サーバーを追加した場合
- 実際にどれくらいのコンテキストが残っているかを知りたい場合
- さらにコンポーネントを追加する予定があり、スペースがあるかを知る必要がある場合
/context-budgetコマンド(本スキルがこれをサポートします)を実行する場合
動作原理
フェーズ 1:インベントリ
すべてのコンポーネントディレクトリをスキャンし、トークン消費量を推定します。
エージェント (agents/*.md)
- 各ファイルの行数とトークン数(単語数 × 1.3)をカウントします。
descriptionプロローグの長さを抽出します。- フラグ付け:ファイルが 200 行を超える場合(重い)、説明が 30 語を超える場合(肥大化したプロローグ)。
スキル (skills/*/SKILL.md)
- SKILL.md のトークン数をカウントします。
- フラグ付け:ファイルが 400 行を超える場合。
.agents/skills/内の重複コピーをチェックします — 同じコピーは重複カウントを避けるためにスキップします。
ルール (rules/**/*.md)
- 各ファイルのトークン数をカウントします。
- フラグ付け:ファイルが 100 行を超える場合。
- 同じ言語モジュール内のルールファイル間のコンテンツの重複を検出します。
MCP サーバー (.mcp.json またはアクティブな MCP 設定)
- 設定されているサーバーの数とツールの総数をカウントします。
- スキーマオーバーヘッドをツールあたり約 500 トークンと見積もります。
- フラグ付け:ツール数が 20 を超えるサーバー、単純な CLI コマンド(
gh,git,npm,supabase,vercel)をラップするサーバー。
CLAUDE.md(プロジェクトレベル + ユーザーレベル)
- CLAUDE.md チェーン内の各ファイルのトークン数をカウントします。
- フラグ付け:合計が 300 行を超える場合。
フェーズ 2:分類
各コンポーネントをカテゴリに分類します。
| カテゴリ | 標準 | アクション |
|---|---|---|
| 常に必要 | CLAUDE.md で参照されている、アクティブなコマンドをサポートしている、または現在のプロジェクトタイプに一致する | 保持 |
| 時々必要 | ドメイン固有(例:言語パターン)、CLAUDE.md で参照されていない | 必要に応じてアクティブ化を検討 |
| ほとんど不要 | コマンド参照がない、コンテンツが重複している、または明確なプロジェクト一致がない | 削除または遅延ロード |
フェーズ 3:問題の検出
以下の問題パターンを特定します。
- 肥大化したエージェントの説明 — プロローグの説明が 30 語を超え、タスクツールが呼び出されるたびにロードされます。
- 重いエージェント — ファイルが 200 行を超え、生成されるたびにタスクツールのコンテキストを増加させます。
- 冗長なコンポーネント — エージェントロジックを複製するスキル、CLAUDE.md を複製するルール。
- MCP の過剰なサブスクリプション — 10 を超えるサーバー、または無料で利用できる CLI ツールをラップするサーバー。
- CLAUDE.md の肥大化 — 長い説明、古いセクション、ルールであるべき指示。
フェーズ 4:レポート
コンテキスト予算レポートを生成します。
コンテキスト予算レポート
═══════════════════════════════════════
総推定コスト:約 XX,XXX トークン
コンテキストモデル:Claude Sonnet (200K ウィンドウ)
実質利用可能コンテキスト:約 XXX,XXX トークン (XX%)
コンポーネントの内訳:
┌─────────────────┬────────┬───────────┐
│ コンポーネント │ 数量 │ トークン数 │
├─────────────────┼────────┼───────────┤
│ Agents │ N │ ~X,XXX │
│ Skills │ N │ ~X,XXX │
│ Rules │ N │ ~X,XXX │
│ MCP tools │ N │ ~XX,XXX │
│ CLAUDE.md │ N │ ~X,XXX │
└─────────────────┴────────┴───────────┘
WARNING: 発見された問題 (N):
[節約できるトークン数でソート]
上位 3 つの最適化提案:
1. [action] → 約 X,XXX トークン節約
2. [action] → 約 X,XXX トークン節約
3. [action] → 約 X,XXX トークン節約
潜在的な節約スペース:約 XX,XXX トークン (現在のコストの XX%)
詳細モードでは、ファイルごとのトークンカウント、最も重いファイルの行レベルの内訳、重複するコンポーネント間の具体的な冗長行、および MCP ツールリストと各ツールスキーマサイズの推定値が追加で出力されます。
例
基本監査
/context-budget
スキル:設定をスキャン → 16個のエージェント(12,400トークン)、28個のスキル(6,200)、87個のMCPツール(43,500)、2個のCLAUDE.md(1,200)
フラグ付け:3個の重いエージェント、14個のMCPサーバー(3個はCLIに置き換え可能)
最大節約:3個のMCPサーバーを削除 → -27,500トークン(コストを47%削減)
詳細モード
/context-budget --verbose
スキル:完全なレポート + planner.md(213行、1,840トークン)のファイルごとの内訳、
MCPツールリストと各ツールのサイズ、重複するルール行の並列表示
スケールアップ前のチェック
User: MCPサーバーをあと5つ追加したいのですが、スペースはありますか?
Skill: 現在のコストは33% → 5つのサーバー(約50個のツール)を追加すると約25,000トークン増加 → コストは45%に上昇します
提案:40%以下に保つために、CLIで代替可能な2つのサーバーを先に削除してください
ベストプラクティス
- トークン推定:散文には
words × 1.3を使用し、コード密度の高いファイルにはchars / 4を使用します。 - MCP が最大のレバレッジ:各ツールスキーマは約 500 トークンを消費します。30 個のツールを持つサーバーは、すべてのスキルの合計よりも多くのコストがかかります。
- エージェントの説明は常にロードされる:エージェントが呼び出されなくても、その説明フィールドはすべてのタスクツールコンテキストに存在します。
- 詳細モードはデバッグ用:コストの原因となっている正確なファイルを特定する必要がある場合に使用し、通常の監査には使用しません。
- 変更後の監査:エージェント、スキル、または MCP サーバーを追加した後に実行し、増分を早期に発見します。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
上下文预算
分析 Claude Code 会话中每个已加载组件的令牌开销,并提供可操作的优化建议以回收上下文空间。
使用时机
- 会话性能感觉迟缓或输出质量下降
- 你最近添加了许多技能、代理或 MCP 服务器
- 你想知道实际有多少上下文余量
- 计划添加更多组件,需要知道是否有空间
- 运行
/context-budget命令(本技能为其提供支持)
工作原理
阶段 1:清单
扫描所有组件目录并估算令牌消耗:
代理 (agents/*.md)
- 统计每个文件的行数和令牌数(单词数 × 1.3)
- 提取
description前言长度 - 标记:文件 >200 行(繁重),描述 >30 词(臃肿的前言)
技能 (skills/*/SKILL.md)
- 统计 SKILL.md 的令牌数
- 标记:文件 >400 行
- 检查
.agents/skills/中的重复副本 — 跳过相同副本以避免重复计数
规则 (rules/**/*.md)
- 统计每个文件的令牌数
- 标记:文件 >100 行
- 检测同一语言模块中规则文件之间的内容重叠
MCP 服务器 (.mcp.json 或活动的 MCP 配置)
- 统计配置的服务器数量和工具总数
- 估算模式开销约为每个工具 500 令牌
- 标记:工具数 >20 的服务器,包装简单 CLI 命令的服务器 (
gh,git,npm,supabase,vercel)
CLAUDE.md(项目级 + 用户级)
- 统计 CLAUDE.md 链中每个文件的令牌数
- 标记:合并总数 >300 行
阶段 2:分类
将每个组件归入一个类别:
| 类别 | 标准 | 操作 |
|---|---|---|
| 始终需要 | 在 CLAUDE.md 中被引用,支持活动命令,或匹配当前项目类型 | 保留 |
| 有时需要 | 特定领域(例如语言模式),未在 CLAUDE.md 中引用 | 考虑按需激活 |
| 很少需要 | 无命令引用,内容重叠,或无明显的项目匹配 | 移除或延迟加载 |
阶段 3:检测问题
识别以下问题模式:
- 臃肿的代理描述 — 前言中描述 >30 词,会在每次任务工具调用时加载
- 繁重的代理 — 文件 >200 行,每次生成时都会增加任务工具的上下文
- 冗余组件 — 重复代理逻辑的技能,重复 CLAUDE.md 的规则
- MCP 超额订阅 — >10 个服务器,或包装了可免费使用的 CLI 工具的服务器
- CLAUDE.md 臃肿 — 冗长的解释、过时的部分、本应成为规则的指令
阶段 4:报告
生成上下文预算报告:
上下文预算报告
═══════════════════════════════════════
总预估开销:约 XX,XXX 个词元
上下文模型:Claude Sonnet (200K 窗口)
有效可用上下文:约 XXX,XXX 个词元 (XX%)
组件细分:
┌─────────────────┬────────┬───────────┐
│ 组件 │ 数量 │ 词元数 │
├─────────────────┼────────┼───────────┤
│ Agents │ N │ ~X,XXX │
│ Skills │ N │ ~X,XXX │
│ Rules │ N │ ~X,XXX │
│ MCP tools │ N │ ~XX,XXX │
│ CLAUDE.md │ N │ ~X,XXX │
└─────────────────┴────────┴───────────┘
WARNING: 发现的问题 (N):
[按可节省词元数排序]
前 3 项优化建议:
1. [action] → 节省约 X,XXX 个词元
2. [action] → 节省约 X,XXX 个词元
3. [action] → 节省约 X,XXX 个词元
潜在节省空间:约 XX,XXX 个词元 (占当前开销的 XX%)
在详细模式下,额外输出每个文件的令牌计数、最繁重文件的行级细分、重叠组件之间的具体冗余行,以及 MCP 工具列表和每个工具模式大小的估算。
示例
基本审计
/context-budget
技能:扫描设置 → 16个代理(12,400个令牌),28个技能(6,200),87个MCP工具(43,500),2个CLAUDE.md(1,200)
标记:3个重型代理,14个MCP服务器(3个可替换为CLI)
最高节省:移除3个MCP服务器 → -27,500个令牌(减少47%开销)
详细模式
/context-budget --verbose
技能:完整报告 + 按文件细目显示 planner.md(213 行,1,840 个令牌),
MCP 工具列表及每个工具的大小,重复规则行并排显示
扩容前检查
User: 我想再添加5个MCP服务器,有空间吗?
Skill: 当前开销33% → 添加5个服务器(约50个工具)会增加约25,000个tokens → 开销将升至45%
建议:先移除2个可用CLI替代的服务器以保持在40%以下
最佳实践
- 令牌估算:对散文使用
words × 1.3,对代码密集型文件使用chars / 4 - MCP 是最大的杠杆:每个工具模式约消耗 500 令牌;一个 30 个工具的服务器开销超过你所有技能的总和
- 代理描述始终加载:即使代理从未被调用,其描述字段也存在于每个任务工具上下文中
- 详细模式用于调试:需要精确定位导致开销的确切文件时使用,而非用于常规审计
- 变更后审计:添加任何代理、技能或 MCP 服务器后运行,以便及早发现增量