diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md index 07e1b59..b9d4b05 100644 --- a/changelog/best-practice/claude-settings/changelog.md +++ b/changelog/best-practice/claude-settings/changelog.md @@ -485,3 +485,24 @@ | 13 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 14+ consecutive runs. Per Rule 10B, deferred pending official docs update | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107) | | 14 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | | 15 | HIGH | Broken Link | Fix two `[auto mode](/en/permission-modes#eliminate-prompts-with-auto-mode)` links at lines 237 and 238 (in `autoMode` and `disableAutoMode` descriptions) — relative paths missing domain prefix. Replace with `https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode`. Anchor verified valid on official permission-modes page | ✅ COMPLETE (both links updated to absolute `https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode` URL) | + +--- + +## [2026-05-01 03:29 PM PKT] Claude Code v2.1.126 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Version Bump | Update report version badge from v2.1.121 → v2.1.126 and header "As of v2.1.121" → "As of v2.1.126" | ✅ COMPLETE (badge updated in Phase 2.6, body header text updated to v2.1.126) | +| 2 | HIGH | New Setting | Add `preferredNotifChannel` to Display Settings table — string, default `"auto"`, values: `"auto"`, `"terminal_bell"`, `"iterm2"`, `"iterm2_with_bell"`, `"kitty"`, `"ghostty"`, `"notifications_disabled"`. Method for task-complete and permission-prompt notifications. Confirmed on official settings page | ✅ COMPLETE (added to Display Settings table after `terminalProgressBarEnabled` with full enum values, default, and `/en/terminal-config` cross-link) | +| 3 | HIGH | New Env Var | Add `ANTHROPIC_BEDROCK_SERVICE_TIER` to env vars table — Bedrock service tier (`default`, `flex`, or `priority`); sent as `X-Amzn-Bedrock-Service-Tier` header. v2.1.122. Confirmed on official /en/env-vars page | ✅ COMPLETE (added after `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` with v2.1.122 attribution and `/en/amazon-bedrock#service-tiers` cross-link) | +| 4 | HIGH | New Env Var | Add `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` to env vars table — set by host platforms that embed Claude Code; provider/auth env vars in settings.json are ignored when set; telemetry follows standard `DISABLE_TELEMETRY` opt-out instead of auto-disabling on Bedrock/Vertex/Foundry. v2.1.126. Confirmed on official /en/env-vars page | ✅ COMPLETE (added after `ANTHROPIC_BEDROCK_SERVICE_TIER` with full description, ignored-vars list, and v2.1.126 attribution) | +| 5 | MED | Permission Modes | Update `bypassPermissions` description (line 248) — v2.1.126 extended exemption to also bypass writes to `.claude/`, `.git/`, `.vscode/`, and shell config files. Catastrophic removal commands still prompt. Builds on v2.1.121 `.claude/commands/`, `.claude/agents/`, `.claude/skills/`, `.claude/worktrees/` exemption | ✅ COMPLETE (description extended with v2.1.126 exemptions for `.claude/`, `.git/`, `.vscode/`, and shell config files; catastrophic-removal safety net retained) | +| 6 | MED | Changed Description | Enrich `defaultShell` description — v2.1.126: when PowerShell is enabled (`CLAUDE_CODE_USE_POWERSHELL_TOOL=1`), it is treated as the **primary** shell. v2.1.120: PowerShell is the fallback shell when Git for Windows is unavailable. Also note v2.1.126 PowerShell 7 detection (Microsoft Store, MSI without PATH, .NET global tool) | ✅ COMPLETE (description enriched with v2.1.120 fallback behavior, v2.1.126 primary-shell flip, and PowerShell 7 detection sources) | +| 7 | LOW | spinnerTipsOverride Note | Optionally enrich `spinnerTipsOverride.excludeDefault` description (line 580) with v2.1.121 detail "suppresses time-based spinner tips". Currently accurate per official settings page wording but lacks the v2.1.121 changelog refinement | ✅ COMPLETE (description expanded with `excludeDefault` semantics from official docs and v2.1.121 time-based tip suppression refinement) | +| 8 | LOW | /config Persistence Note | Add brief note to Settings Hierarchy section that `/config` now persists changes to `~/.claude/settings.json` (v2.1.126). Informational, not a new key | ✅ COMPLETE (added v2.1.126 `> Note` block under Settings Hierarchy after the v2.1.75 Windows path note) | +| 9 | LOW | Example Update | Update Quick Reference example to showcase v2.1.122–v2.1.126 features — `preferredNotifChannel` and an `ANTHROPIC_BEDROCK_SERVICE_TIER` env example | ✅ COMPLETE (added `"preferredNotifChannel": "terminal_bell"` after `prefersReducedMotion` and `"ANTHROPIC_BEDROCK_SERVICE_TIER": "priority"` to the `env` block) | +| 10 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 16+ consecutive runs. Per Rule 10B, deferred pending official docs update | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107) | +| 11 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | +| 12 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` reported `autoSummaryEnabled` as a separate setting from `awaySummaryEnabled` (HIGH-confidence claim). Verified directly against official settings page — `autoSummaryEnabled` does NOT exist; only `awaySummaryEnabled` is documented | ❌ INVALID (agent contradicted by direct doc verification) | +| 13 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` claimed `Agent` permission rule syntax should be `Agent(agent:name)` with an `agent:` prefix. Verified against official settings page — only references `Agent` rules without showing the `agent:` prefix syntax. Report's existing `Agent(name)` form matches established convention; no source confirms the prefix variant | ❌ INVALID (no source-verified evidence for `agent:` prefix) | +| 14 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` flagged `model` default (`"default"`) and `language` default (`"english"`) in Core Configuration as cosmetically wrong because the official docs show `-`. The report's values are descriptive placeholders explaining behavior when unset; flipping to `-` would lose information without any user-facing benefit | ❌ INVALID (cosmetic re-verification with no user-facing benefit) |