# Claude Code config-surface delta — v2.1.114 → v2.1.181 (SUPERSEDED)

> **Status: SUPERSEDED** by `docs/cc-2.1.x-gap-matrix.md` (the verified truth source). This draft is
> kept only as the historical research artifact. Do not action rows from here — the matrix re-verified
> every row per-surface. Two version errors that propagated into both this draft and the matrix's
> draft-correction note were re-checked against the official changelog on 2026-06-18 (Batch 3) and
> corrected at the knowledge layer:
>
> - **Stop/SubagentStop `additionalContext`: v2.1.163** (not v2.1.165 — that release was "Bug fixes
>   and reliability improvements" only). The gap-matrix even self-contradicts here: row 109 already
>   said 2.1.163.
> - **settings `agent` field: introduced v2.0.59**; v2.1.157 is when it became "honored for dispatched
>   `claude agents` sessions" — this draft's "2.1.154" and the matrix's "2.1.157-as-introduction" are
>   both imprecise.
>
> Original draft note: produced by the claude-code-guide research agent 2026-06-18 from the official
> changelog. Items below the 2.1.114 floor (e.g. 2.1.105) belong to the token-management thread (Fase 4).

**Current latest:** v2.1.181 · **Window:** 2.1.114 → 2.1.181

## 1. settings.json / settings.local.json
- 2.1.181 `sandbox.allowAppleEvents` (macOS opt-in) — HIGH
- 2.1.181 env `CLAUDE_CLIENT_PRESENCE_FILE` (suppress mobile notifications) — HIGH
- 2.1.175 `enforceAvailableModels` (managed, constrains default model) — HIGH
- 2.1.176 `footerLinksRegexes` (footer badges) — MED
- 2.1.174 `wheelScrollAccelerationEnabled` — LOW
- 2.1.169 `disableBundledSkills` — HIGH
- 2.1.166 `fallbackModel` (chain up to 3) — HIGH
- 2.1.163 managed `requiredMinimumVersion`, `requiredMaximumVersion` — HIGH
- 2.1.161 env `OTEL_RESOURCE_ATTRIBUTES` — MED
- 2.1.154 `agent` (run main thread as named subagent) — HIGH
- 2.1.154 `fastModePerSessionOptIn` — HIGH
- 2.1.153 `skipLfs` (Git plugin sources) — MED
- 2.1.149 managed `allowAllClaudeAiMcps` — HIGH
- 2.1.143 `worktree.bgIsolation: 'none'` — HIGH
- 2.1.141 env `CLAUDE_CODE_PLUGIN_PREFER_HTTPS`, `ANTHROPIC_WORKSPACE_ID` — MED/HIGH
- 2.1.133 managed `parentSettingsBehavior`, `policyHelper` — HIGH
- 2.1.129 `skillOverrides` (per-skill visibility) — HIGH

## 2. CLAUDE.md / memory
- 2.1.169 `--safe-mode` disables customizations (CLAUDE.md not loaded) — MED
- 2.1.157 plugins in `.claude/skills` auto-load; "closest .claude/ wins" precedence — HIGH
- 2.1.178 nested `.claude/skills` directory loading — MED

## 3. Hooks
- 2.1.178 new matcher syntax `Tool(param:value)` — HIGH
- 2.1.172 OTEL `model` attribute in hook output context — MED
- 2.1.169 new event `post-session` (self-hosted runners) — HIGH
- 2.1.163 `SubagentStop` supports `additionalContext` return — HIGH
- 2.1.157 hook "args: string[]" exec form (no shell wrap) — HIGH
- 2.1.152 new event `MessageDisplay` — HIGH
- 2.1.145 hook input fields `background_tasks`, `session_crons` — HIGH
- 2.1.141 hook output field `terminalSequence` — HIGH
- 2.1.139 hook condition "if" syntax — HIGH

## 4. MCP (.mcp.json)
- 2.1.153 `skipLfs` for Git-based sources — MED
- 2.1.149 managed `allowAllClaudeAiMcps` (auto-approve claude.ai connectors) — HIGH
- 2.1.141 env `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` (transport) — MED
- (format stdio/SSE/HTTP, scopes local/project/user, OAuth: stable in window)

## 5. Plugins & marketplace
- 2.1.178 "closest .claude/" precedence; nested `.claude/skills` — HIGH
- 2.1.157 plugins auto-load from `.claude/skills/`; `claude plugin init` — HIGH/MED
- 2.1.154 plugin `defaultEnabled: false` manifest field — HIGH
- 2.1.149 managed `pluginSuggestionMarketplaces` — MED
- 2.1.143 plugin dependency enforcement (disable/enable) — MED
- 2.1.142 root-level `SKILL.md` plugin surfacing — MED
- 2.1.128 `--plugin-dir ./x.zip` + `--plugin-url` (below window but note) — HIGH

## 6. Skills
- 2.1.178 nested `.claude/skills` directory loading — HIGH
- 2.1.163 `\$` escape for literal `$` in descriptions — MED
- 2.1.152 frontmatter `Skill` type indicator + `disallowed-tools`; `/reload-skills` — HIGH
- 2.1.142 root-level `SKILL.md` — MED
- (below window, Fase 4) 2.1.105 `skillListingBudgetFraction`, `maxSkillDescriptionChars`

## 7. Subagents / agents
- 2.1.178 "closest .claude/" precedence for agent conflicts — HIGH
- 2.1.172 nested sub-agents (5-level depth limit) — HIGH
- 2.1.157 `subagent_type` case/separator-insensitive; `/agents` discovery — MED
- 2.1.154 settings `agent` key; plugin `defaultEnabled` applies to agents — HIGH
- 2.1.143 agent spawning in auto mode — MED

## 8. Slash commands
- 2.1.147 `/simplify` → `/code-review` rename — LOW
- 2.1.152 `/code-review --fix` — LOW
- 2.1.139 `/goal`, `/scroll-speed` new commands — LOW
- (frontmatter argument-hint/allowed-tools/model + namespacing: stable)

## 9. Permissions
- 2.1.178 `Tool(param:value)` parameter-level matching — HIGH
- 2.1.166 glob pattern support in deny rule tool-name position — HIGH
- 2.1.154 auto mode hard-deny rules — HIGH
- 2.1.162 WebFetch precedence fixes — MED
- 2.1.160 single-file grep satisfies read-before-edit — MED
- (allow/deny/ask arrays: stable)

## 10. Model lineup
- 2.1.154 **Opus 4.8** new default; `/effort xhigh` new effort level — HIGH
- 2.1.158 auto mode on Bedrock/Vertex/Foundry for Opus 4.7/4.8 — HIGH
- 2.1.170 **Fable 5** (Mythos-class) introduced — HIGH
- 2.1.173 Fable 5 name normalization (`[1m]` suffix) — HIGH
- 2.1.142 fast mode default Opus 4.6 → 4.7 — HIGH
- settings model keys: `model`, `availableModels`, `enforceAvailableModels`, `fallbackModel`, `effortLevel` (now incl. `xhigh`)

## 11. Output styles / statusline / background / managed / sandbox
- 2.1.181 `sandbox.allowAppleEvents` — HIGH
- 2.1.176 `footerLinksRegexes`; `language` key — MED
- 2.1.169 `--safe-mode`; env `CLAUDE_CLIENT_PRESENCE_FILE` — HIGH
- 2.1.166 env `MAX_THINKING_TOKENS=0` — MED
- 2.1.153 statusline env `COLUMNS`, `LINES` — MED
- 2.1.143 `worktree.bgIsolation` — HIGH
- 2.1.141 hook `terminalSequence`; background agent permission-mode preservation — HIGH/MED
- 2.1.140 settings symlink hot-reload — MED
- 2.1.133 managed `parentSettingsBehavior`, `policyHelper` — HIGH
- 2.1.128 env `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` — MED

## Sources
- Official changelog: https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
- What's new: https://code.claude.com/docs/en/whats-new · Settings: https://code.claude.com/docs/en/settings · Plugins: https://code.claude.com/docs/en/plugins