OpenCode: instalace, modely a první spuštění

OpenCode je open-source AI agent pro programování v terminálu: samotný nástroj je zdarma (licence MIT) a můžete k němu připojit libovolný model – od Claude a GPT až po místní model přes Ollamu. Repozitář projektu už překonal dvě stě tisíc hvězdiček na GitHubu. Výraz „bezplatný Claude Code s libovolným modelem“ zní lákavě, ale je potřeba ho upřesnit: nástroj je zdarma, podmínky použití závisí na zvoleném modelu.

Níže najdete vše podle oficiální dokumentace: co tento nástroj umí, jak ho nainstalovat v macOS, Linuxu nebo Windows, jak připojit model a co udělat při prvním spuštění. Samostatná část se věnuje nákladům, protože „zdarma“ se zde vztahuje jen na nástroj: modely stojí peníze a právě to bývá nejčastějším zdrojem nedorozumění.

Praktické informace o práci s Ailoot najdete v dokumentaci.

Co je OpenCode jednoduše řečeno?#

Stručně řečeno, OpenCode dělá totéž co Claude Code: přijme úkol v běžném jazyce a provede ho ve vašem projektu. Liší se ve dvou věcech. Jeho kód je zcela otevřený, takže si ho můžete přečíst a prohlédnout. A nástroj není svázaný s jediným poskytovatelem modelu: funguje s více než 75 poskytovateli, od Anthropic a OpenAI až po místní model běžící na vašem hardwaru.

Projekt vyvíjí tým Anomaly. Repozitář vznikl 30. dubna 2025 a k 4. říjnu 2026 má více než 211 tisíc hvězdiček a 28 tisíc forků (ověřeno pomocí požadavku na GitHub API). Použitým jazykem je TypeScript. Dokumentace se průběžně aktualizuje, takže níže uvedené pokyny vycházejí z aktuální verze.

Nepleťte si názvy: npm balíček pro současnou řadu se jmenuje opencode-ai, repozitář je anomalyco/opencode a příkaz v terminálu je jednoduše opencode. Starší články mohou používat adresu sst/opencode: organizace změnila název a starý odkaz nyní přesměrovává na nový.

Aktualizováno 4. října 2026: tým vydal OpenCode 2.0, další hlavní generaci tohoto nástroje. Pokyny k instalaci a připojení modelu níže jsou stále napsané pro současnou řadu 1.x (instaluje se příkazem curl -fsSL https://opencode.ai/install | bash; aktuální verze k 30. září 2026 je 1.18.34): je aktivně podporovaná a jde o verzi instalovanou oficiální dokumentací na opencode.ai/docs. Co přesně se ve druhé verzi změnilo a kdy přejít na ni, popisuje samostatná část níže.

V čem se OpenCode liší od Claude Code a Codexu?#

Pokud už máte předplatné Claude, dává smysl ponechat si Claude Code jako hlavní nástroj – máme k němu podrobný návod k instalaci. OpenCode se hodí ve třech případech: chcete pracovat přes předplatné ChatGPT Plus nebo GitHub Copilot, chcete spouštět místní model bez účtů za API, nebo chcete jednotné rozhraní pro několik modelů. Máme také recenzi a návod k instalaci Codexu.

Pokud se teprve rozhodujete, který nástroj zvolit, začněte tímto přehledem: s čím lidé programují v roce 2026. A pokud už máte OpenCode nainstalovaný a potřebujete ho přes ACP propojit s dalšími agenty v Devin Desktop, podívejte se na náš návod k tomuto nastavení.

Co se změnilo v OpenCode 2.0?#

Druhá verze se instaluje příkazem curl -fsSL https://opencode.ai/v2/install | bash. Podle oficiálního migračního návodu (opencode.ai/v2/docs/migrate-v1) obě verze používají stejný příkaz opencode a ve výchozím nastavení se už neinstalují současně: instalátor v2 nahrazuje binární soubor v1 a dokumentace před instalací v2 přes správce balíčků výslovně žádá, abyste nejprve odstranili verzi v1. Konfigurace se však načítá ze stejných souborů – ~/.config/opencode/ a <project>/.opencode/ – takže nastavení, agenti a MCP servery se přenesou bez přepisování. Tři věci přepsat musíte: pluginy (mají nové API), integrace se serverovým API (protokol se změnil) a nastavení terminálu (nyní jeden sdílený soubor cli.json namísto několika souborů tui.json).

Dvě nejvýraznější novinky v2 jsou tyto. Zaprvé byl představen Console – placená služba pro týmy se sledováním využití, rozpočty a sdílenými zásadami pro všechny členy. Zadruhé tým konečně oznámil cenu předplatného Go: $10 měsíčně za Go a $40 měsíčně za Go Plus s vyššími limity (stránka opencode.ai/go, ověřeno 4. října 2026). Dříve dokumentace pouze uváděla „nízkonákladové předplatné“, aniž by cenu specifikovala.

Pokud začínáte a chcete agenta jen nainstalovat, postupujte podle pokynů níže; popisují současnou první verzi, kterou doporučuje sama dokumentace. O v2 uvažujte, pokud potřebujete nové funkce pluginů nebo týmový Console – počítejte však s tím, že některé starší pluginy bude nutné přepsat pro nové API. Pokud vás více zajímá open-source desktopová aplikace, která nevyžaduje terminál, přečtěte si naši recenzi ZCode, dalšího podobného agenta s vlastním rozhraním.

Co potřebujete před instalací?#

Něco více k terminálu, protože právě zde může instalace jako jediná neproběhnout podle plánu. OpenCode v terminálu vykresluje plnohodnotné rozhraní s panely a zvýrazněním, proto dokumentace požaduje moderní emulátor. Pokud rozhraní po spuštění vypadá špatně, nejprve nainstalujte jednu ze čtyř uvedených možností: WezTerm (funguje ve všech systémech), Alacritty, Ghostty nebo Kitty. Ve Windows vede hlavní cesta přes WSL; tomu se věnuje vlastní část níže.

Druhou věcí je model. OpenCode funguje prostřednictvím připojeného modelu: sám o sobě požadavky nezpracovává. Máte čtyři možnosti: předplatné (ChatGPT Plus, GitHub Copilot, GitLab Duo), API klíč libovolného poskytovatele, OpenCode Zen, agregátor od samotného týmu, nebo místní model přes Ollamu. Všechny čtyři možnosti popisuje část o připojení modelu.

Bez popisu projektu musí agent odhadovat příkazy pro sestavení, strukturu souborů a používané konvence – odtud pocházejí „halucinace“. OpenCode k tomu používá soubor AGENTS.md. Stejný přístup platí pro Claude Code i jakéhokoli jiného agenta; mění se pouze název souboru s pokyny.

Jak nainstalovat OpenCode v macOS a Linuxu?#

Doporučenou cestou je oficiální instalátor:

1. Spusťte instalátor

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

   Skript rozpozná váš systém a stáhne OpenCode. Pokud příkaz po instalaci není k nalezení, zavřete a znovu otevřete terminál; cesta se načte v nové relaci.

2. Ověřte, že se instalace zdařila

   opencode --version
   

   Příkaz vrátí číslo verze, což znamená, že instalace proběhla úspěšně. Odpověď „command not found“ vás vrací k prvnímu kroku: spusťte novou relaci terminálu nebo ručně upravte PATH.

Pokud dáváte přednost vlastní správě balíčků, máte tyto možnosti:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Příkaz Homebrew záměrně začíná na anomalyco/tap/: dokumentace doporučuje jejich vlastní tap, protože tým Homebrew aktualizuje vzorec pro brew install opencode méně často. Stejný název balíčku, opencode-ai, funguje také s bun, pnpm a yarn (bun install -g opencode-ai, yarn global add opencode-ai). V Arch Linuxu použijte sudo pacman -S opencode ze stabilního repozitáře nebo paru -S opencode-bin pro nejnovější verzi z AUR.

OpenCode aktualizujete příkazem opencode upgrade; při spuštění také sám stahuje aktualizace, pokud je zapnutá automatická aktualizace. Po aktualizaci ověřte verzi známým příkazem opencode --version. Vestavěné je i odinstalování:

opencode uninstall

Příkaz přesně ukáže, co se odstraní, a požádá o potvrzení. Pokud chcete, můžete ponechat konfiguraci a data relací: použijte příznaky --keep-config a --keep-data.

Jak nainstalovat OpenCode ve Windows?#

První možností, kterou doporučují sami vývojáři, je WSL. Nainstalujte ho jedním příkazem v PowerShellu spuštěném jako správce:

wsl --install

Po restartu otevřete v nabídce Start Ubuntu a spusťte v něm obvyklý příkaz:

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

Soubory na discích Windows jsou ve WSL dostupné přes /mnt/ – disk C: je na /mnt/c/ a disk D: na /mnt/d/. Projekt v C:\Users\Name\project tedy můžete otevřít takto:

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

Druhou možností je vynechat WSL a použít správce balíčků ve Windows. V PowerShellu:

choco install opencode

scoop install opencode

Třetí možností je desktopová aplikace a webová verze. Aplikace se instaluje jako běžný program a zobrazuje rozhraní v okně bez terminálu. Webová verze se spouští příkazem opencode web: otevře OpenCode v prohlížeči a dokumentace doporučuje spouštět ji také z WSL, aby se předešlo problémům s přístupem k souborům. Dokumentace uvádí i méně běžné možnosti – mise, Docker a připravený binární soubor ze stránky GitHub releases. Instalace přes bun ve Windows se stále připravuje; pokud je bun váš hlavní správce balíčků, použijte možnost npm.

Jak připojit model k OpenCode?#

OpenCode podporuje více než 75 poskytovatelů přes AI SDK a Models.dev a také místní modely. Většinu z nich připojíte příkazem /connect v rozhraní; u místních modelů zadáte v konfiguraci také adresu serveru. Možnosti se liší způsobem platby a požadavky na počítač:

Dokumentace doporučuje začátečníkům začít s OpenCode Zen. Tým vybral modely, které fungují dobře konkrétně jako agenti, a vyzkoušel kombinace s poskytovateli na vlastních úkolech.

Připojení probíhá takto: zadejte /connect, vyberte OpenCode Zen, přihlaste se a přidejte platební metodu na opencode.ai/auth, získejte klíč a vložte ho. Příkaz /models pak zobrazí seznam doporučených modelů. K 4. říjnu 2026 jsou na seznamu například GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 a Kimi K2.5. Dokumentace otevřeně upozorňuje, že seznam není úplný a rychle zastarává, protože každý týden vycházejí nové modely.

Předplatná připojíte stejným příkazem /connect: vyberte ze seznamu ChatGPT Plus nebo GitHub Copilot a přihlaste se ke svému účtu – další nastavení není potřeba.

Pokud zvolíte Anthropic, /connect nabídne dvě možnosti: ručně zadat API klíč, nebo vybrat Claude Pro/Max a ověřit se přes prohlížeč. Anthropic však zakazuje používat předplatné Claude Pro/Max prostřednictvím pluginů třetích stran a vestavěné pluginy tohoto druhu byly z OpenCode odstraněny počínaje verzí 1.3.0. Pokud narazíte na starší článek o „OpenCode přes předplatné Claude“, pojednává o těchto odstraněných pluginech, nikoli o oficiálním ověření. Předplatná ChatGPT Plus, GitHub Copilot, GitLab Duo (označené jako experimentální) a Atomic Chat fungují bez dalšího nastavení.

OpenCode ukládá klíče zadané přes /connect do souboru ~/.local/share/opencode/auth.json. Pokud nechcete pokaždé vybírat model, nastavte výchozí model v konfiguračním souboru opencode.json v kořenové složce projektu:

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

Formát je provider/model; oba identifikátory se zobrazují ve výstupu příkazu /models.

Jak připojit místní model přes Ollamu?#

Tato možnost znamená, že neplatíte žádné účty za API: model běží ve vašem počítači. Pokud si obecně vybíráte mezi bezplatnými modely, máme samostatnou recenzi, které fungují jako agenti obstojně a které jen na papíře. Pro OpenCode nainstalujte Ollamu z oficiálních stránek a stáhněte model:

ollama pull qwen3-coder

Užitečný detail z dokumentace: Ollama se může pro OpenCode nakonfigurovat automaticky; má samostatný návod k integraci. Pokud chcete vše nastavit ručně, přidejte do opencode.json poskytovatele s adresou místního serveru Ollamy:

{
  "$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"
        }
      }
    }
  }
}

Příkaz /models pak v rozhraní zobrazí místní model v seznamu. Vyberte ho a pusťte se do práce. Jeden praktický poznatek z dokumentace: pokud agent přestane volat nástroje (upravovat soubory nebo spouštět příkazy), zvyšte v nastavení Ollamy num_ctx – začněte s hodnotami 16k–32k. Místní modely jsou při práci agenta slabší než cloudové modely a malý kontext situaci zhoršuje. Pokud místní verze nestačí, můžete připojit Qwen z cloudu pomocí klíče; kde ho získat, popisuje návod jak získat API klíč pro Qwen Code.

Kolik stojí OpenCode a jeho používání?#

Všechny zde uvedené náklady se týkají modelu a existují čtyři scénáře. S API klíčem nebo Zenem platíte za skutečné využití a částka závisí na tom, kolik agent pracuje. Go je předplatné na otevřené modely od týmu OpenCode: $10 měsíčně za Go a $40 měsíčně za Go Plus s vyššími limity (ověřeno na stránce opencode.ai/go 4. října 2026). Limit závisí na modelu: například Go umožňuje přibližně 110 požadavků za 5 hodin (440 měsíčně) pro Kimi K3 a přibližně 26 000 požadavků za 5 hodin pro lehčí DeepSeek V4.1 Flash. Pro přístup ke konkrétnímu modelu nad rámec limitu uvádí dokumentace samostatnou cenu ($15 měsíčně za Kimi K3, $60 za Go Plus). Úplný seznam modelů a limitů najdete na stránce předplatného při připojování. S ChatGPT Plus nebo Copilotem jsou požadavky zahrnuté v předplatném, které už platíte; nezapomeňte, že i předplatná mají vlastní limity intenzity využívání. A nakonec požadavky na místní model přes Ollamu nestojí nic – potřebujete však dostatečně výkonný počítač, aby model běžel rychle.

Co udělat při prvním spuštění?#

První spuštění – ve složce projektu:

cd path/to/project
opencode

Rozhraní se otevře se vstupním polem. Nejprve použijte příkaz /init: agent prohledá důležité soubory repozitáře, v případě potřeby položí několik otázek a vytvoří soubor AGENTS.md – návod popisující strukturu projektu, příkazy ke spuštění sestavení a testů a používané konvence. Dokumentace doporučuje tento soubor odevzdat do gitu; OpenCode ho pak používá jako trvalý pokyn pro projekt. Z hlediska účelu je AGENTS.md přímou obdobou CLAUDE.md v ekosystému OpenCode.

Zadruhé použijte režim Plan. Klávesa Tab přepíná mezi dvěma hlavními agenty: Build má plný přístup k souborům a příkazům, zatímco Plan slouží k analýze a plánování – úpravy souborů a příkazy bash v režimu Plan ve výchozím nastavení vyžadují vaše schválení. U nových úkolů dokumentace doporučuje začít plánem: přečtěte si, co agent zamýšlí udělat, upravte formulaci a teprve potom se klávesou Tab vraťte do režimu Build.

Dokumentace nabízí tuto radu:

Čím konkrétnější je úkol a čím více kontextu poskytnete, tím méně přepracování budete potřebovat. Soubory přidáte k požadavku pomocí @ – začněte psát název a rozhraní je vyhledá pomocí fuzzy vyhledávání. Obrázky můžete přetáhnout přímo do terminálu a zpráva začínající znakem ! se spustí jako příkaz shellu; její výstup se přidá do kontextu agenta. Pokud jste v zadání udělali chybu nebo agent provedl nesprávnou akci, /undo vrátí změny a můžete ho spustit několikrát za sebou. Rozmysleli jste si to znovu? /redo obnoví vrácené změny. A /share vytvoří odkaz na konverzaci pro váš tým; bez tohoto příkazu se konverzace nikde nezveřejní.

Co dalšího OpenCode umí?#

Vlastní příkazy. Každý opakující se požadavek se může stát příkazem: vložte markdown soubor do .opencode/commands/, do frontmatteru zadejte description, agent a model a níže napište šablonu zadání. Příkaz pak zavoláte pomocí /. Kontroly projektu před publikováním, kontrola nedávných chyb, generování migrace – cokoli, o co žádáte pravidelně.

Subagenti. Kromě Build a Plan jsou k dispozici další tři: General pro vícekrokové úkoly (má přístup ke všem nástrojům kromě seznamu úkolů), Explore pro rychlé čtení kódu bez oprávnění k úpravám a Scout pro průzkum externích knihoven. Zavoláte je tak, že je ve zprávě zmíníte pomocí @.

MCP servery. Externí nástroje připojíte přes část mcp konfigurace opencode.json – podporovány jsou místní i vzdálené servery. Každý MCP server přidává do kontextu své nástroje a nenasytný server jako GitHub může kontext zaplnit velmi rychle – připojujte je uvážlivě a jen ty, které potřebujete. Máme návod s hotovými nastaveními ke konceptu MCP; je napsaný pro Claude Code, ale protokol je společný.

Webová verze a server. opencode web otevře rozhraní v prohlížeči. Pro přístup z jiného počítače použijte opencode serve --hostname 0.0.0.0 --port 4096; kdykoli je dostupný přes síť, nezapomeňte nastavit heslo pomocí proměnné OPENCODE_SERVER_PASSWORD. Bez hesla není server chráněný.

Co dělat, když se instalace nezdaří?#

„opencode: command not found“ po instalaci. Terminál zatím nezná novou cestu. Nejprve terminál jednoduše zavřete a znovu otevřete. Pokud to nepomůže, zjistěte, kam instalátor umístil binární soubor, a přidejte tuto složku do PATH terminálu.

Model mlčí nebo hlásí chybu autorizace. Zkontrolujte, že je poskytovatel připojený: zadejte /connect a znovu se ověřte. Klíče se ukládají do ~/.local/share/opencode/auth.json – pokud jste instalaci přesunuli z jiného počítače nebo vymazali složky, soubor může chybět. Dokumentace popisuje chyby ProviderInitError a AI_APICallError samostatně: v prvním případě znovu autorizujte poskytovatele, ve druhém vymažte složku ~/.cache/opencode a restartujte.

Rozhraní je rozbité: panely jsou rozházené nebo se místo symbolů zobrazují nečitelné znaky. Nejprve zkontrolujte terminál. Nainstalujte jednu z doporučených možností – WezTerm funguje ve všech třech systémech – a spusťte OpenCode z něj.

Pokud nic nepomůže, zkontrolujte protokoly: v macOS a Linuxu jsou v ~/.local/share/opencode/log/; ve Windows stiskněte Win+R a zadejte %USERPROFILE%\.local\share\opencode\log. Uchovává se deset nejnovějších souborů; podrobné protokolování zapnete příznakem opencode --log-level DEBUG. S těmito protokoly můžete nahlásit chybu v repozitáři projektu na GitHubu.

Na co dalšího se lidé ohledně OpenCode ptají?#

Otevřete Ailoot.