Jak aktualizovat Claude Code na nejnovější verzi v roce 2026

Claude Code se mění téměř každý den. Otevřete nejnovější changelog a najdete nové příkazy, opravené chyby a vyšší rychlost. Mezitím vám v terminálu běží sestavení staré dva týdny a polovina těchto vylepšení jednoduše nefunguje. Claude vám to ani neřekne: spustí se jako obvykle a vy přemýšlíte, proč ostatní mají funkci, kterou vy nemáte.

Ukážu vám, jak zkontrolovat verzi, aktualizovat na nejnovější a co dělat, když se aktualizace nenainstaluje. Příkazy jsou doslovně převzaté z oficiální dokumentace Claude Code a byly ověřeny na začátku září 2026. V té době byla nejnovější zveřejněná verze 2.1.261, ale vaše číslo bude jiné. Nemá smysl honit se za konkrétním číslem — důležité je jednoduše používat nedávné sestavení.

Informace o práci s Ailoot jsou k dispozici v dokumentaci.

Jak rychle aktualizovat Claude Code na nejnovější verzi?#

Níže podrobně vysvětlím jednotlivé případy, ale pokud spěcháte, tady jsou tři příkazy, které pokrývají téměř všechny situace.

claude --version   # which version is installed now
claude update      # update immediately (native installation)
claude doctor      # check the installation and updates

První zobrazí vaši verzi, druhý ji aktualizuje a třetí diagnostikuje problémy, pokud se něco pokazí. Níže vysvětlím, kdy který příkaz použít a proč claude update některým lidem nefunguje.

Jak zjistit, která verze Claude Code je právě nainstalovaná?#

Než začnete aktualizovat, je dobré vědět, z jaké verze aktualizujete. Příkaz je jednoduchý:

claude --version

Zobrazí se řádek jako 2.1.211 (Claude Code). To je vaše aktuální verze. Porovnejte první dvě čísla s nejnovějším číslem v changelogu — pokud je vaše verze mnohem nižší, je čas na aktualizaci.

Pokud chcete širší přehled, spusťte claude doctor. Jen kontroluje a nic nemění: nespustí relaci, ale zobrazí stav instalace, chyby v souboru nastavení a varování s připravenými návrhy, co opravit. Zobrazí také výsledek posledního pokusu o automatickou aktualizaci — užitečné, když máte podezření, že se aktualizace na pozadí potichu nenainstalovala.

Aktualizuje se Claude Code samo?#

Vše závisí na tom, jak jste Claude Code nainstalovali. Nativní instalace — tu Anthropic doporučuje a instaluje skript z webu — se může aktualizovat sama a dokumentace to výslovně uvádí.

Funguje to takto: Claude Code kontroluje aktualizace při spuštění a pravidelně během běhu. Pokud najde novou verzi, stáhne a nainstaluje ji na pozadí a použije ji při příštím spuštění. Stačí každých pár dní relaci zavřít a znovu otevřít a budete zase mít aktuální verzi.

Jak dopadl poslední pokus na pozadí, můžete zkontrolovat stejným příkazem claude doctor. Ukáže, zda se aktualizace z nějakého důvodu nepodařila nainstalovat.

Pokud jste ale Claude Code nainstalovali přes správce balíčků — Homebrew na MacBooku, WinGet ve Windows, apt nebo dnf v Linuxu — na pozadí se neaktualizuje. Tyto instalace se aktualizují obvyklým příkazem pro upgrade; tomu je věnována samostatná část níže.

Nedávná verze Claude Code je základ, sama vás ale dál nedovede. Konzistentní výsledky nevycházejí z verze nástroje, ale ze způsobu, jak s ním pracujete.

Jak ručně aktualizovat Claude Code jediným příkazem?#

Nemusíte čekat, až kontrola na pozadí zjistí, že je k dispozici nová verze. Existuje příkaz, který aktualizaci provede hned:

claude update

Možné jsou dva výsledky. Pokud se najde a nainstaluje aktualizace, Claude Code vypíše řádek jako Successfully updated from <old version> to version <new version>. Pokud už máte nejnovější sestavení, zobrazí se Claude Code is up to date (<version>) — to znamená, že není co aktualizovat.

Tento příkaz má při použití správců balíčků jeden háček. Pokud byl Claude Code nainstalován přes Homebrew, WinGet nebo apk, příkaz claude update zobrazí kratší odpověď — Claude is up to date! — a ne vždy sám stáhne nové sestavení. U těchto instalací je spolehlivější použít vlastní příkaz správce balíčků pro upgrade, který je popsán níže.

Jak aktualizovat Claude Code nainstalovaný přes Homebrew nebo WinGet?#

Pokud jste Claude Code nainstalovali přes správce balíčků místo skriptu z webu, za aktualizaci odpovídáte vy. Tady jsou příkazy pro jednotlivé systémy.

V macOS s Homebrew:

brew upgrade claude-code

Homebrew nabízí dvě možnosti. Claude Code instaluje ve dvou variantách. Varianta claude-code sleduje kanál stable — verzi přibližně týden starou, která vynechává vydání se závažnými problémy. Varianta claude-code@latest získá nejnovější verzi hned po jejím vydání. Aktualizujte tu, kterou jste nainstalovali: pokud máte claude-code@latest, příkaz bude brew upgrade claude-code@latest.

Ve Windows s WinGet:

winget upgrade Anthropic.ClaudeCode

U WinGet upgrade někdy selže, když Claude Code běží, protože Windows právě používá spustitelný soubor. Claude Code vám jednoduše zobrazí ruční příkaz; zavřete ho a spusťte upgrade znovu.

V Linuxu s apt, dnf nebo apk není třeba se učit samostatný příkaz — nejnovější verze přichází s běžnou aktualizací systému, protože Claude Code publikuje podepsané repozitáře.

Pokud si to nechcete pamatovat, je tu proměnná prostředí CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Nastavte ji na 1 a Claude Code spustí upgrade na pozadí s Homebrew a WinGet a po úspěšné aktualizaci doporučí restart. Dokumentace obsahuje upozornění: Claude Code vás někdy upozorní na novou verzi dřív, než se skutečně objeví ve správci balíčků. Pokud upgrade žádnou aktualizaci nenajde, chvíli počkejte a zkuste to znovu.

Mimochodem, pokud se teprve rozhodujete, jak Claude Code nainstalovat, podrobný návod najdete v samostatném článku o instalaci Claude Code — včetně důvodů, proč je nativní instalátor pohodlnější než správci balíčků.

Proč se Claude Code neaktualizuje a co s tím dělat?#

Někdy aktualizujete znovu a znovu, ale claude --version tvrdošíjně ukazuje staré číslo. Proberu hlavní příčiny, od nejčastější.

Nejprve zkontrolujte, zda nemáte nainstalováno více kopií Claude Code najednou. Může k tomu dojít, pokud jste ho nejprve nainstalovali přes npm a potom znovu nainstalovali nativně. Příkaz aktualizuje jednu kopii, ale terminál spouští jinou, takže se zdá, že se verze nezměnila. Zkontrolujte, kolik kopií máte:

which -a claude

Claude Code se může nacházet na třech místech: ~/.local/bin/claude je nativní instalátor, ~/.claude/local/ je stará místní instalace npm z prvních verzí a globální balíček npm zobrazí příkaz npm -g ls @anthropic-ai/claude-code. Pokud najdete více než jednu kopii, ponechte si jen jednu — nejlépe nativní instalaci. Přebytečné odstraňte takto:

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/local

Druhou častou příčinou je globální složka npm, do které nelze zapisovat. Pokud jste Claude Code nainstalovali globálně přes npm a nemá oprávnění zapisovat do své složky, aktualizace na pozadí se nenainstaluje. Claude Code při spuštění zobrazí jednorázové upozornění a claude doctor přesně vypíše, co je třeba opravit. I proto je vhodnější nativní instalace: zapisuje do vaší domovské složky a tato oprávnění nevyžaduje.

Třetí situací je, že jste někdy nahradili spouštěč ~/.local/bin/claude vlastním skriptem nebo symbolickým odkazem. Od verze 2.1.207 nechávají automatické aktualizace takový spouštěč být: nové verze se stále instalují do složky ~/.local/share/claude/versions/, ale o tom, která se spustí, rozhoduje váš skript. Nemažte jediný spouštěč a pak nevolejte claude update jeho názvem. Nejprve vlastní spouštěč a u symbolického odkazu i jeho cíl zachovejte v odděleném nepoužitém záložním umístění. Z původní cesty ho přesuňte až po ověření kopie. Nativní spouštěč obnovte pomocí oficiálního instalátoru, který existující příkaz claude nepotřebuje:

# macOS, Linux nebo WSL: oficiální nativní instalátor
curl -fsSL https://claude.ai/install.sh | bash

Po dokončení instalace otevřete nový terminál a ověřte výsledek:

claude --version
claude doctor

První příkaz musí vypsat číslo verze. Před pokračováním prohlédněte výstup doctor kvůli varováním o spouštěči nebo PATH; zachovaný spouštěč nemažte, dokud náhrada nefunguje.

Dalším příznakem je, když claude update nebo claude doctor zamrzne hned po řádku Checking for updates. Ve starších verzích (před 2.1.214) k tomu někdy docházelo, když některý konfigurační soubor shellu, například ~/.zshrc, byl místo souboru adresářem. Novější sestavení to nyní přeskakují, takže aktualizace na nejnovější verzi chybu také opraví.

Jak zvolit aktualizační kanál: latest, nebo stable?#

Aktualizace na nejnovější verzi nemusí vždy znamenat získání nejnovějšího sestavení hned první den. Claude Code vám umožňuje zvolit si mezi dvěma kanály, což přesně ovlivňuje, co při aktualizaci dostanete.

Kanál latest je výchozí. Nové funkce přicházejí hned po vydání, což se hodí, pokud je chcete vyzkoušet jako první. Kanál stable nabízí verzi přibližně týden starou: měla čas se ustálit a vynechává vydání se závažnými problémy. Je určený těm, kdo dávají přednost klidu před rychlostí.

Nejjednodušší způsob, jak kanály přepnout, je příkazem /config přímo v Claude Code, v části Auto-update channel. Nebo to můžete zadat ručně v konfiguračním souboru settings.json:

{
  "autoUpdatesChannel": "stable"
}

Pokud si chcete Claude Code přizpůsobit svým zvyklostem, je tu samostatný návod na přizpůsobení Claude Code — věnuje se celému souboru nastavení, nejen aktualizačnímu kanálu.

Jak nainstalovat konkrétní verzi nebo nastavit minimální verzi?#

Někdy potřebujete konkrétní verzi místo nejnovější — například se vrátit k sestavení, na kterém váš pracovní postup určitě fungoval. Nativní instalátor to podporuje: přijímá název kanálu i přesné číslo verze. Konkrétní sestavení nainstalujte takto:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

Ve Windows vypadá ekvivalent v PowerShellu trochu jinak:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

Stejným způsobem můžete nainstalovat kanál stable — místo čísla napište stable. Kanál zvolený při instalaci se stane výchozím kanálem pro budoucí automatické aktualizace.

Chcete-li zabránit návratu ke starší verzi, nastavte minimální verzi v settings.json:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

To je spodní hranice. Aktualizace na pozadí ani claude update nenainstaluje verzi nižší, než je zadaná. To se hodí při přechodu na stable, pokud se nechcete vrátit ze sestavení, které už používáte, ke staršímu.

Jak vypnout automatické aktualizace, pokud překážejí?#

Někdy aktualizace na pozadí překážejí — například když chcete, aby váš tým používal přesně jednu verzi. Můžete je vypnout v souboru nastavení:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Důležitý detail: DISABLE_AUTOUPDATER potlačí pouze kontrolu na pozadí. Příkaz claude update bude dál fungovat, takže můžete stále aktualizovat ručně. Pokud potřebujete zablokovat všechny cesty aktualizace najednou včetně ručních, existuje přísnější proměnná DISABLE_UPDATES. Používá se při distribuci Claude Code vlastním kanálem, když chcete, aby lidé zůstali přesně u sestavení, které jste poskytli.

Pro běžné osobní používání je lepší tyto proměnné neměnit: nedávná verze Claude Code je téměř vždy lepší než stará a aktualizace může přinést bezpečnostní opravu. Udržovat nástroj aktuální je součástí zachování přístupu a předcházení podivným chybám; samostatný článek popisuje, jak nepřijít o účet Claude.

Kde začít?#

Tady je stručný plán.

1. Zkontrolujte aktuální verzi: claude --version. Porovnejte ji s nejnovějším číslem v changelogu.
2. Aktualizujte. Nativní instalace — claude update. Homebrew — brew upgrade claude-code. WinGet — winget upgrade Anthropic.ClaudeCode.
3. Restartujte relaci Claude Code, aby se nová verze projevila.
4. Pokud se verze nezměnila, spusťte claude doctor a which -a claude. Pravděpodobně máte více instalací nebo složku npm, do které nelze zapisovat.
5. Zvolte si kanál, který vám vyhovuje: latest, pokud chcete nové funkce hned po jejich vydání, nebo stable, pokud je pro vás důležitější předvídatelnost. Změňte ho přes /config.

Nedávná verze opravuje chyby a přidává nové příkazy, ale aktualizovaný nástroj za vás projekt nepostaví. Průvodce alternativami Claude Code vysvětluje, jak se Claude Code liší od jiných terminálových agentů a kdy má smysl zvážit alternativy.

Poznejte Ailoot.