# OpenCode: telepítés, modellek és első indítás > Telepítés macOS, Linux és Windows rendszeren, OpenCode 1.x és 2.0, szolgáltatók és Ollama csatlakoztatása, konfiguráció, költségek és hibaelhárítás. Source: https://ailoot.ai/blog/hu/opencode-installation-models/ Canonical: https://ailoot.ai/blog/hu/opencode-installation-models/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-190 Revision: sha256-8c6974dd3905cbf1bbd0f195f336d43c0e3204d593557cd9eca132a5f90ed694 Az OpenCode egy nyílt forráskódú AI-kódolóügynök terminálhoz: maga az eszköz ingyenes (MIT-licenc), és bármilyen modellt csatlakoztathat hozzá — a Claude-tól és a GPT-től kezdve az Ollamán keresztül futtatott helyi modellekig. A projekt GitHub-repozitóriuma már több mint kétszázezer csillagot kapott. A „ingyenes Claude Code bármilyen modellel” kifejezés jól hangzik, de pontosításra szorul: maga az eszköz ingyenes, a használati feltételek pedig a választott modelltől függenek. Az alábbiakban mindent megtalál a hivatalos dokumentáció alapján: mi ez az eszköz, hogyan telepítheti macOS, Linux vagy Windows rendszeren, hogyan csatlakoztathat modellt, és mit érdemes tennie az első indításkor. Külön rész foglalkozik a költségekkel, mert itt az „ingyenes” csak az eszközre vonatkozik: a modellek pénzbe kerülnek, és ez okozza a legtöbb félreértést. [Az Ailoot használatával kapcsolatos gyakorlati tudnivalókat a dokumentációban találja](https://ailoot.ai/docs/). ## Mi az OpenCode egyszerűen?
Főbb pontok Az OpenCode egy nyílt forráskódú AI-kódolóügynök (MIT-licenc) az Anomaly csapatától. Terminálban működik, és asztali alkalmazásként, szerkesztőbővítményként, valamint webes változatban is elérhető. Elmondja neki, mit kell elvégezni a projektben, az ügynök pedig önállóan beolvassa a fájlokat, módosítja a kódot és parancsokat futtat. Maga az eszköz ingyenes; Ön választja ki a csatlakoztatott modellt, amely lehet felhőalapú vagy helyi.
Röviden: az OpenCode ugyanazt csinálja, mint a Claude Code: természetes nyelven megadott feladatot fogad, és végrehajtja a projektben. Két dologban különböznek. A kód teljesen nyílt, így elolvashatja és ellenőrizheti. Az eszköz ráadásul nincs egyetlen modell szolgáltatójához kötve: több mint 75 szolgáltatóval működik, az Anthropic és az OpenAI modelljeitől kezdve a saját hardverén futó helyi modellekig. A projektet az Anomaly csapata fejleszti. A repozitórium 2025. április 30-án jött létre, és 2026. október 4-én [több mint 211 ezer csillaggal és 28 ezer forkkal](https://github.com/anomalyco/opencode) rendelkezett (GitHub API-kéréssel ellenőrizve). A programozási nyelv a TypeScript. A dokumentáció folyamatosan frissül, ezért az alábbi útmutató az aktuális verzión alapul. Ne keverje össze az elnevezéseket: az aktuális változat npm-csomagjának neve `opencode-ai`, a repozitórium neve `anomalyco/opencode`, a terminálparancs pedig egyszerűen `opencode`. Régebbi cikkekben előfordulhat az `sst/opencode` cím: a szervezet átnevezte magát, a régi hivatkozás pedig most az új címre irányít át. **Frissítve: 2026. október 4.:** a csapat kiadta az OpenCode 2.0-t, az eszköz következő nagy generációját. Az alábbi telepítési és modellcsatlakoztatási útmutató továbbra is az aktuális 1.x-es változathoz készült (a `curl -fsSL https://opencode.ai/install | bash` paranccsal telepíthető; 2026. szeptember 30-án az aktuális verzió az 1.18.34 volt): ezt továbbra is aktívan támogatják, és ezt telepíti az opencode.ai/docs oldalon található hivatalos dokumentáció. Az alábbi külön rész ismerteti, hogy pontosan mi változott a második verzióban, és mikor érdemes váltani. ## Miben különbözik az OpenCode a Claude Code-tól és a Codextől?
Főbb pontok A Claude Code kizárólag Anthropic-modellekkel működik. A Codex egy OpenAI-ügynök, amely a ChatGPT ökoszisztémájához kötődik. Az OpenCode nyílt eszköz, amely nem kötődik egyetlen szolgáltatóhoz sem: ingyenes, Ön pedig több mint 75 szolgáltató modelljei közül választhat, köztük a ChatGPT Plus és a GitHub Copilot előfizetésével elérhető modellek, valamint helyi modellek közül.
| Funkció | OpenCode | Claude Code | Codex | |----|----|----|----| | Kód | Nyílt, MIT | Zárt | Nyílt | | Modellek | Több mint 75 szolgáltató és helyi modellek | Csak Claude | OpenAI-modellek | | Az eszköz ára | Ingyenes | Előfizetés vagy tokenek | ChatGPT-előfizetés vagy tokenek | | Előfizetéses hozzáférés | ChatGPT Plus, GitHub Copilot, GitLab Duo | Claude Pro/Max (saját előfizetés) | ChatGPT (saját előfizetés) | | Hol fut | Terminál, asztali alkalmazás, szerkesztő, böngésző | Terminál és szerkesztő | Terminál, web, szerkesztő | | Projektkonfiguráció | AGENTS.md | CLAUDE.md | AGENTS.md | Ha már van Claude-előfizetése, érdemes a Claude Code-ot megtartania elsődleges eszközként — ehhez [részletes telepítési útmutatót](https://ailoot.ai/blog/hu/install-claude-code/) is készítettünk. Három esetben lehet jó választás az OpenCode: ha ChatGPT Plus- vagy GitHub Copilot-előfizetéssel szeretne dolgozni, ha API-számlák nélkül szeretne helyi modellt futtatni, vagy ha egyetlen felületen szeretne több modellel dolgozni. A Codexhez is van [áttekintésünk és telepítési útmutatónk](https://ailoot.ai/blog/hu/openai-codex-install/). Ha még nem választott eszközt, kezdje ezzel az áttekintéssel: [mivel programoznak az emberek 2026-ban](https://ailoot.ai/blog/hu/ai-coding-tools/). Ha pedig az OpenCode már telepítve van, és az ACP-n keresztül más ügynökökhöz kell csatlakoztatnia a Devin Desktopban, nézze meg az [ehhez a beállításhoz készült útmutatónkat](https://ailoot.ai/blog/hu/codex-claude-agent-opencode-devin-desktop-acp/). ## Mi változott az OpenCode 2.0-ban?
Főbb pontok 2026. október 4-én az OpenCode 2.0 elérhető az opencode.ai oldalon, saját telepítővel és az új `@opencode/cli` npm-csomaggal. Az első verzió — amelyet ez a cikk telepít — nem tűnt el: a dokumentációban külön `V1` ágként szerepel, aktív támogatást kap, és továbbra is ez az alapértelmezett lehetőség. A v2-ben három területen nem tartották meg szándékosan a visszamenőleges kompatibilitást: a bővítmény-API, a szerverprotokoll és a terminálbeállítások fájlja terén.
A második verzió a `curl -fsSL https://opencode.ai/v2/install | bash` paranccsal telepíthető. A hivatalos migrációs útmutató (`opencode.ai/v2/docs/migrate-v1`) szerint mindkét verzió ugyanazt az `opencode` parancsot használja, és alapértelmezés szerint már nem települnek egymás mellé: a v2 telepítője lecseréli a v1 bináris fájlját, a csomagkezelőn keresztül történő v2-telepítés előtt pedig a dokumentáció kifejezetten kéri a v1-es verzió eltávolítását. A konfigurációt azonban ugyanazokból a fájlokból olvassa be — `~/.config/opencode/` és `/.opencode/` —, ezért a beállítások, az ügynökök és az MCP-szerverek átvihetők átírás nélkül. Három dolgot kell átírni: a bővítményeket (új API-t kaptak), a szerver-API-val való integrációkat (megváltozott a protokoll), valamint a terminálbeállításokat (a több `tui.json` fájl helyett most egy közös `cli.json` fájl van). A v2 két legjelentősebb új funkciója a következő. Először is megjelent a Console — egy fizetős csapatszolgáltatás, amely használatkövetést, költségkereteket és minden tagra érvényes közös szabályokat kínál. Másodszor, a csapat végre bejelentette a Go-előfizetés árát: a Go havi \$10, a magasabb limiteket kínáló Go Plus pedig havi \$40 (az `opencode.ai/go` oldalt 2026. október 4-én ellenőriztük). Korábban a dokumentáció csak „alacsony költségű előfizetést” említett, konkrét összeg nélkül. Ha most ismerkedik az eszközzel, és csak telepíteni szeretné az ügynököt, kövesse az alábbi útmutatót; az a dokumentáció által is ajánlott aktuális első verziót ismerteti. A v2-t akkor érdemes választania, ha szüksége van az új bővítményfunkciókra vagy a csapatoknak szánt Console-ra — de készüljön fel arra, hogy néhány régebbi bővítményt át kell írnia az új API-hoz. Ha inkább olyan nyílt forráskódú asztali alkalmazást keres, amelyhez nem kell terminál, olvassa el a [ZCode-ról szóló áttekintésünket](https://ailoot.ai/blog/hu/zcode-claude-code-alternative/), amely egy hasonló, saját felülettel rendelkező ügynököt mutat be. ## Mire van szükség a telepítés előtt?
Főbb pontok Két dologra lesz szüksége: egy modern terminálemulátorra (a dokumentáció a WezTermet, az Alacrittyt, a Ghosttyt vagy a Kittyt nevezi meg), valamint hozzáférésre egy modellhez — ehhez szolgáltatói API-kulcs, támogatott előfizetés vagy Ollamán keresztül elérhető helyi modell kell. A modellre a telepítés után lesz szüksége: az első indításkor csatlakoztatja.
Érdemes kicsit többet mondani a terminálról, mert a telepítés csak ezen a ponton térhet el a várakozásoktól. Az OpenCode panelekkel és kiemelésekkel ellátott teljes felületet jelenít meg a terminálban, ezért kér a dokumentáció modern emulátort. Ha az indítás után hibásan néz ki a felület, először telepítse a négy ajánlott lehetőség egyikét: WezTerm (minden rendszeren működik), Alacritty, Ghostty vagy Kitty. Windows alatt a fő megoldás a WSL; ezzel az alábbiakban külön rész foglalkozik. A másik szükséges dolog egy modell. Az OpenCode az Ön által csatlakoztatott modellen keresztül működik: önmagában nem dolgozza fel a kéréseket. Négy lehetőség van: előfizetés (ChatGPT Plus, GitHub Copilot, GitLab Duo), bármely szolgáltató API-kulcsa, az OpenCode csapatának saját modellgyűjtője, az OpenCode Zen, vagy helyi modell az Ollamán keresztül. Mind a négy lehetőséget bemutatjuk a modellek csatlakoztatásáról szóló részben. Projektleírás nélkül az ügynöknek találgatnia kell a buildparancsokat, a fájlstruktúrát és az alkalmazott konvenciókat — ebből adódnak a „hallucinációk”. Az OpenCode ehhez AGENTS.md fájlt használ. Ugyanez a megközelítés érvényes a Claude Code-ra és bármely más ügynökre is; csak az útmutatófájl neve változik. ## Hogyan telepítheti az OpenCode-ot macOS és Linux rendszeren?
Főbb pontok Egyetlen terminálparancs: curl -fsSL \| bash. A dokumentáció ezt nevezi a legegyszerűbb módszernek. Alternatívák: brew install anomalyco/tap/opencode, npm install -g opencode-ai, Arch Linux alatt pedig pacman vagy paru.
Az ajánlott megoldás a hivatalos telepítő: 1. ### Futtassa a telepítőt ```bash curl -fsSL https://opencode.ai/install | bash ``` A szkript felismeri a rendszert, és letölti az OpenCode-ot. Ha a telepítés után nem található a parancs, zárja be, majd nyissa meg újra a terminált; az új munkamenet már felismeri az útvonalat. 2. ### Ellenőrizze a telepítést ```bash opencode --version ``` A parancs visszaad egy verziószámot, ami azt jelenti, hogy a telepítés sikerült. A „command not found” válasz az első lépéshez irányítja vissza: indítson új terminálmunkamenetet, vagy szerkessze kézzel a PATH-ot. Ha inkább saját maga kezeli a csomagokat, az alábbi lehetőségek közül választhat: ```bash brew install anomalyco/tap/opencode ``` ```bash npm install -g opencode-ai ``` A Homebrew-parancs szándékosan az `anomalyco/tap/` előtaggal kezdődik: a dokumentáció a saját tap használatát ajánlja, mert a Homebrew csapata ritkábban frissíti a `brew install opencode` parancshoz tartozó formulát. Ugyanez az `opencode-ai` csomagnév a bun, a pnpm és a yarn csomagkezelővel is használható (`bun install -g opencode-ai`, `yarn global add opencode-ai`). Arch Linux alatt használja a `sudo pacman -S opencode` parancsot a stabil tárolóból, vagy a `paru -S opencode-bin` parancsot az AUR legújabb verziójához. Az OpenCode a `opencode upgrade` paranccsal frissíthető; indításkor automatikusan is letölti a frissítéseket, ha be van kapcsolva az automatikus frissítés. Frissítés után a megszokott `opencode --version` paranccsal ellenőrizze a verziót. Az eltávolítás is beépített funkció: ```bash opencode uninstall ``` A parancs pontosan megmutatja, hogy mit fog törölni, majd megerősítést kér. Ha szeretné, megtarthatja a konfigurációt és a munkamenet adatait: használja a `--keep-config` és a `--keep-data` kapcsolókat. ## Hogyan telepítheti az OpenCode-ot Windows rendszeren?
Főbb pontok A dokumentáció a WSL-t ajánlja a teljesítmény és a teljes kompatibilitás érdekében: telepítse a Windows Subsystem for Linuxot, majd azon belül az OpenCode-ot a szokásos Linux-paranccsal. WSL nélkül használhatja a Chocolateyt (`choco install opencode`), a Scoopot (`scoop install opencode`), az npm-et vagy az asztali alkalmazást.
A fejlesztők által elsőként ajánlott lehetőség a WSL. Telepítse egyetlen paranccsal egy rendszergazdaként futtatott PowerShell-ablakban: ```powershell wsl --install ``` Az újraindítás után nyissa meg az Ubuntut a Start menüből, és futtassa benne a megszokott parancsot: ```bash curl -fsSL https://opencode.ai/install | bash ``` A Windows-meghajtókon lévő fájlok a WSL-ben a `/mnt/` útvonalon érhetők el — a C: meghajtó a `/mnt/c/`, a D: meghajtó pedig a `/mnt/d/` útvonalon található. Így egy `C:\Users\Name\project` útvonalú projekt például így nyitható meg: ```bash cd /mnt/c/Users/Name/project opencode ``` A második lehetőség a WSL kihagyása és a Windows csomagkezelőinek használata. PowerShellben: ```powershell choco install opencode ``` ```powershell scoop install opencode ``` A harmadik lehetőség az asztali alkalmazás és a webes változat. Az alkalmazás úgy telepíthető, mint bármely más program, és terminál nélkül, egy ablakban jeleníti meg a felületet. A webes változat az `opencode web` paranccsal indul: böngészőben nyitja meg az OpenCode-ot, a dokumentáció pedig azt is ajánlja, hogy WSL-ből indítsa, így elkerülhetők a fájlhozzáférési problémák. A dokumentáció kevésbé gyakori lehetőségeket is felsorol — a mise-t, a Dockert és a GitHub-kiadások oldaláról letölthető előre elkészített bináris fájlt. A bunon keresztüli windowsos telepítés még folyamatban van; ha a bun az elsődleges csomagkezelője, használja az npm-es lehetőséget. ## Hogyan csatlakoztathat modellt az OpenCode-hoz?
Főbb pontok A terminálfelületen írja be a `/connect` parancsot, és válasszon szolgáltatót a listából: saját kulcs nélküli kezdéshez OpenCode Zen, API-kulccsal Anthropic vagy OpenAI, előfizetéssel ChatGPT Plus vagy GitHub Copilot, helyi modellhez pedig Ollama. A kulcsokat az auth.json fájl menti; konkrét modellt a `/models` paranccsal választhat.
Az OpenCode az AI SDK-n és a Models.dev-en keresztül több mint 75 szolgáltatót, valamint helyi modelleket támogat. A legtöbb szolgáltatót a felületen belül kiadott `/connect` paranccsal lehet csatlakoztatni; helyi modell esetében a szerver címét is meg kell adni a konfigurációban. A lehetőségek fizetési módjukban és gépigényükben különböznek: | Lehetőség | Mi ez? | Költség | |----|----|----| | OpenCode Zen | Az OpenCode csapata által ellenőrzött modellgyűjtő | Használatonkénti fizetés, egyenlegfeltöltés | | OpenCode Go | A csapat nyílt modelljeihez kínált előfizetés | Havi \$10 (Go) vagy havi \$40 (Go Plus, magasabb limitekkel) | | API-kulcs | Anthropic, OpenAI, Google, DeepSeek és mások | A szolgáltatónak fizet a használat alapján | | Előfizetés | ChatGPT Plus, GitHub Copilot, GitLab Duo | Már ki van fizetve | | Ollama / LM Studio | Helyi modell a saját hardveren | Nincs API-számla, de megfelelő teljesítményű számítógépre van szükség | A dokumentáció azt javasolja, hogy a kezdők az OpenCode Zennel induljanak. A csapat olyan modelleket választott, amelyek ügynökként különösen jól működnek, és a szolgáltatókkal való kombinációikat a saját feladatain tesztelte. A csatlakoztatás menete: írja be a `/connect` parancsot, válassza az OpenCode Zent, jelentkezzen be, adja meg a fizetési adatokat az opencode.ai/auth oldalon, kérjen egy kulcsot, majd illessze be. Ezután a `/models` megjeleníti az ajánlott modellek listáját. 2026. október 4-én a lista például a GPT 6.1 Solt, a GPT 6 Astrát, a Claude Opus 5.5-öt, a Claude Sonnet 5-öt, a GLM 5.3-at és a Kimi K2.5-öt tartalmazta. A dokumentáció őszintén figyelmeztet, hogy a lista nem teljes, és gyorsan elavul, mert minden héten jelennek meg új modellek. Az előfizetések ugyanazzal a `/connect` paranccsal csatlakoztathatók: válassza ki a listából a ChatGPT Plus vagy a GitHub Copilot lehetőséget, majd jelentkezzen be a fiókjába — nincs szükség további beállításra. Ha az Anthropicot választja, a `/connect` két lehetőséget kínál: kézzel megadhat egy API-kulcsot, vagy kiválaszthatja a Claude Pro/Max előfizetést, majd böngészőben hitelesítheti magát. Az Anthropic azonban tiltja a Claude Pro/Max-előfizetés használatára szolgáló külső bővítményeket, az OpenCode-ba beépített ilyen bővítményeket pedig az 1.3.0-s verziótól eltávolították. Ha egy régebbi, „Claude-előfizetésen keresztül használt OpenCode-ról” szóló cikkel találkozik, az az eltávolított bővítményekre vonatkozik, nem hivatalos engedélyezésre. A ChatGPT Plus, a GitHub Copilot, a GitLab Duo (kísérleti jelöléssel) és az Atomic Chat előfizetéses hozzáférése külön beállítás nélkül működik. Az OpenCode a `/connect` paranccsal megadott kulcsokat a `~/.local/share/opencode/auth.json` fájlban tárolja. Ha nem szeretne minden alkalommal modellt választani, állítsa be az alapértelmezett modellt a projekt gyökérkönyvtárában található `opencode.json` konfigurációs fájlban: ```json { "$schema": "https://opencode.ai/config.json", "model": "anthropic/claude-sonnet-4-5" } ``` A formátum `provider/model`; mindkét azonosító megjelenik a `/models` kimenetében. ## Hogyan csatlakoztathat helyi modellt az Ollamán keresztül?
Főbb pontok Telepítse az Ollamát az ollama.com oldalról, majd töltse le a modellt az `ollama pull` paranccsal — az Ollama automatikusan be tudja állítani magát az OpenCode-hoz. A kézi megoldásnál vegyen fel egy szolgáltatót az `opencode.json` fájlba a helyi szerver címével. Válasszon modellt a `/models` paranccsal. Ha az ügynök nem hívja meg az eszközöket, növelje az Ollama `num_ctx` értékét 16k–32k-re.
Ez a megoldás egyáltalán nem jár API-számlával: a modell a számítógépén fut. Ha általában az ingyenes modellek közül választ, külön [áttekintésben](https://ailoot.ai/blog/hu/free-coding-models/) foglalkozunk azzal, melyek működnek elfogadhatóan ügynökként, és melyek csak papíron. Az OpenCode használatához telepítse az Ollamát a hivatalos webhelyről, majd töltsön le egy modellt: ```bash ollama pull qwen3-coder ``` Hasznos részlet a dokumentációból: az Ollama automatikusan be tudja állítani magát az OpenCode-hoz; külön integrációs útmutató is tartozik hozzá. Ha mindent kézzel szeretne beállítani, vegyen fel egy szolgáltatót a helyi Ollama-szerver címével az `opencode.json` fájlba: ```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" } } } } } ``` Ezután a felület `/models` listájában megjelenik a helyi modell. Válassza ki, és már dolgozhat is vele. A dokumentáció egy gyakorlati megjegyzése: ha az ügynök nem hívja meg az eszközöket (nem szerkeszt fájlokat vagy nem futtat parancsokat), növelje az `num_ctx` értékét az Ollama beállításaiban — kezdje 16k–32k értékkel. A helyi modellek kifejezetten az ügynöki feladatokban gyengébbek a felhőmodelleknél, a kis kontextus pedig tovább ront a helyzeten. Ha a helyi változat nem elég, kulccsal a felhőből is csatlakoztathatja a Qwent; a kulcs beszerzését a [Qwen Code API-kulcs beszerzéséről szóló útmutató](https://ailoot.ai/blog/hu/qwen-code-api-key/) ismerteti. ## Mennyibe kerül az OpenCode és a használata?
Főbb pontok Maga az OpenCode ingyenes: a forráskódja MIT-licenc alatt jelent meg. Csak a modellért fizet: a tényleges használat alapján API-kulccsal vagy a Zenen keresztül, Go-előfizetéssel, a ChatGPT Plus- vagy Copilot-előfizetésével, vagy egyáltalán nem — az Ollamán keresztüli helyi modellnek küldött kérések ingyenesek.
Az itt felsorolt összes költség a modellre vonatkozik, és négy forgatókönyv van. API-kulcs vagy Zen használatakor a tényleges használat alapján fizet, az összeg pedig attól függ, mennyit dolgozik az ügynök. A Go az OpenCode csapata által kínált előfizetés nyílt modellekhez: havi \$10 a Go, havi \$40 pedig a magasabb limiteket kínáló Go Plus (az `opencode.ai/go` oldalon 2026. október 4-én ellenőrizve). A limit a modelltől függ: a Go például 5 óránként körülbelül 110 kérést (havonta 440-et) engedélyez a Kimi K3 esetében, a könnyebb DeepSeek V4.1 Flashnél pedig körülbelül 26 000 kérést 5 óránként. A limiten túli hozzáféréshez a dokumentáció külön árat tüntet fel az adott modellhez (havi \$15 a Kimi K3-ért, \$60 a Go Plusért). A modellek és limitek teljes listáját a csatlakoztatáskor megjelenő előfizetési oldalon találja. ChatGPT Plus vagy Copilot használatakor a kéréseket a már kifizetett előfizetése fedezi; ne feledje, hogy az előfizetéseknek saját használati intenzitási korlátaik vannak. Végül az Ollamán keresztül használt helyi modellnek küldött kérések ingyenesek — de elég erős számítógép kell hozzá, hogy gyorsan futtassa őket. ## Mit érdemes tenni az első indításkor?
Főbb pontok Lépjen a projekt mappájába, futtassa az opencode parancsot, és használja az `/init` parancsot — az ügynök átvizsgálja a projektet, és létrehoz egy azt leíró AGENTS.md fájlt. Mielőtt módosításokat végezne, nyomja meg a Tab billentyűt a Plan módra váltáshoz: az ügynök megoldást javasol, és jóváhagyásra megmutatja a módosításokat. A hibás műveleteket a `/undo` paranccsal vonhatja vissza.
Az első indítást a projekt mappájában végezze: ```bash cd path/to/project opencode ``` A felület egy beviteli mezővel nyílik meg. Először használja az `/init` parancsot: az ügynök átvizsgálja a repozitórium fontos fájljait, szükség esetén feltesz néhány kérdést, majd létrehoz egy AGENTS.md fájlt — ez ismerteti a projekt felépítését, a buildeléshez és teszteléshez futtatandó parancsokat, valamint az alkalmazott konvenciókat. A dokumentáció azt javasolja, hogy ezt a fájlt commitolja a gitbe; az OpenCode ezután állandó projektutasításként használja. A szerepét tekintve az AGENTS.md közvetlen megfelelője a CLAUDE.md-nek az OpenCode ökoszisztémájában. Másodszor, használja a Plan módot. A Tab billentyűvel válthat a két fő ügynök között: a Build teljes hozzáféréssel dolgozik a fájlokkal és parancsokkal, a Plan pedig elemzésre és tervezésre való — Plan módban a fájlmódosításokhoz és bash-parancsokhoz alapértelmezés szerint az Ön jóváhagyása szükséges. Új feladatoknál a dokumentáció a tervvel való kezdést ajánlja: olvassa el, mit készül tenni az ügynök, pontosítsa a megfogalmazást, és csak ezután váltson vissza a Buildre a Tab billentyűvel. A dokumentáció ezt tanácsolja:

Érdemes úgy beszélni vele, ahogyan egy csapatában dolgozó junior fejlesztővel beszélne.

— Hivatalos OpenCode-dokumentáció, https://opencode.ai/docs/
Minél konkrétabb a feladat, és minél több kontextust ad, annál kevesebb utómunkára lesz szüksége. Az `@` jellel adhat fájlokat a kéréshez — kezdje el begépelni a nevüket, a felület pedig fuzzy kereséssel megkeresi őket. Képeket közvetlenül a terminálba is húzhat; a `!` jellel kezdődő üzenet pedig shell-parancsként fut, és a kimenete bekerül az ügynök kontextusába. Ha hibásan adta meg a feladatot, vagy az ügynök rosszul végezte el, a `/undo` visszavonja a módosításokat; egymás után többször is használhatja. Meggondolta magát? A `/redo` visszaállítja a visszavont módosításokat. A `/share` pedig hivatkozást készít a beszélgetéshez a csapata számára; e parancs nélkül a beszélgetés sehol sem jelenik meg nyilvánosan. ## Mire képes még az OpenCode?
Főbb pontok Egyéni parancsok a `.opencode/commands` mappában lévő markdownfájlokból, párhuzamos feladatokhoz és kódolvasáshoz használható alügynökök, külső eszközökhöz csatlakoztatható MCP-szerverek, böngészőben elérhető webes változat és távoli munkához használható szervermód.
**Egyéni parancsok.** Bármely gyakori kérésből készíthet parancsot: tegyen egy markdownfájlt az `.opencode/commands/` mappába, az előlapján adja meg a `description`, `agent` és `model` mezőket, majd alá írjon egy prompt-sablont. Ezután a parancsot a `/` jellel hívhatja meg. Ilyen lehet például a projekt ellenőrzése közzététel előtt, a legutóbbi hibák áttekintése vagy egy migráció létrehozása — bármi, amit rendszeresen kér. **Alügynökök.** A Build és a Plan mellett még három van: a több lépésből álló feladatokra használható General (a feladatlista kivételével minden eszközhöz hozzáfér), az engedély nélküli kódolvasásra szolgáló Explore, valamint a külső könyvtárak felkutatására használható Scout. Üzenetben az `@` jellel szólíthatja meg őket. **MCP-szerverek.** A külső eszközöket az `opencode.json` konfigurációs fájl `mcp` szakaszán keresztül csatlakoztathatja — helyi és távoli szerverek egyaránt támogatottak. Minden MCP-szerver hozzáadja eszközeit a kontextushoz, egy olyan sokat fogyasztó szerver pedig, mint a GitHub, nagyon gyorsan felhasználhatja a kontextust — csak szelektíven, kizárólag a szükséges szervereket csatlakoztassa. Az MCP fogalmáról [kész konfigurációkat is tartalmazó útmutatónk](https://ailoot.ai/blog/hu/mcp-servers-claude-code/) van; az a Claude Code-ról szól, de a protokoll közös. **Webes változat és szerver.** Az `opencode web` böngészőben nyitja meg a felületet. Másik gépről való eléréshez használja az `opencode serve --hostname 0.0.0.0 --port 4096` parancsot; hálózati hozzáférés esetén feltétlenül állítson be jelszót az `OPENCODE_SERVER_PASSWORD` változóval. Jelszó nélkül a szerver nem védett. ## Mit tegyen, ha valami hiba történik a telepítés során?
Főbb pontok A problémák szinte mindig három dologra vezethetők vissza: az `opencode` parancs nem található (indítson új terminálmunkamenetet, vagy szerkessze a PATH-ot), a modell nem válaszol (ellenőrizze a kulcsot a `/connect` paranccsal és az `auth.json` fájlt), vagy a felület hibásan jelenik meg (használjon modern terminált, például a WezTermet). A hibaelhárítást a `~/.local/share/opencode/log/` mappában található naplókkal kezdje.
**Telepítés után „opencode: command not found” üzenet jelenik meg.** A terminál még nem ismeri az új útvonalat. Először egyszerűen zárja be, majd nyissa meg újra. Ha ez nem segít, keresse meg, hová tette a telepítő a bináris fájlt, és vegye fel ezt a mappát a terminál PATH-jába. **A modell nem válaszol, vagy hitelesítési hibát jelez.** Ellenőrizze, hogy csatlakoztatva van-e a szolgáltató: adja ki a `/connect` parancsot, és hitelesítse újra magát. A kulcsok a `~/.local/share/opencode/auth.json` fájlban vannak — ha másik gépről helyezte át a telepítést, vagy törölte a mappákat, előfordulhat, hogy a fájl hiányzik. A dokumentáció külön tárgyalja a ProviderInitError és az AI_APICallError hibát: az elsőnél hitelesítse újra a szolgáltatót, a másodiknál törölje a `~/.cache/opencode` mappát, majd indítsa újra az eszközt. **Hibás a felület: szétszóródnak a panelek, vagy olvashatatlan karakterek jelennek meg a szimbólumok helyett.** Először ellenőrizze a terminált. Telepítse az egyik ajánlott lehetőséget — a WezTerm mindhárom rendszeren működik —, majd onnan indítsa el az OpenCode-ot. Ha semmi sem segít, ellenőrizze a naplókat: macOS és Linux alatt a `~/.local/share/opencode/log/` mappában találja őket; Windows alatt nyomja meg a Win+R billentyűkombinációt, és írja be ezt: `%USERPROFILE%\.local\share\opencode\log`. A tíz legutóbbi fájlt őrzi meg; a részletes naplózást az `opencode --log-level DEBUG` kapcsolóval engedélyezheti. A naplókkal hibajelentést küldhet a projekt GitHub-tárolójában. ## Milyen további kérdéseket tesznek fel az OpenCode-ról?
Főbb pontok Rövid válaszok a gyakori kérdésekre: maga az OpenCode ingyenes; csak a modellért kell fizetni. A Claude Pro/Max a `/connect` paranccsal csatlakoztatható, a külső bővítmények használata pedig tilos. A webes változaton keresztül telefonról is elérhető. Az OpenCode az `opencode upgrade` paranccsal frissíthető.
### Gyakran ismételt kérdések Ingyenes az OpenCode? Igen, a forráskódja MIT-licenc alatt jelent meg. A modellért fizetnie kellhet; az összes lehetőséget a fenti költségekről szóló rész ismerteti. Csatlakoztathatok Claude Pro/Max-előfizetést? Igen, az Anthropic hivatalos Claude Pro/Max-lehetőséget kínál a `/connect` parancsban, böngészős hitelesítéssel. A Claude-előfizetés bővítményeken keresztüli használatáról szóló régi cikkek elavultak: az Anthropic tiltja ezeket a bővítményeket, amelyeket az OpenCode-ból az 1.3.0-s verziótól kezdve el is távolítottak. Elérhető az OpenCode telefonon? A használható megoldás a webes változat: futtassa az `opencode serve` parancsot egy számítógépen vagy szerveren, majd csatlakozzon a telefonja böngészőjéből. Hálózati hozzáférés esetén kötelező jelszót beállítani az `OPENCODE_SERVER_PASSWORD` változóval. Miben jobb az OpenCode a Claude Code-nál? Ez a modellektől és az előfizetésektől függ: a Claude Code Anthropic-modellekkel integrálódik, az OpenCode pedig több mint 75 szolgáltatót, nyílt forráskódú kódot és helyi modelleket kínál. A teljes összehasonlítást a fenti táblázatban találja. Rögtön telepítsem az OpenCode 2.0-t? Nem feltétlenül. A dokumentáció alapértelmezés szerint az aktuális első verziót ajánlja — ez az útmutatóban szereplő curl -fsSL https://opencode.ai/install \| bash paranccsal telepíthető verzió. A második verzió 2026. október 4. óta érhető el, de a bővítmények és a szerver-API-val való integrációk máshogy működnek benne, és néhány kódot át kell írni.
### Források - [OpenCode, hivatalos dokumentáció](https://opencode.ai/docs/) - [Modellszolgáltatók](https://opencode.ai/docs/providers/) - [Modellek kiválasztása és konfigurálása](https://opencode.ai/docs/models/) - [OpenCode Zen](https://opencode.ai/docs/zen/) - [Ügynökök és alügynökök](https://opencode.ai/docs/agents/) - [AGENTS.md szabályfájl](https://opencode.ai/docs/rules/) - [Egyéni parancsok](https://opencode.ai/docs/commands/) - [MCP-szerverek](https://opencode.ai/docs/mcp-servers/) - [OpenCode Windows rendszeren, WSL-en keresztül](https://opencode.ai/docs/windows-wsl) - [Terminálfelület](https://opencode.ai/docs/tui/) - [Webes változat](https://opencode.ai/docs/web/) - [Hibaelhárítás](https://opencode.ai/docs/troubleshooting/) - [Parancssor](https://opencode.ai/docs/cli/) - [OpenCode-repozitórium a GitHubon](https://github.com/anomalyco/opencode) - [OpenCode 2.0: migráció az 1-es verzióról](https://opencode.ai/v2/docs/migrate-v1/) - [OpenCode Go: csomagok és limitek](https://opencode.ai/go)
[Az Ailoot megnyitása](https://ailoot.ai/). ## Kérdések és válaszok: OpenCode: telepítés, modellek és első indítás ### Miért nem ad működő modellt az OpenCode telepítése? Az eszköz és a modellhozzáférés különálló. A /connect alatt kapcsolj szolgáltatót vagy támogatott előfizetést, vagy állíts be helyi modellt, majd a /models alatt válaszd ki és igazolj egy körülhatárolt projektfeladatot. ### Mit nézzek meg OpenCode 1.x-ről 2.0-ra váltás előtt? A pluginek, szerver-API integrációk és terminálbeállítások kompatibilitását. Az útmutató ezeket migrációs területként jelöli; bináriscsere előtt igazold a telepített verziót, és őrizd meg a konfigurációt és munkameneteket. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.