Rövid összefoglaló: A Claude Code CLI egyetlen paranccsal telepíthető, amely automatikusan letölti és konfigurálja az eszközt. macOS és Linux rendszereken használja az Anthropic hivatalos dokumentációjában található shell szkriptet, míg a Windows felhasználók PowerShell vagy WSL parancsokat futtathatnak. A telepítés után hitelesítse API-kulcsával, hogy elkezdhesse használni a Claude AI kódolási asszisztensét a terminálban.
A Claude Code egy ügynök alapú kódolási eszköz, amely a terminálban él, és megérti a teljes kódbázisát. A hivatalos Claude Code dokumentáció szerint képes fájlokat olvasni, parancsokat végrehajtani, kódot szerkeszteni és természetes nyelvi beszélgetéseken keresztül integrálódni fejlesztői eszközökkel.
De az elinduláshoz megfelelő telepítés szükséges. Itt mindent megtudhat, ami a Claude Code CLI telepítéséhez és helyes konfigurálásához szükséges.
Rendszerkövetelmények a telepítés előtt
Mielőtt telepítené a Claude Code-ot, győződjön meg arról, hogy a rendszer megfelel az alapvető követelményeknek. A hivatalos Speciális telepítési dokumentáció szerint távolítsa el ezt a mondatot teljesen.
Ellenőrizze a Node.js telepítését egy terminál megnyitásával és a következő futtatásával:
| node –version |
Ha a Node.js nincs telepítve, vagy a verzió 18 alatt van, töltse le a hivatalos Node.js webhelyről. A Hosszú távú támogatási (LTS) verzió tökéletesen működik a Claude Code-hoz.
A Node.js-en túl a rendszernek alapvető követelményekre van szüksége: macOS 13.0 vagy újabb Mac felhasználók számára, Windows 10 vagy újabb Windows rendszerek számára, és a legtöbb modern Linux disztribúció probléma nélkül működik. Egy Claude-fiók az Anthropic-tól szintén szükséges a telepítés utáni hitelesítéshez.
A Claude Code telepítése macOS és Linux rendszerekre
A macOS és Linux rendszerek telepítési folyamata egyetlen shell paranccsal történik, amely mindent automatikusan kezel. Ez a módszer a hivatalos Claude Code quickstart útmutatóban van dokumentálva.
Nyissa meg a Terminált és futtassa a telepítési szkriptet:
| curl -fsSL claude.ai/install.sh | bash |
A szkript letölti a Claude Code binárist, elhelyezi a megfelelő könyvtárban, és automatikusan konfigurálja a PATH-ot. A teljes folyamat általában egy perc alatt befejeződik.
A macOS felhasználók számára, akik a Homebrew-t részesítik előnyben, létezik egy alternatív telepítési módszer, bár ez nincs hivatalosan dokumentálva az elsődleges forrásokban. A curl módszer a hivatalos dokumentáció szerint továbbra is az ajánlott megközelítés.
A telepítés ellenőrzése
A telepítés befejezése után ellenőrizze, hogy a Claude Code elérhető-e:
| claude –version |
Ez a parancs meg kell jelenítse a telepített verziószámot. Ha hibaüzenet jelenik meg, miszerint "command not found", akkor a PATH konfigurációt módosítani kell.
A hivatalos hibaelhárítási dokumentáció szerint a PATH problémák a leggyakoribb telepítési problémák. A javítás magában foglalja a Claude telepítési könyvtárának hozzáadását a shell konfigurációs fájljához.
A Claude Code telepítése macOS és Linux rendszerekre
A macOS és Linux rendszerek telepítési folyamata az npm-től (Node Package Manager) függ. A hivatalos dokumentáció szerint a Node.js 18+-nak telepítve kell lennie a rendszerén, mielőtt folytatná. Ellentétben a hagyományos CLI eszközökkel, amelyek shell szkripteket használnak, a Claude Code globálisan telepíthető a terminálon keresztül, hogy minden függőség helyesen legyen kezelve.
Nyissa meg a Terminált és futtassa a következő parancsot a csomag telepítéséhez:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Megjegyzés: A CLAUDE_CODE_RELEASE_ALPHA=1 környezeti változót jelenleg a nyilvános béta/alfa fázisban kell használni az eszköz előnézeti státuszának elismerésére.
Ez a parancs letölti a csomagot a hivatalos npm registry-ből, és a claude futtatható fájlt a rendszer globális bináris könyvtárához csatolja. Bár egyes felhasználók megpróbálhatnak Homebrew képleteket keresni, az npm módszer az egyetlen hivatalosan támogatott és dokumentált telepítési út.
A telepítés ellenőrzése
A telepítés befejezése után ellenőrizze, hogy a CLI megfelelően van-e hozzárendelve a környezetéhez a következő futtatásával:
| claude –version |
Ez a parancs meg kell jelenítse az aktuális verziószámot (pl. 0.2.9). Ha "command not found" hibával találkozik, ez általában azt jelenti, hogy a globális npm könyvtár nincs benne a rendszer PATH-jában.
A hivatalos hibaelhárítási dokumentáció szerint ezt úgy javíthatja, hogy azonosítja az npm előtagját az npm config get prefix paranccsal, és gondoskodik arról, hogy a kapott /bin mappa hozzáadásra kerüljön a .zshrc vagy .bashrc fájljához.
A Claude Code telepítése Windows rendszerekre
A Windows telepítés két fő módszert kínál: natív PowerShell telepítést vagy a Windows Alrendszer Linuxhoz (WSL) való használatát. A hivatalos dokumentáció a legtöbb felhasználó számára a PowerShell-t ajánlja.
PowerShell telepítési módszer
Nyissa meg a PowerShell-t Rendszergazdaként (kattintson jobb gombbal a Start menüre, és válassza a "Windows PowerShell (Rendszergazda)" lehetőséget). Futtassa ezt a parancsot:
| irm claude.ai/install.ps1 | iex |
A PowerShell szkript automatikusan elvégzi a letöltést, telepítést és a PATH konfigurációt. Befejezés után zárja be és nyissa meg újra a PowerShell-t a PATH frissítések érvényesüléséhez.
WSL telepítési módszer
A WSL-t már használó fejlesztők a Linux módszerrel telepíthetik a Claude Code-ot. Nyissa meg a WSL terminált, és futtassa ugyanazt a curl parancsot, mint Linuxon:
| curl -fsSL claude.ai/install.sh | bash |
A WSL megközelítés megegyezik a natív Linux telepítésekkel. Előny: A WSL egy Unix-szerűbb környezetet biztosít, amely megfelel a production szerverek konfigurációinak.
A hivatalos hibaelhárítási dokumentáció szerint a WSL felhasználók alkalmanként hálózati kapcsolati problémákkal szembesülnek. Ha a telepítés akadozik, ellenőrizze, hogy a WSL hozzáfér-e külső hálózatokhoz, és hogy a tűzfal szabályok nem blokkolják-e a forgalmat.
Claude és AI Eszköz Kreditkeresés Egy Helyen
A Claude Code CLI telepítése egy lépés. Az AI eszközök hosszú távú kifizetése egy másik. A Get AI Perks startup krediteket és szoftver kedvezményeket gyűjt az AI és a cloud eszközökhöz egy helyen. Ez hozzáférést biztosít az alapítóknak 200+ ajánlathoz, beleértve az Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom és mások ajánlatait. A platform megjeleníti az ajánlatok feltételeit és útmutatókat az ajánlatok igényléséhez.
Claude vagy Anthropic krediteket keresel?
Nézze meg a Get AI Perks-t, hogy:
- AI eszköz krediteket és kedvezményeket találjon egy helyen
- ellenőrizze az ajánlatok feltételeit az igénylés előtt
- hozzáférjen az útmutatókhoz a startup ajánlatok igényléséhez
👉 Látogasson el a Get AI Perks webhelyére, hogy megtekintse a rendelkezésre álló Claude, Anthropic és más AI szoftver ajánlatokat.
Hitelesítés és Kezdeti Konfiguráció
A telepítés után a Claude Code hitelesítést igényel, mielőtt működne. Az eszköz API kulcsokat használ az Anthropic-tól a hozzáférés ellenőrzéséhez.
Indítsa el a hitelesítési folyamatot a következő futtatásával:
| claude |
Amikor ez a parancs fut először, a Claude Code hitelesítést kér. A hivatalos quickstart útmutató szerint ez megnyit egy böngészőablakot az Anthropic fiókba való bejelentkezéshez.
A böngészőn keresztüli bejelentkezés után a CLI automatikusan megkapja a hitelesítési tokent. Ez a token lokálisan tárolódik, és az ülések között megmarad, így ismételt hitelesítésre nincs szükség.
Projekt szintű beállítások konfigurálása
A Claude Code több szinten támogatja a konfigurációt a hivatalos beállítások dokumentációja szerint. A leggyakoribb konfigurációs szintek a következők:
| Hatókör | Hely | Felhasználási eset |
|---|---|---|
| Felhasználó | ~/.claude/ directory | Személyes preferenciák minden projekten átívelően |
| Projekt | .claude/ a repositoryban | Megosztott csapatkonfiguráció |
| Helyi | .claude/settings.local.json | Gép-specifikus felülbírálások |
Az első beállításhoz a felhasználói szintű konfiguráció elegendő. A projekt szintű beállítások fontossá válnak, amikor olyan csapatokkal dolgozik, amelyek megosztják a kódolási szabványokat.
Az első Claude Code munkamenet indítása
A telepítés és a hitelesítés befejezése után indítsa el a Claude Code-ot a parancs argumentumok nélküli futtatásával:
| claude |
Ez elindítja az interaktív módot, ahol a Claude természetes nyelvi kérésekre válaszol. A hivatalos dokumentáció az interaktív módot írja le az elsődleges módnak a Claude Code használatára fejlesztési feladatokhoz.
Próbáljon ki egy egyszerű teszt parancsot:
| Show me the structure of this project |
A Claude Code elemzi az aktuális könyvtárat és áttekintést ad a kódbázis struktúrájáról. Ez bizonyítja, hogy a telepítés helyesen működik, és a Claude hozzáfér a fájlok olvasásához.
Fontos parancsok a napi használathoz
Az interaktív módon túl a Claude Code több parancssablonnal is rendelkezik, amelyek a CLI referenciájában vannak dokumentálva:
| Parancsminta | Cél | Példa |
|---|---|---|
| claude | Interaktív munkamenet indítása | claude |
| claude “task” | Egyszeri feladat végrehajtása | claude “fix the linting errors” |
| claude -p “query” | Gyors lekérdezés munkamenet nélkül | claude -p “what does this function do” |
Az egyszeri feladat minta különösen hasznos CI/CD pipeline-okhoz és automatizálási szkriptekhez, ahol az interaktív munkamenet nem megfelelő.
Gyakori Telepítési Hibaelhárítás
Még automatizált telepítési szkriptek esetén is előfordulnak problémák. A hivatalos hibaelhárítási dokumentáció a leggyakoribb problémákat tárgyalja.
Parancs nem található hibák
Ha a terminál "command not found: claude" üzenetet jelenít meg a telepítés után, akkor a PATH konfiguráció nem fejeződött be helyesen. macOS és Linux rendszereken manuálisan adja hozzá a Claude bináris helyét a shell konfigurációs fájljához.
Bash felhasználók számára szerkessze a ~/.bashrc vagy ~/.bash_profile fájlt, és adja hozzá:
| export PATH=”$HOME/.local/bin:$PATH” |
Zsh felhasználók (alapértelmezett a modern macOS-en) esetén szerkessze a ~/.zshrc fájlt ugyanazzal a sorral. Mentés után töltse be újra a konfigurációt a source ~/.zshrc paranccsal, vagy nyisson meg egy új terminál ablakot.
Hálózati és tűzfal problémák
A vállalati hálózatok és a restriktív tűzfalak néha blokkolják a telepítési szkriptet. A hibaelhárítási dokumentáció szerint, ha a telepítés akadozik, vagy HTML-t ad vissza a végrehajtás helyett, akkor előfordulhat, hogy az Anthropic szervereihez való hálózati hozzáférés blokkolva van.
A kerülő megoldás a telepítési szkript külön letöltését igényli:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Ez a megközelítés nagyobb láthatóságot biztosít abban, hogy mi romlik el, ha a letöltés vagy a végrehajtás során hibák fordulnak elő.
WSL-specifikus problémák
A WSL-t futtató Windows felhasználók néha kapcsolati problémákkal szembesülnek a Linux alrendszer és a Windows között. A hivatalos dokumentáció megemlíti, hogy a tűzfal szabályokat módosítani kell a WSL forgalom engedélyezéséhez.
Ha a Claude Code sikeresen települ, de nem tudja elérni az Anthropic szervereit a hitelesítéshez, ellenőrizze, hogy a Windows tűzfal engedélyezi-e a WSL hálózati hozzáférést. A hibaelhárítási útmutató specifikus PowerShell parancsokat tartalmaz a tűzfal szabályok konfigurálásához.
A Claude Code frissítése
A Claude Code rendszeres frissítéseket kap új funkciókkal és fejlesztésekkel. A hivatalos dokumentáció szerint a frissítéseket ugyanazzal a paranccsal kell telepíteni, mint az első telepítést.
Futtassa újra a telepítési szkriptet:
| curl -fsSL code.anthropic.com/install.sh | sh |
A szkript észleli a meglévő telepítést, és frissíti a legújabb verzióra. A frissítési folyamat során nem vesznek el konfigurációk vagy hitelesítések.
Ellenőrizze az aktuális verziót a frissítés előtt és után:
| claude –version |
A hivatalos Claude Code dokumentációban található változási napló felsorolja az összes változást a verziók között, ami segít meghatározni, hogy egy frissítés-e bevezet-e olyan funkciókat, amelyek relevánsak bizonyos munkafolyamatokhoz.
Következő Lépések a Telepítés Után
A Claude Code telepítésével és működésével a fejlettebb funkciók feltárása is lehetővé válik. A hivatalos dokumentáció számos olyan területet ír le, amelyeket érdemes megvizsgálni:
- Képességek és testreszabás: A hivatalos képességek dokumentációja szerint a Claude Code támogatja a Markdown fájlokban definiált egyéni képességeket a .claude/skills/ könyvtárban. Ezek a képességek kiterjesztik a Claude képességeit projekt-specifikus parancsokkal és munkafolyamatokkal.
- Modell Kontext Protokoll (MCP): Az MCP integráció lehetővé teszi a Claude Code számára, hogy külső eszközökhöz és szolgáltatásokhoz csatlakozzon. Ez Claude-ot egy központtá alakítja, amely hozzáférhet adatbázisokhoz, API-khoz és más fejlesztési erőforrásokhoz.
- Csapatmunka: A .claude/ könyvtárban található projekt szintű konfigurációs fájlok verzióvezérlésre tehetők, így a Claude Code beállításai megoszthatók az egész fejlesztőcsapaton.
- A hivatalos dokumentáció részletes útmutatókat tartalmaz minden ilyen területhez, amelyek az itt tárgyalt alaptelepítésre épülnek.
Gyakran Ismételt Kérdések
Szükségem van fizetős Claude előfizetésre a Claude Code CLI használatához?
A Claude Code-hoz szükség van egy Claude fiókra az Anthropic-tól, de a szükséges előfizetés szintje a használattól függ. A hivatalos dokumentáció szerint a hitelesítés szükséges, de az árak részleteit az Anthropic hivatalos webhelyén kell ellenőrizni, mivel a tervek idővel változnak.
Telepíthetem a Claude Code-ot rendszergazdai jogosultságok nélkül?
macOS és Linux rendszereken a Claude Code alapértelmezés szerint a felhasználó home könyvtárába települ, és nem igényel rendszergazdai hozzáférést. A Windows felhasználóknak rendszergazdai jogosultságokra lehet szükségük a PowerShell telepítési módszerhez, bár a WSL telepítésekhez nincs szükség rendszergazdai hozzáférésre.
Működik a Claude Code offline?
Nem. A Claude Code egy AI-alapú eszköz, amely kommunikál az Anthropic szervereivel a kérések feldolgozásához. A hivatalos dokumentáció szerint aktív internetkapcsolatra van szükség ahhoz, hogy a Claude elemezni tudja a kódot és válaszokat generáljon.
Hogyan távolíthatom el a Claude Code-ot?
A hivatalos Speciális telepítési dokumentáció magyarázza, hogy az eltávolítás magában foglalja a bináris és konfigurációs fájlok törlését. macOS és Linux rendszereken törölje a ~/.claude könyvtárat, és távolítsa el a PATH módosítást a shell konfigurációs fájlokból. Windows felhasználók töröljék a telepítési könyvtárat és töröljék a PATH környezeti változót.
A Claude Code hozzáférhet az egész fájlrendszeremhez?
Alapértelmezés szerint a Claude Code az aktuális munkakönyvtárban és annak alkönyvtáraiban működik. A hivatalos engedélyezési dokumentáció szerint a hozzáférés tovább korlátozható a sandbox beállítások használatával a konfigurációs fájlokban. Claude mindig megerősítést kér, mielőtt potenciálisan destruktív műveleteket hajtana végre.
Mi a különbség a Claude Code CLI és a Claude Desktop között?
A Claude Code CLI a terminálban fut, és a fejlesztési munkafolyamatokra összpontosít, közvetlen fájlrendszer-hozzáféréssel és parancs végrehajtással. A Claude Desktop egy önálló alkalmazás grafikus felülettel. Mindkét eszköz különböző felhasználási eseteket szolgál ki, a CLI pedig azoknak a fejlesztőknek van optimalizálva, akik a terminál alapú munkafolyamatokat részesítik előnyben.
Milyen gyakran frissítsem a Claude Code-ot?
A frissítéseket bármikor kényelmesen telepítheti. A hivatalos változási napló új funkciókat és hibajavításokat dokumentál. Csapatok számára a frissítések koordinálása biztosítja, hogy mindenki kompatibilis verziókat használjon, bár a Claude Code visszafelé kompatibilis a konfigurációs fájlokkal a verziók között.
Következtetés
A Claude Code CLI telepítése operációs rendszertől függetlenül csak néhány percet vesz igénybe. Az automatizált telepítési szkriptek kézi beavatkozás nélkül kezelik a konfigurációt, a PATH beállítást és a bináris fájlok elhelyezését.
A telepítés és a hitelesítés után a Claude Code egy hatékony AI kódolási asszisztenssé válik, amely bármilyen terminálról elérhető. A természetes nyelvi parancsok lehetővé teszik a fejlesztők számára, hogy kódot írjanak, hibákat javítsanak és feladatokat automatizáljanak anélkül, hogy elhagynák a parancssort.
Készen állsz az AI-alapú fejlesztés élményére? Futtassa a telepítési parancsot a platformjához, és indítsa el első Claude Code munkamenetét még ma. A code.claude.com címen található hivatalos dokumentáció átfogó útmutatókat nyújt a fejlettebb funkciókhoz az alapvető beállítások befejezése után.
