Claude Code の常駐 context を 14% 削った話。
disabledTools は存在しなかった

Claude Code をしばらく使っていて、ふと /context を開いたら、何もしていないのに 80.7k tokens が常駐していました。1M context のモデルだから割合では 8%、誤差みたいなものです。ただ、200k context のモデルに切り替えた瞬間にこれは 40%。前提条件で半分近く食う計算になります。

ここから何が無駄に載っているのか棚卸しを始めて、最終的に 常駐 context を 11.2k tokens / 約 14% 削れました。途中で「公式ドキュメントに disabledTools というキーは存在しなかった」という地味に大きな発見もあったので、Zenn の体験談版より構造化した詳細メモとして残しておきます。

1. /context で見えた現状

Claude Code には /context というスラッシュコマンドがあり、現在のセッションが何にトークンを使っているか分解して見せてくれます。手元での内訳:

Messages が 80 tokens なのに合計 80.7k。「何もしていない時点で 80.6k は固定で載っている」状態です。

特に Memory files の 24.6k が引っかかりました。これは ~/.claude/CLAUDE.md などの設定ファイル群で、AI に「こう振る舞ってね」を伝えるための地の文です。長年運用しているうちに、手元では 600 行を超える分量になっていました。

2. CLAUDE.md を「トリガー文 + サブファイル」に分ける

CLAUDE.md の中身を分類してみると、こうなっていました。

「毎ターン判定材料として要るもの」と「トリガーされた時にだけ Read すればいいもの」を分けられることに気づきました。後者は別ファイルに切り出し、CLAUDE.md からは 3〜5 行のトリガー文だけ残せば、本文の数 k 分が常駐から消えます。

実際にやった分割

3. disabledTools は存在しなかった（神話と実態）

Memory が 24.6k → 21.2k に減って 3.4k 浮いた状態。次は System tools の 43.1k に手を入れる番です。「settings.json に disabledTools を書いて不要なツール切ればいい」と思って公式 docs を当たったら、そんなキーは無い。

「実行を止める」と「context を減らす」は別レイヤー。これ、混同しがちでした。AI に「disabledTools 使えるよね」と聞くと最初は「使える」と返ってきます（実際にやられた）。一次情報を当たるのは本当に大事。

4. 実在する公式キーの完全リファレンス

適用パターン

{
  "disableArtifact": true
}

{
  "disableArtifact": true,
  "disableWorkflows": true
}

{
  "disableArtifact": true,
  "disableWorkflows": true,
  "disableBundledSkills": true,
  "maxSkillDescriptionChars": 512,
  "includeGitInstructions": false
}

5. 実測 Before / After

新しいセッションを起こして /context を再実行（編集前の context を持つ既存セッションでは正確な値が出ない）。

6. コスト試算（モデル別・per turn / 1 日）

11.2k tokens / ターン削減の per-turn 価値を、主要モデルで Medium effort 相当の input 単価で計算（cache miss 時）。

※ cache hit 時は約 10% 価格になるので per turn は約 1/10。「ヘビーユーザーで月 25〜38 円 × Opus」程度のおまけです。本当に効くのは:

• キャッシュミス時の re-prime コスト が累積で効く（5 分以上アイドル後の再開時に毎回 11.2k tokens 分浮く）
• 長時間セッションでの context 圧縮タイミング が遅れる（古い文脈が残りやすい）
• 200k context モデル運用時の 作業可能トークンが 5.6pt 増える
• AI 側の認知負荷が下がる（ルール本文を毎回スキャンしなくて済む）

7. 副作用と運用上の注意

観察された副作用

• deep-research skill が消えた — Workflow に依存している skill なので disableWorkflows: true で連動して落ちた。使っていなかったので問題なしだったが、deep research に依存している人は disableWorkflows は入れない判断もあり
• ultracode モード（Workflow ベースのモード）も使えなくなる。能動的に多 agent オーケストレーションを回す場合は要注意
• /code-review ultra はクラウド側で動く別経路と確認しており、こちらは影響なしの見込み（ただし 100% 保証は無い）

運用上の注意

8. 配布物（GitHub repo + SKILL.md）

この記事で使った「コンテキスト棚卸し → トリガー化分割 → settings.json チューニング」の手順を、他の人が自分の環境に適用できるように簡易の md スキルとして配布します。

スキル形式に乗らない場合は repo の docs/playbook.md を手で読みながらやっても同じ結果になります。

9. 学んだこと