Снимок документации · CLI 7.30.1 · SDK 2.6.53. Desktop использует среду выполнения из собственного выпуска. Команды и примеры сохранены из английского оригинала. Английский оригинал

Подключение первого поставщика моделей

Выбор подключения

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

В интерфейсе терминала введите /connect и выберите один из путей ниже. У Desktop собственные настройки и встроенная среда выполнения; эти команды с косой чертой относятся к терминалу.

Облачный API: выберите API Cloud Provider, нужный сервис и следуйте запросам учётных данных. Подписка на чат не обязательно включает доступ к API или средства на его использование.
CLI для программирования: сначала установите поддерживаемую CLI и войдите в неё, затем выберите CLI Provider. AX Code использует этот локальный вход; возможности зависят от адаптера.
Локальная модель: запустите Ollama или LM Studio, загрузите модель с вызовом инструментов, затем выберите Local LLM runtime и подтвердите адрес. AX-Engine runtime предлагает собственную настройку и загрузку моделей на поддерживаемых Mac.
Шлюз: для адреса AX Trust выберите AX Trust, для другого шлюза — API Cloud Provider → Custom API provider, для выделенного совместимого развёртывания — Private GPU cloud. Укажите URL сервиса, токен и точные опубликованные идентификаторы моделей.

Проверка подключения

Выполните команды в интерактивном терминале. Команда входа запросит поставщика и учётные данные; не вставляйте настоящие ключи в общие команды или файлы репозитория.

ax-code providers login
ax-code providers list
ax-code models

Должны появиться поставщик и доступные идентификаторы моделей. Сохранённые данные или успешное получение списка сами по себе не подтверждают право на инференс. Перейдите к выбору модели и отправьте небольшой тестовый запрос.

Управление учётными данными и настройками

Используйте /providers для управления подключениями и /connect для замены ключа. Отключение активности сохраняет учётные данные, разрыв подключения удаляет их из хранилища. Переменные окружения и настроенные ключи всё ещё могут давать доступ.

Используйте проектный ax-code.json для общих несекретных настроек, а глобальный ~/.config/ax-code/ax-code.json — для личных значений по умолчанию. Не храните секреты в системе контроля версий; используйте запрос учётных данных или ссылки на окружение из руководства по шлюзам. После ручных изменений перезапустите программу.

Если настройка не удалась

Ошибка аутентификации: убедитесь, что ключ относится к выбранным сервису, адресу и тарифу API. Для CLI сначала проверьте её собственный вход.
Пустой список или отказ соединения: проверьте запуск локального сервера, загрузку модели, URL и порт. Ollama обычно использует http://localhost:11434/v1, LM Studio — http://localhost:1234/v1.
Модель отклонена: используйте точный идентификатор от сервиса и проверьте права аккаунта. Название в шлюзе может отличаться от идентификатора, передаваемого вышестоящему сервису.
Поставщик отсутствует: проверьте enabled_providers и disabled_providers. Для диагностики установки выполните ax-code doctor; эта команда не проверяет аккаунт поставщика.

Следующие шаги

Каталог поставщиков и способы входа · Собственные шлюзы и частные GPU · Выбор модели · Создание AX Wiki · Главная страница документации