Rövid összefoglaló: A Claude Code telepíthető natív telepítőkkel macOS, Windows és Linux rendszereken a hivatalos Claude Code weboldalról. A Windows felhasználóknak először telepíteniük kell a WSL2-t a Claude Code futtatása előtt. Telepítés után hitelesítse magát a Claude fiókjával, amikor a Claude Code megnyit egy böngészőablakot az első indításkor a bejelentkezéshez, hogy elkezdhessen kódolni AI asszisztencia segítségével közvetlenül a terminálból vagy az asztali alkalmazásból.
A Claude Code az Anthropic ügynöki AI fejlesztői eszközei felé irányuló törekvését képviseli. Ez a parancssori asszisztens kódkészleteket olvas, fájlokat szerkeszt, parancsokat futtat és integrálódik a fejlesztői munkafolyamatokkal.
De a telepítése nem mindig egyenes. Különböző platformok eltérő megközelítéseket igényelnek. A Windows extra beállítást igényel. A dokumentáció, bár átfogó, elboraszthatja az újoncokat.
Ez az útmutató áthidalja a bonyolultságot. Lefedi a rendszerkövetelményeket, a platformspecifikus telepítési lépéseket, a hitelesítést és az ellenőrzést – mindent, ami ahhoz szükséges, hogy a Claude Code megfelelően működjön.
Rendszerkövetelmények a telepítés előtt
A hivatalos Claude Code dokumentáció szerint az eszköz támogatja a macOS, a Windows és a Linux rendszereket. Mindegyik platformnak azonban vannak specifikus előfeltételei.
macOS esetén a követelmények minimálisak. A rendszernek macOS 13.0 vagy újabb verzióra van szüksége. Mind az Intel, mind az Apple Silicon chipek jól működnek.
A Windows nagyobb bonyolultságot mutat. Az operációs rendszernek Windows 10 Build 19041 vagy újabb, vagy Windows 11-nek kell lennie. De itt a csavar – a Claude Code nem fut natívan Windows rendszeren.
A Windows Alrendszer Linuxhoz 2 (WSL2) kötelező. Ez egy Linux környezetet hoz létre, ahol a Claude Code ténylegesen működik. WSL2 nélkül a telepítés meghiúsul.
A Linux felhasználóknak 64 bites disztribúcióra van szükségük. A hivatalos dokumentáció megerősíti az Ubuntu, Debian, Fedora és más nagy disztribúciók támogatását. Az Alpine Linux és a musl-alapú rendszerek további konfigurációt igényelnek.
Minden platformnak stabil internetkapcsolattal kell rendelkeznie a telepítés során. A letöltési méretek változóak, de általában 50 MB és 500 MB között mozognak, attól függően, hogy mi van már telepítve.
| Platform | Minimális verzió | Speciális követelmények |
|---|---|---|
| macOS | 13.0 | Nincs |
| Windows | 10 Build 19041 vagy 11 | WSL2 szükséges |
| Linux | 64 bites disztribúció | glibc alapú előnyben |
Claude Code telepítése macOS rendszeren
A macOS telepítési folyamata natív telepítőt használ. Ez a legegyszerűbb út minden platform közül.
Először töltse le a telepítőt a hivatalos Claude Code weboldalról. A letöltési oldal automatikusan felismeri a macOS rendszert, és felajánlja a megfelelő csomagot.
Nyissa meg a letöltött .dmg fájlt. Húzza a Claude Code alkalmazást az Alkalmazások mappába. Szabványos macOS telepítés – semmi rendhagyó itt.
Egyes felhasználók biztonsági felszólítást kapnak az első indításkor. A macOS alapértelmezés szerint blokkolja az ismeretlen fejlesztőktől származó alkalmazásokat. Kattintson jobb gombbal a Claude Code alkalmazásra, és válassza a „Megnyitás” lehetőséget az egyszeri figyelmeztetés megkerüléséhez.
A parancssori eszköz automatikusan települ az asztali alkalmazással. Nyissa meg a Terminált, és írja be a `claude --version` parancsot az ellenőrzéshez. Ha megjelenik a verziószám, a telepítés sikeres volt.
macOS telepítésének ellenőrzése
Futtassa ezeket a parancsokat a működés ellenőrzéséhez:
| claude --version claude --help |
Mindkét parancsnak hiba nélkül kell kimenetet adnia. A `version` parancs megjeleníti a telepített Claude Code verziót. A `help` parancs megjeleníti az elérhető opciókat és parancsokat.
Egy tesztkönyvtár létrehozása segít a teljes funkcionalitás ellenőrzésében. Navigáljon egy projektmappába, és futtassa a `claude` parancsot az interaktív munkamenet elindításához. Az eszköznek inicializálódnia kell, és hitelesítést kell kérnie, ha még nincs bejelentkezve.
Windows telepítése WSL2-vel
A Windows telepítése több lépést igényel. A folyamat tovább tart, mint macOS esetén, de kezelhető marad.
Először a WSL2-t kell telepíteni. Nyissa meg a PowerShellt rendszergazdaként, és futtassa:
| wsl --install |
Ez a parancs alapértelmezés szerint telepíti a WSL2-t és az Ubuntut. A rendszer újraindítást igényel. Újraindítás után az Ubuntu automatikusan elindul a kezdeti beállítások elvégzéséhez.
Hozzon létre egy Unix felhasználónevet és jelszót, amikor a rendszer kéri. Ezek a hitelesítő adatok különállóak a Windows bejelentkezési adataitól.
Miután a WSL2 fut, a Linux telepítési folyamata érvényes. Nyissa meg az Ubuntu terminált (amelyet a WSL2 telepített), és töltse le a Claude Code telepítőt Linuxra.
Claude Code telepítése WSL2-ben
A hivatalos dokumentáció szerint a telepítési parancs letölti és futtatja a natív telepítőt:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Ez a szkript automatikusan kezeli a függőségeket. Telepíti a Node.js-t, ha szükséges, beállítja a Claude Code bináris fájlt, és konfigurálja a PATH változókat.
A telepítés néhány percet vesz igénybe. A progresszív sávok és az állapotüzenetek jelzik, hogy mi történik. Befejezés után zárja be és nyissa meg újra a terminált a környezeti változók frissítéséhez.
A telepítés tesztelése ugyanazt a folyamatot követi, mint macOS esetén. Futtassa a `claude --version` parancsot az ellenőrzéshez.
Linux telepítési folyamat
A Linux felhasználók rendelkeznek a legegyszerűbb telepítési útvonallal. A natív telepítő közvetlenül működik további rétegek, például a WSL2 nélkül.
Töltse le és futtassa a telepítési szkriptet:
| curl -fsSL claude.ai/install.sh | bash |
Ez letölti a Claude Code bináris fájlt, telepíti a függőségeket és konfigurálja a shell környezetet. A szkript felismeri a disztribúciót és ennek megfelelően igazodik.
Az Ubuntu és Debian alapú rendszerekhez a szkript konfigurálja a telepítést. A hivatalos dokumentáció megerősíti az Ubuntu 20.04+, Debian 10+ és más disztribúciók támogatását.
Alpine Linux megfontolások
Az Alpine Linux és a musl alapú disztribúciók extra lépéseket igényelnek. A hivatalos dokumentáció megjegyzi, hogy ezekhez a rendszerekhez manuális konfigurációra van szükség.
A szabványos telepítő meghiúsulhat Alpine rendszeren. Ehelyett töltse le a musl-kompatibilis bináris fájlt közvetlenül a kiadási oldalról. Csomagolja ki egy olyan könyvtárba, amely szerepel a rendszer PATH-jában, általában az `/usr/local/bin` könyvtárba.
Állítsa be az izvrékenyíthető engedélyeket:
| chmod +x /usr/local/bin/claude |
Az Alpine felhasználóknak a folytatás előtt ellenőrizniük kell a kompatibilitást. Egyes funkciók nem működhetnek azonos módon, mint a glibc alapú disztribúciókban.
Hitelesítés és fiókbeállítás
A Claude Code telepítése után futtassa a `claude` parancsot a terminálban. Az első indításkor a Claude Code megnyit egy böngészőablakot a bejelentkezéshez.
Ez megnyitja a Claude hitelesítési oldalt. Jelentkezzen be egy meglévő Claude-fiókkal, vagy hozzon létre újat.
A böngésző megjelenít egy engedélyezési kódot. Másolja át ezt a kódot, és térjen vissza a terminálhoz. Illessze be a kódot, amikor a rendszer kéri.
A sikeres hitelesítés helyileg tárolja a hitelesítő adatokat. A jövőbeli munkamenetek nem igényelnek bejelentkezést, hacsak a hitelesítő adatok le nem járnak, vagy manuálisan nem törlődnek.
Csapat- és vállalati hitelesítés
A hivatalos hitelesítési dokumentáció szerint a Claude for Teams vagy Enterprise használatával rendelkező csapatoknak további lehetőségeik vannak. A szervezetek beállíthatnak egyszeri bejelentkezést (SSO) vagy felhőszolgáltatói hitelesítést.
Az SSO beállítása rendszergazdai konfigurációt igényel. Az egyes fejlesztők ezután a szervezetük identitásszolgáltatóján keresztül hitelesítik magukat, a személyes Claude-fiókjuk helyett.
A felhőszolgáltatói hitelesítés működik AWS, Google Cloud és Azure telepítéseknél. Ez a módszer meglévő felhőhitelesítő adatokat használ, nem pedig különálló Claude-fiókokat.
| Hitelesítési módszer | Használat | Beállítási bonyolultság |
|---|---|---|
| Személyes fiók | Egyéni fejlesztők | Egyszerű |
| Csapat/Vállalati SSO | Szervezetek | Rendszergazdát igényel |
| Felhőszolgáltató | AWS/GCP/Azure felhasználók | Mérsékelt |
Asztali alkalmazás telepítése
A Claude Code parancssori és asztali alkalmazásokat is kínál. Az asztali alkalmazás grafikus felületet biztosít, miközben fenntartja a teljes terminál funkcionalitást.
Töltse le az asztali telepítőt a hivatalos Claude weboldalról. Az oldal kínál macOS, Windows és Windows ARM64 verziókat. Válassza ki a rendszernek megfelelő verziót.
A macOS telepítése ugyanazt a korábban leírt .dmg folyamatot követi. A Windows felhasználók letölthetik az asztali alkalmazást egy grafikus felülethez anélkül, hogy WSL2 beállításra lenne szükségük.
Az asztali alkalmazás tartalmaz integrált terminál hozzáférést. A Claude Code munkameneteket indíthat külső terminálalkalmazásokra való váltás nélkül.
Az asztali alkalmazás egyik előnye a háttérben való elérhetőség. A hivatalos letöltési oldal szerint az alkalmazás „készenlétben marad a háttérben”, és bármilyen alkalmazásból előhívható ablakváltás vagy fókuszvesztés nélkül.
Használja a Get AI Perks-t a Claude Code Stack hitelkártyáinak megtalálásához
A telepítés a legegyszerűbb rész. A valódi költség általában mindent körülvesz: infrastruktúra, támogató eszközök és fizetett szolgáltatások, amelyeket a beállítás és tesztelés során használnak. A Get AI Perks segíthet az induló kreditek és kedvezmények egy helyen történő felsorolásával, valamint útmutatóval azok igényléséhez.
A Get AI Perks segítségével Ön:
- Krediteket találhat felhő- és AI-val kapcsolatos eszközökhöz
- A kedvezmény feltételeit ellenőrizheti igénylés előtt
- Elkerülheti az időpazarlást olyan ajánlatokkal, amelyekre nem jogosult
- Csökkentheti a beállítási költségeket
Látogasson el a Get AI Perks oldalra, hogy megtudja, vajon a rendelkezésre álló ajánlatok megfelelnek-e a Claude Code-dal használni kívánt eszközöknek.
IDE bővítmények és integrációk
Az önálló telepítésen túl a Claude Code integrálódik a népszerű fejlesztői környezetekkel. Léteznek bővítmények a Visual Studio Code és a JetBrains IDE-k számára.
A VS Code bővítmény a piactérről telepíthető. Keressen rá a „Claude Code” kifejezésre a Bővítmények panelen, és kattintson a Telepítés gombra. A bővítményhez először telepíteni kell a parancssori eszközt.
Egyes felhasználók problémákat jelentenek a mellékelt VS Code bővítményfájllal kapcsolatban. Ha az automatikus telepítés „End of central directory record signature not found” hibával meghiúsul, a mellékelt .vsix fájl sérült lehet.
A kerülő megoldás a bővítmény manuális telepítése a VS Code piactérről, a CLI mellékelt verziójától való függés helyett. Ez szétválasztja a két komponenst, és megakadályozza a telepítési ütközéseket.
A JetBrains integráció hasonlóan működik. Telepítse a bővítményt a JetBrains piactérről az IntelliJ IDEA, PyCharm, WebStorm vagy más JetBrains termékeken belül.
A telepítés sikerességének ellenőrzése
A megfelelő ellenőrzés biztosítja, hogy a Claude Code helyesen működjön, mielőtt tényleges fejlesztési feladatokba kezdene.
Az alapvető ellenőrzés a parancsok elérhetőségét vizsgálja:
| claude --help claude --version |
Ezek a parancsok hiba nélkül futnak le. A `help` parancs felsorolja az elérhető opciókat. A `version` parancs megjeleníti a telepített verziót.
A funkcionális teszteléshez munkamenet indítása szükséges. Hozzon létre egy tesztkönyvtárat:
| mkdir test-project cd test-project claude |
Ez inicializál egy interaktív Claude Code munkamenetet. Az eszköznek elemeznie kell a könyvtárat (ebben az esetben üres), és fel kell kínálnia egy promptot.
Próbáljon meg alapvető parancsokat futtatni a munkameneten belül. Írja be a `help` parancsot a rendelkezésre álló műveletek megtekintéséhez. Kérjen egyszerű feladatokat, mint például „ hozz létre egy README fájlt” vagy „magyarázd el, mit tudsz csinálni”.
A sikeres válaszok megfelelő telepítésre utalnak. Hiba esetén azok általában a hitelesítéssel, hálózati kapcsolattal vagy hiányzó függőségekkel kapcsolatosak.
Frissítés és verziókezelés
A Claude Code alapértelmezés szerint automatikusan frissül. A hivatalos dokumentáció magyarázza, hogy az eszköz új verziókat keres, és azokat felhasználói beavatkozás nélkül telepíti.
A frissítési viselkedés konfigurálható a Claude Code beállításain keresztül. A hivatalos dokumentáció lefedi a kiadási csatorna konfigurálását és a manuális frissítési opciókat.
A manuális frissítésekhez újra kell futtatni a telepítési szkriptet. Ugyanaz a parancs, amelyet a kezdeti telepítéshez használtak, lekéri a legújabb verziót:
| curl -fsSL claude.ai/install.sh | bash |
Lehetőség van specifikus verziók telepítésére tesztelési vagy kompatibilitási okokból. A haladó beállítási dokumentáció lefedi a verzió rögzítését és a kiadási csatorna konfigurálását.
A kiadási csatornák közé tartozik a stabil, béta és éjszakai. Stabil a production munkához ajánlott. A béta és éjszakai csatornák korai hozzáférést biztosítanak az új funkciókhoz, de hibákat tartalmazhatnak.
Gyakori telepítési problémák
Számos probléma merül fel gyakran a közösségi megbeszéléseken a Claude Code telepítésével kapcsolatban.
A PATH konfiguráció sok problémát okoz. Ha a `claude` parancs nem található a telepítés után, akkor a bináris könyvtár nincs a rendszer PATH-jában.
macOS és Linux rendszereken a könyvtár PATH-hoz való hozzáadása általában a `~/.bashrc`, `~/.zshrc` vagy hasonló shell konfigurációs fájlok szerkesztését foglalja magában. A telepítési szkript ezt általában automatikusan elvégzi, de a manuális ellenőrzés segít a hibaelhárításban.
A Windows felhasználóknak WSL2 esetén bezárniuk és újra megnyitniuk kell a terminált a telepítés után. A környezeti változók nem frissülnek a meglévő munkamenetekben.
Hálózati korlátozások blokkolnak néhány telepítést. Vállalati tűzfalak vagy proxy szerverek megakadályozhatják a telepítő letöltését vagy a hitelesítési szerverekhez való csatlakozást.
A proxy konfiguráció környezeti változókat igényel:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Engedélyhibák merülnek fel, amikor védett könyvtárakba telepít. A telepítőnek írási hozzáférésre van szüksége a `/usr/local/bin` vagy hasonló helyekre. A `sudo`-val történő futtatás ezt megoldja, de kerülni kell, hacsak nem szükséges.
Gyakran ismételt kérdések
A Claude Code internetkapcsolat nélkül is futtatható?
Nem. A Claude Code működéséhez internetkapcsolat szükséges. Az eszköz a kódokat és lekérdezéseket az Anthropic szervereire küldi feldolgozás céljából. A helyi gyorsítótárazás lehetővé teheti, hogy néhány művelet ideiglenesen offline módban működjön, de a teljes funkcionalitás aktív kapcsolatot igényel.
A Claude Code együttműködik a meglévő AI kódoló eszközökkel?
Igen. A Claude Code futtatható a GitHub Copilot, a Cursor vagy más AI fejlesztői eszközök mellett. Függetlenül működnek és nem ütköznek. Azonban több AI asszisztens egyidejű használata zavart kelthet abban, hogy melyik eszköz felelős melyik feladatért.
Szükséges a WSL2 minden Windows funkcióhoz?
A parancssori eszközhöz WSL2 szükséges Windows rendszeren. Az asztali alkalmazás azonban natívan fut Windows rendszeren WSL2 nélkül. Az asztali alkalmazás hasonló funkcionalitást kínál grafikus felületen keresztül, nem pedig tiszta parancssori interakcióval.
Mennyibe kerül a Claude Code használata?
Az árak a használattól és az előfizetési szinttől függően változnak. Ellenőrizze a hivatalos Claude weboldalon a jelenlegi árakat, mivel a költségek és a csomagok szerkezete idővel változik. Néhány funkció Claude Pro vagy Enterprise előfizetést igényel.
A Claude Code szerkeszthet fájlokat a projektkönyvtáron kívül?
Alapértelmezés szerint a Claude Code biztonsági okokból korlátozza a fájlelérést a jelenlegi projektkönyvtárra. A konfigurációs beállítások kibővíthetik az engedélyeket, de ennek megtételéhez explicit engedély szükséges. A homokozás dokumentációja részletesen ismerteti az engedélykezelést.
Mi a különbség a Claude Code és a Claude API között?
A Claude Code egy fejlesztői eszköz interaktív kódolási asszisztenciához. A Claude API programozási hozzáférést biztosít olyan alkalmazások létrehozásához, amelyek a Claude AI képességeit használják. Különböző célokat szolgálnak – az egyik a kódot író fejlesztőknek, a másik az AI funkciókat integráló alkalmazásoknak.
A Claude Code eltávolítása eltávolítja az összes adatát?
Az eltávolítás eltávolítja az alkalmazás bináris fájlját, de meghagyhatja a konfigurációs fájlokat és a gyorsítótárazott adatokat. A teljes eltávolításhoz manuálisan kell törölni a `~/.claude` könyvtárat macOS és Linux rendszeren, vagy a megfelelő AppData helyet Windows rendszeren.
Elkezdés a telepítés után
Miután a Claude Code telepítve és ellenőrizve van, a következő lépés annak megértése, hogyan lehet hatékonyan használni.
A gyorsindítási dokumentáció egyszerű feladatokkal javasolja a kezdést. Navigáljon egy meglévő projekthez, és futtassa a `claude` parancsot az interaktív munkamenet elindításához.
Kérje meg a Claude-ot, hogy magyarázza el a projekt struktúráját. Kérjen összefoglalót arról, hogy mit csinál a kódkészlet. Ezek a feltáró lekérdezések segítenek megérteni, hogyan értelmezi az eszköz a kódot.
Próbáljon meg kisebb változtatásokat végrehajtani. Kérje meg a Claude-ot, hogy adjon megjegyzéseket a funkciókhoz, hozzon létre egyszerű tesztfájlokat, vagy refaktoráljon alapvető kódrészleteket. Ezek a feladatok kockázat nélkül demonstrálják a szerkesztési képességeket.
A Git integráció automatikusan működik, ha a projekt verziókezelést használ. A Claude Code létrehozhat commitokat, magyarázhat diff-eket, és javaslatokat tehet fejlesztésekre a változások alapján.
A hivatalos dokumentáció tartalmaz munkafolyamat példákat gyakori fejlesztési feladatokhoz. Ezek lefedik a hibajavítást, a funkciók implementálását, a kódellenőrzést és az automatizált tesztelést.
A Claude Code egy fejlődő eszköz. A telepítés csak az alap. Képességeinek, korlátainak és legjobb gyakorlatainak megértése kísérletezést és gyakorlást igényel.
Készen áll a Claude Code telepítésére? Töltse le a megfelelő telepítőt a platformjához a hivatalos weboldalról, és kövesse a jelen útmutatóban leírt lépéseket. Hitelesítse magát a Claude-fiókjával, ellenőrizze, hogy a telepítés helyesen működik-e, és kezdje el az AI-asszisztált fejlesztés felfedezését.
