From 0a2d3604c008415e84fa27cc51933015066d9b26 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Mon, 1 Jun 2026 00:13:49 +0500 Subject: [PATCH] chore(settings-changelog): log v2.1.158 run (workflow settings, Opus 4.8, auto-mode env) Co-Authored-By: Claude --- .../claude-settings/changelog.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md index e2b8931..cab7281 100644 --- a/changelog/best-practice/claude-settings/changelog.md +++ b/changelog/best-practice/claude-settings/changelog.md @@ -624,3 +624,26 @@ | 15 | 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) | | 16 | INVALID | Spurious Drift Claim | `claude-code-guide` agent flagged `NO_COLOR` / `FORCE_COLOR` as missing env vars (claimed v2.1.143 subprocess pass-through). Verified directly against official /en/env-vars page — neither is documented; the v2.1.143 changelog entry covers `worktree.bgIsolation` + PowerShell ExecutionPolicy, not NO_COLOR. Not added per Rule 8A/5D | ❌ INVALID (agent claim unverified against official docs) | | 17 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` low-confidence noise keys `additionaleventDirectory` and `teammateDefaultModel` — garbled WebFetch-summary artifacts, not source-verified on official settings page. Not added per Rule 8A | ❌ INVALID (WebFetch-summary transcription noise) | + +--- + +## [2026-06-01 12:03 AM PKT] Claude Code v2.1.158 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Version Bump | Update report version badge from v2.1.150 → v2.1.158 and header "As of v2.1.150" → "As of v2.1.158" | ✅ COMPLETE (badge synced in Phase 2.6; body header text updated to v2.1.158) | +| 2 | HIGH | New Setting | Add `disableWorkflows` (boolean, default `false`, any scope) to General Settings — disables dynamic workflows + bundled workflow commands (v2.1.154 introduced workflows). Env equiv `CLAUDE_CODE_DISABLE_WORKFLOWS`. Confirmed on official settings page | ✅ COMPLETE (added to General Settings table after `disableAgentView`) — NEW | +| 3 | HIGH | New Setting | Add `workflowKeywordTriggerEnabled` (boolean, default `true`, min-version 2.1.157) to General Settings — whether the word "workflow" in a prompt triggers a dynamic workflow. Appears in `/config`. Confirmed on official settings page | ✅ COMPLETE (added to General Settings table after `disableWorkflows`) — NEW | +| 4 | HIGH | Model Aliases | Update Model Aliases + Effort Level: Opus 4.8 is now the latest Opus on the Anthropic API (v2.1.154), defaults to high effort, `/effort xhigh` supported. Report currently says `opus` = "Opus 4.7 (Anthropic API)" with no mention of 4.8. RECURRING-style platform-version drift (last touched v2.1.150 #10) | ✅ COMPLETE (updated `opus` alias to Opus 4.8 on Anthropic API; updated `effortLevel` desc, Effort Level table XHigh row, and effort note for Opus 4.8) — NEW | +| 5 | HIGH | New Env Var | Add `CLAUDE_CODE_ENABLE_AUTO_MODE` (set to `1`) to env vars table — enables auto mode on Bedrock/Vertex/Foundry for Opus 4.7 and Opus 4.8 (v2.1.158). Changelog-only — NOT on official /en/env-vars page; annotate per Rule 5D | ✅ COMPLETE (added to env vars table after `CLAUDE_CODE_DISABLE_WORKFLOWS` with changelog-only annotation; also added to Quick Reference `env` block) — NEW | +| 6 | MED | New Setting | Add `teammateDefaultModel` (string, default `null`, `~/.claude.json` Global config) to Global Config Settings table — default model for agent-team teammates; `null` inherits lead's model. Confirmed on official settings page. NOTE: prior run v2.1.150 #17 wrongly rejected this as "garbled noise" — now source-verified | ✅ COMPLETE (added to Global Config Settings `~/.claude.json` table after `externalEditorContext`; corrects v2.1.150 #17 false-reject) — NEW | +| 7 | MED | New Setting | Add `pluginSuggestionMarketplaces` (array, managed-only) to Plugin Settings table — marketplace names whose plugins can appear as contextual install suggestions. Confirmed on official settings page | ✅ COMPLETE (added to Plugin Settings table after `strictPluginOnlyCustomization`) — NEW | +| 8 | MED | New Setting | Add `disableWorkflows` companion env var `CLAUDE_CODE_DISABLE_WORKFLOWS` to env vars table — confirmed on official /en/env-vars page | ✅ COMPLETE (added to env vars table after `CLAUDE_CODE_DISABLE_AGENT_VIEW`) — NEW | +| 9 | MED | MCP Annotation | Remove "(in v2.1.150 changelog, not yet on official settings page)" annotation from `allowAllClaudeAiMcps` in MCP Settings table — now confirmed on official settings page (managed-only boolean). Per Rule 1F | ✅ COMPLETE (stale changelog-only annotation removed from MCP Settings table row) — NEW | +| 10 | MED | Permission Mode | Update `auto` permission mode note — official settings page states auto mode is "not allowed in project/local settings as of v2.1.142". Verify report's `disableAutoMode`/`autoMode` scope notes capture this | ❌ INVALID (verification-only; report's `autoMode`/`disableAutoMode` rows already document "not read from shared project settings" — no change needed) — NEW | +| 11 | LOW | New Setting (session-only) | Consider documenting `ultracode` (boolean, session-only, not persisted) — appears in official "Available settings" list but is session-scoped (set via `/effort ultracode`, `--settings`, or SDK). Low value; annotate as session-only if added | ✅ COMPLETE (added to General Settings table after `workflowKeywordTriggerEnabled` with **(Session-only — not persisted)** annotation) — NEW | +| 12 | LOW | Worktree Default | Verify `worktree.symlinkDirectories`/`worktree.sparsePaths` defaults — report shows `[]`, official page shows `null`/undefined. Cosmetic; both behave as "no entries" | ❌ INVALID (cosmetic only — `[]` and `null`/undefined are behaviorally identical; report's `[]` is clearer for users) — NEW | +| 13 | LOW | Example Update | Update Quick Reference example to showcase v2.1.151–v2.1.158 features (e.g., `disableWorkflows`, `workflowKeywordTriggerEnabled`, or `CLAUDE_CODE_ENABLE_AUTO_MODE` env example) | ✅ COMPLETE (added `disableWorkflows`, `workflowKeywordTriggerEnabled`, and `CLAUDE_CODE_ENABLE_AUTO_MODE` to Quick Reference; JSON re-validated, 39 keys) — NEW | +| 14 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` — v2.1.157 changelog says `OTEL_LOG_TOOL_DETAILS=1` includes tool parameters in telemetry, but still NOT on official /en/env-vars page after 20+ runs. Already in report with annotation (Rule 10B option a) | ✋ ON HOLD (kept — recurring from 2026-04-14 v2.1.107; v2.1.157 changelog re-confirms behavior) | +| 15 | 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) | +| 16 | INVALID | Source Guard | Changelog v2.1.158 lists `CLAUDE_CODE_ENABLE_AUTO_MODE` but env-vars page does not yet document it — flagged as changelog-only (item #5), not as a confirmed env-vars-page var, per Rule 8A/5D | ❌ INVALID (changelog-only; annotated rather than treated as docs-confirmed) |