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

> Inštalácia v systémoch macOS, Linux a Windows, OpenCode 1.x a 2.0, pripojenie poskytovateľov a Ollama, konfigurácia, náklady a riešenie problémov.

Source: https://ailoot.ai/blog/sk/opencode-installation-models/
Canonical: https://ailoot.ai/blog/sk/opencode-installation-models/
Language: sk
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-190
Revision: sha256-b5b5f42639ef575068b5673d426aeaadb9cea4db57e6f4a3814f926dadccd932


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](https://ailoot.ai/docs/).

## Čo je OpenCode jednoduchými slovami?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

OpenCode je open-source AI coding agent (licencia MIT) od tímu Anomaly. Funguje v termináli a je dostupný aj ako desktopová aplikácia, rozšírenie editora a webová verzia. Poviete mu, čo treba v projekte urobiť, a agent sám číta súbory, upravuje kód a spúšťa príkazy. Samotný nástroj je bezplatný; pripojíte si vlastný model, či už cloudový, alebo lokálny.

</div>

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](https://github.com/anomalyco/opencode) (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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Claude Code funguje iba s modelmi Anthropic. Codex je agent od OpenAI prepojený s ekosystémom ChatGPT. OpenCode je otvorený nástroj bez viazanosti na poskytovateľa: je bezplatný a model si vyberáte spomedzi 75+ poskytovateľov vrátane predplatných ChatGPT Plus a GitHub Copilot, ako aj lokálnych modelov.

</div>

| Funkcia | OpenCode | Claude Code | Codex |
|----|----|----|----|
| Kód | Otvorený, MIT | Uzavretý | Otvorený |
| Modely | 75+ poskytovateľov a lokálne modely | Iba Claude | Modely OpenAI |
| Cena nástroja | Bezplatný | Predplatné alebo tokeny | Predplatné ChatGPT alebo tokeny |
| Prístup cez predplatné | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (vlastné predplatné) | ChatGPT (vlastné predplatné) |
| Kde beží | Terminál, desktop, editor, prehliadač | Terminál a editor | Terminál, web, editor |
| Konfigurácia projektu | AGENTS.md | CLAUDE.md | AGENTS.md |

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](https://ailoot.ai/blog/sk/install-claude-code/). 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](https://ailoot.ai/blog/sk/openai-codex-install/) pre Codex.

Ak si ešte vyberáte nástroj, začnite týmto prehľadom: [s čím ľudia programujú v roku 2026](https://ailoot.ai/blog/sk/ai-coding-tools/). 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](https://ailoot.ai/blog/sk/codex-claude-agent-opencode-devin-desktop-acp/).

## Čo sa zmenilo v OpenCode 2.0?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

K 4. októbru 2026 je OpenCode 2.0 dostupný na opencode.ai, s vlastným inštalátorom a novým npm balíkom `@opencode/cli`. Prvá verzia – tá, ktorú inštaluje tento článok – nezanikla: v dokumentácii má samostatnú vetvu `V1`, je aktívne podporovaná a zostáva predvolenou možnosťou. Vo v2 sú tri oblasti, v ktorých vývojári zámerne nezachovali kompatibilitu s prvou verziou: API doplnkov, protokol servera a súbor nastavení terminálu.

</div>

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](https://ailoot.ai/blog/sk/zcode-claude-code-alternative/), ďalšieho podobného agenta s vlastným rozhraním.

## Čo potrebujete pred inštaláciou?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Budete potrebovať dve veci: moderný emulátor terminálu (dokumentácia uvádza WezTerm, Alacritty, Ghostty alebo Kitty) a prístup k modelu – kľúč API poskytovateľa, podporované predplatné alebo lokálny model cez Ollama. Model budete potrebovať po inštalácii: pripojíte ho pri prvom spustení.

</div>

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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Jeden príkaz v termináli: curl -fsSL <https://opencode.ai/install> \| bash. Dokumentácia ho označuje za najjednoduchší spôsob. Alternatívy: brew install anomalyco/tap/opencode, npm install -g opencode-ai a v systéme Arch Linux pacman alebo paru.

</div>

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

1.  ### Spustite inštalátor

    ```bash
    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

    ```bash
    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:

```bash
brew install anomalyco/tap/opencode
```

```bash
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:

```bash
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Dokumentácia odporúča WSL kvôli výkonu a plnej kompatibilite: nainštalujte Windows Subsystem for Linux a potom v ňom nainštalujte OpenCode bežným linuxovým príkazom. Bez WSL môžete použiť Chocolatey (`choco install opencode`), Scoop (`scoop install opencode`), npm alebo desktopovú aplikáciu.

</div>

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:

```powershell
wsl --install
```

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

```bash
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:

```bash
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:

```powershell
choco install opencode
```

```powershell
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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

V terminálovom rozhraní napíšte `/connect` a zo zoznamu vyberte poskytovateľa: OpenCode Zen na začiatok bez vlastných kľúčov, Anthropic alebo OpenAI s kľúčom API, ChatGPT Plus alebo GitHub Copilot s predplatným alebo Ollama pre lokálny model. Kľúče sa ukladajú do súboru auth.json; konkrétny model vyberte pomocou `/models`.

</div>

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č:

| Možnosť | Čo to je | Cena |
|----|----|----|
| OpenCode Zen | Agregátor modelov overených tímom OpenCode | Platba za požiadavku, dobitie zostatku |
| OpenCode Go | Predplatné na otvorené modely od tímu | \$10 mesačne (Go) alebo \$40 mesačne (Go Plus, vyššie limity) |
| Kľúč API | Anthropic, OpenAI, Google, DeepSeek a ďalší | Platíte poskytovateľovi podľa používania |
| Predplatné | ChatGPT Plus, GitHub Copilot, GitLab Duo | Už zaplatené |
| Ollama / LM Studio | Lokálny model na vašom hardvéri | Bez poplatkov za API, ale potrebujete slušný 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:

```json
{
  "$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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Nainštalujte Ollama zo stránky ollama.com a stiahnite model príkazom `ollama pull` – Ollama sa dokáže pre OpenCode nakonfigurovať automaticky. Pri ručnom postupe pridajte do `opencode.json` poskytovateľa s adresou lokálneho servera <http://localhost:11434/v1>. Model vyberte pomocou `/models`. Ak agent nevolá nástroje, zvýšte `num_ctx` v Ollama na 16k–32k.

</div>

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](https://ailoot.ai/blog/sk/free-coding-models/) 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:

```bash
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:

```json
{
  "$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](https://ailoot.ai/blog/sk/qwen-code-api-key/) vysvetľuje, kde ho získať.

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Samotný OpenCode je bezplatný: jeho zdrojový kód sa zverejňuje pod licenciou MIT. Platíte iba za model: podľa skutočného používania cez kľúč API alebo Zen, cez predplatné Go, prostredníctvom vášho predplatného ChatGPT Plus alebo Copilot, prípadne vôbec nič – požiadavky na lokálny model cez Ollama sú bezplatné.

</div>

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í?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Prejdite do priečinka projektu, spustite opencode a použite príkaz `/init` – agent projekt skontroluje a vytvorí súbor AGENTS.md s jeho opisom. Pred úpravami stlačte Tab a prepnite sa do režimu Plan: navrhne riešenie a zobrazí úpravy na vaše schválenie. Nesprávne kroky vráťte príkazom `/undo`.

</div>

Prvé spustenie – v priečinku projektu:

```bash
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:

<figure>
<blockquote>
<p>Pomáha rozprávať sa s ním tak, ako by ste sa rozprávali s junior developerom vo svojom tíme.</p>
</blockquote>
<figcaption>— Oficiálna dokumentácia OpenCode, https://opencode.ai/docs/</figcaption>
</figure>

Čí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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Vlastné príkazy z markdown súborov v priečinku `.opencode/commands`, subagenti na paralelné úlohy a čítanie kódu, servery MCP pre externé nástroje, webová verzia v prehliadači a serverový režim na vzdialenú prácu.

</div>

**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](https://ailoot.ai/blog/sk/mcp-servers-claude-code/) 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í?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Takmer všetky problémy sa dajú zhrnúť do troch vecí: príkaz `opencode` sa nedá nájsť (spustite novú reláciu terminálu alebo upravte PATH), model neodpovedá (skontrolujte kľúč v `/connect` a súbor `auth.json`) alebo sa rozhranie vykresľuje nesprávne (použite moderný terminál, napríklad WezTerm). Riešenie problémov začnite kontrolou logov v `~/.local/share/opencode/log/`.

</div>

**„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?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Kľúčové body v tejto časti">

Kľúčové body

Stručné odpovede na časté otázky: OpenCode je ako nástroj bezplatný; platíte iba za model. Claude Pro/Max sa pripája cez `/connect` a doplnky tretích strán na tento účel sú zakázané. Prístup z telefónu získate cez webovú verziu. OpenCode aktualizujete príkazom `opencode upgrade`.

</div>

<div class="section">

### Často kladené otázky

Je OpenCode bezplatný?

Áno, jeho zdrojový kód je zverejnený pod licenciou MIT. Za model môžete platiť; všetky možnosti sú opísané vyššie v časti o nákladoch.

Môžem pripojiť predplatné Claude Pro/Max?

Áno, Anthropic ponúka v `/connect` oficiálnu možnosť Claude Pro/Max s overením cez prehliadač. Staršie články o používaní predplatného Claude cez doplnky sú zastarané: Anthropic tieto doplnky zakazuje a z OpenCode boli odstránené od verzie 1.3.0.

Je OpenCode dostupný na telefóne?

Funkčnou možnosťou je webová verzia: spustite `opencode serve` na počítači alebo serveri a potom sa pripojte z prehliadača v telefóne. Pri každom sieťovom prístupe sa vyžaduje heslo `OPENCODE_SERVER_PASSWORD`.

V čom je OpenCode lepší ako Claude Code?

Závisí to od vašich modelov a predplatných: Claude Code sa integruje s modelmi Anthropic, zatiaľ čo OpenCode ponúka 75+ poskytovateľov, open-source kód a lokálne modely. Úplné porovnanie nájdete v tabuľke vyššie.

Mám si hneď nainštalovať OpenCode 2.0?

Nie nevyhnutne. Dokumentácia predvolene odporúča aktuálnu prvú verziu – teda tú, ktorá sa v tejto príručke inštaluje príkazom curl -fsSL https://opencode.ai/install \| bash. Druhá verzia je dostupná od 4. októbra 2026, ale doplnky a integrácie so serverovým API v nej fungujú inak a časť kódu bude treba prepísať.

</div>

<div class="section" role="doc-bibliography" aria-label="Zdroje">

### Zdroje

- [OpenCode, oficiálna dokumentácia](https://opencode.ai/docs/)
- [Poskytovatelia modelov](https://opencode.ai/docs/providers/)
- [Výber a konfigurácia modelov](https://opencode.ai/docs/models/)
- [OpenCode Zen](https://opencode.ai/docs/zen/)
- [Agenti a subagenti](https://opencode.ai/docs/agents/)
- [Súbor pravidiel AGENTS.md](https://opencode.ai/docs/rules/)
- [Vlastné príkazy](https://opencode.ai/docs/commands/)
- [Servery MCP](https://opencode.ai/docs/mcp-servers/)
- [OpenCode vo Windowse cez WSL](https://opencode.ai/docs/windows-wsl)
- [Terminálové rozhranie](https://opencode.ai/docs/tui/)
- [Webová verzia](https://opencode.ai/docs/web/)
- [Riešenie problémov](https://opencode.ai/docs/troubleshooting/)
- [Príkazový riadok](https://opencode.ai/docs/cli/)
- [Repozitár OpenCode na GitHube](https://github.com/anomalyco/opencode)
- [OpenCode 2.0: migrácia z verzie 1](https://opencode.ai/v2/docs/migrate-v1/)
- [OpenCode Go: plány a limity](https://opencode.ai/go)

</div>





[Prejdite na Ailoot](https://ailoot.ai/).

## Otázky a odpovede: OpenCode: inštalácia, modely a prvé spustenie

### Prečo inštalácia OpenCode neposkytne funkčný model?

Nástroj a modelový prístup sú oddelené. Cez /connect pripojte poskytovateľa či podporované predplatné alebo nastavte lokálny model, vyberte ho v /models a overte ohraničenú projektovú úlohu.

### Čo overiť pred prechodom OpenCode 1.x na 2.0?

Kompatibilitu pluginov, serverových API integrácií a terminálových nastavení. Sprievodca ich označuje za migračné oblasti; pred výmenou programu overte verziu a uchovajte konfiguráciu aj relácie.


## Ailoot · Spoločnosť a jej portfólio projektov

Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.

Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.

Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.
