> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meoo.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Meoo CLI 使用指南
meoo cli 是秒悟（Meoo）官方推出的命令行工具，让 Claude Code、Codex、Qoder、Qoderwork等本地 agent 在帮你写完前端代码后，能直接接管「数据库、用户登录、文件存储、百炼模型服务、部署上线」的所有云端工作。
🔧 支持工具：具备Coding能力的本地 agent ，例如：Claude Code、Codex、Cursor、Qoder、Qoderwork、Cline 等主流 agent。
🎯 适用场景：
* 从 0-1 搭建项目，需要接入数据库，部署到线上，并生成分享链接
* 本地已有的静态页面同步云端协作
* 本地已有全栈项目，希望保留服务端架构并部署到线上
* 本地已有的 SSR、API 服务、后台系统，现在希望一键发布
✅ 适用人群：
* 有全栈交付需求的泛开发者
* vibe coding 爱好者，想把作品做成链接分享的创作者
* 设计师、产品经理、运营，需要快速产出落地页、H5 长图、活动页并和团队协同打磨
## **步骤一：安装 meoo cli**
前置条件：
* 已安装 [Node.js 20 或更新版本](https://nodejs.org/en/download/)
* macOS 用户推荐通过 nvm 或 Homebrew 安装 Node.js
* Windows 用户还需安装 Git for Windows 和 zip 工具
**方式一：自动安装（推荐）**
打开任意本地 agent（codex/claude code/cursor/qoder/qoderwork等），直接在对话框发送这句话
```text theme={null}
读取 meoo.com/skill-setup.md 并按照说明安装秒悟技能
```
**方式二：手动安装**
打开终端，执行：
```text theme={null}
npm install -g @aliyun-meoo/cli
```
执行下面这行验证安装：
```text theme={null}
meoo --version
```
显示版本号即安装成功。
## 步骤二：登录授权
安装完成后，CLI 会自动打开浏览器，跳转到 meoo.com 的授权页面。首次授权，需要登录秒悟账号，之后只需在网页上确认设备名称并点击「授权登录」。授权成功后，浏览器会提示你回到终端——CLI 会自动获取凭证并保存。
如未触发自动登录和授权，可尝试手动登录：
在终端执行以下命令，会跳转到浏览器登录授权界面
```text theme={null}
meoo login
```
## 步骤三：使用本地 agent 创建项目
打开日常使用的 agent （以codex桌面端为例）, 在对话框输入：
```text theme={null}
帮我用meoo做一个好看的个人主页，数据接入云服务数据库，然后一键发布到线上
```
接下来 agent 会自动完成所有事情——它会写个人主页，调用 meoo cli 在云端创建数据库、补齐缺失的后端代码，最后部署到线上，生成一个可以分享的链接。整个过程你只需要看着终端输出，等它跑完即可。
## 步骤四：本地预览 + 一键上线
AI 干完活后，你可以让它帮你先在本地起一个预览：
```text theme={null}
起个本地预览看看效果
```
浏览器自动打开 localhost:3015，你可以在本地完整测试一遍——注册账号、提交表单、查看数据库等等。确认没问题后，告诉它：
```text theme={null}
部署上线
```
AI 会自动执行 meoo deploy，构建打包并发布到 CDN，最终在终端输出一个可直接分享的访问链接。把这个链接发给朋友、发到社交平台，他们就能用上你做的应用了。
如果想使用扩充数据库容量，调用大模型服务（ai问答，文生图，识图等能力），自定义域名，自定义网页发布范围（全网可见/指定人员可见/仅自己可见）等功能，建议把代码同步到meoo云端，可以继续跟本地agent （以codex为例）对话：
```text theme={null}
帮我把代码同步到meoo云端
```
就可以在 meoo 官网看到刚才构建的应用，可以直接在秒悟里进行二次修改。
## 常见问题
**Q1：我想试用，怎么开始？**
打开你常用的 AI 编程工具（CodeX、Claude Code、Qoder、QoderWork 都行），把下面这条命令丢给 AI：
> 读取 meoo.com/skill-setup.md 并按照说明安装秒悟技能
如果项目有服务端进程，可以补充说明：
> 这个项目需要服务端进程，请使用全栈应用部署。
AI 会自己读完说明、装好工具、引导你完成登录。装完直接告诉它"帮我把这个项目部署上线"就能开始用。
***
**Q2：支持哪些 AI 编程工具？**
CodeX、Claude Code、Qoder、QoderWork等主流的 agent 工具都能接入使用，按上面 Q1 的命令安装一遍就行。
***
**Q3：开发的时候能在本地先看效果吗？**
能。AI 帮你启动后会跑在本地 localhost。静态应用通常是 `localhost:3015`；全栈应用会按项目自己的方式启动。本地预览和部署上线是两件独立的事，可以先反复本地修改，没问题后再让 AI 部署上线。
***
**Q4：我已经在本地改了代码，但 meoo 网页后台也能编辑，会冲突吗？**
会有冲突风险。本地开发期间，不建议直接在网页后台发布覆盖。如果确实要在网页侧协作修改，先让 AI 帮你把代码同步到 Meoo 云端，再去网页操作。
***
**Q5：我让 AI 执行开通云服务，但马上去连数据库就报"未开通"？**
正常，云服务开通大概要等几分钟。命令返回成功只代表开通申请已发出，数据库实例还需要一点时间才能真正就绪。等 2-3 分钟后让 AI 重试即可。
***
**Q6：静态部署和全栈应用部署有什么区别？**
| | 静态部署 | 全栈应用部署 |
| -------- | --------------------------------- | ------------------------------------------------------------------ |
| 适合项目 | React/Vue/Taro SPA、个人主页、活动页、纯前端工具 | Next.js SSR、Nuxt SSR、Express、FastAPI、Django、Spring Boot、Go HTTP 服务 |
| 是否有服务端进程 | 没有 | 有 |
| 发布方式 | 构建前端产物并发布到 CDN | 上传源码，云端构建并运行服务 |
| 后端逻辑 | 使用 Meoo Cloud / Edge Functions | 可以保留项目自带服务端 |
| 典型命令 | `meoo deploy` | 首次 `meoo deploy --runtime image`，后续可直接 `meoo deploy` |
***
**Q7：我以前写好的项目能搬到 meoo 上来吗？**
可以。纯前端项目可以走静态部署；带服务端进程的项目可以走全栈应用部署。迁移之前建议先备份代码，再让 Agent 检查项目类型、列出改造点并执行部署。
***
**Q8：纯静态页面也要开通云服务吗？**
不用。静态页面、个人主页、活动页等不需要注册登录、不需要存数据的项目，可以直接发布，不会消耗云服务额度。
***
**Q9：全栈应用使用meoo cli部署时需要满足哪些环境配置需求？**
全栈应用构建环境：
* OS：Linux，构建/运行目录是 `/code`
* Java：OpenJDK 21
* Node.js：24.15.0
* npm：11.13.0
* pnpm：10.33.3
* Yarn：1.22.22
* Python：3.13
* Go：1.26.0
* 常用工具：`git`、`curl`、`wget`、`unzip`、`rsync`、`build-essential`、`pkg-config`
运行约束：
* 应用必须监听 `0.0.0.0:${PORT:-9000}`
* `scripts/setup.sh` 在远端构建时执行
* `scripts/start.sh` 在容器启动时执行
* 本地文件存储不持久，容器会冷启动/重建，持久化要走云数据库或外部服务
***
**Q10: 全栈应用部署需要我写 Dockerfile 或安装 Docker 吗？**
不需要。你只要告诉 Agent 这个项目需要服务端进程。Agent 会补齐部署所需配置，并调用 Meoo CLI 在云端构建和运行。
***
**Q11: 提示余额不足怎么办？**
如果出现额度不足提示，可以前往 `https://docs.meoo.com/coindesc\` 查看套餐和额度，或到 `https://meoo.com\` 删除不用的项目/实例释放资源。目前限时免费体验，Free 用户可以部署 1 个全栈项目，Pro 用户 4 个，MAX 用户 8 个。