• 文档
• 知识库

claude-code-docs 是一款把 Claude Code 官方文档镜像到本地的开源工具，安装后会自动创建/docs斜杠命令，让你在 AI 助手里离线秒查文档。如果你觉得/docs这个名字太短、容易和别的命令冲突，或者单纯想换个更有辨识度的名字，本文就用3 步带你完成 Claude Code 文档命令的重命名，打造专属的文档查询入口。

为什么想重命名 /docs 命令？

/docs是 claude-code-docs 安装时默认创建的命令，名字虽短，但可能遇到这些情况：

• 重名冲突：你或其他工具已经占用了/docs这个名字
• 辨识不清：命令列表里带 "(user)" 标记的/docs (user)不够直观
• 个人习惯：更偏好/claude-docs、/cdocs这类一眼看懂的名字

好消息是：斜杠命令的名字完全由命令文件名决定，改个文件名即可，不用改任何脚本和配置。

先搞懂原理：命令名 = 文件名

claude-code-docs 的安装器会把一个命令文件写到~/.claude/commands/docs.md（生成逻辑见 install.sh），Claude Code 读取该目录下的.md文件并以下划线前的文件名作为斜杠命令名：

命令文件内部只是指向~/.claude-code-docs/claude-docs-helper.sh的入口（脚本模板见 scripts/claude-docs-helper.sh.template），与文件名无关，所以重命名不会影响自动更新、-t同步检查等任何功能。

3步重命名 /docs 命令

第1步：确认命令文件存在

在终端执行下面的命令，确认默认命令文件还在：

ls ~/.claude/commands/docs.md

如果提示文件不存在，说明还没安装 claude-code-docs，请先按 README.md 完成安装。

第2步：重命名命令文件

把文件名改成你喜欢的名字（以/claude-docs为例）：

mv ~/.claude/commands/docs.md ~/.claude/commands/claude-docs.md

文件名是什么，斜杠命令就是什么：/cdocs、/claude-code-docs都可以随意选。

第3步：重启 Claude Code 并验证

重启 Claude Code 让它重新加载命令，然后输入新命令试一下：

/claude-docs hooks # 读取 hooks 文档 /claude-docs -t # 检查文档同步状态

能看到📚 Reading from local docs之类的输出，就代表重命名成功 🎉。

常见问题

问：以后更新 claude-code-docs，名字会被改回 /docs 吗？

会。安装脚本每次运行都会重新生成~/.claude/commands/docs.md（见 install.sh 中的 "Always update command" 逻辑），所以每次更新后重新执行一遍第 2 步即可，30 秒搞定。

问：重命名后提示 command not found？

1. 检查文件是否真的改名成功：ls ~/.claude/commands/
2. 重启 Claude Code 重新加载命令
3. 仍不行就重新跑一次安装脚本

问：旧命令 /docs 还能用吗？

不能。文件改名后/docs就消失了，这是预期行为；想两个名字并存，直接复制一份命令文件即可。

延伸阅读

• 使用说明与更多技巧：README.md
• 文档主题清单（每个文件对应一个可查询主题）：docs/docs_manifest.json
• 示例主题：docs/hooks.md、docs/mcp.md
• 彻底卸载说明：UNINSTALL.md

• 文档
• 知识库