第一部分：Windows 环境安装与演示基本流程
一、node和nvm下载与安装: Node.js — 下载 Node.js®
二、DevEco Studio下载与安装：下载中心 | 华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态
三、检查基本配置 Windows+R cmd
四、DevEco Code 安装 Windows+R cmd
五、登录华为账户
六、关联 DevEco Studio 安装路径
安装路径寻找 右键图标
七、进入工作界面与完成首个工程项目
八、运行模拟器
运行效果
九、切换工作模式
十、打开已经开发的项目
十一、通过DevEco Studio 打开 打开源码所在位置即可 模拟器运行如下
附件：官方支持：
deveco-code:基于 OpenHarmony 的 AI 辅助应用开发工具项目 - AtomGit
文档中心
第二部分：整体流程与说明
推荐配置
一、操作系统
Windows：Windows 11 22H2 及以上
macOS：macOS 15 Sequoia 及以上
二、硬件
日常使用（短会话、单模块改动、以对话与代码编辑为主）：8 GB 及以上内存
重度使用（大工程、长会话、频繁编译构建与模拟器/真机调试）：16 GB 及以上内存；建议为 DevEco Studio、SDK、模拟器与构建缓存预留 20 GB 及以上可用磁盘空间
三、运行时与工具链
Node.js 22 及以上
DevEco Studio 6.1 及以上（编译构建、Hvigor、HDC、模拟器/真机运行）
已配置 DEVECO_HOME 环境变量，指向 DevEco Studio 安装目录
终端 Shell
Windows：PowerShell 7+（推荐）、Windows PowerShell 5.1+
macOS：Zsh（推荐）、Bash
四、网络
需要稳定的互联网连接（华为账号登录、模型调用、HarmonyOS 知识库检索等）
五、安装前置与常用命名
DevEco Code 通过 npm 分发，安装前请先准备以下环境：
安装 Node.js，推荐使用 22 及更高版本
（可选）安装 DevEco Studio，推荐使用 6.1 及更高版本；若不安装，HarmonyOS 应用构建、推包等工具将无法使用
（可选）配置 DEVECO_HOME 环境变量指向 DevEco Studio 安装目录，默认路径示例：
macOS：/Applications/DevEco-Studio.app
Windows：C:\Program Files\Huawei\DevEco Studio
可先在终端验证 Node.js 环境：cmd
node -v
npm -v
安装与卸载 CMD
安装：
npm install -g @deveco/deveco-code
查看版本、启动：
deveco --version
deveco
更新：
deveco upgrade
卸载运行时数据与全局包：
deveco uninstall
npm uninstall -g @deveco/deveco-code
登录与登出
使用 DevEco Code 需先通过华为账号登录。首次执行 deveco 时会在终端内引导完成登录；也可单独执行登录命令：
deveco auth login
登出会清除当前华为账号的本地登录状态，下次启动需重新登录。执行：
deveco auth logout
创建桌面快捷方式
cmd /k “deveco”
打开已经开发好的项目
cd C:\Users\65794\DevEcoStudioProjects\EarthSimulator（项目路径）
打开模拟器运行
deveco run
六、模型配置
登录后可使用 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.jsonc
七、Agent 配置
DevEco Code 面向 HarmonyOS 开发提供以下 Agent 配置（按 Tab 键切换）：
Build：默认模式，适合工程生成、代码生成、配置修正、测试执行、推包运行和发布执行
Plan：适合需求拆解、技术方案、发布规划、测试规划和文档生成
Goal：适合 SDD 五阶段从需求到实现与构建验证的端到端特性交付
HarmonyOS 场景能力
DevEco Code 集成了常用 HarmonyOS 开发工具能力：
常见场景包括：从零到一创建 HarmonyOS 工程、增量开发页面、修复编译报错、真机调试。
八、扩展能力
DevEco Code 兼容 OpenCode 的 Skill、MCP 和 Plugin 扩展方式。
新增或修改 Skill、MCP、Plugin 配置后，需退出并重新执行 deveco 启动后才会生效。
Skills
npx skills add vercel-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/mcp@latest"], "enabled": true }}
}
Plugins
npm install -g oh-my-opencode
然后在 deveco.jsonc 中配置插件入口：
{
“plugin”: [
"node_modules/oh-my-opencode/dist/index.js"]
}
九、从 OpenCode 迁移
如果需要从 OpenCode 迁移到 DevEco Code，请将配置文件迁移到 DevEco Code 目录。主配置文件可参考：
Windows PowerShell
Copy-Item -Force “{源路径}\opencode.jsonc” “~.config\deveco\deveco.jsonc”
macOS
cp {源路径}/opencode.jsonc ~/.config/deveco/deveco.jsonc
Skills、Agents、Plugins 也可以迁移到 ~/.config/deveco 下的对应目录；MCP 配置项可迁移到 deveco.jsonc 中。
第三部分 工具说明
DevEco Code 是一款面向 HarmonyOS 开发场景的 AI Agent 工具，支持代码编写、编译构建、设备运行、文档查阅、运行时调试及 ArkTS 问题修复等能力。
DevEco Code 基于开源项目 OpenCode 扩展开发，保留了 OpenCode 的终端交互、配置体系、 Provider / MCP / Skill / Plugin 等能力，并针对 HarmonyOS 工程增加了 DevEco Studio、Hvigor、HDC、Skill、HarmonyOS 知识库、ArkTS 检查和设备调试相关集成。
本文参考鸿蒙官方文