Claude Codeを長期間・高精度に使い続けるために、コンテキスト管理の見直しが効果的でした。本記事では、実際に試行錯誤して導入した4つのコンテキスト管理術について、実例とともに解説します。
はじめに
Claude Codeは高いコーディング支援能力を持つAIエージェントですが、長時間使い続けると「レスポンスが遅くなる」「回答の精度が不安定になる」「トークン使用量が急増する」といった課題が出てくることがあります。これらの根本原因は、Claude Codeが持つコンテキストウィンドウの限界にあります。
私自身、Claude Codeを日常的に使い続ける中で、これらの症状に悩まされていました。そこで実践したコンテキスト管理の工夫を4つにまとめたので、本記事でご紹介します。
課題：トークン消費が激しく、回答精度が落ちる
まず、私が直面していた具体的な症状を整理します。
症状
- 長時間使うとレスポンスが遅くなる
- 回答の当たり外れが大きくなる
- トークン使用量が急増する
原因
- コンテキストウィンドウの限界
- CLAUDE.mdの肥大化
- 不要なスキルの常時読み込み
- タスク切り替え後も過去の会話が残り続ける
これらの原因を1つずつ潰していくことで、Claude Codeを快適に使い続けることができるようになりました。
工夫① CLAUDE.mdのスリム化
最初に取り組んだのは、CLAUDE.mdの見直しです。
私のCLAUDE.mdは当初、200行を超えるもので、アーキテクチャ・スコープ・分類など、必要な情報とそうでない情報がごちゃ混ぜになっていました。これを35行まで削減しました。
| 項目 | Before | After |
|---|---|---|
| 行数 | 200行超 | 35行 |
| 内容 | アーキテクチャ・スコープ・分類など全部詰め込み | 概要・制約・方針・行動原則のみ |
削減した詳細な情報は、別ファイルに分離して必要に応じて参照できるようにしました。
docs/claude-context/
├── architecture.md
├── poc-scope.md
└── function-definition.md
ポイント： CLAUDE.mdにはエージェントが常に必要とする情報だけを残し、詳細な設計情報などは必要時に参照する形式にすることで、常時消費されるトークンを抑制できます。
工夫② スキル・MCP・プラグインの整理
次に、Claude Codeに読み込まれるスキル・MCPサーバー・プラグインを整理しました。これだけで約10,000トークンの削減に成功しています。
| 項目 | Before | After |
|---|---|---|
| 読み込みトークン | 27,000 | 17,000 |
手順は以下の3ステップです。
/contextで現在の使用状況を確認（スキル・MCP・プラグインの内訳も表示されます）- 不要なスキルは
/skillsや設定ファイルで無効化 - 不要な MCP サーバーはサーバー設定から削除
- 不要なプラグインは設定から削除
普段使っていないスキルや、特定のプロジェクトでのみ必要なMCPサーバーが常に読み込まれているケースは意外と多いです。/context で一度内訳を確認してみると、不要なものが見つかるかもしれません。
工夫③ タスク切り替え時に /clear を徹底
3つ目の工夫は、タスクを切り替えるタイミングで /clear を実行することです。
以前は /compact で会話履歴を圧縮していましたが、過去タスクの文脈が混入し続ける問題が残っていました。
不要な情報がコンテキストを圧迫し、回答精度が下がる原因になっています。
タスク切り替え時に /clear でコンテキストをリセットすることで、過去の会話履歴や一時的な情報を破棄します。これにより新しいタスクに集中でき、不要なトークン消費を防止できます。
ポイント： /compact は履歴の圧縮ですが、過去の文脈が完全に消えるわけではありません。
タスクが完全に切り替わるタイミングでは、思い切って /clear するのが効果的です。
工夫④ 軽度な作業は他ツールへ切り出す
最後に、Claude Codeですべての作業をこなそうとせず、軽度な作業は他のツールに任せるようにしました。
| 作業 | ツール |
|---|---|
| ファイル検索 | OpenCode（軽量なAIコーディングアシスタント） |
| 軽度な編集 | OpenCode |
| アーキテクチャ設計 | Claude Code |
| 複雑なバグ修正 | Claude Code |
Claude Codeのトークンを高度な作業に集中させることで、効率的な運用が実現できます。軽いファイル検索や1行の編集などで高機能なClaude Codeを使うのは、トークンの観点からもったいないです。
効果まとめ
4つの工夫を導入した結果、以下のような変化がありました。
| 項目 | Before | After |
|---|---|---|
| CLAUDE.md | 200行超 | 35行 |
| スキルトークン | 27,000 | 17,000 |
| タスク切り替え | コンテキスト蓄積 | /clear でリセット |
| 軽度作業 | Claude Code で実施 | 他ツールで実施 |
| 結果 | 消費激増・精度低下 | 効率化・精度維持 |
特に、CLAUDE.mdのスリム化とスキルの整理はすぐに効果が実感できる施策です。継続的にClaude Codeを快適に使い続けるために、コンテキスト管理を見直す価値は大きいと感じています。
今日からできること
本記事で紹介した工夫は、すぐに実践できるものばかりです。
/clearを試す — 今のタスクが終わったら次に進む前に実行してみましょう- CLAUDE.md を見直す — 本当に必要な情報だけ残して、詳細は別ファイルへ移動させましょう
- スキルを整理する —
/contextで確認 → 不要なスキルを無効化しましょう - 別ツールを使い分ける — 軽度な作業は OpenCode など軽量ツールへ切り出してみましょう
Claude Codeを長期間・高精度に使い続けるために、ぜひコンテキスト管理を見直してみてください。
