Home Docs Claude Code CLI 24 Oct 2026

One change · claude-code

All settings changedsettings-reference

Upstream edited this page at 24 Oct 2026 23:09 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 24 Oct 2026 23:37 UTC.

Upstream edited 24 Oct 2026 23:09 UTC

Recorded here 24 Oct 2026 23:37 UTC

Lines+20added

Lines−4removed

From line 113 where the diff opens

First seen 21 Aug 2026 this site's first read of the page

Recorded edits160to this page, all time

#### Idle compaction in VS Code and the desktop app

The whole hunk

from line 113, old and new numbered

lines

This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.

from line 113

113113| [`gcpAuthRefresh`](#gcpauthrefresh) | Refresh [Google Cloud credentials](https://code.claude.com/docs/en/google-vertex-ai.md#advanced-credential-configuration) with your own command | Authentication and providers | Any file |

119119| [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Get a [push notification](https://code.claude.com/docs/en/remote-control.md#mobile-push-notifications) when Claude is waiting on you | Remote, desktop, and notifications | Any file |

from line 2411

24112411

24122412### `idleCompaction`

24132413

2414Idle compaction [compacts](https://code.claude.com/docs/en/context-window.md#what-survives-compaction) a long conversation that you've stepped away from, shortly before its prompt cache expires. Your next message then sends a summary instead of the whole conversation. When you come back, the conversation shows a line that starts with `Compacted while idle, before the prompt cache expired`.

2414Idle compaction [compacts](https://code.claude.com/docs/en/context-window.md#what-survives-compaction) a long conversation that you've stepped away from. Your next message then sends a summary instead of the whole conversation. Once compacted, the conversation shows a notice:

24152415

2416* **Terminal**: a line that starts with `Compacted while idle, before the prompt cache expired`

2417* **[VS Code chat panel](#idle-compaction-in-vs-code-and-the-desktop-app)**: a notice that includes `a summary written while you were away`

2418* **[Desktop app](#idle-compaction-in-vs-code-and-the-desktop-app)**: the same notice, inside a row whose label includes `Claude Code notice`. If you don't see that row or its text, switch to the [Verbose view mode](https://code.claude.com/docs/en/desktop.md#switch-view-modes).

2419

24162420Idle compaction is on by default for conversations that meet all of these conditions:

24172421

2418* **Session**: you're in an interactive terminal session

2422* **Session**: you're in an interactive terminal session, or in the VS Code extension's chat panel or the desktop app's Code tab on an [account that Anthropic selects](#idle-compaction-in-vs-code-and-the-desktop-app)

24192423* **Auto-compaction**: [`autoCompactEnabled`](#autocompactenabled) is on

24202424* **Prompt cache**: the conversation is on the [one-hour prompt cache TTL](https://code.claude.com/docs/en/prompt-caching.md#which-ttl-each-request-gets)

24212425* **Feature flags**: Claude Code can [fetch feature flags from Anthropic](https://code.claude.com/docs/en/env-vars.md#features-that-need-feature-flag-fetching)

from line 2441

24372441}

24382442```

24392443

2440To turn idle compaction off or on from inside a session, run `/config` and change the **Idle compaction** row. Your choice is saved to your user settings and applies right away. The row requires Claude Code v2.1.302 or later. If you run one of those versions and `/config` doesn't show the row, check for these causes:

2444To turn idle compaction off or on from inside a terminal session, run `/config` and change the **Idle compaction** row. Your choice is saved to your user settings and applies right away. The row requires Claude Code v2.1.302 or later. If you run one of those versions and `/config` doesn't show the row, check for these causes:

24412445

24422446* **Another settings source sets the key**: a value in managed settings, the `--settings` flag, or a project or local settings file overrides your user settings. Change the key in that source instead

24432447* **Feature flags are unavailable**: where Claude Code can't [fetch feature flags from Anthropic](https://code.claude.com/docs/en/env-vars.md#features-that-need-feature-flag-fetching), idle compaction doesn't run, so there is nothing to turn off

from line 2462

24582462}

24592463```

24602464

2465#### Idle compaction in VS Code and the desktop app

2466

2467A notice like this one means Claude Code [replaced your earlier conversation with a summary](https://code.claude.com/docs/en/context-window.md#what-survives-compaction) that Claude now works from:

2468

2469```text theme={null}

2470Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

2471```

2472

2473You don't need to do anything. To turn idle compaction off, set `idleCompaction` to `false` in `~/.claude/settings.json` or another [settings file](https://code.claude.com/docs/en/settings.md#settings-files-and-who-they-affect).

2474

2475In the VS Code extension's chat panel and the desktop app's Code tab, idle compaction runs for accounts that Anthropic selects. Claude Code writes the summary while you're away, then compacts with it only if your next message comes an hour or more after the last request.

2476

24612477### `plansDirectory`

24622478

24632479Choose where Claude Code stores the plan files it writes in [plan mode](https://code.claude.com/docs/en/permission-modes.md#analyze-before-you-edit-with-plan-mode). Claude Code resolves the path relative to the project root.

from line 3441

34253441* **Scope**: [`Any file`](#scopes)

34263442* **Type**: string

34273443* **Default**: unset, so Claude Code adds `Co-Authored-By: <name> <[email protected]>`. The name is the model in use when the commit is made, such as `Claude Sonnet 5`. When a [subagent](https://code.claude.com/docs/en/sub-agents.md) makes the commit, the trailer names the subagent's model.

3428 * When Claude Code recognizes the model as a Claude model but can't confirm its exact version, it writes `Claude` alone.

3429 * When it can't match the model ID to any Claude model, such as a third-party model served through a custom [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/en/env-vars), it writes `Claude Code`.

3430

3431This example replaces the default trailer with a custom line and a custom `Co-Authored-By` trailer:

3432

3433```json settings.json theme={null}

3434{

3435 "attribution": {

3436 "commit": "Generated with AI\n\nCo-Authored-By: AI <[email protected]>"

3437 }

3438}

3439```

3440

3441### `attribution.pr`

3442

3443Set the attribution text Claude Code adds to pull request descriptions. Set it to an empty string to hide pull request attribution.

3444

3445* **Scope**: [`Any file`](#scopes)

3446* **Type**: string

3447* **Default**: unset, so Claude Code adds `🤖 Generated with [Claude Code](https://claude.com/claude-code)`

3448

3449```json settings.json theme={null}

3450{

3451 "attribution": {

3452 "pr": ""

3453 }

3454}

3455```

3456

3457### `attribution.sessionUrl`

3458

3459Choose whether Claude Code appends the claude.ai session link when it commits or opens a pull request from a [cloud](https://code.claude.com/docs/en/claude-code-on-the-web.md) or [Remote Control](https://code.claude.com/docs/en/remote-control.md) session. Claude Code adds the link as a `Claude-Session` trailer on commits and as a link in pull request descriptions. Set it to `false` to omit the link.

3460

3461* **Scope**: [`Any file`](#scopes)

3462* **Type**: Boolean

3463 * `true`: Claude Code appends the cla

3444 * When Claude Code recognizes the mod

This page’s history 160 edits

27 Oct 2026 +5 −7
27 Oct 2026 +1 −0
26 Oct 2026 +4 −4
26 Oct 2026 +4 −1
25 Oct 2026 +2 −2
24 Oct 2026 +20 −4 · this one

The page’s own history →

Where it came from

The captureclaude-code
Upstream pagecode.claude.com

Around it

Every changethe ledger
That day24 Oct 2026