Claude Code Handoffのための自動セッション状態管理

Claudeセッションの自動コンテキスト保存

Redditユーザーが、Claudeとの会話におけるコンテキスト劣化、特に会話ウィンドウが大きくなるにつれて発生する自動圧縮や会話中のコンテキスト消失の問題に対処するソリューションを共有しました。このシステムは、手動介入なしでセッション全体を通じてライブ状態ファイルを自動的に維持します。

仕組み

このソリューションは、手動での引き継ぎコマンドを拡張し、追加のフックを組み込んでいます：

• UserPromptSubmitフックは送信されるすべてのメッセージで発火し、Claudeのシステムコンテキストに「何か重要なことが起きたか確認し、もしあればsession-state.mdを更新せよ」という指示を注入します
• PostToolUseフックはClaudeが編集するファイルを追跡します
• session-state.mdが長すぎる場合、指示は自動的に「書き換えモード」に切り替わり、Claudeに重要な情報のみを保持するよう伝えます
• 自動圧縮の前に、PreCompactフックが完全な状態ダンプを強制し、何も失われないようにします
• セッション開始時には、前回セッションの状態が読み込まれます

実装の詳細

この自動化システムは、bashとjq以外の依存関係がない約4つのシェルスクリプトで構成されています。インストールオプションには以下が含まれます：

• gitサブモジュールとしてインストール
• フックを.claude/hooks/ディレクトリにコピー

このシステムは、セッション全体を通じて.claude/session-state.mdにライブ状態ファイルを維持します。また、意図的なチェックポイントのための手動/handoffコマンドも含まれており、タスク追跡、バグ調査、劣化したコンテキストからの回復に役立ちます。

この種のツールは、Claudeを使用した複雑なマルチセッションプロジェクトに取り組む開発者にとって有用であり、会話間でコンテキストを維持することは継続性と繰り返しの回避に不可欠です。