Shopify CLI telepítése és frissítése 2026-ban

A Shopify CLI telepítéséhez 2026-ban Node.js 22.12 vagy újabb verzió, egy támogatott csomagkezelő és legalább Git 2.28 szükséges. A legegyszerűbb megoldás az npm install -g @shopify/cli@latest, macOS-en pedig Homebrew-t is használhatsz. A 4.x CLI automatikusan frissülhet, de CI-ban, projektlokális telepítésnél és major verzióváltáskor továbbra is neked kell gondoskodnod a frissítésről.

A telepítőparancs ritkán okoz gondot. A legtöbb hiba akkor kezdődik, amikor a gépen régi Node.js fut, két különböző csomagkezelővel is felkerült a CLI, vagy a terminál másik shopify binárist talál meg, mint amelyiket éppen frissítetted.

Ez az útmutató a telepítésre, frissítésre és az ezek körüli hibákra koncentrál. Ha előbb azt szeretnéd tisztázni, mire használható az eszköz app-, theme- és Hydrogen-fejlesztésnél, olvasd el a Shopify CLI 3.0 pillar cikket.

Mire van szükség a Shopify CLI telepítéséhez?

A Shopify aktuális CLI dokumentációja 2026 júliusában az alábbi minimumkövetelményeket adja meg:

Összetevő	Követelmény
Node.js	22.12 vagy újabb
Csomagkezelő	npm, Yarn 1.x vagy pnpm
Git	2.28.0 vagy újabb

Mielőtt telepítesz, ellenőrizd a gépedet:

node --version
npm --version
git --version

Ha a Node.js verziója alacsonyabb 22.12-nél, előbb azt frissítsd. Fejlesztői gépen praktikus valamilyen Node version managert használni, mert több projekt eltérő Node-verziót kérhet. Így nem kell minden váltásnál rendszerszinten újratelepítened a Node.js-t.

Régebbi tutorialokban még Node.js 18 vagy 20 szerepelhet. Ezek a cikkek a megjelenésükkor lehettek pontosak, a telepítésnél mindig a jelenlegi Shopify CLI referencia követelménye legyen az irányadó.

Shopify CLI telepítése npm-mel

Az npm-es globális telepítés minden könyvtárból elérhetővé teszi a shopify parancsot:

npm install -g @shopify/cli@latest

A @latest miatt az npm registry aktuális stabil kiadása kerül fel. A telepítés után ellenőrizd a verziót és a parancsok elérhetőségét:

shopify version
shopify help

Ha mindkettő működik, a CLI használatra kész. Az első store-hoz vagy Shopify-fiókhoz kapcsolódó műveletnél a CLI szükség esetén elindítja a hitelesítést. A telepítéshez önmagában nem kell előre bejelentkezned.

Globális npm-telepítésnél lehetőleg kerüld a sudo npm install -g használatát. A jogosultsági hibát jobb a Node.js és az npm globális könyvtárának rendbetételével megoldani. A sudo után könnyen olyan fájlok maradnak a felhasználói környezetedben, amelyeket később csak rendszergazdai jogosultsággal tudsz frissíteni vagy eltávolítani.

Telepítés Yarnnal, pnpm-mel vagy Homebrew-val

Ha már másik támogatott csomagkezelőt használsz, nem kell csak a Shopify CLI miatt npm-re váltanod. A hivatalos telepítőparancsok:

# Yarn 1.x
yarn global add @shopify/cli@latest

# pnpm
pnpm install -g @shopify/cli@latest

macOS-en Homebrew-val is telepítheted:

brew tap shopify/shopify
brew install shopify-cli

Válassz egy telepítési módot, és később ugyanazzal kezeld a CLI-t. Ha npm-mel és Homebrew-val is felteszed, mindkét példány létezhet a gépen. A terminál PATH sorrendje dönti el, melyik indul, ezért könnyen előáll az a helyzet, hogy a frissítés sikeres, a shopify version mégis a régi verziót mutatja.

Telepítés Windows, macOS és Linux alatt

Az npm-es telepítőparancs mindhárom operációs rendszeren ugyanaz:

npm install -g @shopify/cli@latest

A különbség főleg a Node.js telepítésében, a shell környezetében és a PATH hibáinak felderítésében van.

Windows

Windows alatt telepítsd a megfelelő Node.js- és Git-verziót, majd PowerShellből vagy Windows Terminalból futtasd az npm-es telepítést. Utána ugyanott ellenőrizd az eredményt:

node --version
git --version
shopify version

Ha a shopify parancs nem található, a where.exe shopify megmutatja, talál-e a Windows futtatható CLI-példányt, és milyen útvonalon. A terminál újraindítása is szükséges lehet, ha a Node.js telepítője vagy az npm éppen módosította a PATH változót.

macOS

macOS-en az npm mellett a Homebrew is hivatalosan dokumentált telepítési lehetőség. Bármelyiket választod, maradj annál a későbbi frissítéseknél is. Apple Siliconos és Intel-alapú Mac között a csomagkezelő elérési útja eltérhet, ezért egy korábbi gépről átmásolt shell konfiguráció könnyen rossz PATH bejegyzést hagyhat maga után.

Linux

Linuxon az npm-es telepítés a legegyszerűbb általános út. Fejlesztői gépen érdemes felhasználói szinten működő Node version managert használni, így a globális npm-csomagok telepítéséhez sem kell rendszergazdai jogosultság. Ha a shopify nem található, a which -a shopify paranccsal nézd meg az elérhető példányokat.

Windows Subsystem for Linux

A WSL külön Linux-környezetként működik. Ha ott akarod futtatni a Shopify CLI-t, a Node.js-t, a Gitet és a CLI-t is a WSL-en belül telepítsd. A Windowsra telepített Node.js vagy globális npm-csomag nem helyettesíti automatikusan a WSL-es telepítést. A projektet, a csomagkezelőt és a CLI-t érdemes ugyanabban a környezetben tartani, így kevesebb útvonal- és jogosultsági hibába futsz bele.

Globális vagy projektlokális CLI-t használj?

Theme-fejlesztéshez a Shopify globális CLI-telepítést ír elő. Így a shopify theme parancsokat bármelyik theme-mappából elérheted.

Új Shopify app létrehozásakor más a helyzet. A jelenlegi app scaffold a projekt függőségei között is kezeli a szükséges Shopify CLI-csomagokat. Emiatt előfordulhat, hogy a gépeden telepített globális verzió és az adott projekt által használt verzió eltér. Hibakereséskor mindig nézd meg a projekt package.json és lockfile fájlját is, ne csak a globális shopify version kimenetét.

Projektlokális telepítésnek reprodukálhatósági előnye van: a csapat és a CI ugyanahhoz a verzióhoz tud igazodni. Cserébe ezt a példányt nem frissíti automatikusan a globális Shopify CLI. A verzióváltást a projekt függőségeinek frissítésével, majd a lockfile commitolásával kell elvégezned.

Hogyan frissül a Shopify CLI 4.x?

A Shopify CLI 4.0 2026 májusában vezette be az automatikus frissítést és a szemantikus verziózást. Normál globális telepítésnél a CLI azzal a csomagkezelővel frissíti magát, amellyel eredetileg telepítetted.

Az automatikus frissítés három fontos esetben kimarad:

• CI-környezetben;
• projektlokális telepítésnél;
• major verzióváltásnál.

Azonnali kézi frissítéshez futtasd:

shopify upgrade

Az automatikus frissítés állapotát így ellenőrizheted és módosíthatod:

shopify config autoupgrade status
shopify config autoupgrade off
shopify config autoupgrade on

Ha kikapcsolod, a CLI naponta emlékeztet az elérhető új verzióra, de nem telepíti azt. Ezt fejlesztői gépen ritkán érdemes tiltani. Szabályozott vállalati környezetben indokolt lehet, ha minden verzióváltást előbb teszteltek.

A 4.0 óta a Shopify a semantic versioning logikáját használja. A patch kiadások hibajavításokat, a minor kiadások új, visszafelé kompatibilis funkciókat, a major kiadások pedig potenciálisan breaking változásokat jeleznek. Major frissítés előtt olvasd el a Shopify fejlesztői changelogot, különösen akkor, ha automatizált deploy vagy saját shell script épül a CLI parancsaira.

Kézi frissítés a választott csomagkezelővel

Ha a shopify upgrade nem használható, vagy teljesen kontrolláltan szeretnél frissíteni, futtasd újra a telepítést ugyanazzal a csomagkezelővel:

# npm
npm install -g @shopify/cli@latest

# Yarn 1.x
yarn global add @shopify/cli@latest

# pnpm
pnpm install -g @shopify/cli@latest

# Homebrew
brew update
brew upgrade shopify-cli

Utána mindig ellenőrizd az eredményt:

shopify version

CI-ban kerüld a véletlenszerű, minden futásnál változó toolchaint. A Node.js-verziót rögzítsd, a projekt függőségeit lockfile alapján telepítsd, a CLI-verzió frissítését pedig kezeld review-zható változtatásként. Így egy új kiadás nem közvetlenül az éles deploy közben lep meg.

Miért marad régi a verzió frissítés után?

Ha a telepítő sikeresen lefutott, de a shopify version nem változott, általában több CLI-példány van a gépen. macOS-en és Linuxon ezt nézd meg:

which -a shopify

Windowson:

where.exe shopify

A lista megmutatja, mely útvonalakon található futtatható shopify program. Gyakori kombináció a régi RubyGems-telepítés, egy npm-es globális csomag és egy Homebrew-s példány. Az elsőként megtalált útvonal nyer.

Nézd meg azt is, hová telepít globálisan a csomagkezelőd:

npm prefix -g
pnpm bin -g
brew --prefix shopify-cli

Ezután ugyanazzal a csomagkezelővel távolítsd el azt a régi példányt, amellyel telepítetted. Ne törölj találomra bináris fájlokat, mert a csomagkezelő nyilvántartása és a tényleges fájlok könnyen szétcsúsznak.

Gyakori telepítési hibák

A shopify parancs nem található

Ilyenkor a globális bináris könyvtár valószínűleg nincs benne a PATH változóban, vagy a terminált a telepítés óta nem indítottad újra. Először nyiss új terminált, majd ellenőrizd a csomagkezelő globális útvonalát. Ha Node version managert használsz, győződj meg róla, hogy abban a Node-környezetben telepítetted a CLI-t, amelyik jelenleg aktív.

A CLI nem támogatott Node.js-verziót jelez

A Node.js frissítése után ellenőrizd újra a node --version kimenetét ugyanabban a terminálban. Version manager esetén egy másik shell vagy projektkonfiguráció automatikusan visszaválthat régebbi verzióra. A Shopify CLI 2026 júliusában legalább Node.js 22.12-t kér.

Jogosultsági hibát kapsz globális npm-telepítésnél

Ez többnyire az npm globális könyvtárának tulajdonosi vagy jogosultsági problémája. A stabil megoldás egy felhasználói szinten működő Node version manager vagy az npm globális prefixének helyes beállítása. A rendszerszintű telepítés erőltetése később a frissítést is megnehezíti.

Céges proxy mögött nem éri el a Shopify-t

A Shopify CLI 3.78-tól környezeti változóval konfigurálható HTTP- és HTTPS-proxy használatára:

export SHOPIFY_HTTP_PROXY=http://proxy.pelda.hu:8080
export SHOPIFY_HTTPS_PROXY=https://proxy.pelda.hu:8443

Ha hitelesítési adat is kerül a proxy URL-be, ne mentsd repositoryba és ne írd ki CI-logba. Kezeld secretként.

Mit ellenőrizz a telepítés végén?

Egy működő telepítés után ennek a négy parancsnak érdemes hiba nélkül lefutnia:

node --version
git --version
shopify version
shopify help

Utána már a projekt típusa dönti el a következő lépést: shopify app init, shopify theme init vagy shopify hydrogen init. A parancscsoportok szerepét és a deploy közötti különbségeket a Shopify CLI 3.0 áttekintőben találod.

A lényeg egyszerű: válassz egy telepítési módot, tartsd naprakészen a Node.js-t, és mindig ellenőrizd, melyik CLI-példány fut valójában. Ezzel a telepítési és frissítési problémák nagy részét még az első projekt elindítása előtt ki tudod zárni.