v2.1.3222026-11-12
本次更新主要围绕 Claude Code 文档同步:一路跟进至 v2.1.310,其中针对 v2.1.220 和 v2.1.302 做了专门的准确性复查与跨页面矛盾清理。修复方面,纠正了 hooks 中文指南的配置错误、记忆与检查点课程测验的答案偏差、标题锚点中零宽字符丢失等问题;数据库 MCP 示例改为默认只读,CLAUDE.md 只指向已提交文件,.gitissue.yml 迁移为 .idd.yml。功能上,官网新增了带交互式学习路线图的落地页,构建脚本改为单次解析并加入 CI 缓存,图表生成从 Mermaid.js 换成 Pele。附加资源新增 Vexilo 字段指南,CLAUDE 指引也补充了「读者可能是学习者而非贡献者」的提示。
v2.1.1602026-06-02
[v2.1.160] — 2026-06-02
Synced to Claude Code v2.1.160
Bumps tutorial coverage to the Claude Code v2.1.160 release. The intervening
v2.1.156 sync (Claude Opus 4.8, #129) was applied to the docs but not separately
changelogged; this entry continues from there and covers the v2.1.157–v2.1.160
delta. No breaking changes shipped in this range — the additions are a handful
of new CLI/feature surfaces plus the routine footer bump. Auto mode on
third-party providers is opt-in, not a new default.
Added
- claude plugin init <name> (v2.1.157) — scaffolds a new plugin directly
in .claude/skills; plugins placed there now auto-load with no marketplace
required. Documented in 10-cli/README.md, 07-plugins/README.md, and
CATALOG.md.
- Auto mode on Bedrock / Vertex / Foundry (v2.1.158) — auto mode is now
available on the three third-party providers for Opus 4.7/4.8, opt-in via
the CLAUDECODEENABLEAUTOMODE=1 environment variable. Documented in
09-advanced-features/README.md, 10-cli/README.md, and CATALOG.md.
- EnterWorktree mid-session switching (v2.1.157) — the EnterWorktree
tool can now switch between Claude-managed worktrees within a session, and
finished worktrees are left unlocked so git worktree remove/prune can
clean them up. Documented in 09-advanced-features/README.md.
Behavior changes
- acceptEdits write-safety prompts (v2.1.160) — even in acceptEdits
mode, Claude Code now prompts before writing shell-startup files (.zshenv,
.zlogin, .bash_login, ~/.config/git/) and code-executing build configs
(.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml,
.devcontainer/), which could otherwise lead to unintended command
execution. Documented in 09-advanced-features/README.md.
- Dynamic-workflow trigger keyword workflow → ultracode (v2.1.160) — the
bare word "workflow" no longer triggers a dynamic-workflow run; the trigger
keyword is now ultracode. Noted in 09-advanced-features/README.md.
Removed
- CLAUDECODEOPUS46FASTMODEOVERRIDE is now a no-op (v2.1.160)** — the
environment variable was removed and now has no effect. The env-var table
wording in 10-cli/README.md was updated from "removed 2026-06-01" to
"Removed (no-op as of v2.1.160)".
Documentation
- Fixed three internally-inconsistent version strings in README.md (badge and
FAQ prose were stuck at 2.1.145 / v2.1.150) and normalized a stale Sources
link.
- Bumped every English doc's metadata footer to v2.1.160 / June 2, 2026 for
a consistent sync.
What's Changed
* fixing errors where the backtick (`) was not escaped correctly by @stephenfire in https://github.com/luongnv89/claude-howto/pull/114
* feat(scripts): add markdown rendering validator (#119) by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/120
* feat(scripts): add static website generator from markdown sources (#85) by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/121
* fix(i18n): correct logo image paths in translated module READMEs by @iiitutu in https://github.com/luongnv89/claude-howto/pull/123
* fix(i18n): correct logo paths in translated root-level files by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/124
* docs: sync to Claude Code v2.1.145 (2 patches since v2.1.143) by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/125
* docs: sync to Claude Code v2.1.150 by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/127
* fix(i18n): re-point translations to code-review-specialist rename by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/128
* docs: sync to Claude Code v2.1.156 and Claude Opus 4.8 by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/129
* fix(memory): correct settings.json precedence chain order by @Sanford284 in https://github.com/luongnv89/claude-howto/pull/131
* fix(memory): correct settings.json precedence order in vi/ja/uk translations by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/133
New Contributors
* @stephenfire made their first contribution in https://github.com/luongnv89/claude-howto/pull/114
* @Sanford284 made their first contribution in https://github.com/luongnv89/claude-howto/pull/131
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.138...v2.1.160
v2.1.1382026-05-09
教程同步至 Claude Code v2.1.138(2026 年 5 月 9 日发布),覆盖其间七个补丁。
新增 worktree.baseRef
v2.1.1312026-05-09
教程内容同步至 Claude Code v2.1.131(2026 年 5 月 6 日发布),较上一版新增 --plugin-url(从 URL 拉取插件压缩包)、CLAUDECODEFORCESYNCOUTPUT(强制同步输出,解决 Emacs eat 等终端自动检测失效的问题)、CLAUDECODEPACKAGEMANAGERAUTO_UPDATE(让 Homebrew/WinGet 安装也能后台升级)等参数,并补充 disableRemoteControl、skillOverrides 新取值等设置说明。
一处行为变化需要留意:网关 /v1/models 现为可选开启,需额外设置 CLAUDECODEENABLEGATEWAYMODEL_DISCOVERY=1,否则 /model 只显示内置列表。其余改进包括 /context 不再把 ASCII 图写进对话(每次省约 1.6k token)、Ctrl+R 历史默认跨项目检索、超大图片自动缩放等。修复了 Windows 下 VS Code 扩展激活、提示词缓存 TTL 被误截断等问题。
v2.1.1262026-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.json entry). Supports --dry-run, -y/--yes, -i/--interactive, --all. Documented in 10-cli/README.md.
- claude plugin prune subcommand (v2.1.121) — removes orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades. Documented in 07-plugins/README.md.
- claude ultrareview [target] subcommand (v2.1.120) — runs /ultrareview non-interactively from CI/scripts, prints findings to stdout, exits 0/1 on success/failure; supports --json and --timeout <minutes>. Documented in 10-cli/README.md.
- ${CLAUDE_EFFORT} placeholder available inside skill content (v2.1.120) — resolves to the current effort level. Documented in 03-skills/README.md.
- alwaysLoad MCP server config option (v2.1.121) — when true, all tools from that server skip tool-search deferral. Documented in 05-mcp/README.md.
- PostToolUse.hookSpecificOutput.updatedToolOutput now works for all tools (v2.1.121), previously MCP-only. Documented in 06-hooks/README.md.
- ANTHROPICBEDROCKSERVICE_TIER environment variable (v2.1.122) — selects Bedrock service tier (default, flex, priority).
- --dangerously-skip-permissions extended-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.
- OAuth code paste fallback (v2.1.126) — claude auth login accepts the OAuth code pasted into the terminal when the browser callback can't reach localhost (WSL2, SSH, containers).
- Type-to-filter /skills menu (v2.1.121).
- AI_AGENT environment variable (v2.1.120) — set on subprocesses so gh can attribute traffic to Claude Code.
Changed
- --from-pr (v2.1.119) and /resume PR-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). 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.
- /model picker now lists models from your gateway's /v1/models endpoint when ANTHROPICBASEURL points at an Anthropic-compatible gateway (v2.1.126).
- 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.
Security
- Fixed allowManagedDomainsOnly / allowManagedReadPathsOnly being ignored when a higher-priority managed-settings source lacked a sandbox block (v2.1.126).
See CHANGELOG.md for full details.
What's Changed
* docs: sync to Claude Code v2.1.119 by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/94
* fix: replace invalid diff tool with bash in security-reviewer agents by @xiaolai in https://github.com/luongnv89/claude-howto/pull/89
* fix: pin requirements.txt to known-good versions by @xiaolai in https://github.com/luongnv89/claude-howto/pull/90
* fix: constrain cross-reference resolution to repo root by @xiaolai in https://github.com/luongnv89/claude-howto/pull/91
test(scripts): cover repo-root boundary in checkcross_references by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/95
* docs(plugins): clarify marketplace update vs plugin update and add auto-update documentation by @lzw-git-all in https://github.com/luongnv89/claude-howto/pull/84
* docs(skills): improve skill loading process diagram clarity by @lzw-git-all in https://github.com/luongnv89/claude-howto/pull/81
* fix(advanced-features): correct effort level model support by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/96
* docs(skills): question-bank fixes by @OleksandrDemidov in https://github.com/luongnv89/claude-howto/pull/97
* feat(hooks): add SessionEnd progress logger and local progress tracker by @DhanyaJose in https://github.com/luongnv89/claude-howto/pull/87
* fix(cli): correct agent priority order to match official docs by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/100
* docs(hooks): fix README divergence in Example 8 SessionEnd hook by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/101
* docs: sync to Claude Code v2.1.119 (delta from 2026-04-24 plan) by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/102
* feat(i18n): Add Japanese (ja/) translation by @Foxsunshine in https://github.com/luongnv89/claude-howto/pull/105
* fix(memory): correct quiz Q2 answer from discontinued # prefix to /memory by @jeffreyyjp in https://github.com/luongnv89/claude-howto/pull/107
* fix(extended-thinking): correct fictional /think command to valid ultrathink keyword by @lzw-git-all in https://github.com/luongnv89/claude-howto/pull/83
* fix(quiz): correct Q4 extended thinking toggle wording by @lzw-git-all in https://github.com/luongnv89/claude-howto/pull/109
* fix(skills): reference templates and scripts from code-review SKILL.md by @muratclk in https://github.com/luongnv89/claude-howto/pull/62
* fix(lesson-quiz): shuffle answer options and add per-round feedback by @seanxue in https://github.com/luongnv89/claude-howto/pull/76
* docs: sync to Claude Code v2.1.126 by @luongnv89 in https://github.com/luongnv89/claude-howto/pull/111
New Contributors
* @xiaolai made their first contribution in https://github.com/luongnv89/claude-howto/pull/89
* @lzw-git-all made their first contribution in https://github.com/luongnv89/claude-howto/pull/84
* @OleksandrDemidov made their first contribution in https://github.com/luongnv89/claude-howto/pull/97
* @DhanyaJose made their first contribution in https://github.com/luongnv89/claude-howto/pull/87
* @Foxsunshine made their first contribution in https://github.com/luongnv89/claude-howto/pull/105
* @jeffreyyjp made their first contribution in https://github.com/luongnv89/claude-howto/pull/107
* @muratclk made their first contribution in https://github.com/luongnv89/claude-howto/pull/62
* @seanxue made their first contribution in https://github.com/luongnv89/claude-howto/pull/76
Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.112...v2.1.126
v2.1.112 — Claude Code v2.1.112 / Opus 4.7 sync2026-04-16
v2.1.112 教程全面同步至 Claude Code v2.1.112 与新模型 Opus 4.7(claude-opus-4-7):新增 xhigh 力度档位(Opus 4.7 默认,介于 high 与 max 之间)、/ultrareview 与 /less-permission-prompts 两个内置斜杠命令,Windows 下的 PowerShell 工具、「Auto (match terminal)」主题,以及按提示词命名的计划文件;Opus 4.7 订阅 Max 的用户开自动模式不再需要 --enable-auto-mode 参数,18 篇英文文档页脚版本号一并更新。同时补齐乌克兰语(uk)本地化,覆盖全部模块、根文档、示例与参考;修复 pre-tool-check.sh 钩子协议缺陷、乌克兰语 README 的占位内容与失效锚点、目录页 CP1251 编码问题,并统一各处版本号标注。越南语文档也与英文源同步。
v2.3.02026-04-07
v2.3.0(2026-04-07)新增按语言生成并发布 EPUB 产物、performance-optimizer 子代理与 dependency-check 钩子,补齐 zh/ 中文翻译和 pre-tool-check.sh。修复重点在 Windows Git Bash 兼容与 stdin JSON 协议,SVG 图片改为内嵌而非占位符,嵌套代码围栏渲染也一并纠正。重构部分把 Kroki 远程依赖换成本地 mmdc 渲染,质量检查左移到 pre-commit、CI 降为第二道关卡,auto-adapt 钩子由一次性权限配置脚本取代。
v2.2.0 教程全面同步 Claude Code v2.1.84:斜杠命令增至 55+ 内置,钩子事件扩到 25 种并新增 agent 类型,收录 Auto Mode、语音输入、WebSocket MCP 等条目,README 重写为落地页式导航。
v2.1.1 仅修复失效链接与词典补词。v2.1.0 则上线 /self-assessment 和 /lesson-quiz 两个技能,组成带自测与个性化路径的自适应学习流程。
v2.2.02026-03-26
v2.2.0(2026-03-26):全站教程与参考文档同步到 Claude Code v2.1.84。斜杠命令更新为 55 个以上内置命令加 5 个捆绑技能,3 个已废弃项做了标注;Hook 事件从 18 个扩展到 25 个,并新增 agent 类型(现共 4 类);高级功能补上 Auto Mode、Channels、语音输入。技能 frontmatter 新增 effort、shell 字段,Agent 配置补入 initialPrompt、disallowedTools;MCP 方面加入 WebSocket 传输、elicitation 与 2KB 工具上限;插件侧支持 LSP、userConfig 和 ${CLAUDEPLUGINDATA}。CATALOG、QUICK_REFERENCE、LEARNING-ROADMAP、INDEX 等参考文档一并更新,README 也重写成落地页式导览。另修复了 cSpell 词典缺词导致的 CI 报错。
v2.1.12026-03-13
v2.1.1 是一个纯维护版本:删掉了已失效的 marketplace 链接,修复 CI 链接检查报错;同时把 sandboxed、pycache 加入 cSpell 词典,避免拼写检查误报。功能上没有任何变化,升级与否都不影响使用。
v2.1.02026-03-13
v2.1.0 主要带来一套自适应学习路径:新增 /self-assessment 交互式能力测评,覆盖 10 个功能领域并生成个性化学习计划;/lesson-quiz [lesson] 则针对单节课出 8-10 道题检验掌握情况。修复方面,清理了一批失效链接、过时引用与弃用说明,概念指南中嵌套代码块改用波浪线围栏,拼写检查词典也补齐了缺失词条。文档更新量较大:第三至五阶段的 QA 落地,统一了术语与链接,6 份指南补上了此前遗漏的命令、功能与设置,并新增一份基于仓库既有惯例的写作规范。README 和路线图同步收录了两个新技能的入口。