Как обновить Claude Code: 5 правильных команд и 3 ловушки, из-за которых версия не обновляется

Claude Code обновляется одной командой в терминале. Но работает она только для нативной установки, а таких пользователей большинство. Если ставили через npm, Homebrew или WinGet, понадобится другая команда - иначе версия останется старой. Разбираю все способы по порядку, включая места, где процесс обычно ломается.

Что дает свежая версия

Claude Code развивается быстро: релизы выходят регулярно, каждая сборка приносит багфиксы и новые возможности - улучшенную работу с контекстом, свежие модели, обновленные инструменты. Старая версия означает, что вы работаете с ошибками, которые уже починили, и без функций, которые уже выпустили. Минута на обновление против часов на борьбу с симптомами - математика очевидная.

Сначала определите способ установки

От этого зависит буквально всё. Claude Code ставится пятью путями, у каждого свой сценарий обновления:

• Нативная установка через install.sh на macOS и Linux или PowerShell-скрипт на Windows - обновляется сама в фоне
• npm - команда npm install -g @anthropic-ai/claude-code@latest
• Homebrew на macOS - brew upgrade claude-code
• WinGet на Windows - winget upgrade Anthropic.ClaudeCode
• apt, dnf или apk на Linux - через штатное обновление системных пакетов

Если не помните, как ставили, выполните which claude на macOS или Linux и where claude на Windows. Путь вида ~/.local/bin/claude указывает на нативную установку, путь с node_modules в составе - на npm. Есть путь проще: claude doctor показывает тип установки и общее состояние конфигурации.

claude update: главная команда

Для нативной установки на macOS, Linux и Windows обновления происходят автоматически. Claude Code скачивает новую версию в фоне и применяет её при следующем запуске. В идеальном мире вам вообще ничего не нужно делать - садитесь за машину, а инструмент уже свежий.

Не хотите ждать фоновый цикл - выполните команду вручную:

claude update

Команда проверит наличие свежего релиза и выдаст один из двух ответов: Successfully updated с номером версии либо Claude Code is up to date. После обновления перезапустите сессию: новая версия подхватится со следующего запуска, а текущий процесс продолжит работать на старом коде.

npm: главный подвох в флаге @latest

Для установки через npm правильная команда выглядит так:

npm install -g @anthropic-ai/claude-code@latest

Флаг @latest здесь не украшение, а суть операции. Многие по привычке пишут npm update -g и недоумевают, почему версия не сдвинулась. В обсуждениях на Reddit разработчики называют это главной ловушкой обновления Claude Code.

Причина в семвер-диапазоне: npm update уважает ограничения, записанные при первоначальной установке, и может остаться на текущем релизе, если тот формально вписывается в диапазон. npm install с явным @latest такой ловушки не имеет - он тянет именно последний релиз.

Второй частый случай: npm умеет автообновление, но только если глобальная директория доступна для записи. Если при установке вы использовали sudo и папка принадлежит root, фоновое обновление молча не срабатывает, а ручное падает с ошибкой EACCES. Лечится переносом глобального префикса в домашнюю директорию:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
npm install -g @anthropic-ai/claude-code@latest

После этого добавьте ~/.npm-global/bin в PATH и забудьте о проблемах с правами навсегда. Тот же способ официально рекомендует документация npm.

Homebrew: два канала и cleanup

В Homebrew существуют два пакета, и они следят за разными каналами релизов. claude-code отслеживает стабильную ветку, claude-code@latest - самые свежие сборки. Обновляйте тот, который ставили:

brew upgrade claude-code
# или, если вы на канале latest:
brew upgrade claude-code@latest

Какой именно у вас установлен - покажет brew list | grep claude. И периодически запускайте brew cleanup: Homebrew хранит старые версии на диске, и за пару месяцев они незаметно съедают несколько гигабайт.

WinGet: закройте Claude Code перед обновлением

На Windows команда одна:

winget upgrade Anthropic.ClaudeCode

Нюанс, на котором спотыкаются практически все при первом обновлении: запущенный Claude Code Windows блокирует как исполняемый файл, и апгрейд падает с ошибкой. Закройте все окна и терминалы с активными сессиями, затем запускайте winget. Результат проверяется через winget list.

Linux-пакеты: ничего экзотического

Если Claude Code установлен через apt, dnf или apk, он обновляется как любой другой пакет системы. sudo apt update с последующим upgrade, dnf upgrade, apk upgrade - стандартный сценарий, отдельных команд для Claude Code не существует. Автообновления в этом случае тоже нет: версия движется только вместе с общим апгрейдом системы.

Проверка версии и перезапуск

После любых манипуляций алгоритм одинаковый. Сначала узнайте текущую версию:

claude --version

Затем обновитесь подходящим способом и проверьте версию снова. Номер совпал с последним релизом - можно работать. Не совпал - перезапустите терминал: если старая версия висела в памяти процесса, новая подхватится только после перезапуска.

Если обновление не проходит

Три сценария из практики, покрывающие почти все жалобы.

Первый: claude update говорит, что всё обновлено, а claude --version показывает старый номер. Классический симптом нескольких установок на одной машине: нативная версия и npm-версия живут параллельно, и в PATH стоит не та. Выполните which claude и удалите лишнюю копию.

Второй: ошибка EACCES при npm-обновлении. Директория глобальных пакетов недоступна для записи, обычно из-за установки через sudo. Самое чистое решение - сменить префикс npm на папку внутри домашней директории, как показано выше, и переустановить пакет.

Третий: winget ругается на заблокированный файл. Закройте Claude Code полностью, включая фоновые процессы в диспетчере задач, и повторите команду.

В спорных случаях выручает claude doctor - встроенная диагностика, которая показывает тип установки, путь до бинарника и состояние автообновлений. Одна строка в терминале экономит десятки минут гаданий.

Отдельная боль: доступ к моделям Claude из России

Обновить Claude Code - половина дела. Вторая половина в том, что доступ к моделям Claude из России напрямую не работает: нужен зарубежный аккаунт, иностранная карта для подписки и VPN, который не отваливается посреди рабочей сессии. Каждый, кто собирал эту конструкцию вручную, знает, сколько времени уходит на её поддержку.

Я в итоге перешел на 3GPT от 3SELLER. ИИ-роутер дает прямой доступ из России к флагманским моделям: Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Chat GPT 6 Astra, Chat GPT 5.5, Chat GPT 6.1 Sol. Плюс Nano Banana для создания изображений и генерация видео. Без VPN и иностранных карт - баланс пополняется российской картой, через СБП или криптой, старт от 149₽.

Использую для повседневных задач в бизнесе и работе: продающие тексты, сайты, реалистичная обработка изображений, видеоролики, генерация голоса - всё в одном интерфейсе.

Готовые ИИ-агенты под ваши задачи

Отдельная фишка 3GPT - библиотека готовых ИИ-агентов. Выбираете агента под свою задачу и сразу начинаете с ним работать. Модель меняется прямо в чате, без пересоздания диалога. Для рутинных сценариев - тексты, анализ, обработка запросов - это заметно быстрее, чем каждый раз собирать промпт с нуля.

Получить доступ ко всем флагманским моделям нейросетей из России можно на официальном сайте 3GPT.

Что сделать прямо сейчас

Выполните claude --version и запомните номер. Затем claude update, если ставили нативно, или команду под ваш пакетный менеджер из списка выше. Снова проверьте версию и перезапустите сессию. Вся процедура занимает меньше минуты, а экономит часы: свежие версии стабильнее, быстрее и умеют то, чего в старых просто нет.