# OpenCode: instalace, modely a první spuštění > Instalace v macOS, Linuxu a Windows, OpenCode 1.x a 2.0, připojení poskytovatelů a Ollamy, konfigurace, náklady a řešení potíží. Source: https://ailoot.ai/blog/cs/opencode-installation-models/ Canonical: https://ailoot.ai/blog/cs/opencode-installation-models/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-c8c772c345ee773fab1803a10a67fd553947459d6851fca3653e695987733819 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](https://ailoot.ai/docs/). ## Co je OpenCode jednoduše řečeno?
Hlavní body OpenCode je open-source AI agent pro programování (licence MIT) od týmu Anomaly. Funguje v terminálu a je dostupný také jako desktopová aplikace, rozšíření editoru a webová verze. Zadáte mu, co má v projektu udělat, a agent sám čte soubory, upravuje kód a spouští příkazy. Samotný nástroj je zdarma; připojíte si vlastní cloudový nebo místní model.
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ů](https://github.com/anomalyco/opencode) (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?
Hlavní body Claude Code funguje pouze s modely Anthropic. Codex je agent OpenAI svázaný s ekosystémem ChatGPT. OpenCode je otevřený nástroj bez závislosti na jednom poskytovateli: je zdarma a můžete si vybrat model z více než 75 poskytovatelů, včetně předplatných ChatGPT Plus a GitHub Copilot, i místních modelů.
| Funkce | OpenCode | Claude Code | Codex | |----|----|----|----| | Kód | Otevřený, MIT | Uzavřený | Otevřený | | Modely | Více než 75 poskytovatelů a místní modely | Pouze Claude | Modely OpenAI | | Cena nástroje | Zdarma | Předplatné nebo tokeny | Předplatné ChatGPT nebo tokeny | | Přístup přes předplatné | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (vlastní předplatné) | ChatGPT (vlastní předplatné) | | Kde běží | Terminál, desktop, editor, prohlížeč | Terminál a editor | Terminál, web, editor | | Konfigurace projektu | AGENTS.md | CLAUDE.md | AGENTS.md | 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](https://ailoot.ai/blog/cs/install-claude-code/). 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](https://ailoot.ai/blog/cs/openai-codex-install/) Codexu. Pokud se teprve rozhodujete, který nástroj zvolit, začněte tímto přehledem: [s čím lidé programují v roce 2026](https://ailoot.ai/blog/cs/ai-coding-tools/). 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í](https://ailoot.ai/blog/cs/codex-claude-agent-opencode-devin-desktop-acp/). ## Co se změnilo v OpenCode 2.0?
Hlavní body K 4. říjnu 2026 je OpenCode 2.0 dostupný na opencode.ai, má vlastní instalátor a nový npm balíček `@opencode/cli`. První verze – ta, kterou instaluje tento článek – nezmizela: v dokumentaci má samostatnou větev `V1`, je aktivně podporovaná a zůstává výchozí volbou. Ve v2 jsou tři oblasti, v nichž vývojáři záměrně nezachovali kompatibilitu s první verzí: API pluginů, protokol serveru a soubor nastavení terminálu.
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 `/.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](https://ailoot.ai/blog/cs/zcode-claude-code-alternative/), dalšího podobného agenta s vlastním rozhraním. ## Co potřebujete před instalací?
Hlavní body Budete potřebovat dvě věci: moderní emulátor terminálu (dokumentace uvádí WezTerm, Alacritty, Ghostty nebo Kitty) a přístup k modelu – API klíč poskytovatele, podporované předplatné nebo místní model přes Ollamu. Model budete potřebovat po instalaci: připojíte ho při prvním spuštění.
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?
Hlavní body Jeden příkaz v terminálu: curl -fsSL \| bash. Dokumentace označuje tento způsob za nejjednodušší. Alternativy: brew install anomalyco/tap/opencode, npm install -g opencode-ai a v Arch Linuxu pacman nebo paru.
Doporučenou cestou je oficiální instalátor: 1. ### Spusťte instalátor ```bash 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 ```bash 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: ```bash brew install anomalyco/tap/opencode ``` ```bash 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í: ```bash 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?
Hlavní body Dokumentace doporučuje WSL kvůli výkonu a plné kompatibilitě: nainstalujte Windows Subsystem for Linux a poté v něm nainstalujte OpenCode obvyklým linuxovým příkazem. Bez WSL můžete použít Chocolatey (`choco install opencode`), Scoop (`scoop install opencode`), npm nebo desktopovou aplikaci.
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: ```powershell wsl --install ``` Po restartu otevřete v nabídce Start Ubuntu a spusťte v něm obvyklý příkaz: ```bash 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: ```bash cd /mnt/c/Users/Name/project opencode ``` Druhou možností je vynechat WSL a použít správce balíčků ve Windows. V PowerShellu: ```powershell choco install opencode ``` ```powershell 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?
Hlavní body V terminálovém rozhraní zadejte `/connect` a vyberte poskytovatele ze seznamu: OpenCode Zen, pokud chcete začít bez vlastních klíčů, Anthropic nebo OpenAI s API klíčem, ChatGPT Plus nebo GitHub Copilot s předplatným, nebo Ollama pro místní model. Klíče se ukládají do souboru auth.json; konkrétní model vyberte příkazem `/models`.
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č: | Možnost | Co to je | Cena | |----|----|----| | OpenCode Zen | Agregátor modelů prověřený týmem OpenCode | Platba za požadavek, dobití zůstatku | | OpenCode Go | Předplatné na otevřené modely od týmu | \$10 měsíčně (Go) nebo \$40 měsíčně (Go Plus, vyšší limity) | | API klíč | Anthropic, OpenAI, Google, DeepSeek a další | Platíte poskytovateli podle využití | | Předplatné | ChatGPT Plus, GitHub Copilot, GitLab Duo | Již zaplaceno | | Ollama / LM Studio | Místní model na vašem hardwaru | Bez účtů za API, ale potřebujete dostatečně výkonný 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: ```json { "$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?
Hlavní body Nainstalujte Ollamu z ollama.com a stáhněte model příkazem `ollama pull` – Ollama se pro OpenCode může nakonfigurovat automaticky. Ručním postupem je přidat poskytovatele do `opencode.json` s adresou místního serveru . Model vyberte příkazem `/models`. Pokud agent nevolá nástroje, zvyšte v Ollamě `num_ctx` na 16k–32k.
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](https://ailoot.ai/blog/cs/free-coding-models/), 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: ```bash 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: ```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" } } } } } ``` 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](https://ailoot.ai/blog/cs/qwen-code-api-key/). ## Kolik stojí OpenCode a jeho používání?
Hlavní body OpenCode samotný je zdarma: jeho zdrojový kód je zveřejněn pod licencí MIT. Platíte pouze za model: podle skutečného využití přes API klíč nebo Zen, předplatným Go, přes své předplatné ChatGPT Plus nebo Copilot, anebo vůbec nic – požadavky na místní model přes Ollamu jsou zdarma.
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í?
Hlavní body Přejděte do složky projektu, spusťte opencode a použijte příkaz `/init` – agent projekt prozkoumá a vytvoří soubor AGENTS.md s jeho popisem. Než začnete upravovat soubory, stiskněte Tab a přepněte do režimu Plan: navrhne řešení a ukáže změny ke schválení. Chybné akce vraťte příkazem `/undo`.
První spuštění – ve složce projektu: ```bash 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:

Pomáhá mluvit s ním tak, jako byste mluvili s juniorským vývojářem ve svém týmu.

— Oficiální dokumentace OpenCode, https://opencode.ai/docs/
Čí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í?
Hlavní body Vlastní příkazy z markdown souborů ve složce `.opencode/commands`, subagenti pro paralelní úkoly a čtení kódu, MCP servery pro externí nástroje, webová verze v prohlížeči a režim serveru pro vzdálenou práci.
**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](https://ailoot.ai/blog/cs/mcp-servers-claude-code/) 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ří?
Hlavní body Téměř všechny problémy spadají do tří kategorií: příkaz `opencode` nelze najít (spusťte novou relaci terminálu nebo upravte PATH), model neodpovídá (zkontrolujte klíč v `/connect` a soubor `auth.json`) nebo se rozhraní vykresluje nesprávně (použijte moderní terminál, například WezTerm). Řešení potíží začněte kontrolou protokolů v `~/.local/share/opencode/log/`.
**„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í?
Hlavní body Stručné odpovědi na časté otázky: OpenCode je jako nástroj zdarma; platíte jen za model. Claude Pro/Max připojíte přes `/connect` a pluginy třetích stran jsou pro tento účel zakázané. Přístup z telefonu je možný přes webovou verzi. OpenCode se aktualizuje příkazem `opencode upgrade`.
### Často kladené otázky Je OpenCode zdarma? Ano, jeho zdrojový kód je zveřejněn pod licencí MIT. Za model můžete platit; všechny možnosti popisuje výše uvedená část o nákladech. Mohu připojit předplatné Claude Pro/Max? Ano, Anthropic má v `/connect` oficiální možnost Claude Pro/Max s ověřením v prohlížeči. Starší články o používání předplatného Claude přes pluginy jsou zastaralé: Anthropic tyto pluginy zakazuje a počínaje verzí 1.3.0 byly z OpenCode odstraněny. Je OpenCode dostupný v telefonu? Funkční možností je webová verze: spusťte `opencode serve` na počítači nebo serveru a pak se připojte z prohlížeče v telefonu. Pro jakýkoli síťový přístup je vyžadováno heslo, `OPENCODE_SERVER_PASSWORD`. V čem je OpenCode lepší než Claude Code? Záleží na vašich modelech a předplatných: Claude Code se integruje s modely Anthropic, zatímco OpenCode nabízí více než 75 poskytovatelů, open-source kód a místní modely. Úplné srovnání najdete v tabulce výše. Mám OpenCode 2.0 nainstalovat hned? Ne nutně. Dokumentace ve výchozím nastavení doporučuje současnou první verzi – tedy verzi instalovanou příkazem curl -fsSL https://opencode.ai/install \| bash v tomto návodu. Druhá verze je dostupná od 4. října 2026, ale pluginy a integrace se serverovým API v ní fungují jinak a část kódu bude potřeba přepsat.
### Zdroje - [OpenCode, oficiální dokumentace](https://opencode.ai/docs/) - [Poskytovatelé modelů](https://opencode.ai/docs/providers/) - [Výběr a konfigurace modelů](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [Agenti a subagenti](https://opencode.ai/docs/agents/) - [Soubor pravidel AGENTS.md](https://opencode.ai/docs/rules/) - [Vlastní příkazy](https://opencode.ai/docs/commands/) - [MCP servery](https://opencode.ai/docs/mcp-servers/) - [OpenCode ve Windows přes WSL](https://opencode.ai/docs/windows-wsl) - [Terminálové rozhraní](https://opencode.ai/docs/tui/) - [Webová verze](https://opencode.ai/docs/web/) - [Řešení potíží](https://opencode.ai/docs/troubleshooting/) - [Příkazový řádek](https://opencode.ai/docs/cli/) - [Repozitář OpenCode na GitHubu](https://github.com/anomalyco/opencode) - [OpenCode 2.0: migrace z verze 1](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: plány a limity](https://opencode.ai/go)
[Otevřete Ailoot](https://ailoot.ai/). ## Časté otázky ### Proč mi instalace OpenCode nezajistí funkční model? Nástroj a přístup k modelu jsou oddělené. Připojte poskytovatele či podporované předplatné přes /connect nebo nastavte místní model, vyberte jej v /models a ověřte jeden vymezený projektový úkol. ### Co zkontrolovat před přechodem z OpenCode 1.x na 2.0? Ověřte kompatibilitu pluginů, integrací serverového API a nastavení terminálu. Průvodce je uvádí jako oblasti migrace; před výměnou spustitelného souboru ověřte instalovanou verzi a zachovejte nastavení i relace. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.