Как обновить Claude Code, откатить версию или полностью удалить

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

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

Проверка версии:

claude --version

Рабочая установка печатает номер версии вида 2.1.211 (Claude Code). Если оболочка отвечает, что команда не найдена, каталог установки не попал в PATH: откройте новое окно терминала и проверьте снова.

Для подробной диагностики есть команда, которая ничего не меняет и не открывает сессию:

claude doctor

Она показывает состояние установки, ошибки в файлах настроек и результат последней попытки обновления. Способ установки определяет все дальнейшие команды:

Если установок несколько (например, нативная и через npm), запускаться может не та, которую вы обновляли. claude doctor сообщает о таких конфликтах, а в документации есть раздел про поиск конфликтующих установок.

Claude CLI update: как обновить Claude Code

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

claude update

После успешного обновления команда сообщает, с какой версии на какую вы перешли, а если версия последняя, пишет, что обновлений нет.

Для остальных способов команды такие:

Homebrew (команда зависит от того, какой пакет вы ставили), WinGet и npm:

brew upgrade claude-code
brew upgrade claude-code@latest
winget upgrade Anthropic.ClaudeCode
npm install -g @anthropic-ai/claude-code@latest

Для npm документация отдельно предупреждает: не используйте npm update -g, он следует исходному диапазону версий и может не довести вас до новейшей, и не запускайте npm install -g через sudo. Для apt, dnf и apk команды обновления вынесены в раздел про Linux-пакеты. Две особенности: Homebrew и WinGet можно заставить обновляться автоматически переменной CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1, а при обновлении через WinGet Windows может блокировать исполняемый файл, пока Claude Code запущен. Закройте его и повторите. Иногда менеджер пакетов получает новую версию с задержкой после уведомления: тогда подождите и попробуйте позже.

Канал обновлений: latest или stable

Параметр autoUpdatesChannel определяет, как быстро вы получаете новое. Значение "latest" (по умолчанию) даёт новые функции сразу, а "stable" выдаёт версию примерно недельной давности и пропускает релизы с серьёзными регрессиями. Задать можно через /config или в файле настроек:

{
  "autoUpdatesChannel": "stable"
}

Это полезно, если вам нужна предсказуемость. С одной оговоркой из документации: вновь вышедшая модель может требовать версию Claude Code новее, чем отдаёт канал stable. Если после выхода новой модели клиент её не принимает или выдаёт ошибку выбора модели, переключитесь на latest и обновитесь. Идентификаторы моделей, которые принимает шлюз, смотрите в GET https://api.zukko.pro/v1/models.

Как откатить версию

Если новая версия сломала рабочий процесс, установите нужную явно. Нативный установщик принимает номер версии:

curl -fsSL https://claude.ai/install.sh | bash -s НОМЕР_ВЕРСИИ

В документации пример идёт с версией 2.1.89; подставьте ту, к которой хотите вернуться. Для Windows PowerShell и CMD есть эквивалентные команды на той же странице. Через npm то же делается так:

npm install -g @anthropic-ai/claude-code@НОМЕР_ВЕРСИИ

Чтобы фоновое обновление не вернуло вас обратно, отключите его. В ~/.claude/settings.json добавьте:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Этот параметр останавливает только фоновую проверку: claude update и claude install продолжат работать. Если нужно закрыть все пути обновления, в том числе ручные, в документации есть переменная DISABLE_UPDATES. После отката выполните claude --version, чтобы убедиться, что вы на нужной версии. Не забудьте позже снять блокировку, иначе пропустите исправления.

Как полностью удалить Claude Code

Удаление в два этапа: программа, затем настройки.

Шаг 1. Удалить программу

Нативная установка на macOS, Linux и WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Остальные способы:

brew uninstall --cask claude-code          # или claude-code@latest
winget uninstall Anthropic.ClaudeCode
npm uninstall -g @anthropic-ai/claude-code

Для apt, dnf и apk, кроме удаления пакета, документация просит убрать запись о репозитории, и команды там расписаны отдельно. После удаления проверьте, что claude больше не запускается. Если запускается, у вас осталась вторая установка или псевдоним (alias) в оболочке.

Шаг 2. Удалить настройки и историю (по желанию)

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

Если решили стереть всё, на macOS, Linux и WSL:

rm -rf ~/.claude
rm ~/.claude.json

Настройки проекта удаляются из его каталога:

rm -rf .claude
rm -f .mcp.json

Проверьте путь перед нажатием Enter: rm -rf удаляет без возврата. Есть и нюанс: расширения VS Code и JetBrains и десктопное приложение тоже пишут в ~/.claude/. Пока любое из них установлено, каталог появится снова. Для полного удаления сначала уберите их.

Как не потерять подключение к шлюзу

Подключение Claude Code к Zukko состоит из трёх переменных: ANTHROPIC_BASE_URL=https://api.zukko.pro (без /v1), ANTHROPIC_AUTH_TOKEN с вашим ключом fetch_... и ANTHROPIC_MODEL. Где они лежат, определяет судьбу настроек:

• В профиле оболочки (~/.zshrc, ~/.bashrc): удаление программы их не трогает, переустановка подхватит их сразу.
• В блоке env файла ~/.claude/settings.json: шаг 2 удалит файл вместе с ключом.

Перед чисткой сохраните параметры подключения. Полный ключ при создании показывается один раз, поэтому держите его в менеджере паролей, а не только в файле Claude Code. Если ключ потерян, создайте новый в кабинете↗ и отзовите старый. После переустановки восстановить подключение можно блоком:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Не кладите такой файл в репозиторий и не копируйте его в облачные заметки. Проверка после установки: запустите claude, отправьте короткий вопрос и убедитесь, что в разделе «Использование» кабинета появилось списание. Если Claude Code снова просит войти в аккаунт Anthropic, разберитесь по статье «Claude Code просит логин Anthropic»↗. Полная настройка с нуля описана в инструкции по Claude Code↗ и в статье «Claude Code: настройка с нуля»↗, для Windows есть отдельная статья↗.

Частые вопросы

Как узнать, что обновление прошло?

Выполните claude --version. Команда claude update тоже сообщает, с какой версии на какую вы перешли, а claude doctor показывает результат последней попытки автообновления.

Обновление сбросит мои настройки?

Обновление программы настройки не трогает: они лежат в ~/.claude/, ~/.claude.json и вашем профиле оболочки. Стираются они только если вы сами удалите эти файлы.

Что делать, если после удаления команда claude всё равно запускается?

Значит, установлена ещё одна копия или есть псевдоним в оболочке. Выполните claude doctor и поищите конфликтующие установки по инструкции в документации.

Нужно ли обновляться при выходе новой модели?

Не всегда. Но если клиент не принимает новую модель, а вы сидите на канале stable или на отключённом автообновлении, обновитесь до последней версии.