claude-howto 项目 v2.0.0 → v2.3.0 演进全记录文档同步、国际化、Hook 与质量工程实战【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本篇技术指南以 vi/CHANGELOG.md 为主体梳理 claude-howto 这一面向 Claude Code 的可视化、示例驱动指南仓库在 v2.0.02026-02-01至 v2.3.02026-04-07期间的关键版本演进。读者将从中掌握如何围绕上游 Claude Code 版本做大规模文档同步与纠错、如何组织多语言国际化与质量门禁CI pre-commit Hook以及如何把文档仓库升级为可构建 EPUB、可自动审计依赖与权限的可交付工程。版本演进总览从单一英文文档到多语言可交付工程对照 vi/CHANGELOG.md 的版本时间线claude-howto 在三个月内完成了三条主线的升级版本日期核心主题v2.0.02026-02-01同步 Claude Code 2026 年 2 月特性全面纠错虚构内容v2.1.02026-03-13新增自适应学习路径self-assessment / lesson-quizv2.1.12026-03-13修复死链、扩充 cSpell 词典v2.2.02026-03-26同步 Claude Code v2.1.84README 重构为落地页v2.3.02026-04-07Hook 补全、中文/越南语本地化、EPUB 构建、质量左移这一演进路线说明该仓库不仅是翻译文档而是把教程内容当作软件工程制品来维护——每次上游 Claude Code 发版都会触发一次全量同步与审计版本号与上游同步v2.1.84、v2.1.112 等即上游 Claude Code 版本号。v2.0.0与上游特性全面同步 虚构内容大扫除v2.0.0 是一次里程碑式发布更新了全部 10 个教程目录下的 26 个文件和 7 份参考文档新增了对以下 Claude Code 特性的文档覆盖Auto Memory——按项目持久化学习记录对应 02-memory/README.mdRemote Control、Web Sessions、Desktop AppAgent Teams实验性多 Agent 协作MCP OAuth 2.0、Tool Search、Claude.ai ConnectorsPersistent Memory 与 Worktree Isolation针对 subagentBackground Subagents、Task List、Prompt SuggestionsSandboxing 与 Managed Settings企业级HTTP Hooks 及 7 个新 hook 事件Plugin Settings、LSP Servers、Marketplace 更新Summarize from Checkpoint回退选项17 个新 slash 命令/fork、/desktop、/teleport、/tasks、/fast等新 CLI 参数--worktree、--from-pr、--remote、--teleport、--teammate-mode等。纠错清单删除虚构 API对齐真实配置v2.0.0 的另一半价值在于纠正文档中不符合真实 Claude Code 行为的虚构内容这正是技术文档仓库最该警惕的幻觉问题。对照 changelog 的 Bug Fixes 段落可总结为以下七类模型名更新Sonnet 4.5 → Sonnet 4.6、Opus 4.5 → Opus 4.6权限模式名删除虚构的 Unrestricted/Confirm/Read-only改为真实的default/acceptEdits/plan/dontAsk/bypassPermissionsHook 事件删除虚构的PreCommit/PostCommit/PrePush替换为真实事件SubagentStart、WorktreeCreate、ConfigChange等CLI 语法claude-code --headless→claude -pprint 模式Checkpoint 命令虚构的/checkpoint save/list/rewind/diff→ 真实的EscEsc//rewind交互界面会话管理虚构的/session list/new/switch/save→ 真实的/resume//rename//fork插件清单格式plugin.yaml→.claude-plugin/plugin.jsonMCP 配置路径统一为项目级.mcp.json与用户级~/.claude.json。这一轮纠错体现的原则是文档必须可复制、可运行任何虚构命令或配置都会直接误导使用者。v2.1.0自适应学习路径与测验型 Skillv2.1.0 从参考文档转向教学系统新增两个核心 Skill/self-assessment——覆盖 10 个功能领域的交互式熟练度测验输出个性化学习路径/lesson-quiz [lesson]——针对每个课程的 8–10 道定向知识检测。同期完成的还有Giai đoạn 3–5阶段 3–5QA 流程修复跨文档的一致性、URL 与术语问题在 STYLE_GUIDE.md 中新增基于仓库现有约定的样式规范为 MCP 上下文膨胀章节补充 MCPorter 运行时。这些工作表明该仓库用**分阶段 QAPhase 3–5**的方式管理文档质量而非一次性写完。v2.2.0同步 Claude Code v2.1.84 与落地页式 READMEv2.2.0 将全部教程与参考文档同步到 Claude Code v2.1.84关键增量包括slash 命令更新为55 内置 5 个捆绑 skill标记 3 个已废弃hook 事件从 18 个扩展到25 个新增agenthook 类型合计 4 种类型高级特性新增 Auto Mode、Channels、Voice DictationSkill frontmatter 新增effort、shell字段Agent 新增initialPrompt、disallowedTools字段MCP 新增 WebSocket transport、elicitation、2KB 工具大小上限插件新增 LSP 支持、userConfig与${CLAUDE_PLUGIN_DATA}占位符同步更新 CATALOG、QUICK_REFERENCE、LEARNING-ROADMAP、INDEX 全部参考文档。此外README 被重写为落地页结构landing-page-structured guide让新读者能按导航快速定位到 01-slash-commands 至 10-cli 的十个模块。v2.3.0Hook 补全、多语言本地化与可构建 EPUBv2.3.0 是变化最丰富的一个版本直接推动了仓库工程化程度的大幅提升。新增功能构建并发布各语言的 EPUB 制品——对应 scripts/build_epub.py。该脚本按目录结构01-slash-commands、02-memory 等组织章节通过本地mmdcCLI 将 Mermaid 图渲染为 PNG无需网络生成封面、转换内部链接为 EPUB 章节引用并采用严格错误模式任一图渲染失败即构建失败。运行方式uv run scripts/build_epub.py或python scripts/build_epub.py补全缺失的 pre-tool-check.sh 到 06-hooks新增中文翻译目录zh/新增 performance-optimizer subagent 与 dependency-check hook。关键 Bug 修复Windows Git Bash 兼容 stdin JSON 协议Hook 脚本在 Windows Git Bash 下的可移植性修复。以 06-hooks/dependency-check.sh 为例它通过INPUT$(cat)读取 stdin JSON再用可移植sed提取file_path对package.json、requirements.txt、go.mod等各类依赖清单分别触发npm audit、pip-audit/safety、govulncheck、cargo audit、bundler-audit与 trivy 扫描最后始终exit 0警告但不阻塞提交修正 08-checkpoints 中 autoCheckpoint 配置文档——与 08-checkpoints/README.md 中的自动 checkpoint 行为每次用户输入创建、30 天自动清理等保持一致嵌入 SVG 图片而非用占位符替换修复 memory README 中嵌套代码围栏渲染问题。重构质量左移与权限基线收窄v2.3.0 的三项重构最能体现工程思维用本地 mmdc 渲染替换 Kroki HTTP 依赖——消除对外部渲染服务的网络依赖保证构建的确定性质量检查左移到 pre-commitCI 作为第二道防线——并新增 mypy 到 pre-commit修复 CI 失败实现提交前发现问题收窄 auto-mode 权限基线用一次性权限设置脚本替换自动适配 Hook——即 09-advanced-features/setup-auto-mode-permissions.py。该脚本为~/.claude/settings.json播种一套保守的权限基线核心集只含只读检查类命令Read(*)、Glob(*)、Grep(*)、Bash(ls:*)、Bash(git status:*)等编辑、测试、git 写操作、包安装、GitHub CLI 均需通过--include-edits、--include-tests、--include-git-write、--include-packages、--include-gh-write等可选参数显式开启并提供--dry-run预览。越南语本地化v2.3.0 的 Other 类别记录了越南语Tiếng Việt本地化的落地并在语言切换器中加入中英文互切与中文链接。这正是 vi/CHANGELOG.md 自身诞生的背景——它本身就是越南语本地化维护过程的产物。仓库源码佐证Hook 与权限脚本的真实实现为印证 changelog 中 v2.3.0 的修复条目可直接阅读仓库内的实际实现06-hooks/pre-tool-check.sh注册为PreToolUsematcher: Bash的钩子通过 stdin JSON 读取待执行命令。它对rm -rf /锚定后需跟空白或行尾避免误伤rm -rf /tmp/foo、dd if/dev/zero、fork 炸弹、mkfs.等模式执行exit 2硬性阻塞阻塞原因写入 stderrClaude Code 将 stderr 作为阻塞原因回显对rm -rf、git push --force、DROP TABLE等高风险模式仅记入审计日志$CLAUDE_PROJECT_DIR/.claude/hooks/audit.log后放行06-hooks/context-tracker.py把UserPromptSubmit与Stop配对使用基于 transcript 估算每次请求的 token 增量其上下文上限默认 1MOpus 5、Sonnet 5、Opus 4.8、Sonnet 4.6并注明 Haiku 4.5 为 200K——与收窄权限、控制上下文的方向一致04-subagents/performance-optimizer.mdv2.3.0 新增的性能优化 subagent提供从界定范围→剖析测量→分析瓶颈→实施优化→记录结果的完整流程并内置 Big O、N1 查询、内存分配等检查清单与各语言 profiling 命令。质量门禁方法论CHANGELOG 之外的配套工具changelog 中反复出现的 CI 合规、cSpell 词典、链接检查并非空话仓库为此提供了完整工具链scripts/check_links.py链接检查、scripts/check_cross_references.py交叉引用一致性、scripts/check_markdown_rendering.pyMarkdown 渲染与 scripts/check_mermaid.pyMermaid 图检查共同构成质量检查层scripts/sync_translations.py 用于维护vi/、zh/、ja/、uk/四个本地化目录与英文源的一致性v2.1.1 中删除导致 CI 链接检查失败的死 marketplace 链接、向 cSpell 词典补充sandboxed、pycache等词正是这套门禁在真实迭代中拦截问题的记录。总结与可借鉴实践从 vi/CHANGELOG.md 这份发布记录中可以提炼出四条可直接复用的工程实践版本号与上游同步教程文档的版本紧跟上游 Claude Code 版本v2.1.84、v2.1.112…每次上游发版即触发全量审计避免文档滞后纠错即迭代每个版本都包含大量删除虚构命令/字段、对齐真实配置的修复这是技术文档仓库保持可信度的核心动作质量左移pre-commit含 mypy承担第一道质量关卡CI 作为第二道配合 cSpell、链接与 Mermaid 检查脚本形成闭环多语言与可交付物并重越南语、中文、日语、乌克兰语本地化与按语言构建 EPUB 并行推进使教程既能在线阅读也能离线分发。如果你正在维护面向 CLI/Agent 工具的教程仓库这份 changelog 展示的同步—纠错—QA—发布节奏是一份高价值的过程模板。【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考