Rövid összefoglaló: A Claude Code telepítése Windows rendszeren WSL2 (Windows Alrendszer Linuxhoz) beállítását, az Ubuntu telepítését és egy egyszerű telepítési szkript futtatását igényli. A folyamat lehetővé teszi a Windows felhasználók számára, hogy elérjék az Anthropic AI kódolási asszisztensét a termináljukon keresztül. Elérhetők natív Windows bináris fájlok is, azonban a WSL2 továbbra is a legjobb gyakorlat a Windows telepítéséhez.
A Claude Code egy AI-alapú kódolási asszisztens, amely közvetlenül a terminálban működik, segítve a fejlesztőket funkciók létrehozásában, hibák javításában és fejlesztési feladatok automatizálásában. De van egy bökkenő a Windows felhasználók számára.
A Claude Code natív Windows végrehajtható fájlként érhető el, és telepíthető npm vagy közvetlen bináris letöltés útján, WSL2 nélkül. Azonban megköveteli a Windows Alrendszer Linuxhoz (WSL2) használatát, és a hivatalos telepítési módszer továbbra is a WSL2-re támaszkodik.
Íme, hogyan működtethető Windows 11 vagy Windows 10 rendszeren.
Rendszerkövetelmények
A telepítés megkezdése előtt győződjön meg arról, hogy a Windows gépe megfelel ezeknek a követelményeknek:
- Windows 10 1809+ vagy Windows Server 2019+
- Windows 11 (bármilyen verzió)
- Legalább 4 GB szabad RAM memória
- Rendszergazdai jogosultságok a rendszeren
- Internetkapcsolat a WSL2 és az Ubuntu letöltéséhez
A telepítés lemezterületet igényel a WSL2, az Ubuntu és a Claude Code számára.
1. lépés: A Windows Alrendszer Linuxhoz engedélyezése
A WSL2 közvetlenül Windowson belül biztosít egy Linux környezetet. Ez az alap, amely lehetővé teszi a Claude Code működését.
Nyissa meg a PowerShellt rendszergazdaként. Kattintson a jobb egérgombbal a Start gombra, és válassza a "Windows PowerShell (Rendszergazda)" vagy a "Terminál (Rendszergazda)" lehetőséget Windows 11 rendszeren.
Futtassa ezt a parancsot:
wsl –install
Ez a parancs engedélyezi a szükséges Windows funkciókat, és telepíti az Ubuntut alapértelmezett Linux disztribúcióként. A rendszer valószínűleg újraindítást fog kérni.
Újraindítás után a WSL2 automatikusan befejezi a beállítást. Az Ubuntu elindul, és felhasználónevet és jelszót kér. Ezek a hitelesítő adatok csak a Linux környezetre vonatkoznak – nem kell megegyezniük a Windows hitelesítő adatokkal.
2. lépés: A WSL2 telepítésének ellenőrzése
Miután a rendszer újraindult, és az Ubuntu befejezte az első beállítását, ellenőrizze, hogy a WSL2 megfelelően fut-e.
Nyissa meg az Ubuntu terminált (keressen rá az "Ubuntu" kifejezésre a Start menüben), és futtassa:
wsl –version
Ez megjeleníti a WSL verzióinformációit. Keresse meg a "WSL version: 2.x.x" sort a kimenetben.
Ha a parancs WSL1-et mutat, frissítsen WSL2-re a következő paranccsal:
wsl –set-default-version 2
3. lépés: A Claude Code telepítése
Most pedig maga a Claude Code telepítése. A hivatalos dokumentáció egy soros telepítési szkriptet kínál.
Az Ubuntu terminálban futtassa:
curl -fsSL claude.ai/install.sh | bash
A szkript letölti a Claude Code bináris fájlját, beállítja a szükséges engedélyeket, és hozzáadja a rendszer PATH-jához. A telepítés időtartama az internet sebességétől és a rendszer specifikációitól függ.
A hivatalos Claude Code dokumentáció szerint az installer automatikusan felismeri a rendszer architektúráját, és letölti a megfelelő bináris verziót.
Gyakori telepítési problémák
Néhány Windows felhasználó arról számol be, hogy telepítés után "command not found: claude" üzenetet lát. Ez általában azért történik, mert a PATH változó nem frissült.
Zárja be és nyissa újra az Ubuntu terminált, majd próbálkozzon újra. Ha a probléma továbbra is fennáll, ez a PATH konfiguráció segíthet nem hivatalos megoldásként:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
4. lépés: A Claude Code hitelesítése
A Claude Code használat előtt hitelesítést igényel egy Anthropic fiókkal.
Futtassa ezt a parancsot:
claude
A terminál megjelenít egy URL-t, és hitelesítést kér. A folyamat kissé eltér az egyéni felhasználók és a csapatfiókok esetében:
| Fióktípus | Hitelesítési módszer | Mi szükséges |
|---|---|---|
| Egyéni | Személyes API kulcs | Anthropic fiók API hozzáféréssel |
| Csapat/Szervezet | Szervezeti token | Adminisztrátor által biztosított hitelesítési token |
Nyissa meg a megadott URL-t egy böngészőben, jelentkezzen be az Anthropic fiókjába, és engedélyezze a Claude Code-ot. A terminál megerősíti a sikeres hitelesítést.
Munka Windows projektekkel WSL2 alatt
Itt válik bonyolultabbá a helyzet. A Windows fájlrendszerei és a WSL2 fájlrendszerei különállóak.
A Windows fájlok WSL2 alatt a /mnt/c/ (C: meghajtó esetén), /mnt/d/ (D: meghajtó esetén) és így tovább címen érhetők el. De ennek teljesítményköltsége van. Közösségi megbeszélések utalnak teljesítménybeli különbségekre a Windows-ra csatlakoztatott és a natív WSL2 könyvtárak között.
A legjobb teljesítmény érdekében másolja át a projektfájlokat a WSL2 home könyvtárába:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
A kompromisszum? Az IDE integráció bonyolultabbá válik. A Visual Studio Code ezt jól kezeli a Remote-WSL kiegészítőjével, de más IDE-k esetében ez nehézségekbe ütközhet.
A telepítés tesztelése
Ellenőrizze, hogy a Claude Code megfelelően működik-e egy egyszerű teszttel.
Navigáljon egy projektkönyvtárba (vagy hozzon létre egy tesztmappát):
mkdir ~/claude-test
cd ~/claude-test
claude “create a simple hello world Python script”
A Claude Code-nak válaszolnia kell, létrehoznia a fájlt, és megjelenítenie a kódot. Ez megerősíti, hogy a telepítés sikeres volt.
Ne fizessen túl sokat, igényelje először a rendelkezésre álló AI krediteket
A Claude Code telepítése Windows rendszeren általában gyors. A valódi költség később jelenik meg, amikor a fejlesztők elkezdenek tesztelni promptokat, futtatni szkripteket és integrálni a modellt az alkalmazásokba. Ez a kísérletezési fázis sok API hívást generálhat, és sok csapat csak akkor döbben rá a költségekre, miután elkezdték az építést.
Mielőtt pénzt költene a használatra, érdemes ellenőrizni, hogy jogosult-e AI kreditekre vagy partnerprogramokra. A Get AI Perks ezeket a lehetőségeket egy helyen gyűjti össze, felsorolva az AI-szolgáltatóktól, felhőplatformoktól és fejlesztői eszközöktől származó krediteket és kedvezményeket, valamint egyszerű utasításokat arról, hogyan lehet ezeket igényelni.
Mielőtt futtatná az első Claude Code projektjét, tekintse meg a Get AI Perks oldalt, és igényelje az AI krediteket, amelyek fedezhetik a fejlesztési költségeket.
Gyakran Ismételt Kérdések
Futhat-e a Claude Code natívan Windowson WSL2 nélkül?
Igen, de a WSL2 továbbra is a legjobb telepítési módszer Windowsra.
Működik-e a Claude Code a Windows Terminállal?
Igen. A Windows Terminál meg tudja nyitni az Ubuntu lapokat, lehetővé téve a Claude Code elérését anélkül, hogy külön Ubuntu ablakra váltana. A Windows Terminálban kattintson a legördülő nyílra, és válassza az Ubuntut a profilok listájából.
Működni fognak a meglévő Windows fejlesztőeszközeim a Claude Code-dal?
Ez az eszköztől függ. A Visual Studio Code jól integrálódik a Remote-WSL kiegészítőn keresztül. A JetBrains IDE-k és más eszközök további konfigurálást igényelhetnek. A hivatalos dokumentáció VS Code-ot és JetBrains-t említ támogatott platformként.
Hogyan frissíthetem a Claude Code-ot Windowson?
A Claude Code alapértelmezetten automatikusan frissül. A manuális frissítéshez futtassa a "claude update" parancsot az Ubuntu terminálban. Az automatikus frissítési funkció kikapcsolható konfigurációs fájlokon keresztül, ha az vállalati környezetben szükséges.
Mi a különbség a Claude Code és a Claude API között?
A Claude Code egy terminál alapú kódolási asszisztens, amely parancsokat hajt végre és fájlokat szerkeszt. A Claude API programozási hozzáférést biztosít a Claude nyelvi modelljéhez egyéni alkalmazások létrehozásához. Különböző célokat szolgálnak, és különböző beállítási folyamatokat igényelnek.
Használhatom a Claude Code-ot .NET projektekkel Windowson?
Igen, de bizonyos megkötésekkel. Közösségi megbeszélések szerint a .NET SDK támogatása a WSL2-ben működik, de megköveteli a .NET SDK Linux verziójának telepítését az Ubuntun belül. A Windows-on telepített .NET nem lesz elérhető a WSL2-ből.
Mennyibe kerül a Claude Code?
Az árazás a használattól és a fiók típusától függ. Ellenőrizze a hivatalos Anthropic webhelyet az aktuális árazási szintekért és csapatszintű tervekért, mivel a költségek az API fogyasztástól és a szervezeti követelményektől függenek.
Következő lépések a telepítés után
A Claude Code telepítése után kezdje el felfedezni képességeit. A gyorsindítási dokumentáció azt javasolja, hogy kezdje egyszerű feladatokkal, mint például kódmagyarázatok, mielőtt bonyolultabb műveletekre térne át.
Próbálja ki ezeket a parancsokat a megismeréshez:
- claude “explain this function” – Kódmagyarázatok lekérése
- claude commit – Git commit üzenetek generálása
- claude -c – A legutóbbi beszélgetés folytatása
A hivatalos dokumentáció részletes útmutatókat tartalmaz az IDE integrációhoz, a bővítmények telepítéséhez és a fejlett konfigurációs lehetőségekhez. Csapatok számára a szerver által felügyelt beállítások és az analitikai követés további ellenőrzést kínálnak a Claude Code telepítések felett.
A WSL2 beállítása talán extra lépéseknek tűnhet a natív Windows alkalmazásokhoz képest, de jelenleg ez az egyetlen út a Claude Code Windows rendszeren történő futtatásához. A jó hír? Miután konfigurálva van, zökkenőmentesen fut, és a legtöbb fejlesztési munkafolyamattal integrálható.
