MetaGPT 使用教程：从入门到上手

MetaGPT 是什么

MetaGPT 是一个由国内团队开发的多智能体（Multi-Agent）协作框架，它模拟了一家软件公司的完整运作流程。你可以把它理解成一个“AI 员工团队”——里面有一个产品经理、一个架构师、几个工程师，它们各自扮演不同角色，通过对话和分工，帮你从一句话需求直接生成代码、文档甚至测试用例。

与 ChatGPT 这种单次对话不同，MetaGPT 的核心思路是角色分工+流程协作。你只需要给一个需求描述（比如“做一个待办事项清单 App”），MetaGPT 会自动拆解任务：PM 写需求文档、架构师设计技术方案、工程师写代码、QA 做测试。整个过程在本地运行，所有输出都是中文，对国内开发者非常友好。

核心功能怎么用

MetaGPT 最核心的能力是需求到代码的端到端生成。举个例子，你输入“帮我写一个简单的博客系统，支持用户注册、发帖、评论”，它会自动执行以下步骤：

1. 产品经理角色：分析需求，输出一份结构化的 PRD（产品需求文档）
2. 架构师角色：根据 PRD 设计数据库表结构和 API 接口
3. 工程师角色：按照设计文档生成 Python（Flask/FastAPI）或 JavaScript 代码
4. QA 角色：检查代码逻辑，生成测试用例

除了软件项目，你还可以用它写技术文档、做 API 设计、甚至生成 markdown 格式的周报。所有输出都是结构化的文件，保存在本地文件夹里，方便你直接查看和修改。

第一次上手步骤

环境准备

MetaGPT 基于 Python，你需要先安装 Python 3.9 以上版本。建议用虚拟环境（venv 或 conda）隔离。

安装 MetaGPT

打开终端，执行：

pip install metagpt

国内用户如果下载慢，可以使用国内镜像源（比如清华源）：

pip install metagpt -i https://pypi.tuna.tsinghua.edu.cn/simple

配置 API Key

MetaGPT 需要调用大语言模型（默认是 OpenAI 的 GPT-4）。你需要准备一个 OpenAI API Key。注意：OpenAI 服务在国内访问受限，如果你无法直接使用，可以考虑国产替代方案，比如使用支持 OpenAI 兼容接口的国内大模型服务（如智谱、百度文心等），在配置文件中修改 llm.api_base 和 llm.api_key 即可。

配置文件位于 ~/.metagpt/config2.yaml，首次运行会自动生成。你也可以手动创建，内容参考官方文档。

运行第一个项目

在终端输入：

metagpt "写一个计算器，支持加减乘除，用 Python 实现"

MetaGPT 会开始工作，你会在终端看到角色间的对话和文件生成的进度。最终输出保存在 workspace/ 目录下。

适合什么场景

• 快速原型开发：你有一个想法，但不想手写所有代码，让 MetaGPT 帮你生成基础框架和核心逻辑。
• 学习项目结构：新手开发者可以观察 AI 如何拆解需求、设计架构，学习规范的项目组织方式。
• 文档自动生成：需要写技术方案或 API 文档时，让 AI 角色帮你起草初稿。
• 团队协作模拟：产品经理或技术负责人可以用它来验证需求是否清晰，提前发现设计漏洞。

不适合的场景：生产级复杂项目（代码质量需人工审查）、需要高度定制化 UI 的项目（MetaGPT 更擅长后端逻辑）。

价格说明

MetaGPT 本身是完全免费开源的，采用 MIT 协议，你可以随意使用、修改甚至商用。唯一的成本来自你调用的大模型 API——如果你用 GPT-4，每次运行项目会消耗几美分到几美元（取决于项目复杂度）；如果换成国产大模型，成本通常更低，部分服务还有免费额度。

简单说：框架不要钱，跑起来要花点 API 调用费。