Klíčové poznatky
- Dvě metody instalace: Použijte nativní instalátor (
curl -fsSL https://claude.ai/install.sh | bash) pro nastavení bez závislostí, nebo npm (npm install -g @anthropic-ai/claude-code), pokud potřebujete fixování verzí. - Systémové požadavky jsou minimální: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), nebo Windows 10+ s WSL. Alespoň 4GB RAM. Není potřeba GPU.
- Vyžadován účet: Potřebujete účet Claude Pro, Max, Teams, Enterprise nebo Console (API). Bezplatný tarif Claude.ai nezahrnuje přístup k Claude Code.
- Nastavení zabere méně než pět minut: Nainstalujte, autentizujte se v prohlížeči a začněte okamžitě používat Claude Code v jakémkoli adresáři projektu.
Jak nainstalovat Claude Code: Kompletní průvodce nastavením (2026)
Claude Code je AI asistent pro kódování od společnosti Anthropic, který běží přímo ve vašem terminálu. Čte vaši codebase, píše kód, spouští příkazy a zvládá komplexní úpravy ve více souborech najednou – to vše z jediného rozhraní příkazové řádky (CLI).
Na rozdíl od AI chatovacích nástrojů založených na prohlížeči pracuje Claude Code uvnitř vašeho skutečného vývojového prostředí. Vidí vaši souborovou strukturu, rozumí kontextu vašeho projektu a provádí změny v reálných souborech na vašem stroji.
Tento průvodce vás provede každým krokem instalace Claude Code v roce 2026, od kontroly prerekvizit až po spuštění vaší první relace kódování s podporou AI. Ať už používáte macOS, Linux nebo Windows, Claude Code zprovozníte za méně než pět minut.
Co potřebujete (seznam prerekvizit)
Před instalací Claude Code si ověřte, že máte následující:
- Operační systém: macOS 13.0 (Ventura) nebo novější, Ubuntu 20.04+ nebo Debian 10+, nebo Windows 10 (verze 1809+) s WSL
- RAM: Alespoň 4GB (8GB doporučeno pro větší codebase)
- Internetové připojení: Claude Code se připojuje ke cloudovému API společnosti Anthropic, takže je vyžadováno aktivní připojení
- Účet Anthropic: Účet Claude Pro ($20/měsíc), Claude Max ($100-200/měsíc), Teams, Enterprise nebo Console (API)
- Terminál: Bash, Zsh nebo PowerShell
- Node.js 18+ (vyžadováno pouze pro metodu instalace přes npm)
Nepotřebujete GPU. Veškeré zpracování AI probíhá na serverech Anthropic. Váš stroj musí pouze spustit CLI klienta a odesílat požadavky přes síť.
Krok 1: Instalace Node.js (pokud jej nemáte)
Pokud plánujete použít metodu instalace přes npm, potřebujete Node.js 18 nebo vyšší. Pokud již máte Node.js nainstalován, zkontrolujte svou verzi:
node --version
Pokud výstup ukazuje v18.0.0 nebo vyšší, přejděte ke Kroku 2. Pokud ne, nainstalujte nebo aktualizujte Node.js pomocí nvm (Node Version Manager), což je doporučený přístup, protože předchází problémům s oprávněními a umožňuje snadno přepínat mezi verzemi Node.
Instalace nvm na macOS nebo Linuxu:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Zavřete a znovu otevřete terminál, poté nainstalujte Node.js:
nvm install 22
nvm use 22
node --version
Měli byste vidět číslo verze začínající v22. Node.js 22 je aktuální LTS verze a funguje s Claude Code perfektně.
Instalace Node.js na Windows (uvnitř WSL):
Nejprve se ujistěte, že je nainstalováno WSL (viz sekce Windows níže). Poté otevřete terminál WSL a spusťte stejné příkazy nvm jako výše.
Krok 2: Instalace Claude Code
Máte dvě možnosti pro instalaci Claude Code. Nativní instalátor je nyní doporučenou metodou, ale npm zůstává plně podporováno.
Možnost A: Nativní instalátor (doporučeno)
Nativní instalátor nevyžaduje žádné závislosti – žádný Node.js, žádné npm. Automaticky se aktualizuje na pozadí a je to primární metoda, kterou Anthropic testuje a podporuje.
macOS a Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, jako administrátor):
irm https://claude.ai/install.ps1 | iex
Instalátor stáhne binární soubor Claude Code, umístí jej do vaší PATH a nakonfiguruje automatické aktualizace. Celý proces trvá méně než minutu.
Možnost B: Instalace přes npm
Pokud dáváte přednost npm – například pro fixování konkrétní verze nebo protože je npm standardem ve vašem workflow – spusťte:
npm install -g @anthropic-ai/claude-code
Důležité: Nepoužívejte sudo s npm install. Pokud narazíte na chyby oprávnění, správným řešením je použít nvm (který instaluje Node.js do vašeho domovského adresáře), namísto spouštění npm jako root.
Ověření instalace
Bez ohledu na zvolenou metodu ověřte, že je Claude Code nainstalován:
claude --version
Měli byste vidět číslo verze. Můžete také spustit vestavěnou diagnostiku:
claude doctor
Tento příkaz zkontroluje vaše prostředí a nahlásí případné problémy s konfigurací.
Krok 3: Autentizace
Claude Code vyžaduje před použitím autentizaci. Spusťte:
claude
Při prvním spuštění tohoto příkazu Claude Code otevře váš výchozí webový prohlížeč a požádá vás o přihlášení k vašemu účtu Anthropic. Postupujte podle pokynů pro autorizaci CLI.
Možnosti autentizace
Přihlášení přes prohlížeč (výchozí): Nejlepší pro osobní stroje. Claude Code otevře okno prohlížeče, vy se přihlásíte a CLI automaticky obdrží autentizační token. Toto funguje s účty Claude Pro, Max, Teams a Enterprise.
API klíč (pro CI/CD a automatizaci): Pokud spouštíte Claude Code v headless prostředí nebo CI/CD pipeline, nastavte svůj API klíč jako proměnnou prostředí:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
API klíč si můžete vygenerovat v Anthropic Console. Využití API je účtováno za tokeny podle zveřejněných sazeb Anthropic.
Předplatné vs. API účtování: S předplatným Pro nebo Max je vaše využívání Claude Code zahrnuto v měsíčním tarifu (podle limitů využití). S API klíčem z Console platíte za tokeny. Vyberte si podle objemu využití – předplatná jsou jednodušší pro pravidelné používání, zatímco API účtování vám dává větší kontrolu nad proměnlivou nebo automatizovanou zátěží.
Krok 4: Váš první projekt
Nyní, když je Claude Code nainstalován a autentizován, vyzkoušejte jej na skutečném projektu.
Přejděte do libovolného adresáře projektu:
cd ~/my-project
Spusťte Claude Code:
claude
Nyní se nacházíte v interaktivní relaci. Claude Code si přečetl strukturu vašeho projektu a je připraven pomoci. Zkuste mu zadat úkol:
> Vysvětli architekturu tohoto projektu
Claude Code proskenuje vaše soubory, identifikuje technologický stack a poskytne vám shrnutí toho, jak je projekt organizován.
Zkuste něco praktičtějšího:
> Přidej validaci vstupů do registračního formuláře uživatele
Claude Code identifikuje relevantní soubory, navrhne změny a před jakoukoli úpravou vás požádá o potvrzení. Každou změnu si prohlédnete v náhledu změn (diff) a přijmete ji nebo odmítnete.
Pro jednorázový úkol bez vstupu do interaktivního režimu použijte příznak -p:
claude -p "Napiš unit testy pro modul auth"
Tím se úkol spustí, vypíše se výsledek a program se ukončí – užitečné pro skriptování a rychlé dotazy.
Krok 5: Základní konfigurace
Claude Code funguje ihned po instalaci s rozumnými výchozími hodnotami, ale jeho chování si můžete přizpůsobit svému workflow.
Výběr modelu
Claude Code standardně používá nejnovější model Claude. Chcete-li specifikovat jiný model:
claude config set model claude-opus-4-6
Nebo pro jednu relaci:
claude --model claude-sonnet-4-20250514
Oprávnění
Claude Code žádá o potvrzení před provedením potenciálně destruktivních akcí, jako je zápis do souborů nebo spouštění příkazů shellu. Toto chování můžete nakonfigurovat:
claude config set permissions.auto-accept-edits true
Nastavení na úrovni projektu
Vytvořte soubor .claude/settings.json v kořenovém adresáři projektu pro definování sdílené týmové konfigurace:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Tento soubor by měl být zanesen do správy verzí, aby celý váš tým sdílel stejné chování Claude Code.
Pro osobní přenastavení, která by neměla být commitována, použijte raději .claude/settings.local.json.
Konfigurace MCP serveru
Claude Code podporuje servery Model Context Protocol (MCP) pro rozšiřování svých schopností. Nakonfigurujte je v .mcp.json v kořenovém adresáři projektu:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Instalace v různých prostředích
macOS
Nativní instalátor je nejjednodušší cesta na macOS. Podporovány jsou jak stroje Apple Silicon (M1/M2/M3/M4), tak Intel:
curl -fsSL https://claude.ai/install.sh | bash
Případně je Claude Code dostupný přes Homebrew:
brew install --cask claude-code
Linux
Funguje na Ubuntu 20.04+, Debian 10+ a většině moderních distribucí:
curl -fsSL https://claude.ai/install.sh | bash
Pokud používáte starší distribuci, použijte metodu npm s nvm, abyste se vyhnuli problémům se závislostmi na úrovni systému.
Windows (WSL)
Claude Code na Windows vyžaduje buď WSL nebo Git for Windows. WSL je doporučený přístup:
- Otevřete PowerShell jako administrátor a nainstalujte WSL:
wsl --install
-
Po výzvě restartujte počítač.
-
Otevřete terminál WSL (výchozí je Ubuntu) a nainstalujte Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Případně můžete použít nativní instalátor pro Windows přímo v PowerShellu:
irm https://claude.ai/install.ps1 | iex
Docker
Pro kontejnerizovaná prostředí přidejte Claude Code do svého Dockerfile:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
Pro CI/CD pipeline předejte API klíč při spuštění, místo abyste jej vkládali přímo do obrazu:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Spusť sadu testů a oprav případné chyby"
CI/CD Pipeline
Headless režim Claude Code (příznak -p) je navržen pro automatizaci. Zde je příklad pro GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Zkontroluj změny v tomto PR a navrhni zlepšení" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Příznak --output-format json vrací strukturovaný výstup, který mohou následné kroky zpracovat.
Aktualizace Claude Code
Nativní instalátor
Pokud jste nainstalovali Claude Code pomocí nativního instalátoru, aktualizace probíhají automaticky na pozadí. Není vyžadována žádná akce. Můžete nakonfigurovat kanál aktualizací:
claude config set update-channel stable
Pro kontrolu aktuální verze:
claude --version
npm
Pokud jste instalovali přes npm, aktualizujte ručně:
npm update -g @anthropic-ai/claude-code
Nebo nainstalujte konkrétní verzi:
npm install -g @anthropic-ai/claude-code@latest
Integrace s IDE
I když je Claude Code primárně nástroj pro terminál, integruje se přímo s populárními IDE pro vizuálnější zážitek.
Rozšíření pro VS Code
Rozšíření pro VS Code poskytuje nativní grafické rozhraní pro Claude Code přímo ve vašem editoru. Obsahuje panel chatu, vracení změn na základě bodů obnovy (checkpoints), odkazy na soubory pomocí zavináče @ a možnost spouštět více konverzací v paralelních záložkách.
Pro instalaci otevřete VS Code a vyhledejte "Claude Code" v panelu Extensions, nebo spusťte:
code --install-extension anthropic.claude-code
Po instalaci můžete otevřít panel Claude Code z bočního panelu a pracovat s ním stejně jako ve verzi pro terminál, ale s výhodou zobrazení diffů renderovaných přímo v nativním prohlížeči VS Code.
Plugin pro JetBrains
Pro IntelliJ IDEA, PyCharm, WebStorm, GoLand a další IDE od JetBrains nainstalujte plugin Claude Code z JetBrains Marketplace:
- Otevřete své JetBrains IDE
- Přejděte do Settings, poté Plugins a Marketplace
- Vyhledejte "Claude Code"
- Klikněte na Install a restartujte IDE
Plugin pro JetBrains spouští CLI Claude Code uvnitř integrovaného terminálu vašeho IDE a otevírá navržené změny v prohlížeči diffů v IDE. Aktuálně je v beta verzi, ale plně funkční pro každodenní použití.
Řešení problémů
"command not found: claude"
Binární soubor Claude Code není ve vaší PATH. Pokud jste použili nativní instalátor, zkuste otevřít nové okno terminálu. Pokud to nepomůže, spusťte instalační skript znovu. Pro instalace přes npm se ujistěte, že je váš globální adresář npm bin v PATH:
npm config get prefix
Přidejte podadresář bin této cesty do proměnné PATH vašeho shellu.
"Node.js version too old"
Claude Code vyžaduje Node.js 18+. Zkontrolujte svou verzi pomocí node --version. Pokud je nižší než 18, nainstalujte novější verzi pomocí nvm:
nvm install 22
nvm use 22
Chyby oprávnění npm (EACCES)
Nikdy nepoužívejte sudo npm install -g. Místo toho opravte výchozí adresář npm nebo použijte nvm, který instaluje vše do vašeho domovského adresáře a zcela předchází konfliktům s oprávněními:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Selhání autentizace nebo se neotevře prohlížeč
Pokud přihlášení přes prohlížeč nefunguje (běžné na vzdálených serverech nebo WSL), můžete se místo toho autentizovat pomocí API klíče:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Svůj API klíč si vygenerujte na console.anthropic.com.
"Network Error" nebo vypršení časového limitu během instalace
Vaše síť nebo firewall může blokovat npm nebo nativní instalátor. Zkuste:
npm config set registry https://registry.npmjs.org/
Pokud jste za firemní proxy, nakonfigurujte npm tak, aby ji používal:
npm config set proxy http://vaze-proxy:8080
npm config set https-proxy http://vaze-proxy:8080
Claude Code běží pomalu
Samotný Claude Code je lehký – pomalost obvykle znamená latenci sítě k API Anthropic. Zkontrolujte své internetové připojení. Pokud používáte VPN, zkuste se odpojit. Stav API můžete také zkontrolovat na status.anthropic.com.
Další kroky
Máte Claude Code nainstalován, autentizován a spuštěn. Zde je to, co můžete dělat dál:
- Naučte se pracovní postup: Přečtěte si náš tutoriál pro Claude Code pro hlubší pochopení strategií promptování, úprav ve více souborech a maximálního využití vývoje s podporou AI.
- Porovnejte své možnosti: Podívejte se, jak si Claude Code vede v našem srovnání Claude Code vs Cursor, pokud se rozhodujete mezi AI nástroji pro kódování.
- Prozkoumejte pokročilé funkce: Claude Code podporuje MCP servery, vlastní hooky, headless automatizaci a konfigurace s více modely. Oficiální dokumentace se těmto tématům věnuje do hloubky.
Claude Code je nejrychlejší způsob, jak přinést AI do vašeho stávajícího vývojového workflow, aniž byste museli měnit své nástroje nebo opouštět terminál. Nyní, když je nainstalován, začněte malým úkolem na reálném projektu – rozdíl uvidíte okamžitě.
