Claude Code Beállítás: Teljes 2026 Útmutató

Rövid összefoglaló: A Claude Code egy terminál alapú AI kódolási asszisztens, amely natívan fut macOS és Linux rendszereken, vagy Windows alatt WSL2 segítségével. A beállításához létre kell hozni egy Anthropic API kulcsot, futtatni kell egy platformspecifikus telepítőt, hitelesíteni kell a kulccsal, és teszt paranccsal kell ellenőrizni a telepítést. 

A Claude Code az Anthropic hivatalos, terminál alapú kódolási asszisztense. Közvetlenül a parancssorban él, és természetes nyelvű parancsokkal kezeli a kódgenerálástól a hibajavításokig mindent.

A beállítási folyamat azonban nem mindig egyértelmű. A Windows felhasználóknak WSL2-re van szükségük. Az API hitelesítés megakaszthatja az újoncokat. Előfordulnak verziókonfliktusok.

Ez az útmutató végigvezet a teljes beállítási folyamaton minden platformon, a rendszerkövetelményektől az első kódolási munkamenetig.

Mi is pontosan a Claude Code?

A Claude Code egy ügynökszerű terminálalkalmazás, amely integrálódik a fejlesztői környezetekkel. Megérti a kódokat, rutin feladatokat hajt végre, és konverziós parancsokkal kezeli a git munkafolyamatokat.

A böngésző alapú eszközökkel ellentétben a Claude Code helyileg, a terminálban fut. Közvetlenül hozzáfér a projektfájlokhoz, fenntartja a kontextust a munkamenetek között, és integrálódik a meglévő fejlesztői munkafolyamatokkal. A hivatalos Claude Code dokumentáció szerint az eszköz csatlakozik az Anthropic API-hoz, és támogatja az integrációt az Amazon Bedrock, a Google Cloud Vertex AI és az Azure AI rendszerekkel.

Az eszköz másképp működik, mint a hagyományos kódolási asszisztensek. Valójában olyan, mintha egy páros programozó ülne a terminálodban, nem pedig egy kódkiegészítő eszköz.

Rendszerkövetelmények a Claude Code-hoz

Telepítés előtt a rendszereknek meg kell felelniük bizonyos követelményeknek. Íme, mit igényel minden platform:

Minden platformnak stabil internetkapcsolatra van szüksége az API hívásokhoz. A Claude Code letöltések általában körülbelül 50 MB-ot igényelnek, a Windows alatti WSL2 pedig további kb. 500 MB-ot ad hozzá a Linux alrendszerhez.

Tárhely szempontjából legalább 4 GB szabad helyre számíts. Maga az alkalmazás kicsi, de a függőségek és a projektfájlok számára is hely kell.

Windows-specifikus követelmények

A Claude Code futtatható Windows alatt PowerShell-en vagy Parancssoron keresztül, ha a Node.js telepítve van. Az eszköz Windows Subsystem for Linux 2-t igényel egy Linux környezet létrehozásához.

A claude.ai telepítési útmutatói szerint a Windows 10 rendszereknek a 1903-as vagy újabb verzióra van szükségük, 19041-es vagy magasabb buildszámmal. A Windows 11 felhasználóknál beépített a WSL2 támogatás. Rendszergazdai jogosultságok szükségesek az első WSL2 beállításához.

A folyamat magában foglalja a virtualizáció engedélyezését a BIOS-ban, a Windows funkcióinak aktiválását és egy Linux disztribúció telepítését. Az Ubuntu 22.04 LTS az ajánlott disztribúció a kompatibilitás érdekében.

Claude Code telepítése: Lépésről lépésre

A telepítési folyamat platformonként eltérő. Íme, hogyan futtathatod a Claude Code-ot minden operációs rendszeren.

Telepítés macOS és Linux rendszereken

A macOS és Linux telepítések ugyanazt a mintát követik. Mindkét platform támogatja a natív telepítést további beállítások nélkül.

A folyamat a telepítő letöltésével kezdődik. Nyiss egy terminált és futtasd a következőt:

curl -fsSL claude.ai/install.sh | sh

A szkript felismeri az operációs rendszert, letölti a megfelelő binárist, és telepíti a Claude Code-ot a helyi bin könyvtárba. A telepítés általában két percen belül befejeződik stabil kapcsolattal.

A curl nélküli rendszereken a wget alternatívaként használható. A telepítő automatikusan hozzáadja a Claude Code-ot a rendszer PATH-hoz.

Telepítés Windows alatt WSL2-n keresztül

A Windows telepítéshez először be kell állítani a WSL2-t. Íme a teljes folyamat:

Nyiss egy PowerShell ablakot Rendszergazdaként, és engedélyezd a WSL-t:

wsl –install

Ez a parancs engedélyezi a szükséges Windows funkciókat, letölti a WSL2 kernelt, és alapértelmezés szerint telepíti az Ubuntut. A rendszer újraindítást kér. Újraindítás után az Ubuntu automatikusan elindul a felhasználói beállítások befejezéséhez.

Hozz létre egy felhasználónevet és jelszót, amikor a rendszer kéri. Ezek a hitelesítő adatok a Linux környezetre vonatkoznak, elkülönülve a Windows bejelentkezési adataitól.

Miután a WSL2 fut, a Linux telepítési folyamat érvényes. Az Ubuntu terminálban futtasd a curl parancsot a macOS/Linux részben leírtak szerint.

A telepítő elvégzi a többit. A Claude Code a WSL2 környezeten belül települ, és az Ubuntu terminálon keresztül fut.

Anthropic API kulcs beszerzése

A Claude Code hitelesítéshez Anthropic API kulcsot igényel. A kulcs összeköti a helyi telepítést az Anthropic szervereivel.

Látogass el az Anthropic Konzolra a console.anthropic.com címen. Hozz létre egy fiókot, vagy jelentkezz be meglévő hitelesítő adatokkal. Lépj az API kulcsokhoz a fiókbeállításokban.

Kattints az "Kulcs létrehozása" gombra egy új API kulcs generálásához. A kulcs egyszer jelenik meg – azonnal másold ki. Az Anthropic nem jeleníti meg újra a teljes kulcsot az oldal elhagyása után.

Tárold biztonságosan a kulcsot. Teljes hozzáférést biztosít az Anthropic API-hoz és az esetleges kapcsolódó számlázáshoz.

API költségek megértése

A Claude Code fizetős modell alapján működik az Anthropic API-n keresztül. A claude.ai telepítési útmutatók adataiból kiindulva a költségek modellenként eltérőek:

A számlázás aktiválásához minimális vásárlás 5 USD, bár a közösségi megbeszélések szerint a 20-30 USD jobb mozgásteret biztosít a teszteléshez. Alternatív előfizetési lehetőségek közé tartozik a Claude Pro havi 20 dollárért vagy a Claude Max havi 100 dollárért nagy felhasználás esetén.

Az alapértelmezett viselkedés az Opus használata, amíg el nem éri a használati korlátok 50%-át, majd átvált a Sonnet-re a költséghatékonyság érdekében.

Hitelesítés és első indítás

A telepítés után a Claude Code első használat előtt hitelesítést igényel. Indítsd el a Claude Code-ot a következő parancs futtatásával:

claude

Az első indítás kéri az API kulcsot. Illeszd be a kulcsot az Anthropic Konzolról, és nyomj Enter-t. A Claude Code érvényesíti a kulcsot, és biztonságosan tárolja a helyi konfigurációs fájlokban.

A hitelesítés megmarad a munkamenetek között. Az API kulcsot nem kell újra megadni, kivéve, ha kifejezetten eltávolítod, vagy amikor fiókot váltasz.

A hitelesítés sikerességének ellenőrzéséhez a Claude Code üdvözlő üzenetet és parancssort jelenít meg. Az interfész megjeleníti az elérhető parancsokat, és megerősíti a kapcsolatot az Anthropic API-jával.

Modellpreferenciák konfigurálása

A Claude Code alapértelmezés szerint automatikus modellválasztást végez, de manuális konfiguráció is lehetséges. A hivatalos dokumentáció szerint a felhasználók a modellválasztást a `/model` paranccsal vagy a `CLAUDE_CODE_EFFORT_LEVEL` környezeti változó beállításával módosíthatják.

Az erőfeszítési szint az Opus 4.6 és a Sonnet 4.6 modellek gondolkodási mélységét szabályozza: alacsony, közepes vagy magas. A magasabb erőfeszítési szintek növelik az érvelés mélységét, de a költségeket és a válaszidőt is.

Mély elemzést igénylő projektek esetén az "ultrathink" parancs megadása az adott körre ideiglenesen magasra állítja az erőfeszítési szintet.

A telepítés sikerességének ellenőrzése

Hitelesítés után ellenőrizd, hogy a Claude Code megfelelően működik-e. Futtasd ezeket az alapvető teszteket:

claude –help
claude –version

A `help` parancs megjeleníti az elérhető opciókat és parancsokat. A `version` kimenet megerősíti, hogy melyik verzió van telepítve. Mindkét parancsnak hibák nélkül kell végrehajtódnia.

Ezután teszteld a Claude Code-ot egy projekt könyvtárban. Hozz létre egy teszt mappát:

mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude

A Claude Code munkameneten belül próbálj meg alapvető interakciókat:

• Írd be, hogy "help" az elérhető parancsok megtekintéséhez
• Kérdezd meg: "explain what you can do" (magyarázd el, mit tudsz csinálni)
• Kérd: "summarize this project" (foglald össze ezt a projektet)
• Teszteld a /help parancsot

Ezek az interakciók megerősítik, hogy a Claude Code képes elolvasni a projektfájlokat és válaszolni a kérésekre. Sikeres válaszok esetén a telepítés működőképes.

A Claude Code konfigurálása projektekhez

A Claude Code projekt-specifikus beállításokat tárol konfigurációs fájlokban. Ezek a fájlok testreszabják a viselkedést, meghatározzák a memóriát, és beállítják a munkafolyamatokat.

A fő konfigurációs fájl a CLAUDE.md a projekt gyökerében. Ez a fájl tartalmazza az utasításokat, a kontextust és a projekt-specifikus irányelveket, amelyekre a Claude Code a munkamenetek során hivatkozik.

Hozzon létre egy alapvető CLAUDE.md fájlt:

# Project Context

Ez egy [projekttípus], építve [technológiák]-val.

## Fő irányelvek
– [Fontos szabály 1]
– [Fontos szabály 2]

## Projektstruktúra
[Rövid magyarázat a mappa elrendezéséről]

A fájl elfogadja a Markdown formázást. A Claude Code a munkamenet kezdetén elolvassa ezt a kontextust, és fenntartja azt a beszélgetés során.

Haladó konfigurációs lehetőségek

Az alapvető kontextuson túl a Claude Code támogatja a fejlett konfigurációt a `.claude` könyvtáron keresztül. Ez a könyvtár tartalmazhat:

• Képességek: Szakosodott képességek, amelyek a `.claude/skills/SKILL.md` fájlban vannak definiálva
• Parancsok: Egyéni slash parancsok a `.claude/commands/*.md` fájlokban
• Horgok: Automatizált munkafolyamatok, amelyeket események indítanak el
• Bővítmények: Kiterjesztett funkcionalitás programozott integráción keresztül

A hivatalos Agent SDK dokumentáció szerint ezek a funkciók kifinomult testreszabást tesznek lehetővé. A képességek újrafelhasználható funkciókat definiálnak. A parancsok parancsikonokat hoznak létre a gyakori feladatokhoz. A horgok automatizálják a válaszokat a fájlok módosítására vagy eszközök használatára.

A Claude Code használata: Alapvető munkafolyamatok

A telepítés befejezése után a Claude Code természetes nyelv segítségével kezeli a gyakori fejlesztői feladatokat.

Indíts el egy munkamenetet a projekt könyvtárba navigálva és futtasd a következőt:

claude

A prompt elfogadja a sima nyelvű kéréseket. Néhány gyakori munkafolyamat:

• Kódgenerálás: "Hozzon létre egy Python függvényt, amely validálja az e-mail címeket megfelelő hibakezeléssel."
• Hibajavítás: "Ez a függvény null pointer kivételt dob. Tudja azonosítani és javítani a problémát?"
• Refaktorálás: "Refaktorálja ezt a komponenst, hogy függőséginjekciót használjon a közvetlen példányosítás helyett."
• Git műveletek: "Hozzon létre egy új ágat, commit-elje ezeket a módosításokat egy leíró üzenettel, és push-olja az origin-re."

A Claude Code fenntartja a kontextust a munkamenet során. Emlékszik a korábbi interakciókra, nyomon követi a fájlok módosításait, és megérti a tágabb projektstruktúrát.

Terv mód megértése

Komplex módosítások esetén a Claude Code Terv módot kínál. Ez a mód részletes végrehajtási tervet hoz létre a módosítások elvégzése előtt.

A Terv mód aktiválásához helyezze a kéréseket "plan:" előtaggal, vagy használja a /plan parancsot. A Claude Code ezután felvázolja a javasolt módosításokat, elmagyarázza az okokat, és jóváhagyásra vár a végrehajtás előtt.

A Terv mód különösen hasznos refaktoráláshoz, építészeti változtatásokhoz, vagy több fájlt érintő módosításokhoz. Látványos áttekintést nyújt arról, hogy mit tervez a Claude Code, mielőtt elköteleződne a módosítások mellett.

Integráció VS Code-dal és IDE-kkel

Bár a Claude Code a terminálban fut, a kód szerkesztőkkel való integráció javítja a munkafolyamatot. A hivatalos VS Code bővítmény közvetlenül a szerkesztőbe hozza a Claude Code képességeit.

Telepítse a bővítményt a VS Code piacteréről. Keressen rá a "Claude Code" kifejezésre, és kattintson a Telepítés gombra. A bővítmény hozzáad egy Claude Code panelt az oldalsávhoz.

A hivatalos VS Code dokumentáció szerint a bővítmény támogatja:

A bővítmény megőrzi a terminál verzióval azonos funkciókat, miközben olyan IDE-specifikus kényelmi funkciókat is hozzáad, mint az inline diff-ek és az @-megemlített fájlreferenciák.

A Claude Code frissítése és kezelése

A Claude Code alapértelmezés szerint automatikusan frissül. Az alkalmazás rendszeresen ellenőrzi az új verziókat, és a háttérben telepíti a frissítéseket.

Manuális frissítéshez futtasd a következőt:

claude –update

Ez azonnali ellenőrzést és a legújabb verzió telepítését kényszeríti. A frissítési folyamat megőrzi a konfigurációs fájlokat és a hitelesítési adatokat.

Az automatikus frissítéseket a verziókövetést igénylő szervezetek letilthatják. Állítsa a `CLAUDE_CODE_AUTO_UPDATE` környezeti változót hamisra, vagy konfigurálja szerver által felügyelt beállításokon keresztül.

Egy adott verzió telepítéséhez használja a következőt:

curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z

Helyettesítse az X.Y.Z értéket a cél verziószámra.

Gyakori telepítési problémák és megoldások

Számos probléma merülhet fel általában a telepítés során. Íme, hogyan oldhatod meg őket:

• API kulcs elutasítása: Ha a Claude Code elutasítja az API kulcsot, ellenőrizze, hogy nincsenek-e extra szóközök vagy karakterek. Másolja ki újra a kulcsot az Anthropic Konzolról. Ellenőrizze, hogy aktiválva van-e a számlázás – a kulcsok nem működnek fizetési mód nélkül.
• WSL2 telepítési hibák: A Windows rendszerek néha a virtualizációs beállítások miatt hibáznak a WSL2 telepítésénél. Lépjen be a BIOS-ba, és engedélyezze a virtualizációt (Intel VT-x vagy AMD-V). Győződjön meg róla, hogy a Windows verzió megfelel a minimum követelményeknek.
• Ismeretlen parancs: Ha a terminál nem ismeri fel a `claude` parancsot, a PATH nem frissült megfelelően. Zárja be és nyissa meg újra a terminált. Tartós problémák esetén manuálisan adja hozzá a telepítési könyvtárat a PATH-hoz.
• Kapcsolati időtúllépések: Hálózati korlátozások vagy tűzfalak blokkolhatják az API hívásokat. A Claude Code HTTPS hozzáférést igényel az api.anthropic.com címhez. A vállalati hálózatoknak proxy konfigurációra lehet szükségük.
• Engedélyhibák: A Linux és macOS telepítéseknél néha engedélyhibák merülnek fel. Futtassa a telepítőt megfelelő jogosultságokkal, vagy telepítse felhasználói könyvtárba a rendszer-szintű helyek helyett.

Ellenőrizze az elérhető AI krediteket a Claude Code beállítása előtt

A Claude Code beállítása általában kísérletezést jelent – promptok futtatását, integrációk tesztelését és kis prototípusok építését, mielőtt bármi is élesbe kerülne. Ez a korai szakasz gyakran nagy API használattal jár. Ahelyett, hogy azonnal minden kérésért fizetne, sok fejlesztő először az elérhető krediteket vagy induló programokat keresi, amelyek segítenek csökkenteni ezeket a kezdeti költségeket.

A Get AI Perks ezeket a lehetőségeket egy helyen gyűjti össze. Az oldal felsorolja az AI krediteket, kedvezményeket és partnerprogramokat az AI szolgáltatók, felhő platformok és fejlesztői eszközök között, lépésről lépésre útmutatókkal magyarázva, hogyan lehet igényelni őket. Összesen az adatbázis több mint 200 eszközből származó kedvezményeket és több millió dollár értékű elérhető krediteket tartalmaz, amelyekre az induló vállalkozások és az építők pályázhatnak.

Mielőtt befejeznéd a Claude Code beállítását, ellenőrizd a Get AI Perks oldalt, és igényelj olyan AI krediteket, amelyek fedezhetik a kezdeti kísérleteidet.

Gyakran ismételt kérdések

Továbblépés a Claude Code-dal

A Claude Code átalakítja a terminál alapú fejlesztést azáltal, hogy az AI asszisztenciát közvetlenül a parancssorba integrálja. A beállítás platformspecifikus telepítést, API hitelesítést és alapvető konfigurációt igényel, de a folyamat egyértelmű, ha követi a megfelelő lépéseket.

Az eszköz kiválóan alkalmas rutinszerű fejlesztői feladatokra, kódgenerálásra és git munkafolyamatok kezelésére. A Terv mód biztonságot nyújt komplex műveletekhez. Az IDE integráció kiterjeszti a képességeket a terminálon túl.

Kezdje egyszerű feladatokkal, hogy megértse, hogyan értelmezi a Claude Code a kéréseket. Építsen ki komplexebb munkafolyamatokat, ahogy növekszik az ismerősége. Használja a `/clear` parancsot a különálló feladatok között a tiszta kontextus fenntartásához. Konfigurálja a CLAUDE.md fájlokat projekt-specifikus útmutatásért.

A csapatok felfedezhetik a szerver által felügyelt beállításokat és a bővítmény piactereket. Az egyéni fejlesztők profitálhatnak a gyakori mintákhoz igazított képességekből és egyéni parancsokból.

Az anthropics/claude-code GitHub tárhely további példákat, közösségi bővítményeket és hibaelhárítási forrásokat tartalmaz. A docs.anthropic.com címen található hivatalos dokumentáció átfogó technikai referenciákat nyújt.

Most itt az ideje elkezdeni a kódolást. Navigáljon egy projekthez, indítsa el a Claude Code-ot, és nézze meg, hogyan változtatja meg a munkafolyamatát az AI-vezérelt fejlesztés.