Rýchle zhrnutie: Inštalácia Claude Code na Windows vyžaduje nastavenie WSL2 (Windows Subsystem for Linux), inštaláciu Ubuntu a spustenie jednoduchého skriptu na inštaláciu. Proces umožňuje používateľom Windows prístup k asistenta kódovania AI od spoločnosti Anthropic cez ich terminál. K dispozícii sú natívne Windows spustiteľné súbory, ale WSL2 je stále najlepšou praxou pre inštaláciu na Windows.
Claude Code je asistent kódovania poháňaný umelou inteligenciou, ktorý funguje priamo v termináli a pomáha vývojárom vytvárať funkcie, opravovať chyby a automatizovať vývojové úlohy. Pre používateľov Windows je tu však háčik.
Claude Code je k dispozícii ako natívny spustiteľný súbor pre Windows a dá sa nainštalovať cez npm alebo priamym stiahnutím spustiteľného súboru bez WSL2. Vyžaduje si však Windows Subsystem for Linux (WSL2) a oficiálna metóda inštalácie sa stále spolieha na WSL2.
Tu je návod, ako to rozbehnúť na Windows 11 alebo Windows 10.
Systémové požiadavky
Pred začatím inštalácie skontrolujte, či váš počítač s Windows spĺňa tieto požiadavky:
- Windows 10 1809+ alebo Windows Server 2019+
- Windows 11 (akákoľvek verzia)
- Aspoň 4 GB voľnej RAM
- Administrátorské oprávnenia v systéme
- Pripojenie k internetu na stiahnutie WSL2 a Ubuntu
Inštalácia vyžaduje miesto na disku pre WSL2, Ubuntu a Claude Code.
Krok 1: Povolenie Windows Subsystem for Linux
WSL2 poskytuje Linuxové prostredie priamo vo Windowse. Je to základ, ktorý umožňuje funkčnosť Claude Code.
Otvorte PowerShell ako správca. Kliknite pravým tlačidlom myši na tlačidlo Štart a vyberte položku „Windows PowerShell (Admin)“ alebo „Terminál (Admin)“ v systéme Windows 11.
Spustite tento príkaz:
wsl –install
Tento príkaz povolí potrebné funkcie systému Windows a nainštaluje Ubuntu ako predvolenú distribúciu Linuxu. Systém vás pravdepodobne vyzve na reštartovanie.
Po reštartovaní WSL2 automaticky dokončí nastavenie. Spustí sa Ubuntu a zobrazí sa výzva na zadanie používateľského mena a hesla. Tieto poverenia sú určené iba pre prostredie Linuxu – nemusia sa zhodovať s povereniami systému Windows.
Krok 2: Overenie inštalácie WSL2
Po reštartovaní systému a dokončení úvodného nastavenia Ubuntu overte, či WSL2 beží správne.
Otvorte terminál Ubuntu (vyhľadajte „Ubuntu“ v ponuke Štart) a spustite:
wsl –version
Tým sa zobrazia informácie o verzii WSL. V výstupe hľadajte „WSL version: 2.x.x“.
Ak príkaz zobrazuje WSL1 namiesto toho, upgradujte na WSL2 pomocou:
wsl –set-default-version 2
Krok 3: Inštalácia Claude Code
Teraz pre samotnú inštaláciu Claude Code. Oficiálna dokumentácia poskytuje jednoradový inštalačný skript.
V termináli Ubuntu spustite:
curl -fsSL claude.ai/install.sh | bash
Skript stiahne spustiteľný súbor Claude Code, nastaví potrebné povolenia a pridá ho do systémovej cesty (PATH). Doba inštalácie sa líši v závislosti od rýchlosti internetu a špecifikácií systému.
Podľa oficiálnej dokumentácie Claude Code, inštalátor automaticky rozpozná architektúru systému a stiahne príslušnú verziu spustiteľného súboru.
Bežné problémy pri inštalácii
Niektorí používatelia Windows hlásia po inštalácii hlásenie „command not found: claude“. Zvyčajne sa to stáva preto, že premenná PATH sa neobnovila.
Zatvorte a znovu otvorte terminál Ubuntu, potom to skúste znova. Ak problém pretrváva, toto nastavenie cesty môže pomôcť ako neoficiálne riešenie:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
Krok 4: Autentizácia Claude Code
Claude Code vyžaduje pred použitím autentizáciu pomocou účtu Anthropic.
Spustite tento príkaz:
claude
Terminál zobrazí URL a požiada o autentizáciu. Proces sa mierne líši pre individuálnych používateľov a tímové účty:
| Typ účtu | Metóda autentizácie | Čo je potrebné |
|---|---|---|
| Individuálny | Osobné API kľúč | Účet Anthropic s prístupom k API |
| Tím/Organízácia | Token organizácie | Administrátorom poskytnutý autentizačný token |
Otvorte poskytnutú URL v prehliadači, prihláste sa do účtu Anthropic a autorizujte Claude Code. Terminál potvrdí úspešnú autentizáciu.
Práca s projektmi Windows v WSL2
Tu to začína byť zložité. Systémy súborov Windows a systémy súborov WSL2 sú oddelené.
Súbory Windows sú prístupné z WSL2 na /mnt/c/ (pre disk C:), /mnt/d/ (pre disk D:) atď. Existuje však výkonnostná cena. Diskusie komunity naznačujú rozdiely vo výkone medzi adresármi namontovanými z Windowsu a natívnymi adresármi WSL2.
Pre najlepší výkon skopírujte súbory projektu do domovského adresára WSL2:
cp -r /mnt/c/Users/VašeMeno/Projects/váš-projekt ~/projects/váš-projekt
Kompromis? Integrácia IDE sa stáva zložitejšou. Visual Studio Code to rieši dobre pomocou rozšírenia Remote-WSL, ale iné IDE môžu mať problémy.
Testovanie inštalácie
Overte, či Claude Code funguje správne pomocou jednoduchého testu.
Prejdite do adresára projektu (alebo vytvorte testovací priečinok):
mkdir ~/claude-test
cd ~/claude-test
claude “vytvor jednoduchý python skript hello world”
Claude Code by mal odpovedať, vytvoriť súbor a zobraziť kód. Tým sa potvrdí úspešná inštalácia.
Prestaňte preplácať, najprv si nárokujte dostupné kredity AI
Inštalácia Claude Code na Windows je zvyčajne rýchla. Skutočné náklady sa objavia neskôr, keď vývojári začnú testovať príkazy, spúšťať skripty a integrovať model do aplikácií. Táto experimentálna fáza môže generovať veľa volaní API a mnoho tímov si náklady uvedomí až po začatí vývoja.
Predtým, ako miniete peniaze za používanie, stojí za to skontrolovať, či máte nárok na kredity AI alebo partnerské programy. Get AI Perks zhromažďuje tieto príležitosti na jednom mieste a uvádza kredity a zľavy od poskytovateľov AI, cloudových platforiem a vývojárskych nástrojov spolu s jednoduchými pokynmi na ich získanie.
Pred spustením prvého projektu Claude Code skontrolujte Get AI Perks a nárokujte si kredity AI, ktoré môžu pokryť vaše náklady na vývoj.
Často kladené otázky
Môže Claude Code bežať natívne na Windowse bez WSL2?
Áno, ale WSL2 zostáva najlepšou metódou inštalácie pre Windows.
Funguje Claude Code s Windows Terminal?
Áno. Windows Terminal dokáže otvoriť karty Ubuntu, čím umožňuje prístup k Claude Code bez prepínania na samostatné okno Ubuntu. V Windows Terminal kliknite na šípku nadol a vyberte Ubuntu zo zoznamu profilov.
Budú moje existujúce vývojové nástroje pre Windows fungovať s Claude Code?
Závisí to od nástroja. Visual Studio Code sa dobre integruje prostredníctvom rozšírenia Remote-WSL. IDE JetBrains a iné nástroje môžu vyžadovať dodatočné konfigurácie. Oficiálna dokumentácia uvádza VS Code a JetBrains ako podporované platformy.
Ako aktualizujem Claude Code na Windowse?
Claude Code sa štandardne aktualizuje automaticky. Ak chcete manuálne aktualizovať, spustite `claude update` v termináli Ubuntu. Funkcia automatickej aktualizácie sa dá v prípade potreby deaktivovať prostredníctvom konfiguračných súborov pre podnikové prostredia.
Aký je rozdiel medzi Claude Code a API Claude?
Claude Code je terminálový asistent kódovania, ktorý vykonáva príkazy a upravuje súbory. API Claude poskytuje programový prístup k jazykovému modelu Claude na vytváranie vlastných aplikácií. Slúžia rôznym účelom a vyžadujú rôzne procesy nastavenia.
Môžem použiť Claude Code s projektmi .NET na Windowse?
Áno, ale s výhradami. Diskusie komunity naznačujú, že podpora .NET SDK v WSL2 funguje, ale vyžaduje si inštaláciu Linuxovej verzie .NET SDK v rámci Ubuntu. .NET nainštalovaný vo Windowse nebude prístupný z WSL2.
Koľko stojí Claude Code?
Ceny závisia od používania a typu účtu. Aktuálne cenové úrovne a tímové plány si pozrite na oficiálnej webovej stránke Anthropic, pretože náklady sa líšia v závislosti od spotreby API a organizačných požiadaviek.
Ďalšie kroky po inštalácii
Po nainštalovaní Claude Code začnite skúmať jeho možnosti. Dokumentácia na rýchly štart odporúča začať s jednoduchými úlohami, ako je vysvetlenie kódu, predtým, ako prejdete na zložitejšie operácie.
Vyskúšajte tieto príkazy, aby ste sa s ním zoznámili:
- claude “vysvetli túto funkciu” – Získajte vysvetlenia kódu
- claude commit – Generujte správy Git commit
- claude -c – Pokračujte v poslednej konverzácii
Oficiálna dokumentácia poskytuje podrobné návody na integráciu IDE, inštaláciu doplnkov a pokročilé možnosti konfigurácie. Pre tímy ponúkajú nastavenia spravované serverom a sledovanie analýz dodatočnú kontrolu nad nasadením Claude Code.
Nastavenie WSL2 sa môže zdať ako dodatočné kroky v porovnaní s natívnymi aplikáciami Windows, ale je to momentálne jediná cesta k spusteniu Claude Code na Windowse. Dobrá správa? Po nakonfigurovaní funguje hladko a integruje sa s väčšinou vývojových pracovných postupov.
