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

OpenCode Integration (አማርኛ)

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

---

ሁኔታ: በአጠቃላይ የሚገኝ። ታዳሚዎች: OpenCodeን ከOmniRoute ስርጭት ጋር የሚያገናኙ ኦፕሬተሮች። ዋና የመረጃ ምንጭ (የውቅር መርሐግብር): src/shared/services/opencodeConfig.ts ዋና የመረጃ ምንጭ (npm ጥቅል): @omniroute/opencode-provider/ (ሊታተም የሚችል workspace)

OpenCode ወኪል-ተኮር CLI/ዴስክቶፕ AI ደንበኛ ነው። የአቅራቢዎች ካታሎጉን ከ~/.config/opencode/opencode.json (ወይም opencode.jsonc) ያነባል፣ እንዲሁም በhttps://opencode.ai/config.json የሚገኘውን መርሐግብር ይከተላል። OmniRoute ራሱን ለOpenCode ከእነዚያ አቅራቢዎች እንደ አንዱ ያቀርባል — እያንዳንዱ ጥያቄ በOmniRoute መደበኛ OpenAI-ተኳኋኝ /v1 በይነገጽ በኩል ያልፋል፤ በዚህም OpenCode ከAuto-Combo ማዞሪያ፣ circuit breakers፣ የቁልፍ ፖሊሲዎች፣ ታዛቢነት እና ሌሎችም በራስ-ሰር ተጠቃሚ ይሆናል።

ሁለት የሚደገፉ የውህደት መንገዶች አሉ። አንዱን ይምረጡ — ሁለቱም ተመሳሳይ ውቅር ያመነጫሉ።

---

መንገድ 1 — CLI አመንጪ (npm መጫን አያስፈልግም)

ለዋና ተጠቃሚዎች የሚመከር። ከOmniRoute ጋር አብሮ ይቀርባል። opencode.jsonን ባለበት ቦታ ይጽፋል።

# OmniRouteን ከጫኑ በኋላ (npm i -g @omniroute/cli ወይም አካባቢያዊ clone)
omniroute config opencode \
  --base-url http://localhost:20128 \
  --api-key "$OMNIROUTE_API_KEY"

ከጀርባ CLIው mergeOpenCodeConfigText()ን (src/shared/services/opencodeConfig.ts:104) ይጠራል፤ ስለዚህ ቀድሞ ያለ opencode.json ሌሎች አቅራቢዎቹንና አስተያየቶቹን እንዳሉ ያቆያል። የOmniRoute ግቤት በአቶሚክ ሁኔታ ይጨመራል/ይተካል።

የሚገኘው ፋይል (ነባሪ የሞዴል ካታሎግ):

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

---

መንገድ 2 — npm ጥቅል @omniroute/opencode-provider

ውቅሩን ከNode/TS በስክሪፕት ሲያዘጋጁ (CI pipelines፣ monorepos፣ ብጁ የመጫኛ ፍሰቶች) የሚመከር።

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",
  // አማራጭ፦ ለOpenCode የሚቀርበውን የሞዴል ካታሎግ ይተኩ
  models: ["auto", "claude-opus-4-7", "gpt-5.5"],
  modelLabels: { auto: "Auto-Combo" },
});

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

ከነባር ፋይል ጋር ሳያበላሽ ለማዋሃድ፣ ከopencodeConfig.ts የሚገኘውን mergeOpenCodeConfigText() ያባዙ ወይም CLI አመንጪውን ይጠቀሙ።

ለሙሉ API የጥቅሉን README ይመልከቱ።

---

Runtimeው በትክክል የሚያደርገው

ሁለቱም መንገዶች ተመሳሳዩን provider.omniroute.npm: "@ai-sdk/openai-compatible" ያመነጫሉ። በruntime፣ OpenCode @ai-sdk/openai-compatibleን (አስቀድሞ የOpenCode transitive dependency የሆነውን) ጭኖ በbaseURL + apiKey ያዋቅረዋል። ከዚያ በኋላ፦

OpenCode UI/ወኪል
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (የOmniRoute OpenAI በይነገጽ)
         → OmniRoute /v1/chat/completions ተቆጣጣሪ     (open-sse/handlers/chatCore.ts)
            → combo ማዞሪያ / Auto-Combo / executor
               → upstream አቅራቢ

pluginው HTTPን ፈጽሞ አይነካም። ውቅርን ብቻ ያመነጫል።

---

የሞዴል ካታሎግ ነባሪዎች

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;

በmodels: [...] መተካት ይችላሉ። የሚመከሩ ተጨማሪዎች፦

• "auto" — የOmniRouteን ያለምንም ውቅረት የሚሠራ Auto-Combo ራውተር ያቀርባል። ካታሎጉን በኮድዎ ውስጥ በቋሚነት ሳያስቀምጡ፣ OpenCode «ከሚገኙት ምርጡን ሞዴል» እንዲመርጥ ያስችለዋል።
• "<combo-name>" — በዳሽቦርዱ ውስጥ የገለጹት ማንኛውም ጥምረት፤ OmniRoute በግልጽነት ይፈታዋል።

---

የURL መደበኛነት

ረዳቱ ሁለቱንም ቅጾች ይቀበላል፣ እና በትክክል አንድ /v1 ያወጣል፦

ግቤት	ውጤት (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

ይህ ድግግሞሽን የማስወገድ ሂደት በድሮ ውቅሮች ውስጥ የሚታየው እጅግ የተለመደው የብልሽት ምክንያት ነው። ከv3.8.0 በፊት የተፈጠረ፣ ወደ /v1/v1/... የሚያመለክት opencode.json ካለዎት፣ ጀነሬተሩን እንደገና ያስኪዱ ወይም createOmniRouteProviderን እንደገና ይጥሩ።

---

የማረጋገጫ ሁነቶች

የOmniRoute ቅንብር	የሚመከር የapiKey እሴት
REQUIRE_API_KEY=false (ለአካባቢያዊ አጠቃቀም ነባሪ)	sk_omniroute (ቃል በቃል የሚጠቀም ቦታ ያዥ)
REQUIRE_API_KEY=true	ከዳሽቦርድ → API ቁልፎች የተገኘ እውነተኛ የእያንዳንዱ ተጠቃሚ API ቁልፍ።

x-api-key + anthropic-version ለሚልኩ የAnthropic-አይነት ደንበኞች፣ የOmniRoute extractApiKey ከx-api-key የሚመጣውን ቁልፍም ይቀበላል። OpenCode የOpenAIን በይነገጽ ስለሚጠቀም ሁልጊዜ Authorization: Bearer ${apiKey} ይልካል—እዚህ ምንም የAnthropic ልዩ አያያዝ አይተገበርም።

---

ችግር ፍቺ

ምልክት	ምክንያት	መፍትሔ
/v1/v1/ በያዘ URL ላይ ለእያንዳንዱ ጥያቄ 404	ከv3.8 በፊት ያለው ፕለጊን /v1ን ሁለት ጊዜ በመጨመሩ የቆየ ውቅር።	በመንገድ 1 ወይም 2 በመጠቀም እንደገና ያመንጩ።
401 Invalid API key	OmniRoute REQUIRE_API_KEY=true ተብሎ ተቀናብሯል፣ እና ቁልፉ አይታወቅም።	ቁልፉን በዳሽቦርዱ ውስጥ ይፍጠሩ፣ ወይም REQUIRE_API_KEY=false ያድርጉ (ለአካባቢያዊ አጠቃቀም ብቻ) እና sk_omnirouteን ይጠቀሙ።
በOpenCode UI ውስጥ የሞዴል ዝርዝሩ ባዶ ነው	ሁሉም 4 ነባሪ ሞዴሎች በOmniRoute አቅራቢ ታይነት ውስጥ ተደብቀዋል።	ያነቁዋቸውን ለማሳየት models: ["auto", ...]ን ያስተላልፉ።
OpenCode 500 ከcannot read property 'models' ጋር	የቆየ OpenCode (< 0.1.x) በውስጥ የተጻፈ modelsን አይቀበልም ነበር።	OpenCodeን የv1 ንድፍን (opencode.ai/config.json) ወደሚከተል ስሪት ያሻሽሉ።

---

በተጨማሪ ይመልከቱ

• የAPI ማጣቀሻ — ሙሉው የOmniRoute REST አገልግሎት ወሰን
• Auto-Combo — model: "auto" ምን ማለት እንደሆነ
• @omniroute/opencode-provider README
• ምንጭ፦ src/shared/services/opencodeConfig.ts፣ src/lib/cli-helper/config-generator/opencode.ts፣ @omniroute/opencode-provider/src/index.ts