SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Claude Codeのセッション再開と履歴の場所

Claude Codeで--continueや--resumeを使って会話を再開する方法と、端末に保存される平文トランスクリプトの場所を説明します。v2.1.290とv2.1.292の仕様変更も確認できます。

Claude Code セッションを再開する方法

現在のディレクトリで直前の会話を再開するには claude --continue を実行します。以前の会話を一覧から選ぶには claude --resume を実行します。すでに実行中のセッションから別の会話へ切り替える場合は、終了せずに /resume コマンドを実行します。短縮形は -c と -r です。

claude --continue
claude --resume
claude --resume auth-refactor

セッション名または ID が分かっている場合は、引数として渡します。セッションの選択画面を表示せず、Claude Code が直接そのセッションを開きます。

以下の内容は、2026 年 11 月時点の公式セッションドキュメントに基づいています。Claude Code は頻繁にリリースされるため、バージョンによってフラグ名やキーボードショートカットが変わることがあります。ここに記載した内容と端末の表示が異なる場合は、claude --help と公式ページを確認してください。

セッションの実体

セッションとは、プロジェクトディレクトリに紐付いた、保存済みの 1 つの会話です。Claude Code が実行したツール呼び出しと、その結果を含むメッセージ履歴全体を保持します。Claude Code は作業中に継続的にディスクへ書き込むため、終了時に 1 回だけ保存する方式ではありません。そのため、ターミナルを閉じたり SSH 接続が切れたりしても、会話は残ります。

再開時に復元されるのはテキストだけではありません。会話履歴全体に加えて、そのセッションで使用していたモデルと、--agent を使用して開始した場合は起動元のサブエージェントも復元されます。シェルから --continue またはセッション ID を指定して再開した場合は、権限モードも復元されます。ただし、安全上の例外として、bypass-permissions モードは復元されません。このモードで終了したセッションは、新規セッションの開始時と同じモードで再開されます。プランモードは、ピッカーからセッションを選択した場合や /resume で切り替えた場合も含めて復元されます。この 2 つの方法では、それ以外の保存済みモードは引き継がれません。ターミナルからの再開では v2.1.290 以降、ピッカーと /resume では v2.1.292 以降、プランモードが復元されます。それ以前のリリースでは、再開時にプランモードも失われていました。シェルから指定する --permission-mode は、復元されたモードより優先されます。

起動時フラグであり、保存状態ではないため復元されないものもあります。--add-dir で追加したディレクトリや、--mcp-config、--settings、--plugin-dir などのオプションは、再開時に再度指定する必要があります。settings.json などの設定ファイルは起動時に再読み込みされるため、そこに記述された内容を再指定する必要はありません。認証情報も同様です。Claude Code は会話と一緒に認証状態を復元するのではなく、ログイン情報と環境から起動時に認証方法を決定します。そのため、シェルに不要な ANTHROPIC_API_KEY が混入した VPS でセッションを再開すると、前回は正常に動作していても 無効な API key エラーが発生します。

VPS ではセッション履歴がより重要になる理由

意外に思われる事実があります。トランスクリプトは、エージェントを実行したマシン上に書き込まれます。アカウントには保存されず、クラウドにも同期されません。そのマシンのディスク上にあるファイルです。

そのため、VPS の tmux ウィンドウに残したセッションは、ラップトップのセッション選択画面には表示されません。ラップトップのセッションも VPS には表示されません。両者の間でデータが移動することはありません。多くの人が VPS 上の tmux で Claude Code を実行する方法で作業する場合、実際の会話履歴はサーバーに蓄積されます。一方、ローカルで表示されるセッション選択画面には、別の、より少ないセッションしか表示されません。

同じ分離はインターフェース間でも発生します。デスクトップアプリと VS Code 拡張機能は、それぞれ独自のセッション履歴を保持します。どちらも CLI の履歴とは別ですが、デスクトップアプリから CLI セッションを再開することはできます。Claude Code on the web も独自の履歴を保持します。Cowork はさらに別の仕組みです。デフォルトではセッションが Anthropic のクラウドで実行され、所有するハードウェアではなく Claude アカウントに保存されます。ローカル実行が維持されるのは、既存のデスクトップ環境だけです。そのため、Cowork と Claude Code のどちらを選ぶか検討している場合、トランスクリプトの保存先も判断材料になります。

1 台のマシン内では、検索範囲は想像より広くなります。claude --resume <session-id> はまず現在のプロジェクトディレクトリと、その git worktree を検索し、続いてそのマシン上にある他のすべてのプロジェクトを検索します。覚えておくべき点は「そのマシン上」です。別のホストのセッション ID は解決されず、Claude Code は No conversation found with session ID: <session-id> でそのことを通知します。

Claude Code はセッション履歴をどこに保存しますか

デフォルトでは、トランスクリプトは Claude Code の設定ディレクトリ内に、~/.claude/projects/<project>/<session-id>.jsonl の形式のパスで保存されます。

<project> は、作業ディレクトリのパスに含まれる英数字以外の文字をすべてハイフンに置き換えたものです。そのため、/home/deploy/apps/api で開始したセッションは、-home-deploy-apps-api という名前のディレクトリに保存されます。変換後の名前が 200 文字を超える場合、Claude Code は名前を切り詰め、完全なパスのハッシュを追加します。これにより、ディレクトリ名がファイルシステムの制限内に収まります。

ファイル形式は JSONL です。1 行に 1 つの JSON オブジェクトが記録されます。各行には、メッセージ、ツールの使用またはその結果、Claude Code がモデルに送信したリクエスト、またはメタデータのエントリが含まれます。テキストとして読み取れるため、内容を読むこと自体に問題はありません。

ただし、このファイルを直接解析するスクリプトを書くことは推奨されません。エントリの形式は Claude Code の内部仕様であり、バージョン間で変更されます。そのため、これらのファイルを直接読み取るスクリプトは、更新のたびに動作しなくなる可能性があります。Anthropic の公式ドキュメントでも、代わりに /export またはドキュメント化されたスクリプトインターフェイスを使用するよう説明されています。この理由からも、適切な方法です。

2 つの設定によって保存場所と保存期間を変更できます。CLAUDE_CONFIG_DIR は設定ディレクトリ全体を移動します。これにより、トランスクリプトを別のボリュームや暗号化されたボリュームに保存できます。cleanupPeriodDays を settings.json に設定すると保存期間を変更できます。デフォルトは 30 日で、最小値は 1 です。

トランスクリプトファイルの実際の内容

すべてのツール結果が記録されるため、トランスクリプトには Claude が読み取ったファイルの内容と、Claude が実行したコマンドの出力が含まれます。Anthropic のデータ利用に関するページにも明記されています。Claude Code は、セッションのトランスクリプトを ~/.claude/projects/ 配下にプレーンテキストでローカル保存します。トランスクリプトには Claude Code がモデルへ送信する内容も記録されるため、system prompt、ツール定義、リクエストパラメータ、読み込まれた CLAUDE.md ファイルが含まれる場合があります。

サーバー上で何を意味するか考えてみてください。サービスが起動しない原因を調べるために Claude が .env ファイルを読み取った場合、そのファイルの内容はホームディレクトリ内の JSONL ファイルに保存されています。コマンドが接続文字列を出力した場合、その文字列も記録されています。これは情報漏えいではありません。トランスクリプトは実行内容を記録します。それがトランスクリプトの目的であり、脅威モデルに含めるべき理由でもあります。

  • バックアップ: /home または /root を通常どおりバックアップすると、トランスクリプトもバックアップ先へコピーされます。除外設定を追加するか、プロンプトとファイル内容のコピーがバックアップストレージに保存されることを受け入れてください。
  • スナップショットとイメージ: どのような理由で作成した VPS スナップショットにも、ディレクトリ全体が含まれます。2 台目のサーバーを構築するために複製するイメージも同様です。
  • サーバー上の他のアカウント: 権限が厳格に設定されていると決めつけず、ls -ld ~/.claude ~/.claude/projects で自分でモードを確認してください。
  • 意図的なアップロード: /feedback コマンドは会話履歴を Anthropic へ意図的に送信し、/bug と /share も同じ経路で情報を送信します。フィードバックダイアログには、現在のセッションだけでなく、同じプロジェクトにおける過去 24 hours または 7 days の他のセッションが含まれる場合もあります。これらは自分で選択して実行する操作です。確認する前に、何に同意することになるのかを把握してください。

トランスクリプト自体を残したくない場合、CLAUDE_CODE_SKIP_PROMPT_HISTORY でトランスクリプトの書き込みを抑止できます。単一の非対話型 claude -p 実行に対しては、--no-session-persistence で抑止できます。どちらかを設定する前に、トレードオフを明確に理解してください。resume が読み取るのはトランスクリプトです。そのため、トランスクリプトがなければ resume もできません。

古い会話を見つける方法

claude --resumeでピッカーを開きます。実行中のセッション内では /resumeでも開けます。各行には、設定していればセッション名、設定していなければ生成されたタイトルが表示されます。最後のアクティビティからの経過時間、git ブランチ、ファイルサイズも表示されます。

ピッカーでは検索できます。/を押すか、そのまま入力を始めると、一覧を絞り込めます。覚えておくと便利なショートカットは、表示範囲を広げるものです。Ctrl+Aではこのマシン上のすべてのプロジェクトのセッションが表示され、Ctrl+Wでは現在のリポジトリのすべての worktree が表示されます。Ctrl+Bでは現在の git ブランチのセッションだけに絞り込めます。Spaceを押すと、選択したセッションの内容を確認してから再開できます。Ctrl+Rでは選択中のセッション名を変更できます。

セッションに名前を付けると、これらの操作が大幅に簡単になります。claude -n auth-refactorで名前付きセッションを開始できます。会話が実際の作業になったと気付いた時点で、/rename auth-refactorを実行して名前を付けることもできます。名前付きセッションは、shell から名前を指定して再開できます。

名前を付けていないセッションにも、生成されたタイトルが付きます。このタイトルは、最初のプロンプトを要約する小さく高速なモデルへのバックグラウンドリクエストによって作成されます。このタイトルは、ピッカーの行を識別するために使えます。また、再開時の識別子としても機能します。claude --resumeは、設定した名前と同じ方法でこのタイトルを解決します。ただし、my-app-3fのようなデフォルトの表示名は使えません。これは、名前を付けていない実行中のインタラクティブセッションの一覧に表示される名前です。その値を claude --resumeに渡しても、Claude Code はセッションを見つけられません。

適切なセッションを見つけるためにトランスクリプトを grep する

フレーズだけを覚えていて、ほかは何も思い出せないことがあります。トランスクリプトはテキストなので、検索できます。

grep -rl "nftables" ~/.claude/projects/

一致したトランスクリプトのパスが表示されます。.jsonl拡張子を除いたファイル名がセッション ID です。claude --resume <session-id>にはセッション ID を指定できます。claude --resumeにはトランスクリプトの絶対パスを直接指定することもできます。grep で使用するセッションを特定し、resume または export を実行して内容を確認します。

注意点が2つあります。内容は JSON 用にエスケープされているため、引用符を含むフレーズや、改行で分割されたフレーズは、リテラル文字列として一致しない場合があります。また、ツールの結果内で一致した場合、それは Claude がそのテキストを見たことを示すだけで、誰かが入力したことを示すものではありません。

会話の読み取りとエクスポート

/exportは、現在の会話をプレーンテキストとして表示します。メッセージとツールの出力は、JSON ではなく読みやすい形式で書き出されます。引数を指定しない場合は、クリップボードまたはファイルを選択するメニューが開きます。ファイル名を指定すると、/export handover.txtはそのパスへ直接書き込みます。サーバー上の会話をノートパソコンへ移したり、チケットに添付したりする場合に適した方法です。

自動化する場合は、安定した利用を前提として提供されているインターフェースを使用してください。フックとステータスラインのコマンドには、入力としてtranscript_pathフィールドが渡されます。そのため、SessionEndフックを使用して、セッション終了時にトランスクリプトをアーカイブできます。保存済みのセッションを開かずに質問することもできます。

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

これにより、以前の会話に追加のプロンプトが送信され、構造化された JSON が返されます。次のリリースで変更される可能性がある JSONL 形式を解析するよりも、はるかに堅牢な基盤になります。

新しく始めるほうが再開より適している場合

再開すると履歴全体が戻り、その後のすべてのリクエストに履歴全体が含まれます。昨日 4 時間続いた会話を今日続けるとコストが高くなります。長いセッションでトークン使用量がどのように積み上がるかでは、そのコストの実際の発生箇所を説明しています。

Claude Code が中間的な処理を行う場合もあります。対話型ターミナルセッションで長い会話をアイドル状態のままにし、プランの利用枠内で Claude サブスクリプションがメインの会話にデフォルトで提供する 1 時間のプロンプトキャッシュを使用している場合、アイドルコンパクションはキャッシュの期限切れ直前、約 54 分後に会話をコンパクションします。これは、会話のコンテキストがデフォルトで 200,000 トークンのしきい値に達し、自動コンパクションが有効で、その時点でマシンが稼働している場合に適用されます。v2.1.314 より前は、Claude Code が Anthropic から機能フラグを取得する必要もあったため、テレメトリを無効にしたサブスクライバーには適用されませんでした。v2.1.314 以降はそのユーザーにも適用され、VS Code 拡張機能のチャットパネルとデスクトップアプリの Code タブでも動作します。事前に確認を求めるダイアログは表示されません。戻ってくると、会話には Compacted while idle, before the prompt cache expired で始まる行が表示され、次のメッセージでは履歴全体ではなく要約が送信されます。

  • 有効にしておくと、その後のリクエストは安くなります。ただし、要約で削除された内容は利用できなくなります。CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS でしきい値を下げられますが、100,000 未満の値は 100,000 に引き上げられます。
  • settings.json で idleCompaction を false に設定するか、v2.1.302 以降の /config にある Idle compaction の行から無効にできます。無効にすると、会話は全体のまま維持され、リクエストごとのコストは会話のサイズに応じて増加します。次のメッセージを送る時点でキャッシュの期限が切れている場合、そのリクエストでは履歴全体が 1 回再処理されます。

Pro プランと Max プランでは、v2.1.304 で別の確認処理が追加され、現在のドキュメントには Ultra プランも記載されています。長い中断の後に長い会話を再開する場合、または別のモデルで再開する場合に、5 時間の利用上限のうち無視できない割合を使用すると見込まれると、Resume this conversation? ダイアログに推定割合が表示され、再開するか、新しい会話を開始できます。新しい会話の選択肢にその旨が示されている場合、以前の会話を参照すれば Claude がその会話を検索できます。

判断は見た目ほど複雑ではありません。これから入力する内容が、すでに話した内容に依存するなら再開します。依存しないなら新しく始めます。古いコンテキストの影響は、意識して確認すると簡単に見つかります。たとえば、Claude が 1 時間前に削除したファイルに言及したり、セッションの冒頭で決めた事項を再び議論したりする場合です。これは古いコンテキストです。そのまま引き継ぐと、トークンと精度を同時に失います。

古い会話の有用な部分が、後で再び必要になる決定や事実である場合、再開によって保持されることに頼らないでください。すべてのセッションから参照できる場所に書き留めます。そのために Claude Code のメモリファイルを使用します。

ここでは /branch についても知っておくと便利です。現在の時点までの会話をコピーし、そのコピーに切り替えます。元の会話は変更されず、選択画面にも残ります。最初の方法を失わずに別の方法を試す場合に使用します。

resume と compaction、memory の違い

これらは頻繁に混同されますが、解決する問題はそれぞれ異なります。

resume は、終了、再起動、または別の作業への移行後に、会話を再び利用できる状態にするための機能です。compaction は、継続中の会話で context window を管理するための機能です。/compact によって Claude が保持している内容が要約に置き換えられるため、後続のリクエストで送信される token 数を減らせます。context window がいっぱいになっている場合は compaction を使用します。詳しくは Claude Code の context window を管理する を参照してください。

memory はさらに別のものです。CLAUDE.md ファイルと auto memory には、すべての session の開始時に読み込まれる指示と事実が保存されます。そのため、これらは戻る対象の会話ではありません。二度と戻る必要がないように、書き留めておく情報です。

2 つの会話を同時に実行し、相互に連携させたい場合は、別の仕組みを使用します。両方が実行中であれば、Claude Code session 間でメッセージを送信することができます。これは、前日の session をディスクから再び読み込む問題とは異なります。

FAQ

Claude Code はセッション履歴をどこに保存しますか?

デフォルトでは、設定ディレクトリ内の ~/.claude/projects/<project>/<session-id>.jsonl に保存します。<project> は、英数字以外の文字をハイフンに置き換えた作業ディレクトリのパスです。各ファイルは JSONL 形式で、1 行に 1 つの JSON オブジェクトを含みます。オブジェクトには、メッセージ、ツールの使用またはその結果、モデルに送信したリクエストの記録、メタデータエントリのいずれかが記録されます。CLAUDE_CONFIG_DIR を指定すると、設定ディレクトリを別の場所に移動できます。settings.json 内の cleanupPeriodDays では、トランスクリプトの保存期間を設定できます。デフォルトは 30 日で、最小値は 1 日です。

ノートパソコンのピッカーに VPS のセッションが表示されないのはなぜですか?

トランスクリプトはエージェントを実行したマシンのディスクに保存され、マシン間では同期されないためです。VPS 上の tmux 内で行った会話は、VPS にしか存在しません。SSH 経由で VPS 上で再開してください。ローカルに記録を残したい場合は、その中で /export を実行し、テキストファイルをコピーします。

別のディレクトリで開始したセッションを再開できますか?

セッション ID があれば再開できます。claude --resume <session-id> は、まず現在のプロジェクトディレクトリとその git worktree を検索し、次に同じマシン上の他のすべてのプロジェクトを検索します。ピッカー内で Ctrl+A を指定すると、マシン上のすべてのプロジェクトに候補が広がります。Ctrl+W を指定すると、現在のリポジトリにあるすべての worktree に候補が広がります。一致するものがない場合、Claude Code は No conversation found with session ID: <session-id> を報告します。

古いセッションを再開すべきですか、それとも新しいセッションを開始すべきですか?

次のメッセージが、その会話ですでに話した内容に依存する場合は再開します。依存しない場合は新しく開始します。再開すると履歴全体が読み込まれ、その後のすべてのリクエストに履歴が含まれるためです。コンテキストのずれにも注意してください。すでに削除したファイルをセッションが参照し続けている場合、古いコンテキストが残っています。そのコンテキストは、やり取りのたびにトークンと精度を消費します。

Claude Code によるトランスクリプトのディスクへの書き込みを停止できますか?

できます。CLAUDE_CODE_SKIP_PROMPT_HISTORY はトランスクリプトの書き込みを抑止します。--no-session-persistence は、非対話型の claude -p の 1 回の実行に限って書き込みを抑止します。まず、この変更による影響を理解してください。resume はトランスクリプトを読み込むため、書き込みを無効にすると --continue と --resume に読み込むものがなくなります。ファイルの存在自体ではなく保存場所が懸念であれば、CLAUDE_CONFIG_DIR を暗号化ボリュームに指定し、代わりに cleanupPeriodDays を短くしてください。

この記事は役に立ちましたか?