Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / Settings keys

auto

setting never mined JSON

A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

You can set the auto-compact window at launch with --autocompact, using auto or 100k to 1M.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.221.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 149on this box, as of v2.1.308
Written about v2.1.9 first named in a changelog, 15 Jan 2026

In the changelogs

62

Releases whose published page names auto.

  1. v2.1.300
    /autocompact warns about high token usage only for larger windows

    The high-token-usage warning in /autocompact now shows only when the chosen window is bigger than the auto window for your model

    found in this entry's text

  2. v2.1.299
    /effort and /fast now work in agent view

    In agent view, /effort and /fast now take effect instead of telling you to attach to a session

    found in this entry's text

  3. v2.1.296
    Moving a session to the cloud can keep auto mode

    When you move a session to the cloud from a terminal in auto mode, Claude Code now asks the cloud session to stay in auto mode

    found in this entry's text

  4. v2.1.296
    Subagent definitions now pass their own auto-compact window to the agent

    An agent definition can set autoCompactWindow, and Claude Code now passes that value on to the subagent it starts

    found in this entry's text

  5. v2.1.293
    Desktop app admin settings gain SSH, home layout and update-cap options

    Admin settings for the Claude Desktop app gain sshTransport, desktopHome and dangerousMaxVersion

    found in this entry's text

  6. v2.1.290
    PreCompact hooks are now told when compaction was automatic

    The PreCompact hook now receives a trigger of auto for automatic compaction instead of always manual

    found in this entry's text

  7. v2.1.288
    Auto-compact window can now be set separately for each model

    autoCompactWindow can now go under modelSettings for a single model, as a token count or auto

    found in this entry's text

  8. v2.1.288
    Autocompact window setting can differ by model

    The autocompact window setting can now take a per-model value with a default, and auto falls back to the built-in value

    found in this entry's text

  9. v2.1.288
    The auto-compact window is now saved separately for each model

    Setting the auto-compact window in /config now applies to the current model only, not every model

    found in this entry's text

  10. v2.1.283
    --remote can ask before sharing local MCP servers or serving tools unattended

    An attached --remote session can now ask whether to share your local MCP servers, and ask again before serving tools in auto or bypass mode

    found in this entry's text

  11. v2.1.281
    Remote Control can hold back transcript upload until a client opens the session (dark-launched)

    Remote Control has a new mode that holds back the full transcript upload until a client opens the session, controlled by remote config

    found in this entry's text

  12. v2.1.281
    Account-set permission mode is now recorded for remote plan-mode answers

    Claude Code now remembers the permission mode your account set, and uses it to decide who may answer a plan-mode question in remote sessions

    found in this entry's text

  13. v2.1.280
    New "max effort" mode with /effort command

    A new "max effort" mode appears with a footer hint pointing to the /effort command

    found in this entry's text

  14. v2.1.275
    Permission-mode 'auto' resolves to a concrete mode at request time

    'Auto' permission mode now resolves to a concrete mode when a tool request is made

    found in this entry's text

  15. v2.1.275
    Workflow agent() auto-mode classifier call now receives rootToolSurface

    Workflow agents running in auto mode now report their root tool surface to the auto-mode classifier

    found in this entry's text

  16. v2.1.273
    Bridge/remote-control child sessions default to auto-granting 'auto' permission mode

    A new grants module can auto-switch Remote Control child sessions into auto-approval permission mode

    found in this entry's text

  17. v2.1.271
    New remote-control-plane commands: MCP reconnect/toggle, session titling/renaming, task stop/backgrounding, and flag settings

    Remote control connections can now reconnect/toggle MCP servers, rename sessions, stop tasks, and set effort/ultracode flags

    found in this entry's text

  18. v2.1.271
    Bridge child auto-mode permission defaulting, gated off

    Bridge-spawned child sessions may be defaulted to auto permission mode, gated off

    found in this entry's text

  19. v2.1.271
    New CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS bridge env var

    New CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS bridge env var, plus a new auto settings argument on worker resume

    found in this entry's text

  20. v2.1.271
    New forPromptShellCommand context forces auto mode down to default

    Shell commands run as part of a prompt now force permission mode down from auto to default

    found in this entry's text

  21. v2.1.269
    New bridge-child env vars for auto permission mode and artifact publishing

    New env vars let a bridge-spawned child session default to auto permission mode and force-enable artifacts

    found in this entry's text

  22. v2.1.269
    Reactive-compact 'summarized all' telemetry condition broadened

    The 'summarized all' compaction telemetry event now fires under broader conditions

    found in this entry's text

  23. v2.1.265
    Classifier can now auto-answer approval prompts in plan mode, not just auto mode

    Claude Code's classifier can now auto-approve some tool prompts in plan mode, not just auto mode

    found in this entry's text

  24. v2.1.260
    New "proactive" permission-mode resolution

    A new proactive permission mode picks bypass or auto-accept mode based on context.

    found in this entry's text

  25. v2.1.260
    Compaction requests now tagged as auto vs manual

    Compaction requests are now tagged as auto or manual.

    found in this entry's text

  26. v2.1.259
    Additional CLI permission modes surfaced when replaying session state

    Replayed sessions now round-trip the default, plan, dontAsk and bubble permission modes, not just the three previously handled.

    found in this entry's text

  27. v2.1.259
    Unattended-serving consent prompt for headless/desktop cloud sessions

    Headless and desktop cloud sessions in auto or bypass mode now ask once whether Claude may act unattended, and the answer is saved.

    found in this entry's text

  28. v2.1.259
    Auto-mode gate fallback notification on plan exit

    Exiting plan mode when auto mode is unavailable now tells you it is falling back to the default mode instead of doing it silently.

    found in this entry's text

  29. v2.1.257
    New 'Time format' setting in /config

    A new Time format setting in /config controls whether UI clocks use 12-hour, 24-hour, UTC or a custom pattern.

    found in this entry's text

  30. v2.1.257
    New UI clock formatting settings: timeFormat and timeZone

    Two new settings.json fields, timeFormat and timeZone, control how times are rendered in the UI.

    found in this entry's text

  31. v2.1.257
    'bypassPermissions'/'auto' default-permission-mode can now be set from local settings

    The auto and bypassPermissions default permission modes can now be set from local settings, not just project settings.

    found in this entry's text, named in this entry

  32. v2.1.251
    Auto mode can now grant artifact room joins on its own

    In auto mode, Claude can join an artifact's live room itself unless you refused before.

    named in this entry, found in this entry's text

  33. v2.1.248
    Permission modes auto and dontAsk are now documented in the schema

    The schema now documents all six permission modes, including auto and dontAsk.

    named in this entry, found in this entry's text

  34. v2.1.248
    Permission nudge and explainer moved, not changed

    The auto permission-mode nudge and explainer moved in code but behave the same.

    found in this entry's text

  35. v2.1.248
    Session decides for itself whether remote rules may influence approval

    A remote host's permission rules only count when you're in auto mode and the tool isn't ask-first.

    found in this entry's text

  36. v2.1.248
    More session-name origins survive a reload

    Session names set by you, a peer, a hook or automatically keep their origin after reload.

    found in this entry's text

  37. v2.1.248
    Permission rules serialized for the host

    Permission rules sent to the host omit allow and environment lists for unpermitted callers.

    found in this entry's text

  38. v2.1.246
    IDE diff viewer skips remote calls and more notebook files

    Remote-driven edits no longer pop diff tabs in your IDE, and symlinked notebooks are recognised.

    found in this entry's text

  39. v2.1.246
    Hosts can turn off the auto-mode handback classifier

    A host can set classifyHandoff false to skip the classifier deciding whether a subagent hands control back.

    found in this entry's text

  40. v2.1.235
    New opt-in prompt-input spell checking (aspell/hunspell/ispell)

    Claude Code can now spell-check prompt input using aspell, hunspell, or ispell if you opt in

    found in this entry's text

  41. v2.1.234
    Injected poll events are rate-, size- and mode-limited

    Injected session events now get refused for rate, size or wrong permission mode, each with a logged reason.

    found in this entry's text

  42. v2.1.234
    Poll events get a nonce and a reserved-kind guard

    Injected events get a random nonce and can't reuse an event kind Claude Code produces itself.

    found in this entry's text

  43. v2.1.232
    Tool search says once why it turned itself off

    Tool search logs why it disabled itself and refuses entirely against a non-Anthropic base URL.

    found in this entry's text

  44. v2.1.227
    New setting: Claude-proposed goals

    A "Claude-proposed goals" setting in the config panel controls whether Claude suggests session goals.

    found in this entry's text

  45. v2.1.227
    The model can propose a session goal, controlled by modelProposedGoals

    Claude can propose a session goal; modelProposedGoals lets you always confirm or turn it off.

    found in this entry's text

  46. v2.1.227
    ProposeGoal: Claude can propose a session goal for one-keypress approval

    Claude could propose a session goal you approve with one keypress, but it is switched off.

    found in this entry's text

  47. v2.1.227
    New setting: modelProposedGoals

    modelProposedGoals is only read from user, policy and command-line settings, never from the project.

    found in this entry's text

  48. v2.1.227
    Auto-mode guidance reminders now also appear in bypassPermissions

    Bypass permissions mode now gets the same guidance reminders auto mode gets.

    found in this entry's text

  49. v2.1.225
    Auto-default nudge actually flips the mode, and reports the outcome

    Saying yes to the auto-mode prompt now actually saves auto as your default permission mode.

    named in this entry

  50. v2.1.225
    VS Code-owned sessions get their own settings defaultMode handling

    In VS Code sessions, unsafe default permission modes from settings are refused and fall back to normal.

    found in this entry's text

  51. v2.1.224
    MCP OAuth failures name the specific issuer mismatch

    MCP OAuth failures now tell you it was an issuer mismatch instead of a generic error.

    found in this entry's text

  52. v2.1.221
    New --autocompact flag for the auto-compact window

    You can set the auto-compact window at launch with --autocompact, using auto or 100k to 1M.

    found in this entry's text

  53. v2.1.221
    MCP protocol-era negotiation (2026-07-28 "modern" revision) added behind per-transport gates

    A newer MCP protocol handshake exists per transport but every gate falls back to legacy here.

    found in this entry's text

  54. v2.1.186
    iTerm2 Teammate Pane Mode

    found in this entry's text

  55. v2.1.182

    found in this entry's text

  56. v2.1.182
  57. v2.1.169
    Permission Mode Downgrade Notification

    found in this entry's text

  58. v2.1.128
    Effort Selection Defaults Back to Auto

    found in this entry's text

  59. v2.1.119
  60. v2.1.91
    Permission Mode: auto Classifier

    found in this entry's text

  61. v2.1.76
    /effort Slash Command

    found in this entry's text

  62. v2.1.9
    ENABLE_TOOL_SEARCH Percentage Control

    found in this entry's text

First cited

0

No 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

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

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.

Feedback