OpenCode telepítése és OmniProxy konfigurálása

Az OpenCode egy nyílt forráskódú kódolási asszisztens, amely lehetővé teszi, hogy terminálból, IDE-ből vagy asztali gépről írjon kódot. Nem tárolja a kódját vagy a környezetét, így alkalmas adatvédelmi szempontból érzékeny projektekhez. A build a projekt módosítására szolgál, míg a plan alapértelmezés szerint csak olvasható, és hasznos az ismeretlen kód megértéséhez és a változtatások megtervezéséhez, mielőtt végrehajtaná azokat. Igényei alapján választhat modellszolgáltatást.

Mielőtt elkezdené

A telepítőszkript a legegyszerűbb lehetőség. Szüksége van egy modern terminálra—egy terminálalkalmazásra, amely képes parancsokat futtatni és projektfájlokkal dolgozni—mint például a WezTerm, Alacritty, Ghostty vagy Kitty. Windowson a WSL ajánlott. Ez egy Linux környezetet biztosít a Windowson belül, teljesebb teljesítménnyel és funkcionalitással.

Legegyszerűbb

Telepítőszkript

• curl opencode.ai/install
• Használja közvetlenül macOS-en Linuxon
• A WSL ajánlott Windowson

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Gyakrabban frissítve, mint a formula
• Egy csomag Arch-hoz is elérhető

Natív Windows

Csomagkezelő

• choco vagy scoop
• Vagy telepítse globálisan npm-mel
• Letöltheti a kiadásokból is

Készítse elő az aktuális modelllistából származó modellazonosítót is. A modellazonosító az a név, amelyet a szolgáltatás egy adott modell pontos azonosítására használ.

Telepítés és első indítás

A legegyszerűbb telepítési parancs:

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

Használhatja a következő telepítési módszerek egyikét is:

• Node.js: npm install -g opencode-ai. A Bun, a pnpm és a Yarn szintén rendelkezik megfelelő globális telepítési parancsokkal; lásd a bevezető oldalt ennek az útmutatónak a végén.
• Homebrew macOS-en és Linuxon: brew install anomalyco/tap/opencode. Használja ezt a tap-et, mert gyakrabban frissül, mint a brew install opencode, amelyet a Homebrew csapata tart karban.
• Arch Linux: használja a sudo pacman -S opencode-t a stabil kiadáshoz, vagy az AUR csomagot opencode-bin egy újabb verzióhoz.
• Windows: használja a choco install opencode vagy scoop install opencode parancsot. Használhatja a npm install -g opencode-ai-t is. A bináris fájlok letölthetők a kiadásokból is. A Bun-nal történő telepítés támogatása Windowson még folyamatban van.

Lépjen be a projektkönyvtárába, majd indítsa el az OpenCode-ot:

cd /path/to/project
opencode

Amikor először használja, futtathatja a /init-t. Ez elemzi a projektet, és létrehozza a AGENTS.md-t a projekt gyökerében. Ez a fájl véglegesíthető a Git-ben, így a projekt megőrzi ezeket az utasításokat.

Csatlakozási értékek beszerzése az OmniProxytól

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

A baseURL a szolgáltatási cím, a API Key a hozzáférési hitelesítő adat, a Model ID pedig a modell teljes neve.

Amikor a /v1/chat/completions-t használja, állítsa az npm csomagot @ai-sdk/openai-compatible-ra. A Chat Completions egyfajta csevegési kérésfelület. Csak akkor váltson @ai-sdk/openai-re, ha a modell /v1/responses-t használ. Amikor az OmniProxy-t a csevegés-kiegészítési végponton keresztül használja, tartsa meg a kompatibilitási csomagot.

Másolja ki a teljes modellazonosítót az OmniProxy aktuális listájából, beleértve a perjelt is. 2026-10-09-től két hivatkozási azonosító volt a claude-sonnet-5-5 és a gpt-6-luna. A gpt-6-luna támogatja a Chat Completions-t; a függvényhívás a Chat Completions-en keresztül csak akkor támogatott, ha a reasoning_effort értéke none. Ne másoljon olyan azonosítót, amely nem szerepel a listában.

Az eszköz konfigurációjának megadása

A szolgáltató (Provider) olyan konfigurációs értékek készleteként értelmezhető, amelyet az OpenCode a modellszolgáltatáshoz való csatlakozáshoz használ. A szolgáltatói dokumentáció az OpenAI-kompatibilis szolgáltatást, amely nem szerepel a /connect alatt, egyéni szolgáltatóként kezeli. Az OpenAI-kompatibilis szolgáltatás ugyanazt a kérésformátumot használja, és ugyanaz a típusú kliens hívhatja meg.

1. Futtassa a /connect-t az OpenCode-ban, és görgessen az Other (Egyéb) részhez.
2. Adjon meg egy szolgáltatói azonosítót. Az alábbi példa a omniproxy-t használja. Válasszon egy könnyen megjegyezhető azonosítót, mert ugyanazt kell használnia a konfigurációs fájlban.
3. Adja meg az OmniProxy API-kulcsot. Ez a lépés csak a hitelesítő adatot menti; a címet és a modelleket továbbra is hozzá kell adni a opencode.json-hoz. A hitelesítő adat a ~/.local/share/opencode/auth.json-ben tárolódik.
4. Hozza létre vagy módosítsa a opencode.json-t a projektkönyvtárban:

{
  "$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. Futtassa a /models-t. Az egyéni szolgáltató és modelljei megjelennek a listában.

A /connect alatt megadott azonosítónak meg kell egyeznie a opencode.json kulcsával. Ne tegyen valódi titkos kulcsot ebbe a fájlba. Ha nem használ /connect-t, használhat környezeti változó szintaxist a options.apiKey-ben, például {env:VARIABLE_NAME}. A 2026-10-09-i tesztelés során az OpenCode 1.18.34-gyel, a kulcs közvetlen elhelyezése a projekt options.apiKey-jében a /connect használata nélkül szintén sikeresen csatlakozott. Ha a gateway nem érvényesíti a kulcsot, ez az érték lehet egy helyőrző karakterlánc, amelyet csak a helyi gépen használnak. A models alatti kulcsoknak a listából származó teljes azonosítókat kell használniuk.

Kulcs

/connect

• Válassza az Other lehetőséget alul
• Válassza ki saját szolgáltatói azonosítóját
• Tárolva az auth.json-ban

Projekt

opencode.json

• A szolgáltatói kulcsnak ugyanazt a nevet kell használnia
• Használjon kompatibilis npm csomagot
• A baseURL /v1-re végződik

Kiválasztás

/models

• A modell megjelenik a listában
• Válasszon egyet, mielőtt kérdést tenne fel
• Használja a gateway listájából származó azonosítót

Ellenőrzés valódi feladattal

Először futtasson egy valódi feladatot a projektkönyvtárból. A modellhivatkozás formátuma Provider ID/model ID; őrizze meg a modellazonosítón belüli perjelt:

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

A --auto lehetővé teszi, hogy ez a futtatás olyan eszközöket használjon, mint a fájlolvasó eszközök. A 2026-10-09-i tesztelés során az OpenCode 1.18.34-gyel sikeresen elolvasta a megadott fájl tartalmát. Az első futtatás körülbelül két percig tartott.

Interaktív használathoz futtassa a opencode-t, majd válasszon modellt a /models-mal. Használhatja a @-t fájlok keresésére. Használja a opencode auth list-t a /connect-n keresztül mentett hitelesítő adat megerősítésére, majd ellenőrizze az OmniProxy kérésrekordjait a forrás és a modellazonosító ellenőrzéséhez.

Indítás

az opencode elindul

• Először cd a projekthez
• az auth list mutatja az azonosítót
• A konfigurációs fájl a projektben van

Feladat

Elolvasta a kódot

• Kérdezzen egy adott fájlról
• Tekintse át a magyarázatát
• Használja a /undo parancsot, ha rossz

Naplók

Látható a gateway-ben

• A forrás OpenCode
• A modellazonosító egyezik
• Ne véglegesítse a kulcsot

Gyakori hibák

• Az OmniProxy nem jelenik meg a /models alatt: Ellenőrizze, hogy a /connect alatt megadott azonosító megegyezik-e a opencode.json kulcsával, hogy a npm értéke @ai-sdk/openai-compatible, és hogy a baseURL a /v1-ra végződik.
• A hitelesítő adat hiányzik: Futtassa a opencode auth list-t. Az olyan szolgáltatók, mint a Bedrock, amelyek környezeti változókra támaszkodnak, nem jelennek meg itt; egy /connect-n keresztül konfigurált egyéni szolgáltatónak láthatónak kell lennie.
• A Windows funkcionalitása nem teljes: Használja a telepítőszkriptet a WSL-en belül.
• A modellazonosító érvénytelen: Másolja ki újra az OmniProxy aktuális listájából, és frissítse a megfelelő kulcsot a models alatt.
• A kérések rossz végpontra mennek: Tartsa meg a @ai-sdk/openai-compatible-t a csevegés-kiegészítésekhez. Ne változtassa meg a csomagot a Responses felülethez, hacsak az OmniProxy-n lévő modell ténylegesen nem használ /v1/responses-t.

Hivatalos hivatkozások

A telepítéshez lásd az OpenCode bevezetőt. Az egyéni szolgáltatókért lásd a Szolgáltatók részt. A példákban használt modellazonosítókért lásd a Claude modell áttekintést és a GPT-6 Luna oldalt.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · OpenCode ↗