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

log 2026-04-29 claude-settings run for v2.1.121 — 13 actions completed, 2 ON HOLD

Browse Source 
Records the v2.1.121 settings update: alwaysLoad, sshConfigs, status line
fields, ~/.claude.json → settings.json file-scope migration, AI_AGENT and
OTEL_LOG_USER_PROMPTS env vars, bypassPermissions exemption, /effort xhigh,
\${CLAUDE_EFFORT}, and broken auto-mode anchor links. OTEL_LOG_TOOL_DETAILS
and OTEL_LOG_TOOL_CONTENT remain ON HOLD per Rule 8A/10B.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-04-29 01:23:52 +05:00
parent a43dcd783a
commit 2c40369f4d
1 changed files with 22 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
changelog/best-practice/claude-settings/changelog.md
+22
View File
@@ -463,3 +463,25 @@
| 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 | `claude-code-guide` agent reported `attribution.pr` as a NEW v2.1.119 setting. Verified against current report (line 149) — already documented in Attribution Settings table | ❌ INVALID (already in report) |
| 14 | INVALID | Spurious Drift Claim | `claude-code-guide` agent claimed `sandbox.network.deniedDomains` was added v2.1.116. Workflow agent and report (line 386) both confirm v2.1.113 introduction (matches recent v2.1.114 changelog entry that resolved its prior unverified status). Report value retained | ❌ INVALID (agent contradicted by report-specific agent + prior changelog) |
---
## [2026-04-29 12:49 AM PKT] Claude Code v2.1.121
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Version Bump | Update report version badge from v2.1.119 → v2.1.121 and header "As of v2.1.119" → "As of v2.1.121" | ✅ COMPLETE (badge updated in Phase 2.6, header text updated to v2.1.121) |
| 2 | HIGH | New Setting | Add `sshConfigs` to a new Workspace & Teams subsection (object[], required: `id`/`name`/`sshHost`; optional: `sshPort`/`sshIdentityFile`/`startDirectory`). Provides SSH connection dropdown in Desktop. Per official settings page section 14 | ✅ COMPLETE (new Workspace & Teams subsection added with Key table, Field reference table, and JSON example) |
| 3 | HIGH | New MCP Option | Add `alwaysLoad` to MCP Settings — boolean per-server option, exempts server from tool-search deferral; available on all server types; requires v2.1.121+. Per-tool variant via `_meta: {"anthropic/alwaysLoad": true}`. Confirmed on official MCP page | ✅ COMPLETE (new "Per-Server Tool Loading" subsection added under MCP Servers with rationale, JSON example, and per-tool `_meta` variant) |
| 4 | HIGH | Status Line Fields | Add `effort.level` (low/medium/high/xhigh/max) and `thinking.enabled` to Status Line Input Fields table (v2.1.121). Confirmed on official statusline docs | ✅ COMPLETE (both fields added after `agent.name` row with v2.1.121 attribution) |
| 5 | HIGH | File Scope Migration | Move `autoScrollEnabled`, `editorMode`, `showTurnDuration`, `teammateMode`, `terminalProgressBarEnabled` from Global Config Settings (`~/.claude.json`) table to main Display Settings table (settings.json). Add historical note: "Versions before v2.1.119 stored these in `~/.claude.json`". Reverses Rule 1H findings from v2.1.78/v2.1.86/v2.1.107/v2.1.114 — official docs now explicitly list them under "Available settings" with the historical note | ✅ COMPLETE (5 keys added to Display Settings table with per-key historical note; removed from Global Config Settings table; v2.1.119 migration callout added to Global Config Settings preamble) |
| 6 | HIGH | Missing Env Var | Add `AI_AGENT` to env vars table — env var injected into subprocesses by Claude Code (similar to `CLAUDECODE`). v2.1.120 changelog only — annotate accordingly | ✅ COMPLETE (added after `CLAUDECODE` row with changelog-only annotation) |
| 7 | HIGH | Missing Env Var | Add `OTEL_LOG_USER_PROMPTS` to env vars table — gates `user_system_prompt` field in OTel LLM request spans. v2.1.121 changelog. **RECURRING** (first seen 2026-04-16 v2.1.110) — was deferred per Rule 8A but now actionable per fresh v2.1.121 changelog mention | ✅ COMPLETE (added after `OTEL_LOG_RAW_API_BODIES` with changelog-only annotation — RECURRING resolved, first seen 2026-04-16) |
| 8 | MED | Permission Behavior | Add v2.1.121 `--dangerously-skip-permissions` exclusion note to Permissions section. Re-verified against official permission-modes docs: the change is that writes to `.claude/commands/`, `.claude/agents/`, `.claude/skills/`, and `.claude/worktrees/` are EXEMPT from the protected-paths prompt under bypassPermissions — i.e., these subdirectories now auto-approve, opposite of the agent's original framing | ✅ COMPLETE (description added to `bypassPermissions` row in Permission Modes table with corrected framing per official docs — exemption, not restriction) |
| 9 | MED | Changed Description | Update `language` setting description — v2.1.121 also applies the language to the terminal tab title | ✅ COMPLETE (terminal tab title behavior appended to `language` description with v2.1.121 attribution) |
| 10 | MED | Useful Commands | Update `/effort` row to include `xhigh` value (currently lists only `low`/`medium`/`high`) | ✅ COMPLETE (`/effort` row now lists `low`, `medium`, `high`, `xhigh` (Opus 4.7 only, v2.1.111), and `max` (Opus 4.6 only)) |
| 11 | LOW | Skill Variable Note | Add brief `${CLAUDE_EFFORT}` skill template variable note (v2.1.120) — informational, not strictly a settings key | ✅ COMPLETE (added to Effort Level Note section as "Skill template variable" sentence with v2.1.120 attribution) |
| 12 | LOW | Example Update | Update Quick Reference example to showcase v2.1.121 features (MCP `alwaysLoad`, `sshConfigs`, or new status line fields) | ✅ COMPLETE (added `mcpServers` block with `alwaysLoad: true` and `sshConfigs` block to Quick Reference example) |
| 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) |