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

settings.json

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.

Resumed sessions now carry your settings files along, with plugin registrations stripped out.

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

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 v1.0.7 first named in a changelog, 30 May 2025

In the changelogs

59

Releases whose published page names settings.json.

  1. v2.1.305
    Plugin checking gains a folder-layout check and a --profile directory option

    claude plugin validate now also runs a folder-layout check, and plugin loading now checks key plugin files stay within allowed folders

    found in this entry's text

  2. v2.1.305
    Plugins can no longer read their manifest or settings from outside their folder

    Claude Code now refuses to load a plugin whose manifest, monitors or settings file links to a location outside the plugin's folder

    found in this entry's text

  3. v2.1.302
    Idle compaction messages now explain the timing and how to turn it off

    When Claude Code compacts while you are idle, it now says it did so before the prompt cache expired and how to turn this off

    found in this entry's text

  4. v2.1.286
    The /hooks menu now opens on a list of your hooks

    /hooks now opens on a list of every configured hook with its event, source, command and matcher, with the event list one step away

    found in this entry's text

  5. v2.1.280
    Settings validation now warns about invalid values instead of silently misbehaving

    Claude Code now warns when a settings.json value fails validation instead of silently ignoring it

    found in this entry's text

  6. v2.1.277
    TASK_MAX_OUTPUT_LENGTH removed from recognized settings list

    The TASK_MAX_OUTPUT_LENGTH environment variable is no longer a recognized setting

    found in this entry's text

  7. v2.1.274
    CLAUDE_CODE_FOOTER_INDICATOR env var now overrides settings config directly

    CLAUDE_CODE_FOOTER_INDICATOR environment variable now overrides the footer_indicator setting

    found in this entry's text

  8. v2.1.271
    Config duplication now copies .config.json and additional .claude*.json profile files

    Duplicating a config/session directory now also copies .config.json and additional .claude*.json profile files

    found in this entry's text

  9. v2.1.271
    Self-hosted runner gains host-config snapshotting for sessions

    The self-hosted runner can now snapshot an operator's Claude config and seed it into every session, with a drain-marker mechanism

    found in this entry's text

  10. 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

  11. v2.1.269
    New bashEditDiffEnabled setting controls Bash-tool file-change diffs and PostToolUse hook data

    New bashEditDiffEnabled setting shows diffs for files the Bash tool edits and passes changed files to PostToolUse hooks

    found in this entry's text

  12. v2.1.268
    --trust-workspace gains a stricter mode referencing cli#44151, still on by default

    --trust-workspace help text now documents a stricter mode that drops repo-committed permission grants

    found in this entry's text

  13. v2.1.268
    Settings env vars now validated: invalid names/values/NUL bytes are dropped with a warning

    Invalid environment variable names or values in settings.json are now dropped with a warning instead of silently used

    found in this entry's text

  14. v2.1.265
    /model default-save now confirms the write and reports failure/unconfirmed states

    /model's default-save now waits to confirm the write and reports saved, unconfirmed, or failed instead of assuming success

    found in this entry's text

  15. v2.1.265
    New Claude Code state files: device-mcp-consent.json / device-mcp-snapshot.json

    Two new state files, device-mcp-consent.json and device-mcp-snapshot.json, are now tracked and copied alongside other Claude config

    found in this entry's text

  16. v2.1.261
    New settings for inline Bash/Task output truncation limits

    New settings let you control how much Bash and Task output Claude sees before it gets truncated to a file.

    found in this entry's text

  17. v2.1.259
    Settings can now supply a default model, ahead of ANTHROPIC_DEFAULT_MODEL

    A model set in settings.json now takes precedence over the ANTHROPIC_DEFAULT_MODEL environment variable at startup.

    found in this entry's text

  18. 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

  19. v2.1.257
    New user-facing errors for cloud session sync and TLS pinning failures

    New messages cover sync being switched off because settings.json could not be parsed, and sign-in aborting on a changed TLS certificate.

    found in this entry's text

  20. v2.1.248
    Five more environment variables can be set from settings.json

    Five more environment variables, including stream and byte watchdogs, can be set in settings.json.

    found in this entry's text

  21. v2.1.242
    Session spawn aborts on host-specific write paths committed to a repo

    A committed settings file granting host-specific write paths blocks session startup with instructions.

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

  22. v2.1.242
    Consent screen explaining what forwarding your hooks to a cloud session means

    A consent screen explains what letting cloud sessions run your local hooks means.

    found in this entry's text

  23. v2.1.232
    Three more variables can be set from settings.json

    You can now set OTEL_SERVICE_NAME, OTEL_TRACES_EXPORT_INTERVAL and CLAUDE_CODE_FORK_SUBAGENT in settings.json.

    found in this entry's text

  24. v2.1.227
    Settings can be pre-loaded through the v5 storage backend

    Settings can be pre-read through the new storage backend, skipping re-parsing when unchanged.

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

  25. v2.1.222
    Resume snapshots carry user settings without plugin keys

    Resumed sessions now carry your settings files along, with plugin registrations stripped out.

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

  26. v2.1.186
    respondToBashCommands Setting

    found in this entry's text

  27. v2.1.182
    attribution.sessionUrl Setting

    found in this entry's text

  28. v2.1.166
    fallbackModel setting in settings.json

    found in this entry's text

  29. v2.1.124
  30. v2.1.124
  31. v2.1.124
  32. v2.1.124
    update-config skill prompt rewritten

    found in this entry's text

  33. v2.1.121
    Focus View Requires Fullscreen Renderer

    found in this entry's text

  34. v2.1.117
    /autocompact Interactive Dialog

    found in this entry's text

  35. v2.1.117
    Auto-Compact Window Message Improvement

    found in this entry's text

  36. v2.1.85
    Worktree Support for Non-Git VCS

    found in this entry's text

  37. v2.1.83
  38. v2.1.80
    Inline Marketplace Definitions in Settings

    found in this entry's text

  39. v2.1.77
    update-config Skill

    found in this entry's text

  40. v2.1.76
    /effort Slash Command

    found in this entry's text

  41. v2.1.76
    Hooks UI Redesigned as Read-Only Viewer

    found in this entry's text

  42. v2.1.75
    Plugin Configurable Options

    found in this entry's text

  43. v2.1.59
    Voice Dictation Mode

    found in this entry's text

  44. v2.1.50
    VCS-Agnostic Worktree Isolation via Hooks

    found in this entry's text

  45. v2.1.48
    HTTP Hooks

    found in this entry's text

  46. v2.1.48
    CLAUDE.md Exclude Patterns

    found in this entry's text

  47. v2.1.47
    Plugin Settings from settings.json

    found in this entry's text

  48. v2.1.36
    New User Setting: fastMode

    found in this entry's text

  49. v2.1.26
    Terminal Tab Title Setting

    found in this entry's text

  50. v2.1.19
    Settings Sync for Remote Sessions

    found in this entry's text

  51. v2.1.15
    Cowork Plugins Directory Support [Hidden]

    found in this entry's text

  52. v2.0.0
    Config Command Array Functions

    found in this entry's text

  53. v2.0.0
    Breaking Changes

    found in this entry's text

  54. v2.0.0
    Migration Guide

    found in this entry's text

  55. v1.0.124
    Sandboxed Bash Mode (-sb/--sandboxed-bash)

    found in this entry's text

  56. v1.0.71
    StatusLine Setup Agent

    found in this entry's text

  57. v1.0.51
    Removed Features

    found in this entry's text

  58. v1.0.7
    New Features

    found in this entry's text

  59. v1.0.7
    Deprecated Features

    found in this entry's text

First cited

5

The earliest release whose published evidence quoted settings.json was v2.1.47, 18 Feb 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.4718 Feb 2026Loaded settings from settings.json for plugin
v2.1.8019 Mar 2026Inline marketplace manifest defined directly in settings.json
v2.1.24224 Aug 2026Host-specific write-scope entries belong in the operator's user-level settings.json
v2.1.28630 Sep 2026This menu is read-only. To add or change a hook, edit settings.json or ask Claude.
v2.1.30216 Oct 2026turn off with "idleCompaction": false in settings.json

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