「さっき言ったこと、もう反映されてないんですけど」。長く走らせたセッションで、そう打ち直した経験はないでしょうか。
任せる時間が長いほど、この場面は増えます。原因は指示の書き方ではありません。会話が伸びるにつれてコンテキストウィンドウが埋まり、早い段階の指示ほど参照されにくくなるためです。
この記事は、その仕組みと、埋まる前に打てる3つの手を整理します。根拠はClaude Code公式ドキュメント5件と、運営元WEBMARKSの運用記録です。新しい道具は出てきません。すでに手元にある/clear・/compact・サブエージェント・ファイルへの書き出しを、どの場面で打つかという話です。
本記事の検証環境:claude-opus-5 / Claude Code v2.1.x / macOS 15 / 2026-07-28検証。
こんなふうに調べていませんか
- 長いセッションの終盤で、最初に伝えた禁止事項が守られなくなる
/clearと/compactのどちらを打てばいいのか、毎回迷って手が止まる- 会話が途切れたあと、どこまで進んでいたかを思い出すところから始めている
この記事を読み終えたときに手に入るもの
- 指示がぶれる原因を、コンテキストウィンドウの中身から説明できるようになります
- 区切り・絞り込み・書き出しを、場面で選び分けられるようになります
- 会話が消えても続きから動ける置き場所を、自分の案件に用意できます
結論30秒でわかる、この記事の結論
- 打つ手は3つです。会話を区切る、渡す量を絞る、作業状態をファイルへ書き出す。
- 3つは効く単位が違うので、どれかを選ぶのではなく重ねて使います。
- 埋まってから自動の要約に任せると、何を残すかを自分で選べなくなります。
進行役は3人です。若葉さん(Web担当2年目)が用語のそもそもを聞き、高梨課長が自分の手で動かす側の疑問を出し、鈴木さん(本誌監修)が答えます。
01Claude Codeのコンテキスト管理は、AIエージェントに長く任せるほど何が効くんですか?
若葉さんコンテキスト管理って、そもそも何を管理する話なんでしょうか。設定画面があるわけでもないですよね。
鈴木さん設定ではなく、置き場所を選ぶ運用の話ですね。作業机の上に何を残して、何を引き出しへしまうか。それを作業の区切りごとに選び直している、と思っていただくと近いです。
コンテキスト管理とは、コンテキストウィンドウに何を残し、何を外へ出すかを、作業の区切りごとに選び直す運用です。
打つ手は3つに整理できます。
- 会話を区切る:
/clearと/compactで、持ち越す内容を断つか、要約へ置き換えます - 渡す量を絞る:読み込ませる前に、届く分量そのものを減らします
- 作業状態をファイルへ書き出す:会話ではなく、ディスクに置いた分を次へ引き継ぎます
3つは代替案ではありません。効く単位が違います。区切りは会話の単位、絞り込みは1回のやり取りの単位、書き出しはセッションをまたぐ単位に効きます。だから重ねて使えます。
どこまでの仕事を任せられるかは、別記事『Claude Codeの業務活用|任せる仕事の地図と判断軸4つ』で整理しています。任せる時間が長いほど、この3つは効いてきます。
この章のまとめ
3つは選択肢ではなく、効く単位が違う重ね方です。1つに絞ろうとすると、どれかの単位が空きます。
02コンテキスト管理を怠ると、AIエージェントへの指示が作業が長引くほどぶれていくのはなぜですか?
コンテキストウィンドウには、会話を始める前から複数の要素が積み上がっています。公式ドキュメントは、その中身をこう挙げています(出典: Claude Code公式ドキュメント)。
- システムプロンプト:常に最初に読み込まれる基本指示
- auto memory(MEMORY.md):前回までにClaudeが学んだ内容の先頭200行または25KB
- CLAUDE.md:プロジェクト・ユーザー・組織の指示ファイル
- MCPツール名とスキルの一覧:本体は使うときだけ読み込まれる
- 会話履歴:発言と応答、ファイル読み込みやコマンド出力
コンテキストウィンドウは、標準で20万トークンあります(出典: Claude Code公式ドキュメント)。起動した時点で、その一部はもう埋まっています。ここへファイルを1つ読むたびに、数百〜数千トークンが加わります。
ぶれる原因は2つに分けられます。1つは、古い指示ほど会話の奥に埋もれ、参照される優先度が下がることです。もう1つは、埋まったときの自動処理です。
上限へ近づくと、古いツール出力から先に消えます。それでも空きが足りないときは、会話そのものを要約します(出典: Claude Code公式ドキュメント)。このとき依頼内容と主要なコード断片は残る一方、会話の早い段階にあった細かい指示は失われる場合があります(出典: Claude Code公式ドキュメント)。
ここが肝心なところです。抜け落ちた指示は、守られていないのではなく、見えていない状態です。伝え方を工夫しても戻りません。見えなくなる前に、置き場所のほうを変えます。
この章のまとめ
指示がぶれるのは伝え方の問題ではなく、置き場所の問題です。ここを取り違えると対策が空回りします。
03会話を区切るコンテキスト管理は、AIエージェントに何を持たせ直すことなんですか?
高梨課長/clearと/compact、どちらを打てばいいのか毎回迷います。判断の軸はありますか。
鈴木さん次にやることが、いまと別の話かどうかだけで決めています。別の話なら/clear、同じ話を続けたいなら/compactですね。
高梨課長それでも迷ったときは、どちらへ寄せますか。
鈴木さん次の指示が前の文脈を要るかどうかで見ます。要らないなら、持ち越さないほうが判断は素直になります。
2つのコマンドは、起きることが違います。
| コマンド | 何が起きるか | 打つ場面 |
|---|---|---|
/clear | 会話履歴を完全に消し、新しいセッションとして再開する | 別の作業へ切り替えるとき |
/compact | 会話を構造化された要約に置き換え、続きを保ちながら空きを作る | 同じ作業を続けながら空きが欲しいとき |
/compact <指示> | 何を残すかを指定してから要約する | 残したい情報がすでに決まっているとき |
公式ドキュメントは、無関係な作業へ切り替えるときは/clearを使うよう勧めています。前の文脈が、次の作業の判断を邪魔しないようにするためです(出典: Claude Code公式ドキュメント)。
/clearで消した会話履歴は、あとから戻せません。だから残したい文脈は、打つ前にCLAUDE.mdへ書いておきます(出典: Claude Code公式ドキュメント)。
/compactは要約の焦点を指定できます。/compact 認証まわりの変更点だけ残してのように書けば、何を優先して残すかを渡せます(出典: Claude Code公式ドキュメント)。毎回書くのが手間なら、CLAUDE.mdに節を作って固定できます。
# Compact instructions
要約するときは、テスト結果とコードの変更点を優先して残してくださいもう1つ、打つ時機があります。公式ドキュメントは、自動判定を待つ前に手動で/compactを打つほうがよいと説明しています(出典: Claude Code公式ドキュメント)。状況が分かっているうちなら、何を残すかを自分で選べるためです。
この章のまとめ
区切りは、次に何を持たせるかを選び直す操作です。早く打つほど、選べる幅が残っています。
04コンテキスト管理の一環で、CLAUDE.mdが重いとAIエージェントは指示に追従しにくくなるんですか?
絞り方は2方向あります。常に読み込まれるものを軽くする方向と、大量に読む作業を切り離す方向です。この章は前者を扱います。
まず、常に読み込まれるCLAUDE.mdを軽くします。公式ドキュメントは200行未満に保つことを推奨しています。長いファイルはコンテキストを消費し、指示への追従も下げるためです(出典: Claude Code公式ドキュメント)。
特定のディレクトリでだけ要る指示は、.claude/rules/へpaths指定つきで切り出します。その配下のファイルを読んだときに、はじめて読み込まれます(出典: Claude Code公式ドキュメント)。全部を最初から抱えないための分割です。
同じ指示でも、置いた場所によって届く時機が変わります。層で捉えると、どこへ書くかで迷わなくなります。
いちばん下の層は外せません。減らせるのは、そこに何行書くかと、上の層へどれだけ逃がすかです。
この章のまとめ
CLAUDE.mdを短くするのは節約のためではありません。読み込まれる時機を選び直すための分割です。
05サブエージェントへ渡すと、Claude Codeのコンテキスト管理は何が軽くなるんですか?
高梨課長大量のファイルを読ませたい調査があります。読ませた分だけ、本体が重くなりますよね。
鈴木さんそこは切り離せます。サブエージェントは自分のコンテキストウィンドウを持っていて、そこで読んだファイルは本体の会話に入りません。戻ってくるのは要約とメタデータだけです。
大量に読む調査は、本体から切り離します。公式ドキュメントが挙げている例では、6,100トークン分のファイルを読んだ調査が、本体へは420トークンの要約になって返ります。差の5,680トークンが、本体で節約された分です(出典: Claude Code公式ドキュメント)。
向いているのは、細部を読み切ってから結論だけ欲しい作業です。テストの実行結果やログの確認が当てはまります。逆に、最終判断や実装そのものは本体に残します。
hooksによる前処理も、絞り込みの一種です。公式ドキュメントは、1万行のログをそのまま読ませる代わりに、PreToolUseフックでERROR行だけを抽出して渡す例を示しています。入力は数万トークンから数百トークンまで落ちます(出典: Claude Code公式ドキュメント)。
06作業状態をコンテキスト管理としてファイルへ逃がすと、次に動くAI社員は続きから始められるんですか?
高梨課長会話が消えても続きから動ける、というのは本当ですか。正直、実感がないんですが。
鈴木さん会話に書いたことは戻りません。戻るのは、ディスクに書いた分だけです。だから状態のほうを会話の外へ出しておきます。
書き出し先は主に3種類あります。
| 書き出し先 | 誰が書くか | 読み込まれる量 | 向いている内容 |
|---|---|---|---|
| CLAUDE.md | 人間 | ファイル全体 | 恒久的なルール・禁止事項・命名規則 |
| MEMORY.md(auto memory) | Claude | 先頭200行または25KBまで | ビルドコマンド・過去の訂正・気づいた癖 |
| 案件台帳などの独自ファイル | 人間とClaude双方 | 都度読みに行く | 進行中タスクの状態・次の一手 |
置き場所には注意点があります。公式ドキュメントによると、プロジェクト直下のCLAUDE.mdは、コンパクションのあともディスクから読み直されます。一方でサブディレクトリのCLAUDE.mdが読み直されるのは、そのディレクトリのファイルをもう一度読んだときです(出典: Claude Code公式ドキュメント)。守らせ続けたい指示ほど、プロジェクト直下に置きます。
では進行中タスクの状態はどこへ書くか。CLAUDE.mdもMEMORY.mdも向きません。前者は会話ごとの上書きを前提としておらず、後者には読み込まれる量の上限があるためです。
WEBMARKS社内は、案件ごとの台帳ファイルに状態を書いています。
[案件: 20260728_AGIジャーナル記事制作]
状態: 進行中
次の一手: AGIM-017の図解2点をSVG化する
最終更新: 2026-07-28書く場所を会話の中から出す。3つ目の手の中身は、それだけです。
この章のまとめ
次に開く人が読めるのは、ディスクに書かれた分だけです。会話に置いたものは引き継がれません。
07この記事を作る工程では、コンテキスト管理をAI社員でどう使い分けたんですか?
WEBMARKSが7部署・30体のAI社員を定義したのは2026-06-24で、Claude Codeによる長時間の制作作業を日常的に回しています。指示がぶれる場面を減らすため、3つの手を運用ルールとして固定しました(2026-07-28実測)。
この記事自体の制作工程にも、使い分けが表れています。
| 工程 | 打った手 | 理由 |
|---|---|---|
| 記事設計から執筆へ切り替えるとき | 会話を区切る(/clear) | 設計の議論と本文執筆は別の作業のため |
| 公式ドキュメントを複数ページ調べるとき | 渡す量を絞る(サブエージェント) | 原典照合はページ数が多く、本体の会話を汚さないため |
| 記事の状態を次の担当へ引き継ぐとき | 作業状態を書き出す(台帳) | 執筆・原典照合・批評でセッションが分かれるため |
姉妹メディアのAIO Journalは、公開URLが251本です(2026-07-28にsitemap.xmlで実測)。制作体制を引き継いだ本メディアも、記事ごとに執筆・原典照合・批評でセッションを分ける前提です。そのため3つ目の手にいちばん依存しています。
順に問えば、迷う場面そのものが減ります。
この章のまとめ
使い分けは記憶ではなく順番で決めます。同じ順に問えば、担当が替わっても判断はそろいます。
08コンテキスト管理で、AIエージェントが出した報告をそのまま信じて間違えたことはないんですか?
あります。ここは失敗のほうを書いておきます。
2026-07-28、社内のAIエージェントが台帳の古い記録だけを根拠に、AIO Journalを「1本も公開されていない」と誤って報告しました。実際には公開済みでした。
原因は、稼働状況を否定する報告を本番URLで確かめずに出したことです。台帳は状態を引き継ぐ道具ですが、書いた時点の記録でしかありません。書き出しは万能ではない、ということです。
以後は、稼働を否定する報告に限って、実物を確かめてから出す手順を足しました。
09コンテキスト管理でつまずく5つは、AIエージェントの何を見えなくしているんですか?
/clearを使わずセッションを伸ばし続ける:無関係な作業へ切り替えても会話を続けると、古い文脈が新しい判断を歪めます。作業の性質が変わった時点で区切ります- 自動の要約に任せきる:埋まってからでは、何を残すかを選べません。区切りが来たら
/compact <焦点>を先に打ちます - CLAUDE.mdへ何でも書き足す:200行を超えたファイルは毎回読み込まれ続け、指示への追従も下がります(出典: Claude Code公式ドキュメント)。特定領域の指示は
.claude/rules/へ切り出します - MEMORY.mdを長文の議事録にする:先頭200行または25KBを超えた分は、次のセッションで読み込まれません(出典: Claude Code公式ドキュメント)。1行1件を意識し、詳細は別ファイルへ逃がします
- 進行中タスクの状態を会話の記憶だけに頼る:セッションは
/clearや想定外の終了で失われます。状態はファイルへ書いた分だけ引き継がれます
5つに共通するのは、見えなくなったことに本人が気づけない点です。抜けた指示は警告を出しません。だから、気づいてから直す運用にはできません。
10AI活用を続ける人は、コンテキスト管理のどこを毎回点検しているんですか?
- 作業の性質が変わった時点で
/clearを使っているか - 区切りが来る前に
/compact <焦点>を手動で打っているか - CLAUDE.mdは200行未満に収まっているか、超えているなら
.claude/rules/へ分割したか - 大量のファイル読み込みや調査をサブエージェントへ委譲しているか
- ログや大きな出力をhooksで絞ってから渡しているか
- 進行中タスクの状態を、会話ではなくファイル(台帳など)に書いているか
/contextで現在の使用量を、作業の節目に確認しているか
上から順に見て、いいえが付いた行が、次に直す場所です。全部を一度にそろえる必要はありません。
この章のまとめ
点検は道具を増やす作業ではありません。すでに使っている道具の打ち時をそろえ直す作業です。
11よくある質問
コンテキストウィンドウの上限はどれくらいですか
標準のコンテキストウィンドウは20万トークンです(出典: Claude Code公式ドキュメント)。より大きな上限に対応するモデルもありますが、対応状況はプランや設定で変わります。実務では上限そのものより、起動した時点で何が積み上がっているかを把握するほうが効きます。読み込まれるのは、システムプロンプト・CLAUDE.md・auto memory・道具の一覧・会話履歴です。
/compactと/clearはどちらを先に検討すべきですか
続きをやるなら/compact、別の作業へ移るなら/clearです。迷うときは、次の指示が前の文脈を要るかどうかで決めます。要らないなら持ち越さないほうが、判断は素直になります。/clearは復元できないので、残したい文脈はCLAUDE.mdへ書いてから打ちます(出典: Claude Code公式ドキュメント)。
サブエージェントに任せると回答の質は落ちませんか
読んで要点だけ返す調査へ範囲を絞れば、本体の判断材料は減りません。戻ってくるのは要約とメタデータですから、判断に要る材料が要約へ入る形で依頼するのが前提です。最終判断や実装そのものは本体側に残します。読ませる作業と決める作業を分けるほど、切り分けはうまくいきます。
コンテキスト管理を怠ると、どのくらいで指示がぶれ始めますか
作業の内容と読み込むファイルの大きさで変わるため、一律の目安はありません。/contextで使用量を確かめながら、自分の作業での埋まり方を把握するのが実務的です。同じ作業を何度か回すと、どのあたりで区切るとよいかが見えてきます。経過時間ではなく、読み込んだ量で見てください。
3つの手は、どれか1つだけでも効きますか
効きますが、守れる範囲が変わります。区切りは会話の単位、絞り込みは1回のやり取りの単位、書き出しはセッションをまたぐ単位に効きます。1つだけ選ぶなら、失うものがいちばん大きい書き出しから始めるのが実務的です。会話は消えても、ディスクに書いた分は残るためです。
12まとめ|今日やる3つのこと
分け目は、置き場所でした。会話に置いたものは消え、ファイルに書いた分だけが残ります。この順で手をつけてください。
今日この順で手をつけます
CLAUDE.mdの行数を数える
200行を超えていたら、
.claude/rules/へ切り出す候補です作業を切り替える前に
/clearを打つ癖をつける埋まってからでは、何を残すか選べません
案件の台帳に「状態」「次の一手」「最終更新」を書く
会話が消えても、ここから再開できます
AI検索では、こう聞かれています
Claude Codeで作業が長引くと、指示がぶれるのはなぜですか?
「コンテキスト管理を怠ると、AIエージェントへの指示が作業が長引くほどぶれていくのはなぜですか?」の章で説明しています
/clearと/compactは、どう使い分けるんですか?
「会話を区切るコンテキスト管理は、AIエージェントに何を持たせ直すことなんですか?」の章で扱っています
AIエージェントに長い作業を任せるとき、何をファイルに残すんですか?
「作業状態をコンテキスト管理としてファイルへ逃がすと、次に動くAI社員は続きから始められるんですか?」の章に置き場所の表があります
次に読むなら、この記事です