随着 HarmonyOS 生态的快速发展，开发者对高效开发工具的需求日益迫切。在 HDC 2026 上，华为正式发布了专为 HarmonyOS 应用开发打造的 AI Agent 工具——DevEco Code（简称 DevEco Code）。它并非传统 IDE 插件，而是一个基于终端交互的“编程智能体”，能够深入理解自然语言意图，自主完成从项目创建、代码编写、编译构建到真机调试的全流程。

一、DevEco Code 是什么？

DevEco Code 是华为面向 HarmonyOS 开发场景发布的全链路 AI Agent 工具。它基于开源项目 OpenCode 深度定制，保留了 OpenCode 的终端交互、配置体系以及 Provider / MCP / Skill / Plugin 等核心能力，并在此基础上深度融合了 DevEco Studio、Hvigor 构建工具、HDC 设备管理、HarmonyOS 知识库、ArkTS 静态检查和设备调试等 HarmonyOS 专属能力。

其核心定位是：在命令行终端中直接与 AI 对话，完成 HarmonyOS 应用的编码、构建、运行、调试全流程。开发者只需用自然语言描述需求，DevEco Code 即可自主调用各种工具，完成从代码生成到设备部署的闭环。

1.1 与 DevEco CLI 的区别

HDC 2026 同期还发布了另一款工具——DevEco CLI（@deveco/deveco-cli）。两者虽然都服务于 HarmonyOS 开发，但定位截然不同。理解它们之间的差异，有助于开发者根据自身情况选择合适的工具。

维度DevEco CLI（@deveco/deveco-cli）DevEco Code（@deveco/deveco-code）
本质命令行工具集，封装 DevEco Studio 原子能力AI Agent 对话式工具
交互方式手动输入命令 + 参数自然语言描述意图，AI 自主执行
代码能力不涉及代码编写支持代码编写、修改、审查、重构
排错能力输出错误日志，需人工分析自动读取错误日志，定位根因并修复
知识检索集成官方知识库供 Agent 调用内置 HarmonyOS 知识库，自然语言查询
上下文理解无状态，每次独立执行有状态会话，理解项目结构和历史对话
适用场景已有 AI Agent 的团队，将鸿蒙能力接入现有流程独立开发者或团队，开箱即用的 AI 编程助手

简而言之：DevEco CLI 是供已有 AI Agent 调用的“鸿蒙能力工具箱”；DevEco Code 则是自带 AI 大脑、能够“自动驾驶”的开发伙伴。

1.2 核心能力一览

根据公开资料，DevEco Code 具备以下关键能力：

  • 智能对话开发：在终端中以自然语言交互，支持多轮对话，理解项目上下文。
  • 代码生成与修改：根据需求描述或注释自动生成 ArkTS/ArkUI 代码，并可对现有代码进行重构、修复。
  • 编译构建：通过 build_project 工具执行 Hvigor 构建，生成 HAP 产物。
  • 设备部署与运行：通过 start_app 工具将应用安装到模拟器或真机并启动。
  • 日志收集：通过 hdc_log 工具收集或清理设备日志（基于 hdc shell hilog）。
  • UI 意图验证：通过 verify_ui 工具在模拟器/真机上自动执行 UI 操作，验证界面显示与交互逻辑。
  • ArkTS 静态检查：通过 check_ets_files 工具进行 ArkTS 语法检查。
  • 知识库检索：通过 arkts_knowledge_search 工具查询 HarmonyOS 官方文档和 API Reference。
  • 多模型支持：内置 GLM-5.1 免费模型，支持接入 DeepSeek、OpenAI 等第三方模型。
  • 三种 Agent 模式：Build、Plan、Goal，覆盖从日常编码到端到端自动驾驶的不同场景。

二、安装与快速开始

2.1 前置条件

在安装 DevEco Code 之前，请确保环境满足以下条件：

  1. Node.js 环境：推荐安装 Node.js 22 及以上版本。DevEco Code 通过 npm 分发，需要 npm 命令支持。
  2. DevEco Studio（可选）：推荐安装 DevEco Studio 6.1 及以上版本。如果未安装，则 HarmonyOS 应用的构建、推包等工具将无法使用，DevEco Code 的部分能力会受限。
  3. DEVECO_HOME 环境变量（可选）：如果 DevEco Studio 安装在非默认路径，建议配置 DEVECO_HOME 环境变量指向其安装目录。默认路径示例：
    • macOS：/Applications/DevEco-Studio.app
    • Windows：C:\Program Files\Huawei\DevEco Studio

验证 Node.js 环境：

node -v
npm -v

2.2 安装 DevEco Code

使用 npm 全局安装 DevEco Code：

# npm 全局安装（推荐）
npm install -g @deveco/deveco-code

国内用户如果访问 npm 官方源较慢，可以使用淘宝镜像源：

npm install -g @deveco/deveco-code --registry=https://registry.npmmirror.com

安装完成后，可以通过 deveco-code --version 或 deveco-code -v 检查版本（具体命令以实际终端提示为准，资料中未给出明确版本检查命令）。

2.3 启动 DevEco Code

进入你的 HarmonyOS 项目目录（如果没有项目，可以先创建一个空目录或使用 DevEco Studio 创建工程），然后启动 DevEco Code：

cd your-harmonyos-project
deveco-code

启动后，终端会进入 DevEco Code 的对话界面。你可以直接输入自然语言描述任务，例如：

> 帮我从零创建一个 HarmonyOS 工程，包含一个首页和一个设置页

DevEco Code 会自动调用 deveco-create-project Skill 创建工程，编写代码，然后执行 build_project 编译，最后通过 start_app 在设备上运行（如果有可用设备）。

2.4 登录与免费模型

首次使用 DevEco Code 时，可能需要登录华为账号以使用免费模型通道。具体登录方式资料中未详细说明，但根据类似工具的经验，通常在启动后会引导登录或通过命令（如 /login）完成。登录后即可使用 DevEco Code 提供的免费模型（当前为 GLM-5.1），单账号默认每分钟 50 次请求。

如果免费模型响应速度较慢，或需要更高并发，可以接入第三方模型（如 DeepSeek）。详细配置方法见后文。

三、Agent 配置：Build、Plan、Goal 三种模式

DevEco Code 提供了三种预置的 Agent 模式，覆盖从需求分析到代码交付的完整链路。开发者可以在交互界面中通过 Tab 键 在模式间快速切换。

3.1 Build（默认模式）

角色定位：完整读写权限的编码执行者。

能力范围：负责日常开发中的编码、编译、调试、修复等任务。当开发者给出具体编码需求时，Build Agent 会直接生成代码、执行构建，并在出现错误时尝试自动修复。

适用场景：日常功能开发、Bug 修复、代码重构、增量开发等。

3.2 Plan（只读分析模式）

角色定位：只读的代码分析专家。

能力范围：专注于代码分析和方案规划，不会对项目文件进行写操作。它会探索代码库结构，理解现有实现，然后输出开发方案或重构建议，供开发者确认后再切换到 Build 模式执行。

适用场景：探索陌生代码库、设计重构方案、评估技术实现路径。

3.3 Goal（端到端自动驾驶模式）

角色定位：以终为始的全自动驾驶智能体。

能力范围：Goal 模式实现了从“人提需求”到“AI 自主达成目标”的完整闭环。其工作流程如下：

  1. 读取 Spec：解析开发者提供的 Spec 文档，提取需求与验收标准。
  2. 任务拆解：自动完成需求分析、任务拆解和架构设计。
  3. 编码与编译：进行代码生成、语法校验、编译打包。
  4. 部署与验证：将应用推送到模拟器或真机，执行功能自验证。
  5. 自修复与迭代：发现问题后自动修复，重新构建、部署、验证，循环迭代直至满足验收标准。

适用场景：按需求文档全自动交付功能的场景，例如从零实现一个完整页面或模块。

Goal 模式的工作流程示例（以“首页基础文本组件快捷入口”任务为例）：

  1. 自动启动设备并推包运行。
  2. 进入循环执行：代码生成 → 语法检查 → 代码修复 → 构建出包 → 推送模拟器 → 功能自验证。
  3. 直到用户最终确认完成为止。

Goal 模式大幅减少了人工干预，将 AI 从“辅助工具”升级为“自主开发者”。

四、HarmonyOS 场景能力：内置工具矩阵

DevEco Code 预置了一套覆盖 HarmonyOS 应用开发全流程的核心工具。这些工具以自然语言命令的形式暴露给 AI Agent，使其能够与实际开发环境交互。以下为工具列表及其对应传统命令：

工具名称功能说明对应传统命令
build_project执行编译构建并导出构建产物hvigorw assembleHap
start_app在模拟器或真机上运行应用hdc install + hdc shell aa start
hdc_log收集 / 清理设备日志 / 查看连接设备hdc shell hilog
verify_ui基于自然语言描述执行 UI 操作，验证功能正确性手动操作 + 截图对比
check_ets_filesArkTS 静态语法检查DevEco Studio 内置 ArkTS-Check
arkts_knowledge_searchHarmonyOS 知识库检索查阅官网文档 / API Reference
switch_cwd切换构建项目路径cd

这些工具使得 DevEco Code 不再只是一个聊天机器人，而是能够真正操作工程环境、构建产物、管理设备的“手”和“脚”。

4.1 build_project

执行 Hvigor 构建，生成 HAP 包。AI 在写完代码后，会调用此工具进行编译，如果编译失败，会自动读取错误日志并尝试修复，然后重新构建。

4.2 start_app

将构建产物安装到模拟器或真机，并启动应用。这是实现“推包运行”闭环的关键工具。

4.3 hdc_log

收集设备日志，帮助 AI 分析运行时错误。在出现崩溃时，AI 可以自动抓取日志，定位问题。

4.4 verify_ui

这是 DevEco Code 最具特色的能力之一。它允许 AI 在模拟器或真机上自动执行 UI 操作，并通过多模态模型判断 UI 显示和交互逻辑的正确性，最后生成问题报告。例如，AI 可以自动滑动页面、点击按钮，然后判断画面是否符合预期。

UI 意图验证的意义：传统 AI 编码工具只能保证代码通过编译，无法保证应用运行后的界面和交互符合需求。DevEco Code 借助 verify_ui 补齐了“代码运行态的功能验证”，让 AI 真正做到“自己写完、自己跑一遍、自己检查”。

4.5 check_ets_files

对 ArkTS 文件进行静态语法检查，帮助 AI 在编译前发现潜在语法错误。

4.6 arkts_knowledge_search

内置 HarmonyOS 官方知识库，支持自然语言查询。当 AI 需要查阅 API 用法、组件属性、最佳实践时，会调用此工具获取权威信息，确保生成代码的准确性。

4.7 switch_cwd

切换当前工作目录。在多模块项目中，AI 可能需要切换到不同模块目录进行构建，此工具使其能够灵活操作。

五、模型配置与 DeepSeek 接入

DevEco Code 内置了免费的 GLM-5.1 模型，但可能会有速率限制（默认每分钟 50 次请求）且响应速度较慢。对于中高强度使用，建议接入第三方模型，如 DeepSeek、OpenAI 等。下面详细介绍模型配置方法。

5.1 查看与切换模型

在 DevEco Code 交互界面中，输入 /models 命令可进入模型配置界面。该界面会列出当前可用的模型，以及 Provider 选择入口。

5.2 配置 Provider

按 Ctrl+A 可进入 Provider 选择界面，在这里可以配置支持的第三方模型 Provider。具体操作步骤参考下文 DeepSeek 接入示例。

5.3 通过 deveco.jsonc 配置文件

DevEco Code 的 Agent 配置完全兼容 OpenCode 的配置体系。你可以在项目根目录或用户目录下创建 deveco.jsonc 配置文件，手动指定 Provider 和模型参数。以下为示例配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deveco": {
      "name": "DevEco Code",
      "models": {
        "glm-5": {
          "tool_call": true,
          "limit": {
            "context": 200000,
            "output": 8192
          }
        }
      },
      "options": {
        "baseURL": "https://api.openbitfun.com/v1",
        "apiKey": "{env:DEVECO_API_KEY}"
      }
    }
  }
}

这个配置示例展示了如何定义 Provider 名称、模型参数（上下文长度、输出长度）、API 地址和密钥引用方式。其中 {env:DEVECO_API_KEY} 表示从环境变量 DEVECO_API_KEY 中读取密钥，避免明文泄露。

5.4 接入 DeepSeek 模型完整步骤

以下以接入 DeepSeek 平台模型为例，完整说明配置流程：

步骤 1：获取 API Key

访问 DeepSeek 开放平台（platform.deepseek.com），注册账号并创建 API Key。请妥善保管该 Key。

步骤 2：进入模型配置界面

在 DevEco Code 终端界面中输入 /models 命令，进入模型配置界面。

步骤 3：配置 Provider

按 Ctrl+A 进入 Provider 选择界面，选择“DeepSeek”或“自定义 Provider”。界面会提示输入 API Key，将第一步复制的 Key 粘贴进去，回车确认。

步骤 4：切换到指定模型

返回 /models 界面，选择刚配置的 DeepSeek 模型（例如 deepseek-v4-pro），即可完成切换。

步骤 5：验证配置

在对话界面输入任意指令，例如 你好，如果能够正常返回，说明 DeepSeek 模型接入成功。

注意：上述步骤中的界面操作可能存在版本差异，但总体流程一致。若配置失败，请检查 API Key 是否正确、网络是否可达、Provider 是否支持 OpenAI 兼容接口。

5.5 多模型灵活切换

DevEco Code 支持任意 OpenAI 兼容 Provider，因此除了 DeepSeek，还可以接入 OpenAI、GLM 等模型。通过 /models 界面和 deveco.jsonc 配置文件，开发者可以根据需要灵活切换。

六、工程化体系：Harness 与 TRACE 框架

DevEco Code 之所以在 HarmonyOS 开发场景中表现出色，背后离不开一套名为 Harness 的系统化工程框架，以及 TRACE 归因分析框架。

6.1 Harness：可运行的鸿蒙应用开发系统

Harness 将 Agent 角色、工具调用、领域知识、构建与真机反馈及轨迹分析整合为一个可运行、可观察、可迭代的 HarmonyOS 应用开发系统。它定义了不同 Agent 的职责与协作边界，管理 HarmonyOS 领域的 Skills、Tools、知识库及 ArkTS/ArkUI 代码生成能力。

Harness 的核心价值在于：将“调一句提示词”升级为“优化一组可评测的工程资产”。它将模型调用、构建结果、日志与验证结果记录下来，支撑问题复盘与失败归因，使得 DevEco Code 的能力可以持续迭代优化。

6.2 TRACE：量化归因 Coding Agent 轨迹

TRACE 框架通过量化归因 Coding Agent 的轨迹，识别规划、检索等维度的干扰因子，锁定系统 Prompt、RAG 检索、模型、Skills/Tools 设计及 Agent 循环控制五大变量，实现自动化策略迭代。

TRACE 的思路是：沿“大锅乱炖 → 食谱炒菜 → 食谱管理”路径，结合 Eval、Gate、Release 闭环，将直觉式“炼丹”转为可复用沉淀的工程体系，系统性破解组合爆炸难题，提升鸿蒙应用的编译准确率与任务完成率。

6.3 实测效果

根据华为公布的数据，在相同任务下，DevEco Code 结合 GLM 5.1 模型，相比 OpenCode 加 DeepSeek-V4-Pro 等组合方案，在编译成功率和任务完成率两个核心指标上均实现明显提升。其中：

  • 编译成功率提升至 80% 以上。
  • 任务完成率突破 60%。

此外，代码修复 Agent 的故障修复成功率超过 80%，可实现分钟级自主修复。

七、Skills 插件体系与场景化能力

DevEco Code 提供覆盖鸿蒙应用开发全旅程的精品 Skills 和工具，按需加载。这些 Skills 封装了 HarmonyOS 开发的最佳实践，涵盖以下阶段：

  • 项目创建：如 deveco-create-project，用于从零创建 HarmonyOS 工程。
  • 开发：如 ArkTS 语法标准、ArkUI 知识库相关 Skills。
  • 修复：如 arkts-error-fixes（ArkTS 语法错误修复）、runtime-fix（运行时问题修复）。
  • 验证：如 UI 意图校验、模拟器运行应用。
  • 测试：单元测试生成、集成测试辅助。
  • 调优：性能分析、代码优化建议。
  • 运维：DFX 日志分析、故障定位。

通过 Skills 插件体系，DevEco Code 可以调用“专家经验”，降低鸿蒙开发门槛，让开发者少走弯路。

7.1 UI 意图验证工具（verify_ui）实践

UI 意图验证工具解决了缺陷修复流程中的痛点：过去 AI 修复缺陷后，只有编译构建通过才能校验，实际功能有效性无法确认，需要人工复测。DevEco Code 通过 verify_ui 实现全流程自动化闭环：

  1. 代码编译。
  2. 模拟器运行应用。
  3. 自动操作 UI。
  4. 多模态模型判断功能正确性。
  5. 生成报告，如发现缺陷则再次修复并循环。

这使得重复性验证工作自动化落地，减少开发者的重复劳动。

7.2 代码修复 Agent

DevEco Code 内置代码修复 Agent，自动诊断语法错误、编译构建错误、运行崩溃和运行时功能问题。例如，当应用运行时崩溃，Agent 会自动捕获日志，覆盖十余类代码崩溃问题，定位根因并修复。官方数据称故障修复成功率超过 80%，分钟级自主修复。

八、实战示例：从自然语言到运行应用

以下通过几个典型场景，展示 DevEco Code 的使用方式。

8.1 从零创建工程

在终端中启动 DevEco Code 后，输入：

帮我从零创建一个 HarmonyOS 工程，包含一个首页和一个设置页

DevEco Code 会：

  1. 调用 deveco-create-project Skill 创建工程骨架。
  2. 编写首页和设置页的 ArkTS 代码。
  3. 调用 build_project 执行编译。
  4. 调用 start_app 在模拟器或真机上运行应用。

整个过程中，开发者只需等待结果或确认关键步骤。

8.2 增量开发页面

如果已有工程，需要新增一个登录页面，可以输入：

在现有项目中新增一个登录页面，包含账号输入框、密码输入框和登录按钮。

DevEco Code 会：

  1. 分析现有项目结构。
  2. 创建对应的 .ets 文件。
  3. 编写 ArkUI 代码，使用 @State 状态变量管理输入。
  4. 执行 check_ets_files 语法检查。
  5. 如有错误，自动修复。
  6. 调用 build_project 编译验证。

8.3 修复编译报错

如果项目出现编译错误，可以直接将错误信息或相关文件交给 DevEco Code：

当前项目编译失败，错误信息：Type 'string' is not assignable to type 'number'，请修复。

DevEco Code 会调用代码修复 Agent，分析错误原因，修改代码，然后重新构建验证。

8.4 UI 功能验证

假设 AI 完成了一个登录功能，但需要确认按钮点击后能否正确跳转。可以输入：

验证登录页面：输入账号 test、密码 123456，点击登录按钮，应该跳转到首页。

DevEco Code 会：

  1. 启动应用。
  2. 通过 verify_ui 工具模拟输入和点击。
  3. 截图并判断跳转结果。
  4. 输出验证报告。

这种能力让功能验收从人工操作变为自动化，极大提升效率。

8.5 Goal 模式全自动交付

如果有一个明确的需求文档（Spec），例如要求“实现一个待办事项列表页面，支持添加和删除”。使用 Goal 模式，开发者只需提供 Spec 文档和验收标准，DevEco Code 将自动完成：

  1. 需求分析和任务拆解。
  2. 架构设计。
  3. 代码生成。
  4. 语法检查、编译打包。
  5. 部署到模拟器。
  6. 功能自验证（添加、删除等操作）。
  7. 发现问题自动修复，重新构建部署验证。
  8. 直到满足验收标准。

整个过程几乎无需人工干预，开发者只需最终确认结果。

九、DevEco Code 与 DevEco CodeGenie 的关系

在部分旧资料（如华为云社区 2024 年发布的博客）中，出现过 DevEco CodeGenie 的名称。它可能指的是 DevEco Studio 早期内置的智能编程助手插件，通过 IDE 界面提供代码生成、注释、问答等功能。而本文所讲的 DevEco Code 是 2026 年发布的独立命令行 AI Agent 工具，与前者不是同一个产品。

二者的核心区别：

  • DevEco CodeGenie：集成在 DevEco Studio 内部，通过图形界面交互，侧重于代码补全、注释生成、知识问答等 IDE 内辅助功能。
  • DevEco Code：独立的终端工具，采用对话式 AI Agent 形态，能够自主调用构建、部署、验证等能力，实现全流程自动化。

随着 DevEco Code 的发布，华为的 AI 编程策略从“IDE 内辅助”升级为“Agent 级自动驾驶”。开发者可以根据自身习惯和场景选择合适的工具。

十、总结与展望

DevEco Code 的发布标志着 HarmonyOS 开发正式迈入 AI-Native 时代。它并非简单地在 IDE 中嵌入聊天窗口，而是以 Agent 形态深度介入开发全流程——从项目创建、代码编写、编译构建，到真机运行与调试，AI 都能自主完成。

核心优势：

  1. 开箱即用：无需额外配置 AI 环境，安装即可使用，独立开发者也能快速上手。
  2. HarmonyOS 原生集成：基于 OpenCode 深度定制，完美适配 ArkTS 语法、Hvigor 构建体系和 hdc 设备调试。
  3. 三种 Agent 模式：Build（编码执行）、Plan（方案规划）、Goal（端到端自动驾驶），覆盖不同开发阶段。
  4. 多模型灵活切换：支持 DeepSeek、OpenAI、GLM 等任意 OpenAI 兼容 Provider。
  5. 70+ Skill 插件体系：多设备适配、崩溃修复、元服务生成、单元测试等场景化能力可按需加载。
  6. 开源开放：基于 OpenCode 开源项目扩展，社区驱动持续迭代。

无论你是 HarmonyOS 新手还是资深开发者，DevEco Code 都能显著提升开发效率。现在就可以通过一条命令开始体验：

npm install -g @deveco/deveco-code

随着 HarmonyOS 生态的持续壮大，DevEco Code 及其背后的 Harness、TRACE 框架还将不断进化，为开发者提供更智能、更可靠的开发体验。未来的鸿蒙应用开发，或许真的只需要一句需求描述，剩下的交给 AI。

# harmonyos # 华为
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

我用 NVIDIA SkillSpector 纯静态扫了一遍 GitHub 最火的 agent skills：能挖出多少注入？0 个

avatar 龙虾开发者社区
cover

周榜换血九成，Agent Skills 星数翻倍

avatar 龙虾开发者社区

写给 TypeScript 工程师的 OpenClaw.NET 上手指南：用你熟悉的 TS 思维，跑起一个生产级 AI Agent

读代码层：TS 和 C# 本来就是「远房亲戚」——asyncawait??、接口、泛型、严格空检查，你的心智模型几乎无缝平移。真正要适应的只有两件事：类型是具名而非结构化的（多一句显式声明），以及 NativeAOT 下的「禁反射」约束。写扩展层：你甚至可以不怎么碰 C#——Node.js 插件桥意味着你的 TypeScript 插件就是一等公民，而且能在生产 aot 车道跑。内核给你 .NET

avatar 龙虾开发者社区