鸿蒙 DevEco CLI 与 DevEco Code 全攻略

2026 HDC AI coding 会议一览

前言

短短几年，AI Coding 的编程范式便由 Copilot 过渡到 Vibe Coding 最后又到了 Agentic 模式。

Copilot 模式可以简单的理解为人绝对主导、AI 辅助，比如我们常用的豆包网页版，是人主动在上面输入内容，然后 AI 返回信息。

Vibe Coding 模式全称意图驱动的协同开发范式，特点是人类可以使用自然语言去描述，然后 AI 具体执行，人类去检验 AI 产物，然后反馈结果，人类在过程中充当审核的角色。

Agentic 模式全称是目标驱动的智能体开发范式，它强调人类制定顶层目标，AI 自主制定计划和推进工作，并且具备复杂推理能力和长期记忆，人类在关键节点进行监督和审核。

鸿蒙 AI 辅助工具的目标

开发者在长期的鸿蒙应用开发过程中面临的问题主要有：

常见的鸿蒙 AI Coding 场景

场景一

开发者使用习惯的 AI IDE，如 Trae、QOder 或者 WorkBuddy 等，然后希望可以有官方出品的知识库、Skill、MCP 或者 Agent 等能力。

然后开发者可以基于鸿蒙提供的官方命令行工具实现工程的创建、编码、测试、编译、签名打包、分发等流程。

场景二

为了简化开发流程，开发者希望官方提供一站式的鸿蒙 AI 开发工具，开箱即用、不需要额外多余配置。

官方解决方案

基于上述需求，鸿蒙官方推出了两款产品，分别是 DevEco CLI 和 DevEco Code。

DevEco CLI 是鸿蒙开发命令行基座，统一整合鸿蒙开发工具链、鸿蒙专属知识库与鸿蒙精品 Skills。面向各类 AI Agent 使用的 AI 产品，将鸿蒙开发能力封装为适配 AI 调用的标准化接口，既可供给 DevEco Code 集成，也可全面开放给各类通用 AI 开发工具集成使用。

DevEco Code 是鸿蒙应用 AI 辅助开发工具，融合鸿蒙领域软件工程能力，深度集成 DevEco CLI 全量能力，结合鸿蒙原生应用开发特性做全链路深度优化，全方位打磨流畅高效的开发体验，倾力打造适配鸿蒙生态、贴合开发者需求的极致 Agentic 智能开发工具。

除此之外，为了更加方便开发者发布和贡献专用于鸿蒙开发的 AI 功能能力市场，官方还做了个 格物市场，支持按标签、按分类、按组织检索各种 AI 资产，也支持按照业务场景，提供精品集，汇聚业务场景下的工程能力集，供开发者一键式批量下载。

DevEco CLI 入门

DevEco CLI 将 DevEco Studio 工具链统一封装为一个 CLI，内置 ohpm、hvigor、hdc、emulator、hilog，同时集成 HarmonyOS 技能安装、项目脚手架、本地 HarmonyOS 文档检索和 MCP 服务。

环境要求

安装

npm install -g @deveco/deveco-cli@latest

更新

devecocli update

创建工程

devecocli create --app-name MyApp

运行工程

devecocli run

常用命令

HarmonyOS 应用开发命令行工具

Options:
  -V, --version          output the version number
  -h, --help             display help for command

Commands:
  build [options]        构建 HarmonyOS 项目
  run [options]          构建并在连接的设备上运行项目
  update                 将 deveco-cli 更新至最新版本
  device                 管理已连接的设备
  emulator               管理模拟器实例
  skills                 管理 HarmonyOS 技能（skills）
  log [options]          获取设备应用日志
  create [options]       脚手架方式创建新的 HarmonyOS 应用项目
  init [options]         将 deveco-cli skill 安装到 AI 代理中，或将 deveco-mcp 服务器配置进 AI 代理
  serve                  托管内置的辅助协议服务器
  docs [options]         从本地文档目录搜索并阅读 HarmonyOS 文档
  help [command]         显示指定命令的帮助信息

AI Agent 集成

DevEco CLI 支持通过命令行将自身技能添加到 Agent 中，比如添加到 Claude Code 中。

devecocli init --agent claude-code

执行完上述命令后，检查全局的 Claude Code 的 Skill 目录：

然后你就可以直接在对应 Agent 中像使用普通的 Skill 去使用它了。

/deveco-cli 修改首页的背景颜色为上-下 红-蓝渐变，然后重新运行

过程中也的确看到了它调用了 deveco-cli 这个 Skill。

Server MCP

在本地启动一个基于 stdio 的 MCP（Model Context Protocol）服务器，让支持 MCP 的 AI IDE / 编辑器（如 Cursor、OpenCode 等）能够直接调用 DevEco 的 ArkTS / C++ 语法检查能力。

当你在编辑器里写 ArkTS 代码时，AI 可以通过这个 MCP 服务器调用 DevEco 的编译器，实时发现语法错误、类型不匹配等问题。

可以配置全局的 MCP，也可以配置项目级别的 MCP（推荐），这样当在当前工程启动 Agent 时，才会加载这个 MCP。

可以直接运行命令在当前工程中配置：

devecocli init --agent claude-code --mcp --project C:\Users\yeah1\Desktop\MyApp

得到 mcp.json 文件，不同智能体的配置方式不同。

{
  "mcpServers": {
    "deveco-mcp": {
      "type": "stdio",
      "command": "devecocli",
      "args": [
        "serve",
        "mcp"
      ],
      "env": {
        "PROJECT_PATH": "C:\\Users\\yeah1\\Desktop\\MyApp"
      },
      "enabled": true
    }
  }
}

然后 MCP 服务器会返回编译错误、警告等信息。

DevEco Code 入门

DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具，支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。

DevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、Provider / MCP / Skill / Plugin 等能力，并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。

安装

npm install -g @deveco/deveco-code

启动

deveco

然后它会引导你打开华为登录页面，进行登录即可。

配置模型

当前模型免费提供了 GLM 5.1，提供了每分钟 50 次请求，所以重度用户如果不够用，需要自行配置模型。

先输入 /modes 进入模型切换界面，然后按下 Ctrl+A 进入模型配置界面。

这里选择 DeepSeek。

UI 检查

UI 检查就是让大模型自行检查你的页面设计是否符合要求，这里需要你的模型支持多模态，如 Kimi 2.5、mimo-2.5 等，但是当前的 DevEco Code 仅支持 Qwen 系列。

权限模式

在终端中输入 Tab 键进行切换。

如何选择？

基本案例使用演示

1. 创建工程

2. 配置签名

3. 开发工程

4. 验收

参考地址