目标：让任何小白都能快速配置 OpenCode 与 oh-my-opencode，并用 GitHub Copilot 的模型实现「主力模型 + 小模型」分工，稳定、简洁、易排错。

1. 这篇文章适合谁

你可能符合以下情况之一：

• 想在终端里用 OpenCode 写代码、查资料、做自动化
• 想用 oh-my-opencode 的多代理（agents）能力：oracle / librarian / explore / frontend 等
• 没有 Claude/ChatGPT/Gemini 订阅，但有 GitHub Copilot（或能通过 GitHub 登录使用）
• 希望配置尽可能少，不想引入一堆冗余 provider

---

2. 最终效果（先看结果）

我们希望最终实现：

OpenCode（全局默认）

• 默认主力模型：github-copilot/gpt-5.2
• 默认小模型：github-copilot/gpt-5.1-codex-mini

oh-my-opencode（agents 分工）

• 主力 agents（复杂推理/规划/主实现） → github-copilot/gpt-5.2
• small agents（探索/检索/写文档/看图等） → github-copilot/gpt-5.1-codex-mini

这样做的好处：

• 质量稳定：复杂任务交给大模型
• 性价比高：探索/辅助任务用小模型更快更省
• 排错简单：provider 统一（只走 github-copilot），不混用免费模型/其他 provider

---

3. 安装前检查（必须）

在终端运行下面三条命令：

opencode --version
node --version
npx --version

你需要：

• opencode 已安装并能显示版本
• 有 node 和 npx（用于运行 oh-my-opencode 安装器）

如果你没有 Node.js：建议装官方 LTS（不同系统方式不同，这里略）。

---

4. 配置 OpenCode 默认模型（核心）

OpenCode 的全局配置通常在：

~/.config/opencode/opencode.json

推荐最小配置如下（可直接复制）：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "github-copilot/gpt-5.2",
  "small_model": "github-copilot/gpt-5.1-codex-mini",
  "plugin": ["oh-my-opencode"]
}

字段解释：

• model：默认主力模型
• small_model：默认小模型（适合轻量/后台/检索类任务）
• plugin：启用 oh-my-opencode 插件（安装后一般会自动加上）

---

5. 安装 oh-my-opencode（多代理团队作战）

执行安装：

npx oh-my-opencode@latest install

安装过程会问你是否有订阅：

• Claude Pro/Max？
• ChatGPT Plus/Pro？
• Gemini？

如果你都没有，就全部选 No 即可。

安装成功后通常会：

• 修改 ~/.config/opencode/opencode.json（注册插件）
• 生成 ~/.config/opencode/oh-my-opencode.json（配置 agents）

---

6. 配置 oh-my-opencode：主力 agents 与 small agents 分工

小白最容易忽略的一步：如果你没有订阅，安装器可能把 agents 默认指向免费模型（例如 opencode/glm-4.7-free）。

如果你明确想用 Copilot 的模型，就应该把 agents 统一到 github-copilot/*，更一致、更稳定。

编辑下面这个文件：

~/.config/opencode/oh-my-opencode.json

推荐模板（可直接复制）：

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",
  "agents": {
    "Sisyphus": { "model": "github-copilot/gpt-5.2" },
    "oracle": { "model": "github-copilot/gpt-5.2" },
    "frontend-ui-ux-engineer": { "model": "github-copilot/gpt-5.2" },

    "explore": { "model": "github-copilot/gpt-5.1-codex-mini" },
    "librarian": { "model": "github-copilot/gpt-5.1-codex-mini" },
    "document-writer": { "model": "github-copilot/gpt-5.1-codex-mini" },
    "multimodal-looker": { "model": "github-copilot/gpt-5.1-codex-mini" }
  }
}

为什么这样分配比较推荐？

• Sisyphus / oracle：规划、推理、决策、主实现，适合大模型
• explore / librarian：偏检索、探索、定位信息，小模型更划算
• document-writer：快速出文档初稿，小模型足够，再由大模型润色
• multimodal-looker：图片/PDF 信息提取，小模型先提取也很合适

如果你追求极致输出质量：也可以全部用 gpt-5.2，但成本和速度会变差。

---

7. GitHub Copilot 登录（很多小白卡点）

如果你第一次用 github-copilot/* 模型，需要授权登录：

opencode auth login

按提示选择 GitHub/Copilot，完成浏览器 OAuth 登录即可。

---

8. 验证是否成功（3 条命令）

8.1 查看可用模型

opencode models

至少应看到：

• github-copilot/gpt-5.2
• github-copilot/gpt-5.1-codex-mini

8.2 检查 oh-my-opencode 是否健康

npx oh-my-opencode@latest doctor

出现 warnings 是正常的（只要没有 failed）。

8.3 实战测试（魔法关键词）

oh-my-opencode 的魔法词是 ultrawork 或 ulw。例如在 opencode 里输入：

ulw 帮我总结当前启用的 agents，并说明各自适合做什么

---

9. 常见问题排错

Q1：doctor 提示 “No model providers configured… fallback …”

原因：oh-my-opencode.json 里 agents 仍指向免费模型。 解决：按第 6 节把 agents 统一改成 github-copilot/*。

Q2：Copilot 模型报 401 / 没权限

原因：没登录或登录过期。 解决：重新执行 opencode auth login。

Q3：doctor 显示 LSP Servers 1/4

解释：不是错误，只是“代码智能”功能没装全。 建议：等你明确主力语言后再补（比如 Python 装 pyright）。

---

10. 可选补全（我建议先别折腾）

以下都属于“可选增强”，不是必须：

• gh（GitHub CLI）：终端里管理 PR/issue 才需要
• AST-Grep NAPI：结构化重构增强，但 CLI 版本已够用
• 更多 LSP servers：只在你明确语言后再装

---

11. 一句话总结：最小配置哲学

• provider 统一：只走 github-copilot/*
• 模型分工：大模型做决策，小模型做辅助
• 配置最简：OpenCode 管默认模型，oh-my-opencode 管 agents 映射

---

如果你觉得这篇对你有帮助，也欢迎你把“你的最终配置片段/截图”补在文末，读者照抄会更快成功。