企业官网建设流程全解析

• 文档
• 知识库

claude-code-docs 是 Claude Code 官方文档的本地镜像工具，通过/docs斜杠命令让你离线快速查阅文档。本文带你 3 步彻底卸载 claude-code-docs，备份配置、清理残留、需要时还能一键重装，全程不伤其他 Claude Code 设置。

一、卸载前：它会在系统里留下什么？🔍

了解残留位置，才能做到"干净卸载"。claude-code-docs 安装后一共写入 3 处内容：

💡 v0.2 及更早版本可能安装在任意目录，卸载前建议先确认自己的安装位置。

二、备份 Claude 配置：30 秒留后路 💾

卸载脚本会自动在移除钩子前备份设置，但手动备份一次更稳妥：

cp ~/.claude/settings.json ~/.claude/settings.json.mybackup cp ~/.claude/commands/docs.md ~/docs-command-backup.md 2>/dev/null || true

这样即使后续发现误删，也能随时恢复/docs命令和钩子配置。

三、最快一键卸载：运行 uninstall.sh

v0.3+（安装在 ~/.claude-code-docs）

在项目任意位置执行：

~/.claude-code-docs/uninstall.sh

也可以直接在 Claude Code 中使用：

/docs uninstall

v0.2 或更早版本

进入当年的安装目录后执行：

./uninstall.sh

脚本会替你做什么？✅

uninstall.sh 的卸载流程非常周全：

1. 自动发现安装位置—— 从docs.md命令文件和settings.json钩子中解析出所有安装路径（uninstall.sh）；
2. 移除/docs命令—— 删除~/.claude/commands/docs.md；
3. 清理自动更新钩子—— 只移除引用 claude-code-docs 的PreToolUse钩子，不影响你的其他钩子（uninstall.sh）；
4. 安全删除安装目录—— 仅在目录是干净 git 仓库时才删除，有未提交改动会保留并提示Preserved；
5. 自动备份—— 移除钩子前自动生成~/.claude/settings.json.backup。

执行过程中会列出将要删除的内容，输入y确认后才会继续，误操作风险很低。

四、手动彻底卸载：3 步干净移除 🧹

如果不想用脚本，或卸载后仍有残留，可手动清理（详细步骤见 UNINSTALL.md）：

第 1 步：删除命令文件

rm -f ~/.claude/commands/docs.md

第 2 步：移除钩子

在 Claude Code 中用/hooks命令查看并删除引用 claude-code-docs 的PreToolUse钩子；或直接编辑~/.claude/settings.json，删掉hooks.PreToolUse中 command 含claude-code-docs的条目（注意保留 JSON 合法格式）。

第 3 步：删除安装目录

# v0.3+ rm -rf ~/.claude-code-docs # 旧版本（替换为你的实际安装路径） rm -rf /path/to/your/claude-code-docs

⚠️注意：如果你曾在安装目录里修改过文档文件，请先备份再删除——脚本检测到未提交改动时也会选择保留目录而不是强删。

五、多实例清理与残留验证 🧪

如果测试过多个版本，可能存在多份安装。用下面命令找出所有残留目录：

find ~ -name "claude-code-docs" -type d 2>/dev/null | grep -v ".claude-code-docs"

对输出中的每个旧目录按第四节步骤单独清理。最后验证是否卸载干净：

ls ~/.claude/commands/docs.md # 应提示 No such file grep claude-code-docs ~/.claude/settings.json # 应无输出 ls ~/.claude-code-docs # 应提示 No such file

三项都"没有反应"，说明卸载彻底。确认无误后，可以删掉自动生成的备份文件~/.claude/settings.json.backup。

六、卸载后悔了？一键重装 /docs 功能 🔄

claude-code-docs 是纯本地工具，重装很简单。克隆仓库并运行安装脚本：

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

install.sh 会自动完成：克隆到~/.claude-code-docs、重建/docs命令、写回自动更新钩子，并顺带清理其他旧安装位置（install.sh）。装好后重启 Claude Code，输入/docs hooks验证即可。

📌 依赖提示：系统需已安装git、jq、curl（Linux 上jq可能需要apt install jq）。

常见问题 ❓

Q1：卸载会误删其他 hooks 吗？不会。脚本用jq精准筛选，只删除 command 中包含claude-code-docs的钩子条目（uninstall.sh）。

Q2：显示 "Preserved（已保留）" 是什么意思？说明安装目录不是干净的 git 仓库（有未提交改动或你添加的自定义文件），脚本出于安全选择不删除，需你确认目录内容后手动清理。

Q3：卸载后/docs命令还在？重启 Claude Code 让它重新加载命令列表即可，或检查~/.claude/commands/docs.md是否真的删除。

小结

卸载 claude-code-docs 只需记住三条：先备份~/.claude配置 → 运行~/.claude-code-docs/uninstall.sh一键清理 → 用find+grep验证残留。整个过程 5 分钟内完成，且完全可逆，需要时随时重装恢复。更多细节可参考 README.md 的 "Uninstalling" 章节与 UNINSTALL.md。

• 文档
• 知识库