„OpenCode“ diegimas ir „OmniProxy“ konfigūravimas

„OpenCode“ yra atvirojo kodo programavimo asistentas, leidžiantis rašyti kodą iš terminalo, IDE ar darbalaukio. Jis nesaugo jūsų kodo ar konteksto, todėl tinka privatumui jautriems projektams. build naudojamas projektui modifikuoti, o plan pagal numatytuosius nustatymus yra tik skaitomas ir naudingas norint suprasti nepažįstamą kodą bei planuoti pakeitimus prieš juos atliekant. Galite pasirinkti modelių paslaugą pagal savo poreikius.

Prieš pradedant

Diegimo scenarijus yra lengviausias pasirinkimas. Jums reikia modernaus terminalo – terminalo programos, kuri gali vykdyti komandas ir dirbti su projekto failais, pavyzdžiui, „WezTerm“, „Alacritty“, „Ghostty“ ar „Kitty“. „Windows“ sistemoje rekomenduojama „WSL“. Ji suteikia „Linux“ aplinką „Windows“ sistemoje su išsamesniu našumu ir funkcionalumu.

Lengviausia

Diegimo scenarijus

• curl opencode.ai/install
• Naudokite tiesiogiai „macOS“ „Linux“ sistemose
• „WSL“ rekomenduojama „Windows“ sistemoje

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Atnaujinama dažniau nei formulė
• Paketas taip pat prieinamas „Arch“

Vietinė „Windows“

Paketų tvarkyklė

• choco arba scoop
• Arba įdiekite visuotinai su „npm“
• Taip pat galite atsisiųsti iš „Releases“

Taip pat paruoškite modelio ID iš dabartinio modelių sąrašo. Modelio ID yra pavadinimas, kurį paslauga naudoja tiksliai identifikuoti konkretų modelį.

Pirmasis diegimas ir paleidimas

Lengviausia diegimo komanda yra:

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

Taip pat galite naudoti vieną iš šių diegimo būdų:

• Node.js: npm install -g opencode-ai. „Bun“, „pnpm“ ir „Yarn“ taip pat turi atitinkamas visuotinio diegimo komandas; žr. įžangos puslapį šio vadovo pabaigoje.
• Homebrew „macOS“ ir „Linux“ sistemose: brew install anomalyco/tap/opencode. Naudokite šį „tap“, nes jis atnaujinamas dažniau nei brew install opencode, kurį prižiūri „Homebrew“ komanda.
• Arch Linux: naudokite sudo pacman -S opencode stabiliam leidimui arba AUR paketą opencode-bin naujesnei versijai.
• Windows: naudokite choco install opencode arba scoop install opencode. Taip pat galite naudoti npm install -g opencode-ai. Vykdomuosius failus taip pat galima atsisiųsti iš „Releases“. „Bun“ diegimo „Windows“ sistemoje palaikymas vis dar kuriamas.

Įeikite į savo projekto katalogą, tada paleiskite „OpenCode“:

cd /path/to/project
opencode

Naudodami pirmą kartą, galite paleisti /init. Jis analizuoja projektą ir sukuria AGENTS.md projekto šaknyje. Šį failą galima įkelti į „Git“, kad projektas išsaugotų šias instrukcijas.

Ryšio reikšmių gavimas iš „OmniProxy“

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

baseURL yra paslaugos adresas, API Key yra prieigos kredencialas, o Model ID yra visas modelio pavadinimas.

Naudodami /v1/chat/completions, nustatykite „npm“ paketą į @ai-sdk/openai-compatible. „Chat Completions“ yra pokalbių užklausų sąsajos tipas. Perjunkite į @ai-sdk/openai tik tada, kai modelis naudoja /v1/responses. Kai „OmniProxy“ naudojamas per „chat completions“ galinį punktą, išlaikykite suderinamumo paketą.

Nukopijuokite visą modelio ID iš dabartinio „OmniProxy“ sąrašo, įskaitant visus pasviruosius brūkšnius. 2026-10-09 duomenimis, dvi nuorodos ID buvo claude-sonnet-5-5 ir gpt-6-luna. gpt-6-luna palaiko „Chat Completions“; funkcijų iškvietimas per „Chat Completions“ palaikomas tik tada, kai reasoning_effort yra none. Nekopijuokite ID, kurio nėra sąraše.

Įrankio konfigūracijos įvedimas

Teikėją (Provider) galima suprasti kaip konfigūracijos reikšmių rinkinį, kurį „OpenCode“ naudoja prisijungti prie modelio paslaugos. Teikėjo dokumentacijoje „OpenAI“ suderinama paslauga, kurios nėra sąraše po /connect laikoma pasirinktiniu teikėju. „OpenAI“ suderinama paslauga naudoja tą patį užklausos formatą ir ją gali iškviesti to paties tipo klientas.

1. Paleiskite /connect „OpenCode“ ir slinkite iki Other.
2. Įveskite teikėjo ID. Žemiau pateiktame pavyzdyje naudojamas omniproxy. Pasirinkite lengvai įsimenamą ID, nes tą patį turėsite naudoti konfigūracijos faile.
3. Įveskite „OmniProxy“ API raktą. Šis veiksmas išsaugo tik kredencialą; adresas ir modeliai vis tiek turi būti pridėti prie opencode.json. Kredencialas saugomas ~/.local/share/opencode/auth.json.
4. Sukurkite arba modifikuokite opencode.json projekto kataloge:

{
  "$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. Paleiskite /models. Pasirinktinis teikėjas ir jo modeliai pasirodys sąraše.

ID, įvestas po /connect turi sutapti su raktu opencode.json. Nedėkite tikro slapto rakto į šį failą. Jei nenaudojate /connect, galite naudoti aplinkos kintamojo sintaksę options.apiKey, pavyzdžiui, {env:VARIABLE_NAME}. 2026-10-09 atlikto testavimo su „OpenCode 1.18.34“ metu, įdėjus raktą tiesiai į projekto options.apiKey nenaudojant /connect taip pat pavyko sėkmingai prisijungti. Jei „gateway“ nepatvirtina rakto, ši reikšmė gali būti vietos rezervavimo eilutė, naudojama tik vietiniame kompiuteryje. Raktai po models turi naudoti visus ID iš sąrašo.

Raktas

/connect

• Pasirinkite „Other“ apačioje
• Pasirinkite savo teikėjo ID
• Saugoma auth.json

Projektas

opencode.json

• Teikėjo raktas turi naudoti tą patį pavadinimą
• Naudokite suderinamą „npm“ paketą
• baseURL baigiasi /v1

Pasirinkite

/models

• Modelis pasirodo sąraše
• Pasirinkite vieną prieš užduodami klausimą
• Naudokite ID iš „gateway“ sąrašo

Tikros užduoties patikrinimas

Pirmiausia paleiskite vieną tikrą užduotį iš projekto katalogo. Modelio nuorodos formatas yra Provider ID/model ID; išsaugokite visus pasviruosius brūkšnius modelio ID:

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

--auto leidžia šiam vykdymui naudoti įrankius, pvz., failų skaitymo įrankius. 2026-10-09 atlikto testavimo su „OpenCode 1.18.34“ metu, jis sėkmingai perskaitė nurodyto failo turinį. Pirmasis vykdymas užtruko apie dvi minutes.

Interaktyviam naudojimui paleiskite opencode, tada pasirinkite modelį su /models. Galite naudoti @ failų paieškai. Naudokite opencode auth list patvirtinti kredencialą, išsaugotą per /connect, tada patikrinkite „OmniProxy“ užklausų įrašus, kad patikrintumėte šaltinį ir modelio ID.

Paleidimas

„opencode“ paleidžiamas

• Pirmiausia „cd“ į projektą
• „auth list“ rodo ID
• Konfigūracijos failas yra projekte

Užduotis

Jis perskaitė kodą

• Paklauskite apie konkretų failą
• Peržiūrėkite jo paaiškinimą
• Naudokite /undo, jei jis neteisingas

Žurnalai

Matomi „gateway“

• Šaltinis yra „OpenCode“
• Modelio ID sutampa
• Nekelkite rakto į saugyklą

Dažnos klaidos

• „OmniProxy“ nerodomas po /models: Patikrinkite, ar ID, įvestas po /connect sutampa su raktu opencode.json, kad npm nustatytas į @ai-sdk/openai-compatible, ir kad baseURL baigiasi /v1.
• Trūksta kredencialo: Paleiskite opencode auth list. Teikėjai, tokie kaip „Bedrock“, kurie remiasi aplinkos kintamaisiais, čia nerodomi; pasirinktinis teikėjas, sukonfigūruotas per /connect turėtų būti matomas.
• „Windows“ funkcionalumas neišsamus: Vietoj to naudokite diegimo scenarijų „WSL“ viduje.
• Modelio ID neteisingas: Nukopijuokite jį dar kartą iš dabartinio „OmniProxy“ sąrašo ir atnaujinkite atitinkamą raktą po models.
• Užklausos siunčiamos į neteisingą galinį punktą: Išlaikykite @ai-sdk/openai-compatible pokalbių užbaigimui. Nekeiskite „Responses“ sąsajos paketo, nebent tas modelis „OmniProxy“ iš tikrųjų naudoja /v1/responses.

Oficialios nuorodos

Diegimą rasite OpenCode introduction. Individualius teikėjus rasite Providers. Pavyzdžiuose naudojamus modelių ID rasite Claude model overview ir GPT-6 Luna.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · OpenCode ↗