Claude Code ガイド

Appearance

原文（日本語） ​

VS Code拡張機能で再開する際の重複セッションを修正

原文（英語） ​

Fixed duplicate sessions when resuming in VS Code extension

概要 ​

Claude Code 2.1.38では、VS Code拡張機能でセッションを再開する際に、重複したセッションが作成されてしまう問題が修正されました。これにより、セッション管理が正常に行われ、リソースの無駄遣いやコンテキストの混乱が防げるようになりました。

基本的な使い方 ​

VS Code拡張機能で作業を中断・再開する際、自動的に既存のセッションが再利用されます。

bash
# VS Codeでの基本的なワークフロー
1. Claude Codeで作業開始
2. VS Codeを閉じる（またはウィンドウをリロード）
3. VS Codeを再度開く
4. セッションが自動的に復元される（重複なし）

実践例 ​

長期プロジェクトでの作業再開 ​

複数日にわたるプロジェクトで、セッションの連続性が保たれます。

修正前の問題:

Day 1: セッションID abc123 で作業開始
Day 2: VS Code再起動 → 新しいセッションID def456 が作成される
       - 以前のコンテキストが失われる
       - 重複したセッションがバックグラウンドで実行される
       - メモリリソースが無駄に消費される

修正後の動作:

Day 1: セッションID abc123 で作業開始
Day 2: VS Code再起動 → 同じセッションID abc123 が再開される
       - コンテキストが保持される
       - リソースの無駄がない
       - シームレスな作業継続

マルチワークスペース環境 ​

複数のVS Codeワークスペースを開いている場合でも、各ワークスペースで正しくセッション管理されます。

ワークスペース1: プロジェクトA
  └─ セッションID: session-a

ワークスペース2: プロジェクトB
  └─ セッションID: session-b

ウィンドウリロード後も、それぞれのセッションが保持される

VS Codeウィンドウのリロード ​

開発中に拡張機能の更新やウィンドウリロードを行っても、セッションが継続されます。

bash
# VS Codeコマンドパレット (Ctrl+Shift+P / Cmd+Shift+P)
> Developer: Reload Window

# 修正後: セッションが自動的に再接続される
# - 会話履歴が保持される
# - 進行中のタスクが継続される

エラー後の復旧 ​

予期しないエラーやクラッシュからの復旧時にも、重複セッションが作成されません。

bash
# エラー発生 → VS Code再起動

修正前:
- 古いセッションが残ったまま新規セッションが作成
- 競合やメモリリークの原因に

修正後:
- 既存セッションを検出して再利用
- クリーンな状態で作業再開

リモート開発環境 ​

SSH接続やWSL環境でも、セッション管理が正常に機能します。

bash
# リモート環境での使用
VS Code → SSH接続 → Linuxサーバー
  └─ Claude Codeセッション起動

接続切断 → 再接続
  └─ 同じセッションに自動的に再接続

注意点 ​

  • VS Code専用の修正: この問題はVS Code拡張機能に特有のもので、CLI版には影響しません
  • セッションの永続性: セッションは一定期間後に自動的にクリーンアップされます
  • 手動セッション削除: 必要に応じて /clear コマンドで手動でセッションをクリアできます
  • 拡張機能の再インストール: 拡張機能を完全に削除・再インストールした場合は、セッションもリセットされます

セッション管理のベストプラクティス ​

  1. 定期的なクリーンアップ: 不要になったセッションは /clear で削除
  2. プロジェクトごとの整理: ワークスペースごとに独立したセッションを使用
  3. 長時間の中断後: 作業を再開する前に、コンテキストが正しく復元されているか確認

関連情報 ​