Claude Code VS Code拡張機能のセッションタイトル破損の根本原因を特定

Claude Code拡張機能におけるセッションタイトル破損バグ

Claude CodeのVS Code拡張機能に存在する持続的なバグにより、「過去の会話」内のセッションタイトルが破損し、誤ったタイトルが表示されたり、最後のプロンプトテキストに戻ったり、完全に消えたりします。開発者がこのアーキテクチャ上の根本原因を特定し、同じ根本的な問題に起因する20件以上の関連GitHubイシューを収集しました。

根本原因の分析

拡張機能のセッションリストは、各.jsonlセッションファイルの最後64KB内で"customTitle"の生の文字列検索を実行してタイトルを読み取ります。このアプローチにより、3つの具体的な障害モードが発生します：

• 64KBの追い出し — 長いセッション（エージェントワークフローで一般的）では、カスタムタイトルのエントリが64KBの末尾ウィンドウの外に押し出され、タイトルが失われます。
• セッション間のコンテンツ汚染 — スキャナーは、実際のカスタムタイトルのJSONLエントリと、ツールの結果や会話コンテンツ内に現れる文字列「customTitle」を区別しないため、あるセッションのタイトルが完全に別のセッションに表示されます。
• 再開時の上書き — セッションが再開され新しいコンテンツが追加されると、/renameからのカスタムタイトルは埋もれてしまいます。拡張機能はその後、lastPromptにフォールバックするか、ツール出力からの古いマッチを拾います。

影響を受けるイシュー

開発者はこの問題に関連する20件以上のGitHubイシューを収集しました：

• タイトル消失: #33165, #32150, #25090, #23610, #26240, #29194
• 誤ったタイトル: #29801, #9668, #29342, #27751
• セッション非表示: #9898, #31813, #29088, #22215, #18619, #11232
• 機能リクエスト（回避策）: #11956, #9198, #11694, #7441

これらのイシューの多くは、修正が実装されないままボットによって重複として自動クローズされました。v2.1.47とv2.1.71での部分的な修正は特定の症状に対処しましたが、根本的なアーキテクチャには対応していません。

提案された解決策と回避策

開発者は、会話コンテンツをスキャンするのではなく、タイトルを別の軽量なインデックス（例：title-registry.json）に保存することを提案しています。このアプローチはセッションの成長を乗り切り、コンテンツ汚染の影響を受けず、クライアント間の同期を可能にします。

現在の回避策として、開発者はUserPromptSubmitフック＋systemdタイマー＋永続的なタイトレジストリを実行しており、すべてのプロンプトと2分ごとに正しいタイトルを再アサートしています。実装の詳細はイシュー#32150で入手可能です。

このバグは、作業項目にセッションを一致させることが重要なタスクベースのワークフローでClaude Codeを使用しているすべての人に影響します。20件のイシューすべてにリンクされた完全な根本原因分析は、GitHubディスカッションで入手可能です。