Подключение без настройки с нуля

Claude Code — ручная настройка

Ручная инструкция; документация проверена 2026-10-03. Совместимость Avlumo с конкретной версией клиента, моделью и ОС не подтверждена; проверки native T02/T03 не пройдены. URL ниже — запланированные адреса Avlumo, а не проверенные рабочие API. Помощник не устанавливает клиенты, не принимает ключ, не загружает рабочий каталог моделей, не меняет настройки установленных клиентов и не выполняет запросы к модели. Отдельный синтетический сценарий Linux preview/apply/restore доступен через guide workflow и не доказывает работу установленного клиента.

MODEL_ID — заполнитель, а не рекомендованная модель. Заменяйте его только на опубликованную модель, разрешённую для вашего доступа и отдельно проверенную с этим клиентом и протоколом. Если этих сведений нет, остановитесь до платного запроса. Используйте существующий ключ: настройка не меняет доступ, купленный лимит, ценовой профиль или правила исходного канала. Для чтения инструкции не нужны новый аккаунт или покупка.

1. Требования и способ запуска для ОС

Нужен установленный Claude Code CLI с версией, поддерживаемой его инструкцией для ОС: shell в macOS/Linux; PowerShell для нативной Windows либо shell внутри WSL. Выполните требования именно этой версии, не предполагая одинаковую поддержку функций. Помощник не устанавливает Claude Code и не меняет ограничения исполнения ОС.[4]

2. Где настраивать и что сохранить

Для первой настройки используйте отдельный терминал. Документированные постоянные настройки CLI находятся в ~/.claude/settings.json (Windows %USERPROFILE%\.claude\settings.json), в блоке env; управляемые настройки могут иметь приоритет. Файл проекта не является безопасным местом для ключа по умолчанию. У CLI, расширения редактора и настольного приложения разные пути настройки; здесь рассматривается только CLI.[23]

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

3. Протокол, base URL и модель

Запланированный base URL — https://api.avlumo.com **без** /v1: Claude Code добавляет /v1/messages. Нужен Anthropic Messages с ожидаемыми заголовками, полным потоковым выводом и семантикой инструментов, а не просто OpenAI API. Укажите опубликованный совместимый MODEL_ID явно. Расширенный поиск MCP-инструментов, псевдонимы, малые и фоновые модели требуют отдельной проверки; нельзя молча переназначать их на произвольную модель.[24]

{"env":{"ANTHROPIC_BASE_URL":"https://api.avlumo.com"}}

Это иллюстративный фрагмент без секрета: объединяйте только добавляемое поле с нужной областью настроек, не заменяя существующий блок env.

4. Локальный ввод ключа

Для bearer-ключа шлюза документирована переменная ANTHROPIC_AUTH_TOKEN; ANTHROPIC_API_KEY использует x-api-key. Не задавайте обе наугад и не удаляйте существующий вход или helper. До отправки проверьте выбранный способ авторизации Avlumo.[23] В отдельном **Bash** (при zsh сначала запустите bash) или Windows PowerShell скрытый локальный ввод исключает литерал ключа из истории команд и argv:

export ANTHROPIC_BASE_URL='https://api.avlumo.com'
read -r -s -p 'Avlumo API key: ' ANTHROPIC_AUTH_TOKEN
printf '\n'
export ANTHROPIC_AUTH_TOKEN

$env:ANTHROPIC_BASE_URL = 'https://api.avlumo.com'
$localKey = Read-Host 'Avlumo API key' -AsSecureString
$env:ANTHROPIC_AUTH_TOKEN = [System.Net.NetworkCredential]::new('', $localKey).Password
$localKey = $null

Значение получают только этот процесс и его потомки; не записывайте его в глобальные переменные ОС, хранилище браузера или отслеживаемый файл. Закройте отдельный терминал для удаления временных настроек. Для постоянного хранения используйте проверенный credential helper или приватную пользовательскую область клиента без ключа в копируемых командах.

5. Проверка: бесплатно или с оплатой

Бесплатные локальные проверки: прочитать инструкцию, осмотреть несекретные настройки и выбранные модель с провайдером. avlumo-setup doctor только собирает сведения о локальной машине: он не проверяет ключ и не доказывает работу сети, модели или инструментов. Запуск клиента, получение моделей и кнопки Verify/Test connection не обязательно бесплатны или работают без сети. Проверку через авторизованный API можно назвать бесплатной лишь после проверки конкретного маршрута Avlumo и его тарификации; этот выпуск таких запросов не делает.

Необязательный реальный запрос, цикл инструментов или потоковый тест оплачивается и может вызвать фоновые модели либо повторы. Выполняйте его только после активации доступа, прохождения native-проверок и проверки совместимости клиента с моделью, явно приняв тариф и ограниченный бюджет, при опубликованной модели. Используйте временный проект без секретов, сохраните ограничения на подтверждение действий и затем сравните единственный купленный лимит с фактическим расходом. Не отправляйте приватные файлы и ключ в тестовом запросе. Здесь ни один платный тест не выполнен.

После явного разрешения сетевой активности клиента claude --model MODEL_ID запускает выбранный сеанс, а /status показывает маршрут и источник ключа; это проверка настройки, а не доказательство оплаченного инференса. Не прикладывайте отладочный журнал с секретами. Последующий реальный запрос является отдельно оплачиваемым тестом.[23]

claude --model MODEL_ID
/status

6. Отмена, ошибки и ограничения

Перед отменой изменений остановите соответствующий сеанс клиента. Верните прежний выбор и удалите только добавленные вами поля и учётные данные Avlumo поддерживаемым способом. Сравните текущий файл с приватной копией и записью изменений: если вы или клиент правили его позже, объедините точечную отмену с новыми правками, а не перезаписывайте файл. Сохраните остальные изменения, провайдеры, ключи, MCP, плагины, навыки, хуки и права. Не удаляйте весь каталог настроек, не сбрасывайте клиент, не отзывайте общий ключ Avlumo ради отмены локального параметра и не восстанавливайте старый файл поверх новых правок. Автоматическое резервное копирование/восстановление установленного клиента не включено. Синтетический сценарий Linux — отдельно; см. guide workflow.

При 401 проверьте источник ключа и состояние исходного доступа локально, не передавая ключ. Если модель или протокол недоступны, проверьте опубликованные сведения о совместимости, а не угадывайте другой псевдоним. Ключ подготовленного товара с ожидаемой активацией не разрешает инференс. Недостаток лимита или сбой исходного канала не разрешают прямую оплату, преобразование аккаунта или другой канал поддержки. Используйте поддержку или пополнение, разрешённые для исходного доступа; передавайте только очищенный номер обращения и версию клиента. Потоковый вывод, инструменты, контекст, повторы, фоновые модели, серверные инструменты и списания требуют отдельной проверки.

Sources

[4] https://code.claude.com/docs/en/setup [23] https://code.claude.com/docs/en/llm-gateway-connect [24] https://code.claude.com/docs/en/llm-gateway-protocol