MENU

Claude Codeのセッションを再開するには?中断した作業を爆速で復旧させる基本コマンド!

ターミナルで爆速開発をサポートしてくれるClaude Codeですが、作業を中断した後にどうやって元の状態に戻るか迷うこともありますよね。実はClaude Codeのセッション管理は非常に洗練されており、これまでの試行錯誤を「資産」として引き継ぐことができます。ここでは、スムーズに作業を再開するための基本的な知識を、初心者の方にも分かりやすく深掘りして整理しました。

目次

Claude Codeでセッション再開をする基本

セッション履歴の確認方法

Claude Codeを使いこなす第一歩は、自分の対話がどこに記録されているかを知ることです。Claude Codeでは、過去のやり取りがクラウド上ではなく、原則として自分のPC内のローカルストレージに保存されます。これにより、オフライン環境でも過去のログを振り返ったり、プライバシーを保ちながら履歴を管理したりすることが可能になっています。

具体的には、MacやLinux環境であれば ~/.claude/projects/ という隠しディレクトリの中に、プロジェクトごとの履歴が整然と格納されています。このディレクトリを覗いてみると、プロジェクトごとにUUID(一意の識別子)が振られたサブディレクトリが存在し、その中に実際の会話ログが含まれています。自分がどのセッションを再開したいか迷ったときは、無理にコマンドを打たなくても、このフォルダ構成を確認するだけで「あ、あの時の作業だ」と直感的に把握できるはずです。

技術的な側面を少し補足すると、セッション履歴はJSONL(JSON Lines)形式というテキストファイルで保存されています。これは1行ごとに1つのJSONオブジェクトが完結している形式で、万が一ターミナルがクラッシュしたり、書き込み中に電源が落ちたりしても、ファイル全体が破損するリスクを最小限に抑える工夫がなされています。エディタで直接開いて中身を読むこともできるので、過去にClaudeが提案した特定のコード片を検索したい時などにも重宝しますね。こうした堅牢な設計があるからこそ、私たちは安心して長時間の開発作業をAIに任せられるわけです。

プロの知恵袋:
JSONL形式のログファイルを grep コマンドなどで検索すれば、過去の全セッションから特定のキーワード(例:関数名やエラーメッセージ)を爆速で探し出すことも可能です。ターミナル使いなら覚えておいて損はないテクニックですよ!

セッション継続のメリット

一度中断した作業を、またゼロから説明し直すのは精神的にも時間的にもなかなかの苦行ですよね。セッションを継続して再開する最大のメリットは、Claudeのエージェントが「文脈(コンテキスト)」を完全に保持した状態で戻ってきてくれることです。これまでどのファイルを修正し、どんな依存関係を解決し、最終的にどんなコンソールエラーに直面していたのか……。これらの情報を説明し直す手間が省けるだけで、開発のスイッチを入れるハードルがグッと下がります。

そして、何より無視できないのがAPIコストの圧倒的な節約効果です。セッションを新規で立ち上げるたびに同じソースコードを読み込ませると、その都度大量のトークンを消費してしまいます。しかし、既存のセッションを再開すれば、Claudeは以前の分析結果を内部的に再利用しようとします。これにより、同じ分析を繰り返す無駄な課金を防ぎ、お財布に優しい開発が可能になります。特に大規模なリファクタリングや、数日間にわたる複雑な機能実装など、タスクのスコープが広い場合ほど、この「一貫性の維持」と「コスト効率」の恩恵は大きくなります。

さらに、セッションを継続することで、Claudeとの「呼吸」も合ってきます。例えば、「さっきの修正方針で行こう」といった曖昧な指示でも、前後の流れを汲み取って正確に動いてくれるようになります。これは単なる効率化を超えて、まるでチームメイトと一緒に並走しているような、心地よい開発体験(DX)に繋がるポイントかなと思います。短期的なタスクなら使い捨てでも良いですが、プロジェクトの核となる部分を触るなら、セッションの継続はもはや必須と言えるでしょう。

コマンドの使い方と基本

Claude Codeの操作感は、極限までシンプルに設計されています。基本的にはターミナルで claude と打ち込むだけで魔法のように新しい会話が始まりますが、真価を発揮するのは特定の「フラグ」を組み合わせた時です。これを知っているかどうかで、再開作業のストレスが100倍くらい変わってきます。初心者のうちは、難しいことを考えずに「続きをやりたい時はオプションを足す」というルールだけ覚えておけば大丈夫です。

基本となるのは、後述する –continue–resume といったオプションですが、これらは特別な環境設定や複雑なConfigファイルを用意する必要がありません。ただコマンドの末尾に添えるだけ。まるでゲームのセーブデータをロードするかのように、昨日の続きからコーディングを再開できる感覚は、一度体験するともう元には戻れません。ターミナルを閉じる時に「あ、セーブし忘れた!」と焦る必要もありません。Claude Codeはあなたの背中を常に追いかけ、その足跡を刻み続けてくれています。

また、コマンドライン引数として特定のファイルパスを指定しながら再開することも可能です。これにより、「セッションは継続しつつ、新しくこのファイルも見てほしい」といった柔軟な指示が最初から出せます。こうした柔軟性こそが、エンジニアに支持される理由の一つですね。まずは claude --help でどんなオプションがあるかパラパラと眺めてみるだけでも、新しい発見があるかもしれません。ツールを使いこなすワクワク感を、ぜひターミナルから感じてみてください。

起動フラグの活用法

Claude Codeを起動する際、状況に合わせて「フラグ」を使い分けることで、作業効率は劇的に向上します。特にセッション再開に関するフラグは、いわば「時空を操るボタン」のようなもの。これらをマスターして、スマートに開発を再開しましょう。

フラグ名役割と動作の詳細おすすめの具体的な場面
--continue現在のプロジェクトで「最後に行った会話」を自動的に特定して再開します。ランチ休憩から戻った時や、PCを再起動した直後など、とにかく「さっきの続き」をしたい時に最適。
--resume過去のセッション履歴を一覧表示し、対話形式で再開したいものを選べます。「3日前のあの修正案に戻りたい」「別のブランチで作業していた時のログを見たい」という時に便利。
--fork-session既存のセッション履歴を引き継ぎつつ、新しい分岐セッションとして開始します。今の文脈を壊さずに、「もしこのライブラリを導入したらどうなるか?」といった破壊的な実験を試したい時。
--session-id [ID]UUIDを指定して、特定のセッションを一発で呼び出します。スクリプトやエイリアスを組んで、特定の重要タスクを瞬時に立ち上げたい上級者向けの使い方です。

それぞれのフラグには明確な役割分担があります。普段使いなら --continue だけで事足りますが、複数の機能を並行して開発しているなら --resume で履歴をざっと眺めるのが正解です。また、個人的にイチオシなのが --fork-session です。これはGitのブランチを切る感覚に近く、メインの思考プロセスを汚さずに試行錯誤できるので、迷った時の「砂場(サンドボックス)」として非常に優秀ですよ。

セッションIDの指定方法

特定の作業をピンポイントで、寸分の狂いもなく呼び出したい……そんな時は、各セッションに割り振られた固有の「セッションID」を直接指定しましょう。Claude CodeのセッションはすべてUUIDという長い英数字の文字列で管理されています。一見するとただの無機質な記号の羅列ですが、これは宇宙に一つだけの作業履歴を示す住所のようなものです。

具体的な使い方は、ターミナルで claude --session-id [ID名] と入力するだけです。このIDは、claude --resume コマンドを打った時に表示されるリストから確認することができます。大規模なプロジェクトにおいて、「認証機能の実装」「UIの微調整」「データベースの移行」など、全く異なるコンテキストのタスクを同時に進めなければならない場合、このID指定が救世主になります。前の作業の文脈が混ざることなく、独立した思考スペースを一瞬で確保できるからです。

少し上級者向けのテクニックとして、進行中の重要なタスクのIDを TODO.md などにメモしておくのもアリですね。そうすれば、チームメンバーに「このセッションIDの履歴を見ておいて」と伝えるだけで、自分たちがどんな議論を経てそのコードに辿り着いたのか、思考のプロセスを共有する足がかりにもなります(※ただし、現状はローカル保存なので、ファイル自体の共有が必要です)。この「特定の過去を狙い撃ちにする」感覚を覚えると、Claude Codeが単なるツールではなく、過去の自分と対話するためのインターフェースに進化します。

セッション名の付け方

いくら便利でも、550e8400-e29b-41d4-a716-446655440000 みたいな長いIDを覚えるのは、正直言って無理ですよね。人間の脳には優しくありません。そこでぜひ活用してほしいのが、セッションに分かりやすい「名前」を付ける機能です。これを行うだけで、管理の手間が驚くほど軽減されます。

やり方はとても簡単。Claudeとの会話の中で、スラッシュコマンド /rename [好きな名前] を打ち込むだけです。例えば、バグ修正中なら /rename fix-login-bug、新機能のブレスト中なら /rename feature-idea-v1 といった具合ですね。こうして名前を付けておけば、次回以降 claude --resume fix-login-bug と入力するだけで、迷わず目的の場所にジャンプできます。これはまさに、本の「しおり」にラベルを貼るような感覚です。

特に初心者の方に強くおすすめしたいのが、「日付+タスク名」の形式で名前を付ける習慣です。後で見返した時に「あ、これは先週の月曜に悩んでいたやつだ」と一目で分かります。整理整頓が得意なエンジニアは、Claudeとの対話の終わらせ方もスマート。作業を終える直前に /rename で名前を付けて、スッキリした気持ちでターミナルを閉じる。この小さな積み重ねが、翌日の自分の生産性を最大化してくれるはずです。ぜひ今日から取り入れてみてくださいね!


Claude Codeのセッション再開のコツ

基本操作をマスターしたあなたへ。ここからは、Claude Codeをさらに「賢く、そして低コストで」使い倒すための、一歩踏み込んだテクニックをご紹介します。AIを道具として使うステージから、パートナーとして最適化するステージへと進んでいきましょう。

プロンプトキャッシュの仕組み

Claude Codeを語る上で絶対に外せないのが、Anthropicが提供する革新的な「プロンプトキャッシュ(Prompt Caching)」の技術です。これは、あなたが送信した長いコードや膨大な会話履歴を、AI(Claude)側で一時的に「学習済み状態」として保存しておく仕組みです。通常、AIは毎回すべての情報を最初から読み直しますが、キャッシュが効いていると「あ、これはさっき読んだから飛ばしていいよ」とショートカットしてくれるんです。

この仕組みの何が凄いかというと、再開時の読み取り料金が通常の約10分の1(90%オフ!)という驚異的な安さになることです。さらに、読み込み時間をスキップするため、レスポンスの速さも劇的に向上します。まさに「速い・安い・美味い」の三拍子が揃った機能。ただし、このキャッシュには有効期限があることに注意してください。一般的には最後にメッセージを送ってから一定時間(数分〜1時間程度)が勝負です。こまめに再開して作業を繋げることで、キャッシュを常に「温かい」状態に保つのが、お財布を守る最大の秘訣となります。

(出典:Anthropic公式ドキュメント 『Pricing – Claude API Docs』

プロンプトキャッシュの重要指標:
Claude APIの最新仕様では、キャッシュされたトークンの読み取り(Cache Read)は、通常の入力トークンのわずか10%程度のコストで済みます。長大な履歴を抱えるセッションほど、このキャッシュの恩恵は計り知れません。1時間以内に再開する「クイック・リターン」を意識してみましょう!

トークン節約とコスト管理

会話を重ねれば重ねるほど、Claudeは賢くなりますが、同時に「記憶(トークン)」が肥大化していきます。これは、毎回のラリーで過去の全履歴を送信し直すため、放っておくと塵も積もって山となり、思わぬ請求額に驚く原因にもなりかねません。そこで活用したいのが、魔法のコマンド /compact です。セッションを再開して「あ、少し履歴が長くなってきたな」と感じたら、迷わずこのコマンドを打ち込んでください。

/compact を実行すると、Claudeはこれまでの冗長なやり取りを自分で分析し、重要なコンテキスト(技術的決定事項や現在の修正状況など)をギュッと凝縮した「要約」に置き換えてくれます。これにより、本質的な記憶は維持したまま、不要なトークンを一掃できるんです。コスト計算のイメージは以下の通りですが、要約によって「新規入力分」のベースラインを下げるのが狙いです。

コストの概念イメージ:
合計コスト = (キャッシュされた既読分 × 0.1) + (要約後の履歴 + 新規指示 × 1.0) + (新たなキャッシュの書き込み分)

また、不要になった過去のセッションを /forget コマンドで物理的に削除することも、ストレージの節約だけでなく精神的な整理に繋がります。コスト管理とは、単にお金を節約することではなく、AIに「今、本当に必要な情報だけ」を集中させるための高度なディレクション術だと言えるでしょう。

履歴の要約と整理術

Claude Codeには「セッションメモリ」という、目に見えない裏方が常に働いています。これはバックグラウンドであなたの作業を観察し、プロジェクトの特記事項をサマリーとしてまとめてくれる機能です。新しいセッションを立ち上げた際、ターミナルに「Recalled memories」という緑色の文字が表示されることがありますが、これはまさに過去の知見が自動で召喚された証。あなたが教えた「このプロジェクトではこのディレクトリ構造が重要」「テストは必ずこのコマンドで実行する」といった暗黙のルールを、Claudeがそっと引き出しから出してきてくれているのです。

もし、特定のルールを「一時的な記憶」ではなく「永遠の掟」として覚えさせたい場合は、/remember コマンドを使ってください。これを使うと、プロジェクト直下の CLAUDE.md というファイルに重要な知識を昇格させることができます。このファイルは、Claude Codeが起動時に必ず参照する「聖典」のような役割を果たします。セッションを再開するたびに同じ指示を繰り返す必要がなくなり、指示の精度が格段に安定します。履歴の整理とは、単なる削除ではなく、価値ある情報を「磨いて残す」作業だと言えますね。

ファイルパスと同期の注意点

ここで、実運用でハマりがちな注意点を一つ共有しておきます。Claude Codeのセッション管理は、非常に厳密に「ディレクトリの絶対パス」に紐付いています。これは、AIが「今、自分がどの環境で作業しているか」を間違えないための安全策なのですが、マルチデバイスで作業する際には少し厄介な壁になります。

環境移行時の落とし穴:
例えば、会社のMacで /Users/tanaka/project で作業していた履歴は、自宅のWindowsで C:\Users\Sato\project に同期しても、パスが異なるため別プロジェクトとして扱われてしまいます。セッション履歴ファイルを手動で移動させたとしても、パスの不一致で「セッションが見つからない」というエラーが出る場合があるため注意が必要です。

もし複数のPCで同じセッションを継続したい場合は、プロジェクトのルートディレクトリを揃えるか、シンボリックリンクを駆使してパスを擬似的に一致させるなどの工夫が必要になります。現時点では、マシンを跨いだ公式の同期機能は実装されていないため、「重い作業はこのマシンで完結させる」という割り切りも、今のAI開発においては賢い選択かもしれませんね。

エラーや消えた時の対処法

「昨日まであったはずのセッションが、リストに出てこない!」……そんな絶望的な瞬間が訪れても、冷静に対処すれば道は開けます。まずは落ち着いて、今いるディレクトリ(カレントディレクトリ)が正しいか pwd コマンドで確認しましょう。前述の通り、パスが1文字でも違うとClaude Codeは他人行儀になってしまいます。正しい場所にいるのに表示されない場合は、~/.claude/projects/ 内のJSONLファイルが破損していないか、直接ファイルサイズなどをチェックしてみてください。

また、セッションを再開したものの、Claudeの返答が支離滅裂になったり、記憶が混濁しているように感じたりすることもあります。そんな時は、特定のメッセージまで時を戻す /rewind コマンドの出番です。これを実行すると、1つ前、あるいは数個前のやり取りまで履歴をロールバックできます。「あの修正指示を出してからおかしくなったな」と特定できれば、そこまで巻き戻して別の指示を出し直す。まさにタイムリープのようなデバッグが可能です。どうしてもダメな時は、潔く新しいセッションを立てつつ、前回のログを cat で読み込ませて再学習させるという「強引な再開」も検討してみましょう。

Claude Codeでセッション再開するまとめ

いかがでしたでしょうか。Claude Codeのセッション再開機能をマスターすることは、単なる時短テクニックではなく、AIという知性を自分の開発フローに深く溶け込ませるための儀式のようなものです。最初は --continue で「昨日の自分」を呼び出し、慣れてきたら /rename で「整理された自分」を構築し、最後は /compact/remember で「洗練された知見」へと昇華させていく。このプロセス自体が、あなたの開発者としての成長を加速させてくれるはずです。

パスの依存性など、まだ発展途上で少し癖のある部分もありますが、それを差し引いてもClaude Codeが提供する「文脈を維持した開発」のパワーは圧倒的です。AIは魔法の杖ではなく、使いこなすほどに研ぎ澄まされる「最高の工具」です。ぜひ、今日から自分のプロジェクトでこれらのテクニックを試し、自分だけの最強の開発環境を構築してみてください。あなたのターミナルが、これまで以上にクリエイティブな場所になることを願っています!

最後に:
Claude Codeは現在進行形で進化しているツールです。より詳細な最新フラグや隠しコマンドを知りたいときは、迷わず claude --help を叩いて、公式の最新ヘルプをチェックする癖をつけましょう。新しい機能があなたの開発をさらに楽にしてくれるかもしれませんよ!

目次