[[[[Switch to English]]]]

---

title: "如何安装 BMad" description: 在您的项目中安装 BMad 的分步指南

使用 npx bmad-method install 命令在您的项目中安装 BMad，并选择您需要的模块和 AI 工具。

何时使用

• 使用 BMad 开始新项目
• 将 BMad 添加到现有代码库
• 更新现有的 BMad 安装

:::note[先决条件]

• Node.js 20+ (安装程序需要)
• Git (推荐)
• AI 工具 (Claude Code, Cursor, Windsurf, 或类似工具) :::

步骤

1. 运行安装程序

npx bmad-method install

2. 选择安装位置

安装程序会询问将 BMad 文件安装在哪里：

• 当前目录 (对于新项目，如果您自己创建了目录并在其中运行，推荐此选项)
• 自定义路径

3. 选择您的 AI 工具

选择您使用的 AI 工具：

• Claude Code
• Cursor
• Windsurf
• 其他

每个工具都有自己的命令集成方式。安装程序会创建用于激活工作流和代理的小型提示文件 — 它只是将它们放在您的工具期望找到它们的地方。

4. 选择模块

安装程序会显示可用模块。选择您需要的任何模块 — 大多数用户只需要 BMad Method (软件开发模块)。

5. 按照提示操作

安装程序会引导您完成其余步骤 — 自定义内容、设置等。

您得到什么

your-project/
├── _bmad/
│   ├── bmm/            # 您选择的模块
│   │   └── config.yaml # 模块设置 (如果您需要更改它们)
│   ├── core/           # 必需的核心模块
│   └── ...
├── _bmad-output/       # 生成的工件
└── .claude/            # Claude Code 命令 (如果使用 Claude Code)

验证安装

运行 help 工作流 (在大多数平台上为 /bmad-help) 以验证一切正常并查看下一步做什么。

来自 main 分支的最新版本：

npx github:bmad-code-org/BMAD-METHOD install

如果您想在正式发布之前使用最新功能，请使用这些。可能会有不稳定的情况。

故障排除

安装程序报错 — 将输出复制粘贴到您的 AI 助手中，让它找出问题。

安装程序工作正常，但后来有些东西不工作 — 您的 AI 需要 BMad 上下文来提供帮助。请参阅 [[[[[如何获取关于 BMad 的答案]]]]] 了解如何将您的 AI 指向正确的来源。