Home Docs Claude Code CLI 22 Oct 2026

One change · claude-code

All settings changedsettings-reference

Nearest release: v2.1.309, published 2 hours after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 22 Oct 2026 18:08 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 22 Oct 2026 18:37 UTC.

Upstream edited 22 Oct 2026 18:08 UTC

Recorded here 22 Oct 2026 18:37 UTC

Lines+14added

Lines−5removed

From line 48 where the diff opens

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

Recorded edits149to this page, all time

The whole hunk

from line 48, 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 48

4949| [`awsAuthRefresh`](#awsauthrefresh) | Refresh expired [Bedrock credentials](/docs/en/amazon-bedrock.md#advanced-credential-configuration) in `.aws` with your own command | Authentication and providers | Any file |

5050| [`awsCredentialExport`](#awscredentialexport) | Supply [Bedrock credentials](/docs/en/amazon-bedrock.md#advanced-credential-configuration) as JSON from your own command | Authentication and providers | Any file |

from line 816

816816* Your `~/.claude/skills/` and `~/.claude/commands/` directories, including [skills synced from claude.ai](/docs/en/skills.md#where-synced-skills-load)

817817* An `--add-dir` directory

818818* [Plugins declared with a `.claude-plugin` manifest](/docs/en/plugins/loading#plugins-shared-through-a-repository) inside `~/.claude/skills/` or the project's `.claude/skills/`

819* Plugins loaded for one session only, whose ids end in [`@inline`](/docs/en/plugins/loading#find-where-a-plugin-came-from), when all of these hold:

820 * The session is a [Code session](/docs/en/desktop.md#environment-configuration) or [Cowork session](/docs/en/managed-settings.md#where-and-when-a-policy-applies), other than a cloud session, for which the Claude Desktop app itself starts Claude Code

821 * Your managed settings set the key, not only an embedding host's [parent settings](/docs/en/managed-settings.md#let-an-embedding-host-add-policy)

822 * The session runs Claude Code v2.1.305 or later

819823

820Skills from managed settings and bundled skills keep their `allowed-tools`. A skill's `disallowed-tools` still applies. For what a developer sees when Claude Code ignores the field, see [When only managed permission rules apply](/docs/en/skills.md#when-only-managed-permission-rules-apply).

824Skills from managed settings and bundled skills keep their `allowed-tools`. `@inline` plugins outside those Desktop sessions keep theirs too, except one named [`anthropic-skills`](/docs/en/skills#names-reserved-for-synced-skills). A skill's `disallowed-tools` still applies. For what a developer sees when Claude Code ignores the field, see [When only managed permission rules apply](/docs/en/skills.md#when-only-managed-permission-rules-apply).

821825

822826* **Scope**: [`Managed`](#scopes)

823827* **Type**: Boolean

from line 1960

19561960

19571961* **Scope**: [`Any file`](#scopes), with [limits on project and local settings](/docs/en/sandboxing.md#repository-settings-under-an-admin-required-sandbox)

19581962* **Type**: Boolean

1959 * `true`: sandboxed commands can connect to every Unix socket

1963 * `true`: sandboxed commands can connect to every Unix socket. On Linux and WSL2 they can also connect to VM sockets, the `AF_VSOCK` address family

19601964 * `false`: the sandbox blocks Unix-socket connections: on macOS except the paths in `allowUnixSockets`, and on Linux and WSL2 through the seccomp filter when it's present

19611965* **Default**: `false`

19621966

from line 2347

23432347

23442348 Ignoring this group in project and local settings requires Claude Code v2.1.282 or later.

23452349 * Variables that change how Claude Code starts or syncs, such as `CLAUDE_CODE_PROCESS_WRAPPER`, `CLAUDE_CODE_SYNC_SKILLS`, `CLAUDE_CODE_SYNC_PLUGINS`, `CLAUDE_CODE_PLUGIN_CACHE_DIR`, and `CLAUDE_CODE_PLUGIN_SEED_DIR`.

2350 * The [screen reader mode](/docs/en/accessibility.md) variable `CLAUDE_AX_SCREEN_READER` and the other variables whose names start with `CLAUDE_AX_`, such as [`CLAUDE_AX_STARTUP_QUIET_MS`](/docs/en/env-vars#variables).

23462351 * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](/docs/en/env-vars#variables), which sets the timer on an unanswered dialog.

23472352 * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](/docs/en/env-vars#variables), which turns off attachment processing.

23482353 * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](/docs/en/env-vars#variables), which stops Claude Code from expanding `@` mentions of files and directories.

from line 2359

23542359* [`CLAUDE_CODE_RESTRICTED`](/docs/en/env-vars#variables), which Claude Code reads from the launch environment only, is ignored from every file.

23552360* [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](/docs/en/env-vars#variables), which Claude Code reads from the launch environment only, is ignored from every file. The variable requires Claude Code v2.1.283 or later.

23562361* [`CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT`, `CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT`, `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT`, and `CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT`](/docs/en/env-vars#variables), which Claude Code reads from the launch environment only, are ignored from every file.

2362* [`CLAUDE_CODE_WARN_DISK_FREE_GIB` and `CLAUDE_CODE_WARN_MEMORY_FREE_GIB`](/docs/en/env-vars#variables), which Claude Code reads from the launch environment only, are ignored from every file. The variables require Claude Code v2.1.304 or later.

23572363

23582364### `fileCheckpointingEnabled`

23592365

from line 2387

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

23822388

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

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

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

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

23862393* **Size**: the conversation's context has reached the token threshold, which you can [change](#change-the-idle-compaction-threshold) from its default of 200,000

from line 2548

25412548

25422549Render screen-reader friendly output: flat text without decorative borders or animations. Screen-reader mode uses the classic renderer, so the `tui` setting has no effect while it is active; attached [background sessions](/docs/en/agent-view.md) still render fullscreen.

25432550

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

2551* **Scope**: [`User or managed`](#scopes). You can also set the key in a file you pass with `--settings`. Claude Code ignores the key in project and local settings, so neither a repository nor your own `.claude/settings.local.json` can turn screen-reader mode on or off.

25452552* **Type**: Boolean

25462553 * `true`: Claude Code renders flat text without decorative borders or animations, using the classic renderer

25472554 * `false`: Claude Code renders normally

from line 3707

37003707 * `"off"`: Claude doesn't see the skill and `/name` is hidden from autocomplete

37013708* **Default**: unset, so every skill is `"on"`

37023709

3703This example lists `legacy-context` to Claude by name only and hides `deploy` from Claude and from `/` autocomplete:

3704

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

3706{

3707 "skillOverrides": {

3708 "legacy-context": "name-only",

3709 "deploy": "off"

3710 }

3711}

3712```

3713

3714Overrides don't apply to plugin skills, which you manage through `/plugin`.

3715

3716In managed settings and files passed with `--settings`, a key on a bundled skill's alias, such as `checkup` for `/doctor`, also applies to the skill; see [how alias keys combine with keys on the skill's own name](/docs/en/skills.md#override-skill-visibility-from-settings).

3717

3718### `syncClaudeAiSkills`

3719

3720Turn off the download of the [skills enabled for your claude.ai account](/docs/en/skills.md#how-synced-skills-behave). Claude Code downloads them into `~/.claude/skills/synced/` in [terminal sessions where you sign in with your claude.ai account](/docs/en/skills.md#where-synced-skills-load), interactive or non-interactive, and in Cowork and cloud sessions. Set `false` to stop that download and stop loading the skills it already synced. Claude Code honors only `false`: `true` is the same as unset and doesn't turn syncing on where it's otherwise off.

3721

3722* **Scope**: [`User, local, or managed`](#scopes), and files passed with `--settings`. A repository can't turn it off for you.

3723* **Type**: Boolean

3724 * `false`: Claude Code stops downloading synced skills and stops loading the ones already in `~/.claude/skills/synced/`. In user or managed settings, it also moves them to `~/.claude/skills/.trash/`

3725 * `true`: the same as unset

3726* **Default**: unset, so sessions signed in with your claude.ai account sync your skills

3727

3728This example keeps a machine from downloading the account's skills in any session:

3729

3730```json

3710This example lists `legacy-context` to Claude by name only and hides `deploy` from Claude and from `/` autocom

This page’s history 149 edits

23 Oct 2026 +5 −0
22 Oct 2026 +2 −0
22 Oct 2026 +14 −5 · this one
22 Oct 2026 +694 −694
22 Oct 2026 +3 −4
22 Oct 2026 +1 −1

The page’s own history →

Where it came from

The captureclaude-code
Upstream pagecode.claude.com

Around it

Every changethe ledger
That day22 Oct 2026