SECTION · GETTING STARTED
开始使用
从安装 MoAI-ADK 到运行第一个项目的完整引导
介绍
MoAI-ADK 是用 成本（代币经济学）· 自我改进（智能体循环工程）· 质量把控（智能体线束）这三件事把 Claude Code 包起来的 Agentic …
迁移指南
迁移指南 MoAI-ADK 经历了两次大转换。(1) 1.x(Python) 到 2.x(Go 单个二进制),(2) 2.x 到 3.0(tokenomics …
安装
介绍在系统中安装 MoAI-ADK 的方法。实际安装的只是用 Go 构建的单一二进制 —— 无需 Python、虚拟环境或包管理器。
许可证 MoAI-ADK …
有什么不同 — 三种使用形式比较
有什么不同 — 三种使用形式比较 将 Claude Code 用于代理性开发主要有三种方式。(1)直接使用 Claude Code,(2)用通用包装器 …
Windows 使用指南
本文整理了在 Windows 上使用 MoAI-ADK 时需要了解的环境要求与常见陷阱。先说结论：WSL 最省心 — 原生 Windows 环境中遇到的大部分路 …
初始设置
通过 MoAI-ADK 的交互式设置向导完成首次设置。按你的开发环境配置语言、模型策略、报告格式、质量/工作流设置。这里设定的所有值都会保存为 …
快速开始
用 MoAI-ADK 创建第一个项目，体验开发工作流。跟随本文，你将完整跑完从编写 SPEC 到实现、文档化的一个循环。
事前准备 开始之前需完成以下事项：
CLI 概览
概览在终端执行的 moai(Go 二进制)的所有命令与标志。它与在 Claude Code 对话窗输入的 /moai(斜杠子命令)是完全不同的工具 —— 本页只 …
常见问题
以下是使用 MoAI-ADK 时经常被问到的问题与解答。
Q: moai 和 /moai 有什么区别？ 它们是完全不同的两样东西。这是最常见的混淆，先说清楚。信息所属价值: 代币经济学 · 智能体循环工程 · 代理型线束
这是为初次接触 MoAI-ADK 的用户准备的入门路径。按 介绍 → 安装 → 快速开始 的顺序阅读，30 分钟内即可运行第一个 MoAI-ADK 项目。安装只需下载一个单体二进制文件，运行第一个 SPEC 也不需要额外的运行时或依赖。
信息
flowchart TD
A["介绍
WHAT/WHY"] --> B["安装
环境准备"]
B --> C["初始设置
moai init"]
C --> D["快速开始
运行第一个 SPEC"]
D --> E["更新·配置文件
持续运维"]
E --> F["CLI·FAQ
参考资料"]| 顺序 | 文档 | 核心内容 |
|---|---|---|
| 1 | 介绍 | MoAI-ADK 是什么，解决什么问题 |
| 2 | 安装 | macOS/Linux 上的安装与前置条件 |
| 3 | Windows 使用指南 | Windows 环境的特殊注意事项 |
| 4 | 初始设置 | 使用 moai init 交互式向导配置项目 |
| 5 | 快速开始 | 创建第一个 SPEC 并运行 /moai plan → run → sync |
| 6 | 更新 | 让模板保持最新版本 |
| 7 | 配置文件管理 | 用户配置文件·环境变量·设置同步 |
| 8 | CLI 参考 | moai 二进制全部子命令索引 |
| 9 | 常见问题 | 安装·运行时常见问题与解决方法 |
信息下一步：完成安装后，可以在核心概念中学习 v3.0 的三大核心 — 代币经济学 (Tokenomics)、智能体循环工程 (Agentic Loop Engineering)、智能体挽具 (Agentic Harness) — 以及 SPEC·DDD·TRUST 5 等 MoAI-ADK 的设计哲学。