先把 OmO 的三份配置分工

OmO 接入 AIGoCode 时，最容易漏掉的不是 API Key，而是把三个层级写进了不同文件却没有对齐。官方文档把接口地址、API Key 和模型放在 ~/.omo/agent/models.json，把终端默认模型放在 ~/.omo/agent/settings.json，把主控与子 Agent 路由放在 ~/.omo/omo.jsonc。Windows 对应路径是 %USERPROFILE%\.omo\agent\models.json、%USERPROFILE%\.omo\agent\settings.json 和 %USERPROFILE%\.omo\omo.jsonc。

第一处：models.json 先确认协议和地址

在 AIGoCode 用户端创建 ChatGPT API（Azure）分组 Key，再在 models.json 的 provider 中填写 baseUrl、api、apiKey 和 models。官方示例使用 https://api.aigocode.dev/v1、openai-responses 和 gpt-6-astra。这里的模型 ID 要与模型列表中的 id 一致；不要把显示名称当成请求 ID。

示例结构可以按官方字段整理：

{
  "providers": {
    "aigocode": {
      "baseUrl": "https://api.aigocode.dev/v1",
      "api": "openai-responses",
      "apiKey": "填入对应分组的 Key",
      "models": [{"id": "gpt-6-astra", "name": "AIGoCode GPT-6 Astra"}]
    }
  }
}

第二处：settings.json 决定终端默认模型

models.json 只声明“有哪些供应商和模型”。每次启动 OmO 时默认选谁，还要在 ~/.omo/agent/settings.json 写 defaultProvider 和 defaultModel：

{
  "defaultProvider": "aigocode",
  "defaultModel": "gpt-6-astra"
}

这两个值要能在 models.json 找到对应 provider 和 model id。否则模型列表可能能加载，终端却仍使用旧默认值。

第三处：omo.jsonc 决定主控和子 Agent 路由

OmO 的终端默认模型与主控、类别和 Agent 路由是两层设置。omo.jsonc 里可以让 model_profile、模型别名和各类 Agent 都指向 aigocode/gpt-6-astra。例如先定义 aigocode-main，再让 architect、quick、explore 等路由引用这个别名。这样换模型时，路由层不会悄悄留在旧供应商。

要特别区分两种写法：defaultModel 是终端默认模型的裸 ID；model_profile 和路由引用使用 provider/model 形式。把后者误写成裸 ID，或只改 settings.json，都会让主控与子 Agent 的实际路由和终端默认值不一致。

更换模型时按顺序核对

先在 models.json 确认 provider、API 类型、地址和模型 id。
再把 settings.json 的 defaultProvider、defaultModel 改到同一组值。
最后检查 omo.jsonc 的 model_profile、别名、类别和 Agent 列表。
在项目目录运行 omo，先发送普通消息，再触发一次需要子 Agent 的任务。
如果鉴权或模型报错，回到 Key 分组、API 地址和模型 ID 三项逐个核对。

官方 OmO 文档还提醒，aigocode-main 只是配置别名；真正决定请求目标的是它指向的 aigocode/gpt-6-astra。需要了解 AIGoCode 入口与其他客户端路径时，可继续查看 AIGoCode 官方文档。