gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

log v2.1.126 settings workflow run with 14 actions

Browse Source 
Appends a new dated entry (2026-05-01 03:29 PM PKT) for the Claude Code v2.1.126 settings update:
- 9 COMPLETE: version-bump, 3 new keys (preferredNotifChannel, ANTHROPIC_BEDROCK_SERVICE_TIER, CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST), enriched bypassPermissions/defaultShell/spinnerTipsOverride descriptions, /config persistence note, Quick Reference example refresh
- 2 ON HOLD: OTEL_LOG_TOOL_DETAILS and OTEL_LOG_TOOL_CONTENT (changelog-only, recurring 16+ runs)
- 3 INVALID: spurious drift claims from research agent (autoSummaryEnabled non-existent, Agent(agent:name) prefix unverified, descriptive defaults flipped to "-" with no user benefit)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-05-01 16:15:49 +05:00
parent 27ff6b6c9b
commit 60f6831ddd
1 changed files with 21 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
changelog/best-practice/claude-settings/changelog.md
+21
View File
@@ -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) |