【Claude Code】セッション管理入門──–continueと–resumeの違いを理解しよう

Claude Codeで作業をしていると、「さっきの会話の続きをやりたい」「昨日の解析結果を踏まえて次のステップに進みたい」と思う場面が頻繁にあります。そこで登場するのがセッション管理です。

この記事では、Claude Codeのセッション機能の基本として、--continue--resumeの違いを中心に解説します。対話モード・printモードの両方で使えるので、日常の開発作業からパイプラインの構築まで役立つ知識です。

前提知識

  • Claude Codeのインストールと基本操作(claude / claude -p)ができること
  • output-format jsonでJSON出力を扱えると、より理解が深まります

前提知識について詳しく知りたい人は以下の記事を参考にしてください。

【Claude Code入門】インストールから基本操作まで徹底解説
【Claude Code】printモード入門|パイプ連携とスクリプト活用の基本
【Claude Code】の出力形式を使いこなす――text・json・stream-jsonの違いと実践

セッションとは

Claude Codeでは、一連の会話のやり取りが「セッション」として管理されます。各セッションには一意のUUID(セッションID)が割り当てられ、会話履歴がローカルに保存されます。

セッションの永続化により、以下のことが可能になります。

  • 中断した作業の再開
  • 過去の会話の参照
  • パイプラインの段階的な実行

セッション関連オプションの全体像

オプション説明対話モードprintモード
-c, –continue直近のセッションを継続使用可使用可(プロンプト必須)
-r, –resume [ID]指定IDのセッションを再開使用可(ID省略でピッカー表示)使用可(ID必須
–session-id <uuid>セッションIDを固定使用可使用可
–fork-session再開時に元セッションを分岐使用可(-cか-rと併 用)使用可(-cか-rと併用)
–from-pr [value]PRに紐づくセッションを再開使用可使用可
–no-sessi on-persistenceセッションを永続化しない使用不可使用可(専用)

continueとresumeの違い

この2つは混同しやすいので、明確に区別しましょう。

  • –continue(-c): 最も最近のセッションを自動的に選んで継続する。セッションIDを知る必要がない。
  • –resume [ID](-r): 特定のセッションIDを指定して再開する。IDを省略すると一覧から選択できる。※printモードでのID省略は不可
時系列: セッションA → セッションB → セッションC(最新)

-c            → セッションCを継続
-r            → 一覧から選択
-r <AのID>    → セッションAを再開

continueの使い方

対話モードでセッションを作成し、終了した後に claude -c で継続できます。前回の会話の続きとして新しいプロンプトが表示され、コンテキストが保持されているため、前回の分析結果をそのまま活かせます。

printモードでもcontinueは使えます。注意点として、continueは直近の1つのセッションのみを対象とします。複数セッションを行き来したい場合はresumeを使ってください。

resumeでセッションIDを指定して再開する

セッションIDを使って特定のセッションを再開するには、まずIDを知る必要があります。printモードでoutput-format jsonを使うと、レスポンスにsession_idが含まれます。

IDを省略すると一覧から選択できます。printモードでもresumeを使って、以前の会話の文脈で新しい質問ができます。

no-session-persistenceでセッションを残さない

CI/CD環境など、セッションの永続化が不要な場合は --no-session-persistence を使います。このオプションを使うと、セッションがローカルに保存されず、continueやresumeで再開できなくなります。

本番パイプラインでは基本的にno-session-persistenceを使い、デバッグが必要な場合のみセッションを永続化するのが推奨パターンです。

次に試してみよう

  • 対話モードでセッションを作り、continueで継続してみましょう。前回のコンテキストが保持されていることを確認してください。
  • output-format jsonでセッションIDを取得し、resumeで指定再開を試してみましょう。

さらに深く学びたい方へ
Claude Codeの Skills・MCP・Agent・Hooks・Plugin を体系的に学べる有料教材を Zenn で公開しています。
Claude Code 実践ガイド(Zenn Book)