Changelog
[v2.1.138] β 2026-05-09
Synced to Claude Code v2.1.138
Bumps tutorial coverage from Claude Code v2.1.131 β v2.1.138 (May 9, 2026 release). Anthropic shipped seven patches between v2.1.132 and v2.1.138 since the last sync.
Added (English docs)
worktree.baseRefsetting (v2.1.133) β controls whetherclaude --worktreebranches fromorigin/<default>("fresh", default) or localHEAD("head"). Behavior change: the"fresh"default reverts the v2.1.128 behavior, so users who relied on local-HEADbranching after v2.1.128 must opt back in. Documented in09-advanced-features/README.md.autoMode.hard_denyadmin key (v2.1.136) β array of classifier rules that block a class of actions regardless of inferred user intent. Use for actions that must never run in auto mode (e.g.,rm -rf /, force-push to protected branches). Unlikesoft_deny, hard-deny rules are not negotiable by the classifier. Documented in09-advanced-features/README.md.parentSettingsBehavioradmin key (v2.1.133+, admin-tier) β controls how the SDK'smanagedSettingsmerges with parent-process settings."first-wins"keeps existing precedence;"merge"deep-merges values. Documented in09-advanced-features/README.md.Setuphook event β initial environment setup (one-time per session); use to provision tooling or install deps. Brings the documented hook-events total from 28 to 29. Documented in06-hooks/README.md.effort.levelfield in hook input JSON (v2.1.133) β exposes the active effort level (low/medium/high/xhigh/max) to hooks. Documented in06-hooks/README.md.CLAUDE_CODE_SESSION_IDenvironment variable in Bash subprocesses (v2.1.132) β session UUID matching thesession_idfield in hook input JSON, for correlating bash logs with hook telemetry. Documented in06-hooks/README.md.CLAUDE_EFFORTenvironment variable in Bash subprocesses (v2.1.133) β active effort level, matchingeffort.levelin hook input JSON. Documented in06-hooks/README.md.sandbox.bwrapPathandsandbox.socatPathsettings (v2.1.133+, Linux/WSL) β point Claude Code at non-standard install locations forbubblewrapandsocat. Default to$PATHlookup. Documented in09-advanced-features/README.md.CLAUDE_CODE_DISABLE_ALTERNATE_SCREENenvironment variable (v2.1.132). Documented in09-advanced-features/README.md.CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTELenvironment variable (v2.1.136) β re-enables the session-quality survey for organizations capturing OpenTelemetry data; off by default in OTEL deployments. Documented in09-advanced-features/README.md.
Changed
- Behavior change: Plan mode now blocks all file writes unconditionally
(v2.1.136), including when a matching
Edit(...)rule exists inpermissions.allow. Previously a permissiveEdit(...)rule could let writes through in plan mode; that bypass is closed. Workflows that depended on the older behavior must exit plan mode (Shift+Tab) before editing. Documented in09-advanced-features/README.md. - Plugin spaced slash commands (e.g.,
/myplugin review) now resolve to/myplugin:review. Pluginskillsconfig entries no longer hide the defaultskills/directory β both are merged. Documented in07-plugins/README.md. - MCP servers now persist across
/clear(v2.1.132+). Documented in05-mcp/README.md. - Subagents discover project, user, and plugin skills via the Skill tool
(v2.1.133). Documented in
04-subagents/README.md. --permission-modeis now honored when resuming plan-mode sessions (v2.1.132). Documented in09-advanced-features/README.md.CronListoutput now includes the qualifier(s) and the scheduled prompt body (v2.1.136), so you can audit what each cron will run without opening it. Documented in09-advanced-features/README.md.
Fixed
- OAuth refresh-token concurrent-refresh race condition.
- INDEX.md count drift: Skills 28 β 16, Plugins 40 β 27, Hooks scripts
8 β 9 (recounted from the markdown content tree). The new totals reflect a
.md-only methodology that scopes counts to tutorial content rather than build artifacts and config. - Stale source URLs in
CATALOG.md(v2.1.118 β v2.1.138) andclaude_concepts_guide.md(v2.1.117 β v2.1.138). Removed a duplicate legacy footer in the concepts guide.
Notes for translation maintainers
The vi/, zh/, uk/, and ja/ localized trees are community-maintained
and may lag the English source. Contributors syncing translations should diff
against the English files updated in this release.
[v2.1.131] β 2026-05-06
Synced to Claude Code v2.1.131
Bumps tutorial coverage from Claude Code v2.1.126 β v2.1.131 (May 6, 2026 release). Anthropic shipped v2.1.128, v2.1.129, and v2.1.131 since the last sync; v2.1.127 and v2.1.130 were skipped and never released publicly.
Added (English docs)
--plugin-url <url>flag (v2.1.129) β fetches a plugin.ziparchive from a URL for the current session. Repeatable. Documented in07-plugins/README.md.CLAUDE_CODE_FORCE_SYNC_OUTPUTenv var (v2.1.129) β forces synchronous output for terminals where auto-detection misses (e.g., Emacseat). Documented in10-cli/README.mdand09-advanced-features/README.md.CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEenv var (v2.1.129) β enables background upgrades for Homebrew/WinGet installs (which normally do not auto-update). Documented in10-cli/README.mdand09-advanced-features/README.md.CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERYenv var (v2.1.129) β required to opt in to/v1/modelsgateway discovery (see Changed). Documented in10-cli/README.md.disableRemoteControlsetting (v2.1.128) β admins can blockclaude remote-controland/remote-controlvia managed/policy scope. Documented in09-advanced-features/README.md.--plugin-diraccepts.ziparchives (v2.1.128) β alongside directory inputs. Documented in07-plugins/README.md.skillOverridesaccepts"name-only"and"user-invocable-only"(v2.1.129) β in addition to the previous"on"/"off". Documented in03-skills/README.md.
Changed
- Behavior change: Gateway
/v1/modelsdiscovery is now opt-in (v2.1.129). Previously (v2.1.126), settingANTHROPIC_BASE_URLautomatically populated/modelfrom the gateway's/v1/modelsendpoint. From v2.1.129, users must additionally setCLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1; without the env var,/modelfalls back to the built-in static list. Documented in10-cli/README.md. /mcpshows tool count per server and visually flags servers reporting 0 tools (v2.1.128). Documented in05-mcp/README.md.- Bare
/color(no args) picks a random session color (v2.1.128); explicit/color <name|hex>continues to set a specific color. Documented in01-slash-commands/README.md. --channelsflag now works with API-key (console) authentication (v2.1.128). Earlier releases required Pro/Max OAuth. Documented in09-advanced-features/README.md.- Ctrl+R history picker defaults to all prompts across all projects
(v2.1.129). Press Ctrl+S inside the picker to narrow scope to the current
project. Documented in
09-advanced-features/README.md. /contextno longer dumps its ASCII visualization into the conversation (v2.1.129). The viz is shown in-UI only; no more ~1.6k token cost per invocation. Documented in09-advanced-features/README.md.- Oversized images in drag-and-drop are auto-downscaled (v2.1.128) β earlier versions rejected images outright.
Fixed
- VS Code extension activation on Windows (v2.1.131).
- Mantle endpoint authentication (v2.1.131).
- 1-hour prompt-cache TTL no longer truncated to 5 minutes (v2.1.129).
- Crash on stdin payloads larger than 10 MB (v2.1.128).
Notes for translation maintainers
The vi/, zh/, uk/, and ja/ localized trees are community-maintained
and may lag the English source. Contributors syncing translations should diff
against the English files updated in this release.
[v2.1.126] β 2026-05-02
Synced to Claude Code v2.1.126
Bumps tutorial coverage from Claude Code v2.1.119 β v2.1.126 (May 1, 2026 release). v2.1.120 was rolled back on its first release day (2026-04-24) but re-released successfully on 2026-04-28 with the originally-reported regressions fixed. v2.1.124 and v2.1.125 were skipped by Anthropic and never released.
Added (English docs)
claude project purge [path]subcommand (v2.1.126) β deletes all Claude Code state for a project (transcripts, tasks, debug logs, file-edit history, prompt history,~/.claude.jsonentry). Supports--dry-run,-y/--yes,-i/--interactive,--all. Documented in10-cli/README.md.claude plugin prunesubcommand (v2.1.121) β removes orphaned auto-installed plugin dependencies;plugin uninstall --prunecascades. Documented in07-plugins/README.md.claude ultrareview [target]subcommand (v2.1.120) β runs/ultrareviewnon-interactively from CI/scripts, prints findings to stdout, exits 0/1 on success/failure; supports--jsonand--timeout <minutes>. Documented in10-cli/README.md.${CLAUDE_EFFORT}placeholder available inside skill content (v2.1.120) β resolves to the current effort level. Documented in03-skills/README.md.alwaysLoadMCP server config option (v2.1.121) β whentrue, all tools from that server skip tool-search deferral. Documented in05-mcp/README.md.PostToolUse.hookSpecificOutput.updatedToolOutputnow works for all tools (v2.1.121), previously MCP-only. Documented in06-hooks/README.md.ANTHROPIC_BEDROCK_SERVICE_TIERenvironment variable (v2.1.122) β selects Bedrock service tier (default,flex,priority). Documented in10-cli/README.mdenv-var table.--dangerously-skip-permissionsextended-path coverage (v2.1.121, v2.1.126) β now bypasses prompts for writes to.claude/skills/,.claude/agents/,.claude/commands/,.claude/,.git/,.vscode/, shell config files. Catastrophic removal commands (rm -rf /etc.) still prompt. Documented in09-advanced-features/README.mdpermission-modes section.- OAuth code paste fallback (v2.1.126) β
claude auth loginaccepts the OAuth code pasted into the terminal when the browser callback can't reach localhost (WSL2, SSH, containers). Documented in10-cli/README.md. - Type-to-filter
/skillsmenu (v2.1.121). Documented in03-skills/README.md. AI_AGENTenvironment variable (v2.1.120) β set on subprocesses soghcan attribute traffic to Claude Code. Documented in10-cli/README.mdenv-var table.
Changed
--from-pr(v2.1.119) and/resumePR-URL search (v2.1.122) now both support GitHub, GitHub Enterprise, GitLab, and Bitbucket URLs.- Windows: Git for Windows / Git Bash no longer required (v2.1.120) β Claude
Code uses PowerShell as the shell tool when Git Bash is absent. From v2.1.126,
PowerShell is the primary shell when the PowerShell tool is enabled. Detection
extended to PowerShell 7 installed via Microsoft Store, MSI without PATH, or
.NET global tool. Documented in09-advanced-features/README.mdplatform notes. /modelpicker now lists models from your gateway's/v1/modelsendpoint whenANTHROPIC_BASE_URLpoints at an Anthropic-compatible gateway (v2.1.126). Documented in10-cli/README.md.--dangerously-skip-permissionsno longer prompts for writes to a much broader allowlist (see Added). Catastrophic removals still prompt.- Image paste auto-downscale (v2.1.126) β images larger than 2000px are downscaled on paste; oversized images in history are auto-removed and the request retried. (Tutorial-relevant only as a safety/UX note.)
Security
- Fixed
allowManagedDomainsOnly/allowManagedReadPathsOnlybeing ignored when a higher-priority managed-settings source lacked asandboxblock (v2.1.126).
Notes for translation maintainers
The vi/, zh/, uk/, and ja/ localized trees are community-maintained
and may lag the English source. Contributors syncing translations should diff
against the English files updated in this release.
[v2.4.0] β 2026-04-27
Synced to Claude Code v2.1.119
Bumps tutorial coverage from Claude Code v2.1.112 β v2.1.119 (April 23, 2026 release). v2.1.120 was published April 24, briefly rolled back the same day due to regressions, and re-released on April 28 with fixes β it is now part of the normal release line. A subsequent v2.1.126 (May 1, 2026) is the next stable target and is covered in the v2.1.126 entry above.
Added (English docs)
- Native binary packaging note (v2.1.113) β CLI now ships per-platform native binaries
bfs/ugrepGlob/Grep substitution footnote on native macOS/Linux builds (v2.1.117)mcp_toolhook type with example (v2.1.118)duration_msfield on PostToolUse / PostToolUseFailure inputs (v2.1.119)prUrlTemplatesetting (v2.1.119) and expanded--from-prprovider list (GitLab, Bitbucket)cleanupPeriodDaysextended scope (checkpoints + tasks + shell-snapshots + backups, v2.1.117)- Plugin marketplace enforcement on every lifecycle event (v2.1.117) and
hostPattern/pathPatternregex (v2.1.119) - New env vars:
DISABLE_UPDATES,CLAUDE_CODE_HIDE_CWD,CLAUDE_CODE_FORK_SUBAGENT,OTEL_LOG_TOOL_DETAILS,ENABLE_TOOL_SEARCHVertex opt-in - New slash commands:
/btw,/themewith custom themes /usagecanonical command (merges/cost+/stats, v2.1.118)- Forked subagents (
CLAUDE_CODE_FORK_SUBAGENT=1, v2.1.117) - Auto mode
"$defaults"token (v2.1.118) wslInheritsWindowsSettingsmanaged policy (v2.1.118)- Vim visual / visual-line modes (v2.1.118)
claude install [version]andclaude plugin tagsubcommands
Changed
- Documentation host migrated:
docs.anthropic.com/en/docs/claude-code/*βcode.claude.com/docs/en/* - Opus 4.7 effort levels:
xhighis now the Claude Code default since the 2026-04-16 launch; Opus 4.7 native context window confirmed at 1M (v2.1.117 fixed/contextmiscounting it as 200K) - Default effort raised from
mediumtohighfor Pro/Max subscribers on Opus 4.6 / Sonnet 4.6 (v2.1.117) STYLE_GUIDE.mdSource URL updated from Claude Apps article tocode.claude.com/docs/en/changelog
Deprecated (tracked, not removed)
includeCoAuthoredBysetting β useattribution.commit/attribution.prvoiceEnabledsetting β usevoice.enabled
Notes for translation maintainers
The vi/, zh/, and uk/ localized trees are community-maintained and may lag the English source. Contributors syncing translations should diff against the English files updated in this release.
v2.1.112 β 2026-04-16
Highlights
- Sync all English tutorials with Claude Code v2.1.112 and the new Opus 4.7 model (
claude-opus-4-7), including the newxhigheffort level (default on Opus 4.7, betweenhighandmax), two new built-in slash commands (/ultrareview,/less-permission-prompts), auto-mode no longer requiring--enable-auto-modefor Max subscribers on Opus 4.7, the PowerShell tool on Windows, the "Auto (match terminal)" theme, and plan files named after prompts. All 18 EN doc footers bumped to Claude Code v2.1.112. @Luong NGUYEN
Features
- Add complete Ukrainian (uk) localization across all modules, root docs, examples, and references (039dde2) @Evgenij I
Bug Fixes
- Correct pre-tool-check.sh hook protocol bugs (bce7cf8) @yarlinghe
- Change bad mermaid example to text block to pass CI (b8a7b1f) @Evgenij I
- Fix CP1251 encoding in Ukrainian claude_concepts_guide.md ToC (d970cc6) @Evgenij I
- Replace stub Ukrainian README with full translation, fix broken anchors (f6d73e2) @Evgenij I
- Correct Claude Code version to 2.1.97 across all footers (63a1416) @Luong NGUYEN
- Apply 2026-04-09 documentation accuracy updates (e015f39) @Luong NGUYEN
Documentation
- Sync to Claude Code v2.1.112 (Opus 4.7,
xhigheffort,/ultrareview,/less-permission-prompts, PowerShell tool, Auto-match-terminal theme) @Luong NGUYEN - Sync to Claude Code v2.1.110 (TUI, push notifications, session recap) (15f0085) @Luong NGUYEN
- Sync to Claude Code v2.1.101 with
/team-onboarding,/ultraplan, Monitor tool (2deba3a) @Luong NGUYEN - Sync Vietnamese documentation with English source (561c6cb) @ThiΓͺn ToΓ‘n
- Update Last Updated date and Claude Code version across all files (7f2e773) @Luong NGUYEN
- Add Ukrainian language link to language switcher (9c224ff) @Luong NGUYEN
- Remove contributors section (f07313d) @Luong NGUYEN
- Update GitHub metrics to 21,800+ stars, 2,585+ forks (4f55374) @Luong NGUYEN
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.3.0...v2.1.112
v2.3.0 β 2026-04-07
Features
- build and publish EPUB artifacts per language (90e9c30) @ThiΓͺn ToΓ‘n
- add missing pre-tool-check.sh hook to 06-hooks (b511ed1) @JiayuWang
- add Chinese translations in zh/ directory (89e89d4) @Luong NGUYEN
- Add performance-optimizer subagent and dependency-check hook (f53d080) @qk
Bug Fixes
- Windows Git Bash compatibility + stdin JSON protocol (2cbb10c) @Luong NGUYEN
- correct autoCheckpoint config documentation in 08-checkpoints (749c79f) @JiayuWang
- embed SVG images instead of replacing with placeholders (1b16709) @ThiΓͺn ToΓ‘n
- nested code fence rendering in memory README (ce24423) @Zhaoshan Duan
- apply review fixes dropped by squash merge (34259ca) @Luong NGUYEN
- make hook scripts compatible with Windows Git Bash and use stdin JSON protocol (107153d) @binyu li
Documentation
- sync all tutorials with latest Claude Code docs (April 2026) (72d3b01) @Luong NGUYEN
- add Chinese language link to language switcher (6cbaa4d) @Luong NGUYEN
- add language switcher between English and Vietnamese (100c45e) @Luong NGUYEN
- add GitHub #1 Trending badge (0ca8c37) @Luong NGUYEN
- Introduce cc-context-stats for context zone monitoring (d41b335) @Luong NGUYEN
- Introduce luongnv89/skills collection and luongnv89/asm skill manager (7e3c0b6) @Luong NGUYEN
- Update README stats to reflect current GitHub metrics (5,900+ stars, 690+ forks) (5001525) @Luong NGUYEN
- Update README stats to reflect current GitHub metrics (3,900+ stars, 460+ forks) (9cb92d6) @Luong NGUYEN
Refactoring
- replace Kroki HTTP dependency with local mmdc rendering (e76bbe4) @Luong NGUYEN
- shift quality checks to pre-commit, CI as 2nd pass (6d1e0ae) @Luong NGUYEN
- narrow auto-mode permissions baseline (2790fb2) @Luong NGUYEN
- Replace auto-adapt hook with one-time permissions setup script (995a5d6) @Luong NGUYEN
Other
- shift-left quality gates β add mypy to pre-commit, fix CI failures (699fb39) @Luong NGUYEN
- Add Vietnamese (TiαΊΏng Viα»t) Localization (a70777e) @ThiΓͺn ToΓ‘n
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.2.0...v2.3.0
v2.2.0 β 2026-03-26
Documentation
- Sync all tutorials and references with Claude Code v2.1.84 (f78c094) @luongnv89
- Update slash commands to 55+ built-in + 5 bundled skills, mark 3 deprecated
- Expand hook events from 18 to 25, add
agenthook type (now 4 types) - Add Auto Mode, Channels, Voice Dictation to advanced features
- Add
effort,shellskill frontmatter fields;initialPrompt,disallowedToolsagent fields - Add WebSocket MCP transport, elicitation, 2KB tool cap
- Add plugin LSP support,
userConfig,${CLAUDE_PLUGIN_DATA} - Update all reference docs (CATALOG, QUICK_REFERENCE, LEARNING-ROADMAP, INDEX)
- Rewrite README as landing-page-structured guide (32a0776) @luongnv89
Bug Fixes
- Add missing cSpell words and README sections for CI compliance (93f9d51) @luongnv89
- Add
Sandboxingto cSpell dictionary (b80ce6f) @luongnv89
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.1...v2.2.0
v2.1.1 β 2026-03-13
Bug Fixes
- Remove dead marketplace link failing CI link checks (3fdf0d6) @luongnv89
- Add
sandboxedandpycacheto cSpell dictionary (dc64618) @luongnv89
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.0...v2.1.1
v2.1.0 β 2026-03-13
Features
- Add adaptive learning path with self-assessment and lesson quiz skills (1ef46cd) @luongnv89
/self-assessmentβ interactive proficiency quiz across 10 feature areas with personalized learning path/lesson-quiz [lesson]β per-lesson knowledge check with 8-10 targeted questions
Bug Fixes
- Update broken URLs, deprecations, and outdated references (8fe4520) @luongnv89
- Fix broken links in resources and self-assessment skill (7a05863) @luongnv89
- Use tilde fences for nested code blocks in concepts guide (5f82719) @VikalpP
- Add missing words to cSpell dictionary (8df7572) @luongnv89
Documentation
- Phase 5 QA β fix consistency, URLs, and terminology across docs (00bbe4c) @luongnv89
- Complete Phases 3-4 β new feature coverage and reference doc updates (132de29) @luongnv89
- Add MCPorter runtime to MCP context bloat section (ef52705) @luongnv89
- Add missing commands, features, and settings across 6 guides (4bc8f15) @luongnv89
- Add style guide based on existing repo conventions (84141d0) @luongnv89
- Add self-assessment row to guide comparison table (8fe0c96) @luongnv89
- Add VikalpP to contributors list for PR #7 (d5b4350) @luongnv89
- Add self-assessment and lesson-quiz skill references to README and roadmap (d5a6106) @luongnv89
New Contributors
- @VikalpP made their first contribution in #7
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.0.0...v2.1.0
v2.0.0 β 2026-02-01
Features
- Sync all documentation with Claude Code February 2026 features (487c96d)
- Update 26 files across all 10 tutorial directories and 7 reference documents
- Add documentation for Auto Memory β persistent learnings per project
- Add documentation for Remote Control, Web Sessions, and Desktop App
- Add documentation for Agent Teams (experimental multi-agent collaboration)
- Add documentation for MCP OAuth 2.0, Tool Search, and Claude.ai Connectors
- Add documentation for Persistent Memory and Worktree Isolation for subagents
- Add documentation for Background Subagents, Task List, Prompt Suggestions
- Add documentation for Sandboxing and Managed Settings (Enterprise)
- Add documentation for HTTP Hooks and 7 new hook events
- Add documentation for Plugin Settings, LSP Servers, and Marketplace updates
- Add documentation for Summarize from Checkpoint rewind option
- Document 17 new slash commands (
/fork,/desktop,/teleport,/tasks,/fast, etc.) - Document new CLI flags (
--worktree,--from-pr,--remote,--teleport,--teammate-mode, etc.) - Document new environment variables for auto memory, effort levels, agent teams, and more
Design
- Redesign logo to compass-bracket mark with minimal palette (20779db)
Bug Fixes / Corrections
- Update model names: Sonnet 4.5 β Sonnet 4.6, Opus 4.5 β Opus 4.6
- Fix permission mode names: replace fictional "Unrestricted/Confirm/Read-only" with actual
default/acceptEdits/plan/dontAsk/bypassPermissions - Fix hook events: remove fictional
PreCommit/PostCommit/PrePush, add real events (SubagentStart,WorktreeCreate,ConfigChange, etc.) - Fix CLI syntax: replace
claude-code --headlesswithclaude -p(print mode) - Fix checkpoint commands: replace fictional
/checkpoint save/list/rewind/diffwith actualEsc+Esc//rewindinterface - Fix session management: replace fictional
/session list/new/switch/savewith real/resume//rename//fork - Fix plugin manifest format: migrate
plugin.yamlβ.claude-plugin/plugin.json - Fix MCP config paths:
~/.claude/mcp.jsonβ.mcp.json(project) /~/.claude.json(user) - Fix documentation URLs:
docs.claude.comβdocs.anthropic.com; remove fictionalplugins.claude.com - Remove fictional configuration fields across multiple files
- Update all "Last Updated" dates to February 2026
Full Changelog: https://github.com/luongnv89/claude-howto/compare/20779db...v2.0.0