OpenCode installimine ja OmniProxy konfiguratsioon

OpenCode on avatud lähtekoodiga kodeerimisassistent, mis võimaldab kirjutada koodi terminalist, IDE-st või töölaualt. See ei salvesta teie koodi ega konteksti, mistõttu sobib see privaatsustundlike projektide jaoks. build kasutatakse projekti muutmiseks, samas kui plan on vaikimisi kirjutuskaitstud ja kasulik võõra koodi mõistmiseks ning muudatuste kavandamiseks enne nende tegemist. Saate valida mudeliteenuse vastavalt oma vajadustele.

Enne alustamist

Installiskript on lihtsaim variant. Vajate kaasaegset terminali – terminalirakendust, mis suudab käivitada käske ja töötada projektifailidega – nagu WezTerm, Alacritty, Ghostty või Kitty. Windowsis on eelistatud WSL. See pakub Linuxi keskkonda Windowsis, millel on täielikum jõudlus ja funktsionaalsus.

Lihtsaim

Installiskript

• curl opencode.ai/install
• Kasutage otse macOS-il Linuxil
• WSL on Windowsis soovitatav

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Uuendatakse sagedamini kui valemit
• Pakett on saadaval ka Archile

Natiivne Windows

Paketihaldur

• choco või scoop
• Või installige globaalselt npm-iga
• Saate selle alla laadida ka väljalasetest

Valmistage ette ka mudeli ID praegusest mudelite loendist. Mudeli ID on nimi, mida teenus kasutab konkreetse mudeli täpseks tuvastamiseks.

Installimine ja esmakordne käivitamine

Lihtsaim installikäsk on:

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

Võite kasutada ka ühte neist installimeetoditest:

• Node.js: npm install -g opencode-ai. Bunil, pnpm-il ja Yarnil on ka vastavad globaalsed installikäsud; vaadake selle juhendi lõpus olevat tutvustuslehte.
• Homebrew macOS-il ja Linuxil: brew install anomalyco/tap/opencode. Kasutage seda tap-i, kuna seda uuendatakse sagedamini kui brew install opencode, mida haldab Homebrew meeskond.
• Arch Linux: kasutage sudo pacman -S opencode stabiilse väljalaske jaoks või AUR-i paketti opencode-bin uuema versiooni jaoks.
• Windows: kasutage choco install opencode või scoop install opencode. Võite kasutada ka npm install -g opencode-ai. Binaarfaile saab alla laadida ka väljalasetest. Buniga Windowsile installimise tugi on veel pooleli.

Sisenege oma projektikataloogi ja käivitage OpenCode:

cd /path/to/project
opencode

Esmakordsel kasutamisel saate käivitada /init. See analüüsib projekti ja loob AGENTS.md projekti juurkataloogi. Selle faili saab Git-i lisada, et projekt säilitaks need juhised.

Ühenduse väärtuste hankimine OmniProxyst

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

baseURL on teenuse aadress, API Key on juurdepääsutunnus ja Model ID on mudeli täisnimi.

Kui kasutate lõpp-punkti /v1/chat/completions, seadke npm-i pakett väärtusele @ai-sdk/openai-compatible. Chat Completions on vestluspäringu liidese tüüp. Lülituge väärtusele @ai-sdk/openai ainult siis, kui mudel kasutab /v1/responses. Kui OmniProxyt kasutatakse vestluse lõpetamise lõpp-punkti kaudu, säilitage ühilduvuspakett.

Kopeerige kogu mudeli ID OmniProxy praegusest loendist, sealhulgas kõik kaldkriipsud. Seisuga 2026-10-09 olid kaks viite-ID-d claude-sonnet-5-5 ja gpt-6-luna. gpt-6-luna toetab Chat Completionsi; funktsioonide kutsumine Chat Completionsi kaudu on toetatud ainult siis, kui reasoning_effort on none. Ärge kopeerige ID-d, mida loendis ei ole.

Tööriista konfiguratsiooni sisestamine

Teenusepakkujat (Provider) saab mõista kui konfiguratsiooniväärtuste kogumit, mida OpenCode kasutab mudeliteenusega ühenduse loomiseks. Teenusepakkuja dokumentatsioon käsitleb OpenAI-ga ühilduvat teenust, mida pole loetletud jaotises /connect kui kohandatud teenusepakkujat. OpenAI-ga ühilduv teenus kasutab sama päringuvormingut ja seda saab kutsuda sama tüüpi klient.

1. Käivitage /connect OpenCode’is ja kerige jaotiseni Other.
2. Sisestage teenusepakkuja ID. Alltoodud näites kasutatakse omniproxy. Valige ID, mida on lihtne meeles pidada, sest peate kasutama sama ID-d konfiguratsioonifailis.
3. Sisestage OmniProxy API võti. See samm salvestab ainult volikirja; aadress ja mudelid tuleb siiski lisada faili opencode.json. Volikiri salvestatakse faili ~/.local/share/opencode/auth.json.
4. Looge või muutke opencode.json projektikataloogis:

{
  "$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. Käivitage /models. Kohandatud teenusepakkuja ja selle mudelid ilmuvad loendisse.

Jaotises /connect sisestatud ID peab ühtima failis opencode.jsonoleva võtmega. Ärge pange sellesse faili päris salajast võtit. Kui te ei kasuta /connect, saate failis options.apiKeykasutada keskkonnamuutuja süntaksit, näiteks {env:VARIABLE_NAME}. 2026-10-09 tehtud testimisel OpenCode 1.18.34-ga õnnestus ühendus ka siis, kui panin võtme otse projekti faili options.apiKey ilma /connect kasutamata. Kui lüüs võtit ei valideeri, võib see väärtus olla kohatäitja string, mida kasutatakse ainult kohalikus masinas. Jaotise models all olevad võtmed peavad kasutama loendist täielikke ID-sid.

Võti

/connect

• Valige allosas Other
• Valige oma teenusepakkuja ID
• Salvestatud faili auth.json

Projekt

opencode.json

• Teenusepakkuja võti peab kasutama sama nime
• Kasutage ühilduvat npm-i paketti
• baseURL lõpeb /v1-ga

Valige

/models

• Mudel ilmub loendisse
• Valige üks enne küsimuse esitamist
• Kasutage lüüsi loendi ID-d

Kontrollige tegeliku ülesandega

Käivitage esmalt üks tegelik ülesanne projektikataloogist. Mudeliviite vorming on Provider ID/model ID; säilitage kõik mudeli ID-s olevad kaldkriipsud:

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

--auto võimaldab sellel käivitamisel kasutada tööriistu, näiteks faililugemise tööriistu. 2026-10-09 tehtud testimisel OpenCode 1.18.34-ga luges see edukalt määratud faili sisu. Esimene käivitamine võttis umbes kaks minutit.

Interaktiivseks kasutamiseks käivitage opencode, seejärel valige mudel käsuga /models. Failide otsimiseks saate kasutada @ . Kasutage opencode auth list volikirja kinnitamiseks, mis on salvestatud läbi /connect, seejärel kontrollige OmniProxy päringukirjeid, et kontrollida allikat ja mudeli ID-d.

Käivitamine

opencode käivitub

• Esmalt cd projekti
• auth list näitab ID-d
• Konfiguratsioonifail on projektis

Ülesanne

See luges koodi

• Küsige konkreetse faili kohta
• Vaadake selle selgitust
• Kasutage /undo, kui see on vale

Logid

Nähtav lüüsis

• Allikas on OpenCode
• Mudeli ID ühtib
• Ärge lisage võtit hoidlasse

Levinud vead

• OmniProxy ei ilmu jaotise /modelsalla: Kontrollige, kas jaotises /connect sisestatud ID ühtib failis opencode.jsonoleva võtmega, et npm on seatud väärtusele @ai-sdk/openai-compatibleja et baseURL lõpeb /v1-ga.
• Volikiri on puudu: Käivitage opencode auth list. Teenusepakkujad, nagu Bedrock, mis tuginevad keskkonnamuutujatele, siin ei ilmu; kohandatud teenusepakkuja, mis on konfigureeritud läbi /connect peaks olema nähtav.
• Windowsi funktsionaalsus on puudulik: Kasutage selle asemel WSL-i installiskripti.
• Mudeli ID on kehtetu: Kopeerige see uuesti OmniProxy praegusest loendist ja värskendage vastavat võtit jaotises models.
• Päringud lähevad valesse lõpp-punkti: Hoidke @ai-sdk/openai-compatible vestluse lõpetamiseks. Ärge muutke vastuste liidese paketti, välja arvatud juhul, kui see mudel OmniProxys tegelikult kasutab /v1/responses.

Ametlikud viited

Installimise kohta vaadake OpenCode introduction. Kohandatud teenusepakkujate kohta vaadake Providers. Näidetes kasutatud mudeli ID-de kohta vaadake Claude model overview ja GPT-6 Luna.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · OpenCode ↗