Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Поддерживаемые провайдеры и модели

Статус: активно Область: текущее состояние Последняя проверка: 2026-09-19 Владелец: среда выполнения ax-code

Эта страница перечисляет пресеты провайдеров, которые AX Code показывает в потоках настройки по умолчанию. Источник истины — разрешающий список провайдеров среды выполнения в packages/ax-code/src/provider/default-setup-providers.ts, комплектный снимок моделей в packages/ax-code/src/provider/models-snapshot.json, пресеты локальной среды выполнения в packages/ax-code/src/provider/local-runtime.ts и определения AX Engine в packages/ax-code/src/provider/ax-engine/constants.ts.

Используйте /connect в терминальном интерфейсе или ax-code providers login <provider-id> для интерактивной настройки. Безголовые среды и CI также могут задать перечисленные переменные окружения.

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

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

• Заменить ключ: выберите провайдера в /connect и выберите Заменить ключ либо заново выполните ax-code providers login <provider-id>.
• Временно отключить: выберите Отключить в /providers или /connect либо выполните ax-code providers disable <provider-id>. Это добавляет провайдера в disabled_providers глобальной конфигурации и сохраняет учётные данные. Отключённые провайдеры остаются видны в /providers и в разделе Отключённые в /connect, а включить их снова можно через Включить или ax-code providers enable <provider-id>.
• Отсоединить навсегда: выберите Отсоединить в /providers или /connect либо выполните ax-code providers logout <provider-id> — это удаляет сохранённые учётные данные из auth.json.

Каталоги размещённых моделей входят в каждый выпуск AX Code и отфильтрованы по пригодным возможностям кодирующего агента. Выполните ax-code models <provider-id>, чтобы получить авторитетные идентификаторы моделей установленного выпуска; сырой реестр и скопированные веб-списки могут содержать модели, которые AX Code скрывает, потому что у них нет текстового вывода или вызова инструментов. Пресет провайдера не означает, что каждая модель бесплатна или доступна на каждом аккаунте.

Варианты среды выполнения

Выбор модели без версии

И TUI, и ax-code run принимают эти имена семейств --model без учёта регистра:

Например, ax-code --model glm открывает TUI с GLM Flash, а ax-code run --model qwen -- "Review this change" запрашивает Qwen Flash. Поставьте запрос после -- (или передайте --prompt / --prompt-file); --file прикладывает файлы и не является файлом запроса. ax-code models перечисляет пригодные идентификаторы provider/model. Имена семейств разрешаются через нативного провайдера или подключённый шлюз, который отдаёт ту же модель. Можно также назвать провайдера: --model my-gateway/glm. Используйте полный идентификатор вроде my-gateway/glm-5.3, чтобы запросить конкретную версию или уровень.

Пропуск --model сохраняет настроенный выбор, выбор агента, сессии и недавней модели. Когда пригодного выбора нет, общий порядок запасного варианта начинается с DeepSeek Flash, затем GLM Flash, затем Qwen Flash среди подключённых провайдеров. У настройки провайдера свои значения по умолчанию: Alibaba Coding Plan использует qwen3-coder-plus; Alibaba Token Plan использует qwen3.8-flash.

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

Варианты в /connect идут в порядке облачный провайдер API, провайдер CLI, среда выполнения AX-Engine, локальная среда LLM, частное облако GPU и AX Trust. Среда выполнения AX-Engine сразу открывает выбор локальной модели и управление средой. Локальная среда LLM перечисляет эти варианты по порядку:

Пресеты MTPLX и oMLX доступны в рабочей копии исходников; упакованные двоичные файлы v7.19.3 их не включают. Настройку возможностей инструментов, необязательную аутентификацию и оговорку об общем порте по умолчанию см. в Настройке MTPLX и oMLX.

Запустите локальный сервер, выберите его пункт меню и подтвердите или поправьте конечную точку. AX Code добавляет /v1, если его опустили. «Другие» сохраняет одну настраиваемую конечную точку в local-llm; выберите её снова, чтобы сменить конечную точку. LMStudio и «Другие» используют существующий локальный поток настройки без запроса токена API. LM Studio документирует свою конечную точку списка моделей.

Варианты настройки уважают enabled_providers и disabled_providers. Одно лишь открытие выбора не активирует и не опрашивает эти локальные серверы. Обнаруженные внешние локальные модели сохраняют консервативные возможности по умолчанию; чтобы быть выбираемыми для процессов кодирующего агента, модели должны поддерживать вызов инструментов.

Облачные провайдеры API

Эти провайдеры вызывают размещённые API или конечные точки размещённых планов аккаунта.

MiniMax переименовал Coding Plan в Token Plan. Идентификаторы провайдеров остаются minimax-coding-plan / minimax-cn-coding-plan, чтобы совпадать с models.dev и OpenCode. Используйте ключ Token Plan (sk-cp-…) с platform.minimax.io (международный) или platform.minimaxi.com (Китай).

huggingface — это размещённый маршрутизатор Serverless Inference Providers (https://router.huggingface.co/v1). Он не связан с локальным кэшем снимков Hugging Face, которым AX Engine хранит скачанные локальные модели: подключение huggingface никогда не запускает локальный движок и не требует его.

Первый запуск без платы см. в Быстром старте API бесплатного уровня. Он отличает бесплатное предложение провайдера от совместимости AX Code и объясняет, почему внешний каталог бесплатных API сам по себе не матрица поддержки.

Grok поддерживается только через провайдера grok-build-cli, перечисленного ниже. В AX Code больше нет прямого облачного провайдера API xai; существующие учётные данные API Grok соединение не создают.

github-copilot — мост аккаунта GitHub Copilot. Это не отдельный API github-models, который перечисляют некоторые каталоги бесплатных API.

Шлюзы, совместимые с OpenAI и Anthropic, тоже поддерживаются через конфигурацию пользовательского провайдера. См. Пользовательских провайдеров и шлюзы.

Частное облако GPU

Эти провайдеры появляются в /connect в разделе Частное облако GPU, после локальной среды LLM.

Выберите Пользовательский провайдер, чтобы подключить собственную конечную точку GPU, совместимую с OpenAI. Введите её URL и ключ API; AX Code обнаруживает модели из /v1/models и хранит ключ в зашифрованном хранилище аутентификации. Сохранённое соединение остаётся в частном облаке GPU. Выберите его снова, чтобы выбрать модель, заменить конечную точку или отсоединиться. Эта запись хранит одну настраиваемую конечную точку в custom-private-gpu.

Каталог (ключ API)

Размещённые каталоги GPU в стиле OpenCode. Модели берутся из комплектного снимка models.dev. Подключайтесь ключом API.

Размещённый маршрутизатор Hugging Face (huggingface / HF_TOKEN) остаётся в облачных провайдерах API. Выделенные конечные точки Hugging Face Inference Endpoints перечислены ниже.

Выделенные (URL и токен)

Выделенные конечные точки GPU в стиле PAI. Вставьте URL, совместимый с OpenAI, и токен; AX Code вызывает GET …/models и использует идентификаторы развёрнутых моделей. Это не провайдеры Alibaba Coding Plan / Token Plan (DashScope).

sagemaker предназначен для URL, совместимого с OpenAI, перед SageMaker (vLLM / TGI / API Gateway). Он не подписывает AWS SigV4.

AX Trust

AX Trust — последняя категория в /connect, после частного облака GPU. Выберите Подключить AX Trust, введите базовый URL шлюза, включая /v1, и укажите ключ API клиента. AX Code обнаруживает модели шлюза и хранит ключ в зашифрованном хранилище аутентификации. Сохранённые соединения предлагают выбор модели, обновление конечной точки, обновление моделей и удаление.

Повторное подключение существующего URL сохраняет его идентификатор провайдера, модели и сохранённый ключ, если токен оставлен пустым. Провайдер остаётся в AX Trust даже с пользовательским именем. Устаревшие идентификаторы ax-trust и ax-trust-* тоже появляются в этой категории. AX Trust по-прежнему владеет политикой шлюза, одобрениями и аудитом. По умолчанию AX Code посылает на этих соединениях заголовок привязки сессии.

Провайдеры CLI

Провайдеры CLI переиспользуют локальный вендорский CLI и его вход или сессию вместо хранения размещённого ключа API в AX Code.

Сначала выполните вход вендорского CLI, если он требуется, затем ax-code providers login <provider-id>. AX Code опрашивает команду CLI и после успешной пробы сохраняет локальную метку учётных данных.

Для Muse Code установите локальный двоичный файл muse, выполните muse login (или задайте META_API_KEY), затем ax-code providers login muse-cli. AX Code переиспользует сессию Muse CLI (~/.config/muse), а не хранит размещённый ключ API Meta. Размещённый провайдер API meta остаётся отдельным соединением.

Размещённый MiniMax Token Plan остаётся доступен как minimax-coding-plan / minimax-cn-coding-plan. Комплектного провайдера MiniMax Code CLI или Kimi Code CLI нет.

Локальный провайдер AX Engine

ax-engine — встроенный провайдер локального вывода. Он доступен только на подходящих Mac с Apple Silicon и предлагает только пакеты разработки AutomatosX Tiel Coder и Cyber-Tiel Coder 35B A3B MXFP4 MTP. Нативные возможности проверяются при запуске модели.

Qwen3.8 27B, Ornith, Qwen3-Coder-Next и все прочие репозитории исключены из управляемого выбора. Исторические записи остаются читаемыми для статуса и очистки.

Локальная модель по умолчанию — tiel-coder-35b-axq-mxfp4. Точные выбранные репозитории, память и рекомендации по диску см. в Выборе модели AX Engine.

Для существующего отдельно настроенного интерфейса присоединения к петле авторитетен /v1/models: AX Code обнаруживает живые идентификаторы моделей, пределы контекста и вывода, модальности и поддержку структурированного вызова инструментов. Модель, которая не объявляет структурированный вызов инструментов, не используется для запросов кодирующего агента.

AX Engine по умолчанию использует компактный профиль инструментов core (bash, обнаружение, чтение, правка и запись файлов, а также навыки). Задайте provider.ax-engine.options.toolProfile равным full только для пользовательского развёртывания с достаточным контекстом для полного реестра инструментов.

Установка движка

Локальному выводу нужен AX Engine 7.5.7 или новее. Установщики Mac с Apple Silicon уже включают самостоятельный sidecar AX Engine (engine/<version>/ рядом со средой выполнения CLI), поэтому чистому Mac Homebrew не нужен.

Затем AX Code разрешает двоичный файл в таком порядке:

1. provider.ax-engine.options.binaryPath в ax-code.json (нужна проверенная версия не ниже 7.5.7)
2. переменная окружения AX_ENGINE_BIN (нужна проверенная версия не ниже 7.5.7)
3. ax-engine в вашем PATH (нужна проверенная версия не ниже 7.5.7)
4. управляемая AX Code установка наложения (ax-code providers ax-engine install; тоже нужна версия не ниже 7.5.7)
5. sidecar, входящий в текущую среду выполнения Mac

Сначала проверяется --version, затем запасной install.version из ax-engine doctor --json. Код выхода Doctor сообщает готовность хоста (цепочка Metal, файлы MLX), поэтому ненулевой выход всё ещё считается, если этот JSON содержит версию. Запуском сервера владеет AX Code и обычно запускает ax-engine serve на 127.0.0.1:31418. Необязательная формула Homebrew остаётся альтернативой для тех, кто хочет движок во владении brew; она не обязательна.

Управляемые запуски Tiel используют окно каталога (65 536 токенов контекста и 8 192 токена вывода), которое больше встроенного значения по умолчанию ax-engine serve в 16 384 токена, чтобы уместился запрос агента. Уменьшите любой бюджет через provider.ax-engine.options.contextTokens и provider.ax-engine.options.maxOutputTokens (outputTokens — тот же регулятор вывода). Имена окружения — AX_ENGINE_CONTEXT_TOKENS и AX_ENGINE_MAX_OUTPUT_TOKENS (AX_ENGINE_OUTPUT_TOKENS — псевдоним). Переопределение может только сузить потолок каталога: большее или недопустимое значение сообщается и игнорируется, а окно Tiel или Qwen3.8, не кратное 1 024, прищёлкивается вниз, чтобы блоки кэша префикса оставались по 1 024 токена. Те же числа использует работающий сервер и предел модели. Живая карточка /v1/models может ещё сузить это окно и не может его поднять. Настроенные параметры побеждают, и AX Code предупреждает, когда значение окружения игнорируется. То же предупреждение выдаётся, когда binaryPath игнорирует AX_ENGINE_BIN или когда connectionMode / baseURL игнорирует AX_ENGINE_HOST. Меньшее окно может оказаться слишком малым для полного запроса агента; тогда AX Code отказывает модели, а не посылает запрос, который сервер не удержит.

Tiel и Cyber-Tiel объявляют структурированный вызов инструментов. Живая карточка /v1/models всё ещё перекрывает это объявление, когда сервер уже работает. mtpPolicy: disabled выключает MTP, даже если версию двоичного файла прочитать нельзя; auto и required по-прежнему требуют AX Engine 7.4.0 или новее.

Установка из PATH или наложения, в которой нет libmlx.dylib / mlx.metallib, отвергается. Комплектный архив и архив наложения — самостоятельная полезная нагрузка macOS 7.5.7.

Установка движка не скачивает модель. Затем выберите и скачайте модель со страницы Desktop Модели или через ax-code providers ax-engine prepare. Полный совместимый базовый снимок, уже лежащий в кэше Hugging Face, принимается для прямого декодирования; prepare --download использует предпочтительный пакет MTP каталога, когда он доступен.

Используйте /connect → среда выполнения AX-Engine → Выбрать модель. AX Code настраивает и запускает локальную среду автоматически, когда выбранная модель нужна; URL и ключ API не требуются. Показать статус, Остановить локальную среду и Отключить управляют локальной средой. Выбор модели также заменяет устаревшие параметры ручного присоединения управляемой локальной настройкой.

Движок поставляется только для macOS с Apple Silicon. На других хостах используйте размещённого провайдера или шлюз провайдера, совместимый с OpenAI; серверы AX Code только локальные.