Skip to content

Claude Codeのコンテキスト使用量を最適化する #561

@gn-t-k

Description

@gn-t-k

パッケージ / 対象

Claude Code設定ファイル(リポジトリ全体)

問題

Claude Codeの会話開始時のコンテキスト使用量が29k/200k tokens (15%)を占めている。
調査の結果、以下の3点で約6.8k tokens(23%)の無駄が発生している。

  1. プラグインスキルの重複(~2k tokens): example-skillsdocument-skills の両方が有効化されており、16個のスキルが完全に重複
  2. 不要プラグインスキル(~1k tokens): 筋トレアプリ開発に無関係なスキル7個が毎回ロードされている
  3. CLAUDE.mdの@参照による自動ロード(~3.8k tokens): 毎回のロードが不要なドキュメント2件が @ プレフィックスで自動ロードされている

修正内容

1. プラグインスキルの重複削除(~2k tokens削減)

~/.claude/settings.jsonenabledPlugins から document-skills@anthropic-agent-skills を削除する。

2. 不要プラグインスキルのブロック(~1k tokens削減)

~/.claude/plugins/blocklist.json に以下の7スキルを追加する。

  • slack-gif-creator
  • brand-guidelines
  • internal-comms
  • algorithmic-art
  • canvas-design
  • theme-factory
  • web-artifacts-builder

3. CLAUDE.mdの@参照見直し(~3.8k tokens削減)

以下2件の @ プレフィックスを削除する(Claudeは必要時に自分でファイルを読めるため、毎回ロード不要)。

  • @docs/project/overview.mddocs/project/overview.md(~1.1k tokens)
  • @docs/architecture-decision-record/overview.mddocs/architecture-decision-record/overview.md(~2.7k tokens)

維持対象(コーディングルールとして毎回必要):

  • @.claude/rules/coding-style.md
  • @.claude/rules/error-handling.md
  • @.claude/rules/testing.md

効果見込み

対応 削減量
プラグイン重複削除 ~2k tokens
不要スキルのブロック ~1k tokens
@参照の見直し ~3.8k tokens
合計 ~6.8k tokens

現状29k → 約22k tokens(約23%削減)

中期的な追加改善候補(優先度低)

  • Vercelスキル3個の選別
  • settings.local.jsonpermissions.allow(122個)の定期レビュー
  • 使用していないMCPサーバーがあれば無効化

対象ファイル

  • ~/.claude/settings.json
  • ~/.claude/plugins/blocklist.json
  • CLAUDE.md

検証方法

  • 変更適用後、新しい会話を開始してコンテキスト使用量が削減されていることを確認する
  • 必要なルールファイル(coding-style, error-handling, testing)が引き続きロードされていることを確認する

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions