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

OpenCode Integration (Български)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇩 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/ (работно пространство, което може да бъде публикувано)

OpenCode е агентен CLI/настолен AI клиент. Той прочита каталога си с доставчици от ~/.config/opencode/opencode.json (или opencode.jsonc) и следва схемата на https://opencode.ai/config.json. OmniRoute се представя пред OpenCode като един от тези доставчици — всяка заявка преминава през стандартния, съвместим с OpenAI интерфейс /v1 на OmniRoute, така че 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 генератора.

Вижте README на пакета за пълния API.

---

Какво всъщност прави средата за изпълнение

И двата начина създават една и съща стойност 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          (OpenAI интерфейс на OmniRoute)
         → манипулатор на 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" — предоставя достъп до маршрутизатора Auto-Combo на OmniRoute, който не изисква конфигуриране. Позволява на 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, extractApiKey на OmniRoute също приема ключа от 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 — пълният REST интерфейс на OmniRoute
• Auto-Combo — какво означава model: "auto"
• README на @omniroute/opencode-provider
• Изходен код: src/shared/services/opencodeConfig.ts, src/lib/cli-helper/config-generator/opencode.ts, @omniroute/opencode-provider/src/index.ts