Instalace OpenCode a konfigurace OmniProxy

OpenCode je open-source asistent pro kódování, který vám umožní psát kód z terminálu, IDE nebo plochy. Neukládá váš kód ani kontext, což je vhodné pro projekty citlivé na soukromí. build se používá k úpravě projektu, zatímco plan je ve výchozím nastavení pouze pro čtení a je užitečný pro pochopení neznámého kódu a plánování změn před jejich provedením. Můžete si vybrat modelovou službu podle svých potřeb.

Než začnete

Instalační skript je nejjednodušší volbou. Potřebujete moderní terminál – terminálovou aplikaci, která umí spouštět příkazy a pracovat se soubory projektu – jako je WezTerm, Alacritty, Ghostty nebo Kitty. Ve Windows je preferováno WSL. Poskytuje linuxové prostředí v rámci Windows s úplnějším výkonem a funkcemi.

Nejjednodušší

Instalační skript

• curl opencode.ai/install
• Použijte přímo na macOS Linux
• WSL je doporučeno ve Windows

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• Aktualizováno častěji než formula
• Balíček je dostupný i pro Arch

Nativní Windows

Správce balíčků

• choco nebo scoop
• Nebo nainstalujte globálně pomocí npm
• Můžete si jej také stáhnout z Releases

Připravte si také ID modelu z aktuálního seznamu modelů. ID modelu je název, který služba používá k přesné identifikaci konkrétního modelu.

Instalace a první spuštění

Nejjednodušší instalační příkaz je:

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

Můžete také použít jednu z těchto metod instalace:

• Node.js: npm install -g opencode-ai. Bun, pnpm a Yarn mají také odpovídající příkazy pro globální instalaci; viz úvodní stránka na konci této příručky.
• Homebrew na macOS a Linuxu: brew install anomalyco/tap/opencode. Použijte tento tap, protože je aktualizován častěji než brew install opencode, který spravuje tým Homebrew.
• Arch Linux: použijte sudo pacman -S opencode pro stabilní verzi, nebo balíček AUR opencode-bin pro novější verzi.
• Windows: použijte choco install opencode nebo scoop install opencode. Můžete také použít npm install -g opencode-ai. Binární soubory lze také stáhnout z Releases. Podpora instalace pomocí Bun ve Windows je stále ve vývoji.

Přejděte do adresáře projektu a poté spusťte OpenCode:

cd /path/to/project
opencode

Při prvním použití můžete spustit /init. Analyzuje projekt a vytvoří AGENTS.md v kořenovém adresáři projektu. Tento soubor lze commitnout do Gitu, aby si projekt tyto pokyny zachoval.

Získání hodnot připojení 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 přístupový údaj a Model ID je úplný název modelu.

Při použití /v1/chat/completions, nastavte balíček npm na @ai-sdk/openai-compatible. Chat Completions je typ rozhraní pro chatové požadavky. Přepněte na @ai-sdk/openai pouze tehdy, když model používá /v1/responses. Když se OmniProxy používá přes koncový bod chat completions, ponechte balíček kompatibility.

Zkopírujte celé ID modelu ze seznamu OmniProxy, včetně všech lomítek. K 9. 10. 2026 byla dvě referenční ID claude-sonnet-5-5 a gpt-6-luna. gpt-6-luna podporuje Chat Completions; volání funkcí přes Chat Completions je podporováno pouze tehdy, když reasoning_effort je none. Nekopírujte ID, které není v seznamu.

Zadání konfigurace nástroje

Poskytovatele (Provider) lze chápat jako sadu konfiguračních hodnot, které OpenCode používá k připojení k modelové službě. Dokumentace poskytovatele považuje službu kompatibilní s OpenAI, která není uvedena pod /connect jako vlastního poskytovatele. Služba kompatibilní s OpenAI používá stejný formát požadavků a může být volána stejným typem klienta.

1. Spusťte /connect v OpenCode a přejděte na Other.
2. Zadejte ID poskytovatele. Níže uvedený příklad používá omniproxy. Zvolte ID, které si snadno zapamatujete, protože jej musíte použít stejné v konfiguračním souboru.
3. Zadejte API klíč OmniProxy. Tento krok uloží pouze přihlašovací údaj; adresu a modely je stále nutné přidat do opencode.json. Přihlašovací údaj je uložen v ~/.local/share/opencode/auth.json.
4. Vytvořte nebo upravte opencode.json v adresáři 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. Spusťte /models. Vlastní poskytovatel a jeho modely se objeví v seznamu.

ID zadané pod /connect se musí shodovat s klíčem v opencode.json. Nevkládejte do tohoto souboru skutečný tajný klíč. Pokud nepoužíváte /connect, můžete v options.apiKeypoužít syntaxi proměnných prostředí, jako je {env:VARIABLE_NAME}. Při testování dne 9. 10. 2026 s OpenCode 1.18.34 se vložení klíče přímo do souboru projektu options.apiKey bez použití /connect také úspěšně připojilo. Pokud gateway klíč neověřuje, může být tato hodnota zástupným řetězcem používaným pouze v místním počítači. Klíče pod models musí používat úplná ID ze seznamu.

Klíč

/connect

• Vyberte Other dole
• Zvolte vlastní ID poskytovatele
• Uloženo v auth.json

Projekt

opencode.json

• Klíč poskytovatele musí mít stejný název
• Použijte kompatibilní balíček npm
• baseURL končí /v1

Vybrat

/models

• Model se objeví v seznamu
• Před položením otázky jeden vyberte
• Použijte ID ze seznamu gateway

Ověření skutečným úkolem

Nejprve spusťte jeden skutečný úkol z adresáře projektu. Formát reference modelu je Provider ID/model ID; zachovejte všechna lomítka v 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 spuštění používat nástroje, jako jsou nástroje pro čtení souborů. Při testování dne 9. 10. 2026 s OpenCode 1.18.34 úspěšně přečetl obsah zadaného souboru. První spuštění trvalo asi dvě minuty.

Pro interaktivní použití spusťte opencode, poté vyberte model pomocí /models. K vyhledávání souborů můžete použít @ . Použijte opencode auth list k potvrzení přihlašovacího údaje uloženého přes /connect, poté zkontrolujte záznamy požadavků OmniProxy pro ověření zdroje a ID modelu.

Spuštění

opencode se spustí

• Nejprve cd do projektu
• auth list zobrazuje ID
• Konfigurační soubor je v projektu

Úkol

Přečetl kód

• Zeptejte se na konkrétní soubor
• Zkontrolujte jeho vysvětlení
• Pokud je to špatně, použijte /undo

Logy

Viditelné v gateway

• Zdroj je OpenCode
• ID modelu souhlasí
• Neukládejte klíč do repozitáře

Běžné chyby

• OmniProxy se neobjevuje pod /models: Zkontrolujte, zda ID zadané pod /connect odpovídá klíči v opencode.json, že npm je nastaveno na @ai-sdk/openai-compatible, a že baseURL končí /v1.
• Chybí přihlašovací údaj: Spusťte opencode auth list. Poskytovatelé jako Bedrock, kteří spoléhají na proměnné prostředí, se zde neobjevují; vlastní poskytovatel nakonfigurovaný přes /connect by měl být viditelný.
• Funkčnost Windows je neúplná: Použijte instalační skript uvnitř WSL.
• ID modelu je neplatné: Zkopírujte jej znovu z aktuálního seznamu OmniProxy a aktualizujte odpovídající klíč pod models.
• Požadavky směřují na špatný koncový bod: Ponechte @ai-sdk/openai-compatible pro chat completions. Neměňte balíček pro rozhraní Responses, pokud daný model na OmniProxy skutečně nepoužívá /v1/responses.

Oficiální reference

Pro instalaci viz OpenCode introduction. Pro vlastní poskytovatele viz Providers. Pro ID modelů použitá v příkladech viz Claude model overview a GPT-6 Luna.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · OpenCode ↗