A Claude Code telepítése a hivatalos webhelyről

Mi az a Claude Code, és miért a terminálban fut?#

A terminál szinte mindenkit megijeszt, aki szoftverfejlesztési háttér nélkül kezd vibe codinggal foglalkozni. Olyannak tűnik, mint egy fekete ablak a hackerekről szóló filmekből, de valójában csak egy sor, ahová parancsokat ír be. A Claude Code-nak éppen azért van szüksége rá, hogy megnyithassa és módosíthassa a fájljait, valamint önállóan ellenőrzéseket futtathasson, miközben Ön szavakkal leírja a feladatot.

Az Anthropic így írja le a terméket.

A különbség az ismerős csevegéshez képest egyszerű. A böngészőben kézzel másolgatja a kódot az ablak és a szerkesztő között. A Claude Code belép a projektmappába, elolvassa a szükséges fájlokat, elvégzi a módosítást, majd megmutatja, min változtatott. Továbbra is Ön dönt és hagyja jóvá a módosításokat; a mechanikus munkát az eszköz végzi el Ön helyett.

Ha egyáltalán nem szeretne terminált használni, az Anthropic asztali alkalmazást is kínál hagyományos ablakkal, valamint webes verziót a claude.ai/code címen, amely közvetlenül a böngészőben fut. A legerősebb és legrugalmasabb lehetőség azonban a terminálos verzió, amelyről ez az egész cikk szól.

Hol található a Claude Code hivatalos webhelye, és mit kell letölteni?#

A kezdők elsőként gyakran azt nem tudják, hol található a Claude Code hivatalos webhelye, és mire kell kattintani a letöltéshez. Íme az Anthropic összes hivatalos címe táblázatban, hogy ne kelljen találgatnia.

Nem úgy tölt le telepítőt a webhelyről, mint egy hagyományos program esetében, ami ellentétes az emberek elvárásaival. Egy terminálparanccsal telepíti, amely aztán letölti a rendszerének megfelelő verziót. Ez a cikk tartalmazza a pontos parancsokat Macre, Windowsra és Linuxra.

Gyakori buktató a név: sokan elírják, például clode code, clade code, слод код vagy clode design formában. A termék neve Claude Code, au betűkkel. Tartsa ezt észben, amikor a hivatalos webhelyet keresi: a hasonló írásmódú domainek máshoz tartoznak.

Érdemes a pontos npm-csomagnevet is ismerni. A hivatalos csomag neve @anthropic-ai/claude-code, az @anthropic-ai/ előtaggal. Maga az Anthropic birtokolja a rövid, előtag nélküli claude-code nevet – ez a hivatalos hivatkozása ugyanarra a csomagra. Az egyszerű szabály: a közzétevőnek Anthropicnak kell lennie, a telepítéshez használt névnek pedig tartalmaznia kell az előtagot.

Mire van szükség a telepítéshez: számítógépes követelmények#

A Claude Code követelményei szerények: a nehéz munkát az Anthropic szerverei végzik; a számítógépe csak kéréseket küld és válaszokat fogad.

Külön megjegyzés a Node.js-ről, mivel ezzel kapcsolatban terjed a legtöbb tévhit. A natív telepítő – amelyet maga az Anthropic ajánl – egyáltalán nem igényel Node.js-t: egyetlen önálló fájlként települ. Node.js-re csak akkor van szükség, ha npm-en keresztül telepíti a Claude Code-ot, és ilyenkor a 22-es vagy újabb verzió kell. A régebbi cikkekben az szerepel, hogy „Node 18 vagy újabb” – ez már elavult; a 22+-t vegye alapul.

A fő verzió használatához terminálra van szükség. Ha nem szeretne terminált használni, telepítse az asztali alkalmazást a hagyományos ablakával, vagy használja a webes verziót a claude.ai/code címen. A terminálos verzió funkciók tekintetében továbbra is erősebb, ezért a cikk hátralévő része annak telepítését mutatja be.

A Claude Code telepítése olyan, mintha egy szerszámot venne a kezébe. Önmagában azonban gyakran hallucinál: elfelejti a projektjét, kitalál dolgokat, és egy feladat közepén elveszíti a fonalat. Három dolog kombinációjától válik megbízhatóvá: egy AI-klón, egy Second Brain és a kontextusmérnökség. Ez a három pillér akadályozza meg, hogy az AI hallucináljon.

Hogyan telepítheti a Claude Code-ot macOS-re?#

Nyissa meg a Terminált (minden Macen megtalálható: nyomja meg a Cmd+Space billentyűkombinációt a Spotlight megnyitásához, majd írja be, hogy „Terminál”), és illessze be ezt az egy sort:

curl -fsSL https://claude.ai/install.sh | bash

A parancs letölti a telepítőt az Anthropic hivatalos címéről, és telepíti a Claude Code-ot. Node.js nem kell hozzá. A natív módszer a frissítések miatt is kényelmes.

Ha már használja a Homebrew-t, van egy másik lehetőség is:

brew install --cask claude-code

A különbség a frissítések kezelésében van: a natív telepítő magát frissíti, a Homebrew viszont nem – manuálisan kell frissítenie a brew upgrade claude-code paranccsal. Maga a program ugyanaz, ezért válassza azt a módszert, amelyet megszokott. Ha bizonytalan, használja az elsőt.

Hogyan telepítheti a Claude Code-ot Windowsra?#

Először állapítsa meg, hol van. A Windowsnak két shellje van, és mindegyikhez saját parancs tartozik. Nyisson meg egy ablakot, és nézze meg a prompt elejét: a PS C:\> PowerShellt jelent, míg a PS nélküli C:\> a Parancssort (CMD).

PowerShellhez (legegyszerűbben úgy nyithatja meg, hogy jobb gombbal kattint a Start gombra, és kiválasztja a „Terminál” lehetőséget):

irm https://claude.ai/install.ps1 | iex

Parancssorhoz (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Van egy harmadik lehetőség is: a beépített WinGet csomagkezelő használata:

winget install Anthropic.ClaudeCode

Ha már van működő WSL-környezete (Linux a Windowson belül), telepítse a Claude Code-ot közvetlenül a WSL-be, ugyanazzal a paranccsal, mint Linuxon. A WSL-ben van egy külön, Node-dal kapcsolatos sajátosság; erről a gyakori hibákról szóló részben lesz szó.

Hogyan telepítheti a Claude Code-ot Linuxra?#

A legnépszerűbb disztribúciókhoz ugyanaz az önálló telepítő az alapmódszer:

curl -fsSL https://claude.ai/install.sh | bash

Node.js nem szükséges; a program egyetlen fájlként érkezik, és ezután automatikusan frissül.

Ha kizárólag a rendszer csomagkezelőjén keresztül szokott programokat telepíteni, hozzáadhatja az Anthropic hivatalos tárházait: apt a Debianhoz és az Ubuntuhoz, dnf a Fedorához és az RHEL-hez, apk pedig az Alpine-hoz. Kulccsal vannak aláírva, és stable, illetve latest csatornát kínálnak. Kezdőknek ez túlzás, ezért a részleteket a források részben található dokumentációra hagyom, és alapértelmezés szerint a fenti parancsot ajánlom.

Olcsó szervereken előfordulhat egy probléma. Ha nagyon kevés szabad memória van a gépen, a telepítés a Killed szóval (137-es kóddal) leállhat – a rendszer azért állította le a folyamatot, mert elfogyott a memória. A megoldás egy swapfájl hozzáadása: a Claude Code telepítéséhez körülbelül 512 MB szabad memória szükséges.

Hogyan indíthatja el először a Claude Code-ot?#

Az első indítás néhány percet vesz igénybe. Így zajlik a folyamat.

1. Lépjen a projektmappába

   A terminálban a cd path-to-project paranccsal lépjen a használni kívánt mappába, majd írja be, hogy claude.

2. Jelentkezzen be a fiókjába

   Megnyílik a böngésző a bejelentkezési ablakkal. Ha nem nyílik meg automatikusan, nyomja meg a c billentyűt a hivatkozás másolásához, majd illessze be kézzel a böngészőbe. Ha a böngésző kódot jelenít meg (ez WSL-ben és távoli szervereken fordulhat elő), illessze vissza ezt a kódot a terminálba.

3. Várja meg a megerősítést

   Bejelentkezés után a terminál a Login successful üzenetet jeleníti meg, és az Enter megnyomását kéri.

4. Tegye fel az első kérdését

   Kérdezzen valami egyszerűt a projektről, például: „mit csinál ez a projekt?” A Claude beolvassa a fájlokat, és válaszol.

5. Hagyja jóvá az első módosítást

   Amikor megkéri, hogy változtasson meg valamit, a Claude megmutatja a javasolt módosításokat, és megerősítést kér. A hozzáférési módokat a Shift+Tab billentyűkombinációval válthatja.

Érdemes rögtön megtanulni néhány alapvető parancsot a munkameneten belül: a /help felsorolja a parancsokat, a /clear törli a beszélgetés előzményeit, a /exit pedig kilép (a Ctrl+D kétszeri megnyomása ugyanezt teszi). Ha beírja, hogy /help, a Claude ezeket magától is megmutatja.

Bejelentkezés előfizetéssel vagy API-kulccsal: melyiket válassza?#

Ez az első kérdés, amely bejelentkezéskor felmerül.

Kétféleképpen jelentkezhet be, és a fizetés módjában különböznek.

Előfizetéssel való bejelentkezéshez egyszerűen használja a Claude.ai-fiókját. API-kulccsal való bejelentkezéshez szerezzen kulcsot a Claude Console-ból (platform.claude.com); használat közben a díjak az előre feltöltött egyenlegéből vonódnak le. Állítsa be a kulcsot az ANTHROPIC_API_KEY környezeti változóban, és a Claude Code nem nyitja meg minden alkalommal a böngészőt.

A munkameneten belül a /login paranccsal fiókot válthat, a /logout paranccsal pedig kijelentkezhet.

A Claude Code azonban fizetős hozzáférés nélkül nem indul el. Ha még nincs fiókja, előbb tájékozódjon arról, melyik e-mail-címet használja a regisztrációhoz: később nem módosíthatja.

Hogyan ellenőrizheti, hogy minden megfelelően települt?#

Három parancsot érdemes már az elején megismerni.

Az első a verziót ellenőrzi:

claude --version

A működő telepítés X.Y.Z (Claude Code) formátumú számot jelenít meg. A pontos számjegyek verziónként változnak; az a fontos, hogy a parancs egyáltalán verziószámot adjon vissza. A „command not found” válasz más problémát jelez – erről a következő részben lesz szó.

A második a diagnosztika, ha valami félresikerül.

A harmadik a munkameneten belüli /status: megmutatja, hogyan jelentkezett be, melyik e-mail-cím vagy szervezet kapcsolódik a fiókjához, és lejárt-e a hozzáférése. A claude update pedig azonnal telepíti a legújabb frissítést, nem kell megvárnia a háttérben történő frissítést.

Miért nem található a claude parancs a telepítés után?#

Ez a kezdők leggyakoribb panasza, és ijesztőbbnek hangzik, mint amilyen valójában. A terminál nem keresi a parancsokat az egész számítógépen; csak a PATH-ban szereplő mappákat ellenőrzi. A Claude Code a ~/.local/bin/claude helyre települ (Macen és Linuxon), illetve a %USERPROFILE%\\.local\\bin\\claude.exe helyre (Windowson). Ha ez a mappa nincs benne a PATH-ban, a terminál egyszerűen nem látja a programot.

Macen és Linuxon adja hozzá a mappát a listához. Nyissa meg a shell beállítófájlját (~/.zshrc Zsh esetén, ~/.bashrc Bash esetén), és írja a következő sort a fájl végére:

export PATH="$HOME/.local/bin:$PATH"

Ezután zárja be, majd nyissa meg újra a terminált (vagy futtassa a source ~/.zshrc parancsot). Ezután a claude parancs már megtalálható lesz.

Gyakori telepítési és első indítási hibák#

Vegyük sorra ezeket; mindegyik az Anthropic hivatalos hibaelhárítási útmutatóján alapul.

1. Régi Node npm-en keresztüli telepítésnél. Az @anthropic-ai/claude-code csomaghoz Node.js 22-es vagy újabb verzió kell. Windowson az npm azért hiúsulhat meg, mert az üzenet szerint a szkriptek le vannak tiltva – a PowerShell házirendje blokkolja a futtatásukat. WSL-ben gyakori hiba az exec: node: not found: a WSL a Windows Node-ot használja a Linux Node helyett. Ha gondot okoz az npm, váltson a natív telepítőre; ahhoz nem kell Node.
2. Nem a shellhez való telepítő. Az 'irm' is not recognized azt jelenti, hogy PowerShell-parancsot illesztett be a Parancssorba. A The token '&&' is not a valid statement separator azt jelenti, hogy fordítva történt: CMD-parancsot futtatott a PowerShellben. Az A parameter cannot be found that matches parameter name 'fsSL' azt jelenti, hogy a Mac/Linux parancsot futtatta PowerShellben. Ellenőrizze a prompt elejét: a PS C:\ a PowerShell, a C:\ pedig a CMD.
3. Egy régi API-kulcs felülbírálja az előfizetést. Ha az előfizetése aktív, de egy régi kulcs még be van állítva a környezetben, ezt fogja látni: API Error: 400 ... This organization has been disabled. A kulcs elsőbbséget élvez az előfizetéses bejelentkezéssel szemben. Távolítsa el az unset ANTHROPIC_API_KEY paranccsal (PowerShellben használja a Remove-Item Env:ANTHROPIC_API_KEY parancsot), ellenőrizze a ~/.zshrc és ~/.bashrc fájlt, majd írja be, hogy /status.
4. Kevés memória egy gyenge szerveren. A telepítés a Killed szóval és a 137-es kóddal leáll – ez azt jelenti, hogy nincs elegendő RAM. Körülbelül 512 MB szabad memóriára van szükség; a swap hozzáadása megoldja a problémát.
5. A telepítő valami mást adott vissza. A syntax error near unexpected token '<' hiba, illetve a <!DOCTYPE html> hivatkozás azt jelenti, hogy a telepítési URL szkript helyett egy weboldalt adott vissza – ennek oka rendszerint az Ön régiója, egy vállalati tűzfal vagy átmeneti üzemzavar. Próbáljon ki egy másik módszert (Homebrew, WinGet), vagy próbálkozzon újra néhány perc múlva.

Bármelyik hiba esetén ugyanaz az első lépés: futtassa a claude doctor parancsot. Megmutatja, mi romlott el, és javaslatot ad, hol keresse a problémát.

Van egy diagnosztikai sajátosság: telepítés közben a magában álló 403-as hiba vállalati tűzfalból vagy proxyszerverből is eredhet. Ha tehát irodai hálózaton van, először ellenőrizze, nem blokkolja-e a hozzáférést.

Mit tegyen a telepítés után: első lépések#

A telepítés csak a kezdet. Az érdemi munka ezután indul, és az első probléma, amellyel az emberek találkoznak, a memória. A nyelvi modell nem emlékszik Önre a beszélgetések között: egy új csevegésben csak azt tudja, amit a kontextusába helyezett.

A telepítés utáni első valódi lépés tehát egy CLAUDE.md fájl létrehozása a projekt gyökérmappájában. Ez egy szövegfájl, amely a projekt szabályait és kontextusát tartalmazza, és amelyet a Claude Code minden indításkor beolvas. Egyszer írja le, mivel foglalkozik, hogyan épül fel a projekt, és mi fontos – így nem kell ezt minden beszélgetésben megismételnie.

Egy külön útmutatóban mutatom be, hogyan állíthatja össze ezt a fájlt, és hogyan szabhatja testre a Claude-ot: a Claude testreszabása. Összeállítottam továbbá a vibe coding eszközeinek általános térképét 2026-ra.

Milyen más kérdéseket szoktak feltenni?#

A teljes vibe coding keretrendszer: AI-klón + Second Brain + kontextusmérnökség.