Claude Code меняется почти каждый день. Открываешь свежий changelog - там новые команды, починенные баги, ускорения. А у тебя в терминале сборка двухнедельной давности, и половина этих улучшений просто не работает. Причём Claude об этом молчит: запускается как обычно, и ты сам гадаешь, почему у других фича есть, а у тебя её нет.
Разберу по шагам, как узнать свою версию, обновиться до последней и что делать, если обновление не встаёт. Команды даю дословно из официальной документации Claude Code, проверял на начало сентября 2026. На тот момент последняя опубликованная версия была 2.1.261, но у тебя цифра будет своя. Гнаться за конкретным числом смысла нет - важно просто стоять на свежей сборке.
В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись.
Как быстро обновить Claude Code до последней версии?
Дальше распишу каждый случай подробно, но если некогда читать - вот три команды, которые закрывают почти все ситуации.
claude --version # какая версия стоит сейчас
claude update # обновить немедленно (нативная установка)
claude doctor # проверить, что с установкой и обновлениямиПервая показывает твою версию, вторая обновляет, третья диагностирует, если что-то пошло не так. Ниже разложу, когда какая нужна и почему у части людей claude update не срабатывает.
Как проверить, какая версия Claude Code стоит сейчас?
Прежде чем обновляться, стоит понять, от чего ты обновляешься. Команда простая:
claude --versionВ ответ придёт строка вида 2.1.211 (Claude Code). Это твоя текущая версия. Сравни первые две цифры со свежим номером в changelog - если твоя цифра сильно меньше, самое время обновиться.
Если хочется картину пошире, запусти claude doctor. Она только смотрит и ничего не меняет: сессию не стартует, зато показывает состояние установки, ошибки в файле настроек и предупреждения с готовыми подсказками, что чинить. Там же видно результат последней попытки авто-обновления - удобно, когда подозреваешь, что фоновое обновление молча не встаёт.
Обновляется ли Claude Code сам?
Тут всё зависит от того, как ты Claude Code ставил. Нативная установка - та, что рекомендует Anthropic и которую ставит скрипт с сайта - умеет обновляться сама, и в документации это сказано прямо.
Нативные установки автоматически обновляются в фоне, чтобы держать тебя на последней версии.
Механика такая: Claude Code проверяет обновления при старте и периодически, пока работает. Если нашлась новая версия, она качается и ставится в фоне, а применяется при следующем запуске. Достаточно раз в пару дней закрыть и открыть сессию заново, и ты снова на свежем.
Проверить, как прошла последняя фоновая попытка, можно всё той же командой claude doctor. Если обновление по какой-то причине не встаёт, она это покажет.
А вот если ты ставил Claude Code через пакетный менеджер - Homebrew на макбуке, WinGet на Windows, apt или dnf на Linux - фонового обновления там нет. Такие установки обновляются твоей обычной командой апгрейда, и об этом отдельный раздел ниже.
Свежий Claude Code - это фундамент, но сам по себе он тебя не вывозит. Стабильный результат даёт не версия инструмента, а методология работы с ним. На практикуме за три вечера собираешь всю связку: ИИ-клон, Второй мозг и контекст-инжиниринг - три кита, без которых ИИ галлюцинирует даже на самой свежей сборке.
Как обновить Claude Code вручную одной командой?
Ждать, пока фоновая проверка сама заметит новую версию, не обязательно. Есть команда, которая обновляет прямо сейчас:
claude updateДальше возможны два исхода. Если обновление нашлось и встало, Claude Code отчитается строкой Successfully updated from <старая версия> to version <новая версия>. Если ты и так на последней сборке, придёт Claude Code is up to date (<версия>) - значит, обновляться нечего.
У этой команды есть тонкость на пакетных менеджерах. Если Claude Code стоит через Homebrew, WinGet или apk, claude update отвечает короче - Claude is up to date! - и не всегда тянет саму новую сборку. Для таких установок надёжнее команда апгрейда самого пакетного менеджера, о ней ниже.
Как обновить Claude Code, установленный через Homebrew или WinGet?
Если ты ставил Claude Code через пакетный менеджер вместо скрипта с сайта, обновление лежит на тебе. Вот команды по системам.
На macOS через Homebrew:
brew upgrade claude-codeТут есть развилка. Homebrew ставит Claude Code в двух вариантах. Вариант claude-code следит за стабильным каналом - это версия примерно недельной давности, которая пропускает релизы с крупными поломками. Вариант claude-code@latest тянет свежак сразу, как только он выходит. Обновляешь тот, что ставил: если у тебя claude-code@latest, то и команда будет brew upgrade claude-code@latest.
На Windows через WinGet:
winget upgrade Anthropic.ClaudeCodeНа WinGet апгрейд иногда падает прямо во время работы Claude Code - Windows держит исполняемый файл занятым. Тогда Claude Code просто покажет ручную команду, закрой его и запусти апгрейд заново.
На Linux с apt, dnf или apk отдельной команды учить не надо - свежая версия приезжает вместе с обычным обновлением системы, потому что Claude Code публикует подписанные репозитории.
| Как ставил | Команда обновления |
|---|---|
| Нативный установщик | обновляется сам, либо claude update |
| Homebrew (macOS) | brew upgrade claude-code |
| WinGet (Windows) | winget upgrade Anthropic.ClaudeCode |
| apt / dnf / apk (Linux) | обычный системный апгрейд |
Если лень держать это в голове, есть переменная окружения CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE. Выставь её в 1, и Claude Code сам будет запускать апгрейд на Homebrew и WinGet в фоне, а после успеха покажет предложение перезапуститься. В документации есть оговорка: Claude Code иногда уведомляет о новой версии раньше, чем она реально появилась в пакетном менеджере. Если апгрейд не находит обновление - подожди немного и повтори.
Кстати, если ты ещё только выбираешь, как ставить Claude Code, я подробно разбирал это в отдельном материале про установку Claude Code - там же про то, почему нативный установщик удобнее пакетных менеджеров.
Почему Claude Code не обновляется и что с этим делать?
Бывает, обновляешь-обновляешь, а claude --version упрямо показывает старую цифру. Разберу главные причины по частоте.
Первое, что стоит проверить - не стоит ли у тебя несколько установок Claude Code одновременно. Такое случается, когда сначала поставил через npm, потом переставил нативно. Команда обновляет одну копию, а в терминале запускается другая, и версия будто не меняется. Посмотри, сколько у тебя копий:
which -a claudeClaude Code может лежать в трёх местах: ~/.local/bin/claude - это нативный установщик, ~/.claude/local/ - старый локальный npm из ранних версий, а глобальный npm-пакет виден командой npm -g ls @anthropic-ai/claude-code. Если нашлось несколько - оставь одну, лучше нативную. Лишние убираются так:
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude/localВторая частая причина - глобальная папка npm закрыта на запись. Если ставил Claude Code глобальным npm и у него нет прав писать в свою папку, фоновое обновление не встаёт. Claude Code показывает разовое уведомление при старте, а claude doctor перечисляет, что именно поправить. Это ещё один довод в пользу нативной установки: она пишет в твою домашнюю папку и таких прав не требует.
Третья ситуация - ты когда-то заменил лончер ~/.local/bin/claude своим скриптом или симлинком. Начиная с версии 2.1.207 авто-обновление такой лончер не трогает: новые версии всё равно ставятся в папку ~/.local/share/claude/versions/, но какую из них запускать, решает твой скрипт. Если хочешь вернуть управление Claude Code, удали свой лончер и обнови:
rm ~/.local/bin/claude
claude updateЕщё один симптом - claude update или claude doctor зависают сразу после строки Checking for updates. На старых версиях (до 2.1.214) так бывало, когда на месте одного из файлов настроек оболочки, например ~/.zshrc, оказывалась папка. В свежих сборках это уже пропускается, так что само обновление до последней версии этот баг и лечит.
Как выбрать канал обновлений: latest или stable?
Обновиться до последней версии - не всегда значит хватать самую свежую сборку в первый же день. У Claude Code есть выбор из двух каналов, и он влияет на то, что именно тебе прилетает при обновлении.
Канал latest стоит по умолчанию. На нём новые возможности приходят сразу после релиза - удобно, если хочешь пробовать свежак первым. Канал stable даёт версию примерно недельной давности: она уже отлежалась и пропускает релизы, где вылезли крупные поломки. Это выбор для тех, кому спокойствие важнее скорости.
Переключить канал проще всего командой /config внутри Claude Code, пункт Auto-update channel. Или прописать руками в файле настроек settings.json:
{
"autoUpdatesChannel": "stable"
}Для тех, кто настраивает Claude Code под свои привычки, я собрал отдельный разбор про настройку Claude Code под себя - там про файл настроек в целом, не только про канал обновлений.
Как поставить конкретную версию или зафиксировать минимальную?
Иногда нужна конкретная версия вместо последней - например, вернуться на сборку, где твой рабочий сценарий точно работал. Нативный установщик это умеет: он принимает и номер канала, и точный номер версии. Ставишь конкретную сборку так:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89На Windows в PowerShell то же самое выглядит чуть иначе:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89Тем же способом ставится и стабильный канал - вместо номера пишешь stable. Канал, который выбрал при установке, становится каналом по умолчанию для будущих авто-обновлений.
Если хочешь застраховаться от отката вниз, задай в settings.json минимальную версию:
{
"autoUpdatesChannel": "stable",
"minimumVersion": "2.1.100"
}Это нижняя граница. Ни фоновое обновление, ни claude update не поставят версию ниже указанной. Удобно, когда переключаешься на stable, но не хочешь при этом откатиться с более свежей сборки, на которой уже сидишь.
Как отключить авто-обновления, если они мешают?
Иногда фоновые обновления мешают - например, ты хочешь держать команду на строго одной версии. Отключается это через файл настроек:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}Важный нюанс: DISABLE_AUTOUPDATER глушит только фоновую проверку. Команда claude update продолжит работать, так что обновиться руками ты всё равно сможешь. Если же надо закрыть все пути обновления разом, включая ручной, есть более жёсткая переменная DISABLE_UPDATES. Её ставят, когда раздают Claude Code через свой канал и хотят, чтобы люди сидели ровно на той сборке, которую им выдали.
Для обычной работы одиночки я эти переменные трогать не советую: свежий Claude Code почти всегда лучше старого, а исправление безопасности может прилететь именно с обновлением. Держать инструмент в актуальном состоянии - часть того, чтобы не терять доступ и не ловить странные баги, про это у меня есть отдельный материал - как не потерять аккаунт Claude.
С чего начать?
Собираю всё в короткий план.
- Проверь текущую версию:
claude --version. Сравни со свежим номером в changelog. - Обновись. Нативная установка -
claude update. Homebrew -brew upgrade claude-code. WinGet -winget upgrade Anthropic.ClaudeCode. - Перезапусти сессию Claude Code, чтобы новая версия применилась.
- Если версия не поменялась - запусти
claude doctorиwhich -a claude. Скорее всего, у тебя несколько установок или закрытая на запись папка npm. - Выбери канал под себя:
latest, если хочешь свежак сразу,stable, если важнее предсказуемость. Меняется через/config.
Свежая версия закрывает баги и открывает новые команды, но сам по себе обновлённый инструмент проект за тебя не соберёт. О том, чем Claude Code вообще отличается от других терминальных агентов и когда есть смысл смотреть в сторону других, я писал в разборе аналогов Claude Code.
Источники
- Claude Code - Advanced setup, официальная документация - авто-обновление нативной установки, команда claude update, каналы latest и stable, настройки autoUpdatesChannel, minimumVersion, DISABLE_AUTOUPDATER, установка конкретной версии
- Claude Code - Troubleshoot installation, официальная документация - конфликт нескольких установок, which -a claude, права на папку npm, кастомный лончер, зависание claude update
- Claude Code - CHANGELOG на GitHub - список версий и что меняется в каждой сборке, откуда сверять свежий номер
Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

