settings.json

cleanupPeriodDays

型integer既定値30記述場所どの設定ファイルでも可

セッション、タスク、シェルスナップショットなどの履歴を保持する日数を設定します。

記述例

{
  "cleanupPeriodDays": 20
}

使い方・用途

  • ローカルディスク容量を節約するために、古いセッションログや一時ファイルを自動的にクリーンアップしたい場合に使用します。
  • セキュリティ要件に合わせて、機密情報が含まれる可能性のある会話履歴の保持期間を短縮(最小 1 日)することができます。
英語原文(公式ドキュメントより)

Number of days to retain sessions, orphaned subagent worktrees, tasks, shell snapshots, and backups. Minimum is 1; setting 0 is rejected with a validation error. See https://code.claude.com/docs/en/settings#available-settings

関連ドキュメント

関連する変更履歴

v2.1.304(1件)

Changed
mod の settings.read フックを変更し、各設定レイヤーを受け取ってマージ済み設定を書き換えるようにした。これにより、管理対象 mod が組織の設定を上限として設定できる（保持期間のクリーンアップで使用される cleanupPeriodDays を含む）
英語原文を表示
Changed mods' settings.read hooks to receive each settings layer and rewrite the merged settings, so a managed mod can make an organization's setting a ceiling, including the cleanupPeriodDays the retention sweep uses

変更後

管理対象の mod がユーザーやプロジェクト側の設定より短い保持期間など、組織の設定を上限として強制できるようになる。これにより、ユーザーが任意の設定値で上書きしても、cleanupPeriodDays のような保持期間の制御が組織のポリシーどおりに動作する。

関連ドキュメント

v2.1.271(1件)

Fixed
claude.ai から同期されたスキルがサインアウト後もディスク上に無期限に残る問題を修正し、cleanupPeriodDays 以内に更新されなかったコピーは次回起動時に復元可能なゴミ箱へ移動するようになった
英語原文を表示
Fixed skills synced from claude.ai staying on disk indefinitely after signing out; copies not refreshed within cleanupPeriodDays now move to the recoverable trash at the next launch

関連ドキュメント

v2.1.257(1件)

Fixed
バックグラウンドデーモンの起動が中断された際にシステムの一時ディレクトリに cc-daemon-* フォルダが残る問題を修正した。cleanupPeriodDays の保持期間スイープで削除されるようになった
英語原文を表示
Fixed leftover cc-daemon-* folders in the system temp directory after an interrupted background daemon start; the cleanupPeriodDays retention sweep now removes them

関連ドキュメント

v2.1.117(1件)

Changed
設定項目の cleanupPeriodDays による自動クリーンアップの対象が、タスク履歴、シェル・スナップショット、バックアップディレクトリにも拡大されました
英語原文を表示
The cleanupPeriodDays retention sweep now also covers ~/.claude/tasks/, ~/.claude/shell-snapshots/, and ~/.claude/backups/

変更後

手動で不要ファイルを削除する手間が省け、ディスク容量を効率的に管理できます。

関連ドキュメント

v2.1.101(1件)

Fixed
--setting-sources に user が含まれない場合、バックグラウンドでのクリーンアップが設定(cleanupPeriodDays)を無視して30日以前の履歴を削除してしまう問題を修正
英語原文を表示
Fixed --setting-sources without user causing background cleanup to ignore cleanupPeriodDays and delete conversation history older than 30 days

変更後

長期にわたるプロジェクトの重要な会話履歴が意図せず消えてしまうリスクを回避できます。

関連ドキュメント

v2.1.89(1件)

Changed
settings.json で cleanupPeriodDays: 0 と設定した場合にバリデーションエラーで拒否するように変更した。従来はこの設定がトランスクリプトの永続化を黙って無効化していた。
英語原文を表示
Changed cleanupPeriodDays: 0 in settings.json to be rejected with a validation error — it previously silently disabled transcript persistence

変更後

意図せずトランスクリプトの永続化が無効になる事態を防ぎ、誤った設定値にすぐ気づけるようになる。

関連ドキュメント

v2.1.83(1件)

Fixed
ツール実行結果のファイルが削除されず、cleanupPeriodDays 設定が無視される問題を修正しました
英語原文を表示
Fixed tool result files never being cleaned up, ignoring the cleanupPeriodDays setting

変更後

不要なデータによってディスク容量が圧迫されるのを防ぎ、システムをクリーンな状態に保てます。

関連ドキュメント

v0.2.117(1件)

Added
Introduced settings.cleanupPeriodDays