文档知识库【免费下载链接】claude-code-docs项目地址https://gitcode.com/gh_mirrors/cl/claude-code-docs点击查看免费下载如果你在用 Claude Code一定遇到过这样的尴尬本地文档已经过时却不知道新版本改了什么。claude-code-docs是 Claude Code 官方文档的本地镜像工具每 3 小时自动抓取最新内容而它最实用的功能之一就是用-t标志秒级检查本地文档与远端的同步状态——一条/docs -t命令即可确认你的文档是最新的、落后了几个提交还是网络不通只能离线使用。本文将带你快速安装并完全掌握这个同步检查功能。claude-code-docs 是什么claude-code-docs 把 Claude Code 官方文档 完整镜像到本地~/.claude-code-docs目录并注入一个/docs斜杠命令到 Claude Code 中。它的核心价值能力说明⚡ 秒开文档直接读本地 Markdown无需联网翻网页 自动更新GitHub Actions 定期抓取本地 hook 自动git pull 同步检查-t标志对比本地与远端提交一眼看出是否过时 变更追踪/docs whats new查看最近文档改动 官方更新日志/docs changelog读取 Claude Code 版本历史镜像目录中的 docs/ 包含 200 余篇主题文档hooks、MCP、permissions 等并由 docs/docs_manifest.json 记录每篇文档的来源与最后更新时间。为什么要检查文档同步状态本地镜像不是装完就永远新的。它可能出现三种状态✅最新——与远端一致放心使用⚠️落后——远端已有新提交本地还是旧版⚠️领先——本地有未推送的改动通常是手动修改过⚠️离线——网络异常无法同步只能依赖本地缓存。-t标志就是为这个场景设计的体检命令底层逻辑在 scripts/claude-docs-helper.sh.template 的show_freshness函数中它先做一次快速的git fetch约 0.4 秒再用git rev-list对比本地与远端的提交数输出对应状态。一键安装 claude-code-docs支持macOS 12 和 LinuxUbuntu、Debian、Fedora 等需要预装git、jq、curl三个依赖。git clone https://gitcode.com/gh_mirrors/cl/claude-code-docs cd claude-code-docs bash install.sh安装脚本 install.sh 会自动完成三件事将文档仓库克隆到~/.claude-code-docs创建/docs斜杠命令文件~/.claude/commands/docs.md在~/.claude/settings.json中注册一个PreToolUse的Readhook实现读取文档时自动同步。安装完成后重启 Claude Code输入/docs (user)即可看到新命令。-t标志的三种用法用法一单独检查同步状态/docs -t这是最纯粹的用法只体检、不读文档。典型输出长这样 Branch: main Version: 0.3.3 ✅ You have the latest documentation用法二先检查、再读指定主题/docs -t hooks # 先检查同步状态再读取 hooks 文档 /docs -t mcp # 检查后读取 MCP 文档适合我要查某个主题但顺便确认一下版本的日常场景。用法三长标志 --check-t有一个等价的长形式--check输入习惯不同的同学可以任选/docs --check /docs --check permissions两种写法在脚本中完全等价见 scripts/claude-docs-helper.sh.template 的参数解析部分。如何看懂同步状态输出-t的输出只可能出现四种结论对照下表即可秒懂输出文案含义建议操作✅ You have the latest documentation本地与远端完全一致无需操作⚠️ Local version is behind GitHub by N commit(s)本地落后 N 个提交脚本通常已自动git pull若仍提示落后手动更新⚠️ Local version is ahead of GitHub by N commit(s)本地有 N 个未推送的本地改动检查是否误改了文档文件⚠️ Could not sync with GitHub (using local cache)网络异常无法同步检查网络后重试当前结果基于本地缓存小贴士输出末尾的 Branch和 Version还能帮你确认当前分支和工具版本当前为 0.3.3排查问题时非常有用。自动同步是怎么工作的理解了-t背后的机制你就不会再担心文档过时远端定时抓取——官方仓库通过 GitHub Actions 定期把最新文档提交到docs/目录镜像每 3 小时刷新一次本地快速比对——每次使用/docs时脚本执行一次静默git fetch耗时仅约0.4 秒几乎无感落后才拉取——只有当本地BEHIND远端提交数大于 0 时才执行git pull并提示 Updating documentation...本地领先时绝不会误删你的改动读取文档前兜底——即使不走-t读取任意主题文档时脚本也会先做一次状态检查见 scripts/claude-docs-helper.sh.template 的read_doc函数确保你读到的永远是最新版。也就是说日常直接/docs hooks就是闪电模式想确认真伪时加上-t即可。同步异常排查清单文档一直显示落后按 README.md 的 Troubleshooting 章节三步走运行/docs -t强制检查并触发更新手动更新cd ~/.claude-code-docs git pull确认远端定时任务是否正常——若长期无新提交可重新运行bash install.sh完成迁移升级。其他常见安装问题git/jq/curl not found→ 先安装缺失工具Linux 可用apt install jq/docs命令不出现 → 检查~/.claude/commands/docs.md是否存在并重启 Claude Code。不需要用时/docs uninstall会给出完整卸载命令详细说明见 UNINSTALL.md。顺手掌握的相邻命令学会了-t这两个查新命令也值得一试/docs whats new # 查看最近 5 次文档更新及改动文件列表 /docs changelog # 读取 Claude Code 官方版本更新日志总结场景命令只想知道文档是否最新/docs -t检查后立刻读某个主题/docs -t 主题输入长标志偏好/docs --check看最近改了什么/docs whats new看 Claude Code 版本更新/docs changelog一句话记忆/docs -t 文档体检0.4 秒出结果。配合每 3 小时一次的自动抓取你的 Claude Code 文档将永远不会悄悄过时。更多文档主题一览可直接浏览 docs/ 目录安装与原理详见 README.md。赞分享文档知识库【免费下载链接】claude-code-docs项目地址https://gitcode.com/gh_mirrors/cl/claude-code-docs点击查看免费下载相关推荐claude-howto 文档同步实战用 Claude Code /sync-docs 命令让文档始终与代码一致claude howto 文档同步实战用 Claude Code /sync docs 命令让文档始终与代码一致 本篇指南基于 claude howto 仓库文档教程知识库Context7 Claude Code 插件中的 /context7:docs 命令实时获取库文档的完整实战指南Context7 Claude Code 插件中的 /context7:docs 命令实时获取库文档的完整实战指南 /context7:docs 是 Cont人工智能MCP 服务AI 技能开发者工具文档JetBrains Claude Code 与 Codex GUI 插件中的「先检查廉价同步条件再 await 异步标志」优化实践JetBrains Claude Code 与 Codex GUI 插件中的「先检查廉价同步条件再 await 异步标志」优化实践 导读 本文围绕 Verce上一篇LAV FiltersWindows媒体播放的终极解码解决方案告别格式不兼容烦恼下一篇如何在Blender中使用MMD Tools插件从零开始的完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考