Инсталација OpenCode-а и конфигурација OmniProxy-а

OpenCode је асистент за кодирање отвореног кода који вам омогућава да пишете код из терминала, IDE-а или десктопа. Он не чува ваш код или контекст, што га чини погодним за пројекте осетљиве на приватност. build се користи за измену пројекта, док је plan подразумевано само за читање и користан је за разумевање непознатог кода и планирање измена пре него што их направите. Можете одабрати сервис модела према својим потребама.

Пре почетка

Инсталациона скрипта је најлакша опција. Потребан вам је модеран терминал — терминалска апликација која може да покреће команде и ради са датотекама пројекта — као што су WezTerm, Alacritty, Ghostty или Kitty. На Windows-у, WSL је пожељнији. Он обезбеђује Linux окружење унутар Windows-а са потпунијим перформансама и функционалношћу.

Најлакше

Инсталациона скрипта

• curl opencode.ai/install
• Користите директно на macOS Linux-у
• WSL се препоручује на Windows-у

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Ажурира се чешће од формуле
• Пакет је такође доступан за Arch

Нативни Windows

Менаџер пакета

• choco или scoop
• Или инсталирајте глобално са npm
• Такође га можете преузети са Releases

Такође припремите ID модела са тренутне листе модела. ID модела је име које сервис користи да прецизно идентификује одређени модел.

Инсталација и прво покретање

Најлакша команда за инсталацију је:

curl -fsSL https://opencode.ai/install | bash

Такође можете користити један од ових метода инсталације:

• Node.js: npm install -g opencode-ai. Bun, pnpm и Yarn такође имају одговарајуће команде за глобалну инсталацију; погледајте уводну страницу на крају овог водича.
• Homebrew на macOS-у и Linux-у: brew install anomalyco/tap/opencode. Користите овај tap јер се ажурира чешће од brew install opencode, који одржава Homebrew тим.
• Arch Linux: користите sudo pacman -S opencode за стабилно издање, или AUR пакет opencode-bin за новију верзију.
• Windows: користите choco install opencode или scoop install opencode. Такође можете користити npm install -g opencode-ai. Бинарне датотеке се такође могу преузети са Releases. Подршка за инсталацију са Bun-ом на Windows-у је још увек у развоју.

Уђите у директоријум свог пројекта, а затим покрените OpenCode:

cd /path/to/project
opencode

Када га користите први пут, можете покренути /init. Он анализира пројекат и креира AGENTS.md у корену пројекта. Ова датотека се може унети у Git тако да пројекат задржи ова упутства.

Добијање вредности за повезивање из OmniProxy-а

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL је адреса сервиса, API Key је акредитив за приступ, и Model ID је пуно име модела.

Када користите /v1/chat/completions, поставите npm пакет на @ai-sdk/openai-compatible. Chat Completions је тип интерфејса за захтеве за ћаскање. Пребаците се на @ai-sdk/openai само када модел користи /v1/responses. Када се OmniProxy користи преко endpoint-а за chat completions, задржите пакет компатибилности.

Копирајте цео ID модела са тренутне листе OmniProxy-а, укључујући све косе црте. Од 09.10.2026, два референтна ID-а су била claude-sonnet-5-5 и gpt-6-luna. gpt-6-luna подржава Chat Completions; позивање функција кроз Chat Completions је подржано само када reasoning_effort је none. Немојте копирати ID који није на листи.

Унос конфигурације алата

Провајдер се може разумети као скуп конфигурационих вредности које OpenCode користи за повезивање са сервисом модела. Документација провајдера третира сервис компатибилан са OpenAI-ом који није наведен под /connect као прилагођеног провајдера. Сервис компатибилан са OpenAI-ом користи исти формат захтева и може га позвати исти тип клијента.

1. Покрените /connect у OpenCode-у и скролујте до Other.
2. Унесите ID провајдера. Пример испод користи omniproxy. Изаберите ID који је лако запамтити јер морате користити исти у конфигурационој датотеци.
3. Унесите OmniProxy API кључ. Овај корак чува само акредитив; адреса и модели се ипак морају додати у opencode.json. Акредитив се чува у ~/.local/share/opencode/auth.json.
4. Креирајте или измените opencode.json у директоријуму пројекта:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Покрените /models. Прилагођени провајдер и његови модели ће се појавити на листи.

ID унет под /connect мора се поклапати са кључем у opencode.json. Немојте стављати прави тајни кључ у ову датотеку. Ако не користите /connect, можете користити синтаксу променљиве окружења у options.apiKey, као што је {env:VARIABLE_NAME}. У тестирању 09.10.2026 са OpenCode 1.18.34, стављање кључа директно у пројекат options.apiKey без коришћења /connect такође се успешно повезало. Ако gateway не потврђује кључ, ова вредност може бити placeholder стринг који се користи само на локалној машини. Кључеви под models морају користити пуне ID-ове са листе.

Кључ

/connect

• Изаберите Other на дну
• Изаберите свој ID провајдера
• Чува се у auth.json

Пројекат

opencode.json

• Кључ провајдера мора користити исто име
• Користите компатибилан npm пакет
• baseURL се завршава са /v1

Изаберите

/models

• Модел се појављује на листи
• Изаберите један пре постављања питања
• Користите ID са листе gateway-а

Верификација стварног задатка

Прво покрените један стварни задатак из директоријума пројекта. Формат референце модела је Provider ID/model ID; сачувајте све косе црте унутар ID-а модела:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto омогућава овом покретању да користи алате као што су алати за читање датотека. У тестирању 09.10.2026 са OpenCode 1.18.34, успешно је прочитао садржај наведене датотеке. Прво покретање је трајало око два минута.

За интерактивну употребу, покрените opencode, затим изаберите модел са /models. Можете користити @ за претрагу датотека. Користите opencode auth list да потврдите акредитив сачуван кроз /connect, затим проверите записе захтева OmniProxy-а да бисте верификовали извор и ID модела.

Покретање

opencode се покреће

• Прво cd у пројекат
• auth list приказује ID
• Конфигурациона датотека је у пројекту

Задатак

Прочитао је код

• Питајте о одређеној датотеци
• Прегледајте његово објашњење
• Користите /undo ако је погрешно

Логови

Видљиво у gateway-у

• Извор је OpenCode
• ID модела се поклапа
• Не уносите кључ у репозиторијум

Уобичајене грешке

• OmniProxy се не појављује под /models: Проверите да ли се ID унет под /connect поклапа са кључем у opencode.json, да је npm постављено на @ai-sdk/openai-compatible, и да се baseURL завршава са /v1.
• Акредитив недостаје: Покрените opencode auth list. Провајдери као што је Bedrock који се ослањају на променљиве окружења се овде не појављују; прилагођени провајдер конфигурисан кроз /connect би требало да буде видљив.
• Функционалност Windows-а је непотпуна: Уместо тога користите инсталациону скрипту унутар WSL-а.
• ID модела је неважећи: Копирајте га поново са тренутне листе OmniProxy-а и ажурирајте одговарајући кључ под models.
• Захтеви иду на погрешан endpoint: Задржите @ai-sdk/openai-compatible за chat completions. Немојте мењати пакет за интерфејс Responses осим ако тај модел на OmniProxy-у заиста не користи /v1/responses.

Званичне референце

За инсталацију, погледајте OpenCode introduction. За прилагођене провајдере, погледајте Providers. За ID-ове модела коришћене у примерима, погледајте Claude model overview и GPT-6 Luna.

Замените сваки чувар места вредностима из ваше OmniProxy конфигурације. Никада не објављујте стварни кључ.

Сачувани резултат или HTTP 200 сами по себи не доказују пуну компатибилност Агента. Проверите извор и модел у запису позива OmniProxy.

Званични извори · OpenCode ↗