OpenCode: Open-source AI agent v terminálu — instalace, příkazy a kompletní průvodce

Co je OpenCode?

OpenCode je AI coding agent pro terminál — open-source nástroj pod MIT licencí, který vám dá plnou kontrolu nad tím, jaký AI model používáte, kde běží a jak se chová. Na rozdíl od proprietárních řešení jako Claude Code nejste vázáni na jednoho poskytovatele. Chcete dnes Claude, zítra GPT-4 a na víkend lokální model přes Ollama? OpenCode to zvládne bez přepínání nástrojů.

Projekt vznikl pod organizací SST (tvůrci serverless frameworku) a nyní spadá pod organizaci Anomaly. Je napsaný v TypeScriptu, běží na Bunu a má propracované terminálové rozhraní (TUI) postavené na SolidJS. S více než 130 000 hvězdičkami na GitHubu je jedním z nejpopulárnějších open-source AI nástrojů vůbec.

75+

podporovaných LLM providerů — od cloud API po lokální modely

Instalace na macOS

Nejrychlejší cesta — instalační skript, který detekuje platformu a stáhne správný binární soubor:

Terminál

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

Alternativně přes Homebrew (doporučeno pro automatické aktualizace):

Terminál

# Oficiální Homebrew formula brew install opencode # Nebo přes tap brew install anomalyco/tap/opencode

Pro macOS je k dispozici i desktopová aplikace (beta) přes brew install --cask opencode-desktop — nativní Tauri wrapper kolem webového rozhraní.

Instalace na Windows

Na Windows máte dvě hlavní možnosti — Scoop nebo Chocolatey:

PowerShell

# Přes Scoop scoop install opencode # Přes Chocolatey choco install opencode

Desktopová aplikace je dostupná i pro Windows: scoop install extras/opencode-desktop. Pokud preferujete npm:

PowerShell

npm i -g opencode-ai@latest

Tip pro Windows

Pro nejlepší zážitek z TUI doporučujeme Windows Terminal s profilem pro PowerShell 7+ nebo Git Bash. Starší cmd.exe nemusí správně zobrazovat některé Unicode znaky a barvy, které OpenCode používá.

Instalace na Linuxu

Univerzální instalační skript funguje na všech distribucích:

Terminál

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

Pro specifické distribuce:

Distribuce

# Arch Linux (oficiální balíček) sudo pacman -S opencode # Arch Linux (AUR — nejnovější verze) paru -S opencode-bin # Nix nix run nixpkgs#opencode # Homebrew (funguje i na Linuxu) brew install opencode # Mise (polyglot tool manager) mise use -g opencode

OpenCode je k dispozici i jako Docker image pro kontejnerizované prostředí a CI/CD pipeline.

Po instalaci spusťte opencode auth login — interaktivní průvodce vás provede nastavením API klíčů pro poskytovatele, které chcete používat. Bez API klíče OpenCode nefunguje (na rozdíl od IDE pluginů nemá vlastní model).

Podporovaní AI provideři

Největší výhoda OpenCode oproti proprietárním nástrojům: není uzamčený na jednoho poskytovatele. Podporuje přes 75 LLM providerů, včetně:

Cloud AI — Anthropic (Claude), OpenAI (GPT), Google (Gemini), xAI (Grok), Mistral, Groq, DeepInfra, Cohere, Together AI, Perplexity
Enterprise — Azure OpenAI, Amazon Bedrock, Google Vertex AI, GitHub Copilot, GitLab Duo
Gateway/routing — OpenRouter, Vercel AI Gateway, Cloudflare AI Gateway, Helicone
Lokální modely — Ollama, LM Studio, llama.cpp (přes OpenAI-kompatibilní endpoint)
OpenCode Zen — vlastní kurátorská služba za $20 pay-as-you-go

Nastavení providera

# Přihlášení k providerovi opencode auth login # Seznam autentizovaných providerů opencode auth list # Zobrazení dostupných modelů opencode models # Spuštění s konkrétním modelem opencode --model anthropic/claude-sonnet-4-6 # Lokální model přes Ollama opencode --model ollama/llama3

Model specifikujete ve formátu provider/model-id. Pokud chcete přepnout model během session, stačí stisknout F2 nebo použít příkaz /models.

Proprietární nástroje

Jeden provider. Jeden model. Jedno předplatné. Pokud API spadne, nepracujete. Vendor lock-in.

OpenCode

75+ providerů. Přepnutí modelu jedním příkazem. Lokální modely bez internetu. Žádný vendor lock-in. MIT licence.

Režimy práce

OpenCode nabízí čtyři režimy, které pokrývají různé workflow:

TUI (výchozí) — interaktivní terminálové rozhraní. Spustíte příkazem opencode. Kompletní UI se sidebar, barevným zvýrazněním a klávesovými zkratkami.
Run — neinteraktivní režim. opencode run --prompt "oprav bugy v src/". Výstup do stdout, ideální pro skripty.
Serve — spustí headless API server (port 4096). Umožňuje ovládat OpenCode z jiných aplikací — mobilní app, web, nebo vlastní integrace.
Web — spustí server + webové rozhraní v prohlížeči. opencode web.

Příkazy

# Interaktivní TUI (výchozí) opencode # Neinteraktivní — provede úkol a skončí opencode run --prompt "přidej error handling do src/api/" # API server pro vzdálené ovládání opencode serve --port 4096 # Webové rozhraní opencode web # Připojení k běžícímu serveru opencode attach

Klient-server architektura je unikátní feature. Můžete spustit OpenCode na výkonném desktopu a ovládat ho z telefonu přes webové rozhraní. Server podporuje mDNS — automaticky se najde v lokální síti.

Klíčové CLI příkazy a přepínače

1. Session management

OpenCode ukládá konverzace automaticky. Vracet se k nim můžete několika způsoby:

Session příkazy

# Pokračovat v poslední session opencode --continue # Pokračovat v konkrétní session opencode --session SESSION_ID # Forknout session (kopie pro experimentování) opencode --continue --fork # Seznam všech sessions opencode session list # Export session jako JSON opencode export # Import session (ze souboru nebo sdílené URL) opencode import session.json

2. Model a agent

Přepínání modelů a agentů za běhu:

Model příkazy

# Spustit s konkrétním modelem opencode --model openai/gpt-4o # Spustit s konkrétním agentem opencode --agent code-reviewer # V TUI: F2 pro přepnutí modelu # V TUI: Tab/Shift+Tab pro přepnutí agenta # Vytvořit vlastního agenta opencode agent create # Seznam agentů opencode agent list

3. Soubory a kontext

Připojení souborů přímo z příkazové řádky:

Soubory

# Připojit soubory ke konverzaci opencode --file src/api/auth.ts --file src/types/user.ts # V TUI: @ pro fuzzy vyhledávání souborů

4. Výstupní formáty

Formáty

# Výchozí textový výstup opencode run --prompt "analyzuj kód" --format default # JSON výstup pro strojové zpracování opencode run --prompt "najdi bugy" --format json # Statistiky spotřeby opencode stats

5. MCP servery

Rozšíření schopností přes Model Context Protocol:

MCP

# Přidat MCP server opencode mcp add # Seznam MCP serverů opencode mcp list # OAuth autentizace pro MCP opencode mcp auth

6. GitHub agent

OpenCode má vestavěného GitHub agenta, který reaguje na zmínky v komentářích:

GitHub

# Nastavit GitHub Actions agenta opencode github install # Spustit GitHub agenta manuálně opencode github run

Po nastavení stačí napsat /opencode oprav tento bug do komentáře u issue nebo PR — agent vytvoří branch, provede změny a otevře pull request. Funguje v GitHub Actions runners.

30+

vestavěných LSP serverů — automatická detekce jazyka a diagnostika v reálném čase

LSP integrace — inteligentní diagnostika

Jedna z nejsilnějších funkcí OpenCode. Vestavěná podpora 30+ LSP serverů znamená, že AI agent dostává diagnostiku v reálném čase — vidí chyby, warningy a typing problémy ještě předtím, než vám je ukáže editor.

Podporované jazyky zahrnují:

Web — TypeScript, JavaScript, Vue, Svelte, Astro, HTML, CSS
Backend — Python, Go, Rust, Java, C#, PHP, Elixir, Kotlin
Systémové — C, C++, Zig, Swift, Dart
Funkcionální — Haskell, OCaml, Gleam, F#, Clojure
Ostatní — Bash, Lua, Nix, Terraform, YAML

LSP servery se detekují automaticky podle souborových přípon. Pokud máte nainstalovaný příslušný LSP server (např. typescript-language-server), OpenCode ho použije. Pokud ne, automaticky ho nainstaluje.

Proč je to důležité

LSP integrace znamená, že AI agent nemusí hádat, jestli kód zkompiluje — vidí stejné chyby jako váš editor. Když edituje soubor a zavede typing chybu, okamžitě ji vidí a opraví. Bez LSP by o ní nevěděl, dokud nespustíte compiler.

Automatické formátování

OpenCode automaticky formátuje soubory po každé AI editaci. Podporuje 24+ formátovacích nástrojů:

JavaScript/TypeScript — Biome, Prettier, dprint
Python — Ruff, Black, autopep8, YAPF
Go — gofmt, goimports
Rust — rustfmt
C/C++ — clang-format
A další — shfmt (Bash), stylua (Lua), nixfmt (Nix), terraform fmt, swift-format...

Formátování se spouští transparentně — nevidíte ho, ale výstup AI je vždy konzistentní s vaším projekt setupem. Pokud máte .prettierrc nebo biome.json, OpenCode ho respektuje.

Konfigurace: opencode.json

OpenCode se konfiguruje přes opencode.json (nebo opencode.jsonc s komentáři) v kořeni projektu:

Příklad opencode.json

// Hlavní model pro komplexní úkoly "model": "anthropic/claude-sonnet-4-6" // Menší model pro jednoduché dotazy "small_model": "openai/gpt-4o-mini" // Oprávnění pro nástroje "permission": { "bash": "ask", "edit": "allow", "read": "allow" } // Sdílení sessions "share": "manual" // Automatické aktualizace "autoupdate": true // Instrukce (ekvivalent CLAUDE.md) "instructions": ["./AGENTS.md", "./.opencode/rules.md"]

Konfigurace se hledá v tomto pořadí (od nejnižší priority po nejvyšší):

Remote config — z endpointu .well-known/opencode vaší organizace
Globální — ~/.config/opencode/opencode.json
Env proměnná — cesta v OPENCODE_CONFIG
Projektová — opencode.json v kořeni
Managed — enterprise úroveň (/etc/opencode nebo C:\ProgramData\opencode)

Konfigurace podporuje proměnné: { env:ANTHROPIC_API_KEY } pro environment proměnné a { file:path/to/key } pro obsah souborů.

TUI — klávesové zkratky a navigace

OpenCode má propracované terminálové rozhraní inspirované Vimem. Leader klávesa je výchozí Ctrl+X (konfigurovatelná).

Hlavní zkratky

<leader>n — nová session
<leader>l — seznam sessions
<leader>g — timeline zobrazení
<leader>b — přepnout sidebar
<leader>m — seznam modelů
<leader>a — seznam agentů
<leader>u — undo (vrátit změnu)
<leader>r — redo (obnovit změnu)
<leader>y — kopírovat do clipboardu
<leader>t — přepnout barevné téma
<leader>q — ukončit
F2 / Shift+F2 — cyklovat mezi modely
Tab / Shift+Tab — cyklovat mezi agenty
@ — fuzzy vyhledávání souborů

Editace textu (Emacs/readline styl)

Ctrl+A / Ctrl+E — začátek / konec řádku
Alt+F / Alt+B — posun o slovo dopředu / dozadu
Ctrl+K — smazat do konce řádku
Ctrl+W — smazat slovo dozadu

Témata

OpenCode obsahuje 10+ barevných témat: tokyonight, catppuccin, gruvbox, nord, kanagawa, everforest, ayu, one-dark, matrix a další. Konfiguruje se v souboru tui.json nebo příkazem /theme.

Pokud jste Vim uživatel, budete se cítit jako doma. Leader key, kompozitní zkratky a fuzzy vyhledávání souborů přes @ — celé TUI je navržené pro klávesnicové ovládání bez myši.

Snapshoty — undo/redo pro AI změny

OpenCode automaticky vytváří snapshoty souborů při každé editaci. Pokud AI udělá nežádoucí změnu, můžete ji okamžitě vrátit:

Undo/Redo

# V TUI: leader+u pro undo, leader+r pro redo # Nebo slash příkazy: /undo /redo

To je zásadní výhoda oproti nástrojům, kde musíte ručně procházet Git historii nebo diffovat soubory. OpenCode ví přesně, co AI změnil, a umí to atomicky vrátit — bez ohledu na to, kolik souborů bylo dotčeno.

Plugin systém

OpenCode má rozšiřitelnou plugin architekturu. Pluginy jsou JS/TS soubory v adresáři .opencode/plugins/ nebo npm balíčky:

Hooks — reagujte na editace souborů, LSP eventy, session eventy, spouštění nástrojů
Custom tools — definujte vlastní nástroje, které AI může volat
Shell environment — upravte prostředí pro bash příkazy
Overrides — přepište chování vestavěných nástrojů

Pluginy jsou silný nástroj pro týmy — můžete vynutit konvence, přidat interní nástroje (přístup k interní wiki, ticketovacímu systému) nebo automatizovat opakující se úkoly.

GitHub agent — AI přímo v repozitáři

Unikátní feature: OpenCode GitHub agent reaguje na zmínky přímo v GitHub komentářích. Napíšete /opencode oprav tento bug do issue komentáře a agent:

Analyzuje issue a relevantní kód
Vytvoří novou branch
Provede změny
Otevře pull request s popisem

Funguje v GitHub Actions — nastavíte ho příkazem opencode github install. Triggery: komentáře u issues, PR reviews, scheduler, manuální dispatch. Zkratka /oc funguje stejně jako /opencode.

130k+

GitHub stars — jeden z nejpopulárnějších open-source AI nástrojů

OpenCode vs. Claude Code — kdy co použít?

Claude Code

Proprietární. Pouze Anthropic modely. 1M tokenů kontextu. Stabilnější pro production workflow. Chrome integrace. Vestavěná memory. Lepší pro enterprise s Anthropic smlouvou.

OpenCode

Open source (MIT). 75+ providerů. LSP integrace. Auto-formátování. Plugin systém. Undo/redo. GitHub agent. Témata. Klient-server architektura. Lokální modely.

V praxi záleží na vašem use case:

Vyberte Claude Code pokud: váš tým má Anthropic smlouvu, potřebujete Chrome integraci, cenníte si stability a dedikované podpory
Vyberte OpenCode pokud: chcete svobodu výběru modelu, potřebujete lokální modely (air-gapped prostředí), chcete LSP diagnostiku, stavíte vlastní pluginy, potřebujete GitHub agenta
Oba najednou — není problém mít oba. Claude Code pro komplexní úkoly s velkým kontextem, OpenCode pro rychlé úpravy s Sonnet/GPT-4o nebo lokálním modelem

Tipy a triky

Slash příkazy v TUI

/init — inicializuje konfiguraci projektu
/undo / /redo — vrátit/obnovit AI změny
/share — sdílet session přes veřejný odkaz
/models — přepnout model
/theme — změnit barevné téma
/connect — připojit k běžícímu serveru
/help — nápověda

Lokální modely bez internetu

Pro práci offline nebo v citlivých prostředích:

Ollama setup

# Nainstalovat Ollama a stáhnout model ollama pull llama3 # Spustit OpenCode s lokálním modelem opencode --model ollama/llama3 # Nebo v opencode.json: "model": "ollama/llama3"

Vzdálené ovládání z telefonu

Remote workflow

# Na desktopu: spustit server opencode serve # Server se automaticky registruje přes mDNS # Na mobilu/tabletu: otevřít webové rozhraní # http://desktop-hostname:4096

CI/CD integrace

CI/CD příklady

# Automatický code review v pipeline opencode run --prompt "review changes vs main" --format json # Generování release notes opencode run --prompt "generate changelog from recent commits" --format default # Security audit opencode run --prompt "security audit of src/ directory" --format json

Shrnutí: Jak začít s OpenCode

Nainstalujte — curl -fsSL https://opencode.ai/install | bash (nebo package manager)
Přihlaste se — opencode auth login (nastavte API klíč alespoň jednoho providera)
Inicializujte projekt — /init v TUI vytvoří opencode.json
Začněte jednoduše — vysvětlení kódu, generování testů, code review
Přidejte LSP — většinou funguje automaticky, jinak upřesněte v konfiguraci
Experimentujte s modely — zkuste různé providery, najděte optimální poměr cena/výkon

Největší výhoda OpenCode? Svoboda. Můžete kdykoliv přepnout model, providera, nebo dokonce celý nástroj — vaše session data, konfigurace a pluginy zůstanou. Žádný vendor lock-in, žádné překvapení na faktuře.

Chcete se naučit efektivně pracovat s AI coding nástroji? Na našich workshopech pro vývojáře porovnáváme Claude Code, OpenCode i další nástroje na reálných příkladech z vašeho stacku.