OmniRoute OpenCode插件指南：@omniroute/opencode-provider原生集成教程

OmniRoute OpenCode插件指南omniroute/opencode-provider原生集成教程【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRouteOmniRoute 是一个免费开源MIT的 AI 网关一个端点接入 350 家供应商、1200 模型支持配额感知的自动故障转移与 RTKCaveman 压缩。本教程面向新手手把手讲解如何用omniroute/opencode-provider与omniroute/opencode-plugin两个官方包把 OpenCode终端/桌面 AI 编程客户端原生集成到 OmniRoute让 Claude、GPT、Gemini、Kimi、GLM 等模型在 OpenCode 中随叫随到。 先搞懂两个官方包provider 还是 pluginOmniRoute 仓库提供了两个 OpenCode 集成包职责不同选错会踩坑对比项omniroute/opencode-provideromniroute/opencode-plugin类型构建期静态配置生成器运行时动态插件推荐模型来源冻结的 8 个默认模型启动时拉取/v1/models实时目录Combos 支持❌ 无✅ 自动聚合为伪模型离线兜底❌✅ 磁盘缓存快照适用场景CI 流水线、脚本化脚手架日常开发OpenCode CLI/桌面端⚠️重要提示omniroute/opencode-provider已被标记弃用——它写入的模型列表是硬编码的OmniRoute 新增模型后不会自动出现在 OpenCode 中。官方推荐用一行插件配置替代迁移方法见下文。两者源码分别在 src/index.ts 和 src/index.ts官方集成文档见 docs/frameworks/OPENCODE.md。 三种集成方式从最快到最灵活方式一一条命令一键安装推荐新手插件已随 v3.8.23 的omniroutenpm 包内置预构建一条命令即可完成复制插件 写配置 登录鉴权# 复制插件到 ~/.config/opencode/plugins/ 并更新 opencode.json omniroute setup opencode --auth # 按交互提示输入 OmniRoute API Key # 重启 OpenCode 后/models 即可看到完整实时模型目录该命令会自动执行opencode auth login --provider opencode-omniroute把密钥写入auth.json并自动清理旧的omniroute/opencode-provider残留条目可重复执行以升级插件或更换地址--base-url指定非默认地址。方式二CLI 生成器写入 opencode.json无需 npm installomniroute config opencode \ --base-url http://localhost:20128 \ --api-key $OMNIROUTE_API_KEY它对现有opencode.json做非破坏性合并——其他供应商配置与注释原样保留OmniRoute 条目被原子化地添加或替换。方式三编程式生成配置CI / 脚本场景omniroute/opencode-provider的核心 API 只有两个函数适合在 Node/TS 脚本中动态生成配置import { buildOmniRouteOpenCodeConfig } from omniroute/opencode-provider; const config buildOmniRouteOpenCodeConfig({ baseURL: http://localhost:20128, apiKey: process.env.OMNIROUTE_API_KEY ?? sk_omniroute, models: [auto, claude-opus-4-7, gpt-5.5], // 可选自定义模型目录 }); // config 可直接 JSON.stringify 写入 opencode.json生成的配置中provider.omniroute.npm指向ai-sdk/openai-compatibleOpenCode 自带运行时所有请求走 OmniRoute 的 OpenAI 兼容/v1表面因此自动获得 Auto-Combo 路由、熔断器、密钥策略、可观测性等网关能力——OpenCode 无需感知上游是哪家供应商。 API Key 与鉴权配置在 Dashboard 的Endpoint页面可查看 API 端点地址默认http://localhost:20128/v1与已注册的 API Keys。鉴权按实例配置二选一OmniRoute 设置apiKey 应填REQUIRE_API_KEYfalse本地默认字面量占位符sk_omnirouteREQUIRE_API_KEYtrueDashboard → API Keys 中创建的真实密钥OpenCode 侧统一发送Authorization: Bearer apiKey无需任何 Anthropic 风格的特殊处理。密钥存入~/.local/share/opencode/auth.json与插件的baseURL配置相互独立。 模型目录如何工作从 8 个默认模型到 1200 实时目录静态模式provider 包默认只暴露 8 个精选模型默认目录定义cc/claude-opus-4-8、cc/claude-sonnet-4-6、claude-opus-4-5-thinking、gemini-3-flash等。建议额外加入auto— 暴露 OmniRoute 的 Auto-Combo 零配置路由器由网关挑选当前最优模型combo-name— 你在 Dashboard 中定义的任意路由组合网关透明解析。动态模式plugin 包则完全交给网关做唯一事实来源启动时拉取/v1/models/api/combos-low/-medium/-high/-thinking变体与 Combo 均作为一等 ID 出现不做客户端合成默认5 分钟 TTL自动刷新modelCacheTtl运行期还有后台自动发现autoSyncIntervalMs新模型无需重启 OpenCode 即可出现输入/omni-sync可强制立即同步/omni-autosync查看同步状态Combo 的上下文窗口按成员最小值LCD 聚合计算避免null值导致的 4K token 截断。⚙️ 插件进阶特性精选模型选择器OmniRoute 实例通常提供 600 模型OpenCode 的选择器会翻不动。插件的features块全部可选帮你治理特性默认作用combostrueCombos 以Combo: name标签展示与裸模型区分enrichmenttrue覆盖显示名与每百万 token 价格输入/输出/缓存usableOnlyfalse只保留有健康连接的供应商选择器更聚焦visibleModels/hiddenModels未设白名单/黑名单裸后缀可匹配任意前缀黑名单优先diskCachetrue最近一次成功目录快照存盘离线冷启动也能显示模型mcpAutoEmitfalse自动写入mcp.omniroute远程条目直连/api/mcp/stream生产推荐组合usableOnly: truediskCache: truevisibleModels白名单。完整参数说明见 插件 README。 三个高频故障的 30 秒排查法症状原因解决请求全部 404URL 出现/v1/v1/旧版配置重复拼接了/v1重新运行omniroute setup opencode或生成器新版已自动规范化 URL401 Invalid API keyREQUIRE_API_KEYtrue但密钥无效Dashboard 创建密钥或本地改为false并用sk_omnirouteOpenCode 中模型列表为空默认模型被供应商可见性设置隐藏显式传models: [auto, ...]插件用户开启enrichment 相关资源索引集成官方文档docs/frameworks/OPENCODE.md静态生成器包omniroute/opencode-provider/默认模型目录运行时插件包omniroute/opencode-plugin/插件入口配置合并核心服务src/shared/services/opencodeConfig.ts至此OpenCode 已经通过 OmniRoute 网关接入全部模型——配额耗尽自动切换供应商、Token 节省 15–95%而你在终端里只需一句omniroute setup opencode --auth。【免费下载链接】OmniRouteNever stop coding. Free MIT AI gateway: one endpoint, 350 providers (90 free), 1200 models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline Copilot. Quota-aware auto-fallback, RTKCaveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 450 contributors项目地址: https://gitcode.com/GitHub_Trending/om/OmniRoute创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考