从零到一：用华为云码道 CLI + AGENTS.md 快速搭一个 Web 应用

案例共创 · 码道实战
2026-07-07 AI Agent 自动验证。用华为云码道 CLI 和 AGENTS.md 规则文件，从自然语言到可运行 Web 应用，全程无需手写一行代码。

---

一、背景

痛点：从需求到原型，中间差了很多步

作为一个开发者运营同学，经常需要快速搭个 Demo 给团队看——活动报名页、周报工具、数据展示面板。传统流程：

写需求文档 → 找开发排期 → 等1~2天 → 拿到初版 → 改3轮 → 上线

整个周期至少 2~3 天，换个字段就得再来一轮。有没有办法自己用对话就能生成可运行的应用？

目标

目标	说明
🎯 自然语言出代码	说需求，AI 直接生成
🎯 可运行	生成立刻能跑，不是代码片段
🎯 可定制	能通过规则文件约束 AI 行为
🎯 团队可复制	别人改个配置就能用

为什么选华为云码道

华为云码道（CodeArts）提供了两样正好对口的工具：

1. 码道 CLI — 终端里说一句话，Agent 自动写代码、建文件、搭项目
2. AGENTS.md / Rules — 项目根目录放个规则文件，AI 自动遵守编码规范

这两个组合起来，就是「说需求 → 按规则出代码 → 直接跑起来」的闭环。

---

二、实战过程

环境准备

# 1. 安装码道 CLI（macOS）
sh -c "$(curl -L https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/cli_tui/install_script/install.sh)"

# 2. 配置 AK/SK
export CODEARTS_CLI_AK="你的 Access Key"
export CODEARTS_CLI_SK="你的 Secret Key"

# 3. 验证
$ codearts models
model_id                              model_name
------------------------------------------------
huaweicloud-maas/deepseek-v3.2        DeepSeek-V3.2
huaweicloud-maas/GLM-5.1              GLM-5.1
huaweicloud-maas/Glm-5-internal       GLM-5
huaweicloud-maas/GLM-4.7-SFT-Harmony  GLM-4.7-ArkTS-SPARK

Step 1：用 AGENTS.md 告诉 AI「按什么规矩来」

在项目根目录放一个 AGENTS.md，码道 Agent 会自动读取并遵守里面的规则。这是让 AI 输出符合团队规范的关键一步：

# AGENTS.md — 项目规约

## 技术栈
- 框架：Python Flask
- 前端：Bootstrap 5 + Jinja2 模板
- 数据：JSON 文件（无需数据库，方便 Demo）

## 编码规范
- API 风格：RESTful，使用 Flask Blueprint
- 错误处理：统一返回 JSON `{"error": "...", "code": N}`
- 日志：每条请求记录 method、path、status、耗时

## 项目结构要求
flask_app/
├── app.py              # 主入口
├── requirements.txt    # 依赖
├── templates/          # HTML 模板
├── static/             # CSS/JS
└── data/               # JSON 数据文件

放好这个文件，Agent 后续生成的所有代码都会自动遵守上述规范。不需要在每一步都重复说一遍要求。

Step 2：一句话让码道 CLI 生成项目

codearts run "用 Flask 创建一个 Web 应用，包含首页和关于页，使用 Bootstrap 深色主题" \
  --model huaweicloud-maas/GLM-5.1

Agent 实际执行了什么：

1. mkdir -p flask_app/templates — 建目录结构
2. 通过 cat > file << 'EOF' 逐文件写入代码（码道 CLI 非交互模式下文件编辑权限自动拒绝，但 cat > 写入不受影响）
3. 生成了以下文件：

flask_app/
├── app.py                  # Flask 入口 + 路由
├── requirements.txt        # flask, flask-cors
├── templates/
│   ├── base.html          # Bootstrap 深色主题基础模板
│   ├── index.html         # 首页
│   └── about.html         # 关于页
└── data/
    └── site.json          # 站点配置

Step 3：运行验证

cd flask_app
pip install -r requirements.txt
python app.py

# 访问 http://localhost:5000
# 首页 → 看到深色主题的页面
# /about → 关于页

运行截图（略） — 实际测试中，Flask 应用正常启动，三个页面均可访问，Bootstrap 深色主题渲染正常。

Step 4：迭代修改（追问即可）

不满意？不用重新生成，直接追加要求：

codearts run "把首页改成浅色主题，在导航栏加一个「项目」菜单项"

Agent 会基于已有代码增量修改，而不是从头重写。

---

三、实际用下来的感受

好的地方

• AGENTS.md 是真的有用 — 设好规则后，后续生成的所有代码都按规范走。比每次对话里重复说「用 Flask」「用 Bootstrap」省事多了。
• CLI 模式适合脚本化 — 不需要打开 IDE，终端里一条命令就干活。可以写到 Shell 脚本里批量执行。
• 模型可用性不错 — DeepSeek-V3.2 和 GLM-5.1 都能正常调用，中文理解能力在线。

需要注意的地方

• 文件编辑需要确认 — CLI 非交互模式下，AI 要改已有文件时会弹权限确认。因为没人点「允许」，会卡住。解决方案是用 cat > 新建文件或覆盖，实测可行。
• 没有 Figma 导入 — 如果期望「设计稿 → 代码」一条龙，码道目前不支持。需要手工写文字描述布局。对简单页面影响不大，复杂 UI 会比较费口舌。
• 一键部署目前没有 — 生成了代码需要自己 python app.py 启动或部署到服务器。没有内置的「一键上云」按钮。

适合谁用

人群	推荐度	原因
开发者运营	⭐⭐⭐⭐⭐	快速搭 Demo、做活动页、做工具，太对口了
全栈开发者	⭐⭐⭐⭐	省掉重复的模板代码编写
前端为主	⭐⭐⭐	后端代码生成靠谱，前端 UI 需要自己微调
非技术人员	⭐⭐	需要会装 Python 和跑命令行，有一定门槛

---

四、总结

能力	码道 CLI	说明
✅ 自然语言 → 代码	✅	codearts run "..." 一句话干活
✅ 规则约束	✅ AGENTS.md	设好规范，AI 自动遵守
✅ 可运行	✅	生成完整项目，python app.py 就跑
✅ 增量修改	✅	追问就行，不用从头来
⚠️ 文件编辑自动化	需用 cat > 绕过	非交互模式的已知限制
❌ Figma/设计稿输入	暂不支持	需文字描述替代

一句话总结

码道 CLI + AGENTS.md = 一个能听懂需求、按规矩办事、还给交付物的终端队友。

对开发者运营来说，最直接的收益是：不用求开发排期，自己 10 分钟就能出一个可演示的 Demo。周报工具、活动报名页、数据看板这类场景，码道 CLI 一套带走。

---

延伸玩法

方向	怎么做
Spec-Driven 开发	用 YAML 定义数据规范 → Agent 按规范生成对应代码
Skills 复用	把常用的 AGENTS.md 存成码道 Skill，下次直接引用
接入 MCP	码道支持 MCP 协议，可以接入外部工具扩展能力
批量生成	把多个 codearts run 写进 Shell 脚本，一键跑全套

---

免费体验华为云码道：https://codearts.huaweicloud.com/?source=dmzntgwsf&source=dmzntgwwbwz
体验版 ¥0，每月 500 万 Token，支持 Agent Space / CLI / Skills / MCP 全部功能