Kjell Tore Guttormsen
624f5edabc
The knowledge base was frozen at ~v2.1.111, describing an Opus-4.7 world after CC shipped Opus 4.8 and Fable 5. Refreshed three agent-facing knowledge files; every fact re-verified against the official changelog (~/.claude/cache/changelog.md, CC 2.1.181) on 2026-06-18. - feature-evolution.md: new Opus-4.8-era rows above the v2.1.111 freeze -- Opus 4.8 default + /effort xhigh (2.1.154), Fable 5 Mythos-class (2.1.170), post-session hook (2.1.169), MessageDisplay (2.1.152), /simplify -> /code-review (2.1.147), /config key=value (2.1.181). - hook-events-reference.md: 26 -> 28 events (+MessageDisplay, +post-session); documented Stop/SubagentStop additionalContext output field. - claude-code-capabilities.md: 2026-06 model/effort lineup table; bundled skills /simplify -> /code-review; documented /config key=value. - cc-2.1.x-changelog-delta.md: marked SUPERSEDED by the gap-matrix. Verification caught two version errors in STATE/matrix, corrected to the changelog: - Stop/SubagentStop additionalContext is 2.1.163, not 2.1.165 (2.1.165 was "Bug fixes" only; matrix row 109 already said 2.1.163). - settings `agent` field introduced 2.0.59; 2.1.157 = honored for dispatched `claude agents` sessions, not the introduction. New tests/knowledge/knowledge-staleness.test.mjs (8 tests) encodes the verified facts as a re-freeze guard (RED before edits, GREEN after). Full suite: 850/850 green (+8). self-audit PASS, A(100)/A(97).
121 lines
6.5 KiB
Markdown
121 lines
6.5 KiB
Markdown
# 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
|