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).
6.5 KiB
6.5 KiB
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
agentfield: introduced v2.0.59; v2.1.157 is when it became "honored for dispatchedclaude agentssessions" — 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-modedisables customizations (CLAUDE.md not loaded) — MED - 2.1.157 plugins in
.claude/skillsauto-load; "closest .claude/ wins" precedence — HIGH - 2.1.178 nested
.claude/skillsdirectory loading — MED
3. Hooks
- 2.1.178 new matcher syntax
Tool(param:value)— HIGH - 2.1.172 OTEL
modelattribute in hook output context — MED - 2.1.169 new event
post-session(self-hosted runners) — HIGH - 2.1.163
SubagentStopsupportsadditionalContextreturn — 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
skipLfsfor 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: falsemanifest field — HIGH - 2.1.149 managed
pluginSuggestionMarketplaces— MED - 2.1.143 plugin dependency enforcement (disable/enable) — MED
- 2.1.142 root-level
SKILL.mdplugin surfacing — MED - 2.1.128
--plugin-dir ./x.zip+--plugin-url(below window but note) — HIGH
6. Skills
- 2.1.178 nested
.claude/skillsdirectory loading — HIGH - 2.1.163
\$escape for literal$in descriptions — MED - 2.1.152 frontmatter
Skilltype 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_typecase/separator-insensitive;/agentsdiscovery — MED - 2.1.154 settings
agentkey; plugindefaultEnabledapplies to agents — HIGH - 2.1.143 agent spawning in auto mode — MED
8. Slash commands
- 2.1.147
/simplify→/code-reviewrename — LOW - 2.1.152
/code-review --fix— LOW - 2.1.139
/goal,/scroll-speednew 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 xhighnew 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;languagekey — MED - 2.1.169
--safe-mode; envCLAUDE_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