简介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 版本。推荐系统配置项目要求操作系统Windows 11 22H2 及以上、macOS 15 Sequoia 及以上硬件日常使用 8 GB 内存重度使用 16 GB 内存建议预留 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 -v npm -v一键安装推荐使用 npm 官方源 或 淘宝镜像源 安装其他镜像源可能因同步延迟导致安装失败或版本滞后。npm install -g deveco/deveco-code查看版本deveco --version更新与卸载更新卸载deveco upgrade启动与登录在终端中执行以下命令启动 DevEco Codedeveco使用 DevEco Code 需先通过华为账号登录。首次执行deveco时会在终端内引导完成登录也可单独执行登录命令deveco auth login登录成功后可免费使用内置模型。登出会清除当前华为账号的本地登录状态下次启动需重新登录。执行deveco auth logoutHarmonyOS 开发能力Agent 模式在 DevEco Code 中输入/agents可查看所有可用的 Agent 模式按下 Tab 键可在不同模式之间快速切换。Build默认工程生成、代码生成、配置修正、测试执行、推包运行、发布执行Plan需求拆解、技术方案、发布规划、测试规划、文档生成Goal适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付开发工具工具说明build_project执行编译构建并导出构建产物start_app在模拟器/真机上运行应用hdc_log收集/清理设备日志、查看已连接模拟器verify_ui执行 UI 操作验证功能是否正确arkts_checkArkTS 静态语法检查arkts_knowledge_searchHarmonyOS 知识搜索switch_cwd切换构建项目路径内置 SkillSkill说明适用场景arkts-grammar-standardsArkTS 语法规则、TypeScript 迁移差异及 ArkUI 组件开发最佳实践参考ArkTS 语法规范、ArkUI 界面开发arkts-error-fixes编译与类型错误快速查询快速调试deveco-create-project快速创建标准化 HarmonyOS 模板工程项目初始化arkts-runtime-fix运行时常见问题修复方案稳定性保障典型应用场景创建新工程根据需求描述自动生成完整的 HarmonyOS 应用工程➕增量开发基于已有工程新增功能、页面、Tab 切换等编译错误修复自动分析编译错误并生成修复方案真机调试在 DevEco Studio 完成签名配置后支持真机部署与调试设计稿生成代码配置多模态模型后可基于设计稿图片自动生成界面代码Goal 模式Goal 模式包含5 个阶段需求分析 → 架构设计 → 任务分解 → 代码实现 → 功能验证。执行过程中在当前工程下新建.specs/目录每个需求依次生成spec.md、plan.md、tasks.md。切换模式按下Tab键可切换至 Goal 模式。模拟器 / 真机配置功能验证阶段需要配置模拟器或连接真机设备。参考 创建模拟器。ℹ未配置模拟器或真机设备时功能验证阶段仅执行编译验证。连接真机需确保工程已完成签名配置。UI 检查配置UI 检查是功能验证阶段的可选能力用于验证界面是否符合需求描述。功能验证阶段如需检查 UI设置环境变量ADDITIONAL_TOOL_GROUPSui_integration_test。macOSWindows# 添加到 Shell 配置文件如 ~/.zshrc、~/.bashrc export ADDITIONAL_TOOL_GROUPSui_integration_test多模态模型配置UI 检查已登录默认使用内置 Qwen3-VL未登录跳过 UI 检查自定义在deveco.jsonc配置仅支持 Qwen 系列{ $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, hidden: true } } }模型配置在 DevEco Code 中输入/models进入模型配置界面。使用免费模型当前免费提供GLM-5.1模型单账号默认每分钟 50 次请求。登录后即可使用无需额外配置。也可以通过/connect进入 Provider 选择界面配置支持的第三方模型。通过 Provider 配置在模型选择页面按/connect进入 Provider 界面选择提供商、输入 API Key、选择模型。通过配置文件编辑~/.config/deveco/deveco.jsonc不存在则新建。配置读取优先级.deveco/deveco.jsonc 项目目录deveco.jsonc~/.config/deveco/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} } } } }配置多模态模型多模态模型支持图片输入仅支持 Qwen 系列可通过以下方式配置界面配置/models → /connect → 选择提供商如 ZhipuAI、Alibaba→ 输入 API Key → 选择支持图片的模型配置文件在deveco.jsonc的 provider 中新增带modalities字段的模型配置多模态模型配置文件示例{ $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] } } } } } }常用配置配置绿灯模式启用后所有工具调用将自动执行无需逐次确认{ $schema: https://opencode.ai/config.json, permission: allow }生成 AGENTS.mdAGENTS.md是工程级别的上下文描述文件用于辅助 AI 理解项目结构与开发规范。建议在开始开发前生成该文件DevEco Code 将自动加载并用于提升代码生成的准确性与效率。Skill / MCP / 插件类型说明配置方式Skill全局技能定义支持目录放置、npx 安装、自定义创建~/.config/deveco/skills/MCP外部工具集成协议连接浏览器、数据库等第三方服务deveco.jsonc插件社区插件扩展如 Oh My OpenAgentnpm install -gdeveco.jsoncℹ新增或修改 Skill、MCP、Plugin 配置后需退出并重新执行deveco启动后才会生效。Skill 安装详情方式一目录放置将 Skill 文件放入~/.config/deveco/skills/重启后生效。方式二npx 安装npx skills add vercel-labs/agent-skills安装后存储在~/.agents/skills/目录。方式三使用 skill-creator在 DevEco Code 内使用内置skill-creator创建自定义 Skill。MCP 配置示例Playwright{ $schema: https://opencode.ai/config.json, mcp: { playwright: { type: local, command: [npx, playwright/mcplatest], enabled: true } } }插件配置示例Oh My OpenAgentnpm install -g oh-my-openagent在deveco.jsonc中配置插件入口文件路径{ plugin: [ node_modules/oh-my-openagent/dist/index.js ] }自定义命令支持 JSON 配置和 Markdown 文件两种方式定义自定义命令。{ }JSON 方式在deveco.jsonc的command字段中定义命令名、模板、描述、agent 和 model。Markdown 方式在~/.config/deveco/commands/或.deveco/commands/放置 .md 文件文件名即命令名。JSON 命令配置示例{ $schema: https://opencode.ai/config.json, command: { test: { template: Run the full test suite with coverage report..., description: Run tests with coverage, agent: build, model: deveco/glm-5.1 } } }在 TUI 中运行/test从 OpenCode 迁移至 DevEco Code按照以下对照表将 OpenCode 配置迁移至 DevEco Code。ℹ以下路径均相对于 DevEco Code 配置目录默认为~/.config/deveco/内容迁移目标路径支持 deveco.jsoncSkillsskills/✔Agentsagents/✔Pluginsplugins/✔MCP在deveco.jsonc中配置✔主配置deveco.jsonc—迁移命令示例SkillsAgentsPlugins主配置cp -r {源路径}/skills/* ~/.config/deveco/skills/最佳实践登录华为账号后可免费使用内置模型无需额外配置 API Key。推荐使用Build 模式执行日常开发任务以获得最佳体验。开始开发前建议先生成AGENTS.md以提升 AI 对项目的理解能力。真机调试需在 DevEco Studio 中预先完成应用签名配置。Windows 用户推荐使用 PowerShell 或 Windows Terminal避免终端兼容性问题。FAQ1. 安装时遇到网络问题或镜像源配置错误怎么办如果你在国内使用时遇到下载速度慢、连接超时或因配置了错误的下载源导致文件下载失败、下载内容不完整/不正确建议切换 npm 下载源方式一使用 npm 官方源npm config set registry https://registry.npmjs.org/方式二使用淘宝镜像源npm config set registry https://registry.npmmirror.com/设置完成后建议先清除缓存再重新安装npm cache clean --force npm install可通过npm config get registry查看当前配置的下载源。2. 免费模型有使用限制吗登录后默认提供免费的GLM-5.1模型单账号存在额度限制。免费模型适合快速体验但在复杂场景下可能存在能力局限。为获得最佳体验推荐配置第三方模型如智谱、通义千问、DeepSeek 等在 DevEco Code 中按/connect进入 Provider 选择界面或在deveco.jsonc中配置 Provider详见模型配置3. 编译构建或推包运行时报错怎么办编译构建、推包、模拟器运行等能力依赖 DevEco Studio请确认已安装 DevEco Studio6.1 及以上版本已正确配置DEVECO_HOME环境变量macOSexport DEVECO_HOME/Applications/DevEco-Studio.appWindows在系统环境变量中添加DEVECO_HOME值为 DevEco Studio 安装路径如C:\Program Files\Huawei\DevEco Studio配置完成后可在终端验证macOSWindowsecho $DEVECO_HOME4. 登录华为账号失败或提示认证错误怎么办DevEco Code 需要通过华为账号登录后才能使用。如果登录失败请检查网络连接是否正常登录需要访问华为账号服务终端是否能正常访问外网如果使用了代理尝试关闭代理后重试如需重新登录可先登出再登录deveco auth logout deveco auth login5. 修改了 MCP / Skill / Plugin 配置后没有生效新增或修改 Skill、MCP、Plugin 配置后需要退出并重新启动DevEco Code 才会生效在终端中按CtrlC退出当前会话重新执行deveco启动参与贡献欢迎贡献请在提交 Pull Request 前阅读 CONTRIBUTING.md。帮助与支持常见问题请参阅 FAQ 文档终端常用命令如/models、/connect等请参阅使用指导反馈与交流 GitCode Issue开源许可MIT License基于 OpenCode 构建的声明本项目基于开源项目 OpenCode 扩展开发。DevEco Code并非OpenCode 团队出品也与 OpenCode 团队无任何附属或关联关系。如有与 DevEco Code 相关的问题请通过 GitCode Issue 反馈而非联系 OpenCode 社区。DevEco Code — An open-source AI Agent for HarmonyOS application development本页内容简介快速开始支持平台推荐系统配置安装前置一键安装更新与卸载启动与登录HarmonyOS 开发能力Agent 模式开发工具内置 Skill典型应用场景Goal 模式切换模式模拟器 / 真机配置UI 检查配置模型配置使用免费模型通过 Provider 配置通过配置文件配置多模态模型常用配置配置绿灯模式生成 AGENTS.mdSkill / MCP / 插件方式一目录放置方式二npx 安装方式三使用 skill-creator自定义命令从 OpenCode 迁移至 DevEco Code最佳实践FAQ参与贡献帮助与支持开源许可基于 OpenCode 构建的声明↑