Настройка Claude Code¶

Claude Code обращается к Nexus по протоколу Anthropic Messages. Достаточно одного ключа Nexus. Положите его в отдельное окружение, чтобы обычный вход Claude не менялся.

Общий порядок — на странице подключения клиентов.

Значения¶

Поле	Значение
Базовый URL	`https://api.nexus-hub.tech`
Протокол	Anthropic Messages
Маршрут	`POST /v1/messages`
Переменная ключа	`ANTHROPIC_AUTH_TOKEN` или `ANTHROPIC_API_KEY`
Заголовок версии	`anthropic-version: 2023-06-01`

Не добавляйте /v1 к базовому URL. Claude Code сам дописывает /v1/messages. ANTHROPIC_AUTH_TOKEN уходит как Authorization: Bearer. ANTHROPIC_API_KEY уходит как x-api-key. Для одной записи укажите одну переменную, не обе.

Первая проверка в оболочке¶

export ANTHROPIC_BASE_URL="https://api.nexus-hub.tech"
export ANTHROPIC_AUTH_TOKEN="your_nexus_key"

Запустите Claude Code в этой оболочке и отправьте короткий запрос. Команда /status должна показать этот базовый URL и что ключ взят из ANTHROPIC_AUTH_TOKEN.

Чтобы настройка сохранилась¶

Когда короткая проверка прошла, запишите те же переменные в ~/.claude/settings.json. Этот файл действует для всех проектов. В Windows путь %USERPROFILE%\.claude\settings.json.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.nexus-hub.tech",
    "ANTHROPIC_AUTH_TOKEN": "your_nexus_key"
  }
}

Не кладите ключ в .claude/settings.json проекта. Этот файл попадает в репозиторий. Значение в блоке env файла настроек важнее одноимённого экспорта оболочки.

Если вместо токена вы используете ANTHROPIC_API_KEY, не задавайте ANTHROPIC_AUTH_TOKEN.

Модель¶

Возьмите id из GET /v1/models для этого ключа. Claude Code может прочитать этот список у Nexus и показать его в /model.

ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL задавайте только точным id из этого списка. Если хватает /model, оставьте их пустыми.

Проверка¶

Отправьте короткое сообщение. Обычный ответ значит, что подключение работает. Подсчёт токенов идёт на POST /v1/messages/count_tokens с тем же базовым URL и тем же заголовком версии.

Если не работает¶

401 или invalid_key: один ключ, без лишних пробелов и без приставки Bearer внутри переменной.
model_not_found или model_not_allowed: этого id нет в GET /v1/models для ключа.
unsupported_model: id виден, но на Messages не разрешён. Выберите другой id.
Неверный адрес: база — https://api.nexus-hub.tech, без /v1.
Экспорт оболочки как будто не действует: применяется блок env файла настроек.

В поддержку отправьте маршрут, код ошибки, время и x-request-id. Ключ и полный текст запроса не отправляйте.

Официальная справка: Connect Claude Code to an LLM gateway.