Legfontosabb tudnivalók

• Többféle telepítési útvonal: npm, Homebrew, curl script, Go install, Docker, és forráskódból való fordítás -- válassza azt, amelyik illeszkedik az Ön toolchain környezetéhez.
• Öt perc az első futtatásig: A leggyorsabb útvonal (curl telepítő script) kevesebb mint öt perc alatt működésre bírja az OpenCode-ot bármilyen Unix rendszeren.
• Szolgáltatófüggetlen: Az OpenCode működik OpenAI, Google Gemini, Ollama helyi modellekkel és sok mással -- Ön nincs egyetlen AI szolgáltatóhoz kötve.
• Minimális konfiguráció: Egyetlen config.toml fájl és egy környezeti változó minden, amire szüksége van az AI-val való kódoláshoz a terminálban.

Hogyan telepítsük az OpenCode-ot: Lépésről lépésre útmutató (2026)

Az OpenCode egy nyílt forráskódú AI kódoló ágens, amelyet a terminálhoz fejlesztettek ki. A nagy nyelvi modellek erejét közvetlenül a parancssorba hozza, lehetővé téve a kód írását, refaktorálását, hibakeresését és értelmezését anélkül, hogy elhagyná a szerkesztőt vagy a terminál munkafolyamatát.

Akár először telepíti az OpenCode-ot, akár egy másik AI kódoló eszközről vált át, ez az útmutató végigvezeti Önt minden telepítési módszeren, a kezdeti konfiguráción, a szolgáltatók beállításán és a szükséges hibaelhárítási lépéseken.

---

Előfeltételek

Az OpenCode telepítése előtt ellenőrizze, hogy rendszere megfelel-e az alábbi követelményeknek.

Operációs rendszer

Az OpenCode fut macOS, Linux és Windows rendszereken. Windows felhasználók számára a WSL (Windows Subsystem for Linux) használata erősen ajánlott. A Scoop segítségével elérhető a natív Windows támogatás is.

Futtatási követelmények (a telepítési módszertől függően)

Telepítési módszer	Követelmény
npm	Node.js 18 vagy újabb
Homebrew	macOS vagy Linux telepített Homebrew-val
Curl script	bash, curl
Go install	Go 1.22 vagy újabb
Docker	Docker Engine 20+
Build from source	Go 1.22+, Git

Terminál követelmények

Az OpenCode TUI (Terminal User Interface) felületet biztosít, így a terminál emulátornak támogatnia kell a true color megjelenítést és a megfelelő Unicode renderinget. A legtöbb modern terminál (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) alapból működik. A régebbi terminálok, mint például az alapértelmezett macOS Terminal.app, megjelenítési problémákat tapasztalhatnak.

Ellenőrizze a Node.js verzióját:

node --version

Ellenőrizze a Go verzióját (ha a Go install módszert használja):

go version

---

1. módszer: Telepítő script (Leggyorsabb)

A hivatalos telepítő script a leggyorsabb módja az OpenCode elindításának. Felismeri az OS-t és az architektúrát, letölti a megfelelő binary-t, és elhelyezi a PATH-ban.

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

Ez az egyetlen parancs mindent elintéz. A befejezés után ellenőrizze a telepítést:

opencode --version

Ez a módszer macOS és Linux rendszereken működik. Nem igényel Node.js-t vagy Go-t.

---

2. módszer: npm telepítés

Ha már használja a Node.js-t a munkafolyamatában, az npm a legismerősebb opció.

npm install -g opencode-ai@latest

A csomag neve az npm-en opencode-ai, nem pedig opencode. Ez gyakori forrása a félreértéseknek.

Az ellenőrzéshez:

opencode --version

Ha jogosultsági hibákba ütközik, vagy javítsa ki az npm globális könyvtárának jogosultságait, vagy használja az npx-et a globális telepítés nélküli futtatáshoz:

npx opencode-ai@latest

---

3. módszer: Homebrew (macOS és Linux)

A Homebrew felhasználók a hivatalos tap-ból telepíthetik az OpenCode-ot:

brew install anomalyco/tap/opencode

Ez telepíti a legújabb stabil kiadást, és a frissítéseket a brew upgrade parancson keresztül kezeli.

Az ellenőrzéshez:

opencode --version

---

4. módszer: Go Install

Ha telepítve van a Go 1.22+, közvetlenül forrásból is telepítheti a go install segítségével:

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

Győződjön meg róla, hogy a $GOPATH/bin (vagy alapértelmezés szerint $HOME/go/bin) szerepel a PATH-ban. Ha még nincs ott, adja hozzá a shell profiljához:

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

Ellenőrzés:

opencode --version

---

5. módszer: Docker

Az OpenCode futtatása Docker-ben hasznos CI/CD pipeline-ok esetén, vagy ha izolált környezetet szeretne.

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

Futtassa a projekt könyvtárának csatolásával:

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

Az -it flagek elengedhetetlenek, mert az OpenCode interaktív TUI-t használ. A -v flag csatolja az aktuális projekt könyvtárát, így az OpenCode tudja olvasni és módosítani a fájljait.

---

6. módszer: Forráskódból való fordítás

Közreműködőknek vagy bárkinek, aki a legfrissebb verziót szeretné:

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

Helyezze át a binary-t egy olyan könyvtárba, amely szerepel a PATH-ban:

sudo mv opencode /usr/local/bin/

A forrásból való építéshez Go 1.22+ és Git szükséges. Ez hozzáférést biztosít a még ki nem adott funkciókhoz, és lehetővé teszi az eszköz módosítását a saját igényei szerint.

---

7. módszer: Scoop (Windows)

Azon Windows felhasználók, akik a natív élményt preferálják a WSL-lel szemben, használhatják a Scoop-ot:

scoop install opencode

A Scoop automatikusan kezeli a PATH konfigurációt.

---

Első indítás és konfiguráció

Az OpenCode telepítése után navigáljon bármelyik projekt könyvtárába, és indítsa el:

cd your-project
opencode

Az első indításkor az OpenCode megnyitja a TUI-t, és kéri, hogy csatlakoztasson egy AI szolgáltatót. Használhatja az interaktív /connect parancsot az API kulcs hozzáadásához:

/connect

Ez végigvezeti Önt a szolgáltató (OpenAI, Google, Anthropic, stb.) kiválasztásán és az API kulcs megadásán. A hitelesítő adatok a ~/.local/share/opencode/auth.json fájlban tárolódnak.

A gyorsabb kezdéshez inicializálhatja a projektet a következővel is:

/init

Ez elemzi a repository szerkezetét, és létrehoz egy agents.md fájlt a kódbázis kontextusával, segítve az AI-t abban, hogy kezdettől fogva pontosabb válaszokat adjon.

---

AI szolgáltatók konfigurálása

Az OpenCode több AI szolgáltatót támogat. Itt látható, hogyan konfigurálhatja mindegyiket.

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

Állítsa be az API kulcsot környezeti változóként:

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

Vagy adja hozzá a shell profiljához (~/.zshrc, ~/.bashrc) a tartós beállításhoz.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

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

Google API kulcsot a Google AI Studio oldalon szerezhet be.

Ollama (Helyi modellek -- Ingyenes, Privát)

Az Ollama lehetővé teszi modellek helyi futtatását API kulcs nélkül. Először telepítse az Ollama-t, töltsön le egy modellt, majd konfigurálja az OpenCode-ot:

# Ollama telepítése (ha még nincs telepítve)
curl -fsSL https://ollama.com/install.sh | sh

# Kódoló modell letöltése
ollama pull qwen2.5-coder:32b

# Az OpenCode automatikusan felismeri az Ollama-t, ha a localhost:11434-en fut

Az Ollama-hoz nincs szükség API kulcsra. Az OpenCode automatikusan felismeri, ha helyben fut.

Anthropic (Claude -- Korlátozott hozzáférés)

Az Anthropic korlátozta a Claude hozzáférését harmadik féltől származó eszközökben, beleértve az OpenCode-ot is. Ha van olyan API kulcsa, amely még működik:

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

Azonban 2026-ban a legtöbb felhasználó az OpenAI-t vagy a Gemini-t használja elsődleges szolgáltatóként az OpenCode-dal ezen korlátozások miatt.

---

Alapvető konfiguráció: config.toml áttekintés

Az OpenCode TOML konfigurációs fájlt használ a finomhangoláshoz. A konfigurációs fájl a ~/.config/opencode/config.toml helyen található (vagy a projekt gyökérkönyvtárában opencode.json néven a projekt-specifikus beállításokhoz).

Íme egy gyakorlati példa a config.toml fájlra:

# Provider configuration
[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"

# Disable providers you do not use
disabled_providers = ["anthropic"]

Fontos megjegyzések:

• Változó behelyettesítés: Használja a {env:VARIABLE_NAME} formátumot a környezeti változókra való hivatkozáshoz a kulcsok hardkódolása helyett.
• Modell kiválasztása: Pontosan megadhatja, melyik modellt kívánja használni az egyes szolgáltatóknál.
• Letiltott szolgáltatók: Megakadályozhatja, hogy az OpenCode betöltse azokat a szolgáltatókat, amelyekhez nincs hitelesítő adata, így elkerülhetők az indítási figyelmeztetések.
• Base URL felülbírálása: Ha proxyt vagy egyéni végpontot használ, adja hozzá a baseURL = "https://your-proxy.com/v1" sort a szolgáltató szekcióhoz.

Projekt-szintű konfigurációhoz hozzon létre egy opencode.json fájlt a projekt gyökérkönyvtárában:

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

Ez felülbírálja a globális beállításokat az adott projekthez.

---

A telepítés ellenőrzése

Menjen végig ezen az ellenőrzőlistán annak megerősítéséhez, hogy minden megfelelően működik.

1. Verzió ellenőrzése

opencode --version

Látnia kell a kiírt verziószámot. 2026 márciusában a legújabb stabil verzió a 0.x tartományban van.

2. A TUI elindítása

cd any-project-directory
opencode

Látnia kell az OpenCode terminál felületét egy prompttal az alján.

3. Egyszerű prompt tesztelése

Az OpenCode TUI-ban írjon be egy egyszerű kérést:

Explain what this project does based on the file structure.

Ha választ kap az AI-tól, a szolgáltató konfigurációja működik.

4. Fájlműveletek tesztelése

Kérje meg az OpenCode-ot egy kis tesztfájl létrehozására:

Create a file called test-opencode.txt with the text "OpenCode is working"

Ellenőrizze, hogy a fájl létrejött-e a projekt könyvtárában, majd törölje azt.

---

Gyakori problémák elhárítása

"command not found: opencode"

A binary nincs benne a PATH-ban. A megoldás a telepítési módszertől függ:

• npm: Futtassa az npm list -g opencode-ai parancsot a telepítés megerősítéséhez. Ha telepítve van, ellenőrizze, hogy az npm globális bin könyvtára szerepel-e a PATH-ban: npm config get prefix és adja hozzá a /bin utótagot ehhez az útvonalhoz.
• Go: Adja hozzá a $(go env GOPATH)/bin útvonalat a PATH-hoz.
• Curl script: Futtassa újra a telepítő scriptet, vagy mozgassa manuálisan a binary-t a /usr/local/bin/ könyvtárba.

Jogosultsági hibák az npm telepítés során

Ne használja a sudo npm install -g parancsot. Ehelyett javítsa ki az npm alapértelmezett könyvtárát:

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"

Az OpenCode npm csomagja Node.js 18+ verziót igényel. Ellenőrizze a verzióját:

node --version

Ha régebbi verziót használ, frissítsen nvm használatával:

nvm install 18
nvm use 18

Hálózati hibák vállalati tűzfal mögött

Ha az npm install lefagy vagy hálózati korlátozások miatt meghiúsul:

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

Vagy töltse le a binary-t közvetlenül a GitHub releases page oldalról, és helyezze el manuálisan a PATH-ban.

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

Győződjön meg róla, hogy az API kulcs környezeti változója exportálva van ugyanabban a shell session-ben:

echo $OPENAI_API_KEY

Ha nem ír ki semmit, állítsa be újra:

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

A tartósság érdekében adja hozzá az exportálási sort a ~/.zshrc vagy ~/.bashrc fájlhoz, és futtassa a source ~/.zshrc parancsot.

TUI megjelenítési problémák (összezavart szöveg, hiányzó keretek)

Váltson egy modern terminál emulátorra, amely támogatja a true color-t. Ajánlott opciók: iTerm2 (macOS), Alacritty (cross-platform), WezTerm (cross-platform) vagy Windows Terminal (Windows).

Go install: "go: command not found"

A Go nincs telepítve vagy nincs benne a PATH-ban. Telepítse a Go-t a go.dev/dl oldalról, és biztosítsa, hogy benne legyen a PATH-ban:

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

---

Az OpenCode frissítése

Tartsa naprakészen az OpenCode-ot a legújabb modell-támogatás és hibajavítások érdekében.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl script: Futtassa újra a telepítő parancsot:

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

Go install: Futtassa újra a @latest jelöléssel:

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

---

Következő lépések

Most, hogy az OpenCode telepítve és konfigurálva van, készen áll arra, hogy elkezdje használni a napi munkafolyamatában.

• Tanulja meg a parancsokat: Tekintse meg az OpenCode Tutorial 2026 útmutatónkat a parancsok, munkafolyamatok és speciális funkciók teljes áttekintéséhez.
• GitHub integráció beállítása: Telepítse az OpenCode GitHub App-ot az AI-alapú kódátvizsgáláshoz és az issue-kra való válaszadáshoz közvetlenül a repository-jaiban.
• Fedezze fel a /init parancsot: Futtassa a /init parancsot a projektjében egy agents.md fájl generálásához, amely mély kontextust ad az OpenCode-nak a kódbázisa architektúrájáról.
• Próbáljon ki több szolgáltatót: Konfiguráljon két vagy három szolgáltatót, és váltson közöttük, hogy megtudja, melyik modell működik a legjobban az Ön kódolási feladataihoz.

Az OpenCode az egyik leggyorsabban növekvő nyílt forráskódú AI eszköz 2026-ban, mert ott találkozik a fejlesztőkkel, ahol már amúgy is dolgoznak: a terminálban. Mivel a telepítés kevesebb mint öt percet vesz igénybe, és a konfigurációhoz csak egy API kulcs szükséges, nincs ok arra, hogy ne próbálja ki még ma.