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

OpenCode Integration (Eesti)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 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

---

Olek: Üldiselt kättesaadav. Sihtrühm: Operaatorid, kes ühendavad OpenCode'i OmniRoute'i juurutusega. Tõeallikas (konfiguratsiooniskeem): src/shared/services/opencodeConfig.ts Tõeallikas (npm-pakett): @omniroute/opencode-provider/ (avaldatav tööruum)

OpenCode on agentne käsurea-/töölaua-AI-klient. See loeb teenusepakkujate kataloogi failist ~/.config/opencode/opencode.json (või opencode.jsonc) ja järgib skeemi aadressil https://opencode.ai/config.json. OmniRoute esitleb end OpenCode'ile ühe sellise teenusepakkujana — iga päring liigub läbi OmniRoute'i standardse OpenAI-ga ühilduva /v1-liidese, mistõttu saab OpenCode automaatselt kasu Auto-Combo marsruutimisest, kaitselülititest, võtmepoliitikatest, jälgitavusest jne.

Toetatud on kaks integratsiooniviisi. Valige üks — mõlemad genereerivad sama konfiguratsiooni.

---

Viis 1 — CLI-generaator (npm-i installimine pole vajalik)

Soovitatav lõppkasutajatele. Tarnitakse koos OmniRoute'iga. Kirjutab faili opencode.json kohapeal.

# Pärast OmniRoute'i installimist (npm i -g @omniroute/cli või kohalik kloon)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

Taustal kutsub CLI välja funktsiooni mergeOpenCodeConfigText() (src/shared/services/opencodeConfig.ts:104), mistõttu säilivad olemasoleva opencode.json-faili teised teenusepakkujad ja kommentaarid. OmniRoute'i kirje lisatakse või asendatakse atomaarselt.

Tulemuseks olev fail (vaikimisi mudelikataloog):

{
  "$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" },
      },
    },
  },
}

---

Viis 2 — npm-pakett @omniroute/opencode-provider

Soovitatav juhul, kui skriptite konfiguratsiooni Node'i/TS-i kaudu (CI-konveierid, monorepod, kohandatud installivood).

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",
  // Valikuline: alista OpenCode'ile pakutav mudelikataloog
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

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

Olemasoleva failiga mittepurustavaks ühendamiseks kopeerige funktsiooni mergeOpenCodeConfigText() loogika failist opencodeConfig.ts või kutsuge välja CLI-generaator.

Täieliku API kirjelduse leiate paketi README-failist.

---

Mida käituskeskkond tegelikult teeb

Mõlemad viisid loovad sama kirje provider.omniroute.npm: "@ai-sdk/openai-compatible". Käitusajal laadib OpenCode paketi @ai-sdk/openai-compatible (mis on juba OpenCode'i transitiivne sõltuvus) ja konfigureerib selle väärtustega baseURL + apiKey. Sealt edasi:

OpenCode'i kasutajaliides/agent
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (OmniRoute'i OpenAI-liides)
         → OmniRoute'i /v1/chat/completions töötleja  (open-sse/handlers/chatCore.ts)
            → kombineeritud marsruutimine / Auto-Combo / täitur
               → ülesvoolu teenusepakkuja

Pistikprogramm ei suhtle kunagi otse HTTP-ga. See väljastab ainult konfiguratsiooni.

---

Mudelikataloogi vaikeväärtused

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;

Saate need alistada valikuga models: [...]. Soovitatavad täiendused:

• "auto" — teeb kättesaadavaks OmniRoute'i nullkonfiguratsiooniga marsruuteri Auto-Combo. Võimaldab OpenCode'il valida „parima saadaoleva mudeli“, ilma et peaksite kataloogi koodi sisse kirjutama.
• "<combo-name>" — mis tahes kombinatsioon, mille olete juhtpaneelil määratlenud; OmniRoute lahendab selle läbipaistvalt.

---

URL-i normaliseerimine

Abifunktsioon aktsepteerib mõlemat kuju ja väljastab täpselt ühe /v1:

Sisend	Väljund (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

See duplikaatide eemaldamine lahendab kõige levinuma tõrke, mida vanemates konfiguratsioonides esineb. Kui teil on versioonieelsest v3.8.0 ajast pärit opencode.json, mis osutab teele /v1/v1/..., käivitage generaator uuesti või kutsuge createOmniRouteProvider uuesti välja.

---

Autentimisrežiimid

OmniRoute'i säte	Soovitatav apiKey väärtus
REQUIRE_API_KEY=false (kohalik vaikimisi)	sk_omniroute (sõnasõnaline kohatäide)
REQUIRE_API_KEY=true	Tegelik kasutajapõhine API-võti: Juhtpaneel → API-võtmed.

Anthropicu-laadsete klientide puhul, mis saadavad x-api-key + anthropic-version, arvestab OmniRoute'i extractApiKey ka päisest x-api-key saadud võtit. OpenCode kasutab OpenAI liidest, mistõttu saadab see alati Authorization: Bearer ${apiKey} — Anthropicu erijuhtum siin ei rakendu.

---

Tõrkeotsing

Sümptom	Põhjus	Lahendus
404 igal päringul, mille URL sisaldab /v1/v1/	Aegunud konfiguratsioon v3.8-eelsest pluginast, mis lisas /v1 kaks korda.	Looge konfiguratsioon uuesti 1. või 2. viisil.
401 Invalid API key	OmniRoute'is on REQUIRE_API_KEY=true ja võti pole teada.	Looge võti juhtpaneelil või määrake REQUIRE_API_KEY=false (ainult kohalikult) ja kasutage sk_omniroute.
Mudelite loend on OpenCode'i kasutajaliideses tühi	Kõik 4 vaikemudelit on OmniRoute'i pakkuja nähtavusseadetes peidetud.	Lubatud mudelite kuvamiseks edastage models: ["auto", ...].
OpenCode'i 500 veaga cannot read property 'models'	Vanem OpenCode (< 0.1.x) ei aktsepteerinud tekstisisest models väärtust.	Uuendage OpenCode versioonile, mis järgib v1 skeemi (opencode.ai/config.json).

---

Vaata ka

• API viitedokumentatsioon — OmniRoute REST-liidese täielik ülevaade
• Auto-Combo — mida model: "auto" tähendab
• @omniroute/opencode-provider README
• Lähtekood: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts