Claude Codeの履歴はなぜ30日で消える？保存場所・残す設定・消す方法を実測

Claude Codeの履歴はどこに保存されますか？

Claude Code の履歴は、ホームフォルダ直下の ~/.claude/ に平文のファイルとして保存されます。中心になるのは会話の記録（トランスクリプト）で、~/.claude/projects/<作業フォルダ名>/<セッションID>.jsonl に1セッション1ファイルで書かれます。作業フォルダ名は、フォルダの絶対パスの記号を「-」に置き換えたものです（公式ドキュメント「Manage sessions」）。

「履歴」と呼ばれるものは、実は3種類あります。役割と場所が違うので、最初に分けておきます。

手元の Mac では ~/.claude/projects/ の下に508個のフォルダ、合計2.9GB の記録がありました。公式ドキュメントが強調しているとおり、ツールを通ったものはすべて記録に書かれます。Claude が読んだファイルの中身、コマンドの出力、貼り付けたテキストがそのまま入り、守っているのはOSのファイル権限だけです。顧問先の決算書を読ませれば、その数字が記録ファイルに残ると考えてください。

なぜClaude Codeの履歴は30日で消えるのか？

Claude Code は、ターミナルで始めた会話の記録のうち、設定 cleanupPeriodDays（既定30日）より古いものを、セッション開始後にバックグラウンドの「掃除」で削除します。削除時にメッセージは出ず、消えた会話は /resume の一覧からも消えます（公式の設定リファレンス）。Claude Desktop や Cowork で始めた記録は、後述のとおり v2.1.248 以降は既定で対象外です。

値は1以上の整数で、0 を指定すると設定エラーになります。「消えない設定」は無く、3650 のような大きな値で実質的に無期限にする、というのが公式の案内です。

掃除の頻度にも決まりがあります。監視の公式ドキュメントによると、掃除は1セッションに最大1回で、同じ端末で過去24時間以内に掃除が走っていれば、次の掃除は10分以上遅らされます。つまり、毎日使っている端末では「翌日以降に最初に起動したセッションの、起動から少し後」に消えます。ちょうど30日目に消えるわけではなく、31日目かもしれませんし、しばらく起動しなければ消えません。

手元で40日前の記録を置いて再現した結果

公式の説明どおりに動くかを、2026年10月17日に Claude Code v2.1.302（macOS）で確かめました。架空のプロジェクトフォルダを ~/.claude/projects/ の下に作り、更新日時を40日前（9月7日）にした記録ファイル、2日前の記録ファイル、40日前の自動メモリ、40日前の編集前スナップショット（file-history）を置きます。前回の掃除から24時間たっていなかったため、掃除の実行日時を記録するマーカーファイル .last-cleanup を一度外し、短い claude -p を1回実行しました。

40日前の記録は、ターミナルに何も表示されないまま消えました。一方で自動メモリは40日前のまま残り、入力履歴は9か月分が残っています。この違いが、次の節の「消えるもの・消えないもの」の根拠になります。

消えた記録の多さを示す報告もあります。2026年10月5日に GitHub の issue #99817 を立てた利用者は、デスクトップアプリに記録された97セッションのうち76本の記録がディスクから消えていたと、自分で突き合わせた監査結果を載せています。同じ内容の issue は2026年5月14日の #59248 から5件先行していると本人が補足しており、研究助成の申請書類の作業経緯が追えなくなったという実害も書かれています。なお、この利用者の記録が消えたのは2026年3月から6月で、Desktop 起点の記録を保持するようになった v2.1.248（2026年8月27日）より前の出来事です。現在のバージョンでは、Desktop で始めた記録はこの形では消えません。

Claude Codeの履歴で消えるもの・消えないものは？

30日の掃除で消えるのは、会話の記録と、それに付随する作業ファイル（スナップショット、計画、Claude が書いた mod など）です。入力履歴、自動メモリ、そして Claude Desktop や Cowork で始めた会話の記録は、既定では消えません。公式の一覧から、業務で関係の深いものを抜き出します。

Desktop の例外は手元でも確認できました。CLI の記録で30日を超えて残っているものは0本でしたが、Claude Desktop から始めた2本（8月14日と9月1日更新）はそのまま残っていました。記録の先頭行には起動元を示す entrypoint: claude-desktop が書かれており、Claude Code はこれで区別しているようです。

もう1つ覚えておきたいのは、claude -p に --bare を付けた実行では掃除そのものが走らないことです。定時実行のスクリプトを --bare だけで回している端末は、人が対話で起動するまで古い記録が残り続けます。

Claude Codeの履歴を消えないようにする設定

履歴を残す方法は3段階あります。保持期間を延ばす設定、セッション終了時に記録を自動で退避するフック、人が読める形で保存する /export です。どれも「これから作られる記録」にしか効きません。Bryce Watson 氏が自身のブログで書いているとおり、設定は未来を守りますが、残さなかった過去は何も守ってくれません。

1. 保持期間を延ばす（cleanupPeriodDays）

ユーザー設定 ~/.claude/settings.json に次の1行を足します。公式の設定リファレンスは、長期保持の例として 3650（約10年）を挙げています。プロジェクトの .claude/settings.json にも書けますが、記録の保持は人（端末）単位で決めるものなので、ユーザー設定に置くのが自然です。

{
  "cleanupPeriodDays": 3650
}

設定が効いているかは、対話中に /status で確認できます。設定ファイルに書き損じがあると、Claude Code は保持期間を「判断できない」として掃除を止め、/status に警告を出します（組織の managed settings が値を定めていれば、その値で掃除は続きます）。

Claude Desktop や Cowork の記録に上限を付けたい場合は、逆に desktopSessionCleanupPeriodDays を指定します。こちらは cleanupPeriodDays と両方の期限を過ぎたときに消える仕組みで、例えば 7 を指定しても cleanupPeriodDays が既定の30なら30日残ります。

2. セッション終了時に記録を退避する（SessionEnd フック）

保持期間を延ばすだけでは、記録は ~/.claude の中に散らばったままです。顧問先ごとの作業記録として扱うなら、セッションが終わるたびに記録ファイルを案件フォルダへコピーするほうが実務に合います。公式ドキュメントは、hooks が受け取る transcript_path を使い、SessionEnd フックで記録を退避する方法を案内しています。

実際に、プロジェクトの .claude/settings.json に次のフックを書いて試しました。セッション終了時に、記録ファイルを作業フォルダ内の archive/ へ日時付きの名前でコピーします。

{
  "hooks": {
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 -c \"import sys,json,shutil,os,datetime; d=json.load(sys.stdin); p=d['transcript_path']; dst=os.path.join(os.getcwd(),'archive', datetime.datetime.now().strftime('%Y%m%d-%H%M%S')+'-'+os.path.basename(p)); shutil.copy2(p,dst); print('archived',dst)\""
          }
        ]
      }
    ]
  }
}

短い claude -p を1回実行すると、終了直後に archive/20261017-155948-<セッションID>.jsonl が作られました。1往復だけの会話でも31行・約309KBあり、CLAUDE.md などの添付がそのまま含まれています。退避先を案件フォルダにすれば、30日の掃除とは無関係に記録が残ります。ただし退避した記録にも顧問先のデータが平文で入るので、置き場所はほかの業務書類と同じアクセス権で守ってください。

3. 人が読める形で保存する（/export）

記録ファイル（JSONL）の形式は Claude Code の内部仕様で、バージョンごとに変わります。公式ドキュメントは、スクリプトで直接解析せず、人が読む用途には /export を使うよう案内しています。/export は会話中に実行すると、メッセージとツール出力を読める文章にして、クリップボードかテキストファイルに保存します。ファイル名を引数に渡せばメニューを飛ばして直接書き出せます。「この案件で Claude に何をさせたか」を上長や顧問先に説明する資料としては、JSONL より /export の出力のほうが扱いやすいでしょう。

補足: 保存先そのものを移す（CLAUDE_CONFIG_DIR）

環境変数 CLAUDE_CONFIG_DIR を指定すると、~/.claude の代わりに任意のフォルダへ記録と設定を置けます。バックアップ対象のドライブや、案件ごとに分けたフォルダを指定する使い方ができます。v2.1.234 以降は CLAUDE_CODE_PROJECT_DIR_NAME と組み合わせて、作業フォルダに関係なく記録の置き場所の名前を固定することもできます。

士業・バックオフィスの記録保全をどう設計するか

当研究所の見解では、業務で Claude Code を使う組織は「残す記録」と「残さない記録」を先に決め、残す側は退避、残さない側は短い保持期間、という2系統で設計するのが現実的です。保持期間を一律に延ばすだけだと、顧問先のデータを含む平文の記録が端末に何年も溜まり、今度は情報管理の問題になります。

具体的には次の3点を決めます。

デスクトップ側の動きも押さえておきます。2026年10月6日から、Pro・Max プランの Cowork の新しいタスクはクラウドで実行され、「このコンピューターのみ」の選択肢はなくなりました。すでに手元で始めたタスクは手元に残り、手元で完結させたい場合は Claude Code を使うよう、公式ヘルプが案内しています。この変更を伝えた X の投稿は約40万回表示され、「データはどこにあり、誰が見られるのか」という反応が多く付きました。クラウドで実行したセッションの記録は Anthropic 側に保存され、保持期間はプランの規定（個人向けは学習許可で5年・不許可で30日、商用は標準30日）に従います。PC の中の記録をどう残すかと、サーバー側にどれだけ残るかは別の話として、両方を把握しておく必要があります。

Claude Codeの履歴を削除する方法

特定の案件の記録をすぐに消したいときは、claude purge に作業フォルダのパスを渡します。そのプロジェクトの会話の記録と自動メモリ、関連する tasks・debug・file-history、入力履歴 history.jsonl の該当行、~/.claude.json の項目をまとめて削除します。v2.1.288 より前は claude project purge という名前でした。

claude purge ~/work/顧問先A --dry-run
claude purge ~/work/顧問先A
claude purge --all          # すべてのプロジェクトの記録を削除

手元で --dry-run を実行すると、削除予定のフォルダと「project transcripts (.jsonl) and memory/」の説明、そして shell-snapshots と backups は対象外であることが表示され、「1 item(s) would be deleted」で終わりました。実行時は削除計画を表示して確認を求めるので、-y を付けない限り誤って消すことはありません。

注意点が3つあります。第一に、貼り付けた画像とセッションのスクラッチパッドは ~/.claude ではなく一時フォルダにあるため、purge では消えません（画像は30日の掃除で消えます）。第二に、/heapdump を実行したことがある端末では、会話全体を含むヒープスナップショットが残り、掃除も purge も触りません。第三に、purge は PC の中の記録を消すだけで、Anthropic のサーバー側の保持期間には影響しません。クラウドセッションの記録は claude.ai 側で個別に削除します。

最初から書かせない選択肢もあります。環境変数 CLAUDE_CODE_SKIP_PROMPT_HISTORY はすべてのモードで記録と入力履歴の書き込みを止め、claude -p の単発実行なら --no-session-persistence で同じことができます。定時実行のスクリプトから顧問先データを扱う場合は、こちらのほうが管理しやすいこともあります。Claude Code の基本的な使い方は入門ガイド、主なコマンドはコマンド一覧にまとめています。

まとめ