OpenCode: telepítés, modellek és első indítás

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.

Mi az OpenCode egyszerűen?#

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 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?#

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 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.

Ha még nem választott eszközt, kezdje ezzel az áttekintéssel: mivel programoznak az emberek 2026-ban. 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.

Mi változott az OpenCode 2.0-ban?#

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 <project>/.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, amely egy hasonló, saját felülettel rendelkező ügynököt mutat be.

Mire van szükség a telepítés előtt?#

É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?#

Az ajánlott megoldás a hivatalos telepítő:

1. Futtassa a telepítőt

   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

   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:

brew install anomalyco/tap/opencode

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ó:

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?#

A fejlesztők által elsőként ajánlott lehetőség a WSL. Telepítse egyetlen paranccsal egy rendszergazdaként futtatott PowerShell-ablakban:

wsl --install

Az újraindítás után nyissa meg az Ubuntut a Start menüből, és futtassa benne a megszokott parancsot:

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:

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:

choco install opencode

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?#

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:

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:

{
  "$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?#

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 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:

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:

{
  "$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ó ismerteti.

Mennyibe kerül az OpenCode és a használata?#

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?#

Az első indítást a projekt mappájában végezze:

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:

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?#

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 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?#

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?#

Az Ailoot megnyitása.