从 OpenCode 换到 DevEco，先列一张迁移清单
原来的 OpenCode 已配置 AIGoCode，准备在 DevEco Code 中继续项目时，不要只把原配置文件换个名字。AIGoCode 的两份官方教程给出的文件位置、OpenAI 适配器和部分示例分组并不完全相同。
本文把两页文档并排检查，帮助你在本机重新建立一组匹配的 DevEco 配置。它不是自动导入工具的说明，也不承诺旧 Key 可以直接用于所有新配置。
第一处差异：全局 opencode.json 与项目 deveco 文件
OpenCode 文档 将全局配置放在 Windows 的 %USERPROFILE%\.config\opencode\opencode.json，或 macOS/Linux 的 ~/.config/opencode/opencode.json。它要求正在运行时先关闭 OpenCode，再编辑配置。
DevEco Code 文档 则先通过界面连接自定义服务商，随后打开项目中的 deveco.json 或 deveco.jsonc 写入模型配置。两份教程指定的目标文件不同。做迁移记录时，应把“原工具读哪份文件”和“新工具教程要求改哪份文件”分开，不把原文件存在当成新工具已经配置完成。
这也不意味着已经验证两款工具所有配置层级的优先级；本文仅按当前两页教程指定的文件进行对照。
第二处差异：相似 JSON 不等于所有字段都照搬
两页示例都包含 model、provider、npm、options.baseURL 和模型条目，但示例值存在差异：
| 检查项 | OpenCode 页面示例 | DevEco Code 页面示例 |
|---|---|---|
| OpenAI 的 npm 适配器 | @ai-sdk/openai | @ai-sdk/openai-compatible |
| Claude 示例 Key 分组 | Claude API（AWS） | Claude Code（可外接） |
| Claude 示例模型 | claude-sonnet-5-5 | claude-opus-5-5 |
| Gemini 示例模型 | gemini-3.8-flash | gemini-4-argon |
这些是当前文档示例的差别，不是两款工具的完整支持矩阵，也不是断言旧模型一定不能使用。它们提醒你：复制旧配置前，应重新按目标工具页面核对，而不是根据 JSON 长得相似就认定值可直接交换。
如果暂时只做文档示例接入，就先选定 DevEco 页面中的一组，按该组 Key、适配器、地址和模型填写。不要为迁移一次同时混入多个协议的示例。
第三处检查：DevEco 的协议地址与模型引用
DevEco 当前示例的对应关系如下：
| 接入方向 | Key 分组 | npm 适配器 | baseURL |
|---|---|---|---|
| OpenAI 兼容 | ChatGPT API（Azure） | @ai-sdk/openai-compatible | https://api.aigocode.dev/v1 |
| Anthropic Messages | Claude Code（可外接） | @ai-sdk/anthropic | https://api.aigocode.dev/v1 |
| Gemini 原生接口 | Gemini | @ai-sdk/google | https://api.aigocode.dev/v1beta |
尤其是 Claude 一行，DevEco 文档明确说明 @ai-sdk/anthropic 会在地址后追加 /messages，所以 baseURL 需要保留 /v1。这里不需要根据另一个工具的根地址习惯自行删改。
再看模型引用。DevEco 示例的顶层 model 分别为 aigocode/gpt-6-astra、aigocode/claude-opus-5-5、aigocode/gemini-4-argon；对应 provider 的 models 里分别登记斜杠后面的模型 ID。检查迁移是否完整时，把顶层引用和内部模型键对照，别只修改显示名称。
文档还要求一次只保留与当前配置匹配的 model 和 provider 内容。建议先保留本机原文件副本，再合入目标配置，避免复制示例时覆盖其他需要保留的项目设置。真实 Key 只在本机填写，迁移清单仅写分组名称。
在新工具里完成服务商连接和模型选择
DevEco 页面的界面操作是：主界面按 Ctrl+P，搜索 provider，选择 Connect provider；搜索 other，选择 Other Custom provider，再按协议填写服务商信息。不要把在 OpenCode 中配置过供应商等同于已经完成这里的操作。
写好项目文件后，文档要求重新打开 DevEco Code，输入 /models，选择对应的 AIGoCode 模型。迁移验收记录可以按下面顺序填写：
- 目标项目的
deveco.json或deveco.jsonc已核对。 - Key 分组、适配器、地址和模型引用属于同一组。
- 重新打开 DevEco 并通过
/models选择目标模型。 - 发送简单消息，检查回复，并在控制台用量记录核对请求是否产生。
这四项是给读者使用的检查顺序，本文没有实际安装或运行两款工具，也没有进行模型请求。若仍失败，保留当前错误，再依照文档核对 API Key、协议与错误码；不要把“配置已保存”当作“调用已成功”。
留下工具之间的差异，方便以后切回来
迁移记录只需保留原文件位置、目标项目文件、选择的协议、分组名称、适配器、模型 ID 和验证结果，不保存真实 Key。以后切回原工具时，也按它自己的教程检查，避免将这次 DevEco 的设置反向覆盖到全局 OpenCode 配置。
如果需要进一步排查，先按 API 日志脱敏流程 整理信息。单独配置 OpenCode 的步骤已有 OpenCode 全局配置指南；本篇新增的是跨工具迁移时的差异核对，不能替代当前工具文档或账户的实际可用范围。