企业官网建设流程全解析

• 文档
• 知识库

claude-code-docs 是一个 Claude Code 官方文档的本地镜像工具，它的 What's New 功能可以帮你一眼看清 Claude Code 文档的每次改动：最近哪些文档被更新、更新了什么内容，一条命令全部搞定。对于依赖 Claude Code 开发的朋友来说，文档更新往往意味着新特性、新命令和新参数，而这个功能让"追文档"这件事变得轻松又高效。

为什么你需要跟踪 Claude Code 文档变化？

Claude Code 迭代速度很快，文档内容会频繁更新。手动去官网逐页对比显然不现实，而 claude-code-docs 的思路是：

• 本地镜像：把官方文档同步到~/.claude-code-docs目录，读取零延迟
• 自动更新：每次使用前自动git pull，保持文档新鲜
• 改动追踪：借助 Git 提交历史，直接列出"最近哪些文档变了"

最后一点，就是本文的主角——What's New 功能。

快速安装：3 步跑起 claude-code-docs

先确认系统已安装git、jq、curl（macOS 一般自带，Linux 可用apt install jq）。

git clone https://gitcode.com/gh_mirrors/cl/claude-code-docs cd claude-code-docs bash install.sh

安装脚本会做三件事（详见 install.sh）：

1. 把文档仓库安装到~/.claude-code-docs
2. 创建/docs斜杠命令，供 Claude Code 中直接调用
3. 注册一个PreToolUse钩子，在读取文档前自动同步更新

安装完成后，在 Claude Code 中输入/docs看到可用主题列表，就说明一切就绪了。

What's New 功能实战：一条命令看改动

在 Claude Code 中直接输入：

/docs what's new

工具会先确保文档库是最新的（必要时显示 "🔄 Updating documentation..."），然后基于 Git 提交历史，列出最近 5 次文档更新，每次更新包含：

• 提交时间（相对时间，如 "2 days ago"）
• 本次更新涉及的具体文档文件（如hooks、mcp、permissions）
• 每个文档对应的官方页面地址，方便点击回看

这个逻辑实现在 scripts/claude-docs-helper.sh.template 的whats_new()函数中：它先执行auto_update拉取最新提交，再扫描git log中涉及docs/*.md的提交，用git diff-tree提取每次改动碰过的文档文件名。

💡小提示：想先确认同步状态再查看更新，可以用：

/docs -t what's new

-t会先展示本地库与远端的同步状态（领先/落后几个提交），适合网络不稳定时排查问题。

配套阅读：每周 What's New 摘要

除了"文档哪里变了"，仓库里还内置了 Claude Code 官方的每周特性摘要，位于 docs/whats-new.md。

每周一期，格式固定：当期最重要的 1 个大特性 + 若干"Also this week"次要更新，并标注了对应的版本号区间。例如最近几期：

每期摘要都有独立详情页，如 docs/whats-new__2026-w37.md、docs/whats-new__2026-w32.md，里面附可运行的示例代码和官方文档链接。

阅读建议：

• 赶时间：只看 docs/whats-new.md 的总览页，扫每期第一段即可
• 深入某个特性：再打开对应的whats-new__2026-wXX.md详情页
• 查每个小修复：配合/docs changelog阅读官方发布说明

它是怎么保持文档"新鲜"的？

理解这套机制，能帮你更好地区分两类"新"：

1. 文档库本身的更新→ 用/docs what's new（基于 Git 提交历史）
2. Claude Code 官方新特性→ 读docs/whats-new.md（官方周度摘要）

后台同步由两部分协作完成：

• scripts/fetch_claude_docs.py：定时任务脚本，解析官方 sitemap，抓取并校验文档内容哈希，有变化就提交新 commit
• docs/docs_manifest.json：文档清单，记录每个文件的来源 URL、内容 hash 和最后更新时间，是增量同步的"账本"

也就是说，每次/docs what's new展示的改动，都对应上游官方文档的一次真实变更，而不是噪音。

常见问题速查

Q：提示 "No recent documentation updates found"？说明最近 10 次提交里没有涉及文档的更新（或全是合并提交），过几天再看即可。

Q：网络不好时 What's New 还能用吗？可以。自动更新失败时会自动回退到本地缓存，不影响查看历史改动；用/docs -t可确认当前落后几个提交。

Q：命令找不到了怎么办？检查~/.claude/commands/docs.md是否存在，重启 Claude Code 重新加载命令，仍不行就重新运行安装脚本。

Q：不想要了怎么卸载？执行/docs uninstall获取卸载命令，或手动运行~/.claude-code-docs/uninstall.sh，详细说明见 UNINSTALL.md。

写在最后

claude-code-docs 的 What's New 功能把"文档变化追踪"这件繁琐的事压缩成了一条/docs what's new：本地镜像保证秒开，Git 历史保证改动可查，周度摘要保证重点不漏。如果你每天都在和 Claude Code 打交道，花三分钟装上它，之后每周一杯咖啡的时间就能把文档动态看个通透。

• 文档
• 知识库