【共创季稿事节】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 版本 ≥ 18npm-v# 确认 npm 可用devecocli--version# 安装后验证 CLI 版本安装
# 全局安装（推荐）npminstall-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-level23执行后生成标准的 HarmonyOS 工程结构，包含entry模块、AppScope、build-profile.json5、oh-package.json5等完整配置。
4.2 构建打包：build
# 默认构建（debug 模式）devecocli build# Release 构建devecocli build --build-mode release# 指定模块构建devecocli build--modulesentry library# 清理构建产物后重新构建devecocli build clean构建产出包括.hap（应用包）、.hsp（共享包）、.har（静态库）、.app（应用包集合）。
4.3 部署运行：run
# 构建、安装、启动一站式devecocli run# 指定目标设备devecocli run--device127.0.0.1:5555# Release 模式 + 先卸载旧版devecocli run --build-mode release--uninstall4.4 设备管理：device
devecocli device list# 列出所有已连接设备devecocli device view-t127.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 accept4.6 日志诊断：log
# 查看 Error 级别日志devecocli log--levelE# 按应用包名过滤崩溃日志devecocli log--crash--bundle-name com.example.app# 实时追踪（类似 tail -f）+ 关键词过滤devecocli log--follow--keywordInit# 查看最近 5 分钟的日志，限制 100 条devecocli log--from5m--tail1004.7 文档检索：docs
将 2000+ 万字的鸿蒙官方文档本地化，支持全文检索：
# 搜索关键词devecocli docs search List devecocli docs search"@State @Prop"--catalogharmonyos-guides--limit10# 阅读指定文档devecocli docsreadharmonyos-guides/application-models/arkts-page-start-overview# 查看文档目录devecocli docs catalog五、Skills 技能市场
DevEco CLI 内置了 HarmonyOS 技能市场，提供由社区和官方维护的精品 Skills。Skill 本质上是“专家经验包”——告诉 AI Agent 在特定场景下如何操作。
# 列出所有可用 Skillsdevecocli skills list--long# 搜索特定领域的 Skilldevecocli skillsfinddeveco# 安装 Skill 到指定 AI Agentdevecocli skillsadd--skilldeveco-cli--agentagentname# 移除 Skilldevecocli skills remove--skillskillname七、接入 Claude Code（完整实战）
本节将详细演示如何通过 DevEco CLI 将鸿蒙开发能力接入 Claude Code。DevEco CLI 的init命令能够自动完成配置，整个过程简洁高效。
7.1 前置确认
# 确保 DevEco CLI 已安装devecocli--version# 确保 Claude Code 已安装claude--version7.2 自动配置
DevEco CLI 的init命令可以自动检测并配置 Claude Code：
# 进入你的 HarmonyOS 项目目录cdyour-harmonyos-project# 1. 给 Claude Code 安装 deveco-cli 技能devecocli init--agentclaude-code# 2. 给 Claude Code 在当前 HarmonyOS 项目配置 MCPdevecocli init--mcp--agentclaude-code--project./# 3. 进入项目并启动 Claude Codeclaude给 Claude Code 安装 deveco-cli 技能
给 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）获得鸿蒙开发的专业能力。其核心价值体现在：
能力封装：将 DevEco Studio 工具链（hvigor / hdc / ohpm / emulator / hilog）统一为简洁的命令行接口，AI Agent 无需理解底层复杂性即可直接调用。
MCP 标准化：通过 Model Context Protocol 提供符合行业标准的工具接口，与 Claude Code 等主流 AI Agent 无缝对接。
知识注入：2000+ 万字鸿蒙官方文档本地化，可通过
docs命令检索，也可作为 Skill 注入 AI Agent 的上下文，大幅提升回答的准确性。技能生态：内置 Skills 市场，社区可贡献更多场景化专家经验包（多设备适配、崩溃定位、元服务开发等），持续丰富 AI 助手的能力边界。
团队友好：项目级
.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
