Stručné shrnutí: Instalace Claude Code na Windows vyžaduje nastavení WSL2 (Windows Subsystem for Linux), instalaci Ubuntu a spuštění jednoduchého instalačního skriptu. Tento proces umožňuje uživatelům Windows přístup k AI asistenta pro kódování od společnosti Anthropic prostřednictvím jejich terminálu. K dispozici jsou nativní Windows binární soubory, nicméně WSL2 je pro instalaci na Windows stále nejlepším postupem.
Claude Code je AI asistent pro kódování, který funguje přímo v terminálu a pomáhá vývojářům vytvářet funkce, opravovat chyby a automatizovat vývojové úlohy. Pro uživatele Windows je zde však háček.
Claude Code je k dispozici jako nativní spustitelný soubor pro Windows a lze jej nainstalovat prostřednictvím npm nebo přímým stažením binárního souboru bez WSL2. Vyžaduje však Windows Subsystem for Linux (WSL2) a oficiální metoda instalace se stále spoléhá na WSL2.
Zde je návod, jak jej zprovoznit na Windows 11 nebo Windows 10.
Systémové požadavky
Před zahájením instalace ověřte, zda váš počítač se systémem Windows splňuje následující požadavky:
- Windows 10 1809+ nebo Windows Server 2019+
- Windows 11 (jakákoli verze)
- Nejméně 4 GB dostupného RAM
- Administrátorská oprávnění na systému
- Internetové připojení pro stažení WSL2 a Ubuntu
Instalace vyžaduje místo na disku pro WSL2, Ubuntu a Claude Code.
Krok 1: Povolení Windows Subsystem for Linux
WSL2 poskytuje prostředí Linux přímo ve Windows. Je to základ, který umožňuje fungování Claude Code.
Otevřete PowerShell jako správce. Klikněte pravým tlačítkem myši na tlačítko Start a vyberte „Windows PowerShell (Admin)“ nebo „Terminál (Admin)“ ve Windows 11.
Spusťte tento příkaz:
wsl –install
Tento příkaz povolí potřebné funkce systému Windows a nainstaluje Ubuntu jako výchozí distribuci Linuxu. Systém vás pravděpodobně vyzve k restartování.
Po restartování se WSL2 automaticky dokončí. Spustí se Ubuntu a požádá o uživatelské jméno a heslo. Tyto přihlašovací údaje jsou pouze pro prostředí Linux – nemusí se shodovat s přihlašovacími údaji systému Windows.
Krok 2: Ověření instalace WSL2
Po restartování systému a dokončení úvodního nastavení Ubuntu ověřte, zda WSL2 správně funguje.
Otevřete terminál Ubuntu (vyhledejte „Ubuntu“ v nabídce Start) a spusťte:
wsl –version
Zobrazí se informace o verzi WSL. V příkazu hledejte „WSL version: 2.x.x“.
Pokud příkaz zobrazí WSL1, upgradujte na WSL2 pomocí:
wsl –set-default-version 2
Krok 3: Instalace Claude Code
Nyní k samotné instalaci Claude Code. Oficiální dokumentace poskytuje jednřádkový instalační skript.
V terminálu Ubuntu spusťte:
curl -fsSL claude.ai/install.sh | bash
Skript stáhne binární soubor Claude Code, nastaví potřebná oprávnění a přidá jej do systémové cesty (PATH). Doba instalace se liší v závislosti na rychlosti internetu a specifikacích systému.
Podle oficiální dokumentace Claude Code, instalátor automaticky detekuje architekturu systému a stáhne příslušnou verzi binárního souboru.
Běžné problémy s instalací
Někteří uživatelé Windows hlásí po instalaci chybu „command not found: claude“. To se obvykle stává proto, že se proměnná PATH neobnovila.
Zavřete a znovu otevřete terminál Ubuntu, poté zkuste znovu. Pokud problém přetrvává, může jako neoficiální řešení pomoci toto nastavení cesty:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
Krok 4: Autentizace Claude Code
Claude Code vyžaduje před použitím autentizaci pomocí účtu Anthropic.
Spusťte tento příkaz:
claude
Terminál zobrazí URL a požádá o autentizaci. Proces se mírně liší pro jednotlivé uživatele a týmové účty:
| Typ účtu | Metoda autentizace | Co je požadováno |
|---|---|---|
| Individuální | Osobní API klíč | Účet Anthropic s přístupem k API |
| Tým/Organizace | Token organizace | Autentizační token poskytnutý administrátorem |
Otevřete zobrazené URL v prohlížeči, přihlaste se ke svému účtu Anthropic a autorizujte Claude Code. Terminál potvrdí úspěšnou autentizaci.
Práce s projekty Windows v WSL2
Zde začíná být situace složitější. Systémy souborů Windows a WSL2 jsou oddělené.
Soubory Windows jsou z WSL2 přístupné na /mnt/c/ (pro disk C:), /mnt/d/ (pro disk D:) a tak dále. To však s sebou nese výkonnostní náklady. Diskuze v komunitě naznačují výkonnostní rozdíly mezi disky připojenými ve Windows a nativními adresáři WSL2.
Pro nejlepší výkon zkopírujte soubory projektu do domovského adresáře WSL2:
cp -r /mnt/c/Users/VašeJméno/Projects/váš-projekt ~/projects/váš-projekt
Kompromis? Integrace IDE se stává složitější. Visual Studio Code to řeší dobře pomocí rozšíření Remote-WSL, ale jiná IDE mohou mít problémy.
Testování instalace
Ověřte správnou funkčnost Claude Code jednoduchým testem.
Přejděte do adresáře projektu (nebo vytvořte testovací složku):
mkdir ~/claude-test
cd ~/claude-test
claude “vytvoř jednoduchý Python skript hello world”
Claude Code by měl reagovat, vytvořit soubor a zobrazit kód. Tím se potvrdí úspěšné dokončení instalace.
Přestaňte přeplácet, nejprve si nárokujte dostupné AI kredity
Instalace Claude Code na Windows je obvykle rychlá. Skutečné náklady se objeví později, když vývojáři začnou testovat prompty, spouštět skripty a integrovat model do aplikací. Tato fáze experimentování může vygenerovat velké množství volání API a mnoho týmů si uvědomí náklady až poté, co začnou budovat.
Než začnete utrácet peníze za používání, je dobré zkontrolovat, zda máte nárok na AI kredity nebo partnerské programy. Get AI Perks shromažďuje tyto příležitosti na jednom místě a uvádí kredity a slevy od poskytovatelů AI, cloudových platforem a vývojářských nástrojů, spolu s jednoduchými pokyny, jak je získat.
Než spustíte svůj první projekt Claude Code, podívejte se na Get AI Perks a získejte AI kredity, které mohou pokrýt vaše vývojové náklady.
Často kladené otázky
Může Claude Code běžet nativně na Windows bez WSL2?
Ano, ale WSL2 stále zůstává nejlepším způsobem instalace pro Windows.
Funguje Claude Code s Windows Terminálem?
Ano. Windows Terminál umí otevřít záložky Ubuntu, což umožňuje přístup k Claude Code bez přepínání do samostatného okna Ubuntu. Ve Windows Terminálu klikněte na šipku dolů a ze seznamu profilů vyberte Ubuntu.
Budou mé stávající vývojové nástroje pro Windows fungovat s Claude Code?
Záleží na nástroji. Visual Studio Code se dobře integruje prostřednictvím rozšíření Remote-WSL. IDE JetBrains a další nástroje mohou vyžadovat další konfiguraci. Oficiální dokumentace zmiňuje VS Code a JetBrains jako podporované platformy.
Jak aktualizovat Claude Code na Windows?
Claude Code se ve výchozím nastavení aktualizuje automaticky. Pro manuální aktualizaci spusťte v terminálu Ubuntu příkaz „claude update“. Funkce automatické aktualizace může být v případě potřeby pro podniková prostředí zakázána prostřednictvím konfiguračních souborů.
Jaký je rozdíl mezi Claude Code a Claude API?
Claude Code je terminálový asistent pro kódování, který spouští příkazy a upravuje soubory. Claude API poskytuje programový přístup k jazykovému modelu Claude pro tvorbu vlastních aplikací. Slouží k různým účelům a vyžadují odlišné nastavení.
Mohu používat Claude Code s projekty .NET na Windows?
Ano, ale s výhradami. Komunitní diskuze naznačují, že podpora .NET SDK v WSL2 funguje, ale vyžaduje instalaci Linuxové verze .NET SDK v Ubuntu. .NET nainstalovaný ve Windows nebude z WSL2 přístupný.
Kolik Claude Code stojí?
Cena závisí na použití a typu účtu. Aktuální cenové úrovně a týmové plány naleznete na oficiálních webových stránkách Anthropic, protože náklady se liší podle spotřeby API a požadavků organizace.
Další kroky po instalaci
Po instalaci Claude Code začněte zkoumat jeho možnosti. Dokumentace pro rychlý start doporučuje začít s jednoduchými úkoly, jako je vysvětlování kódu, před přechodem ke složitějším operacím.
Vyzkoušejte tyto příkazy, abyste se s ním seznámili:
- claude “vysvětli tuto funkci” – Získání vysvětlení kódu
- claude commit – Generování Git commit zpráv
- claude -c – Pokračování v poslední konverzaci
Oficiální dokumentace poskytuje podrobné návody pro integraci IDE, instalaci pluginů a pokročilé možnosti konfigurace. Pro týmy nabízejí serverově spravovaná nastavení a sledování analytických údajů další kontrolu nad nasazením Claude Code.
Nastavení WSL2 se může zdát jako další kroky ve srovnání s nativními aplikacemi pro Windows, ale v současnosti je to jediná cesta, jak spustit Claude Code na Windows. Dobrá zpráva? Jakmile je nakonfigurován, běží hladce a integruje se s většinou vývojových pracovních postupů.
