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

OpenCode Integration (Српски)

🌐 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 · 🇳🇬 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 · 🇸🇪 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/ (радни простор који се може објавити)

OpenCode је агентски CLI/десктоп AI клијент. Свој каталог добављача чита из ~/.config/opencode/opencode.json (или opencode.jsonc) и прати шему на адреси https://opencode.ai/config.json. OmniRoute се OpenCode-у представља као један од тих добављача — сваки захтев пролази кроз OmniRoute-ов стандардни /v1 интерфејс компатибилан са OpenAI-јем, тако да OpenCode аутоматски користи предности Auto-Combo усмеравања, прекидача кола, политика кључева, опсервабилности итд.

Постоје два подржана начина интеграције. Изаберите један — оба генеришу исту конфигурацију.

---

Путања 1 — CLI генератор (без npm инсталације)

Препоручује се крајњим корисницима. Испоручује се уз OmniRoute. Уписује измене директно у opencode.json.

# Након инсталирања OmniRoute-а (npm i -g @omniroute/cli или локални клон)
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": "<ваш-кључ>",
      },
      "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 токови, монорепозиторијуми, прилагођени токови инсталације).

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));

За недеструктивно обједињавање са постојећом датотеком, поновите логику из mergeOpenCodeConfigText() у opencodeConfig.ts или позовите CLI генератор.

Комплетан API потражите у README-у пакета.

---

Шта окружење за извршавање заправо ради

Обе путање производе исти provider.omniroute.npm: "@ai-sdk/openai-compatible". Током извршавања, OpenCode учитава @ai-sdk/openai-compatible (који је већ транзитивна зависност OpenCode-а) и конфигурише га помоћу baseURL + apiKey. Након тога:

OpenCode кориснички интерфејс/агент
   → @ai-sdk/openai-compatible
      → HTTP POST {baseURL}/chat/completions          (OmniRoute OpenAI интерфејс)
         → OmniRoute /v1/chat/completions обрађивач   (open-sse/handlers/chatCore.ts)
            → комбиновано усмеравање / Auto-Combo / извршилац
               → узводни добављач

Додатак никада не приступа 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

Ово уклањање дупликата је најчешћи узрок неисправности у старијим конфигурацијама. Ако имате opencode.json из периода пре верзије v3.8.0 који упућује на /v1/v1/..., поново покрените генератор или поново позовите createOmniRouteProvider.

---

Режими аутентификације

OmniRoute поставка	Препоручена вредност за apiKey
REQUIRE_API_KEY=false (подразумевано локално)	sk_omniroute (дословна вредност чувара места)
REQUIRE_API_KEY=true	Стварни API кључ за појединачног корисника из Контролна табла → API кључеви.

За клијенте у Anthropic стилу који шаљу x-api-key + anthropic-version, OmniRoute extractApiKey такође прихвата кључ из x-api-key. OpenCode користи OpenAI интерфејс, па ће увек слати Authorization: Bearer ${apiKey} — Anthropic посебан случај се овде не примењује.

---

Решавање проблема

Симптом	Узрок	Решење
404 на сваком захтеву чији URL садржи /v1/v1/	Застарела конфигурација додатка пре v3.8 која је двапут додавала /v1.	Поново генеришите помоћу путање 1 или 2.
401 Invalid API key	OmniRoute има REQUIRE_API_KEY=true, а кључ није познат.	Направите кључ на контролној табли или поставите REQUIRE_API_KEY=false (само локално) и користите sk_omniroute.
Листа модела је празна у OpenCode корисничком интерфејсу	Сва 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