OpenCoden asennus ja OmniProxyn konfigurointi

OpenCode on avoimen lähdekoodin koodausavustaja, jonka avulla voit kirjoittaa koodia päätteestä, IDE:stä tai työpöydältä. Se ei tallenna koodiasi tai kontekstiasi, mikä tekee siitä sopivan yksityisyyttä vaativille projekteille. build käytetään projektin muokkaamiseen, kun taas plan on oletusarvoisesti vain luku -tilassa ja on hyödyllinen tuntemattoman koodin ymmärtämiseen ja muutosten suunnitteluun ennen niiden tekemistä. Voit valita mallipalvelun tarpeidesi mukaan.

Ennen kuin aloitat

Asennusskripti on helpoin vaihtoehto. Tarvitset modernin päätteen – pääteohjelman, joka voi suorittaa komentoja ja työskennellä projektitiedostojen kanssa – kuten WezTerm, Alacritty, Ghostty tai Kitty. Windowsissa WSL on suositeltu. Se tarjoaa Linux-ympäristön Windowsin sisällä, jossa on täydellisempi suorituskyky ja toiminnallisuus.

Helpoin

Asennusskripti

• curl opencode.ai/install
• Käytä suoraan macOS:ssä Linuxissa
• WSL on suositeltu Windowsissa

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Päivitetään useammin kuin kaava
• Paketti on saatavilla myös Archille

Natiivi Windows

Paketinhallinta

• choco tai scoop
• Tai asenna globaalisti npm:llä
• Voit myös ladata sen julkaisuista (Releases)

Valmistele myös mallin tunniste nykyisestä malliluettelosta. Mallin tunniste on nimi, jota palvelu käyttää tietyn mallin tunnistamiseen tarkasti.

Asennus ja ensimmäinen käynnistys

Helpoin asennuskomento on:

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

Voit käyttää myös jotakin näistä asennustavoista:

• Node.js: npm install -g opencode-ai. Bun, pnpm ja Yarn sisältävät myös vastaavat globaalit asennuskomennot; katso johdantosivu tämän oppaan lopusta.
• Homebrew macOS:ssä ja Linuxissa: brew install anomalyco/tap/opencode. Käytä tätä tap-lähdettä, koska sitä päivitetään useammin kuin brew install opencode, jota Homebrew-tiimi ylläpitää.
• Arch Linux: käytä sudo pacman -S opencode vakaalle julkaisulle tai AUR-pakettia opencode-bin uudemmalle versiolle.
• Windows: käytä choco install opencode tai scoop install opencode. Voit myös käyttää npm install -g opencode-ai. Binääritiedostot voidaan myös ladata julkaisuista. Bun-asennuksen tuki Windowsissa on vielä työn alla.

Siirry projektihakemistoosi ja käynnistä OpenCode:

cd /path/to/project
opencode

Kun käytät sitä ensimmäistä kertaa, voit suorittaa /init. Se analysoi projektin ja luo AGENTS.md projektin juureen. Tämä tiedosto voidaan tallentaa Gitiin, jotta projekti säilyttää nämä ohjeet.

Hae yhteysarvot OmniProxysta

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

baseURL on palvelun osoite, API Key on pääsyvaltuus ja Model ID on mallin koko nimi.

Kun käytät /v1/chat/completions, aseta npm-paketti muotoon @ai-sdk/openai-compatible. Chat Completions on eräänlainen chat-pyyntöliittymä. Vaihda pakettiin @ai-sdk/openai vain, kun malli käyttää rajapintaa /v1/responses. Kun OmniProxya käytetään chat completions -päätepisteen kautta, säilytä yhteensopivuuspaketti.

Kopioi koko mallin tunniste OmniProxyn nykyisestä luettelosta, mukaan lukien mahdolliset vinoviivat. 9.10.2026 kaksi viitetunnistetta olivat claude-sonnet-5-5 ja gpt-6-luna. gpt-6-luna tukee Chat Completionsia; funktioiden kutsuminen Chat Completionsin kautta on tuettu vain, kun reasoning_effort on none. Älä kopioi tunnistetta, joka ei ole luettelossa.

Syötä työkalun konfiguraatio

Palveluntarjoaja (Provider) voidaan ymmärtää joukkona konfiguraatioarvoja, joita OpenCode käyttää mallipalveluun yhdistämiseen. Palveluntarjoajan dokumentaatio käsittelee OpenAI-yhteensopivaa palvelua, jota ei ole lueteltu kohdassa /connect mukautettuna palveluntarjoajana. OpenAI-yhteensopiva palvelu käyttää samaa pyyntömuotoa ja sitä voi kutsua samantyyppinen asiakas.

1. Suorita /connect OpenCodessa ja vieritä kohtaan Other.
2. Syötä palveluntarjoajan tunniste. Alla oleva esimerkki käyttää omniproxy. Valitse tunniste, joka on helppo muistaa, koska sinun on käytettävä samaa konfiguraatiotiedostossa.
3. Syötä OmniProxy API-avain. Tämä vaihe tallentaa vain valtuustiedot; osoite ja mallit on silti lisättävä kohtaan opencode.json. Valtuustiedot tallennetaan tiedostoon ~/.local/share/opencode/auth.json.
4. Luo tai muokkaa opencode.json projektihakemistossa:

{
  "$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. Suorita /models. Mukautettu palveluntarjoaja ja sen mallit ilmestyvät luetteloon.

Kohdassa /connect syötetyn tunnisteen on vastattava tiedoston opencode.json avainta. Älä laita oikeaa salaista avainta tähän tiedostoon. Jos et käytä /connect, voit käyttää ympäristömuuttujasyntaksia tiedostossa options.apiKey, kuten {env:VARIABLE_NAME}. Testauksessa 9.10.2026 OpenCode 1.18.34 -versiolla avaimen laittaminen suoraan projektin options.apiKey tiedostoon ilman /connect käyttöä yhdisti myös onnistuneesti. Jos yhdyskäytävä ei validoi avainta, tämä arvo voi olla vain paikallisella koneella käytetty paikkamerkkijono. Kohdan models alla olevien avainten on käytettävä luettelon täydellisiä tunnisteita.

Avain

/connect

• Valitse Other alareunasta
• Valitse oma palveluntarjoajan tunniste
• Tallennettu tiedostoon auth.json

Projekti

opencode.json

• Palveluntarjoajan avaimen on käytettävä samaa nimeä
• Käytä yhteensopivaa npm-pakettia
• baseURL päättyy /v1

Valitse

/models

• Malli ilmestyy luetteloon
• Valitse yksi ennen kysymyksen esittämistä
• Käytä yhdyskäytäväluettelon tunnistetta

Vahvista todellisella tehtävällä

Suorita yksi todellinen tehtävä projektihakemistosta ensin. Malliviitteen muoto on Provider ID/model ID; säilytä mahdolliset vinoviivat mallin tunnisteessa:

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

--auto sallii tämän ajon käyttää työkaluja, kuten tiedostonlukutyökaluja. Testauksessa 9.10.2026 OpenCode 1.18.34 -versiolla se luki määritetyn tiedoston sisällön onnistuneesti. Ensimmäinen ajo kesti noin kaksi minuuttia.

Interaktiivista käyttöä varten suorita opencode, valitse sitten malli komennolla /models. Voit käyttää @ tiedostojen etsimiseen. Käytä opencode auth list vahvistaaksesi kautta tallennetut valtuustiedot /connect, tarkista sitten OmniProxyn pyyntölokit lähteen ja mallin tunnisteen vahvistamiseksi.

Käynnistys

opencode käynnistyy

• Siirry ensin projektiin cd-komennolla
• auth list näyttää tunnisteen
• Konfiguraatiotiedosto on projektissa

Tehtävä

Se luki koodin

• Kysy tietystä tiedostosta
• Tarkista sen selitys
• Käytä /undo, jos se on väärin

Lokit

Näkyvissä yhdyskäytävässä

• Lähde on OpenCode
• Mallin tunniste täsmää
• Älä tallenna avainta arkistoon

Yleiset virheet

• OmniProxy ei näy kohdassa /models: Tarkista, että kohdassa /connect syötetty tunniste vastaa tiedoston opencode.jsonavainta, että npm on asetettu arvoon @ai-sdk/openai-compatibleja että baseURL päättyy /v1.
• Valtuustiedot puuttuvat: Suorita opencode auth list. Palveluntarjoajat, kuten Bedrock, jotka luottavat ympäristömuuttujiin, eivät näy tässä; kohdan /connect kautta määritetyn mukautetun palveluntarjoajan pitäisi näkyä.
• Windows-toiminnallisuus on puutteellinen: Käytä asennusskriptiä WSL:n sisällä.
• Mallin tunniste on virheellinen: Kopioi se uudelleen OmniProxyn nykyisestä luettelosta ja päivitä vastaava avain kohdassa models.
• Pyynnöt menevät väärään päätepisteeseen: Säilytä @ai-sdk/openai-compatible chat completions -toiminnolle. Älä muuta Responses-liittymän pakettia, ellei kyseinen malli OmniProxyssa todella käytä /v1/responses.

Viralliset viitteet

Katso asennus kohdasta OpenCode introduction. Katso mukautetut palveluntarjoajat kohdasta Providers. Katso esimerkeissä käytetyt mallitunnisteet kohdista Claude model overview ja GPT-6 Luna.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · OpenCode ↗