# Как обновить Claude Code до последней версии в 2026 году > Пошаговая инструкция по проверке версии Claude Code и обновлению через claude update, Homebrew или WinGet, а также диагностике ошибок обновления. Source: https://ailoot.ai/blog/ru/update-claude-code/ Canonical: https://ailoot.ai/blog/ru/update-claude-code/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-130 Revision: sha256-9ad86a1186303a3755a2c88c271348ef9a48403cf0e70c252fd5a695760b2738 Claude Code получает обновления очень часто. В новом changelog появляются команды, исправления ошибок и улучшения скорости. Но если в терминале установлена сборка двухнедельной давности, часть этих изменений у тебя недоступна. При этом программа запускается как обычно и не сообщает, что версия устарела, поэтому причину отсутствующей функции легко не заметить. В этой инструкции разберём, как посмотреть установленную версию, обновиться и устранить проблемы, если обновление не устанавливается. Команды взяты из официальной документации Claude Code; их актуальность проверялась в начале сентября 2026 года. На тот момент последней опубликованной была версия 2.1.261, но у тебя номер может отличаться. Ориентируйся на актуальность установки, а не на конкретное значение. Сведения об использовании Ailoot собраны в [документации](https://ailoot.ai/docs/). ## Как быстро обновить Claude Code до последней версии?
Коротко При установке через нативный установщик Claude Code обновляется автоматически в фоне. Чтобы запустить обновление немедленно, введи в терминале `claude update`. При установке через Homebrew, WinGet или пакетный менеджер Linux обновляться нужно отдельной командой, например `brew upgrade claude-code`. Текущую версию в любой момент покажет команда `claude --version`.
Ниже подробно описаны все варианты. Если времени мало, начни с этих трёх команд: ```bash claude --version # какая версия установлена сейчас claude update # немедленно обновить нативную установку claude doctor # проверить установку и обновления ``` Первая команда выводит номер версии, вторая запускает обновление, а третья помогает выяснить причину сбоя. Дальше объясняется, в каких случаях нужна каждая команда и почему `claude update` иногда не срабатывает. ## Как проверить, какая версия Claude Code установлена?
Коротко Введи в терминале `claude --version`. Команда выведет номер в формате вроде `2.1.211 (Claude Code)` и не запустит сессию. Для проверки состояния установки, проблем в настройках и предупреждений используй `claude doctor`: эта команда тоже работает без запуска сессии.
Перед обновлением проверь, какая версия установлена. Для этого достаточно одной команды: ```bash claude --version ``` В ответ появится строка наподобие `2.1.211 (Claude Code)`. Это номер текущей версии. Сверь его с последним номером в changelog. Если установленная сборка заметно старше, пора обновиться. Для более полной диагностики выполни `claude doctor`. Команда только проверяет состояние и ничего не меняет: она не запускает сессию, но показывает состояние установки, ошибки в файле настроек и предупреждения с рекомендациями. Также там отображается результат последней попытки автоматического обновления — это помогает понять, не завершилась ли фоновая проверка безуспешно. ## Обновляется ли Claude Code автоматически?
Коротко При установке через нативный установщик — скрипт `install.sh` или Windows-скрипт `install.ps1` — Claude Code обновляется автоматически. Программа проверяет обновления при запуске и периодически во время работы, загружает новую сборку в фоне и применяет её при следующем запуске. Установки через Homebrew, WinGet и пакетные менеджеры Linux автоматически не обновляются: для них нужна отдельная команда.
Способ обновления зависит от того, как установлен Claude Code. Нативный установщик, который рекомендует Anthropic и запускает скрипт с сайта, поддерживает автоматическое обновление. Это подтверждает официальная документация.

Нативные установки автоматически обновляются в фоне, чтобы у вас сохранялась последняя версия.

— Документация Claude Code: расширенная настройка, официальный источник
Claude Code проверяет наличие обновлений при запуске и время от времени во время работы. Найденная новая версия загружается и устанавливается в фоне, а начинает использоваться после следующего запуска программы. Поэтому достаточно периодически завершать и заново запускать сессию. Результат последней фоновой попытки можно посмотреть через `claude doctor`. Если обновление не удалось, команда покажет сведения об этом. При установке через пакетный менеджер — Homebrew в macOS, WinGet в Windows, apt или dnf в Linux — фоновое обновление не выполняется. В таком случае используй команду обновления соответствующего менеджера; она приведена ниже. ## Как вручную обновить Claude Code одной командой?
Коротко Выполни `claude update`, чтобы сразу проверить и применить обновление, не дожидаясь фоновой проверки. Если доступна новая версия, появится сообщение об успешном переходе с прежней версии на новую. Если установлена актуальная сборка, команда сообщит `Claude Code is up to date` и укажет её номер. Команда работает с нативной установкой и пакетными менеджерами, однако для Homebrew и WinGet может потребоваться собственная команда менеджера.
Не обязательно ждать, пока фоновая проверка найдёт новую сборку. Запусти обновление вручную: ```bash 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 используй `brew upgrade claude-code`, а в Windows — `winget upgrade Anthropic.ClaudeCode`. В Linux обновление через apt, dnf или apk устанавливается вместе с обычным обновлением системы. Чтобы Claude Code сам запускал обновление через Homebrew и WinGet, задай переменную окружения `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` со значением `1`.
Если Claude Code установлен через пакетный менеджер, а не через скрипт с сайта, обновление нужно запускать самостоятельно. Команды зависят от системы. В macOS с Homebrew: ```bash brew upgrade claude-code ``` Homebrew предлагает два варианта установки Claude Code. Пакет `claude-code` следует стабильному каналу: его версия примерно на неделю старше и в нём пропускаются релизы с серьёзными проблемами. Пакет `claude-code@latest` получает новую сборку сразу после выхода. Выполняй обновление для того пакета, который установлен. Например, для `claude-code@latest` команда будет такой: ```bash brew upgrade claude-code@latest ``` В Windows с WinGet: ```powershell 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](https://ailoot.ai/blog/ru/install-claude-code/). ## Почему Claude Code не обновляется и как это исправить?
Коротко Обычно проблема связана с одной из трёх причин: одновременно установлено несколько копий Claude Code; глобальная папка npm недоступна для записи; пользовательский скрипт заменил запускающий файл. Начни проверку с `claude doctor` и `which -a claude`: эти команды помогут найти место установки и определить причину.
Если после обновления команда `claude --version` по-прежнему показывает старый номер, проверь наиболее распространённые причины. Сначала выясни, не установлено ли несколько копий Claude Code. Такое бывает, если сначала программа была поставлена через npm, а затем — через нативный установщик. Обновляется одна копия, а терминал запускает другую, поэтому номер версии не меняется. Найти все доступные команды можно так: ```bash which -a claude ``` Claude Code может находиться в трёх местах: `~/.local/bin/claude` — нативная установка, `~/.claude/local/` — прежняя локальная установка через npm, а глобальный npm-пакет отображается командой `npm -g ls @anthropic-ai/claude-code`. Если обнаружено несколько копий, оставь одну; предпочтительный вариант — нативный установщик. Удалить лишние можно так: ```bash 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 [официальным установщиком](https://code.claude.com/docs/en/setup#install-claude-code), которому не нужна существующая команда `claude`: ```bash # Официальный нативный установщик для macOS, Linux или WSL curl -fsSL https://claude.ai/install.sh | bash ``` После установки открой новый терминал и проверь результат: ```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` отстаёт примерно на неделю и пропускает релизы с серьёзными проблемами. Выбирай `latest`, если важнее новые возможности, или `stable`, если нужна более предсказуемая версия. Настройка `autoUpdatesChannel` меняется в `settings.json` или через команду `/config`.
Последняя версия не обязательно означает самую свежую сборку, доступную в день её выхода. Claude Code предлагает два канала, от которых зависит, какие обновления ты получишь. Канал `latest` выбран по умолчанию. Новые функции на нём появляются сразу после релиза. В канале `stable` используется версия примерно недельной давности, которая успела пройти дополнительное время проверки; релизы с серьёзными проблемами пропускаются. Такой вариант подойдёт, если предсказуемость важнее немедленного доступа к новым функциям. Канал можно сменить через `/config` внутри Claude Code, выбрав пункт Auto-update channel. Другой способ — задать значение вручную в `settings.json`: ```json { "autoUpdatesChannel": "stable" } ``` Общие параметры персональной настройки Claude Code описаны в материале о [настройке Claude Code](https://ailoot.ai/blog/ru/claude-personalization-profile-memory/). ## Как установить конкретную версию или задать минимальную?
Коротко Нативный установщик позволяет указать канал или точный номер версии. Чтобы установить конкретную сборку, добавь её номер в конец команды, например `bash -s 2.1.89`. Так же можно выбрать канал `stable` вместо `latest`. Минимальную версию для будущих обновлений задаёт параметр `minimumVersion` в `settings.json`: фоновые обновления и `claude update` не установят сборку ниже указанного номера.
Иногда требуется установить определённую версию, например чтобы вернуться к сборке, совместимой с нужным рабочим процессом. Нативный установщик принимает как название канала, так и точный номер версии. Команда для установки конкретной сборки: ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` В Windows PowerShell команда выглядит иначе: ```powershell & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89 ``` Тем же способом можно выбрать стабильный канал: вместо номера версии укажи `stable`. Выбранный при установке канал будет использоваться по умолчанию при последующих автоматических обновлениях. Чтобы ограничить возможный откат, задай в `settings.json` минимально допустимую версию: ```json { "autoUpdatesChannel": "stable", "minimumVersion": "2.1.100" } ``` Параметр задаёт нижнюю границу: ни автоматическое обновление, ни `claude update` не установят версию ниже указанной. Это полезно при переходе на `stable`, если нужно сохранить уже установленную более новую сборку. ## Как отключить автоматические обновления?
Коротко Чтобы выключить фоновые обновления Claude Code, добавь `DISABLE_AUTOUPDATER` со значением `1` в раздел `env` файла `settings.json`. Ручная команда `claude update` при этом продолжит работать. Для блокировки всех способов обновления, в том числе ручного, используй `DISABLE_UPDATES`. Эта настройка может пригодиться, если нужно поддерживать одну версию для всей команды.
Фоновые обновления можно отключить через файл настроек, например если требуется закрепить одну версию для всей команды: ```json { "env": { "DISABLE_AUTOUPDATER": "1" } } ``` Учти, что `DISABLE_AUTOUPDATER` отключает только фоновую проверку. Команда `claude update` остаётся доступной, поэтому обновиться вручную можно. Чтобы запретить все варианты обновления, включая ручной, предусмотрена переменная `DISABLE_UPDATES`. Её используют, когда Claude Code распространяется командой по собственному каналу и участникам нужно сохранить заданную версию. Для индивидуального использования обычно нет необходимости менять эти параметры: новая версия может содержать важные исправления, в том числе безопасности. Вопросы сохранения доступа к аккаунту Claude разобраны в отдельном материале — [как не потерять аккаунт Claude](https://ailoot.ai/blog/ru/claude-account-suspension-appeal/). ## С чего начать?
Коротко Сначала выполни `claude --version` и сравни номер с последним в changelog. Для нативной установки запусти `claude update` и перезапусти сессию. При установке через Homebrew или WinGet используй команду соответствующего пакетного менеджера. Если версия не меняется, выполни `claude doctor` и `which -a claude`, чтобы проверить наличие конфликтующих установок. Для новых функций выбирай `latest`, для большей предсказуемости — `stable`.
Выполняй действия по порядку: 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](https://ailoot.ai/blog/ru/claude-code-alternatives/).
### Источники - [Claude Code: расширенная настройка — официальная документация Anthropic](https://docs.claude.com/en/docs/claude-code/setup) — автоматические обновления нативной установки, команда `claude update`, каналы `latest` и `stable`, параметры `autoUpdatesChannel` и `minimumVersion`, переменная `DISABLE_AUTOUPDATER`, установка определённой версии. - [Claude Code: устранение проблем с установкой — официальная документация Anthropic](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) — несколько конфликтующих установок, `which -a claude`, права на запись в папку npm, пользовательский запускающий файл и зависание `claude update`. - [Claude Code: журнал изменений на GitHub Anthropic](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) — перечень версий и изменений для проверки последнего номера.
Познакомься с [Ailoot](https://ailoot.ai/). ## Вопросы и ответы ### Почему claude update продолжает запускать старую обёртку? Нативное обновление сохраняет пользовательский launcher, поэтому он по-прежнему выбирает программу. Перед исправлением сохрани обёртку и её цель. Используй документированный нативный установщик вместо удаления единственной команды с немедленным её вызовом. ### Как проверить восстановление launcher? Открой новый терминал и выполни claude --version: должен появиться номер версии. Затем через claude doctor проверь установку и предупреждения. Если команда не найдена, сначала исправь PATH. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.