)` — 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?
Hlavní poznatek
Správci balíčků Claude Code automaticky neaktualizují, takže musíte příkaz pro upgrade spustit sami. Na MacBooku s Homebrew je to brew upgrade claude-code. Ve Windows s WinGet je to winget upgrade Anthropic.ClaudeCode. V Linuxu s apt, dnf nebo apk přichází aktualizace spolu s běžným upgradem systému. Chcete-li, aby Claude Code samo spouštělo upgrade přes Homebrew a WinGet, nastavte proměnnou prostředí CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE na hodnotu one.
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:
```bash
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:
```powershell
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.
| Způsob instalace | Příkaz pro aktualizaci |
|----------------------|----------------|
| Nativní instalátor | aktualizuje se samo, nebo `claude update` |
| Homebrew (macOS) | `brew upgrade claude-code` |
| WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` |
| apt / dnf / apk (Linux) | běžná aktualizace systému |
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](https://ailoot.ai/blog/cs/install-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?
Hlavní poznatek
Obvykle připadají v úvahu tři příčiny. Zaprvé máte více instalací Claude Code, které si navzájem překážejí: příkaz aktualizuje jednu, ale spouští se jiná. Zadruhé globální složka npm není zapisovatelná, takže se aktualizace na pozadí potichu nenainstaluje. Zatřetí jste možná nahradili spouštěč vlastním skriptem. S řešením potíží začněte příkazem claude doctor a příkazem which -a claude; přesně ukážou, kde je problém.
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:
```bash
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:
```bash
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](https://code.claude.com/docs/en/setup#install-claude-code), který existující příkaz `claude` nepotřebuje:
```bash
# 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:
```bash
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?
Hlavní poznatek
Claude Code má dva aktualizační kanály. Latest je výchozí kanál; nové funkce přicházejí hned po vydání. Stable je verze přibližně týden stará, která vynechává vydání se závažnými problémy. Pokud jsou pro vás důležité čerstvé funkce, zůstaňte na latest. Pokud je pro vás důležitější předvídatelnost a nechcete narazit na nedopečená sestavení, přepněte na stable. Změnit to můžete nastavením autoUpdatesChannel v souboru settings.json nebo příkazem /config.
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`:
```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](https://ailoot.ai/blog/cs/claude-personalization-profile-memory/) — věnuje se celému souboru nastavení, nejen aktualizačnímu kanálu.
## Jak nainstalovat konkrétní verzi nebo nastavit minimální verzi?
Hlavní poznatek
Nativní instalátor přijímá název kanálu i přesné číslo verze. Chcete-li nainstalovat konkrétní sestavení, přidejte jeho číslo na konec instalačního příkazu, například bash -s 2.1.89. Stejným způsobem můžete místo latest nainstalovat kanál stable. Chcete-li zabránit tomu, aby vás aktualizace někdy vrátily pod určitou verzi, nastavte v settings.json položku minimumVersion. Jde o spodní hranici, pod kterou nepůjde ani aktualizace na pozadí, ani claude update.
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:
```bash
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
```
Ve Windows vypadá ekvivalent v PowerShellu trochu jinak:
```powershell
& ([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`:
```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í?
Hlavní poznatek
Pokud nepotřebujete aktualizace Claude Code na pozadí, vypněte je proměnnou DISABLE_AUTOUPDATER v bloku env souboru settings.json. Zastaví pouze kontrolu na pozadí — příkaz claude update bude dál fungovat, pokud chcete aktualizovat ručně. Pokud potřebujete zablokovat všechny cesty aktualizace včetně ručních, použijte druhou proměnnou DISABLE_UPDATES. Hodí se to při distribuci Claude Code vašemu týmu, když chcete, aby všichni zůstali na stejné verzi.
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í:
```json
{
"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](https://ailoot.ai/blog/cs/claude-account-suspension-appeal/).
## Kde začít?
Hlavní poznatek
Začněte kontrolou verze pomocí claude --version a porovnejte ji s nejnovějším číslem v changelogu. Pokud jste Claude Code nainstalovali nativně, aktualizujte příkazem claude update a restartujte relaci. Pokud jste ho nainstalovali přes Homebrew nebo WinGet, spusťte příkaz pro upgrade svého správce balíčků. Pokud se verze nezmění, spusťte claude doctor a which -a claude a zkontrolujte konflikty způsobené více instalacemi. A vyberte si kanál: latest pro čerstvé funkce, stable pro klid.
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](https://ailoot.ai/blog/cs/claude-code-alternatives/) vysvětluje, jak se Claude Code liší od jiných terminálových agentů a kdy má smysl zvážit alternativy.
### Zdroje
- [Claude Code - Pokročilé nastavení, oficiální dokumentace](https://docs.claude.com/en/docs/claude-code/setup) - automatické aktualizace nativních instalací, příkaz claude update, kanály latest a stable, nastavení autoUpdatesChannel a minimumVersion, DISABLE_AUTOUPDATER, instalace konkrétní verze
- [Claude Code - Řešení potíží s instalací, oficiální dokumentace](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - konflikty mezi více instalacemi, which -a claude, oprávnění složky npm, vlastní spouštěče, zamrzání příkazu claude update
- [Claude Code - CHANGELOG na GitHubu](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - seznam verzí a změn v jednotlivých sestaveních; kde ověřit nejnovější číslo
Poznejte [Ailoot](https://ailoot.ai/).
## Časté otázky
### Proč claude update stále spouští můj starý vlastní spouštěč?
Nativní aktualizátor vlastní spouštěč ponechává, takže binární soubor stále vybírá tento skript. Před opravou zachovejte spouštěč i jeho cíl; použijte dokumentovaný nativní instalátor místo smazání jediného příkazu a jeho okamžitého zavolání.
### Jak ověřit obnovu spouštěče?
Otevřete nový terminál a spusťte claude --version; má vypsat číslo verze. Pak spusťte claude doctor a prohlédněte varování instalace a spouštěče. Pokud příkaz chybí, nejprve opravte PATH.
## Ailoot · Společnost a její portfolio projektů
Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.
Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.
Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.