Namestitev OpenCode in konfiguracija OmniProxy

OpenCode je odprtokodni pomočnik za kodiranje, ki vam omogoča pisanje kode iz terminala, IDE ali namizja. Ne shranjuje vaše kode ali konteksta, zato je primeren za projekte, občutljive na zasebnost. build se uporablja za spreminjanje projekta, medtem ko je plan privzeto samo za branje in je koristen za razumevanje neznane kode ter načrtovanje sprememb, preden jih izvedete. Storitev modela lahko izberete glede na svoje potrebe.

Preden začnete

Namestitveni skript je najlažja možnost. Potrebujete sodoben terminal – terminalsko aplikacijo, ki lahko izvaja ukaze in dela z datotekami projekta – kot so WezTerm, Alacritty, Ghostty ali Kitty. V sistemu Windows je priporočljiv WSL. Zagotavlja okolje Linux znotraj sistema Windows z bolj popolno zmogljivostjo in funkcionalnostjo.

Najlažje

Namestitveni skript

• curl opencode.ai/install
• Uporabite neposredno v macOS Linux
• WSL je priporočljiv v sistemu Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Posodobljeno pogosteje kot formula
• Paket je na voljo tudi za Arch

Izvirni Windows

Upravitelj paketov

• choco ali scoop
• Ali namestite globalno z npm
• Prenesete ga lahko tudi iz Releases

Pripravite tudi ID modela s trenutnega seznama modelov. ID modela je ime, ki ga storitev uporablja za natančno identifikacijo določenega modela.

Prva namestitev in zagon

Najlažji ukaz za namestitev je:

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

Uporabite lahko tudi eno od teh metod namestitve:

• Node.js: npm install -g opencode-ai. Bun, pnpm in Yarn imajo prav tako ustrezne ukaze za globalno namestitev; glejte uvodno stran na koncu tega vodnika.
• Homebrew v macOS in Linuxu: brew install anomalyco/tap/opencode. Uporabite ta tap, ker se posodablja pogosteje kot brew install opencode, ki ga vzdržuje ekipa Homebrew.
• Arch Linux: uporabite sudo pacman -S opencode za stabilno izdajo ali paket AUR opencode-bin za novejšo različico.
• Windows: uporabite choco install opencode ali scoop install opencode. Uporabite lahko tudi npm install -g opencode-ai. Binarno datoteko lahko prenesete tudi iz Releases. Podpora za namestitev z Bun v sistemu Windows je še v razvoju.

Vstopite v mapo projekta in zaženite OpenCode:

cd /path/to/project
opencode

Ob prvi uporabi lahko zaženete /init. Analizira projekt in ustvari AGENTS.md v korenu projekta. To datoteko lahko uveljavite (commit) v Git, tako da projekt ohrani ta navodila.

Pridobitev vrednosti povezave iz OmniProxy

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

baseURL je naslov storitve, API Key je poverilnica za dostop, Model ID pa polno ime modela.

Pri uporabi /v1/chat/completions nastavite paket npm na @ai-sdk/openai-compatible. Chat Completions je vrsta vmesnika za zahteve klepeta. Preklopite na @ai-sdk/openai le, ko model uporablja /v1/responses. Ko se OmniProxy uporablja prek končne točke za dokončanje klepeta, ohranite paket združljivosti.

Kopirajte celoten ID modela s trenutnega seznama OmniProxy, vključno s poševnicami. Od 2026-10-09 sta bila dva referenčna ID-ja claude-sonnet-5-5 in gpt-6-luna. gpt-6-luna podpira Chat Completions; klicanje funkcij prek Chat Completions je podprto le, če je reasoning_effort nastavljen na none. Ne kopirajte ID-ja, ki ga ni na seznamu.

Vnos konfiguracije orodja

Ponudnika (Provider) lahko razumemo kot nabor konfiguracijskih vrednosti, ki jih OpenCode uporablja za povezavo s storitvijo modela. Dokumentacija ponudnika obravnava storitev, združljivo z OpenAI, ki ni navedena pod /connect, kot ponudnika po meri. Storitev, združljiva z OpenAI, uporablja enak format zahtev in jo lahko kliče ista vrsta odjemalca.

1. V OpenCode zaženite /connect in se pomaknite do Other.
2. Vnesite ID ponudnika. Spodnji primer uporablja omniproxy. Izberite ID, ki si ga je lahko zapomniti, saj ga morate uporabiti istega v konfiguracijski datoteki.
3. Vnesite ključ API OmniProxy. Ta korak shrani le poverilnico; naslov in modele je treba še dodati v opencode.json. Poverilnica je shranjena v ~/.local/share/opencode/auth.json.
4. Ustvarite ali spremenite opencode.json v mapi projekta:

{
  "$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. Zaženite /models. Ponudnik po meri in njegovi modeli se bodo pojavili na seznamu.

ID, vnesen pod /connect, se mora ujemati s ključem v opencode.json. V to datoteko ne vnašajte pravega tajnega ključa. Če ne uporabljate /connect, lahko v options.apiKey uporabite sintakso okoljske spremenljivke, na primer {env:VARIABLE_NAME}. Pri testiranju 2026-10-09 z OpenCode 1.18.34 je bila povezava uspešna tudi, če je bil ključ neposredno v options.apiKey projekta brez uporabe /connect. Če prehod ne preverja ključa, je ta vrednost lahko nadomestni niz, ki se uporablja samo v lokalnem računalniku. Ključi pod models morajo uporabljati celotne ID-je s seznama.

Ključ

/connect

• Na dnu izberite Other
• Izberite svoj ID ponudnika
• Shranjeno v auth.json

Projekt

opencode.json

• Ključ ponudnika mora uporabljati isto ime
• Uporabite združljiv paket npm
• baseURL se konča z /v1

Izberite

/models

• Model se prikaže na seznamu
• Pred vprašanjem izberite enega
• Uporabite ID s seznama prehoda

Preverjanje z dejansko nalogo

Najprej zaženite eno dejansko nalogo iz mape projekta. Format reference modela je Provider ID/model ID; ohranite vse poševnice znotraj ID-ja modela:

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

--auto omogoča, da ta zagon uporablja orodja, kot so orodja za branje datotek. Pri testiranju 2026-10-09 z OpenCode 1.18.34 je uspešno prebral vsebino določene datoteke. Prvi zagon je trajal približno dve minuti.

Za interaktivno uporabo zaženite opencode, nato izberite model z /models. Za iskanje datotek lahko uporabite @. Uporabite opencode auth list za potrditev poverilnice, shranjene prek /connect, nato preverite zapise zahtev OmniProxy, da preverite vir in ID modela.

Zagon

OpenCode se zažene

• Najprej cd v projekt
• auth list prikazuje ID
• Konfiguracijska datoteka je v projektu

Naloga

Prebral je kodo

• Vprašajte o določeni datoteki
• Preglejte njegovo razlago
• Če je narobe, uporabite /undo

Dnevniki

Vidno v prehodu

• Vir je OpenCode
• ID modela se ujema
• Ne uveljavljajte (commit) ključa

Pogoste napake

• OmniProxy se ne prikaže pod /models: Preverite, ali se ID, vnesen pod /connect, ujema s ključem v opencode.json, da je npm nastavljen na @ai-sdk/openai-compatible in da se baseURL konča z /v1.
• Poverilnica manjka: Zaženite opencode auth list. Ponudniki, kot je Bedrock, ki se zanašajo na okoljske spremenljivke, se tukaj ne prikažejo; ponudnik po meri, konfiguriran prek /connect, bi moral biti viden.
• Funkcionalnost Windows je nepopolna: Namesto tega uporabite namestitveni skript znotraj WSL.
• ID modela ni veljaven: Ponovno ga kopirajte s trenutnega seznama OmniProxy in posodobite ustrezni ključ pod models.
• Zahteve gredo na napačno končno točko: Ohranite @ai-sdk/openai-compatible za dokončanje klepeta. Ne spreminjajte paketa za vmesnik Responses, razen če ta model na OmniProxy dejansko uporablja /v1/responses.

Uradne reference

Za namestitev glejte Uvod v OpenCode. Za ponudnike po meri glejte Ponudniki. Za ID-je modelov, uporabljene v primerih, glejte pregled modelov Claude in GPT-6 Luna.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · OpenCode ↗