セッションを再開する
セッションは作業中に ローカルトランスクリプトファイルに継続的に保存されるため、終了後または/clear を実行した後に再開できます。これらのエントリポイントを使用します。
Claude Code は
claude -pまたは Agent SDKで作成されたセッションをセッションピッカーから除外し、claude --continue からも除外します。セッション ID を claude --resume <session-id> に渡すことで再開できます。claude --continue を使用する場合、Claude Code は 最初のプロンプトが /loop だったセッションもスキップします。claude -p --continueを実行すると、Claude Code は -p、SDK、および /loop セッションを含めます。
claude --continue は完了した バックグラウンドセッションを開きますが、実行中のセッションは開きません。完了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。最新の会話が バックグラウンドに移動したセッションで、そこで実行中の場合、Claude Code は Your most recent conversation is running in the background と終了し、そのセッションの ID を表示します。claude agentsからセッションにアタッチするか、claude --resume を実行して別のセッションを選択します。
任意のディレクトリから claude --resume <session-id> を実行できます。Claude Code は現在のプロジェクトディレクトリとその git worktrees でまず ID を検索し、次にこのマシン上の他のすべてのプロジェクトで検索するため、他の場所で開始されたセッションや /cdで移動したセッションを見つけます。クロスプロジェクト検索は、正確に 1 つの他のプロジェクトがそれのメッセージを含むトランスクリプトを保持している場合にのみ ID を解決するため、手動でコピーされた重複は Claude Code が見つからないと報告し、任意のコピーを再開するのではなく、見つかりません。保存されたセッションが ID と一致しない場合、Claude Code は No conversation found with session ID: <session-id> と報告します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git worktrees で停止したため、セッションが最後に機能していたディレクトリから再開する必要がありました。
再開されたセッションが復元するもの
再開されたセッションは、会話とそれに保存された状態を復元します。- 会話履歴：ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したときに実行中だったツール（例えばクラッシュ）は、再開時に完了または再実行されません。Claude はその出力なしで続行します。
- モデル：セッションは使用していたモデルで続行されます。モデルが廃止されたか
availableModelsで許可されていない場合、--modelフラグまたはANTHROPIC_MODELファミリー環境変数が起動時に 1 つを選択する場合、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundryなどのプロバイダー固有のデプロイ ID を使用するプロバイダーの場合は復元されません。モデル設定の解決順序を参照してください。 - エージェント：
--agentまたはagent設定で開始されたセッションはそのエージェントとして続行され、ツール制限とモデルを保持します。再開時に--agentを渡して別のエージェントを選択します。どちらの場合のシステムプロンプトについては、再開された会話のシステムプロンプトフラグを参照してください。Claude Code は 2 つの場所でエージェントを検索します。セッションの元のディレクトリ（そのワークスペースを信頼している場合）、次に再開するディレクトリ。プロジェクトスコープのエージェントは別のディレクトリから再開する場合でも読み込まれます。Claude Code がどちらの場所でもエージェントを見つけられない場合、セッションはデフォルトのツールで再開され、エージェントに名前を付けた警告が表示されます。 - 権限モード：
claude --continue、claude --resume <session-id>、またはclaude --resume <name>（名前が 1 つのセッションと一致する場合）で-pなしでターミナルから再開する場合、Claude Code はセッションが存在していた権限モードを復元します。ただし、再開時の権限モードの場合は除きます。これはセッションピッカー、/resume、およびclaude -pで再開する場合もカバーします。--permission-modeまたは--dangerously-skip-permissionsを渡して復元されたモードをオーバーライドします。 - アクティブなゴール：セッションが終了したときにまだアクティブだった ゴールは引き継がれます。ターン数、タイマー、およびトークン支出ベースラインはリセットされます。
- スケジュール済みタスク：有効期限が切れていないタスクが復元されます。バックグラウンド Bash およびモニタータスクは復元されません。
--mcp-config、--settings、--plugin-dir、--fallback-model、または --add-dir で追加されたディレクトリに依存していた場合、再開時に再度渡します。セッション中に /add-dir で追加されたディレクトリは復元されませんが、セッションピッカーはセッションを見つけるためにそれらを使用します。settings.json や settings.local.json などの標準設定ファイルは起動時に再度読み込まれるため、それらに存在する設定を再度渡す必要はありません。--system-prompt および --append-system-prompt については、再開された会話のシステムプロンプトフラグを参照してください。
再開時の権限モード
再開されたセッションが開始される権限モードは、再開方法によって異なります。- ターミナル：
claude --continue、claude --resume <session-id>、またはclaude --resume <name>（名前が 1 つのセッションと一致する場合）で-pなし。Claude Code はセッションが存在していた権限モードを復元します。ただし、表の場合は除きます。--permission-modeまたは--dangerously-skip-permissionsを渡して復元されたモードをオーバーライドします。 - 非対話型：
claude -p --resumeまたはclaude -p --continue。Claude Code は新しいclaude -p実行が開始される権限モードで実行を開始します。ただし、プランモードで終了したセッションは 以下の条件下でプランモードで再開されます。 - VS Code：拡張機能の会話パネル。表は、プランモードで終了した会話のみをカバーします。その他については、過去の会話を再開を参照してください。
- 起動時のセッションピッカー：セッションピッカーから選択したセッション。
claude --resumeだけで開いたか、claude --from-prで開いたか、複数のセッションと一致する名前で開いたかに関わらず。Claude Code は保存された権限モードを復元しません。同じコマンドラインから新しいセッションを開始する権限モードでセッションを開始します。 - セッション内の
/resume（引数の有無を問わず）：Claude Code は保存された権限モードを復元しません。切り替える会話は、現在のセッションが存在する権限モードで続行されます。
claude -p --resume または claude -p --continue 実行は、4 つの条件すべてが成立する場合にのみプランモードで再開されます。
--permission-prompt-toolを渡すため、Claude Code は承認のためにプランを提示できます--permission-modeまたは--dangerously-skip-permissionsを渡さない--fork-sessionを渡さない- 実行が チャネルを通じて開始されていない
サマリーから再開
Pro または Max プランでは、約 1 時間以上非アクティブで 100,000 トークンを超えるセッションを再開すると、Claude Code は会話を復元してから、最初のメッセージを送信する前にダイアログを開きます。セッションの プロンプトキャッシュはその時点で有効期限が切れているため、ダイアログのオプションのどれを選択しても、次のリクエストは完全な履歴を 1 回処理します。 ダイアログはセッションを続行する 3 つの方法を提供します。各方法は、会話の各部分が後のリクエストにどの程度引き継がれるかが異なり、これはすべての詳細を保持することと、リクエストごとに送信するトークンを減らすことのトレードオフです。- サマリーから再開：
/compactを直ちに実行します。Claude Code は完全な履歴に対して 1 つの要約リクエストを送信し、その後履歴をサマリー、最新の交換、および最近読んだファイルまで 5 つに置き換えます。後のリクエストは完全な履歴の代わりにサマリーを実行します。 - セッション全体をそのまま再開：会話を変更せずに読み込みます。最初のメッセージを送信した後、Claude Code は完全な履歴を再処理してキャッシュし、キャッシュが温かいままの間は後のリクエストでキャッシュから再度読み込みます。
- 今後は聞かないでください：セッション全体を再開し、すべての将来の再開でダイアログの表示を停止します。
セッションピッカーが検索する場所
Claude Code はセッションをプロジェクトディレクトリごとに保存します。デフォルトでは、セッションピッカーは以下を表示します。- 現在の worktree からのセッション。バックグラウンドセッションを含み、リストで
bgとマークされています - 他の場所で開始され、
/add-dirで現在のディレクトリを追加したセッション
Ctrl+W を使用してリポジトリのすべての worktree に拡張するか、Ctrl+A を使用してこのマシン上のすべてのプロジェクトに拡張します。
最初のプロンプトが /loopコマンドだったセッションはピッカーに表示されず、claude --continue もそれらをスキップします。会話の後半で /loop を実行してもセッションは非表示になりません。v2.1.211 より前は、会話の早い段階で /loop 実行を行うと、セッションはピッカーから永続的に非表示になりました。
/cdでセッションを移動すると、新しいディレクトリのプロジェクトストレージに再配置されるため、その後そのディレクトリのピッカーに表示されます。v2.1.196 以降、移動されたセッションはクラッシュまたは強制終了後も古いディレクトリのピッカーから除外されたままになります。以前のバージョンでは、古いパスにアンダースコアなどの特殊文字が含まれている場合、クリーンでない終了後に古いディレクトリのリストに再度表示される可能性がありました。
同じリポジトリの別の worktree からセッションを選択すると、Claude Code はそこで再開します。セッション自体の worktree が存在しなくなった場合、Claude Code は 現在のディレクトリで再開します。関連のないプロジェクトからセッションを選択すると、Claude Code は cd と再開コマンドをクリップボードにコピーします。そのプロジェクトのディレクトリが存在しなくなった場合、Claude Code は失敗する cd コマンドをコピーするのではなく、現在のディレクトリでセッションを再開します。
名前で再開する場合は、現在のリポジトリとその worktree 全体で解決されます。どちらの形式も完全一致を探し、別の worktree に存在する場合でも直接再開します。
セッションに名前を付ける
セッションに説明的な名前を付けて、セッションピッカーで見つけやすく、名前で再開できるようにします。これは複数のタスクを並行して処理している場合に最も重要です。
CLI ルートまたは claude.ai からセッションに名前を付けたら、
claude --resume <name> または /resume <name> で再開できます。デスクトップアプリセッションはアプリで再開され、独自のセッション履歴が保持されます。worktree 全体での名前解決の動作については、セッションを再開するを参照してください。
このマシン上で既に実行中の別のセッションが既に使用している名前でインタラクティブセッションを開始または再開した場合、またはセッションをそのような名前に名前変更した場合、Claude Code は既に持っているセッションに名前を残し、auth-refactor-graceful-unicorn のような 2 語のサフィックスを持つバリアントに名前を変更し、その旨を通知します。自分で選びたい場合は、新しい名前で /rename を実行してください。v2.1.232 より前は、両方のセッションが名前を保持していました。
Claude Code が重複の名前を変更しない場合が 3 つあり、リストに同じ名前の 2 つのセッションが表示される場合があります。
- AI が生成したタイトルまたはデフォルト表示名をチェックしません。
- 起動時にバックグラウンドまたは
-pセッションの--nameをチェックしません。 - 以前のバージョンの Claude Code でセッションの名前を変更することはできません。
- デフォルト表示名：名前を付けないインタラクティブセッションでも、起動時にデフォルト表示名が自動的に付けられます。Claude Code v2.1.196 以降が必要です。デフォルト名は、作業ディレクトリの名前と 2 文字のサフィックスを組み合わせたもので、例えば
my-app-3fのようになり、agent viewやclaude agents --json出力などの実行中セッションのリストでセッションを識別します。デフォルト名は再開ハンドルではありません。claude --resumeまたは/resumeに渡した場合、Claude Code はセッションを見つけません。セッションに名前を付けるとデフォルト名がリストに置き換わり、プランを受け入れても置き換わります。 - 生成されたタイトル：セッションに名前を付けない場合、Claude Code はセッションのタイトルを生成します。タイトルは最初のプロンプトの短い要約で、通常は Haiku クラスモデルである小型/高速モデルへのバックグラウンドリクエストで作成されます。プランを受け入れるとプランに基づいたタイトルに置き換わります。セッションに名前を付けると生成されたタイトルが置き換わります。最初のプロンプトタイトルはセッションピッカーと、名前が設定されていない場合のステータスライン
session_nameフィールドに表示されます。プランタイトルは同じ 2 つの場所に表示され、実行中セッションのリストにも表示され、デフォルト表示名の代わりになります。claude --resumeまたは/resumeにいずれかのタイトルを渡すことができ、Claude Code は設定した名前と同じ方法で解決します。
セッションピッカーを使用する
セッション内で/resume を実行するか、引数なしで claude --resume を実行して、インタラクティブセッションピッカーを開きます。これらのキーボードショートカットを使用して、ナビゲート、検索、リストを拡張します。
各行は、セッション名が設定されている場合はそれを表示し、そうでない場合は AI が生成したセッションタイトル、会話の概要、または最初のプロンプト、最後のアクティビティからの経過時間、git ブランチ、およびファイルサイズを表示します。
Ctrl+A ですべてのプロジェクトに拡張して、各セッションのプロジェクトパスも表示します。
/branch または --fork-session で作成されたセッションは独自のセッション ID を取得し、別の行として表示されます。ピッカーが同じセッションの複数のエントリを見つけた場合、それらは単一の行の下にグループ化されます。グループを展開するには → を押します。
Claude Code が claude --resume ピッカーから選択したセッションを読み込めない場合、Failed to resume the conversation を出力し、再試行するコマンドを表示してから、終了コード 1 で終了します。セッション内の /resume ピッカーから、Claude Code は失敗を報告し、現在の会話は実行を続けます。
セッションを分岐させる
分岐は、これまでの会話のコピーを作成し、それに切り替え、元のセッションはそのままにしておきます。別のアプローチを試す際に、進めていたパスを失わないようにするために使用します。 セッション内から、オプションの名前を付けて/branch を実行します。
Branched conversation にフォールバックしていました。
コマンドラインから、--continue または --resume を --fork-session と組み合わせます。
/branch 確認は 2 つのセッション ID を出力します。現在いる新しいブランチと元のセッションです。元のセッションは変更されず、セッションピッカーで利用可能なままです。/resume <original-name> で元のセッションに戻るか、その ID を /resume に渡します。
/branch はトランスクリプトをコピーし、実行中の Claude Code プロセスをそれに書き込むように切り替えます。この区別により、ブランチが継承するものが決まります。
フォークせずに 2 つのターミナルで同じセッションを再開すると、両方からのメッセージが 1 つのトランスクリプトにインターリーブされます。単一セッション内のチェックポイントベースの巻き戻しについては、チェックポイントを参照してください。
セッション内でコンテキストを管理する
これらのコマンドは、セッションを離れることなくコンテキストウィンドウ内の内容を制御します。/clear：空のコンテキストで新たに開始します。Claude Code は以前の会話を保存します。/resumeで再開するか、同じ Claude Code プロセス内では、rewind メニューの前のセッションエントリから再開できます。引数がない場合、新しい会話は--nameまたは/renameで設定した名前を保持しますが、AI が生成したセッションタイトルは保持しません。代わりに、離れる会話に名前を付けるには、/clear release-prepのように名前を渡します。その後、新しい会話は名前なしで開始します/compact [instructions]：履歴を概要に置き換え、オプションで指定した内容に焦点を当てます/context：現在コンテキストを消費しているものを表示します
セッションデータをエクスポートして見つける
/export を実行して、現在の会話をクリップボードにコピーするか、プレーンテキストファイルとして保存するメニューを開きます。メッセージとツール出力は読みやすいテキストとしてレンダリングされます。ファイル名を渡して、メニューをスキップしてそのファイルに直接書き込みます。
スクリプトから会話にアクセスする
/export は人が読むためのレンダリングされたトランスクリプトを生成します。以下のインターフェースはスクリプトが解析するための構造化データを生成します。実行からの JSON 結果、セッションのトランスクリプトファイルへのパス、またはイベントのライブストリームです。スクリプトをトリガーするものによって選択してください。
- Claude を 1 回実行して結果をキャプチャする:
--output-format jsonまたはstream-jsonでclaude -pを呼び出して、非インタラクティブ実行の結果、セッション ID、使用状況、およびコストを構造化 JSON としてキャプチャします。 - 既存のセッションに質問する:
claude -p --resumeにセッション ID を渡して、フォローアップ プロンプト（要約リクエストなど）を送信し、構造化された応答をキャプチャします。 - セッションイベントに反応する: hooks と status line commands が入力として受け取る
transcript_pathフィールドを読みます。SessionEndhook はセッションが終了したときにトランスクリプトをアーカイブできます。 - TypeScript または Python アプリに Claude を埋め込む: Agent SDK を使用して、各メッセージをプログラムで受け取ります。
jq で答えを読みます。
トランスクリプトが保存される場所
デフォルトでは、Claude Code はトランスクリプトを~/.claude/projects/<project>/<session-id>.jsonl に JSONL として保存します。ここで <project> は作業ディレクトリパスで、英数字以外の文字が - に置き換えられています。作業ディレクトリの変換後の名前が 200 文字を超える場合、Claude Code は名前を 200 文字に切り詰め、フルパスのハッシュを追加するため、ディレクトリ名はファイルシステムの制限内に留まります。
各行はメッセージ、ツール使用、またはメタデータエントリの JSON オブジェクトです。エントリ形式は Claude Code の内部形式であり、バージョン間で変更されるため、これらのファイルを直接解析するスクリプトはリリースごとに破損する可能性があります。セッションデータを構築するには、代わりに /export または スクリプトインターフェース を使用してください。
場所、保持期間、および書き込み動作は設定可能です。
セッションデータを削除する
トランスクリプトは 保持スイープルール に基づいて期限切れになります。プロジェクトのトランスクリプトと関連する状態をより早く削除するには、claude project purge を実行してください。claude rm <id> で バックグラウンドセッション を削除した場合、そのトランスクリプトはディスク上に残り、claude --resume を通じて利用可能なままです。
プロジェクトディレクトリに自分で名前を付ける
デフォルトでは、Claude Code は<project> 名をワーキングディレクトリパス全体から導出します。自分で名前を選択するには、CLAUDE_CONFIG_DIR と一緒に CLAUDE_CODE_PROJECT_DIR_NAME を設定してください。Claude Code はそのセッションのトランスクリプトと 自動メモリ をあなたの名前の下に保存します。これは Claude Code を埋め込み、各セッションに独自の設定ディレクトリを与えるホストに適しています。Claude Code v2.1.234 以降が必要です。
たとえば、このローンチはテナント A のデータを /srv/tenant-a の下に保持し、そのプロジェクトディレクトリに work という名前を付けます。
/srv/tenant-a/projects/work/ に、その自動メモリを /srv/tenant-a/projects/work/memory/ に書き込みます。ワーキングディレクトリがどこであるかは関係ありません。
これを設定する場合、3 つのルールが適用されます。
CLAUDE_CONFIG_DIRも設定してください: 名前はワーキングディレクトリによって変わらないため、デフォルトの~/.claudeの下では、すべてのプロジェクトのトランスクリプトと自動メモリが 1 つのディレクトリにマージされます。Claude Code はCLAUDE_CONFIG_DIRが設定されていない場合、CLAUDE_CODE_PROJECT_DIR_NAMEを無視します。- 1 ～ 64 文字の英字、数字、ハイフン、またはアンダースコアを使用してください:
conなどの Windows デバイス名を使用しないでください。Claude Code は他の値を無視し、導出された名前を使用します。 claudeを開始するシェル環境で設定してください: Claude Code はスタートアップ時にその環境から一度だけ読み込むため、設定ファイルのenvブロックはそれを設定できません。
CLAUDE_CONFIG_DIR で Claude Code を開始しても CLAUDE_CODE_PROJECT_DIR_NAME がない場合、導出されたディレクトリを再度読み書きします。あなたの名前の下に保存されたセッションはディスク上に残ります。セッションピッカー で Ctrl+A を押して、その設定ディレクトリの下のすべてのプロジェクトディレクトリ（ピン留めされたものを含む）からセッションをリストアップし、どのようにローンチしても、claude --resume <session-id> はどちらの名前の下に保存されたセッションでも見つけます。
関連項目
これらのページは関連するセッションと並列処理のメカニクスについて説明しています。- Worktrees：別のブランチで分離された並列セッションを実行します
- Checkpointing：コードと会話を以前のポイントに巻き戻します
- Context window：コンテキストを満たすもの、圧縮後に残るもの
- Non-interactive mode：
claude -pの下でのセッション動作