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

OpenCode Integration (Suomi)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇷 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

---

Tila: Yleisesti saatavilla. Kohderyhmä: Ylläpitäjät, jotka yhdistävät OpenCoden OmniRoute-asennukseen. Ensisijainen lähde (määritysskeema): src/shared/services/opencodeConfig.ts Ensisijainen lähde (npm-paketti): @omniroute/opencode-provider/ (julkaistava työtila)

OpenCode on agenttipohjainen CLI-/työpöytä-AI-asiakasohjelma. Se lukee palveluntarjoajaluettelonsa tiedostosta ~/.config/opencode/opencode.json (tai opencode.jsonc) ja noudattaa osoitteessa https://opencode.ai/config.json määriteltyä skeemaa. OmniRoute näkyy OpenCodelle yhtenä näistä palveluntarjoajista — jokainen pyyntö kulkee OmniRouten OpenAI-yhteensopivan /v1-vakiorajapinnan kautta, joten OpenCode hyötyy automaattisesti Auto-Combo-reitityksestä, katkaisijoista, avainkäytännöistä, havainnoitavuudesta jne.

Integraatioon on kaksi tuettua tapaa. Valitse niistä toinen — ne tuottavat saman määrityksen.

---

Tapa 1 — CLI-generaattori (ei npm-asennusta)

Suositellaan loppukäyttäjille. Toimitetaan OmniRouten mukana. Kirjoittaa opencode.json-tiedoston suoraan paikalleen.

# OmniRouten asentamisen jälkeen (npm i -g @omniroute/cli tai paikallinen klooni)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

CLI kutsuu taustalla mergeOpenCodeConfigText()-funktiota (src/shared/services/opencodeConfig.ts:104), joten olemassa olevan opencode.json-tiedoston muut palveluntarjoajat ja kommentit säilyvät. OmniRoute-merkintä lisätään tai korvataan atomisesti.

Tuloksena syntyvä tiedosto (oletusarvoinen malliluettelo):

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

---

Tapa 2 — npm-paketti @omniroute/opencode-provider

Suositellaan, kun luot määrityksen ohjelmallisesti Node/TS-ympäristössä (CI-putket, monorepot, mukautetut asennustyönkulut).

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",
  // Valinnainen: korvaa OpenCodelle tarjottava malliluettelo
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

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

Jos haluat yhdistää määritykset rikkomatta olemassa olevaa tiedostoa, toteuta opencodeConfig.ts-tiedoston mergeOpenCodeConfigText()-toiminnallisuus tai kutsu CLI-generaattoria.

Täydellinen API-kuvaus on paketin README-tiedostossa.

---

Mitä suoritusympäristö käytännössä tekee

Molemmat tavat tuottavat saman arvon provider.omniroute.npm: "@ai-sdk/openai-compatible". Suorituksen aikana OpenCode lataa @ai-sdk/openai-compatible-paketin (joka on jo OpenCoden transitiivinen riippuvuus) ja määrittää sen baseURL- ja apiKey-arvoilla. Sen jälkeen kulku on seuraava:

OpenCoden käyttöliittymä/agentti
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (OmniRouten OpenAI-rajapinta)
         → OmniRouten /v1/chat/completions-käsittelijä (open-sse/handlers/chatCore.ts)
            → yhdistelmäreititys / Auto-Combo / suorittaja
               → ylemmän tason palveluntarjoaja

Liitännäinen ei koskaan käsittele HTTP-liikennettä. Se tuottaa ainoastaan määrityksen.

---

Malliluettelon oletukset

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;

Voit ohittaa oletukset asetuksella models: [...]. Suositeltuja lisäyksiä:

• "auto" — tuo näkyviin OmniRouten Auto-Combo-reitittimen, joka ei vaadi määrityksiä. Sen avulla OpenCode voi valita parhaan saatavilla olevan mallin ilman, että malliluetteloa tarvitsee määrittää kiinteästi.
• "<combo-name>" — mikä tahansa hallintapaneelissa määrittämäsi yhdistelmä; OmniRoute selvittää sen läpinäkyvästi.

---

URL-osoitteen normalisointi

Apufunktio hyväksyy molemmat muodot ja tuottaa täsmälleen yhden /v1-päätteen:

Syöte	Tulos (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

Tämä päällekkäisyyden poisto korjaa yleisimmän vanhemmissa määrityksissä esiintyvän ongelman. Jos sinulla on versiota v3.8.0 edeltävä opencode.json, joka osoittaa polkuun /v1/v1/..., suorita generaattori uudelleen tai kutsu createOmniRouteProvider-funktiota uudelleen.

---

Todennustilat

OmniRoute-asetus	Suositeltu apiKey-arvo
REQUIRE_API_KEY=false (paikallinen oletus)	sk_omniroute (kirjaimellinen paikkamerkki)
REQUIRE_API_KEY=true	Todellinen käyttäjäkohtainen API-avain kohdasta Hallintapaneeli → API-avaimet.

Anthropic-tyylisissä asiakasohjelmissa, jotka lähettävät otsakkeet x-api-key ja anthropic-version, OmniRouten extractApiKey hyväksyy myös x-api-key-otsakkeessa olevan avaimen. OpenCode käyttää OpenAI-rajapintaa, joten se lähettää aina otsakkeen Authorization: Bearer ${apiKey} — Anthropic-kohtainen erikoistapaus ei päde tässä.

---

Vianmääritys

Oire	Syy	Korjaus
404 jokaisessa pyynnössä, jonka URL sisältää /v1/v1/	Vanha, versiota v3.8 edeltävän lisäosan määritys, joka lisäsi /v1-päätteen kahdesti.	Luo määritys uudelleen tavalla 1 tai 2.
401 Invalid API key	OmniRoutessa on REQUIRE_API_KEY=true, eikä avainta tunneta.	Luo avain hallintapaneelissa tai aseta REQUIRE_API_KEY=false (vain paikallisesti) ja käytä arvoa sk_omniroute.
Malliluettelo on tyhjä OpenCode-käyttöliittymässä	Kaikki neljä oletusmallia on piilotettu OmniRouten palveluntarjoajan näkyvyysasetuksissa.	Tuo käyttöön ottamasi mallit näkyviin antamalla models: ["auto", ...].
OpenCode palauttaa 500-virheen ja ilmoituksen cannot read property 'models'	Vanhempi OpenCode (< 0.1.x) ei hyväksynyt sisäkkäistä models-määritystä.	Päivitä OpenCode versioon, joka noudattaa v1-skeemaa (opencode.ai/config.json).

---

Katso myös

• API-viite — OmniRoute REST -rajapinnan täydellinen kuvaus
• Auto-Combo — mitä model: "auto" tarkoittaa
• @omniroute/opencode-provider-paketin README
• Lähdekoodi: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts