AgileBuilder logoAgileBuilder
返回文档

快速开始 · 专业版

注册 AgileBuilder 账号，使用云端空间托管模板与文档资源，CLI 登录后多设备同步使用

专业版在开源 CLI 的基础上增加了云端空间：模板和文档资源托管在云端，多设备登录同一账号即可同步使用。本篇从注册开始走完整个流程。

第 1 步：注册账号

打开控制台并注册：

  • 中国区控制台：https://app.agilebuilder.cn
  • 全球区控制台：https://app.agilebuilder.net

AgileBuilder 采用纯 SSO 认证，没有独立密码。支持的登录方式：

  • 邮箱 + 验证码
  • 微信扫码
  • GitHub / Google 账号

首次登录会自动创建账号，并为你生成一个个人空间，无需任何手动初始化。

第 2 步：在控制台添加资源

登录控制台后，进入你的个人空间，可以在线管理两类资源：

  • 模板（Template）：指向一个 Git 仓库（可指定分支和子目录），用于生成项目
  • 文档（Doc）：Markdown 或纯文本内容，作为规范与上下文材料，可通过 MCP 暴露给 AI 工具

把团队规范文档录入为文档资源后，配置好 MCP 的 AI 工具（如 Cursor、Claude Code）就能实时读取这些规范，详见 MCP 集成。

第 3 步：CLI 登录

在终端执行：

ag login

CLI 会自动打开浏览器完成 SSO 授权：它在 127.0.0.1 上监听 OAuth 回调（从端口 51280 开始，最多向后探测 10 个端口），授权完成后自动回到终端。

无法打开浏览器的环境（如服务器、CI）可以使用 API Key 登录：

ag login --api-key <your-api-key>

查看认证状态与退出：

ag auth status     # 查看当前登录状态
ag logout          # 清除本地凭据

第 4 步：切换到云端空间

ag space list              # 列出你可见的所有空间（local + 云端空间）
ag space use <space-id>    # 切换到你的个人空间
ag space current           # 确认当前空间

当前空间决定了 res 命令操作的对象，以及 create <resource-id> 从哪个空间解析资源。

第 5 步：使用云端资源创建项目

ag res list                          # 列出当前空间的模板与文档
ag create <resource-id> --target ./my-app --var appName=my-app

命令用法与开源版完全一致——区别只是资源来自云端空间，换一台电脑登录同一账号即可使用同一套模板库。

也可以用 CLI 直接向云端空间添加资源：

ag res add template \
  --name service-template \
  --git-url https://github.com/example/service-template.git \
  --branch main \
  --tags "node,service"

免费版、Trial 与 Pro

免费版Trial（试用）Pro（专业版）
登录并查看云端空间、同步使用资源✅✅✅
在云端空间创建/编辑/删除资源❌（只读）✅✅
时长不限14 天按订阅年数
价格¥0¥0中国区 ¥199/年；全球区 $49/年
  • 每个账号和空间可激活一次 14 天 Trial 试用，试用期间拥有完整的云端写入能力。
  • 到期或未订阅的空间进入只读状态：已有资源仍可查看和使用，但不能新增或修改。
  • 中国区支持微信 / 支付宝支付，全球区支持 PayPal / Paddle。所有付费订单 14 天内可申请退款，详见退款政策。

多设备场景：在每台设备上分别执行 ag login 即可。用 ag device list 查看已登录的设备，ag device revoke <device-id> 可以远程撤销某台设备的访问。

下一步