前言DevEco Code是一款面向HarmonyOS应用开发的AI Agent工具基于华为BitFun技术与开源OpenCode构建不仅保留OpenCode的终端交互、配置Model/Provider/MCP/Skill等能力还集成HarmonyOS精品Skills、DevEco Studio开发工具链和HarmonyOS知识库从而支持代码编写、编译构建、运行调试、ArkTS问题修复及文档查阅等功能。快速开始# 1. 安装npminstall-gdeveco/deveco-code# 2. 启动deveco# 3. 开始对话 —— 在终端中直接描述你的 HarmonyOS 开发需求提示词示例 - 解释一下代码库的架构 - 帮我重构login_check这个函数 - 帮我检查并修复语法错误建议使用 npm 官方源 或 淘宝镜像源 安装其他镜像源可能因同步延迟导致安装失败或版本滞后。如需编译构建、设备运行等能力请先安装 DevEco Studio 并配置DEVECO_HOME环境变量。简介DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。DevEco Code 基于开源项目 OpenCode 扩展开发保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。支持平台DevEco Code 当前通过 npm 提供以下平台安装包平台架构说明Windowsx64Windows 11macOSarm64Apple SiliconM 系列芯片macOSx64IntelIntel 芯片 Mac暂不支持 Linux。HarmonyOS 编译构建、模拟器与真机调试依赖 DevEco Studio且目前仅提供 Windows 与 macOS 版本。推荐配置操作系统WindowsWindows 11 22H2 及以上macOSmacOS 15 Sequoia 及以上硬件日常使用短会话、单模块改动、以对话与代码编辑为主8 GB 及以上内存重度使用大工程、长会话、频繁编译构建与模拟器/真机调试16 GB 及以上内存建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间运行时与工具链Node.js22 及以上DevEco Studio6.1 及以上编译构建、Hvigor、HDC、模拟器/真机运行已配置DEVECO_HOME环境变量指向 DevEco Studio 安装目录终端 ShellWindowsPowerShell 7推荐、Windows PowerShell 5.1macOSZsh推荐、Bash网络需要稳定的互联网连接华为账号登录、模型调用、HarmonyOS 知识库检索等安装前置DevEco Code 通过 npm 分发安装前请先准备以下环境安装 Node.js推荐使用 22 及更高版本可选安装 DevEco Studio推荐使用 6.1 及更高版本若不安装HarmonyOS 应用构建、推包等工具将无法使用可选配置DEVECO_HOME环境变量指向 DevEco Studio 安装目录默认路径示例macOS/Applications/DevEco-Studio.appWindowsC:\Program Files\Huawei\DevEco Studio可先在终端验证 Node.js 环境node-vnpm-v安装与卸载安装npminstall-gdeveco/deveco-code查看版本、启动deveco--versiondeveco更新deveco upgrade卸载运行时数据与全局包deveco uninstallnpmuninstall-gdeveco/deveco-code登录与登出使用 DevEco Code 需先通过华为账号登录。首次执行deveco时会在终端内引导完成登录也可单独执行登录命令deveco auth login登出会清除当前华为账号的本地登录状态下次启动需重新登录。执行deveco authlogout模型配置登录后可使用 DevEco Code 提供的免费模型通道。在 DevEco Code 中输入/models可进入模型配置界面。当前免费提供GLM-5.1模型单账号默认每分钟 50 次请求。也可以通过/connect进入 Provider 选择界面配置支持的第三方模型。也可以通过deveco.jsonc配置模型{ $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} } } } }UI 检查配置UI 检查是功能验证阶段的可选能力用于验证界面是否符合需求描述。该功能需调用多模态模型仅用于 UI 检查不作为主对话模型已登录账号时默认使用内置 Qwen3-VL 模型未登录时则跳过 UI 检查。如需配置第三方多模态模型仅支持 Qwen 系列可在deveco.jsonc的agent中指定以qwen3-vl-plus为例{ $schema: https://opencode.ai/config.json, provider: { myprovider: { npm: ai-sdk/openai-compatible, name: alibaba, options: { baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1, apiKey: your-api-key, }, models: { qwen3-vl-plus: { modalities: { input: [text, image], output: [text], }, }, }, }, }, agent: { ui_verification: { mode: subagent, model: myprovider/qwen3-vl-plus, // 格式为provider-name/model-name hidden: true, }, }, }配置文件读取优先级项目目录下.deveco/deveco.jsonc项目目录下deveco.jsonc用户目录下.config/deveco/deveco.jsoncAgent 配置DevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置按Tab键切换Build默认模式适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行Plan适合需求拆解、技术方案、发布规划、测试规划和文档生成Goal适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付HarmonyOS 场景能力DevEco Code 集成了常用 HarmonyOS 开发工具能力工具说明build_project执行编译构建并导出构建产物start_app在模拟器或真机上运行应用hdc_log收集/清理设备日志/查看连接模拟器verify_ui执行 UI 操作验证功能是否正确arkts_checkArkTS 静态语法检查arkts_knowledge_searchHarmonyOS 知识搜索switch_cwd切换构建项目路径常见场景包括从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。扩展能力DevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。新增或修改 Skill、MCP、Plugin 配置后需退出并重新执行deveco启动后才会生效。Skillsnpx skillsaddvercel-labs/agent-skills也可以把 Skill 放到~/.config/deveco/skills目录。MCP可在~/.config/deveco/deveco.jsonc中配置 MCP{ $schema: https://opencode.ai/config.json, mcp: { playwright: { type: local, command: [npx, playwright/mcplatest], enabled: true } } }Pluginsnpminstall-goh-my-opencode然后在deveco.jsonc中配置插件入口{ plugin: [ node_modules/oh-my-opencode/dist/index.js ] }从 OpenCode 迁移如果需要从 OpenCode 迁移到 DevEco Code请将配置文件迁移到 DevEco Code 目录。主配置文件可参考# Windows PowerShellCopy-Item-Force{源路径}\opencode.jsonc~\.config\deveco\deveco.jsonc# macOScp{源路径}/opencode.jsonc ~/.config/deveco/deveco.jsoncSkills、Agents、Plugins 也可以迁移到~/.config/deveco下的对应目录MCP 配置项可迁移到deveco.jsonc中。参与贡献欢迎贡献请在提交 Pull Request 前阅读 CONTRIBUTING.md。帮助与支持完整文档请参阅 DevEco Code 使用文档需下载到本地后打开也可在线阅读 OpenCode TUI 文档常见问题请参阅 FAQ 文档反馈与交流 GitCode Issue