OpenCode: inštalácia, modely a prvé spustenie

OpenCode je open-source AI coding agent pre terminál: samotný nástroj je bezplatný (licencia MIT) a môžete k nemu pripojiť ľubovoľný model – od Claude a GPT až po lokálny model cez Ollama. Repozitár projektu už na GitHube prekročil dvestotisíc hviezdičiek. Fráza „bezplatný Claude Code s ľubovoľným modelom“ znie lákavo, ale treba ju objasniť: nástroj je bezplatný; podmienky používania závisia od modelu, ktorý si vyberiete.

Nižšie nájdete všetko podľa oficiálnej dokumentácie: čo je tento nástroj, ako ho nainštalovať v systéme macOS, Linux alebo Windows, ako pripojiť model a čo robiť pri prvom spustení. Samostatná časť sa venuje nákladom, pretože „bezplatné“ sa tu vzťahuje iba na nástroj: modely stoja peniaze a práve to najčastejšie spôsobuje nejasnosti.

Praktické informácie o práci s Ailoot nájdete v dokumentácii.

Čo je OpenCode jednoduchými slovami?#

Stručne povedané, OpenCode robí to isté čo Claude Code: prijme úlohu zadanú bežným jazykom a vykoná ju vo vašom projekte. Líšia sa v dvoch veciach. Kód je úplne otvorený, takže si ho môžete prečítať a skontrolovať. A nástroj nie je viazaný na jediného poskytovateľa modelov: funguje so 75+ poskytovateľmi, od Anthropic a OpenAI až po lokálny model spustený na vašom hardvéri.

Projekt vyvíja tím Anomaly. Repozitár vznikol 30. apríla 2025 a k 4. októbru 2026 má viac než 211-tisíc hviezdičiek a 28-tisíc forkov (overené požiadavkou na GitHub API). Použitým jazykom je TypeScript. Dokumentácia sa priebežne aktualizuje, takže nasledujúce pokyny vychádzajú z aktuálnej verzie.

Nezamieňajte si názvy: npm balík pre aktuálnu líniu sa volá opencode-ai, repozitár je anomalyco/opencode a príkaz v termináli je jednoducho opencode. Staršie články môžu uvádzať adresu sst/opencode: organizácia zmenila názov a starý odkaz teraz presmeruje na nový.

Aktualizované 4. októbra 2026: tím vydal OpenCode 2.0, ďalšiu hlavnú generáciu nástroja. Pokyny na inštaláciu a pripojenie modelu nižšie sú naďalej určené pre aktuálnu líniu 1.x (inštaluje sa príkazom curl -fsSL https://opencode.ai/install | bash; aktuálna verzia k 30. septembru 2026 je 1.18.34): je aktívne podporovaná a práve túto verziu inštaluje oficiálna dokumentácia na opencode.ai/docs. Čo presne sa v druhej verzii zmenilo a kedy na ňu prejsť, vysvetľuje samostatná časť nižšie.

V čom sa OpenCode líši od Claude Code a Codex?#

Ak už máte predplatné Claude, dáva zmysel ponechať si Claude Code ako hlavný nástroj – máme o ňom podrobný návod na inštaláciu. OpenCode sa hodí v troch prípadoch: chcete pracovať cez predplatné ChatGPT Plus alebo GitHub Copilot, chcete spúšťať lokálny model bez poplatkov za API alebo chcete jedno rozhranie pre viacero modelov. Máme aj prehľad a návod na inštaláciu pre Codex.

Ak si ešte vyberáte nástroj, začnite týmto prehľadom: s čím ľudia programujú v roku 2026. A ak už máte OpenCode nainštalovaný a potrebujete ho cez ACP prepojiť s ďalšími agentmi v Devin Desktop, pozrite si náš návod na toto nastavenie.

Čo sa zmenilo v OpenCode 2.0?#

Druhá verzia sa inštaluje príkazom curl -fsSL https://opencode.ai/v2/install | bash. Podľa oficiálneho sprievodcu migráciou (opencode.ai/v2/docs/migrate-v1) používajú obe verzie rovnaký príkaz opencode a predvolene sa už neinštalujú vedľa seba: inštalátor v2 nahradí binárny súbor v1 a dokumentácia pred inštaláciou v2 cez správcu balíkov výslovne žiada najprv odstrániť verziu v1. Konfigurácia sa však číta z tých istých súborov – ~/.config/opencode/ a <project>/.opencode/ –, takže nastavenia, agenti a servery MCP sa prenesú bez prepisovania. Tri veci treba prepísať: doplnky (majú nové API), integrácie so serverovým API (protokol sa zmenil) a nastavenia terminálu (namiesto viacerých súborov tui.json je teraz jeden zdieľaný súbor cli.json).

Dve najvýraznejšie nové funkcie v2 sú tieto. Po prvé, pribudol Console – platená služba pre tímy so sledovaním používania, rozpočtami a zdieľanými pravidlami pre všetkých členov. Po druhé, tím konečne oznámil cenu predplatného Go: $10 mesačne za Go a $40 mesačne za Go Plus s vyššími limitmi (stránka opencode.ai/go, overené 4. októbra 2026). Predtým dokumentácia iba uvádzala „nízkonákladové predplatné“ bez konkrétnej sumy.

Ak ste noví a chcete si agenta len nainštalovať, postupujte podľa pokynov nižšie; týkajú sa aktuálnej prvej verzie, ktorú odporúča samotná dokumentácia. Zvážte v2, ak potrebujete nové funkcie doplnkov alebo tímový Console – počítajte však s tým, že niektoré staršie doplnky budete musieť prepísať pre nové API. Ak vás viac zaujíma open-source desktopová aplikácia, ktorá nevyžaduje terminál, máme prehľad ZCode, ďalšieho podobného agenta s vlastným rozhraním.

Čo potrebujete pred inštaláciou?#

Niekoľko slov o termináli, pretože práve tu sa inštalácia nemusí vydať podľa plánu. OpenCode zobrazuje v termináli plnohodnotné rozhranie s panelmi a zvýrazňovaním, preto dokumentácia odporúča moderný emulátor. Ak sa rozhranie po spustení zobrazuje nesprávne, najprv si nainštalujte jednu zo štyroch uvedených možností: WezTerm (funguje vo všetkých systémoch), Alacritty, Ghostty alebo Kitty. V systéme Windows je hlavnou cestou WSL; tomu sa venuje samostatná časť nižšie.

Druhou vecou je model. OpenCode funguje prostredníctvom pripojeného modelu: sám o sebe požiadavky nespracúva. Sú štyri možnosti: predplatné (ChatGPT Plus, GitHub Copilot, GitLab Duo), kľúč API od ľubovoľného poskytovateľa, OpenCode Zen – agregátor od samotného tímu – alebo lokálny model cez Ollama. Všetky štyri možnosti sú opísané v časti o pripájaní modelu.

Bez opisu projektu musí agent hádať príkazy na zostavenie, štruktúru súborov a používané konvencie – odtiaľ pochádzajú „halucinácie“. OpenCode na to používa súbor AGENTS.md. Rovnaký prístup platí pre Claude Code aj každého iného agenta; mení sa iba názov súboru s pokynmi.

Ako nainštalovať OpenCode v systémoch macOS a Linux?#

Odporúčaný postup je použiť oficiálny inštalátor:

1. Spustite inštalátor

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

   Skript rozpozná váš systém a stiahne OpenCode. Ak sa príkaz po inštalácii nenájde, zatvorte a znova otvorte terminál; cesta sa načíta v novej relácii.

2. Skontrolujte, či sa nainštaloval správne

   opencode --version
   

   Príkaz vráti číslo verzie, čo znamená, že inštalácia prebehla úspešne. Odpoveď „command not found“ vás vracia k prvému kroku: spustite novú reláciu terminálu alebo ručne upravte PATH.

Ak radšej spravujete balíky sami, máte tieto možnosti:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Príkaz Homebrew sa zámerne začína reťazcom anomalyco/tap/: dokumentácia odporúča ich vlastný tap, pretože tím Homebrew aktualizuje recept pre brew install opencode menej často. Rovnaký názov balíka, opencode-ai, funguje aj s bun, pnpm a yarn (bun install -g opencode-ai, yarn global add opencode-ai). V systéme Arch Linux použite sudo pacman -S opencode zo stabilného repozitára alebo paru -S opencode-bin pre najnovšiu verziu z AUR.

OpenCode aktualizujete príkazom opencode upgrade; pri spustení si tiež sám sťahuje aktualizácie, ak je zapnutá automatická aktualizácia. Po aktualizácii skontrolujte verziu známym príkazom opencode --version. Súčasťou programu je aj odinštalovanie:

opencode uninstall

Príkaz presne zobrazí, čo sa odstráni, a požiada o potvrdenie. Ak chcete, môžete si ponechať konfiguráciu a údaje relácie: použite príznaky --keep-config a --keep-data.

Ako nainštalovať OpenCode v systéme Windows?#

Prvou možnosťou, ktorú odporúčajú samotní vývojári, je WSL. Nainštalujte ho jedným príkazom v prostredí PowerShell spustenom ako správca:

wsl --install

Po reštarte otvorte Ubuntu z ponuky Štart a spustite v ňom známy príkaz:

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

Súbory na diskoch Windows sú vo WSL dostupné cez /mnt/ – disk C: je v /mnt/c/ a disk D: v /mnt/d/. Projekt v umiestnení C:\Users\Name\project teda môžete otvoriť takto:

cd /mnt/c/Users/Name/project
opencode

Druhou možnosťou je vynechať WSL a použiť správcov balíkov pre Windows. V prostredí PowerShell:

choco install opencode

scoop install opencode

Treťou možnosťou je desktopová aplikácia a webová verzia. Aplikácia sa inštaluje ako bežný program a zobrazuje rozhranie v okne bez terminálu. Webová verzia sa spúšťa príkazom opencode web: otvorí OpenCode v prehliadači a dokumentácia odporúča spúšťať ju tiež z WSL, aby sa predišlo problémom s prístupom k súborom. Dokumentácia uvádza aj menej bežné možnosti – mise, Docker a hotový binárny súbor zo stránky vydaní GitHubu. Inštalácia cez bun vo Windows je stále vo vývoji; ak je bun váš hlavný správca balíkov, použite možnosť npm.

Ako pripojiť model k OpenCode?#

OpenCode podporuje 75+ poskytovateľov cez AI SDK a Models.dev, ako aj lokálne modely. Väčšina sa pripája príkazom /connect priamo v rozhraní; pri lokálnych modeloch zadávate v konfigurácii aj adresu servera. Možnosti sa líšia spôsobom platby a požiadavkami na počítač:

Dokumentácia odporúča začiatočníkom začať s OpenCode Zen. Tím vybral modely, ktoré dobre fungujú konkrétne ako agenti, a na vlastných úlohách otestoval ich kombinácie s poskytovateľmi.

Pripojenie prebieha takto: zadajte /connect, vyberte OpenCode Zen, prihláste sa a pridajte platobnú metódu na opencode.ai/auth, získajte kľúč a vložte ho. Potom sa v /models zobrazí zoznam odporúčaných modelov. K 4. októbru 2026 zoznam obsahuje napríklad GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 a Kimi K2.5. Dokumentácia otvorene upozorňuje, že zoznam nie je úplný a rýchlo zastaráva, pretože každý týždeň vychádzajú nové modely.

Predplatné sa pripájajú tým istým príkazom /connect: vyberte zo zoznamu ChatGPT Plus alebo GitHub Copilot a prihláste sa do svojho účtu – ďalšie nastavenie netreba.

Ak si vyberiete Anthropic, /connect ponúka dve možnosti: zadať kľúč API ručne alebo vybrať Claude Pro/Max a overiť sa cez prehliadač. Anthropic však zakazuje doplnky tretích strán na používanie predplatného Claude Pro/Max a vstavané doplnky tohto typu boli z OpenCode odstránené od verzie 1.3.0. Ak narazíte na starší článok o „OpenCode cez predplatné Claude“, týka sa týchto odstránených doplnkov, nie oficiálneho oprávnenia. Predplatné ChatGPT Plus, GitHub Copilot, GitLab Duo (označené ako experimentálne) a Atomic Chat fungujú bez ďalšieho nastavenia.

OpenCode ukladá kľúče zadané cez /connect do súboru ~/.local/share/opencode/auth.json. Ak nechcete zakaždým vyberať model, nastavte predvolený model v konfiguračnom súbore opencode.json v koreňovom priečinku projektu:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Formát je provider/model; oba identifikátory sa zobrazujú vo výstupe príkazu /models.

Ako pripojiť lokálny model cez Ollama?#

Táto možnosť znamená nulové poplatky za API: model beží na vašom počítači. Ak si všeobecne vyberáte medzi bezplatnými modelmi, máme samostatný prehľad o tom, ktoré fungujú ako agenti pomerne dobre a ktoré iba na papieri. Ak chcete použiť OpenCode, nainštalujte Ollama z oficiálnej stránky a stiahnite model:

ollama pull qwen3-coder

Užitočný detail z dokumentácie: Ollama sa dokáže pre OpenCode nakonfigurovať automaticky; má na to samostatného sprievodcu integráciou. Ak chcete všetko nastaviť ručne, pridajte do opencode.json poskytovateľa s adresou lokálneho servera Ollama:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Potom sa v rozhraní v zozname modelov zobrazí lokálny model pomocou /models. Vyberte ho a môžete začať pracovať. Praktická poznámka z dokumentácie: ak agent prestane volať nástroje (upravovať súbory alebo spúšťať príkazy), zvýšte v nastaveniach Ollama hodnotu num_ctx – začnite na 16k–32k. Lokálne modely sú pri práci agentov slabšie než cloudové a malý kontext situáciu zhoršuje. Ak lokálna verzia nestačí, môžete pripojiť cloudový Qwen pomocou kľúča; návod ako získať kľúč API pre Qwen Code vysvetľuje, kde ho získať.

Koľko stojí OpenCode a jeho používanie?#

Všetky náklady v tejto časti sa týkajú modelu a existujú štyri scenáre. Pri kľúči API alebo Zen platíte za skutočné používanie a suma závisí od toho, koľko agent pracuje. Go je predplatné na otvorené modely od tímu OpenCode: $10 mesačne za Go a $40 mesačne za Go Plus s vyššími limitmi (overené na stránke opencode.ai/go 4. októbra 2026). Limit závisí od modelu: napríklad Go povoľuje približne 110 požiadaviek za 5 hodín (440 mesačne) pre Kimi K3 a približne 26,000 požiadaviek za 5 hodín pre ľahší DeepSeek V4.1 Flash. Pri prístupe ku konkrétnemu modelu nad limit dokumentácia uvádza samostatnú cenu ($15 mesačne za Kimi K3, $60 za Go Plus). Úplný zoznam modelov a limitov nájdete na stránke predplatného pri pripájaní. Pri ChatGPT Plus alebo Copilot sú požiadavky pokryté predplatným, ktoré už platíte; nezabúdajte, že predplatné má vlastné limity intenzity používania. Napokon, požiadavky na lokálny model cez Ollama nič nestoja – potrebujete však dostatočne výkonný počítač, aby model bežal rýchlo.

Čo robiť pri prvom spustení?#

Prvé spustenie – v priečinku projektu:

cd path/to/project
opencode

Rozhranie sa otvorí so vstupným poľom. Najprv použite príkaz /init: agent prehľadá dôležité súbory repozitára, v prípade potreby položí niekoľko otázok a vytvorí súbor AGENTS.md – príručku opisujúcu štruktúru projektu, príkazy na zostavenie a testovanie a používané konvencie. Dokumentácia odporúča tento súbor commitnúť do gitu; OpenCode ho potom používa ako trvalý pokyn pre projekt. Z hľadiska účelu je AGENTS.md priamym ekvivalentom CLAUDE.md v ekosystéme OpenCode.

Po druhé, používajte režim Plan. Kláves Tab prepína medzi dvoma hlavnými agentmi: Build pracuje s plným prístupom k súborom a príkazom, zatiaľ čo Plan slúži na analýzu a plánovanie – úpravy súborov a príkazy bash v režime Plan predvolene vyžadujú vaše schválenie. Pri nových úlohách dokumentácia odporúča začať plánom: prečítajte si, čo agent zamýšľa urobiť, upravte formuláciu a až potom sa klávesom Tab vráťte do režimu Build.

Dokumentácia ponúka túto radu:

Čím konkrétnejšia je úloha a čím viac kontextu poskytnete, tým menej práce budete musieť prerábať. Do požiadavky pridajte súbory pomocou @ – začnite písať názov a rozhranie ich nájde nepresným vyhľadávaním. Obrázky môžete presunúť priamo do terminálu a správa začínajúca znakom ! sa spustí ako príkaz shellu; jej výstup sa pridá do kontextu agenta. Ak ste v zadaní urobili chybu alebo agent vykonal nesprávnu činnosť, /undo vráti zmeny a môžete ho spustiť niekoľkokrát za sebou. Zmenili ste názor znova? /redo obnoví vrátené zmeny. A /share vytvorí odkaz na konverzáciu pre váš tím; bez tohto príkazu sa konverzácia nikde nezverejní.

Čo ešte dokáže OpenCode?#

Vlastné príkazy. Každá opakujúca sa požiadavka sa môže zmeniť na príkaz: vložte markdown súbor do .opencode/commands/, v jeho frontmatter nastavte description, agent a model a pod neho napíšte šablónu promptu. Potom príkaz zavolajte pomocou /. Kontrola projektu pred publikovaním, kontrola nedávnych chýb, vytvorenie migrácie – čokoľvek, o čo pravidelne žiadate.

Subagenti. Okrem Build a Plan sú tu ešte traja: General na viacstupňové úlohy (prístup ku všetkým nástrojom okrem zoznamu úloh), Explore na rýchle čítanie kódu bez povolenia na úpravy a Scout na prieskum externých knižníc. Zavolajte ich tak, že ich v správe spomeniete pomocou @.

Servery MCP. Externé nástroje pripojíte cez sekciu mcp v konfigurácii opencode.json – podporované sú lokálne aj vzdialené servery. Každý server MCP pridáva svoje nástroje do kontextu a náročný server, ako je GitHub, môže kontext veľmi rýchlo vyčerpať – pripájajte preto selektívne iba to, čo potrebujete. Máme sprievodcu s hotovými nastaveniami konceptu MCP; je napísaný pre Claude Code, ale protokol je spoločný.

Webová verzia a server. Príkaz opencode web otvorí rozhranie v prehliadači. Ak chcete prístup z iného počítača, použite opencode serve --hostname 0.0.0.0 --port 4096; pri každom sieťovom prístupe nezabudnite nastaviť heslo pomocou premennej OPENCODE_SERVER_PASSWORD. Bez hesla nie je server chránený.

Čo robiť, ak sa inštalácia nepodarí?#

„opencode: command not found“ po inštalácii. Terminál ešte nepozná novú cestu. Najprv jednoducho zatvorte a znova otvorte terminál. Ak to nepomôže, nájdite, kam inštalátor umiestnil binárny súbor, a pridajte daný priečinok do PATH terminálu.

Model mlčí alebo hlási chybu autorizácie. Skontrolujte, či je poskytovateľ pripojený: zadajte /connect a znova sa overte. Kľúče sa ukladajú v ~/.local/share/opencode/auth.json – ak ste inštaláciu presunuli z iného počítača alebo vymazali priečinky, súbor môže chýbať. Dokumentácia osobitne opisuje chyby ProviderInitError a AI_APICallError: pri prvej znova autorizujte poskytovateľa; pri druhej vymažte priečinok ~/.cache/opencode a reštartujte.

Rozhranie je pokazené: panely sú rozhádzané alebo sa namiesto symbolov zobrazujú nečitateľné znaky. Najprv skontrolujte terminál. Nainštalujte jednu z odporúčaných možností – WezTerm funguje vo všetkých troch systémoch – a spustite OpenCode z nej.

Ak nič nepomáha, skontrolujte logy: v systémoch macOS a Linux sa nachádzajú v ~/.local/share/opencode/log/; vo Windowse stlačte Win+R a zadajte %USERPROFILE%\.local\share\opencode\log. Uchováva sa desať najnovších súborov; podrobné zaznamenávanie zapnete príznakom opencode --log-level DEBUG. S týmito logmi môžete nahlásiť chybu v repozitári projektu na GitHube.

Na čo ďalšie sa ľudia pýtajú o OpenCode?#

Prejdite na Ailoot.