Klíčové poznatky

• Více instalačních cest: npm, Homebrew, curl skript, Go install, Docker a sestavení ze zdroje -- vyberte si tu, která vyhovuje vašemu toolchainu.
• Pět minut do prvního spuštění: Nejrychlejší cesta (instalační skript curl) zprovozní OpenCode za méně než pět minut na jakémkoli systému Unix.
• Agnostický vůči poskytovatelům: OpenCode funguje s OpenAI, Google Gemini, Ollama místními modely a dalšími -- nejste vázáni na jediného AI poskytovatele.
• Konfigurace je minimální: Jediný soubor config.toml a jedna proměnná prostředí jsou vše, co potřebujete k zahájení kódování s AI ve vašem terminálu.

Jak nainstalovat OpenCode: Průvodce nastavením krok za krokem (2026)

OpenCode je open-source AI agent pro kódování vytvořený pro terminál. Přináší výkon velkých jazykových modelů přímo do vašeho příkazového řádku, což vám umožňuje psát, refaktorovat, ladit a chápat kód, aniž byste opustili svůj editor nebo pracovní postup v terminálu.

Ať už nastavujete OpenCode poprvé, nebo přecházíte z jiného nástroje pro kódování s AI, tento průvodce vás provede každou metodou instalace, počáteční konfigurací, nastavením poskytovatele a kroky pro řešení problémů, které budete potřebovat.

---

Předpoklady

Před instalací OpenCode se ujistěte, že váš systém splňuje následující požadavky.

Operační systém

OpenCode běží na macOS, Linux a Windows. Pro uživatele Windows se důrazně doporučuje WSL (Windows Subsystem for Linux). K dispozici je také nativní podpora pro Windows přes Scoop.

Požadavky na běhové prostředí (závisí na metodě instalace)

Metoda instalace	Požadavek
npm	Node.js 18 nebo vyšší
Homebrew	macOS nebo Linux s nainstalovaným Homebrew
Curl skript	bash, curl
Go install	Go 1.22 nebo vyšší
Docker	Docker Engine 20+
Sestavení ze zdroje	Go 1.22+, Git

Požadavky na terminál

OpenCode poskytuje TUI (Terminal User Interface), takže váš terminálový emulátor musí podporovat true color a správné vykreslování Unicode. Většina moderních terminálů (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) funguje ihned po vybalení. Starší terminály, jako je výchozí macOS Terminal.app, mohou mít problémy s vykreslováním.

Zkontrolujte verzi Node.js:

node --version

Zkontrolujte verzi Go (pokud používáte metodu Go install):

go version

---

Metoda 1: Instalační skript (Nejrychlejší)

Oficiální instalační skript je nejrychlejší způsob, jak zprovoznit OpenCode. Detekuje váš operační systém a architekturu, stáhne správný binární soubor a umístí jej do vaší PATH.

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

Tento jediný příkaz vyřídí vše. Po jeho dokončení ověřte instalaci:

opencode --version

Tato metoda funguje na macOS a Linux. Nevyžaduje Node.js ani Go.

---

Metoda 2: Instalace přes npm

Pokud již máte Node.js ve svém pracovním postupu, npm je nejznámější volba.

npm install -g opencode-ai@latest

Název balíčku na npm je opencode-ai, nikoli opencode. Toto je častý zdroj zmatků.

Pro ověření:

opencode --version

Pokud narazíte na chyby oprávnění, buď opravte oprávnění globálního adresáře npm, nebo použijte npx pro spuštění bez globální instalace:

npx opencode-ai@latest

---

Metoda 3: Homebrew (macOS a Linux)

Uživatelé Homebrew mohou nainstalovat OpenCode z oficiálního tapu:

brew install anomalyco/tap/opencode

Tím se nainstaluje nejnovější stabilní verze a aktualizace se řeší pomocí brew upgrade.

Pro ověření:

opencode --version

---

Metoda 4: Instalace přes Go

Pokud máte nainstalované Go 1.22+, můžete instalovat přímo ze zdroje pomocí go install:

go install github.com/opencode-ai/opencode@latest

Ujistěte se, že $GOPATH/bin (nebo ve výchozím nastavení $HOME/go/bin) je ve vaší PATH. Přidejte jej do svého profilu shellu, pokud tam ještě není:

export PATH="$PATH:$(go env GOPATH)/bin"

Ověřte:

opencode --version

---

Metoda 5: Docker

Spouštění OpenCode v Docker je užitečné pro CI/CD pipelines nebo když chcete izolované prostředí.

docker pull ghcr.io/opencode-ai/opencode:latest

Spusťte jej s připojeným adresářem projektu:

docker run -it --rm \
  -v "$(pwd)":/workspace \
  -w /workspace \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/opencode-ai/opencode:latest

Příznaky -it jsou nezbytné, protože OpenCode používá interaktivní TUI. Příznak -v připojí váš aktuální projektový adresář, aby OpenCode mohl číst a upravovat vaše soubory.

---

Metoda 6: Sestavení ze zdroje

Pro přispěvatele nebo kohokoli, kdo chce nejnovější verzi (bleeding-edge):

git clone https://github.com/opencode-ai/opencode.git
cd opencode
go build -o opencode .

Přesuňte binární soubor do adresáře ve vaší PATH:

sudo mv opencode /usr/local/bin/

Sestavení ze zdroje vyžaduje Go 1.22+ a Git. To vám poskytne přístup k nevydaným funkcím a umožní vám nástroj upravit pro své vlastní potřeby.

---

Metoda 7: Scoop (Windows)

Uživatelé Windows, kteří preferují nativní prostředí před WSL, mohou použít Scoop:

scoop install opencode

Scoop automaticky řeší konfiguraci PATH.

---

První spuštění a konfigurace

S nainstalovaným OpenCode přejděte do libovolného adresáře projektu a spusťte jej:

cd your-project
opencode

Při prvním spuštění OpenCode otevře své TUI a vyzve vás k připojení AI poskytovatele. Můžete použít interaktivní příkaz /connect k přidání svého API klíče:

/connect

To vás provede výběrem poskytovatele (OpenAI, Google, Anthropic atd.) a zadáním vašeho API klíče. Přihlašovací údaje jsou uloženy v ~/.local/share/opencode/auth.json.

Pro rychlejší start můžete také inicializovat svůj projekt pomocí:

/init

To analyzuje strukturu vašeho repozitáře a vytvoří soubor agents.md s kontextem o vaší codebase, což pomůže AI poskytovat od začátku přesnější odpovědi.

---

Konfigurace AI poskytovatelů

OpenCode podporuje více AI poskytovatelů. Zde je návod, jak nakonfigurovat každý z nich.

OpenAI (GPT-5.4, GPT-4.1, o3)

Nastavte API klíč jako proměnnou prostředí:

export OPENAI_API_KEY="sk-your-key-here"

Nebo jej přidejte do svého profilu shellu (~/.zshrc, ~/.bashrc) pro trvalost.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

export GOOGLE_API_KEY="your-google-api-key"

API klíč Google můžete získat v Google AI Studio.

Ollama (Místní modely -- zdarma, soukromé)

Ollama vám umožňuje spouštět modely lokálně bez jakéhokoli API klíče. Nejprve nainstalujte Ollama, stáhněte model a poté nakonfigurujte OpenCode:

# Instalace Ollama (pokud ještě není nainstalována)
curl -fsSL https://ollama.com/install.sh | sh

# Stažení modelu pro kódování
ollama pull qwen2.5-coder:32b

# OpenCode detekuje Ollama automaticky při spuštění na localhost:11434

Pro Ollama není potřeba žádný API klíč. OpenCode jej automaticky detekuje při lokálním spuštění.

Anthropic (Claude -- Omezený přístup)

Anthropic omezil přístup k Claude v nástrojích třetích stran, včetně OpenCode. Pokud máte API klíč, který stále funguje:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

Nicméně většina uživatelů v roce 2026 používá s OpenCode jako primárního poskytovatele OpenAI nebo Gemini kvůli těmto omezením.

---

Základní konfigurace: Průvodce souborem config.toml

OpenCode používá pro detailní ovládání konfigurační soubor TOML. Konfigurační soubor se nachází v ~/.config/opencode/config.toml (nebo v kořenovém adresáři projektu jako opencode.json pro nastavení specifická pro projekt).

Zde je praktický příklad config.toml:

# Konfigurace poskytovatele
[provider.openai]
apiKey = "{env:OPENAI_API_KEY}"

[provider.openai.models.gpt]
id = "gpt-5.4"

[provider.google]
apiKey = "{env:GOOGLE_API_KEY}"

[provider.google.models.gemini]
id = "gemini-2.5-pro"

# Zakázání poskytovatelů, které nepoužíváte
disabled_providers = ["anthropic"]

Klíčové věci k zapamatování:

• Nahrazování proměnných: Použijte {env:VARIABLE_NAME} pro odkazování na proměnné prostředí namísto pevného kódování klíčů.
• Výběr modelu: Můžete přesně specifikovat, který model se má u každého poskytovatele použít.
• Zakázaní poskytovatelé: Zabraňte OpenCode v načítání poskytovatelů, jejichž přihlašovací údaje nemáte, abyste se vyhnuli varováním při spuštění.
• Přepsání základní URL: Pokud používáte proxy nebo vlastní endpoint, přidejte baseURL = "https://vase-proxy.com/v1" pod sekci poskytovatele.

Pro konfiguraci na úrovni projektu vytvořte opencode.json v kořenovém adresáři projektu:

{
  "provider": "openai",
  "model": "gpt-5.4"
}

Toto přepíše globální nastavení pro daný konkrétní projekt.

---

Ověření instalace

Projděte si tento kontrolní seznam, abyste potvrdili, že vše funguje správně.

1. Zkontrolujte verzi

opencode --version

Měli byste vidět vytištěné číslo verze. K březnu 2026 je nejnovější stabilní verze v řadě 0.x.

2. Spusťte TUI

cd any-project-directory
opencode

Měli byste vidět terminálové rozhraní OpenCode s výzvou ve spodní části.

3. Otestujte jednoduchý dotaz

V TUI OpenCode napište jednoduchý požadavek:

Vysvětli, co tento projekt dělá na základě struktury souborů.

Pokud dostanete odpověď od AI, vaše konfigurace poskytovatele funguje.

4. Otestujte souborové operace

Požádejte OpenCode o vytvoření malého testovacího souboru:

Vytvoř soubor s názvem test-opencode.txt s textem "OpenCode funguje"

Zkontrolujte, zda byl soubor vytvořen v adresáři vašeho projektu, a poté jej smažte.

---

Řešení běžných problémů

"command not found: opencode"

Binární soubor není ve vaší PATH. Řešení závisí na vaší metodě instalace:

• npm: Spusťte npm list -g opencode-ai pro potvrzení instalace. Pokud je nainstalován, zkontrolujte, zda je globální adresář binárních souborů npm ve vaší PATH: npm config get prefix a přidejte /bin k této cestě.
• Go: Přidejte $(go env GOPATH)/bin do své PATH.
• Curl skript: Znovu spusťte instalační skript nebo ručně přesuňte binární soubor do /usr/local/bin/.

Chyby oprávnění během instalace npm

Nepoužívejte sudo npm install -g. Místo toho opravte výchozí adresář npm:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g opencode-ai@latest

"Error: Node.js version too old"

Balíček npm OpenCode vyžaduje Node.js 18+. Zkontrolujte svou verzi:

node --version

Pokud máte starší verzi, upgradujte pomocí nvm:

nvm install 18
nvm use 18

Síťové chyby za firewallem společnosti

Pokud se instalace přes npm zasekne nebo selže kvůli síťovým omezením:

npm install -g opencode-ai@latest --registry https://registry.npmmirror.com

Nebo si stáhněte binární soubor přímo ze stránky vydání na GitHubu a umístěte jej do své PATH ručně.

"API key not found" nebo "No provider configured"

Ujistěte se, že proměnná prostředí vašeho API klíče je exportována ve stejné relaci shellu:

echo $OPENAI_API_KEY

Pokud se nic nevytiskne, nastavte ji znovu:

export OPENAI_API_KEY="sk-your-key-here"

Pro trvalost přidejte řádek s exportem do svého ~/.zshrc nebo ~/.bashrc a spusťte source ~/.zshrc.

Problémy s vykreslováním TUI (zkomolený text, chybějící okraje)

Přepněte na moderní terminálový emulátor, který podporuje true color. Doporučené možnosti: iTerm2 (macOS), Alacritty (multiplatformní), WezTerm (multiplatformní) nebo Windows Terminal (Windows).

Go install: "go: command not found"

Go není nainstalováno nebo není ve vaší PATH. Nainstalujte Go z go.dev/dl a ujistěte se, že je ve vaší PATH:

export PATH="$PATH:/usr/local/go/bin"

---

Aktualizace OpenCode

Udržujte OpenCode aktuální, abyste získali nejnovější podporu modelů a opravy chyb.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl skript: Znovu spusťte instalační příkaz:

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

Go install: Znovu spusťte s @latest:

go install github.com/opencode-ai/opencode@latest

---

Další kroky

Nyní, když je OpenCode nainstalován a nakonfigurován, jste připraveni jej začít používat ve svém každodenním pracovním postupu.

• Naučte se příkazy: Podívejte se na náš OpenCode tutoriál 2026 pro kompletního průvodce příkazy, pracovními postupy a pokročilými funkcemi.
• Nastavte integraci s GitHub: Nainstalujte aplikaci OpenCode GitHub App pro používání AI-poháněného code review a odpovědí na issues přímo ve vašich repozitářích.
• Prozkoumejte příkaz /init: Spusťte /init ve svém projektu a vygenerujte soubor agents.md, který poskytne OpenCode hluboký kontext o architektuře vaší codebase.
• Vyzkoušejte více poskytovatelů: Nakonfigurujte dva nebo tři poskytovatele a přepínejte mezi nimi, abyste zjistili, který model nejlépe vyhovuje vašim úkolům při kódování.

OpenCode je jedním z nejrychleji rostoucích open-source AI nástrojů v roce 2026, protože se s vývojáři setkává tam, kde už pracují: v terminálu. S instalací trvající méně než pět minut a konfigurací vyžadující pouze jeden API klíč není důvod, proč jej nevyzkoušet ještě dnes.