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

docs(claude-settings): log v2.1.145 changelog entry (25 items)

Browse Source 
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-05-21 00:37:45 +05:00
parent 14c01819b5
commit a28cd96b6c
1 changed files with 32 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
changelog/best-practice/claude-settings/changelog.md
+32
View File
@@ -568,3 +568,35 @@
| 20 | 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) |
| 21 | INVALID | Spurious Drift Claim | `claude-code-guide` listed effort values as `"fast"`, `"balanced"`, `"thorough"`. Verified against official /en/env-vars — valid values are `low`, `medium`, `high`, `xhigh`, `max`, `auto`. Report retained | ❌ INVALID (agent contradicted by official docs) |
| 22 | INVALID | Spurious Drift Claim | `claude-code-guide` claimed `CLAUDE_EFFORT` is a documented env var. Verified — only `CLAUDE_CODE_EFFORT_LEVEL` exists on /en/env-vars. `CLAUDE_EFFORT` is changelog-only (subprocess injection, not user-configurable). Report retained | ❌ INVALID (agent contradicted by official docs) |
---
## [2026-05-21 12:07 AM PKT] Claude Code v2.1.145
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Version Bump | Update report version badge from v2.1.139 → v2.1.145 and header "As of v2.1.139" → "As of v2.1.145" | ✅ COMPLETE (header text updated to v2.1.145; badge synced in Phase 2.6) |
| 2 | HIGH | New Setting | Add `claudeMdExcludes` (array, glob patterns of CLAUDE.md files to skip) to Core Configuration — listed on official settings page. RECURRING (first seen 2026-05-09 v2.1.138 #19, was deferred to HIGH-only scope) | ✅ COMPLETE (added to General Settings table with official wording) |
| 3 | HIGH | New Setting | Add `autoMemoryEnabled` (boolean, default `true`, enables auto memory read/write) to Core Configuration — currently only `autoMemoryDirectory` is documented. RECURRING (first seen 2026-05-09 v2.1.138 #20) | ✅ COMPLETE (added to Plans & Memory Directories table beside autoMemoryDirectory) |
| 4 | HIGH | New Worktree Setting | Add `worktree.bgIsolation` (string, `"worktree" \| "none"`, default `"worktree"`) to Worktree Settings table — `"none"` lets background sessions edit the working copy directly (v2.1.143). Confirmed on official settings page | ✅ COMPLETE (added to Worktree Settings table with official wording) |
| 5 | HIGH | New Env Var | Add `ANTHROPIC_WORKSPACE_ID` to Common Environment Variables table — workload identity federation, scopes the minted token (v2.1.139/v2.1.141). Confirmed in changelog | ✅ COMPLETE (added to env vars table — confirmed ON official /en/env-vars page this run, not changelog-only) |
| 6 | HIGH | Missing Permission Mode | Confirm/keep `dontAsk` and `auto` modes; verify `acceptEdits` description matches official permissions page wording ("Automatically accepts file edits and common filesystem commands `mkdir`, `touch`, `mv`, `cp`, etc. for paths in the working directory or `additionalDirectories`") — report's current description is shorter | ✅ COMPLETE (acceptEdits description expanded to official wording) |
| 7 | MED | Permission Behavior | Update `bypassPermissions` description with v2.1.144/v2.1.145 detail per official permissions page: "Removals targeting the filesystem root or home directory such as `rm -rf /` and `rm -rf ~` still prompt as a circuit breaker" (current report says "Catastrophic removal commands still prompt") | ✅ COMPLETE (bypassPermissions circuit-breaker wording updated to official text) |
| 8 | MED | Permission Syntax | Add PowerShell tool permission rules to Tool Permission Syntax table — official permissions page documents `PowerShell(cmd *)` rules with same shape as Bash, alias canonicalization, AST-based compound-command checking. Not currently in the report's tool syntax table | ✅ COMPLETE (PowerShell row added with alias-canonicalization + AST compound-command note) |
| 9 | MED | Permission Semantics | Add compound-command / process-wrapper semantics to Bash wildcard notes — official permissions page documents wrapper stripping (`timeout`, `time`, `nice`, `nohup`, `stdbuf`, bare `xargs`), exec-wrapper prompting (`watch`, `setsid`, `ionice`, `flock`, `find -exec`/`-delete`), and per-subcommand matching for `&&`/`||`/`;`/`|` | ✅ COMPLETE (compound-command + process-wrapper bullets added to Bash wildcard notes) |
| 10 | MED | Permission Semantics | Add symlink resolution behavior to Read/Edit path patterns — official permissions page: allow rules require both symlink path and target to match; deny rules apply if either matches | ✅ COMPLETE (symlink resolution note added after Read/Edit prefix table) |
| 11 | MED | New Env Var (Hook Input) | Add `$CLAUDE_EFFORT` to env vars table — Bash subprocess and hook input env exposing active effort level (companion to `CLAUDE_CODE_EFFORT_LEVEL`). RECURRING (first seen 2026-05-09 v2.1.138 #15, deferred) | ✅ COMPLETE (added to env vars table; confirmed NOT on official /en/env-vars page — annotated read-only/changelog-only per Rule 5D) |
| 12 | MED | New Env Var (Changelog) | Add `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` to env vars table — set to `1` to use Opus 4.6 for fast mode (v2.1.142 changed fast-mode default to Opus 4.7). v2.1.142 changelog only | ✅ COMPLETE (added to env vars table — confirmed ON official /en/env-vars page this run, NOT changelog-only as originally flagged) |
| 13 | MED | New Env Var (Changelog) | Add `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` to env vars table — set to `1` to opt out of PowerShell tool passing `-ExecutionPolicy Bypass` (v2.1.143). Changelog only | ✅ COMPLETE (added to env vars table — confirmed ON official /en/env-vars page this run, NOT changelog-only as originally flagged) |
| 14 | MED | New Env Var (Changelog) | Add `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` to env vars table — clone GitHub plugin sources over HTTPS (v2.1.141). Changelog only | ✅ COMPLETE (added to env vars table — confirmed ON official /en/env-vars page this run, NOT changelog-only as originally flagged) |
| 15 | MED | Plugin Marketplace | Add brief note that plugin marketplace `source: 'settings'` supports inline plugin entries directly in settings.json (v2.1.137). RECURRING (first seen 2026-05-09 v2.1.138 #16) | ✅ COMPLETE (verified already documented in Plugin Settings + inline example; no change needed) |
| 16 | MED | Status Line | Add `terminalSequence` hook-output field reference and note that status line JSON now includes GitHub repo + PR information when detected (v2.1.145) to Status Line section | ✅ COMPLETE (github status-line input field added; terminalSequence is a hook-output field, deferred to claude-code-hooks repo per Rule 4A) |
| 17 | MED | Model Aliases | Verify Model Aliases table reflects Opus 4.7 / fast-mode-default-Opus-4.7 (v2.1.142) and `/model` session-only-change behavior (v2.1.144, press `d` to set default). Add `opus[1m]` default-on-Max/Team/Enterprise note already present; add note that `/model` change is session-scoped | ✅ COMPLETE (added /model session-scoped note v2.1.144; opus alias left as 4.6 — version is platform-dependent: 4.7 on Anthropic API, 4.6 on Bedrock/Vertex) |
| 18 | MED | Useful Commands | Add `/usage-credits` to Useful Commands (renamed from `/extra-usage` in v2.1.144; old name still works) | ✅ COMPLETE (/usage-credits added to Useful Commands) |
| 19 | MED | Env Var Rename | Annotate `DISABLE_EXTRA_USAGE_COMMAND` — `/extra-usage` renamed to `/usage-credits` in v2.1.144; verify whether a `DISABLE_USAGE_CREDITS_COMMAND` alias now exists | ✅ COMPLETE (annotated DISABLE_EXTRA_USAGE_COMMAND with the rename; no separate DISABLE_USAGE_CREDITS_COMMAND var observed this run) |
| 20 | LOW | Header Count | Update header claim from "60+ settings" → "80+ settings" to reflect actual official count after additions. RECURRING (first seen 2026-05-09 v2.1.138 #22) | ✅ COMPLETE (header count updated 60+ → 80+) |
| 21 | LOW | Example Update | Update Quick Reference example to showcase v2.1.140–v2.1.145 features (e.g., `worktree.bgIsolation`, `claudeMdExcludes`, or `ANTHROPIC_WORKSPACE_ID` env example) | ✅ COMPLETE (Quick Reference now showcases claudeMdExcludes + worktree.bgIsolation) |
| 22 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 18+ consecutive runs. Per Rule 10B, deferred pending official docs update | ON HOLD (kept — recurring from 2026-04-14 v2.1.107) |
| 23 | 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) |
| 24 | INVALID | Ownership Boundary (no-op) | Cross-checked all env vars in `claude-cli-startup-flags.md` (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS, CLAUDE_CODE_TMPDIR, CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD, DISABLE_AUTOUPDATER, CLAUDE_CODE_EFFORT_LEVEL, USE_BUILTIN_RIPGREP, CLAUDE_CODE_SIMPLE, CLAUDE_BASH_NO_LOGIN, CCR_FORCE_BUNDLE) against the settings report. No duplication-without-cross-reference found; shared vars correctly carry cross-reference links both ways | ❌ INVALID (no boundary violation — Rule 5B passes) |
| 25 | INVALID | Hyperlink Validation (no-op) | All report hyperlinks validated: 12 ToC anchors resolve to headings; external URLs (settings, env-vars, permissions, schemastore via 301, feiskyer repo, shipyard blog, GitHub changelog) all return valid pages. `json.schemastore.org` still 301-redirects to `www.schemastore.org` (working) — leave as-is per v2.1.119 #8 decision | ❌ INVALID (no broken links — Rules 9A/9B/9C pass) |