公開日: 最終更新:
執筆・編集:株式会社Nexa 編集部(下書きと機械検査はAI、公開前に人が確認)/約18分で読めます。公式ドキュメント・公式発表などの一次情報を確認したうえで執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。記事の作り方と検査の方針
Claude Codeのコンテキストを適切に管理することで、大規模プロジェクトでも性能を維持し生産性を最大化できます。
- 要点1: コンテキストが60%を超えると性能が低下し始めるとコミュニティで広く共有されている。現在の既定モデル(Sonnet 5.5・Opus 5.5)は1Mトークンのコンテキストウィンドウで動作し、/compactコマンドで圧縮できる
- 要点2: CLAUDE.mdに設定を外部化することで、セッションをまたいで情報を永続化できる。加えてClaude自身が学びを書き残す「Auto memory」も標準機能として用意されている
- 要点3: サブエージェントを活用すると独立したコンテキストウィンドウで並列処理が可能
対象: Claude Codeを業務で活用している経営者・DX推進担当者・ビジネスパーソン
今日やること: 使用率は/usageコマンドで確認し、不要なファイルは.claude/settings.jsonのpermissions.denyでRead拒否ルールを設定する(.claudeignoreは現在効果がない)
※本記事は2026年10月8日時点のClaude Code公式ドキュメント(Manage costs・How Claude remembers your project)で内容を確認しています。
Claude Codeのコンテキストを適切に管理することで、長時間セッションや大規模プロジェクトでも性能を維持し、チーム全体の生産性を大幅に向上させることができます。
「長時間作業していると、Claude Codeの応答精度が下がってきた気がする」「大きなプロジェクトで使うと、最初の指示を忘れてしまう」——こうした課題は、コンテキスト管理を見直すことで解決できます。
この記事では、/compactコマンドの使い方から、CLAUDE.mdによる永続メモリの設計、サブエージェントを使ったコンテキスト分割まで、実践的な管理テクニックを体系的に解説します。
Claude Codeのコンテキストウィンドウとは?基礎から理解する
コンテキスト管理を実践する前に、まずコンテキストウィンドウの仕組みを正しく理解しておくことが重要です。
コンテキストウィンドウとは、Claude Codeが「一度に参照できる情報の総量」を指します。会話の全履歴、読み込んだファイルの内容、コマンドの実行結果——これらすべてがコンテキストウィンドウに蓄積されます。ウィンドウが満杯に近づくと、古い情報が参照できなくなったり、応答精度が低下したりします。
コンテキストウィンドウに含まれるもの
以下の要素がすべてトークン(処理単位)として消費されます。
| 要素 | トークン消費量の目安 |
|---|---|
| 会話履歴(全メッセージ) | 大きい(積み重なるほど増加) |
| 読み込んだファイルの内容 | ファイルサイズに比例 |
| コマンドの実行結果 | 長いログは要注意 |
| CLAUDE.mdの内容 | 100行≒4,000トークン |
| Webページの読み込み | 数百〜数千トークン |
1つの会話セッションが長くなればなるほど、または読み込むファイルが多くなればなるほど、コンテキストウィンドウは埋まっていきます。
性能が落ちる閾値と自動compactの仕組み
コミュニティのベストプラクティスとして広く共有されているのが「60%閾値」です。コンテキスト使用率が60%を超えると、Claude Codeの応答精度が低下し始めるとされています(Anthropic公式がこの数値を明言しているわけではなく、利用者の経験則です)。
Claude Codeは「auto-compact」の発動タイミングをモデルのコンテキストウィンドウに応じて自動調整します。現在の既定モデル(Sonnet 5.5・Opus 5.5など1Mトークンウィンドウのモデル)では、ウィンドウが埋まりきる前の約96万7,000トークン(全体の約96.7%)に達した時点でauto-compactが自動発動し、会話履歴を要約・圧縮します。この閾値は/autocompactコマンドやCLAUDE_CODE_AUTO_COMPACT_WINDOW環境変数で10万〜100万トークンの範囲で変更できます。ただし、自動compactに任せきりにすると、細かいニュアンスや決定事項が失われるリスクがあるため、手動でのコントロールが推奨されています。
ポイントコンテキスト使用率は
/usageコマンド(旧/cost)でリアルタイムに確認できます。70%を超えたら積極的に/compactを使うことを習慣にしましょう。詳細は公式ドキュメント(Manage costs)を参照してください。
モデル・プランによるコンテキストサイズの違い
コンテキストサイズは、契約プランそのものよりもどのモデルを使うかで決まる比重が大きくなっています。現在の既定モデルであるClaude Sonnet 5.5・Opus 5.5は、Pro・Max・Team・Enterpriseのどのプランでも追加の利用クレジットなしで1Mトークンのコンテキストウィンドウを標準搭載しています。
| モデル | コンテキストサイズ | 追加クレジットの要否 |
|---|---|---|
| Sonnet 5.5 / Sonnet 5 | 1Mトークン(全プラン共通) | 不要 |
| Opus 5.5 | 1Mトークン | 不要(Proプラン含む全プランで利用可) |
一つ前の世代(Opus 4.6・Sonnet 4.6)までは、1Mトークンウィンドウの利用はMax・Team・Enterpriseプランで標準搭載、Proプランでは利用クレジットが必要という区別がありました。Sonnet 5.5・Opus 5.5ではこの区別がなくなり、Proプランでも1Mトークンを標準で使えます。auto-compactはウィンドウが埋まりきる前の約96万7,000トークンで自動発動するため、実質的に使える目安は約96万7,000トークン前後(残り約3万3,000トークンはシステムが確保するバッファ)です。大規模コードベースや複数ファイルの同時処理が多い場合も、現在はモデル選択の方が効くため、プラン選びはチームの人数や同時実行数を基準に考えるのが実態に合っています。
コンテキストを効率的に使う5つの基本テクニック
日常的なClaude Code使用で実践できる5つのテクニックを紹介します。どれも5分以内に始められる具体的な方法です。
テクニック1|/compactで会話を圧縮する
/compact コマンドは、会話履歴を要約・圧縮しながら重要情報を保持する機能です。コンテキストが肥大化してきたと感じたら、まずこのコマンドを試してください。
# 基本的なcompact
/compact
# 特定の情報を保持するよう指示してcompact
/compact APIの変更点と実装の決定事項を優先的に保持してください
/compactを使うと、古い会話履歴が要約されるため、コンテキストの空き容量が回復します。ただし、圧縮により細かい経緯情報が失われる場合があるため、重要な決定事項は事前にファイルに書き出しておくと安心です。
テクニック2|/clearで不要なコンテキストをリセットする
/clear コマンドは、会話の全履歴を削除してコンテキストを完全リセットします。タスクの切れ目(別プロジェクトに移るとき、全く関係ないタスクに切り替えるとき)に使用します。
# コンテキストの完全リセット
/clear
/compactとの違いを整理すると次のとおりです。
| コマンド | 動作 | 使いどき |
|---|---|---|
| /compact | 履歴を要約・圧縮して継続 | 同じタスクを継続したいが容量が不足 |
| /clear | 全履歴を削除してリセット | 別タスクに切り替える・新規セッション相当に戻したい |
| /rewind | 会話とコードを直前のチェックポイントまで復元 | 指示を誤った・意図しない変更を戻したい(Escキー2回連打でも呼び出せる) |
実務でのポイント: 午前中の作業が終わったら/clearでリセットし、午後の作業を新鮮なコンテキストで始める——という習慣が効果的です。
テクニック3|Read拒否ルールで不要ファイルを除外する(.claudeignoreは廃止)
以前は .claudeignore ファイルをプロジェクトルートに配置することで、Claude Codeが参照しないファイル・ディレクトリを指定できるとされていました。しかし公式ドキュメントでは「プロジェクトに.claudeignoreファイルがあっても効果はない」と明記されており、現在この方法は機能しません。node_modulesや.gitなど、AI分析に不要なファイルを除外したい場合は、.claude/settings.json の permissions.deny に Read の拒否ルールを書きます。
// .claude/settings.json
{
"permissions": {
"deny": [
"Read(./node_modules/**)",
"Read(./.git/**)",
"Read(./dist/**)",
"Read(./.env)"
]
}
}
この設定はバージョン管理にコミットしてチーム全体に共有できます。大規模なWebアプリケーション開発では、node_modulesだけで数万ファイルが存在することもあり、拒否ルールの有無で作業効率が大きく変わります。詳しくは公式ドキュメント(Configure permissions)を参照してください。
テクニック4|セッションを30〜45分以内に収める
「1つのセッションで何でもやろう」とすると、コンテキストが汚染されて精度が下がります。30〜45分を目安にタスクを区切り、セッションを新鮮な状態に保つことが推奨されています。
1つのセッションで扱うタスクの例として「提案書の第1〜3章のドラフト作成」「CSVデータの集計と可視化スクリプト作成」「特定ページのバグ調査と修正」など、明確なスコープを持つ単一タスクに絞ることが効果的です。
テクニック5|コンテキスト使用率を常時監視する
コンテキストの残量を把握しながら作業することで、性能が落ちる前に対処できます。
# 現在のトークン消費量を確認(/costは/usageのエイリアス)
/usage
より高度な運用として、ターミナルのステータスバーにコンテキスト使用率をリアルタイム表示するカスタム設定(bashやzshのプロンプト設定)を使う方法もあります。常時可視化することで、意識せずとも最適なタイミングで/compactを実行できるようになります。
CLAUDE.mdで「記憶」を外部化する
コンテキスト管理の核心は、「セッションが終わっても失われてほしくない情報」を外部ファイルに逃がすことです。その仕組みがCLAUDE.mdです。
CLAUDE.mdはClaude Codeが新しいセッションを開始するたびに自動的に読み込む設定ファイルです。プロジェクトのルールやチームの共通認識をここに書いておけば、毎回説明し直す手間が省けます。
CLAUDE.mdに書くべき内容と書かないべき内容
書くべき内容(永続的な参照情報)
- コードの書き方のルール(インデント、命名規則)
- よく使うコマンドと用途
- プロジェクト固有の専門用語・背景情報
- 禁止事項(.envファイルの読み込み禁止、本番DBへの直接接続禁止など)
- チームの作業方針
書かないべき内容(コンテキストを無駄に消費するもの)
- 一時的なタスクのメモ(毎セッション変わる情報)
- 大量のサンプルコード
- 長い説明文(200行を超えるとコンテキスト消費が大きくなる)
グローバル・プロジェクト・ローカル・組織の4階層設計
CLAUDE.mdは複数の場所に配置でき、それぞれの適用スコープが異なります。
| 種類 | 配置場所 | 適用スコープ |
|---|---|---|
| グローバル(ユーザー) | ~/.claude/CLAUDE.md |
自分の全プロジェクト共通 |
| プロジェクト | プロジェクトルート CLAUDE.md または .claude/CLAUDE.md |
特定プロジェクトのみ・Gitでチーム共有 |
| ローカル(個人用) | CLAUDE.local.md(プロジェクトルート) |
自分だけの設定・.gitignoreへ追加推奨 |
| 組織管理 | OS別の管理ポリシー配置先(例: macOSは/Library/Application Support/ClaudeCode/CLAUDE.md) |
組織全体に強制適用・個人設定で除外不可 |
企業での運用では「組織管理・グローバルに共通ルールを書き、プロジェクトごとに固有の設定を上書き」という構成が一般的です。なお、リポジトリに他のAIコーディングツール向けのAGENTS.mdが既にある場合、CLAUDE.mdが無ければClaude Codeはそれをそのままプロジェクト指示として読み込みます。
@importによる分割管理(.claude/rules/ディレクトリ活用)
CLAUDE.mdが長くなってきたら、@import構文を使ってファイルを分割することができます。
# CLAUDE.md
@.claude/rules/coding-style.md
@.claude/rules/api-guidelines.md
@.claude/rules/security-rules.md
ファイル分割することで、「コーディングスタイルのルールだけ更新する」といった管理は容易になりますが、@importで読み込んだファイルも起動時にすべてコンテキストへ読み込まれるため、分割してもトークン消費量そのものは減りません(公式ドキュメントで明記されています)。特定のディレクトリやファイル種別にだけ適用したいルールは、次に紹介する.claude/rules/に置くと、普段のコンテキスト消費を抑えられます。
推奨サイズの目安: 単体のCLAUDE.mdは200行以内(公式推奨)。これを超えると、コードや会話に使えるコンテキストが圧迫され、指示への追従率も下がるとされています。
.claude/rules/でパスごとにルールを分ける
特定のディレクトリやファイル種別にだけ適用したいルールは、.claude/rules/ディレクトリにトピックごとのMarkdownファイルを置いて管理します。YAMLフロントマターのpathsフィールドで対象ファイルを指定すると、該当するファイルをClaudeが読み書きするときだけそのルールが読み込まれ、@importと違って普段のコンテキスト消費を抑えられます。pathsを指定しないルールは起動時に常に読み込まれ、CLAUDE.mdと同じ扱いになります。
Auto memory:Claudeが自分で学びを記録する仕組み
CLAUDE.mdは人が書く設定ファイルですが、Claude Codeにはそれを補完する「Auto memory」という仕組みもあります。ユーザーの役割・指摘された間違い・進行中のプロジェクトの背景などを、Claudeが会話の中で判断して~/.claude/projects/<project>/memory/配下にメモとして書き残し、索引ファイルMEMORY.md(先頭200行または25KBまで)を毎セッション自動で読み込みます。コードから読み取れる内容や、CLAUDE.mdに既に書いてある内容は保存の対象外です。/memoryコマンドで内容の閲覧・編集・オンオフの切り替えができます。
Claude Codeの詳しいメモリ設計については「Claude Code Memory完全ガイド|6種類のメモリ設計と企業活用法」も参考にしてください(公式ドキュメントはHow Claude remembers your project)。
大規模プロジェクトでのコンテキスト分割戦略
プロジェクトが大きくなるほど、単一のセッションでは対処しきれなくなります。大規模プロジェクトに対応するための上級テクニックを紹介します。
サブエージェントで独立したコンテキストウィンドウを確保する
サブエージェントとは、メインのClaude Codeセッションから呼び出される、独立したコンテキストウィンドウを持つAIエージェントです。
例えば「コードレビュー」「ドキュメント生成」「テスト作成」といったタスクを、それぞれ独立したサブエージェントに割り当てることで、各エージェントが専門領域に集中できます。メインセッションのコンテキストを汚染することなく、大量の処理が可能になります。
# サブエージェントの起動例(カスタムサブエージェント)
# .claude/agents/code-reviewer.md にサブエージェント設定を記述することで
# レビュー専用の独立したコンテキストで動作させることができます
なお、サブエージェントにも専用の設定でAuto memoryを持たせることができ、メインセッションの学びとは別に専門領域の知見を蓄積させられます。
サブエージェントの詳細な設計方法については「Claude Code Agent・サブエージェント完全ガイド」で詳しく解説しています(公式ドキュメントはSubagents)。
複数セッションの並列起動で水平スケールする
大規模プロジェクトでは、複数のターミナルウィンドウでClaude Codeを並列起動し、それぞれが独立したタスクを担当する「水平スケール」が効果的です。
公開されている活用例では、3つのサブエージェントを同時起動し、合計53回のツール呼び出し(10回・27回・16回)を並列処理しながらメイン会話には要約だけを返した例が紹介されています。単一セッションで順次処理する場合と比較して、大幅な時間短縮が見込めます。
| 並列セッション | 担当タスク |
|---|---|
| セッション1 | フロントエンド実装 |
| セッション2 | バックエンドAPI実装 |
| セッション3 | テストコード作成 |
進捗をファイルに逃がす「Document & Clearパターン」
長時間の作業では、「重要な決定事項をファイルに書き出してから/clearする」という「Document & Clearパターン」が推奨されています。
実践手順は次のとおりです。
- セッション中に行った重要な決定・変更をメモファイルに記録する
/compactまたは/clearでコンテキストをリセットする- 次のセッション開始時に、メモファイルをClaude Codeに読み込ませる
こうすることで、長いセッションが唯一の記録になることを防ぎ、コンテキストをリセットしても作業の継続性を保てます。頻繁なgitコミットと組み合わせることで、さらに安全な作業環境が構築できます。
AI導入に関するお困りごとは、株式会社NexaのAI顧問がサポートします。「何から始めればいいか分からない」という段階からご相談いただけます。
業種・業務別コンテキスト管理の実践例
コンテキスト管理は、エンジニアだけでなくビジネスパーソン全般が意識すべき技術です。ここでは業種・業務ごとの実践例を紹介します。
営業・マーケティング(提案書作成・コンテンツ制作)
営業資料の作成や、SEO記事の量産など、複数の類似タスクを連続してこなすケースでは次の運用が効果的です。
- CLAUDE.mdに書く内容: 自社サービスの概要、競合他社との差別化ポイント、文体ルール(NG表現リスト)
- セッション設計: 提案書1件ごとにセッションを区切る。複数件をまとめて依頼しない
- Read拒否ルールの活用: 過去の提案書アーカイブフォルダを除外し、必要なテンプレートのみ参照させる
経営企画・管理部門(レポート作成・データ分析)
月次レポートや経営数値の分析など、定期的に繰り返すタスクには「テンプレートセッション」の設計が有効です。
- CLAUDE.mdに書く内容: KPIの定義・計算式、レポートのフォーマット、データの取得元情報
- セッション設計: データ取得・集計・文章化のフェーズごとにセッションを分割する
- Document & Clear: 集計結果をMarkdownファイルに出力してから/clearし、次のセッションで文章化タスクに専念させる
開発チーム(コードレビュー・リファクタリング)
コードベースが大きくなると、1つのセッションで全体を把握させることが難しくなります。
- CLAUDE.mdに書く内容: アーキテクチャの概要、モジュール間の依存関係、コーディング規約、禁止パターン
- サブエージェントの活用: モジュール単位でサブエージェントを割り当て、各エージェントが専門領域に集中
- Read拒否ルールの活用: テスト用データ、ビルド成果物、ドキュメントなど、コードレビュー不要なファイルを除外
よくある質問
Q. /compactと/clearはどう使い分ければいいですか?
/compactは「同じタスクを継続したいが、コンテキストが重くなってきた」ときに使います。会話履歴を要約しつつ、重要な情報は保持したまま継続できます。一方/clearは「全く別のタスクに切り替える」「新しいセッションとして再スタートしたい」ときに使います。タスクの継続性が必要かどうかが判断基準です。
Q. コンテキストが枯渇してしまったらどうすればいいですか?
1Mトークンウィンドウの既定モデル(Sonnet 5.5など)では、約96万7,000トークン(全体の約96.7%)に達するとauto-compactが自動発動します。ただし、自動圧縮では重要な情報が失われる場合があるため、70〜80%の段階で /compact コマンドを手動実行することを推奨します。それでも不足する場合は、重要な決定事項をファイルに書き出した上で /clear でリセットし、新しいセッションで作業を継続してください。
Q. CLAUDE.mdはどこに置けばよいですか?
プロジェクト固有のルールを書く場合はプロジェクトルートの CLAUDE.md、すべてのプロジェクトに共通のルールは ~/.claude/CLAUDE.md に置きます。どちらも自動的に読み込まれます。自分専用の設定(Git管理したくない情報)は CLAUDE.local.md に、特定のディレクトリ・ファイル種別だけに適用したいルールは .claude/rules/ に分けて置くこともできます。
Q. チームでClaude Codeを使う場合のコンテキスト設計はどうすればいいですか?
プロジェクトルートの CLAUDE.md をGitで管理することで、チーム全員が同じ前提でClaude Codeを使えるようになります。「このプロジェクトでのコーディング規約」「チームの作業フロー」「よく使うコマンドのレシピ」などを共有設定として書き込んでおくと、メンバー間での品質のばらつきを防げます。チーム用のCLAUDE.md設計についてはClaude Code ベストプラクティス15選も参照ください。
Q. Proプランでも1Mトークンのコンテキストは使えるのですか?
使えます。現在の既定モデルであるClaude Sonnet 5.5・Opus 5.5は、Pro・Max・Team・Enterpriseのどのプランでも追加の利用クレジットなしで1Mトークンのコンテキストウィンドウを使えます(一つ前の世代のOpus 4.6・Sonnet 4.6まではMax・Team・Enterpriseのみ標準搭載で、Proプランでは利用クレジットが必要でした)。実際にはauto-compactが約96万7,000トークンの時点で発動するため、実質的に使えるのは約96万7,000トークン前後です。それでも旧世代の標準ウィンドウ(20万トークン)の約5倍近い容量があり、大規模なモノレポや数千ファイルのプロジェクトにも対応できます。
\ AI活用の「次の一手」を一緒に考えませんか /
AI顧問の無料相談はこちらまとめ
Claude Codeのコンテキスト管理について、基礎から実践テクニックまで解説しました。
今回紹介した5つの基本テクニックを振り返ります。
- /compactコマンド: 会話を圧縮してコンテキストを解放。70〜80%で手動実行が推奨
- /clearコマンド: タスクの切れ目でコンテキストをリセット。新しいタスクは新鮮な状態で
- Read拒否ルール:
.claude/settings.jsonのpermissions.denyで不要ファイルの読み込みを拒否してコンテキストを節約。まずnode_modulesから設定(.claudeignoreは現在効果がない) - セッションの短縮化: 30〜45分を目安に区切り、1セッション1タスクを意識する
- コンテキスト監視:
/usageコマンドで使用率を把握し、早めに対処する
また、CLAUDE.md・Auto memoryへの外部化とサブエージェント活用を組み合わせることで、大規模プロジェクトや長期作業でも高い精度を維持できます。
今日からすぐにできること: まず .claude/settings.json に permissions.deny を追加し、node_modules/ と .git/ を読み込み拒否に設定してみてください。これだけで体感できる速度向上があります。
法人向けAI導入・活用の月額伴走サービス
AI導入の疑問を、週1回のMTGで相談できる「AI顧問」
株式会社Nexaでは、ChatGPT・Claude・Claude CodeなどのAI導入に関する質問や、社内活用・業務自動化の進め方を週1回相談できる 月額7万円(毎月3社限定で月額5万円)のAI顧問サービス を提供しています。
「自社では何から始めるべきか」「この業務はAI化できるか」「どのツールを選ぶべきか」を、無料相談で整理します。
この記事で参照した外部情報
- Manage costscode.claude.com
- How Claude remembers your projectcode.claude.com
- 公式ドキュメント(Configure permissions)code.claude.com
- Subagentscode.claude.com
本文中でリンクしている外部ページの一覧です(自動生成)。最終確認日は本記事の最終更新日 2026-10-08 で、リンク先の内容はその後変わることがあります。
AI導入を検討中の方へ









