DevEco Code 在 MacOS 上的安装、配置与卸载全流程指南（TaoToken 配置版）

1. MacOS 上装 DevEco Code 到底卡在哪DevEco Code 是华为在 HDC 2026 期间发布的终端 AI Agent 工具基于开源项目 OpenCode 深度定制专门为 HarmonyOS 应用和元服务开发做了优化。它跟 DevEco Studio 那种图形化 IDE 不一样DevEco Code 跑在终端里你用自然语言跟它对话它就能读项目代码、生成 ArkTS、执行构建命令、修编译错误。适合谁适合已经在 MacOS 上做鸿蒙开发、想用 AI 提效的人也适合刚从 Windows 转过来、对 Mac 包管理和 Shell 配置不太熟的人。但 MacOS 上装它坑不在 DevEco Code 本身而在前置环境。我见过太多人卡在三个地方一是 Apple Silicon 和 Intel 的 Homebrew 路径不一样/opt/homebrew/和/usr/local/混着用PATH 配错二是 Node.js 用 Homebrew 全局装npm install -g直接报 EACCES 权限拒绝三是装完不知道怎么把模型通道接进来内置的 GLM-5.1 用完了想换第三方模型配置文件路径找不到。这篇就按「从零到跑通再到卸干净」的顺序走一遍。安装包获取、首次启动、TaoToken 统一 Key 接入 settings.json、终端验证命令、卸载残留检查全部给可复制的片段。你跟着敲就行不用先去啃官方文档。2. 装之前先把 TaoToken 通道准备好DevEco Code 本身通过 npm 安装不需要 TaoToken 也能装。但装完之后你要接模型如果每个模型都去单独申请 Key、单独配 base_url配置会散得到处都是。TaoToken 在这里的作用是做一个统一的 API 通道你拿一个 Key就能在同一个入口下切换不同模型配置只写一份。先注册并拿到 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 完成账号注册。然后进控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsole 。Key 创建后只显示一次复制下来存好。TaoToken 的 API 入口是 https://taotoken.net/api 这个地址后面要写进 DevEco Code 的配置文件里。注意它不加任何 UTM 参数就是干净的 API 根路径。如果你后面要长期用 DevEco Code 做编码和 Agent 任务可以看一下 Coding Plan地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-plan 。它适合高频调用场景比按次计费更划算。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 配置项有疑问的时候对着查。Key 拿到后先别急着配把环境装完再说。下面进入安装环节。3. 从 Homebrew 到 DevEco Code 的可复制配置3.1 先确认 Xcode Command Line ToolsMacOS 上编译原生 npm 模块需要 CLT。先检查xcode-select -p如果输出/Library/Developer/CommandLineTools或 Xcode 路径说明已装。没装的话执行xcode-select --install弹窗点安装等 1-3 GB 下载完。装完用git --version验证一下。3.2 装 Homebrew 并处理 Apple Silicon 路径Apple Silicon 的 Homebrew 装在/opt/homebrew/Intel 在/usr/local/。装完必须把 brew 加进 PATH否则brew命令找不到。Apple Siliconecho eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv)Intelecho eval $(/usr/local/bin/brew shellenv) ~/.zprofile eval $(/usr/local/bin/brew shellenv)验证brew --version3.3 用 fnm 管 Node.js绕开权限坑不要用brew install node然后npm install -gApple Silicon 上大概率报 EACCES。用 fnm 管版本全局安装落在用户目录不需要 sudo。brew install fnm echo eval $(fnm env --use-on-cd --shell zsh) ~/.zshrc source ~/.zshrc fnm install --lts fnm default lts-latest验证node -v npm -v node -e console.log(process.arch)最后一行在 Apple Silicon 上应该输出arm64。如果输出x64说明终端跑在 Rosetta 模式下去 Finder 里右键终端应用显示简介取消勾选「使用 Rosetta 打开」。3.4 装 DevEco Codenpm install -g deveco/deveco-code装完验证deveco --version which devecowhich deveco应该指向 fnm 的 aliases 目录类似/Users/你的用户名/Library/Application Support/fnm/aliases/default/bin/deveco。3.5 写 settings.json 接入 TaoTokenDevEco Code 的模型配置在~/.deveco/ai/config.json。首次启动后这个目录才会生成所以先跑一次deveco看到初始化日志后按 CtrlC 退出再编辑配置。mkdir -p ~/.deveco/ai vim ~/.deveco/ai/config.json写入以下骨架把sk-你的TaoToken密钥换成第 2 步拿到的 Key{ provider: { taotoken: { name: TaoToken, api_base: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, models: { claude-sonnet-4: { tool_call: true, context_window: 200000, max_tokens: 8192, temperature: 0.7 }, gpt-4o: { tool_call: true, context_window: 128000, max_tokens: 4096, temperature: 0.7 } } } }, preferences: { default_model: claude-sonnet-4, auto_compact_threshold: 80, theme: dark } }这里api_base写https://taotoken.net/api不要加斜杠结尾也不要加任何查询参数。models下面的键名是模型 ID具体支持哪些模型以接入文档为准地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc 。保存后重新启动deveco用/model命令应该能看到taotoken这个 provider 和它下面的模型。4. 验证请求是否真的通了配置写完不算通要发一次真实请求确认。启动 DevEco Codecd ~/你的鸿蒙项目目录 deveco在 TUI 里输入/model选择taotoken下的claude-sonnet-4回车确认。然后发一条测试消息你好请用一句话说明你当前使用的模型名称。如果返回正常文本说明 TaoToken 通道打通了。如果报 401检查 Key 是否复制完整、有没有多余空格。如果报连接超时检查api_base是否写成了https://taotoken.net/api不要带路径后缀。再验证一次工具调用能力让它读文件请读取当前目录下的 oh-package.json5告诉我 dependencies 里有哪些包。它能正确列出依赖说明 tool_call 也通了。这一步很关键因为 DevEco Code 的核心价值就是 Agent 能自主读写项目文件光能聊天不算跑通。如果你只是想先验证模型对话不想在终端里折腾也可以直接用模型对话页面测试同一个 Key地址 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chat 。那边通了说明 Key 和通道没问题再回来排查 DevEco Code 的配置。5. 本篇常见错排查5.1 deveco: command not foundfnm 的 shell 集成没生效。检查~/.zshrc里有没有eval $(fnm env --use-on-cd --shell zsh)然后source ~/.zshrc。如果用的是 bash把zsh换成bash写进~/.bash_profile。5.2 npm install -g 报 EACCES说明你用的是 Homebrew 全局 Node不是 fnm。执行which node看路径如果是/opt/homebrew/bin/node说明 fnm 没接管。重新fnm use default并确认which node指向 fnm 目录。5.3 配置文件改了不生效DevEco Code 启动时读一次配置改完要重启进程。另外确认文件路径是~/.deveco/ai/config.json不是项目目录下的。JSON 格式错误会导致静默回退到内置模型用python3 -m json.tool ~/.deveco/ai/config.json校验一下。5.4 Apple Silicon 上跑出 x64终端应用被勾了 Rosetta。Finder 里找到终端右键显示简介取消「使用 Rosetta 打开」重启终端。然后node -e console.log(process.arch)应该输出arm64。5.5 请求返回 404api_base写错了。TaoToken 的 API 根路径是https://taotoken.net/api不要写成https://taotoken.net/api/v1或带其他后缀。模型 ID 也要跟文档对齐写错模型名会返回 404 而不是 400。6. 卸载要卸干净残留文件逐个清卸载分四步卸运行时数据、卸 npm 包、清配置缓存、验证。第一步清运行时数据deveco uninstall第二步卸 npm 全局包npm uninstall -g deveco/deveco-code第三步删配置目录和缓存rm -rf ~/.deveco npm cache clean --force第四步验证deveco --version ls ~/.deveco第一条应该输出command not found第二条应该输出No such file or directory。两条都符合才算卸干净。如果你连 Node.js 和 fnm 也不想留fnm uninstall lts-latest brew uninstall fnm然后手动删掉~/.zshrc里那行eval $(fnm env ...)。Homebrew 本身要卸的话官方卸载脚本在它文档里这里不展开。最后提醒一句~/.deveco/auth/credentials.json里存的是登录凭证卸载前如果这台机器要转手或共用先deveco logout再删目录。项目根目录下的.deveco-rules.md是项目级配置不属于全局安装卸载 DevEco Code 不会动它需要的话自己手动清理。