Как обновить Claude Code и починить зависшее обновление
Команда claude update, проверка версии, обновление при установке через пакетные менеджеры и все поверхности, которые обновляются отдельно — кадры взяты из официального демо.
Коротко
- Нативная установка (curl или PowerShell-скрипт) обновляет Claude Code сама в фоне — остается перезапустить, чтобы применить.
- Нужно прямо сейчас? Запустите claude update. Для пакетных менеджеров — brew upgrade claude-code или winget upgrade Anthropic.ClaudeCode.
- Версию показывает claude --version; claude doctor сообщает результат последней попытки обновления.
- Новые функции сначала приходят в терминал, а расширения IDE, десктоп-приложение и веб обновляются по своему графику.
Installing Claude Code (official walkthrough)
Канал: Claude — official YouTube channel3:02
Claude Code Plugins Explained In 7 Minutes
Канал: Software Engineer Meets AI7:21
Set up Claude Code — official docs (updates & channels)
Документация: code.claude.com/docs
Кадры взяты из официального демо и чистой записи экрана; текст шагов следует официальной документации по установке.
Права на скриншоты принадлежат их авторам; у каждого шага есть ссылка на точный таймкод исходного видео.
Обновление Claude Code по шагам
Обновить CLI
- 1
Убедитесь, что у вас нативная установка
Скрипты curl и PowerShell ставят нативную сборку, которая обновляется в фоне: проверка происходит при запуске и периодически во время работы. Если копия стоит из Homebrew, WinGet, apt или npm — автообновление выключено, вам нужен шаг 7.
Нативный установщик в конце показывает версию и путь установки прямо в терминале.Видео с 0:23 - 2
Немедленное обновление: claude update
В любом терминале запустите claude update, чтобы сразу забрать свежую сборку. При успехе команда сообщает, с какой версии вы ушли и на какую встали; если новее нет — просто скажет, что вы на актуальной.
- 3
Проверьте запущенную версию
claude --version печатает точный номер сборки, например 2.1.211. Тот же номер с моделью показывает баннер при старте каждой сессии — обычно достаточно взгляда на него.
Баннер сессии называет запущенную версию — здесь v2.1.87 на Sonnet 4.6.Видео с 5:31 - 4
Тихо не обновляется? Запустите claude doctor
Если автообновление будто зависло, claude doctor выдает диагностику, включая результат последней попытки обновления. Это же первое, что стоит проверить, когда у глобальной папки npm нет прав на запись — классическая причина сбоев обновления.
Выбрать канал обновлений
- 5
Знайте, какая поверхность получает функции первой
Новое всегда сначала приходит в терминал, интеграции с IDE следуют сразу за ним, десктоп и веб — чуть позже. Нужна функция, объявленная на этой неделе? Обновите CLI и работайте из терминала.
В официальном демо терминал, IDE, десктоп и веб сравниваются рядом.Видео с 2:25 - 6
Хотите спокойнее — включите stable-канал
Свежайшие сборки нужны не всем. Поставьте autoUpdatesChannel в stable через /config или settings.json — вы будете ехать на сборке примерно недельной давности, пропуская релизы с серьезными регрессиями.
- 7
Пакетные менеджеры — по вашему расписанию
Установки из Homebrew, WinGet, apt, dnf и npm никогда не обновляются сами. Обновляйте вручную: brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode, команда apt upgrade или npm install -g @anthropic-ai/claude-code@latest. И не используйте npm update -g — документация прямо об этом предупреждает.
Держать все поверхности свежими
- 8
Обновите расширение VS Code
Расширение обновляется через панель расширений VS Code, как любое другое: найдите Claude Code, установите обновление и перезагрузите окно. Расширение управляет тем же бинарником CLI, так что обновляйте оба.
Claude Code for VS Code виден в списке установленных расширений рядом с панелью Claude Code.Видео с 1:07 - 9
Обновите плагин JetBrains
В IDE JetBrains откройте Settings, затем Plugins и Marketplace, найдите Claude Code и установите обновление. Когда предложит — перезапустите IDE, чтобы загрузилась новая версия плагина.
В JetBrains Marketplace у Claude Code стоит отметка Installed рядом с похожими плагинами.Видео с 1:37 - 10
Не забывайте про десктоп-приложение
Десктоп-приложение обновляется собственным встроенным апдейтером, а переключатель Code внутри запускает сессии в папке — с разрешениями и опциональным облачным окружением. Не игнорируйте его предложения обновиться, иначе встроенный CLI отстанет от терминального.
Десктопу в официальном демо отведен отдельный раздел.Видео с 1:50 - 11
Что значит подсказка «перезапустите, чтобы применить»
Фоновые обновления никогда не подменяют бинарник под работающей сессией. Скачанное обновление Claude Code применит при следующем запуске, поэтому просьба перезапуститься — нормальное поведение, а не ошибка. Доделайте задачу, выйдите и запустите снова.
Если обновление не применяется
- 12
Чиним обновление, которое не применяется
Сначала claude doctor — он покажет проблемы с правами, неудавшуюся попытку обновления и подсказки по исправлению. Не помогло? Запустите нативный установщик еще раз, чтобы заменить бинарник на месте, либо загляните в наш гайд по зависаниям и вылетам Claude Code — там разобран весь спектр сбоев.
Команды для версии Claude Code — шпаргалка
Все команды, чтобы проверить, получить или починить версию Claude Code, в одном списке. Выполняются в обычном терминале.
- 1claude --version — печатает точный номер сборки, например 2.1.211.
- 2claude update — сразу обновляет нативную установку и сообщает старую и новую версии.
- 3claude doctor — диагностика установки, включая результат последней попытки обновления.
- 4brew upgrade claude-code — ручное обновление для Homebrew; время от времени запускайте brew cleanup, чтобы убрать старые версии.
- 5winget upgrade Anthropic.ClaudeCode — ручной путь для WinGet; может упасть, пока Claude Code запущен, потому что Windows блокирует исполняемый файл.
- 6DISABLE_AUTOUPDATER=1 в блоке env файла settings.json полностью отключает фоновые проверки обновлений.
Еще две ручки, которые стоит знать: autoUpdatesChannel в stable держит вас примерно на неделю позади свежего релиза, а managed settings организации могут требовать конкретный минимальный или максимальный номер версии на всех машинах.