クロード コードとカーソルの 50% コンテキスト ルール: セッションをクリアするタイミングとタスクを委任する方法
長いセッションで何が起こるか
あなたはエージェントと 1 時間かけて 1 つの機能について作業します。最初に私たちは、パブリック API には触れず、Vitest でテストを作成し、既存の apiClient を使用することに同意しました。セッションの終わりまでに、エージェントは新しい fetch ラッパーを作成し、エクスポートされた関数の署名を破って、Jest でテストを作成します。人間の意味で「忘れられた」わけではありません。初期の命令はまだコンテキスト内にありますが、それらは現在、数万のログ トークン、差分、読み取りファイルに囲まれています。
これには研究根拠があります。 Lost in the Middle (Liu et al., 2023) は、モデルが長いコンテキストの最初と最後よりも途中からの情報をうまく利用していないことを示しています。さらに、古いバージョンのファイル、キャンセルされたアプローチ、すでに修正されたエラー メッセージなど、コンテキスト内にガベージが蓄積されます。モデルはそれらを現在の状態と同等に見なします。
「50% ルール」はヒューリスティックであり、測定されたしきい値ではありません。重要なのは、エージェントが間違いを犯したり、自動圧縮が開始されるのを待つのではなく、事前にコンテキストを管理することです。
占有率を表示する方法
クロード コードでは、/context コマンドはビジー状態とその内容を表示します: システム命令、CLAUDE.md などのメモリ ファイル、MCP ツールの説明、メッセージ履歴。最後の点は、多くの場合、予期せぬことが判明します。接続された MCP サーバーと数十のツールが、最初のメッセージが表示される前からウィンドウの目立つ部分を占めています。
[カーソル] では、チャット内のコンテキスト インジケーターと自分自身のサインに焦点を当てます。エージェントは、すでに開いているファイルを再度読み取り、拒否されたオプションを繰り返し、名前を混乱させます。
半分のウィンドウの手順
- 1.エージェントにステータスを書き留めるように依頼します。 会話の再話ではなく、作業中の文書です。
Запиши в docs/handoff/feature-export.md: - цель задачи в одном абзаце; - принятые решения и почему (с путями к файлам); - что сделано и проверено (какие тесты проходят); - что осталось, в порядке выполнения; - ограничения: что нельзя трогать; - открытые вопросы. Не включай историю попыток, которые мы отбросили.
- 2.ドキュメントを自分で確認してください。 これは、新しいセッションに何を入れるかを制御できる唯一の場所です。間違っているものを削除し、忘れていた制限を追加します。
- 3.セッションをクリアします。 クロード コード -
/clear、カーソル - 新しいチャット。
- 4.ファイルから始めます。 「docs/handoff/feature-export.md を読み、次のポイントから続行します。」
クロード コードの最初の 3 つのステップの代替案は、保存対象を示す /compact です: /compact сохрани решения по API экспорта и список оставшихся шагов, логи тестов не нужны。高速ですが、最終出力はファイルほど明確に表示されません。
対話の中で避けるべきもの
永続的なプロジェクト ルールはメッセージ履歴に残すべきではありません。これらは CLAUDE.md (クロード コード) または .cursor/rules (カーソル) に属しており、新しいセッションごとにロードされます。素敵な CLAUDE.md の短い:
# Проект Next.js 15, App Router, PostgreSQL через Drizzle. # Команды - pnpm test — Vitest - pnpm lint — ESLint + tsc --noEmit # Правила - HTTP-запросы только через lib/api-client.ts. - Публичные функции в lib/public/* не меняют сигнатуру без явной просьбы. - Перед завершением задачи запускай pnpm lint и pnpm test.
長いリファレンス ブック (データベース図、API の説明) は、常にダウンロードするのではなく、別のファイルに保管し、必要に応じてリンクすることをお勧めします。
コンテキストを膨張させない方法
- ディレクトリ全体を読み取るように要求しないでください。 特定のファイルを指定するか、最初に検索して必要なものを見つけるように要求してください。
- コマンド出力をトリミングします。
pnpm test 2>&1 | tail -50完全なログの代わりに数千行に分割します。 - リサーチをサブエージェントに入れます。 Claude Code では、サブエージェントは別のコンテキストで動作し、出力のみを返します。 「古いクライアントが呼び出される場所をすべて見つける」というタスクは十分に委任されています。メイン セッションは 20 個のファイルの内容ではなく、リストを受け取ります。
- 1 つのセッション - 1 つのタスク。 「ヘッダーのスタイルを同時に修正する」に切り替えると、無関係なファイルがコンテキストにドラッグされます。
早めに掃除する時期のサイン
- エージェントは、あなたが数ステップ前に拒否した解決策を提案します。
- 彼は編集したばかりのファイルを再度読み、その内容に驚きました。
- 1 つのエラーを修正すると、すでに修正した場所に別のエラーが作成されます。
- 答えは長くなり、差分は小さくなります。
この問題が発生した場合、通常、同じセッションを継続する方が、ハンドオフ ファイルに数分を費やすよりもコストが高くなります。
ルールが不要な場合
12 件のメッセージに収まる短いタスクには、手順は必要ありません。ウィンドウが非常に大きいモデルでは、しきい値を移動できますが、キャンセルされた試行による破片は消えません。パーセンテージではなく、エージェントの行動に注目してください。少なくとも 50 という数字を考慮する必要があります。
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.