OmniRoute/docs/i18n/ig/docs/frameworks/OPENCODE.md

OpenCode Integration (Igbo)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

Ọnọdụ: Dị maka ojiji n'ozuzu. Ndị e zubere maka ha: Ndị na-ahụ maka sistemụ na-ejikọ OpenCode na nrụnye OmniRoute. Isi mmalite ziri ezi (schema nhazi): src/shared/services/opencodeConfig.ts Isi mmalite ziri ezi (ngwugwu npm): @omniroute/opencode-provider/ (workspace enwere ike ibipụta)

OpenCode bụ ngwa ahịa AI nke nwere ike ịrụ ọrụ dịka agent na CLI/desktop. Ọ na-agụ katalọgụ provider ya site na ~/.config/opencode/opencode.json (ma ọ bụ opencode.jsonc) ma na-agbaso schema dị na https://opencode.ai/config.json. OmniRoute na-egosi onwe ya nye OpenCode dịka otu n'ime provider ndị ahụ — arịrịọ ọ bụla na-agafe n'elu /v1 ọkọlọtọ OmniRoute nke dakọtara na OpenAI, ya mere OpenCode na-erite uru ozugbo site na routing Auto-Combo, circuit breakers, iwu key, observability, wdg.

E nwere ụzọ njikọta abụọ a na-akwado. Họrọ otu — ha abụọ na-emepụta otu nhazi ahụ.

---

Ụzọ 1 — generator CLI (achọghị nrụnye npm)

A na-atụ aro ya maka ndị ọrụ ikpeazụ. Ọ na-eso OmniRoute abịa. Ọ na-ede opencode.json n'ebe ọ dị ugbu a.

# Mgbe ị wụnyere OmniRoute (npm i -g @omniroute/cli ma ọ bụ clone mpaghara)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

N'azụ ihe a na-ahụ anya, CLI na-akpọ mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104), ya mere opencode.json dị adị na-edobe provider ndị ọzọ na comment ya. A na-agbakwunye/edochi ntinye OmniRoute n'ụzọ atomic.

Faịlụ a na-enweta (katalọgụ model ndabara):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1",
        "apiKey": "<your-key>",
      },
      "models": {
        "claude-opus-4-5-thinking": { "name": "claude-opus-4-5-thinking" },
        "claude-sonnet-4-5-thinking": { "name": "claude-sonnet-4-5-thinking" },
        "gemini-3.1-pro-high": { "name": "gemini-3.1-pro-high" },
        "gemini-3-flash": { "name": "gemini-3-flash" },
      },
    },
  },
}

---

Ụzọ 2 — ngwugwu npm @omniroute/opencode-provider

A na-atụ aro ya mgbe ị na-eji Node/TS ede script maka nhazi ahụ (pipeline CI, monorepo, usoro installer ahaziri iche).

npm install --save-dev @omniroute/opencode-provider

import { writeFileSync } from "node:fs";
import { buildOmniRouteOpenCodeConfig } from "@omniroute/opencode-provider";

const config = buildOmniRouteOpenCodeConfig({
  baseURL: "http://localhost:20128",
  apiKey: process.env.OMNIROUTE_API_KEY ?? "sk_omniroute",
  // Nhọrọ: dochie katalọgụ model e gosiri OpenCode
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

writeFileSync("opencode.json", JSON.stringify(config, null, 2));

Maka merge na-adịghị emebi faịlụ dị adị, mepụtagharịa mergeOpenCodeConfigText() site na opencodeConfig.ts ma ọ bụ kpọọ generator CLI.

Hụ README nke ngwugwu ahụ maka API zuru ezu.

---

Ihe runtime na-eme n'ezie

Ụzọ abụọ ahụ na-emepụta otu provider.omniroute.npm: "@ai-sdk/openai-compatible". N'oge runtime, OpenCode na-ebunye @ai-sdk/openai-compatible (nke bụrịrị dependency OpenCode na-enweta n'ụzọ transitive) ma jiri baseURL + apiKey hazie ya. Site n'ebe ahụ:

UI/agent OpenCode
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (elu OpenAI nke OmniRoute)
         → handler OmniRoute /v1/chat/completions     (open-sse/handlers/chatCore.ts)
            → combo routing / Auto-Combo / executor
               → provider upstream

Plugin ahụ anaghị emetụ HTTP aka ma ọlị. Naanị ihe ọ na-eme bụ iwepụta nhazi.

---

Ndabara katalọgụ ụdị

export const OMNIROUTE_DEFAULT_OPENCODE_MODELS = [
  "claude-opus-4-5-thinking",
  "claude-sonnet-4-5-thinking",
  "gemini-3.1-pro-high",
  "gemini-3-flash",
] as const;

Ị nwere ike dochie ya site na models: [...]. Ihe mgbakwunye ndị akwadoro:

• "auto" — na-eme ka rawụta Auto-Combo nke OmniRoute, nke anaghị achọ nhazi, pụta. Ọ na-enye OpenCode ohere ịhọrọ “ụdị kachasị mma dị” n’ebughị ụzọ tinye katalọgụ ahụ kpọmkwem n'ime koodu.
• "<combo-name>" — combo ọ bụla ị kọwapụtara na dashboard; OmniRoute na-edozi ya n'ụzọ na-adịghị ahụ anya.

---

Ịhazigharị URL

Ihe enyemaka ahụ na-anabata ụdị abụọ ahụ ma na-ewepụta naanị otu /v1:

Ntinye	Mpụta (options.baseURL)
http://localhost:20128	http://localhost:20128/v1
http://localhost:20128/	http://localhost:20128/v1
http://localhost:20128/v1	http://localhost:20128/v1
http://localhost:20128/v1///	http://localhost:20128/v1

Mwepụ oyiri a bụ nsogbu a na-ahụkarị na nhazi ochie. Ọ bụrụ na ị nwere opencode.json sitere tupu v3.8.0 nke na-arụtụ aka na /v1/v1/..., mee generator ahụ ọzọ ma ọ bụ kpọọ createOmniRouteProvider ọzọ.

---

Ụdị nyocha njirimara

Ntọala OmniRoute	Uru apiKey akwadoro
REQUIRE_API_KEY=false (ndabara maka local)	sk_omniroute (ihe njide ọnọdụ nkịtị)
REQUIRE_API_KEY=true	API key nke ezigbo onye ọrụ sitere na Dashboard → API Keys.

Maka klayentị ụdị Anthropic ndị na-eziga x-api-key + anthropic-version, extractApiKey nke OmniRoute na-anabatakwa key sitere na x-api-key. OpenCode na-eji interface OpenAI, ya mere ọ ga-eziga Authorization: Bearer ${apiKey} mgbe niile — ọnọdụ pụrụ iche nke Anthropic anaghị emetụta ebe a.

---

Nchọpụta na ndozi nsogbu

Mgbaàmà	Ihe kpatara ya	Ndozi
404 na arịrịọ ọ bụla nwere URL nke gụnyere /v1/v1/	Nhazi ochie sitere na plugin tupu v3.8 nke tinyere /v1 ugboro abụọ.	Mepụta ya ọzọ site na Ụzọ 1 ma ọ bụ 2.
401 Invalid API key	OmniRoute nwere REQUIRE_API_KEY=true, mana amaghị key ahụ.	Mepụta key ahụ na dashboard, ma ọ bụ tọọ REQUIRE_API_KEY=false (naanị local) ma jiri sk_omniroute.
Ndepụta ụdị ghe oghe na UI OpenCode	E zoro ụdị ndabara 4 niile na ngosi provider nke OmniRoute.	Nyefee models: ["auto", ...] iji mee ka ndị ị gbanyere pụta.
OpenCode 500 nwere cannot read property 'models'	OpenCode ochie (< 0.1.x) anaghị anabata models etinyere ozugbo.	Kwalite OpenCode gaa na ụdị na-agbaso schema v1 (opencode.ai/config.json).

---

Hụkwa

• Ntụaka API — nkọwa zuru ezu nke OmniRoute REST
• Auto-Combo — ihe model: "auto" pụtara
• @omniroute/opencode-provider README
• Koodu mmalite: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts