Claude Code sorozat 5. rész: Hogyan telepítsük a Claude Code-ot?

Hogyan telepítsük a Claude Code-ot

A Claude Code telepítése nem rendelkezik grafikus felülettel, teljes egészében a parancssorban történik. Ha már használtál npm-et, az egész folyamat nem tart tovább két percnél.

Előfeltételek

Mielőtt elkezdened, győződj meg arról, hogy a következők rendelkezésre állnak:

Node.js 18 vagy újabb verzió
Ellenőrzés: terminálban futtasd a node -v parancsot. Ha a verzió 18 alatti, frissítsd nvm, fnm segítségével, vagy töltsd le a nodejs.org oldalról.
Egy Anthropic fiók
Regisztráció a https://console.anthropic.com címen. A fiók API-kulcsot biztosít, amelyre a telepítés után szükség lesz. A regisztráció ingyenes, a tényleges költségek a használat alapján kerülnek felszámításra.
Hálózati hozzáférés az Anthropic API végpontjához
Az alapértelmezett domain: api.anthropic.com. Ha a környezet proxy használatát igényli, állítsd be a HTTP_PROXY vagy HTTPS_PROXY környezeti változókat a terminálban.

Telepítési mód 1: npm globális telepítés

Ez a leggyakoribb módszer, egyszeri telepítés után bárhol használható.

npm install -g @anthropic-ai/claude-code

A telepítés után futtasd a claude --version parancsot. Ha megjelenik egy verziószám, a telepítés sikeres. Globális telepítés esetén a claude parancs bármely könyvtárból közvetlenül hívható.

Ha jogosultsági hibát tapasztalsz (ez gyakori macOS-en a /usr/local/lib könyvtár esetében), két megoldás van:

Használd a sudo-t a telepítéshez (egyszerű, de biztonsági aggályokat vethet fel).
Állítsd be az npm-et, hogy a felhasználói könyvtárat használja a sudo elkerülése érdekében:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Ezután add hozzá a ~/.npm-global/bin mappát a PATH-hoz, majd indítsd újra a terminált.

Telepítési mód 2: npx – egyszeri használatra

Ha nem szeretnél globálisan telepíteni semmit, vagy csak kipróbálnád ideiglenesen, az npx használata egyszerűbb.

npx @anthropic-ai/claude-code

Az npx ideiglenesen letölti a legfrissebb csomagot, futtatja, majd nem hagy globális parancsot. Minden használatkor ellenőrzi a frissítéseket, így mindig a legújabb verziót kapod. Hátránya, hogy lassabb (minden alkalommal le kell tölteni), és nem alkalmas gyakori automatikus parancsfájlokba írásra.

Hasznos: első tapasztalatszerzéshez, más gépén történő ideiglenes használathoz, vagy ritka alkalmakkor.

Ellenőrzés, hogy a program elindul-e

A telepítés után ne rohanj a hitelesítéssel. Futtass egy egyszerű parancsot, hogy lásd, az eszköz elindul-e:

claude --help

Ha megjelenik a súgó, a bináris fájl rendben van. A következő lépés a fiók összekapcsolása, amiről később lesz szó.

A két telepítési mód ugyanazt a programot adja, a hitelesítés és a használat teljesen azonos. Válaszd azt, amelyik kényelmesebb számodra.

Gyakori problémák

Túl alacsony Node verzió
18 alatt közvetlen hibaüzenet jelenik meg, nem csak figyelmeztetés. A Node frissítése a legegyszerűbb megoldás.
Hálózati időtúllépés
Akár az npm csomag letöltése, akár az API csatlakozása során proxy vagy tűzfal okozhatja a problémát. Először ellenőrizd a curl https://api.anthropic.com kapcsolatot, mielőtt továbblépnél.
Natív cmd használata Windows alatt
Bár elméletileg működik, javasolt a Git Bash, WSL2 vagy Windows Terminal használata a furcsa útvonal-átalakítási problémák elkerülése érdekében.