settings.json

cleanupPeriodDays

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

使い方・用途

  • ローカルディスク容量を節約するために、古いセッションログや一時ファイルを自動的にクリーンアップしたい場合に使用します。
  • セキュリティ要件に合わせて、機密情報が含まれる可能性のある会話履歴の保持期間を短縮(最小 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.117 (1件)

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

変更前

古いセッション履歴は削除されても、内部的なシェル操作のログやバックアップファイルが ~/.claude/ 内に蓄積され続け、ディスク容量を圧迫することがありました。

変更後

指定した日数を過ぎた一時ファイル群が包括的に削除され、ディレクトリ内が常にクリーンに保たれます。

ユーザーへの恩恵

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

v2.1.101 (1件)

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

変更前

特定のプロジェクト設定のみで起動した際、会話履歴の保存期間設定が無視され、古い履歴が勝手に削除されてしまうことがありました。

変更後

どのような起動設定であっても、設定された保存期間(デフォルト30日)を正しく参照してクリーンアップが行われます。

ユーザーへの恩恵

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

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

変更前

Claude がツールを実行した際のログや中間ファイルが蓄積され続け、設定で指定した保持期間(デフォルト 30 日)を過ぎてもディスク上に残り続けていました。

変更後

クリーンアップ処理が正しく全ての関連ファイル(.jsonl 等)に適用されるようになり、古いデータが自動的に削除されるようになりました。

ユーザーへの恩恵

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

関連ドキュメント

v0.2.117 (1件)

Added
Introduced settings.cleanupPeriodDays