【共创季稿事节】HarmonyOS 7.0 时代的新基建 ：DevEco CLI + Claude Code，鸿蒙 AI 开发的黄金搭档

引言：当 AI 编程助手遇见鸿蒙——水土不服的困局

AI 编程助手已成为开发者日常工具箱中的标配，但当尝试用它们开发 HarmonyOS 应用时，问题便会接踵而至：通用大模型不认识 ArkTS 语法，看不懂 @Entry 和 @Component 装饰器；无法调用 hdc 命令与设备通信；不理解 Hvigor 构建流程和 ohpm 包管理机制；面对多设备调试、权限配置、签名打包等鸿蒙特有环节更是束手无策。

DevEco CLI 正是为消解这一鸿沟而生。它并非又一款 AI 助手，而是一座“能力桥梁”——将 HarmonyOS 工程创建、编译构建、设备调试、模拟器管理、日志诊断、文档检索等全链路开发能力统一封装为命令行工具，让 任何 AI Agent（Claude Code、OpenCode、Cursor、Trae-CN 等）都能直接调用。

---

一、DevEco CLI 是什么？

DevEco CLI（@deveco/deveco-cli）是华为在 HDC 2026 期间随 HarmonyOS 7.0（API 26）正式发布的命令行开发工具集。它将 DevEco Studio 工具链统一封装为一个 CLI，内置 ohpm、hvigor、hdc、emulator（模拟器）、hilog（日志），同时集成 HarmonyOS 技能（Skill）安装、项目脚手架、本地文档检索和 MCP 服务，为第三方 AI Agent 提供标准化的鸿蒙开发能力调用接口。

与 DevEco Code 的关系

两者在鸿蒙 AI 开发体系中各自承担不同角色：

用户意图 → DevEco Code（AI 大脑：思考、规划、生成、验证）
                ↓ 调用
           DevEco CLI（工程手脚：创建项目、编译构建、部署运行、日志诊断）

维度	DevEco CLI	DevEco Code
角色	被调用的“能力工具箱”	主动执行的“AI Agent”
交互方式	命令行参数 + MCP 协议	自然语言对话
AI 能力	不含 AI，纯工具封装	内置大模型，自主推理与编码
目标用户	已有 AI Agent 的团队	独立开发者、希望开箱即用的团队
核心价值	让第三方 AI Agent 获得鸿蒙开发能力	一站式 AI-Native 鸿蒙开发体验

简言之：DevEco CLI 是给 AI Agent 配的“鸿蒙瑞士军刀”，DevEco Code 是自带 AI 大脑的“自动驾驶司机”。

项目信息

• npm 包名：@deveco/deveco-cli（v1.0.0）
• 开源地址：https://gitcode.com/openharmony-sig/deveco-cli
• 协议：Apache 2.0
• 运行环境：macOS / Windows，Node.js ≥ 18（推荐 22+）

---

二、环境准备与安装

前置条件

要求	说明
操作系统	macOS 或 Windows（目前不支持 Linux）
Node.js	≥ 18，推荐 22+
DevEco Studio	≥ 6.1.0（macOS 需安装在 /Applications 或 ~/Applications；Windows 默认路径 C:\Program Files\Huawei\DevEco Studio）

验证环境：

node -v          # 确认 Node.js 版本 ≥ 18
npm -v           # 确认 npm 可用
devecocli --version   # 安装后验证 CLI 版本

安装

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

# 升级到最新版本
devecocli update

---

四、核心命令详解

4.1 工程创建：create

# 最简创建
devecocli create --app-name MyApp

# 完整参数
devecocli create \
  --project-path ./MyApp \
  --app-name MyApp \
  --bundle-name com.acme.myapp \
  --api-level 23

执行后生成标准的 HarmonyOS 工程结构，包含 entry 模块、AppScope、build-profile.json5、oh-package.json5 等完整配置。

4.2 构建打包：build

# 默认构建（debug 模式）
devecocli build

# Release 构建
devecocli build --build-mode release

# 指定模块构建
devecocli build --modules entry library

# 清理构建产物后重新构建
devecocli build clean

构建产出包括 .hap（应用包）、.hsp（共享包）、.har（静态库）、.app（应用包集合）。

4.3 部署运行：run

# 构建、安装、启动一站式
devecocli run

# 指定目标设备
devecocli run --device 127.0.0.1:5555

# Release 模式 + 先卸载旧版
devecocli run --build-mode release --uninstall

4.4 设备管理：device

devecocli device list                    # 列出所有已连接设备
devecocli device view -t 127.0.0.1:5555  # 查看指定设备详情

4.5 模拟器管理：emulator

完整的模拟器生命周期管理：

# 查看已安装的模拟器
devecocli emulator list

# 下载系统镜像
devecocli emulator image download --device-type phone --os-version "HarmonyOS 6.0.1(21)"

# 创建模拟器实例
devecocli emulator create MyPhone --device-type phone --os-version "HarmonyOS 6.0.1(21)"

# 启动 / 停止 / 删除
devecocli emulator start MyPhone
devecocli emulator stop MyPhone
devecocli emulator delete MyPhone

# 首次使用需接受许可协议
devecocli emulator license accept

4.6 日志诊断：log

# 查看 Error 级别日志
devecocli log --level E

# 按应用包名过滤崩溃日志
devecocli log --crash --bundle-name com.example.app

# 实时追踪（类似 tail -f）+ 关键词过滤
devecocli log --follow --keyword Init

# 查看最近 5 分钟的日志，限制 100 条
devecocli log --from 5m --tail 100

4.7 文档检索：docs

将 2000+ 万字的鸿蒙官方文档本地化，支持全文检索：

# 搜索关键词
devecocli docs search List
devecocli docs search "@State @Prop" --catalog harmonyos-guides --limit 10

# 阅读指定文档
devecocli docs read harmonyos-guides/application-models/arkts-page-start-overview

# 查看文档目录
devecocli docs catalog

---

五、Skills 技能市场

DevEco CLI 内置了 HarmonyOS 技能市场，提供由社区和官方维护的精品 Skills。Skill 本质上是“专家经验包”——告诉 AI Agent 在特定场景下如何操作。

# 列出所有可用 Skills
devecocli skills list --long

# 搜索特定领域的 Skill
devecocli skills find deveco

# 安装 Skill 到指定 AI Agent
devecocli skills add --skill deveco-cli --agent agentname  

# 移除 Skill
devecocli skills remove --skill skillname  

---

七、接入 Claude Code（完整实战）

本节将详细演示如何通过 DevEco CLI 将鸿蒙开发能力接入 Claude Code。DevEco CLI 的 init 命令能够自动完成配置，整个过程简洁高效。

7.1 前置确认

# 确保 DevEco CLI 已安装
devecocli --version

# 确保 Claude Code 已安装
claude --version

7.2 自动配置

DevEco CLI 的 init 命令可以自动检测并配置 Claude Code：

# 进入你的 HarmonyOS 项目目录
cd your-harmonyos-project

# 1. 给 Claude Code 安装 deveco-cli 技能
devecocli init --agent claude-code

# 2. 给 Claude Code 在当前 HarmonyOS 项目配置 MCP
devecocli init --mcp --agent claude-code --project ./

# 3. 进入项目并启动 Claude Code
claude

1. 给 Claude Code 安装 deveco-cli 技能
   

2. 给 Claude Code 在当前 HarmonyOS 项目配置 MCP
   

7.5 验证接入是否成功

进入 Claude Code 后，分别执行以下两条指令验证技能和 MCP 是否配置成功：

• 输入 /skills 验证 skills 是否安装
  

• 输入 /mcp 验证 MCP 服务是否启用
  

7.6 Claude Code + DevEco CLI 典型工作流

接入完成后，你就可以在 Claude Code 中用自然语言驱动鸿蒙开发，示例如下：

# 场景一：创建新工程
> 帮我创建一个 HarmonyOS 项目，包名 com.example.shop，包含一个商品列表页

# 场景二：构建与运行
> 用 release 模式构建当前项目，然后在我的模拟器上运行

# 场景三：日志排查
> 查看这个应用最近 10 分钟的 Error 级别日志，帮我分析崩溃原因

# 场景四：语法检查
> 检查 src/main/ets/pages/ 下所有 .ets 文件的语法问题

# 场景五：文档查询
> 查询 ArkUI 中 @State 和 @Prop 装饰器的官方用法和区别

实际效果如下（日志排查示例）：
在 Claude 中输入“查看这个应用最近 10 分钟的 Error 级别日志，帮我分析崩溃原因”

Claude Code + DevEco CLI 的组合实现了 AI 负责思考与决策 → MCP 鸿蒙相关工具调用 → Skills 注入领域知识 → 持续验证迭代 的完整闭环。

---

九、总结

DevEco CLI 并非又一个需要你改变工作习惯的新工具，而是一个适配层——它让你已经熟悉的 AI Agent（无论是 Claude Code、OpenCode 还是 Cursor）获得鸿蒙开发的专业能力。其核心价值体现在：

1. 能力封装：将 DevEco Studio 工具链（hvigor / hdc / ohpm / emulator / hilog）统一为简洁的命令行接口，AI Agent 无需理解底层复杂性即可直接调用。

2. MCP 标准化：通过 Model Context Protocol 提供符合行业标准的工具接口，与 Claude Code 等主流 AI Agent 无缝对接。

3. 知识注入：2000+ 万字鸿蒙官方文档本地化，可通过 docs 命令检索，也可作为 Skill 注入 AI Agent 的上下文，大幅提升回答的准确性。

4. 技能生态：内置 Skills 市场，社区可贡献更多场景化专家经验包（多设备适配、崩溃定位、元服务开发等），持续丰富 AI 助手的能力边界。

5. 团队友好：项目级 .mcp.json 可提交到 Git，团队成员拉取代码后即可获得相同的鸿蒙 AI 开发环境，保证协作一致性。

总而言之，DevEco CLI 为 AI 驱动的鸿蒙开发提供了坚实的能力底座，让开发者可以更专注于业务创新，而将繁琐的工具链调用与知识检索交给 AI 和 CLI 去完成。

---

参考来源：

• 【工具推荐】HarmonyOS AI开发提效工具：DevEco Code & DevEco CLI - 华为开发者论坛
• DevEco CLI - OpenHarmony SIG
• DevEco Code - OpenHarmony SIG
• DevEco CLI（@deveco/deveco-cli）- npm