DevEco Code 在 MacOS 上的完整安装、配置与卸载全面使用指南（TaoToken 配置版）-北京尧图网络

1. MacOS 上从零跑通 DevEco Code 的真实场景DevEco Code 是华为面向 HarmonyOS 开发场景推出的终端 AI Agent 工具基于 OpenCode 深度定制专门针对 ArkTS 语法、声明式 UI、Stage 模型和 Hvigor 构建系统做了优化。它和 DevEco Studio 内置的 CodeGenie 最大的区别在于CodeGenie 是 Copilot 模式被动补全代码DevEco Code 是 Agent 模式你描述需求它主动读文件、写代码、跑命令、修 Bug。适合谁适合已经在 MacOS 上做鸿蒙开发、想用自然语言批量生成 ArkTS 页面和卡片、又不想被 IDE 插件绑死的开发者。但 MacOS 的坑和 Windows 完全不一样。Homebrew 路径分 Intel 和 Apple Silicon 两套Node.js 全局安装动不动就 EACCES 权限报错Shell 从 bash 换成 zsh 后配置文件加载顺序也变了。我见过太多人卡在npm install -g那一步就放弃了。这篇就按“装环境 → 配 Key → 写 settings.json → 验证请求 → 排错 → 卸载”的完整链路走一遍每一步都给可复制的命令和配置片段。你跟着敲半小时内能让 DevEco Code 在终端里跑起来并成功发出第一次模型请求。2. 前置环境Homebrew、Node.js 与 TaoToken 统一 Key2.1 先确认你的 Mac 架构这一步不能跳过因为后面所有路径都跟它有关。uname -m # Apple Silicon 输出 arm64 # Intel 输出 x86_64Apple Silicon 的 Homebrew 装在/opt/homebrew/Intel 装在/usr/local/。本文默认按 Apple Silicon 写Intel 用户把路径里的/opt/homebrew换成/usr/local即可。2.2 安装 Xcode Command Line Tools这是编译原生 npm 模块比如 node-pty的前提xcode-select --install弹窗点“安装”等它下完。验证xcode-select -p # 期望输出 /Library/Developer/CommandLineTools2.3 安装 Homebrew 并配国内镜像export HOMEBREW_API_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git /bin/bash -c $(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install/raw/HEAD/install.sh)装完把 Homebrew 写进 PATHecho eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv) brew --version2.4 用 fnm 装 Node.js 20 LTS强烈建议用 fnm 而不是 Homebrew 直接装 node因为 fnm 的全局安装目录在用户目录下永远不会遇到 EACCES 权限问题。brew install fnm echo eval $(fnm env --use-on-cd --shell zsh --node-dist-mirror https://npmmirror.com/mirrors/node) ~/.zshrc source ~/.zshrc fnm install 20 fnm default 20 fnm use 20 node -v # 期望 v20.x.x npm -v # 期望 10.x.x2.5 配置 npm 镜像并拿到 TaoToken Keynpm config set registry https://registry.npmmirror.com npm config get registry接下来是 TaoToken 的部分。TaoToken 提供统一的 Key 和 API 通道把多个模型供应商收敛到一个入口你只需要维护一份 Key不用在 DeepSeek、通义、智谱之间来回切换配置。先去控制台创建 Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsoleAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys创建后复制形如sk-xxxxxxxx的 Key先存到环境变量里别硬编码进配置文件echo export TAOTOKEN_API_KEYsk-你的Key ~/.zshrc source ~/.zshrc echo $TAOTOKEN_API_KEYTaoToken 的 API 基础地址是https://taotoken.net/api兼容 OpenAI 的/v1/chat/completions格式所以任何支持 OpenAI 兼容接口的工具都能直接接。接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc3. 安装 DevEco Code 并写入 settings.json 骨架3.1 全局安装npm install -g deveco/deveco-code deveco --version which deveco如果which deveco输出的是~/.fnm/...或~/Library/Application Support/fnm/...下的路径说明走的是 fnm 的用户级目录权限没问题。3.2 首次启动与目录结构cd ~/HarmonyOSProjects/MyApp deveco首次启动会自动建目录、跑数据库迁移。核心目录是~/.deveco/~/.deveco/ ├── data.db # 对话历史 SQLite ├── ai/ │ ├── config.json # 模型配置下面重点讲 │ ├── memory.md # 全局记忆 │ └── prompts/ # 自定义提示词 ├── auth/credentials.json └── logs/deveco-code.log3.3 settings.json / config.json 骨架DevEco Code 的模型配置写在~/.deveco/ai/config.json。下面这份骨架把 TaoToken 作为统一 provider 接进去你只需要替换 Key 的引用方式。注意JSON 里不能直接读环境变量所以要么把 Key 明文写进去本地个人机器可接受要么用启动脚本注入。这里给明文版骨架方便你直接复制{ provider: { taotoken: { name: TaoToken, api_base: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, models: { deepseek-chat: { tool_call: true, context_window: 65536, max_tokens: 8192, temperature: 0.7 }, deepseek-coder: { tool_call: true, context_window: 65536, max_tokens: 8192, temperature: 0.3 }, qwen-plus: { tool_call: true, context_window: 131072, max_tokens: 8192, temperature: 0.7 } } } }, preferences: { default_model: deepseek-coder, auto_compact_threshold: 80, theme: dark, language: zh-CN } }字段说明用表格对照更清楚字段含义建议值api_baseTaoToken 统一入口https://taotoken.net/apiapi_key控制台创建的 Keysk-开头tool_call是否支持函数调用Agent 模式必须 truecontext_window上下文窗口按模型实际填temperature生成温度代码任务 0.3对话 0.7default_model默认模型deepseek-coder注意api_base只写到https://taotoken.net/api不要自己拼/v1适配器会按 OpenAI 兼容规范补全路径。写错了会直接 404。3.4 用 /model 验证配置被读到启动 deveco 后输入/model如果列表里出现taotoken/deepseek-coder、taotoken/qwen-plus说明 config.json 解析成功。选不中或列表为空八成是 JSON 语法错误用下面命令校验python3 -m json.tool ~/.deveco/ai/config.json4. 验证请求发一次真实调用并看返回4.1 先用 curl 直连 TaoToken 确认 Key 有效在配 DevEco Code 之前先用 curl 排除 Key 和网络问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: deepseek-chat, messages: [{role: user, content: 只回复两个字通了}], stream: false }期望返回里能看到content: 通了之类的字段。如果返回 401是 Key 错了返回 404是路径拼错了超时是网络问题先解决网络再往下走。4.2 在 DevEco Code 里发第一次请求cd ~/HarmonyOSProjects/MyApp deveco进入 TUI 后输入请读取当前项目的 module.json5告诉我这个模块注册了哪些 Ability。如果 Agent 能自动读文件并给出正确回答说明 TaoToken 通道工具调用全部打通。这一步成功后面生成代码、改文件就都能用了。4.3 生成一段 ArkTS 验证代码能力在 pages 目录下新建一个 DemoPage.ets实现一个带搜索框和列表的页面列表数据用 State 管理搜索框输入时过滤列表。确认后 DevEco Code 会展示 diff按提示确认写入。然后切到 DevEco Studio 用 Previewer 看效果。这一步能跑通说明整条链路Key → 模型 → 工具 → 文件写入完全就绪。5. 本篇常见错排查5.1 npm install -g 报 EACCESnpm ERR! code EACCES npm ERR! path /opt/homebrew/lib/node_modules/deveco原因是你用了 Homebrew 装的 node全局目录归 root。两个解法一是改用 fnm推荐本文就是这么做的二是改 npm 全局目录到用户空间mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.zshrc source ~/.zshrc5.2 node-gyp 编译失败gyp ERR! stack Error: make failed with exit code: 2基本是 Xcode CLT 没装好或架构不匹配。重装sudo rm -rf /Library/Developer/CommandLineTools xcode-select --install再确认终端没跑在 Rosetta 下arch # 期望 arm64不是 x86_645.3 TaoToken 请求 401 / 404401 是 Key 问题确认~/.zshrc里的TAOTOKEN_API_KEY和控制台一致改完记得source ~/.zshrc。404 是路径问题api_base必须是https://taotoken.net/api不要多写或少写/v1。改完 config.json 后用python3 -m json.tool校验语法。5.4 模型列表为空config.json 里 JSON 尾逗号、中文引号是最常见的坑。用编辑器把引号全换成英文半角删掉最后一个字段后的逗号再重启 deveco。5.5 终端中文乱码echo export LANGen_US.UTF-8 ~/.zshrc echo export LC_ALLen_US.UTF-8 ~/.zshrc source ~/.zshrc5.6 彻底卸载与残留清理想干净移除按顺序来deveco uninstall npm uninstall -g deveco/deveco-code rm -rf ~/.deveco npm cache clean --force验证deveco --version # 期望 command not found ls ~/.deveco # 期望 No such file or directory如果连 Node.js 和 Homebrew 也要卸再执行fnm uninstall 20、brew uninstall fnm最后跑 Homebrew 官方卸载脚本。项目里的.deveco-rules.md记忆文件按需删find ~/HarmonyOSProjects -name .deveco-rules.md -delete6. 后续怎么用按场景分流环境跑通后日常使用分三条线。纯排障和接入配置问题回到 API Keys 和接入文档对照检查https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc 。想快速验证某个模型回答质量、对比不同模型输出直接用模型对话页面https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchat 。如果你打算长期用 DevEco Code 做编码和 Agent 任务建议上 Coding Plan额度和并发更稳https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan 。最后给个实用习惯每个鸿蒙项目根目录放一份.deveco-rules.md写清模块结构、编码规范、主题色、路由注册位置。DevEco Code 每次启动会读它生成的代码风格会稳定很多不用每次在对话里重复交代。这个文件配合 TaoToken 的统一 Key基本就是 MacOS 上鸿蒙 AI 开发的最小可用闭环了。

DevEco Code 在 MacOS 上的完整安装、配置与卸载全面使用指南（TaoToken 配置版）

相关推荐

PowerShell环境变量查看与输出：从Env:到跨机迁移

Anthropic AI原生开发手册解读：Claude Code工程化实践与CI/CD集成

金融系统核心开发指南：账户模型、幂等设计、对账与高可用实践

更多资讯

开源LLM代码审查工作流：Git集成+AST解析+安全沙箱

Atlas 300V 24G NPU加速卡部署YOLO全流程实战与避坑指南

本地化开源代码审查工作流：Git+LLM 可控智能实践

基于Simulink的电能质量扰动仿真：典型模型搭建与批量数据生成

FBMC-OQAM时间同步容限与SIR性能仿真分析

货拉拉AI Coding落地实践：从个人效率到组织提效的跨越

今日更新

BunnyScholar硕士论文跨章节检查：长文档双栏如何梳理因果链

维普标红教育学SEM量表怎么办：助研君修改与RMSEA指标复核

知网标红有限元仿真与网格划分怎么办：助研君按字修改与参数复核

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？