Claude Code Update: как обновить клиент и проверить Relay
Для Claude Code Update сначала определите способ установки. Встроенное обновление запускают командой claude update; установку Homebrew или WinGet обновляют соответствующим менеджером. После обновления проверьте версию, затем короткий запрос через Relay. Ключ Relay и базовый адрес Messages API относятся к подключению модели, а обновление меняет сам клиент.
Как выполнить Claude Code Update для своей установки?
До изменений выполните claude --version и claude doctor. На macOS и Linux команда type -a claude покажет найденные оболочкой варианты запуска; в PowerShell используйте Get-Command claude -All. Сопоставьте путь с тем способом, которым устанавливали программу.
| Установка | Как обновить |
|---|---|
| Самостоятельная установка Claude Code | claude update |
Homebrew, пакет claude-code | brew upgrade claude-code |
| WinGet | winget upgrade Anthropic.ClaudeCode |
Если использовали другой пакет или способ установки, возьмите команду из официального руководства по обновлению. Не устанавливайте второй экземпляр поверх первого ради обновления. После завершения запустите claude --version в новом терминале и сравните результат с исходным.
Какие настройки Relay записать до обновления?
Зафиксируйте адрес, ID основной модели и имена переменных, через которые процесс получает ключ. Сам секрет в заметку не копируйте. Если используются отдельные модели для вспомогательных задач, выпишите их тоже: проверка только основного вызова не покажет ошибку фонового запроса.
У Relay для Anthropic Messages базовый адрес https://relay-llm.ru, без /v1. Полный маршрут запроса: /v1/messages. Значение https://relay-llm.ru/v1 предназначено для OpenAI-совместимого SDK и здесь может привести к удвоенному пути.
Сверьте выбранные ID с каталогом. Например, claude-sonnet-5 и claude-opus-5-5 поддерживают Messages. Название модели в интерфейсе и API-идентификатор могут различаться: переносите ID целиком, включая дефисы.
Не сохраняйте личный ключ в отслеживаемом файле проекта. Если делаете резервную копию пользовательской конфигурации, проверьте, не содержит ли она секретов, прежде чем отправлять её коллеге или прикладывать к задаче.
Как отделить ошибку клиента от ошибки API?
Сначала выполните прямой запрос. Он обходит настройки Claude Code и проверяет ключ, модель и маршрут Relay. В окружении должен быть задан RELAY_API_KEY.
: "${RELAY_API_KEY:?Задайте RELAY_API_KEY}"
curl --silent --show-error --include \
"https://relay-llm.ru/v1/messages" \
-H "x-api-key: $RELAY_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
--data '{
"model": "claude-sonnet-5",
"max_tokens": 64,
"messages": [{"role": "user", "content": "Ответь одним словом: готово"}]
}'Если ответ успешен, ключ и короткий Messages-запрос работают. Это ещё не проверка инструментов, разрешений и вспомогательных моделей Claude Code. Если прямой вызов не прошёл, разберите его статус до изменения клиентской конфигурации. Контракт описан в Messages API.
Как проверить Claude Code после обновления?
Для проверки в Bash или Zsh задайте подключение в текущем терминале. Пример использует ключ из уже подготовленного окружения; значение секрета в команду не вписывается.
: "${RELAY_API_KEY:?Задайте RELAY_API_KEY}"
export ANTHROPIC_BASE_URL="https://relay-llm.ru"
export ANTHROPIC_AUTH_TOKEN="$RELAY_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude -p "Ответь одним словом: готово"Параметры подключения сверяйте со страницей интеграции Claude Code, а команды клиента с его справочником CLI. Если клиент запущен через IDE, оболочку-обёртку или другой терминал, он может получить другое окружение. Меняйте настройки именно у того процесса, который делает запрос.
После короткого ответа проверьте небольшую рабочую задачу в тестовом репозитории. Например, попросите прочитать один несекретный файл и объяснить функцию. Затем отдельно проверьте создание патча с обычными для команды разрешениями. Успешный ответ на текстовый вопрос не доказывает работу файловых инструментов.
Почему версия обновилась, а запросы перестали работать?
| Симптом | Следующая проверка |
|---|---|
| Показывается старая версия | Сравнить пути запуска в новом терминале |
| cURL работает, клиент нет | Проверить окружение и переопределения клиента |
| HTTP 401 | Убедиться, что процесс получил действующий ключ |
| HTTP 404 | Проверить путь и точный ID модели |
| HTTP 402 | Различить баланс и лимит ключа по ответу |
Ошибки Messages имеют формат Anthropic: используйте HTTP-статус, error.type и идентификатор запроса. Поле error.code этого формата не предусмотрено. Для обращения сохраните x-request-id, время и ID модели, но не заголовок с ключом. Правила повторов приведены в справочнике ошибок.
Перед первым большим заданием задайте лимиты отдельному ключу Claude Code в кабинете. Все личные ключи тратят общий баланс; пополнение не восстанавливает исчерпанный лимит ключа. После теста сравните модели и результаты вызовов в журнале, чтобы заметить неожиданные фоновые запросы.
Claude Code Update требует нового API-ключа?
Само обновление не требует перевыпуска ключа Relay. Сначала проверьте передачу существующего секрета в новый процесс.
Нужно ли добавлять /v1 в ANTHROPIC_BASE_URL?
Нет. Для Relay укажите https://relay-llm.ru; клиент добавляет путь Messages API.
Почему прямой запрос работает, а Claude Code нет?
Сравните окружение, модель и переопределения клиента. Затем проверьте отдельные вспомогательные вызовы и разрешения инструментов.
Что делать при нескольких установках claude?
Определите, какой путь запускается, и обновляйте соответствующую установку. Не удаляйте конфигурацию и ключи ради исправления PATH.