【共创季稿事节】HarmonyOS 7.0 时代的新基建 DevEco CLI Claude Code鸿蒙 AI 开发的黄金搭档引言当 AI 编程助手遇见鸿蒙——水土不服的困局AI 编程助手已成为开发者日常工具箱中的标配但当尝试用它们开发 HarmonyOS 应用时问题便会接踵而至通用大模型不认识 ArkTS 语法看不懂Entry和Component装饰器无法调用hdc命令与设备通信不理解Hvigor构建流程和ohpm包管理机制面对多设备调试、权限配置、签名打包等鸿蒙特有环节更是束手无策。DevEco CLI正是为消解这一鸿沟而生。它并非又一款 AI 助手而是一座“能力桥梁”——将 HarmonyOS 工程创建、编译构建、设备调试、模拟器管理、日志诊断、文档检索等全链路开发能力统一封装为命令行工具让任何 AI AgentClaude Code、OpenCode、Cursor、Trae-CN 等都能直接调用。一、DevEco CLI 是什么DevEco CLIdeveco/deveco-cli是华为在 HDC 2026 期间随 HarmonyOS 7.0API 26正式发布的命令行开发工具集。它将 DevEco Studio 工具链统一封装为一个 CLI内置ohpm、hvigor、hdc、emulator模拟器、hilog日志同时集成 HarmonyOS 技能Skill安装、项目脚手架、本地文档检索和MCP 服务为第三方 AI Agent 提供标准化的鸿蒙开发能力调用接口。与 DevEco Code 的关系两者在鸿蒙 AI 开发体系中各自承担不同角色用户意图 → DevEco CodeAI 大脑思考、规划、生成、验证 ↓ 调用 DevEco CLI工程手脚创建项目、编译构建、部署运行、日志诊断维度DevEco CLIDevEco Code角色被调用的“能力工具箱”主动执行的“AI Agent”交互方式命令行参数 MCP 协议自然语言对话AI 能力不含 AI纯工具封装内置大模型自主推理与编码目标用户已有 AI Agent 的团队独立开发者、希望开箱即用的团队核心价值让第三方 AI Agent 获得鸿蒙开发能力一站式 AI-Native 鸿蒙开发体验简言之DevEco CLI 是给 AI Agent 配的“鸿蒙瑞士军刀”DevEco Code 是自带 AI 大脑的“自动驾驶司机”。项目信息npm 包名deveco/deveco-cliv1.0.0开源地址https://gitcode.com/openharmony-sig/deveco-cli协议Apache 2.0运行环境macOS / WindowsNode.js ≥ 18推荐 22二、环境准备与安装前置条件要求说明操作系统macOS 或 Windows目前不支持 LinuxNode.js≥ 18推荐 22DevEco Studio≥ 6.1.0macOS 需安装在/Applications或~/ApplicationsWindows 默认路径C:\Program Files\Huawei\DevEco Studio验证环境node-v# 确认 Node.js 版本 ≥ 18npm-v# 确认 npm 可用devecocli--version# 安装后验证 CLI 版本安装# 全局安装推荐npminstall-gdeveco/deveco-clilatest# 升级到最新版本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 设备管理devicedevecocli device list# 列出所有已连接设备devecocli device view-t127.0.0.1:5555# 查看指定设备详情4.5 模拟器管理emulator完整的模拟器生命周期管理# 查看已安装的模拟器devecocli emulator list# 下载系统镜像devecocli emulator image download --device-type phone --os-versionHarmonyOS 6.0.1(21)# 创建模拟器实例devecocli emulator create MyPhone --device-type phone --os-versionHarmonyOS 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 searchState 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 项目配置 MCP7.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 SIGDevEco Code - OpenHarmony SIGDevEco CLIdeveco/deveco-cli- npm
【共创季稿事节】HarmonyOS 7.0 时代的新基建 :DevEco CLI + Claude Code,鸿蒙 AI 开发的黄金搭档
发布时间:2026/6/16 18:13:45
【共创季稿事节】HarmonyOS 7.0 时代的新基建 DevEco CLI Claude Code鸿蒙 AI 开发的黄金搭档引言当 AI 编程助手遇见鸿蒙——水土不服的困局AI 编程助手已成为开发者日常工具箱中的标配但当尝试用它们开发 HarmonyOS 应用时问题便会接踵而至通用大模型不认识 ArkTS 语法看不懂Entry和Component装饰器无法调用hdc命令与设备通信不理解Hvigor构建流程和ohpm包管理机制面对多设备调试、权限配置、签名打包等鸿蒙特有环节更是束手无策。DevEco CLI正是为消解这一鸿沟而生。它并非又一款 AI 助手而是一座“能力桥梁”——将 HarmonyOS 工程创建、编译构建、设备调试、模拟器管理、日志诊断、文档检索等全链路开发能力统一封装为命令行工具让任何 AI AgentClaude Code、OpenCode、Cursor、Trae-CN 等都能直接调用。一、DevEco CLI 是什么DevEco CLIdeveco/deveco-cli是华为在 HDC 2026 期间随 HarmonyOS 7.0API 26正式发布的命令行开发工具集。它将 DevEco Studio 工具链统一封装为一个 CLI内置ohpm、hvigor、hdc、emulator模拟器、hilog日志同时集成 HarmonyOS 技能Skill安装、项目脚手架、本地文档检索和MCP 服务为第三方 AI Agent 提供标准化的鸿蒙开发能力调用接口。与 DevEco Code 的关系两者在鸿蒙 AI 开发体系中各自承担不同角色用户意图 → DevEco CodeAI 大脑思考、规划、生成、验证 ↓ 调用 DevEco CLI工程手脚创建项目、编译构建、部署运行、日志诊断维度DevEco CLIDevEco Code角色被调用的“能力工具箱”主动执行的“AI Agent”交互方式命令行参数 MCP 协议自然语言对话AI 能力不含 AI纯工具封装内置大模型自主推理与编码目标用户已有 AI Agent 的团队独立开发者、希望开箱即用的团队核心价值让第三方 AI Agent 获得鸿蒙开发能力一站式 AI-Native 鸿蒙开发体验简言之DevEco CLI 是给 AI Agent 配的“鸿蒙瑞士军刀”DevEco Code 是自带 AI 大脑的“自动驾驶司机”。项目信息npm 包名deveco/deveco-cliv1.0.0开源地址https://gitcode.com/openharmony-sig/deveco-cli协议Apache 2.0运行环境macOS / WindowsNode.js ≥ 18推荐 22二、环境准备与安装前置条件要求说明操作系统macOS 或 Windows目前不支持 LinuxNode.js≥ 18推荐 22DevEco Studio≥ 6.1.0macOS 需安装在/Applications或~/ApplicationsWindows 默认路径C:\Program Files\Huawei\DevEco Studio验证环境node-v# 确认 Node.js 版本 ≥ 18npm-v# 确认 npm 可用devecocli--version# 安装后验证 CLI 版本安装# 全局安装推荐npminstall-gdeveco/deveco-clilatest# 升级到最新版本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 设备管理devicedevecocli device list# 列出所有已连接设备devecocli device view-t127.0.0.1:5555# 查看指定设备详情4.5 模拟器管理emulator完整的模拟器生命周期管理# 查看已安装的模拟器devecocli emulator list# 下载系统镜像devecocli emulator image download --device-type phone --os-versionHarmonyOS 6.0.1(21)# 创建模拟器实例devecocli emulator create MyPhone --device-type phone --os-versionHarmonyOS 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 searchState 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 项目配置 MCP7.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 SIGDevEco Code - OpenHarmony SIGDevEco CLIdeveco/deveco-cli- npm