平台与集成
本章节介绍如何配置和管理多个 AI Provider(Anthropic、OpenAI、Google、GitHub Copilot 等),以及 oh-my-opencode 的多模型自动降级机制。
通过学习本章节,你将掌握如何让系统根据任务类型和可用模型,智能选择最合适的 AI 模型,构建高效、可靠的多模型编排工作流。
本章节包含
本章节分为两部分:
1. Provider 配置
学习如何配置多种 AI Provider,包括:
- Anthropic Claude(主编排器首选)
- OpenAI ChatGPT(架构审查专用)
- Google Gemini(前端和媒体分析)
- GitHub Copilot(备用 Provider)
- Z.ai Coding Plan 和 OpenCode Zen(可选服务)
学完你能做什么:
- ✅ 配置 6 种主流 AI Provider
- ✅ 使用交互式安装器快速设置
- ✅ 为不同代理指定最适合的模型
- ✅ 使用
doctor命令诊断配置问题
预计时间:25-30 分钟
2. 多模型策略
深入理解模型解析系统的三步优先级机制:
- 用户覆盖(精确控制)
- Provider 降级(自动容错)
- 系统默认(兜底方案)
学完你能做什么:
- ✅ 理解模型解析的完整工作流程
- ✅ 根据任务需求手动指定模型
- ✅ 利用 Provider 降级提高系统鲁棒性
- ✅ 诊断和解决模型解析问题
预计时间:30-35 分钟
学习路径建议
我们建议按以下顺序学习本章节:
为什么这个顺序?
- 先配置,再理解:先学会如何配置各个 Provider,再理解背后的解析机制
- 从简单到复杂:Provider 配置是基础操作,多模型策略是进阶概念
- 实践验证理论:配置完 Provider 后,可以用
doctor命令验证多模型策略的效果
快速入门路径
如果你只想快速上手,可以先完成 Provider 配置 的第 1-4 步(配置基础 Provider),其他内容可以后续按需学习。
前置条件
在学习本章节之前,请确保:
- ✅ 已完成 安装和初始配置
- ✅ 安装了 OpenCode(版本 >= 1.0.150)
- ✅ 了解基本的 JSON/JSONC 配置文件格式
- ✅ 拥有至少一个 AI Provider 的账号订阅(推荐 Anthropic Claude)
如果没有 Provider 账号怎么办?
你可以先学习配置步骤,但不实际连接 Provider。系统会使用 OpenCode 的默认模型作为兜底。
常见问题
我需要配置所有 Provider 吗?
不需要。你可以只配置你最常用的 Provider(比如只配置 Anthropic Claude)。oh-my-opencode 的 Provider 降级机制会自动使用可用的 Provider。
但如果你想充分利用多模型编排的优势,建议至少配置 2-3 个 Provider,这样系统可以根据任务类型自动选择最合适的模型。
Provider 配置和模型解析有什么区别?
- Provider 配置:是"安装步骤",告诉系统你有哪些 AI 服务可用
- 模型解析:是"决策逻辑",系统如何为每个代理选择使用哪个 Provider
比喻:Provider 配置是"招聘团队成员",模型解析是"分配任务"。
我可以随时修改配置吗?
可以随时修改配置文件:
- 用户配置:
~/.config/opencode/oh-my-opencode.json - 项目配置:
.opencode/oh-my-opencode.json
修改后无需重启,下次使用代理时自动生效。如果修改了 Provider 认证,需要运行 opencode auth login 重新认证。
下一步指引
完成本章节后,你可以:
推荐路径:学习 AI 代理团队
继续学习 AI 代理团队:10 位专家介绍,了解如何使用不同的代理完成专业任务。
进阶路径:深度定制配置
如果你已经熟悉基础配置,可以跳到 配置深度定制:代理与权限管理,学习:
- 如何自定义代理的提示词
- 如何设置代理的权限和访问范围
- 如何创建自定义的代理和 Category
实战路径:使用 Prometheus 规划
开始使用 Prometheus 规划:面试式需求收集,通过实际的代理协作体验多模型编排的威力。
开始学习:从 Provider 配置 开始你的多模型编排之旅吧!