diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md index 62200d3..9ced18d 100644 --- a/changelog/best-practice/claude-settings/changelog.md +++ b/changelog/best-practice/claude-settings/changelog.md @@ -422,4 +422,24 @@ | 11 | MED | Header Setting Count | Verify "60+ settings" count still accurate after adding `awaySummaryEnabled` and `externalEditorContext`; env var count "175+" still reasonable | ✅ COMPLETE (both counts remain within stated ranges — net +2 settings, +1 env var, headers accurate as "60+" and "175+") | | 12 | LOW | Cross-Link | Add bidirectional cross-links for `CLAUDE_CODE_SIMPLE` and `CLAUDE_CODE_EFFORT_LEVEL` between settings report and `claude-cli-startup-flags.md`. Currently one-way; startup-flags file links to settings report but settings report does not link back | ✅ COMPLETE (added cross-reference links back to `./claude-cli-startup-flags.md#environment-variables` for both env vars) | | 13 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still marked "in v2.1.85 changelog, not yet on official env-vars page" after 11+ consecutive runs. Per Rule 10B: consider resolving — either confirm via official docs or remove. Currently agent research confirms still absent from official docs | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107, annotation still accurate) | -| 14 | LOW | Suspect Key Recurrence | `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | \ No newline at end of file +| 14 | LOW | Suspect Key Recurrence | `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | + +--- + +## [2026-04-24 12:27 AM PKT] Claude Code v2.1.118 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Setting | Add `wslInheritsWindowsSettings` to managed-only settings (Windows HKLM registry / `C:\Program Files\ClaudeCode\managed-settings.json` only — WSL inherits Windows policy chain). Confirmed on official settings page | ✅ COMPLETE (added to General Settings table after `forceRemoteSettingsRefresh` with full description and v2.1.118 attribution) | +| 2 | HIGH | Changed Behavior | Update `autoMode` description to document `"$defaults"` sentinel — allows custom rules to be added alongside built-in rules instead of replacing them (v2.1.118). Confirmed on official settings page | ✅ COMPLETE (description updated — sentinel inheritance behavior documented inline with v2.1.118 attribution) | +| 3 | HIGH | New Env Var (Changelog) | Add `DISABLE_UPDATES` to env vars table — completely blocks all update paths including manual `claude update` (stricter than `DISABLE_AUTOUPDATER`). v2.1.118 changelog only, not yet on official /en/env-vars page | ✅ COMPLETE (added after `DISABLE_AUTOUPDATER` with changelog-only annotation) | +| 4 | MED | Stale Suspect Key | Remove `askEdits` and `viewOnly` rows from Permission Modes table — official permissions page lists only 6 modes (`default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`). Report has flagged both as "unverified" since v2.1.74 (2026-03-12). Per Rule 10B (5+ run ON HOLD escalation), resolve by removing | ✅ COMPLETE (both rows removed — RECURRING resolved, first seen 2026-03-12) | +| 5 | MED | Stale Suspect Key | Remove `allow_remote_sessions` from Permission Keys table — official permissions page explicitly notes "Access to Remote Control and web sessions is not controlled by a managed settings key." Admins manage this via Claude Code admin settings UI. First added v2.1.74 (2026-03-12) as a speculative managed setting; has not been documented since | ✅ COMPLETE (row removed from Permission Keys table — RECURRING resolved, first seen 2026-03-12) | +| 6 | MED | Changed Behavior | Update `cleanupPeriodDays` description — v2.1.117 expanded sweep to also clean `~/.claude/tasks/`, `~/.claude/shell-snapshots/`, and `~/.claude/backups/` (previously only transcripts and orphaned worktrees) | ✅ COMPLETE (description rewritten to cover the full sweep scope with v2.1.117 attribution) | +| 7 | MED | Effort Level Note | Add v2.1.117 Pro/Max default-effort change to Effort Level section — default for Pro/Max subscribers on Opus 4.6 and Sonnet 4.6 moved from `medium` to `high`. Current note only mentions the earlier v2.1.94 change for API-key/Bedrock/Vertex/Foundry/Team/Enterprise users | ✅ COMPLETE (Effort Level Note expanded with v2.1.117 Pro/Max alignment sentence) | +| 8 | LOW | Example Update | Update Quick Reference example to showcase v2.1.118 features — either `wslInheritsWindowsSettings` or `"$defaults"` sentinel in `autoMode.soft_deny` | ✅ COMPLETE (added `"soft_deny": ["$defaults", "Never run terraform apply"]` to autoMode block in Quick Reference) | +| 9 | LOW | New Env Var (Changelog) | Consider adding `CLAUDE_CODE_FORK_SUBAGENT` to env vars table — enables forked subagents on external builds. v2.1.117 changelog only, not yet on official /en/env-vars page | ✅ COMPLETE (added after `OTEL_LOG_RAW_API_BODIES` with changelog-only annotation) | +| 10 | LOW | New Env Var (Changelog) | Consider adding `OTEL_LOG_RAW_API_BODIES` to env vars table — emit full API request/response bodies as OpenTelemetry log events. v2.1.111 changelog only, not yet on official /en/env-vars page | ✅ COMPLETE (added after `OTEL_LOG_TOOL_DETAILS` with changelog-only annotation) | +| 11 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 12+ consecutive runs. Per Rule 10B, deferred pending official docs update | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107) | +| 12 | LOW | Suspect Key Recurrence | `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | +| 13 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` reported `sandbox.allowUnsandboxedCommands` default was wrong (claimed docs say `false`). Verified against official settings page — documented default is **`true`**. Report is correct as-is | ❌ INVALID (agent report contradicted by official docs on re-verification) | \ No newline at end of file