Как обновить Claude Code до последней версии в 2026 году

Claude Code получает обновления очень часто. В новом changelog появляются команды, исправления ошибок и улучшения скорости. Но если в терминале установлена сборка двухнедельной давности, часть этих изменений у тебя недоступна. При этом программа запускается как обычно и не сообщает, что версия устарела, поэтому причину отсутствующей функции легко не заметить.

В этой инструкции разберём, как посмотреть установленную версию, обновиться и устранить проблемы, если обновление не устанавливается. Команды взяты из официальной документации Claude Code; их актуальность проверялась в начале сентября 2026 года. На тот момент последней опубликованной была версия 2.1.261, но у тебя номер может отличаться. Ориентируйся на актуальность установки, а не на конкретное значение.

Сведения об использовании Ailoot собраны в документации.

Как быстро обновить 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. Если обновление не удалось, команда покажет сведения об этом.

При установке через пакетный менеджер — Homebrew в macOS, WinGet в Windows, apt или dnf в Linux — фоновое обновление не выполняется. В таком случае используй команду обновления соответствующего менеджера; она приведена ниже.

Как вручную обновить 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_CODE_PACKAGE_MANAGER_AUTO_UPDATE значение 1. Тогда Claude Code будет обновляться в фоне через Homebrew и WinGet и после успешного обновления предложит перезапустить программу. В официальной документации есть уточнение: уведомление о новой версии может появиться раньше, чем эта версия станет доступна в пакетном менеджере. Если команда не находит обновление, подожди немного и запусти её повторно.

Подробная инструкция по выбору способа установки приведена в материале об установке Claude Code.

Почему Claude Code не обновляется и как это исправить?#

Если после обновления команда claude --version по-прежнему показывает старый номер, проверь наиболее распространённые причины.

Сначала выясни, не установлено ли несколько копий Claude Code. Такое бывает, если сначала программа была поставлена через npm, а затем — через нативный установщик. Обновляется одна копия, а терминал запускает другую, поэтому номер версии не меняется. Найти все доступные команды можно так:

which -a claude

Claude 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 doctor перечисляет, что следует исправить. Нативная установка записывает файлы в домашнюю папку пользователя и не требует этих прав.

Проблема также может быть связана с заменой запускающего файла ~/.local/bin/claude пользовательским скриптом или символической ссылкой. С версии 2.1.207 обновление оставляет его на месте: новые версии появляются в ~/.local/share/claude/versions/, но запуск определяет ваш скрипт. Не удаляй единственную команду, чтобы сразу вызвать claude update по имени. Сначала сохрани скрипт, а для ссылки — и её цель в отдельном свободном месте резервирования. Перемещай прежний launcher только после проверки копии. Восстанови нативный launcher официальным установщиком, которому не нужна существующая команда claude:

# Официальный нативный установщик для macOS, Linux или WSL
curl -fsSL https://claude.ai/install.sh | bash

После установки открой новый терминал и проверь результат:

claude --version
claude doctor

Первая команда должна показать номер версии. Перед продолжением изучи предупреждения doctor о launcher и PATH. Не удаляй сохранённый прежний файл, пока замена не заработает.

Если 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 разобраны в отдельном материале — как не потерять аккаунт Claude.

С чего начать?#

Выполняй действия по порядку:

1. Проверь установленную версию командой claude --version и сравни её с последним номером в changelog.
2. Запусти обновление: для нативной установки — claude update, для Homebrew — brew upgrade claude-code, для WinGet — winget upgrade Anthropic.ClaudeCode.
3. Перезапусти сессию Claude Code, чтобы применить новую версию.
4. Если номер не изменился, выполни claude doctor и which -a claude. Возможные причины — несколько установок или отсутствие прав на запись в папку npm.
5. Выбери канал обновления: latest для немедленного получения новых функций или stable для большей предсказуемости. Канал меняется через /config.

Новая версия исправляет ошибки и добавляет команды, но сама по себе не создаёт проект. Разбор отличий Claude Code от других терминальных агентов и условий, при которых стоит рассмотреть альтернативы, приведён в статье об аналогах Claude Code.

Познакомься с Ailoot.