Claude Codeのセッション自動削除を無効化する設定

Claude Codeはデフォルトで30日以上非アクティブなセッションを起動時に削除する。この動作を変更して、セッション履歴を無期限に保持する方法を解説する。

結論

~/.claude/settings.json に cleanupPeriodDays を設定する。

{
  "cleanupPeriodDays": 99999
}

この設定で約274年分のセッションが保持され、実質的に自動削除が無効化される。

設定の詳細

動作の仕組み

• 指定した日数より長く非アクティブなセッションが、Claude Code起動時に削除される
• 0 に設定すると、起動時に全てのセッションが即座に削除される
• 99999 のような大きな値を設定すると、実質的に自動削除が無効化される

設定方法

既存の settings.json がある場合は、トップレベルに追加する。

{
  "cleanupPeriodDays": 99999,
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  },
  "permissions": {
    ...
  }
}

設定は次回のClaude Code起動時から有効になる。

公式ドキュメント

この設定はClaude Codeの公式ドキュメントに記載されている。

• Claude Code settings documentation