Skip to main content
Claude Code 是一款具备智能体能力的命令行工具,能帮助你维护文档。它可以撰写新内容、评审现有页面,并保持文档实时更新。 你可以在项目中添加 CLAUDE.md 文件,并持续迭代完善,用以训练 Claude Code 理解你的文档规范与工作流程。

快速开始

前提条件:
  • 有效的 Claude 订阅(Pro、Max 或 API 访问权限)
设置:
  1. 安装 Claude Code:
  1. 进入您的文档目录。
  2. (可选)将下面的 CLAUDE.md 文件添加到您的项目中。
  3. 运行 claude 启动。
要确认你的设置是否正常,可向 Claude Code 提问,例如 Summarize the standards from CLAUDE.md and list the Mintlify components you can use。正常运行的会话会引用你的 CLAUDE.md,并从已加载的 skill 中引用 Mintlify 组件(例如 CardStepsAccordion)。

CLAUDE.md 的模板

在文档目录根目录保存一个 CLAUDE.md 文件,帮助 Claude Code 理解你的项目。该文件会基于你的文档标准、偏好和工作流程对 Claude Code 进行训练。更多信息请参阅 Anthropic 文档中的管理 Claude 的记忆 复制此示例模板,或根据你的文档规范进行调整:

示例提示

完成 Claude Code 的设置后,试试以下提示,了解它如何协助处理常见的文档任务。你可以直接复制粘贴这些示例,或根据具体需求进行调整。

将笔记转化为完善文档

把粗略草稿转为包含组件和 frontmatter 的规范 Markdown 页面。 示例提示:

审阅文档的一致性

获取关于改进样式、格式和组件使用的建议。 示例提示:

功能变更时更新文档

在产品迭代中保持文档及时更新。 示例:

生成完善的代码示例

创建包含错误处理的多语言示例。 示例提示:

扩展 Claude Code

除了手动向 Claude Code 提示外,你还可以将其集成到现有的工作流程中。

使用 GitHub Actions 进行自动化

在代码变更时自动运行 Claude Code,保持文档同步更新。你可以在拉取请求 (PR;亦称“合并请求”/Merge Request) 上触发文档审阅,或在 API 发生变化时自动更新示例。

多实例工作流

针对不同任务使用独立的 Claude Code 会话——一个用于撰写新内容,另一个用于审阅与质量保证。这样有助于保持一致性,并发现单一会话可能遗漏的问题。

团队协作

将优化后的 CLAUDE.md 文件与团队共享,确保所有贡献者遵循一致的文档标准。团队通常会形成项目特定的提示与工作流程,并将其纳入文档实践中。

自定义命令

.claude/commands/ 中创建可复用的斜杠命令,用于你所在项目或团队常见的文档任务。

常见问题

不需要,但它能显著提升输出质量。如果没有 CLAUDE.md,Claude Code 会基于通用上下文工作,可能无法遵循你的特定风格指南、组件偏好或术语规范。CLAUDE.md 文件可以训练 Claude Code 了解你的项目标准,这样你就不需要在每次提示中重复说明。
Claude Code 是一款命令行工具,专为在整个代码仓库范围内执行智能体式、多步骤任务而设计。它非常适合审查所有页面是否缺少替代文本、在每个代码示例中更新参数名称,或检查一组文件的一致性等任务。Cursor 和 Devin Desktop 是基于 IDE 的工具,更适合通过内联建议编辑单个文件。两种方式都可以——正确的选择取决于你的工作是逐个文件还是跨整个仓库。
可以。Claude Code 可以读取你的源代码并生成对应的文档。将其指向一个 API 端点、配置文件或一组函数,让它按照你的 CLAUDE.md 标准生成匹配的文档。请审核和完善输出——自动生成在你将 Claude Code 视为初稿作者而非最终发布者时效果最佳。
将 CLAUDE.md 文件提交到你的文档仓库中。任何克隆该仓库并运行 Claude Code 的人都会自动使用你的项目配置。这使得文档标准在所有贡献者之间保持一致,无需每个人单独设置自己的上下文。