desktopSessionCleanupPeriodDays
A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.248 and was gone by v2.1.284.
Set an age limit in days for Claude Desktop and Cowork transcripts
Anthropic's own wording. Read off All settings, captured 2026-10-23.
In the changelogs
4Releases whose published page names desktopSessionCleanupPeriodDays.
-
v2.1.282
More remotely managed settings keep their original values when partly invalid
When remotely managed settings fail validation, Claude Code now keeps the original values for more keys instead of only the two cleanup settings
found in this entry's text
-
v2.1.248
Desktop-released session cleanup path
Cleanup code reads a setting for how long to keep sessions released from the desktop app.
named in this entry, found in this entry's text
-
v2.1.248
Transcripts owned by the Claude desktop app are exempt from the retention sweep
Desktop-owned transcripts survive the retention sweep, capped by a new desktopSessionCleanupPeriodDays setting.
named in this entry, found in this entry's text
-
v2.1.248
Cleanup skip message names the setting at fault
When transcript cleanup skips, it now names the retention setting that failed validation.
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
2Build by build
52One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.