К содержимому
Блог

Claude Code Update: как обновить клиент и проверить Relay

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 Codeclaude update
Homebrew, пакет claude-codebrew upgrade claude-code
WinGetwinget 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.

bash
: "${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 задайте подключение в текущем терминале. Пример использует ключ из уже подготовленного окружения; значение секрета в команду не вписывается.

bash
: "${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.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.