快速开始
与 Claude Code 配合使用
学习如何在 Claude Code 中使用 Anydocs 进行 AI 辅助文档编写。
把 Anydocs 接到 Claude Code 的推荐方式是：注册 `@anydocs/mcp`，用 CLI 初始化项目，然后让 Claude Code 通过 MCP 完成页面和导航操作。只有开发 Anydocs 本身时，才需要走源码入口。
1. 安装
安装 Anydocs MCP 服务，请参考安装文档中的 MCP 快捷命令。安装为全局配置后，在任何 Claude Code 项目中都可以直接使用。
claude mcp add -s user anydocs -- npx -y @anydocs/mcpclaude mcp add -s local anydocs -- npx -y @anydocs/mcp安装完成后可以通过 `claude mcp list` 确认已注册的 server。
2. 初始化一个适合 Claude Code 的项目
npx @anydocs/cli init ./my-docs --agent claude-code这个命令会生成 `CLAUDE.md`，并附带 `.claude/commands/` 中的项目内命令模板。
3. 在 Claude Code 中让 AI 做什么
让 Claude Code 优先通过 Anydocs MCP 完成这些动作：
- 打开项目并读取 contract
- 创建或更新页面
- 维护导航结构
- 切换页面状态
- 在发布前运行项目校验，必要时再执行 `preview` 或 `build`
这样可以复用 canonical 校验规则，避免手工修改 JSON 造成结构漂移。
4. 什么时候预览，什么时候构建
用 `preview` 检查 reader 中的真实展示效果；用 `build` 生成最终静态站点和 AI 产物。两者都只暴露 `published` 页面。
npx @anydocs/cli preview ./my-docs
npx @anydocs/cli build ./my-docs