Inštalácia OpenCode a konfigurácia OmniProxy

OpenCode je open-source asistent na kódovanie, ktorý vám umožňuje písať kód z terminálu, IDE alebo plochy. Neukladá váš kód ani kontext, vďaka čomu je vhodný pre projekty citlivé na súkromie. build sa používa na úpravu projektu, zatiaľ čo plan je v predvolenom nastavení určený len na čítanie a je užitočný na pochopenie neznámeho kódu a plánovanie zmien pred ich vykonaním. Modelovú službu si môžete vybrať podľa svojich potrieb.

Skôr než začnete

Inštalačný skript je najjednoduchšia možnosť. Potrebujete moderný terminál – terminálovú aplikáciu, ktorá dokáže spúšťať príkazy a pracovať so súbormi projektu – ako napríklad WezTerm, Alacritty, Ghostty alebo Kitty. Vo Windows sa uprednostňuje WSL. Poskytuje linuxové prostredie v rámci Windows s lepším výkonom a funkčnosťou.

Najjednoduchšie

Inštalačný skript

• curl opencode.ai/install
• Použite priamo na macOS Linux
• WSL sa odporúča vo Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Aktualizované častejšie ako formula
• Balík je dostupný aj pre Arch

Natívny Windows

Správca balíkov

• choco alebo scoop
• Alebo nainštalujte globálne pomocou npm
• Môžete si ho stiahnuť aj z Releases

Pripravte si aj ID modelu z aktuálneho zoznamu modelov. ID modelu je názov, ktorý služba používa na presnú identifikáciu konkrétneho modelu.

Inštalácia a prvé spustenie

Najjednoduchší inštalačný príkaz je:

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

Môžete použiť aj jeden z týchto spôsobov inštalácie:

• Node.js: npm install -g opencode-ai. Bun, pnpm a Yarn majú tiež zodpovedajúce príkazy pre globálnu inštaláciu; pozrite si úvodnú stránku na konci tejto príručky.
• Homebrew na macOS a Linuxe: brew install anomalyco/tap/opencode. Použite tento tap, pretože sa aktualizuje častejšie ako brew install opencode, ktorý spravuje tím Homebrew.
• Arch Linux: použite sudo pacman -S opencode pre stabilné vydanie alebo balík AUR opencode-bin pre novšiu verziu.
• Windows: použite choco install opencode alebo scoop install opencode. Môžete použiť aj npm install -g opencode-ai. Binárne súbory možno stiahnuť aj z Releases. Podpora inštalácie pomocou Bun vo Windows je stále vo vývoji.

Prejdite do adresára projektu a spustite OpenCode:

cd /path/to/project
opencode

Pri prvom použití môžete spustiť /init. Analyzuje projekt a vytvorí AGENTS.md v koreňovom adresári projektu. Tento súbor možno pridať do Git, aby si projekt zachoval tieto pokyny.

Získanie hodnôt pripojenia z 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 adresa služby, API Key je prístupový údaj a Model ID je úplný názov modelu.

Pri použití /v1/chat/completions, nastavte balík npm na @ai-sdk/openai-compatible. Chat Completions je typ rozhrania pre chatové požiadavky. Prepnite na @ai-sdk/openai iba vtedy, ak model používa /v1/responses. Keď sa OmniProxy používa cez koncový bod chat completions, ponechajte balík kompatibility.

Skopírujte celé ID modelu z aktuálneho zoznamu OmniProxy, vrátane všetkých lomiek. K 9. 10. 2026 boli dve referenčné ID claude-sonnet-5-5 a gpt-6-luna. gpt-6-luna podporuje Chat Completions; volanie funkcií cez Chat Completions je podporované iba vtedy, keď reasoning_effort je none. Nekopírujte ID, ktoré nie je v zozname.

Zadanie konfigurácie nástroja

Poskytovateľa (Provider) možno chápať ako súbor konfiguračných hodnôt, ktoré OpenCode používa na pripojenie k modelovej službe. Dokumentácia poskytovateľa považuje službu kompatibilnú s OpenAI, ktorá nie je uvedená pod /connect , za vlastného (custom) poskytovateľa. Služba kompatibilná s OpenAI používa rovnaký formát požiadaviek a môže byť volaná rovnakým typom klienta.

1. Spustite /connect v OpenCode a prejdite na Other.
2. Zadajte ID poskytovateľa. Príklad nižšie používa omniproxy. Vyberte ID, ktoré si ľahko zapamätáte, pretože ho musíte použiť v konfiguračnom súbore.
3. Zadajte API kľúč OmniProxy. Tento krok uloží iba poverenie; adresu a modely je stále potrebné pridať do opencode.json. Poverenie je uložené v ~/.local/share/opencode/auth.json.
4. Vytvorte alebo upravte opencode.json v adresári projektu:

{
  "$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. Spustite /models. Vlastný poskytovateľ a jeho modely sa zobrazia v zozname.

ID zadané pod /connect sa musí zhodovať s kľúčom v opencode.json. Nevkladajte skutočný tajný kľúč do tohto súboru. Ak nepoužívate /connect, môžete v options.apiKeypoužiť syntax premenných prostredia, napríklad {env:VARIABLE_NAME}. Pri testovaní 9. 10. 2026 s OpenCode 1.18.34 sa vloženie kľúča priamo do options.apiKey projektu bez použitia /connect tiež úspešne pripojilo. Ak brána kľúč neoveruje, táto hodnota môže byť zástupný reťazec používaný iba v lokálnom počítači. Kľúče pod models musia používať úplné ID zo zoznamu.

Kľúč

/connect

• Vyberte Other v spodnej časti
• Zvoľte si vlastné ID poskytovateľa
• Uložené v auth.json

Projekt

opencode.json

• Kľúč poskytovateľa musí mať rovnaký názov
• Použite kompatibilný balík npm
• baseURL končí na /v1

Vybrať

/models

• Model sa zobrazí v zozname
• Vyberte jeden pred položením otázky
• Použite ID zo zoznamu brány

Overenie skutočnou úlohou

Najprv spustite jednu skutočnú úlohu z adresára projektu. Formát referencie modelu je Provider ID/model ID; zachovajte všetky lomky v rámci ID modelu:

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

--auto umožňuje tomuto spusteniu používať nástroje, ako sú nástroje na čítanie súborov. Pri testovaní 9. 10. 2026 s OpenCode 1.18.34 úspešne prečítal obsah zadaného súboru. Prvé spustenie trvalo asi dve minúty.

Pre interaktívne použitie spustite opencode, potom vyberte model pomocou /models. Môžete použiť @ na vyhľadávanie súborov. Použite opencode auth list na potvrdenie poverenia uloženého cez /connect, potom skontrolujte záznamy požiadaviek OmniProxy na overenie zdroja a ID modelu.

Spustenie

OpenCode sa spustí

• Najprv cd do projektu
• auth list zobrazí ID
• Konfiguračný súbor je v projekte

Úloha

Prečítal kód

• Opýtajte sa na konkrétny súbor
• Skontrolujte jeho vysvetlenie
• Použite /undo, ak je to nesprávne

Denníky (Logs)

Viditeľné v bráne

• Zdrojom je OpenCode
• ID modelu sa zhoduje
• Neukladajte kľúč do úložiska

Bežné chyby

• OmniProxy sa nezobrazuje pod /models: Skontrolujte, či sa ID zadané pod /connect zhoduje s kľúčom v opencode.json, či npm je nastavené na @ai-sdk/openai-compatible, a či baseURL končí na /v1.
• Poverenie chýba: Spustite opencode auth list. Poskytovatelia ako Bedrock, ktorí sa spoliehajú na premenné prostredia, sa tu nezobrazujú; vlastný poskytovateľ nakonfigurovaný cez /connect by mal byť viditeľný.
• Funkčnosť systému Windows je neúplná: Použite inštalačný skript vo vnútri WSL.
• ID modelu je neplatné: Skopírujte ho znova z aktuálneho zoznamu OmniProxy a aktualizujte príslušný kľúč pod models.
• Požiadavky smerujú na nesprávny koncový bod: Ponechajte @ai-sdk/openai-compatible pre chat completions. Nemeňte balík pre rozhranie Responses, pokiaľ daný model na OmniProxy skutočne nepoužíva /v1/responses.

Oficiálne referencie

Pre inštaláciu pozri OpenCode introduction. Pre vlastných poskytovateľov pozri Providers. Pre ID modelov použité v príkladoch pozri Claude model overview a GPT-6 Luna.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · OpenCode ↗