20260514_its_the_context_window_stupid.pdf

2026/05/14（木） Claude Code Meetup Japan #5 (Claude Code祭り!) 発表資料
https://aid.connpass.com/event/391153/presentation/

Transcript

1. heita と申します、よろしくお願います。 本日最後のセッションでございまして、みなさまもうお疲れのことと思いますが、今日のまとめになるようなお話ができればと思いますので、あと 5分お付き合いください。よろしくお願いします。
2. 今日はコンテキストウィンドウについてお話しします。ここに居るみなさまであれば、もうご存知かもしれませんが、コンテキストウィンドウとはClaude と僕らが会話をした履歴、Claude が実行したコマンドやその出力、それら全てを格納している記憶領域のことです。昔は 10万トークン、だいたい NY bestseller とかのペーパーバック一冊分くらいのコンテキストウィンドウしかありませんでしたが、現在では 100万トークン、ハリーポッターシリーズ全巻のだいたい 3/4 くらいが収まる容量にまで拡大していて、今後ももっと広がっていくと考えられます。
3. ただし、コンテキストウィンドウは大きければ大きいほどいいというわけではなく、肥大化したコンテキストウィンドウはコンテキストロット、腐れコンテキストと呼ばれる現象を引き起こすことが判っています。Claude が指示の内容を無視したり、テストをパスできなくなったり、やたらと怠惰になったりする現象をみなさまも経験したことがあるかもしれません。それらは肥大化したコンテキストウィンドウが原因である可能性が高いです。
4. 今日はコンテキストウィンドウに優しい Claude の使い方を初級編・中級編・上級編の3つに分けて5分でご紹介します。まず初級編、曖昧なプロンプトは避けましょう。曖昧なプロンプトは、それを具体化するために大量のコンテキストを消費します。とは言うものの、あまり具体的過ぎるプロンプトを書くのも大変ですから、一番いいのはサンプルを示すことです。うまく動くケース、失敗して欲しいケースをサンプルとして与えることで、コンテキストに優しく、人間にも優しいプロンプトを書くことができます。 ( ) • ( grep -A10 -B10 ) • UI 3
5. もし、自分のやりたいことが曖昧で、曖昧なプロンプトしか与えられない場合には plan モードを使ってください。plan モードについてはみなさまよくご存じだと思いますので、詳細は省略しますが、なぜプランモードがコンテキストウィンドウに優しいのかと言うと、plan モードは「どのファイルをどう直してください」という計画だけをメインのコンテキストウィンドウに引き次いで、調査にかかった様々な詳細情報は全部自動で忘れ去ってくれるからです。これは後ほど紹介するサブエージェントの機能を使っているためです。
6. 続いて中級編。Claude をコンテキストウィンドウに優しくカスタマイズしていきます。まず、みなさまにやっていただきたいのは、context window の消費量を意識するということです。VSCode などをお使いの場合はデフォルトで表示されていたりもしますが、CLI をお使いの場合でも /statusline というコマンドでステータスラインにコンテキストウィンドウサイズを表示させることができます。ぜひコンテキストウィンドウを意識しながら作業を行なってください。その他、アーキテクチャの全体象だとか、どのディレクトリに何が置いてあるだとか、毎回調べるような情報は Claude.md に記載することで調査にかかるコンテキストを省略することができます。ただ、CLAUDE.md 自体が肥大化してくると、これもコンテキストウィンドウを消費する原因になりますので、テストのときはこうする、ドキュメントを書くときはこうする、など場面場面で切り出せるノウハウについては CLAUDE.md を階層化するか、場面ごとの skill に切り出して、CLAUDE.md を 500行くらいのコンパクトな状態に保つのがお勧めです。
7. 続いて中級編の二つめ。「検証を組み込む」です。Claude が何かやって、人間がダメだしをして、CLaude がまた何かやって、人間がまたダメだしをしてということを繰り返していると、human in the loop で生産性が落ちるだけでなく、その履歴がコンテキストとしてどんどん積み上がっていってしまうことでコンテキストウィンドウを圧迫します。Claude が自分自身で、自分がやったことがうまくいったのか、ダメだったのかを判断できるようなハーネスたとえば、テストケースなどを組み込むことで、Claude はうまく行かなかった試行について、「何を試して、どうダメだったのか」という結論だけを残して、その他の詳細を捨て去ってくれます。詳細については省略しますが、拡張思考という機能です。ぜひ Claude 自身が自分の仕事を評価できるような環境を与えてあげてください。
8. 最後に上級編です。ここではコンテキストウィンドウの内容を積極的に管理する /clear、/compact、/rewind という 3つのコマンドのうち、/rewind についてご紹介します。Claude に間違った指示を与えてしまった場合、「ああ、いまのは間違いで…」と会話を続けるのではなく、/rewind してください。過去のある次点にコンテキストウィンドウを巻き戻して、そこから会話を再開することができます。また、rewind にはいろいろな機能がありまして、試しにやってみたけど上手く行かなかった、という場合にも、/rewind コマンドを使うことで「何をためして、どうダメだったのか」というサマリだけを記憶して、context window を効率的に圧縮することができます。
9. 8 (*1) 2026年4月現在、experimental 機能。 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS を 1 に設 定(環境変数または settings.json の env セクション)する必要がある
10. 本日のまとめです。今日はいろいろな人達が様々な Claude の TIPS を紹介してくれました。SKILL を使え、Plan モードを使え、サブエージェントを使え、ハーネスをこうしろ、たくさん言われて覚えていられないという人もいるかもしれません。でも、これらの TIPS はみな、コンテキストウィンドウを整理整頓された状態に保つというただ一つの目的のためのテクニックなんです。なので、今日は覚えることが沢山すぎて困ったなという人は、ぜひ今日一日のまとめとして「Context Window を意識する」ということだけを覚えて帰ってください。そうすることで、その他のテクニックは自然と身につくと思います。ご静聴ありがとうございました。